reverse-document

Files (1)

• SKILL.md

SKILL.md (first lines)

# 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:
```markdown
# [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:
```markdown
# 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:
```markdown
# [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

From vibeeval/vibecosystem, MIT.

More from vibeeval/vibecosystem