5f3e9b5c47
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
91 lines
4.4 KiB
Markdown
91 lines
4.4 KiB
Markdown
# 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ă.
|