Skip to content

feat: /onboarding — trilho de retomada no decision log + modo expresso --report-only - #28

Merged
elberrd merged 1 commit into
mainfrom
feat/onboarding-rail-express
Aug 17, 2026
Merged

feat: /onboarding — trilho de retomada no decision log + modo expresso --report-only#28
elberrd merged 1 commit into
mainfrom
feat/onboarding-rail-express

Conversation

@elberrd

@elberrd elberrd commented Aug 17, 2026

Copy link
Copy Markdown
Owner

O que muda

Fecha as duas melhorias apontadas na entrega do /onboarding (PR #27):

1. Trilho de retomada (resume rail)

O tour agora usa o decision-log.mjs como trilho determinístico, não como log de entrevista:

  • Passo 0: latest onboarding --json PRIMEIRO — log open = tour interrompido: lê as notas de estágio, confirma o ponto de retomada em UMA pergunta e REUSA o id (um novo open supersederia o trilho). Sem log aberto → open onboarding --topic "brownfield onboarding tour".
  • Após cada estágio: note <id> --text "stage <absorb|stack|kit>: done|skipped|report-only (…)" — é exatamente o que a retomada lê.
  • Wrap-up: close <id> --outcome … --artifact … + docs-commit conforme o cookbook.

Sem allowlist no script — open onboarding funciona sem mudança de código. Nas variantes do harness, o idioma guardado do /kit (script presente → usa; ausente → registro à mão com o mesmo formato).

2. Modo expresso --report-only

Repassado ao estágio /kit (que já suporta a flag): o gap report é apresentado e as decisões de design ficam adiadas para um /kit posterior — reduz o atrito da primeira sessão num codebase grande. O passo 0 anuncia a duração e oferece o atalho.

Registro atualizado

  • pi-templates/.pi/prompts/onboarding.md (trilho + flag)
  • pi-templates/.pi/skills/fia/SKILL.md (assinatura + cookbook decision-log na rota)
  • pi-templates/.pi/skills/fia/cookbooks/decision-log.md (documenta o padrão "resume rail" vs log de entrevista)
  • README.md (linha da tabela Pi)
  • DOCS.md (§12.1 e tabela do harness com trilho + flag; seção Decision logs ganha o parágrafo do rail)

Harness (repo separado, commit 2d40b43): as duas variantes do comando + README/AGENTS.md/docs/workflow.md.

Testes

npm test — 746 pass, 0 fail · npm run lint limpo · npm pack --dry-run confirma o prompt no tarball (pronto para o publish do alpha.12)

🤖 Generated with Claude Code

…resso --report-only

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@elberrd
elberrd merged commit eea93cd into main Aug 17, 2026
@elberrd
elberrd deleted the feat/onboarding-rail-express branch August 17, 2026 00:27
elberrd added a commit that referenced this pull request Aug 17, 2026
… retomada, --report-only) (#30)

A alpha.12 foi publicada às 20:07 de hoje, ANTES dos merges do /onboarding
(#27 às 20:37, #28 e #29 depois) — o pacote publicado não tem nada do
comando novo. Mesma versão devolve E403, então o bump é o caminho.

Delta desde a alpha.12 publicada: o comando /onboarding inteiro (prompt Pi
+ registro em SKILL.md/fia.js/finish.js/mode.js/README/DOCS), o trilho de
retomada no decision log + modo expresso --report-only, e o fix do guard
invertido do project-mode (+ funil idea/guide/feature/stack apontando
/onboarding).

Testes: 746 passando, lint limpo. Tarball: npm pack --dry-run com 184
arquivos, 424.9 kB, onboarding.md incluído.

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
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