OpenSkillIndex← back to search
claude-codewriting

Vibecosystem reverse-document

Generate design docs, ADRs, and concept docs from existing code by reverse engineering intent

install
source · Clone the upstream repo
git clone https://github.com/vibeeval/vibecosystem
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/vibeeval/vibecosystem "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/reverse-document" ~/.claude/skills/vibeeval-vibecosystem-reverse-document && rm -rf "$T"
manifest: skills/reverse-document/SKILL.md
tags
#code-analysis#documentation#reverse-engineering#design-patterns#git-history
source content

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):

  1. Neden var? Bu sistem/modul/fonksiyon hangi problemi cozuyor?
  2. Kim kullaniyor? Hedef kullanici/consumer kim?
  3. Alternatifler? Baska yaklasimlar dusunulmus mu? (Yorumlar, git history)
  4. Sinirlamalar? Bilinen kisitlamalar ne? (TODO, FIXME, HACK)
  5. Evrim? Zaman icinde nasil degismis? (git log --oneline)

Workflow

  1. Scan: Dosya yapisini, dependency'leri, config'leri tara
  2. Read: Ana dosyalari oku, entry point'ten basla
  3. Trace: Data flow'u takip et (input -> process -> output)
  4. Extract: Pattern'leri, kararlari, edge case'leri cikar
  5. Question: Intent sorularini cevapla (koddan veya kullanicidan)
  6. Write: Secilen mod sablonuna gore dokumani yaz
  7. 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