docs: TODO.md ca registru viu + flux plan-pe-Opus / executie-pe-Sonnet

Firele Discord sunt independente: un fir nou nu vede conversatia din alt fir.
Fara un loc scris, progresul unei functionalitati se pierde intre runde. TODO.md
e acel loc, iar CLAUDE.md il face parte din procedura, nu optional.

- TODO.md: intrari grupate pe stare (in lucru / blocate / planificate / gata),
  fiecare cu unde, ce face, ce s-a verificat si data absoluta, plus un Jurnal
  append-only. Populat cu starea reala de azi.
- docs/flux-dezvoltare.md: pentru orice cerere de dezvoltare -- citeste TODO.md,
  planifica delegand `Agent(subagent_type: "Plan", model: "opus")`, posteaza
  planul in fir, executa tu (firul e pe Sonnet), actualizeaza TODO.md.
  Delegarea catre subagent obtine "plan pe Opus, executie pe Sonnet" fara
  `/model` si fara repornirea sesiunii, ceea ce un fir nu poate face oricum.
  Excepii: intrebarile si diagnosticele fara modificare. Marimea sarcinii NU e
  criteriu -- prima versiune a documentului lasa asta ambiguu si agentul a sarit
  peste plan la un script de 20 de linii; acum e spus explicit in ambele locuri.
- CLAUDE.md: sectiunea "Cum lucrezi" in cap, cei 4 pasi, plus TODO.md si
  documentul de flux in tabelul de documentatie.
- CLAUDE.md: nota despre atasamente actualizata -- imaginile si fisierele text
  ajung acum la agent (implementat azi in discord-bridge).
- README.md: tabel de fisiere; `!cd`/`!status` -> `/cd`/`/status`.

Verificat pe o sesiune reala pe Sonnet in acest director, cu aceeasi cerere
inainte si dupa intarire: prima data a sarit peste plan, a doua oara a chemat
subagentul Plan pe Opus si a actualizat TODO.md in formatul cerut.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Q4uzvgm7AyJch5WH8QHRhY

docs/flux-dezvoltare.md

@@ -0,0 +1,90 @@
+# Fluxul de lucru pentru cereri de dezvoltare
+
+Regula, pe scurt: **planifici cu Opus, execuți cu Sonnet, actualizezi
+[`TODO.md`](../TODO.md).** Se aplică oricărei cereri de dezvoltare venite prin puntea
+Discord, indiferent de proiectul atins.
+
+## Ce e „cerere de dezvoltare"
+
+Orice ți se cere să **schimbi**: funcționalitate nouă, refactorizare, reparare de bug,
+schimbare de configurație sau de infrastructură, script nou, migrare.
+
+**Nu** intră aici, și nu au nevoie de plan: întrebări („cum merge X?", „ce e în fișierul
+Y?"), diagnostice fără modificare, citit loguri, verificat starea unui serviciu,
+o corectură de o linie pe care utilizatorul a formulat-o deja exact.
+
+**Mărimea sarcinii nu e un criteriu.** „E doar un script", „e o singură funcție", „știu
+deja exact ce am de făcut" — nu sunt motive să sari peste plan. Criteriul e unul singur:
+*schimbi ceva?* Dacă da, planul se face. Dacă ești în dubiu, planifică. Un plan în plus
+costă câteva secunde; o execuție greșită pe infrastructura de producție costă mult mai
+mult.
+
+Singurul caz în care poți sări peste plan la o schimbare este când utilizatorul spune
+explicit să nu planifici („fă direct", „fără plan").
+
+## Pasul 1 — Planifică, pe Opus
+
+Firele Discord rulează pe **Sonnet** (`MODEL_DEFAULT`). Nu schimba modelul firului ca să
+planifici — nu poți, și oricum ar reporni procesul. În loc de asta, **delegă planificarea
+unui subagent pe Opus**, din sesiunea curentă:
+
+```
+Agent(
+  subagent_type: "Plan",
+  model:         "opus",
+  description:   "Planifică <cerința>",
+  prompt:        "<cerința completă, plus contextul pe care îl știi deja: fișierele
+                  relevante, ce ai găsit citind, constrângerile din CLAUDE.md>"
+)
+```
+
+Așa obții exact ce a cerut utilizatorul — gândirea pe Opus, execuția pe Sonnet — fără
+niciun `/model` și fără repornirea sesiunii.
+
+Înainte de a chema subagentul, **citește [`TODO.md`](../TODO.md)**: poate lucrul e deja
+început, blocat, sau abandonat deliberat, iar planul trebuie să pornească de acolo.
+Dă-i subagentului contextul pe care îl ai deja — el pornește fără istoricul firului.
+
+## Pasul 2 — Postează planul în fir
+
+Rezumă planul în fir **înainte** de a atinge ceva: pașii, fișierele, ce verifici la final.
+Scurt — pașii, nu eseul.
+
+Apoi execută. Nu aștepta aprobare pentru pași obișnuiți; utilizatorul poate interveni
+oricând, un mesaj trimis în timpul turului ajunge la tine ca steering. Cere confirmare
+explicită doar pentru ce e ireversibil sau are efect în afară: ștergere de date, restart
+de servicii cu clienți live, `pct/qm/zfs destroy`, orice ajunge la un client.
+
+## Pasul 3 — Execută, pe Sonnet
+
+Execuția o faci tu, în sesiunea firului, care e deja pe Sonnet. Nu delega execuția înapoi
+unui subagent Opus — ăsta e exact lucrul pe care regula vrea să-l evite.
+
+Termină toată cerința, nu doar partea ușoară. Rulează testele proiectului dacă există
+(`python3 -m pytest -q` pentru puntea Discord) și spune rezultatul real, inclusiv când
+pică.
+
+## Pasul 4 — Actualizează `TODO.md`
+
+La finalul oricărei cereri de dezvoltare, actualizează [`TODO.md`](../TODO.md):
+
+1. **Mută intrarea** în secțiunea potrivită (`🟡 În lucru` → `✅ Gata`, sau `⛔ Blocate`
+   dacă te-ai oprit în ceva ce depinde de altcineva).
+2. **Completează câmpurile:** `Unde` (căi de fișiere), ce face, ce ai verificat,
+   `Actualizat`/`Terminat` cu data absolută (nu „azi", nu „ieri").
+3. **Adaugă o linie în `Jurnal`**, prima, în formatul `AAAA-LL-ZZ — <stare> <nume>`.
+4. Dacă lucrul e nou și nu era în listă, **creează intrarea** — inclusiv când îl termini
+   într-un singur tur; registrul e util doar dacă e complet.
+5. Dacă rămâne ceva neterminat, lasă intrarea în `🟡 În lucru` cu **următorul pas scris
+   explicit** — firul următor pornește fără conversația asta și ăla e tot ce va ști.
+
+`TODO.md` e în repo-ul `claude-agent`; comite-l odată cu restul lucrului.
+
+## De ce așa
+
+- **Opus planifică mai bine, Sonnet execută mai ieftin.** Un plan prost costă mai mult
+  decât diferența de model.
+- **Sesiunile Discord sunt per fir.** Un fir nou nu vede conversația din alt fir, deci
+  ce nu e scris în `TODO.md`, în memorie sau în documentație e pierdut.
+- **Planul postat în fir e singurul moment ieftin de intervenție.** După ce ai scris în
+  `/workspace/romfastsql` sau ai atins un container, corectura e mai scumpă.