Skip to content

feat: /onboarding — tour guiado do brownfield (/absorb → /stack → /kit) terminando em /idea ou /feature - #27

Merged
elberrd merged 1 commit into
mainfrom
feat/onboarding-command
Aug 16, 2026
Merged

feat: /onboarding — tour guiado do brownfield (/absorb → /stack → /kit) terminando em /idea ou /feature#27
elberrd merged 1 commit into
mainfrom
feat/onboarding-command

Conversation

@elberrd

@elberrd elberrd commented Aug 16, 2026

Copy link
Copy Markdown
Owner

O que muda

Novo comando estudante /onboarding — o PRIMEIRO comando num sistema existente recém-instalado. Encadeia os três comandos de onboarding em sequência e termina entregando o projeto pronto para trabalho novo:

  1. /absorb — PRD as-built, map.yaml, conventions, manifesto de stack, registry, project skill (pulável se os artefatos já existem, com UMA pergunta)
  2. /stack — camadas pendentes + research obrigatório + docs em ai-docs/apis/ + equipagem
  3. /kit — auditoria de design system, só tasks design-only aprovadas ("nada aprovado" é resultado válido)
  4. Wrap-up — explica a divisão /idea (módulo: novo ator/domínio/várias telas → capítulo ## Module: no PRD) vs /feature (delta descritível numa frase), com a regra de bolso; /bug e /quick citados de passagem

Guard no passo 0 via project-mode.mjs (não-brownfield → roteia em uma linha). Cada estágio segue o próprio prompt à risca (entrevistas, decision logs, aprovações) — o /onboarding só orquestra.

Registro (regra dos comandos novos)

  • pi-templates/.pi/prompts/onboarding.md (novo prompt)
  • pi-templates/.pi/skills/fia/SKILL.md (tabela Routing — o /guide herda daqui)
  • src/steps/fia.js (painel pós-install — teste a2 exige)
  • src/steps/finish.js (painel brownfield: passo 1 agora aponta /onboarding nos dois ramos)
  • src/steps/mode.js (aviso de projeto existente)
  • README.md (tabela Pi, lista do harness, Exemplo 3)
  • DOCS.md (§12.1 — 23→24 comandos — tabela do harness e exemplo 15.3)

Harness (repo separado, commit 7533971): .cursor/commands/onboarding.md (canônico) + variante .claude + symlink .agents + README/AGENTS.md/docs/workflow.md.

Testes

npm test — 746 pass, 0 fail (inclui os guards de consistência a/a2/c) · npm run lint limpo

🤖 Generated with Claude Code

…/stack → /kit e entrega o projeto pronto para /idea ou /feature

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@elberrd
elberrd merged commit a98b1db into main Aug 16, 2026
5 of 7 checks passed
@elberrd
elberrd deleted the feat/onboarding-command branch August 16, 2026 23:37
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