Skip to content

feat: /goal por milestone + disciplina de tokens do orquestrador - #52

Merged
elberrd merged 1 commit into
mainfrom
feat/goal-milestone
Aug 23, 2026
Merged

feat: /goal por milestone + disciplina de tokens do orquestrador#52
elberrd merged 1 commit into
mainfrom
feat/goal-milestone

Conversation

@elberrd

@elberrd elberrd commented Aug 23, 2026

Copy link
Copy Markdown
Owner

Contexto

Sexta PR do estudo (#47#51). Fora dos FDAs, o maior custo escondido era o próprio orquestrador: a sessão Pi do /goal do projeto medido acumulou 240M tokens em 1.282 turnos — UMA sessão viva por 2 dias relendo a própria história a cada turno. Todo estado do loop já é durável em ai-docs/ (task-master, milestones, briefs, QA reports), então nada exige uma sessão só.

O que muda (prompt-level, deliberadamente — os FDAs já são processos separados)

  1. Sessão por milestone: QA do milestone verde + docs drenadas ⇒ o loop termina na fronteira com um handoff de 5 linhas ("estado durável em ai-docs/ — rode /goal numa sessão NOVA para continuar") quando restam outros milestones. Uma maratona de 240M vira N sessões pequenas; a entrega final (app RUNNING + How to test) continua na sessão que fecha o último milestone.
  2. Bloco "Token discipline" no goal.md: nunca colar briefs/relatórios/output de FDA na conversa (referir paths; "o viewer é o log"), relatório de task em 1 linha, nunca reler task-master.md inteiro, --light recomendado para milestones rotineiros.
  3. harness_bridge.md (bullet de milestone) e a linha do /goal na tabela do DOCS.md alinhados.

Testes

Teste novo em fia-sdlc-repair.test.js pinando as cláusulas nos dois arquivos (o padrão do repo: prompt que protege dinheiro vira assert). As cláusulas existentes que outros testes pinam (never re-ask, recovery budget, theme gate) permanecem intactas — suite completa 1472 pass + lint limpo.

🤖 Generated with Claude Code

https://claude.ai/code/session_01NPYaKxNaVRhPumKbawFNT3

A sessão-maratona do /goal foi o custo escondido nº 1 fora dos FDAs: 240M
tokens (1.282 turnos, uma sessão Pi viva por 2 dias) — o orquestrador relendo
a própria história a cada turno. Todo estado do loop já é durável em ai-docs/,
então nada exige uma sessão só.

- goal.md: bloco "Token discipline" (nunca colar briefs/relatórios/output de
  FDA na conversa — referir paths, o viewer é o log; relatório de task em 1
  linha; nunca reler task-master.md inteiro; --light recomendado para
  milestones rotineiros).
- goal.md + harness_bridge.md: QA do milestone verde + docs drenadas ⇒ o loop
  TERMINA na fronteira com handoff de 5 linhas ("rode /goal numa sessão NOVA")
  quando restam outros milestones — um milestone por sessão é a forma barata;
  a entrega final (app RUNNING) continua na sessão que fecha o último.
- DOCS.md: linha do /goal na tabela de comandos atualizada.
- Teste novo em fia-sdlc-repair.test.js pinando as cláusulas nos dois arquivos.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NPYaKxNaVRhPumKbawFNT3
@elberrd
elberrd merged commit 285290a into main Aug 23, 2026
7 checks passed
@elberrd
elberrd deleted the feat/goal-milestone branch August 23, 2026 21:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant