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
This commit is contained in:
Claude Agent
2026-08-31 17:56:51 +00:00
parent e6c7bdbfb1
commit 5f3e9b5c47
4 changed files with 211 additions and 4 deletions

View File

@@ -2,6 +2,25 @@
Vezi `README.md` pentru context general.
## Cum lucrezi (OBLIGATORIU pentru orice cerere de dezvoltare)
1. **Citește [`TODO.md`](TODO.md)** — registrul viu al funcționalităților. Poate lucrul e
deja început, blocat sau abandonat deliberat.
2. **Planifică pe Opus**, delegând unui subagent: `Agent(subagent_type: "Plan",
model: "opus", ...)`. Firul rulează pe Sonnet; nu schimba modelul firului.
**Pasul ăsta nu se sare pentru că sarcina pare mică.** Un singur fișier nou, un
script de 20 de linii, o schimbare „evidentă" — tot trec prin subagentul Opus.
Mărimea nu e criteriu; singurul criteriu e dacă schimbi ceva (vezi lista de
excepții din documentul de flux).
3. **Postează planul în fir**, apoi **execută tu, pe Sonnet**.
4. **Actualizează [`TODO.md`](TODO.md)** la final — mută intrarea, scrie data absolută,
adaugă o linie în `Jurnal`. Dacă rămâne ceva neterminat, scrie explicit următorul pas:
firul următor nu va ști nimic din conversația asta.
Pașii, excepțiile (întrebări și diagnostice nu au nevoie de plan) și motivele sunt în
**[docs/flux-dezvoltare.md](docs/flux-dezvoltare.md)** — citește-l înainte de prima
cerere de dezvoltare din fir.
## Unde ești
Rulezi pe **LXC 171 (`claude-agent`, 10.0.20.171, nod pvemini)**, în ecosistemul Romfast:
@@ -42,13 +61,16 @@ supraviețuiască între fire se scrie în memorie sau în documentație, nu se
Utilizatorul comunică cu acest agent în principal prin **Discord**, prin puntea
Discord → Claude Code (vezi și `docs/echo-roa2web.md` pentru diferența față de
Echo/MoltBot). Botul care răspunde pe Discord este acest agent (**claude-agent**,
LXC 171), nu Echo. Atașamentele (imagini, fișiere) trimise pe Discord nu sunt încă
citite automat de punte — doar textul mesajului ajunge la Claude.
LXC 171), nu Echo. Atașamentele trimise pe Discord ajung la tine din 2026-08-31:
imaginile (png/jpeg/gif/webp, max 4) le vezi direct, fișierele text intră în prompt,
restul sunt doar numite. Mesajele vocale, nu — vezi `TODO.md`.
## Documentație locală
| Subiect | Fișier |
|---------|--------|
| **Progresul funcționalităților (de citit și actualizat la fiecare cerere)** | [TODO.md](TODO.md) |
| **Fluxul de lucru: plan pe Opus → execuție pe Sonnet → TODO.md** | [docs/flux-dezvoltare.md](docs/flux-dezvoltare.md) |
| Infrastructură Proxmox — rezumat (noduri, LXC, VM, proiecte) | [docs/infrastructure.md](docs/infrastructure.md) |
| Echo (LXC 110 moltbot) — acces și comenzi pentru roa2web | [docs/echo-roa2web.md](docs/echo-roa2web.md) |
| Punte Discord → Claude Code — context | [docs/discord-bridge-context.md](docs/discord-bridge-context.md) |