Directorul .planning/

Structura directorului

.planning/
├── PROJECT.md        # Descrierea proiectului & obiective
├── REQUIREMENTS.md   # Requirements curente
├── ROADMAP.md        # Feature roadmap cu progres
├── STATE.md          # SINGURA SURSA DE ADEVAR
├── ISSUES.md         # Probleme cunoscute & tech debt
└── phases/
    └── 001/
        ├── PLAN.md     # Planul fazei
        └── SUMMARY.md  # Ce s-a realizat

STATE.md — Singura sursa de adevar

Acesta este cel mai important fisier din .planning/. La inceputul fiecarei sesiuni, agentul il citeste ca sa stie unde a ramas si ce urmeaza.

Structura STATE.md:

# PROJECT STATE

## 1. Mission
Tutorial interactiv pentru Claude Code CLI v2.1

## 2. Current Phase
Phase 001 — Structura si validare

## 3. Active Focus
Implementarea scriptului de validare

## 4. Next Concrete Step
Adauga test pentru directorul docs/

## 5. Working Agreements
- TDD obligatoriu
- Atomic commits

## 6. What Was Done This Session
- Creat structura directoare
- Configurat agents si commands

ROADMAP.md — Imaginea de ansamblu

ROADMAP.md contine toate fazele proiectului cu starea lor:

## Faze

### Phase 001 — Structura si validare ✅
### Phase 002 — Workflow PAUL demo 🔄
### Phase 003 — MCP Integration ⏳
### Phase 004 — Documentatie ⏳

Simbolurile: ✅ completat, 🔄 in progres, ⏳ planificat.

Directorul phases/

Fiecare faza are un subdirector cu doua fisiere:

• PLAN.md — planul detaliat: fiecare task specifica fisierele, actiunea, verificarea si criteriul de "done"
• SUMMARY.md — scris la finalul fazei in etapa UNIFY. Documenteaza ce s-a realizat, decizii luate si lectii invatate.

PROJECT.md si REQUIREMENTS.md

PROJECT.md descrie ce este proiectul si de ce exista.REQUIREMENTS.md descrie ce trebuie sa faca concret. Aceste fisiere se schimba rar — sunt referinta stabila.

ISSUES.md

Probleme cunoscute si tech debt. Cand agentul gaseste ceva de imbunatatit dar nu e in scopul curent, il adauga aici in loc sa-l rezolve pe loc.

Fluxul complet

1. Agentul citeste STATE.md → stie unde e
2. Consulta ROADMAP.md → vede imaginea mare
3. Deschide PLAN.md din faza curenta → stie ce are de facut
4. Executa task-urile (APPLY)
5. Scrie SUMMARY.md si actualizeaza STATE.md (UNIFY)

Exercitiu

Navigheaza la .planning/ in acest proiect. Deschide STATE.md si identifica: in ce faza suntem, care e next action-ul, si ce s-a facut in ultima sesiune.