Toolkit de equipe .claude: 10 skills + time de 9 agentes + guia didático - #15
Merged
Conversation
…onta para eles Scaffolds /spec /adr /dl (próximo número + índice + formato lidos dos templates reais em docs/ — zero duplicação, sem drift), laço da fatia /slice (gate de Open Questions; RED primeiro) e /dod (gates + Definition of Done lida das fontes vivas + PR para develop), /release (lockstep pom × OpenApiConfig × snapshot OpenAPI × 2 changelogs; nunca tag), /manual (+ screenshots.md), /dev-env e /ci-triage (lições da sessão do PR #14: smoke test via proxy + logins do DevUserSeeder; 4 famílias de falha de CI + armadilha do target/ sujo em repro Linux), /new-project (+ parameterization.md: preservar/parametrizar/resetar + gatilho de migração para plugin). CLAUDE.md: 2 linhas novas no Routing Map (rituais + time de agentes); a seção 'Command — /manual' encolhe para o essencial — o normativo migrou para o corpo do skill (fonte única). Nomes em inglês kebab-case (docs já citavam /spec /adr /manual), corpos e toda saída em pt-BR. Portabilidade: nada de pacote/produto/fase/contagem hardcoded (OpenApiConfig e DevUserSeeder localizados por Glob). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…daptada) arquiteto (persona da sessão principal via claude --agent; NUNCA infere — regra do dono: dúvida = pergunta; distribui por fatia/módulo em branches disjuntas; media rework retomando o MESMO dev via SendMessage; fluxo do time documentado no corpo), dev-backend / dev-frontend / dev-fullstack (isolation: worktree; RED-first; testes da própria stack; gates verdes antes de devolver; nunca push/merge/tag), qa (bateria completa + PIT + E2E + exploratório derivado da spec + ataque adversarial aos testes dos devs; veredicto APROVADO/REPROVADO; fix exige regressão commitada), revisor-arquitetura (8 checklists das regras da casa sobre o diff, read-only, complementa o /code-review builtin), revisor-pr (briefing de PR para o dono decidir o merge: críticos, cheiros, comentários prontos, veredicto sugerido; não comenta/aprova/mergeia), documentador (sincronia bilíngue delegável), relator (relatórios com todo número citando a linha-fonte). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…xecution log docs/GUIA-TIME-CLAUDE.md: ensina o dono/time a operar skills e agentes do zero, sem assumir conhecimento de Claude Code — 3 conceitos, tabelas dos 10 comandos e 9 agentes, fluxo ponta a ponta com as frases reais a digitar, receitas do dia a dia, o vai-e-volta (rework), o que os agentes nunca fazem (governança ADR-0023) e FAQ. Linha nova no hub docs/README.md e no execution log do ROADMAP-STATUS. Docs/config-only: sem bump (ADR-0015), sem MANUAL (toolkit não é user-facing). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…atório; 5 agentes; tudo em inglês Revisão do dono sobre o PR #15 (2ª rodada): 1. Inglês em tudo (skills e agentes — corpos, descriptions, nomes): instrução de modelo segue melhor em inglês; precedente do repo é o CLAUDE.md. A regra 'All owner-facing communication is in pt-BR' fica escrita em cada arquivo. Frases-gatilho pt-BR mantidas nas descriptions (matching da fala do dono). 2. Time de 9 → 5 (modelo do dono): o architect É o documentador, o revisor e o relator — funções absorvidas no architect.md (specs/ADRs sob demanda e PARA; 8 checklists da casa; protocolo fresh-eyes contra viés de consistência; briefing de PR em 6 seções para o dono decidir o merge; relatórios com todo número citando a fonte). Deletados: arquiteto, revisor-arquitetura, revisor-pr, documentador, relator. Mantidos e traduzidos: dev-backend, dev-frontend, dev-fullstack, qa (veredito volta ao architect). 3. Regras novas do dono no architect: nunca inferir (perguntar é o default); delegação a 1..N devs com MESMA especialidade permitida (paralelo = escopos/ branches disjuntos; cross-stack = sequência na mesma branch); trava de ping-pong (2 reprovações seguidas do QA ⇒ sobe ao dono); portões do dono (spec → plano → merge → tag). GUIA-TIME-CLAUDE reescrito ('você só fala com o arquiteto'); CLAUDE.md routing ajustado; linha do ROADMAP-STATUS atualizada para o estado final. Verificação: 15 frontmatters ok, zero referência órfã, zero hardcode, caminhos citados existem, nomes do GUIA batem com .claude/agents/. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
O que este PR entrega
A pasta
.claude/vira o toolkit do time — versionada, revisável em PR e copiada junto quando um projeto novo nascer deste template.10 skills (
.claude/skills/— digite/para ver)/spec/adr/dldocs/(fonte única — sem drift)/slice/dod/release/manual(+screenshots.md)/dev-envDevUserSeeder/ci-triagetarget/sujo em repro Linux/new-project(+parameterization.md)Time de 9 agentes (
.claude/agents/— é só pedir em português)arquiteto(persona da sessão principal — nunca infere, pergunta ao dono; distribui e media rework) ·dev-backend/dev-frontend/dev-fullstack(worktrees isoladas, gates verdes antes de devolver) ·qa(bateria + PIT + E2E + exploratório da spec + ataque adversarial) ·revisor-arquitetura(regras da casa, read-only) ·revisor-pr(briefing para o dono decidir o merge) ·documentador(bilíngue) ·relator(números sempre com fonte).Docs
docs/GUIA-TIME-CLAUDE.md— guia didático do zero (sem assumir conhecimento de Claude Code): conceitos, tabelas, fluxo ponta a ponta com as frases a digitar, rework, governança, FAQ.CLAUDE.md: +2 linhas no Routing Map; seção/manualenxugada (normativo migrou para o skill).ROADMAP-STATUS.Verificação
OpenApiConfig,DevUserSeeder) resolvem.Decisões do dono registradas neste PR
Time de 9 agentes (visão dele, com adaptações técnicas discutidas); arquiteto nunca infere; dono controla os merges (revisor-pr o municia); sem ADR/DL para esta fatia;
.claude/no repo agora, plugin só com 2+ projetos ativos (gatilho documentado).🤖 Generated with Claude Code