Skip to content
gStack

Checkpoint & Resume

Garantează că locul de muncă supraviețuiește restartului și că setup-ul se face o singură dată, în batch.

A. Bootstrap (prima sesiune / bootstrap_done=false)

Section titled “A. Bootstrap (prima sesiune / bootstrap_done=false)”
  1. Citește config/.env. Pune întrebările de setup DOAR pentru valorile încă neconfigurate (placeholder), TOATE deodată, ca un singur batch:
    • URL + token GitLab + project ID
    • Cheie GLM (Z.ai) + model
    • Cheie Kimi (Moonshot) + model
    • Cadență: QUESTION_BATCH_SIZE, MAX_GREEN_ITERATIONS
    • Care bloc(uri) pornesc primele (A / B / C / toate în paralel)
  2. Acceptă două moduri de răspuns: (a) teamlead-ul completează config/.env direct, sau (b) răspunde în chat și TU scrii valorile în config/.env (NU în fișiere comise; .env e gitignored).
  3. Validează: rulează bash bootstrap.sh (idempotent) și un ping rapid GitLab (skill gitlab-issues, comanda whoami).
  4. Setează în state.json: bootstrap_done=true, current_block, timestamp.
  5. Inițializează task-ledger.md din planul aprobat.

B. Formatul checkpoint-ului

Section titled “B. Formatul checkpoint-ului”

state.json (sursa de adevăr a poziției):

{
  "bootstrap_done": true,
  "current_block": "C",
  "current_task": "C-014",
  "last_checkpoint": "2026-06-18T10:22:00Z",
  "updated_at": "...",
  "blocks": { "A": "in_progress", "B": "in_progress", "C": "in_progress" }
}

task-ledger.md (istoricul lizibil) — o linie per task:

- [DONE]  C-013  Auth service unit tests        | reviewer:APPROVE | mr:!42 | ckpt:2026-06-18T10:05Z
- [WIP]   C-014  Auth refresh-token endpoint     | branch:feat/c-014 | last-green:test 6/9
- [TODO]  C-015  Angular login form + validation

.workplace/checkpoints/<task>.md — context bogat per task (ce s-a făcut, fișiere atinse, ultima stare verde, ce urmează) ca un subagent proaspăt să poată relua fără tine.

C. Scrie checkpoint (după fiecare task / iterație verde)

Section titled “C. Scrie checkpoint (după fiecare task / iterație verde)”
  1. Actualizează linia taskului în task-ledger.md.
  2. Scrie .workplace/checkpoints/<task>.md cu: rezumat, fișiere modificate, comenzi de verificare rulate + rezultat, „NEXT STEP”.
  3. Actualizează state.json (current_task, last_checkpoint).
  4. Commit local pe branch-ul de lucru (nu main).

D. Resume (orice sesiune ulterioară)

Section titled “D. Resume (orice sesiune ulterioară)”
  1. Citește state.json → află current_block/current_task.
  2. Citește task-ledger.md (ce e DONE/WIP/TODO) și checkpoint-ul taskului WIP.
  3. Citește questions/inbox.md — aplică răspunsurile ANSWERED.
  4. Anunță în 3 rânduri: unde suntem, ce urmează, dacă există blocaje. Apoi CONTINUĂ de la „NEXT STEP” — nu reface ce e DONE.

Regulă: dacă un task era WIP și nu există checkpoint coerent, NU presupune că e gata — re-verifică testele/build-ul înainte de a-l declara done.