vibeeval/reverse-document
skills/reverse-document/SKILL.md
Generate design docs, ADRs, and concept docs from existing code by reverse engineering intent
$ install --global
skillsauthnpx skillsauth add vibeeval/vibecosystem reverse-documentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 13, 2026, 2:30 AM16.8s1 file scanned
SKILL.md
- name:
- reverse-document
- description:
- Generate design docs, ADRs, and concept docs from existing code by reverse engineering intent
Reverse Document
Koddan dokuman uret. "Bu sistem neden var?" sorusunu cevapla.
3 Mod
1. Design Mode (Koddan GDD/PRD)
Mevcut kodu analiz ederek tasarim dokumani uret.
Input: Kaynak kod dizini veya dosya Output: Product/Feature Design Document
Sablonlu cikti:
# [Feature/System Adi]
## Problem Statement
Bu sistem hangi problemi cozuyor?
## Solution Overview
Nasil cozuyor? (High-level mimari)
## Key Decisions
Neden bu yaklasim secildi? (Koddan cikarim)
## Components
- [Component 1]: Gorevi, bagimliliklari
- [Component 2]: Gorevi, bagimliliklari
## Data Flow
1. [Adim 1]
2. [Adim 2]
## Edge Cases & Error Handling
Kodda gorulmus ozel durumlar
## Limitations
Bilinen sinirlamalar (TODO/FIXME/HACK yorumlarindan)
2. Architecture Mode (Koddan ADR)
Mimari kararlari reverse engineer ederek ADR (Architecture Decision Record) uret.
Input: Kaynak kod, config dosyalari, dependency listesi Output: ADR dokumenti
Sablonlu cikti:
# ADR-[N]: [Karar Basligi]
## Status
Accepted (kodda uygulanmis)
## Context
Bu karar hangi kosullarda alinmis? (Koddan cikarim)
## Decision
Ne yapilmis? (Concrete implementation)
## Rationale
Neden? (Dependency secimleri, pattern kullanimi, config'den cikarim)
## Alternatives Considered
Kullanilmayan alternatifler (varsa yorum/TODO'lardan)
## Consequences
- Pozitif: [...]
- Negatif: [...]
- Riskler: [...]
3. Concept Mode (Prototypeden Concept Doc)
Erken asamadaki koddan konsept dokumani uret.
Input: Prototip/POC kodu Output: Concept Document
Sablonlu cikti:
# [Konsept Adi]
## One-Liner
Tek cumlelik aciklama
## Problem
Hangi problemi cozuyor?
## Proposed Solution
Prototipte denenmis yaklasim
## Key Insights
Prototipten ogrenilenler
## Open Questions
Henuz cevaplanmamis sorular
## Next Steps
Production'a tasimak icin gerekli adimlar
Intent Sorulari
Kodu okumadan ONCE su sorulari sor (veya koddan cikar):
- Neden var? Bu sistem/modul/fonksiyon hangi problemi cozuyor?
- Kim kullaniyor? Hedef kullanici/consumer kim?
- Alternatifler? Baska yaklasimlar dusunulmus mu? (Yorumlar, git history)
- Sinirlamalar? Bilinen kisitlamalar ne? (TODO, FIXME, HACK)
- Evrim? Zaman icinde nasil degismis? (git log --oneline)
Workflow
- Scan: Dosya yapisini, dependency'leri, config'leri tara
- Read: Ana dosyalari oku, entry point'ten basla
- Trace: Data flow'u takip et (input -> process -> output)
- Extract: Pattern'leri, kararlari, edge case'leri cikar
- Question: Intent sorularini cevapla (koddan veya kullanicidan)
- Write: Secilen mod sablonuna gore dokumani yaz
- Review: Kullaniciyla birlikte dogrula
Kurallar
- Spekuasyon yapma, kodda gordugun seyi yaz
- "Muhtemelen" yerine "Kodda goruldugu uzere" kullan
- Git history varsa kararlarin kronolojisini ekle
- TODO/FIXME/HACK yorumlarini "Limitations" bolumune ekle
- Kodda olmayan seyi dokumante etme
Related Skills
vibeeval/workflow-router
development
VerifiedTrustedCommunity
Goal-based workflow orchestration - routes tasks to specialist agents based on user goals
500SKILL.mdUpdated Jun 11, 2026
vibeeval/wiring
tools
VerifiedTrustedCommunity
Wiring Verification
500SKILL.mdUpdated Jun 11, 2026
vibeeval/websocket-patterns
development
VerifiedTrustedCommunity
Connection management, room patterns, reconnection strategies, message buffering, and binary protocol design.
500SKILL.mdUpdated Jun 11, 2026
vibeeval/vp-engineering
testing
VerifiedTrustedCommunity
VP Engineering perspective - org design (team topologies), process improvement, cross-team dependencies, engineering culture, OKRs, incident management maturity, platform strategy, DX optimization, release management at scale
500SKILL.mdUpdated Jun 11, 2026