Tudo roda dentro de uma sessão do Claude Code: instalar, escolher modelo, adotar num projeto e abrir o time do dia. Quatro momentos, cada um com um comando.
claude plugin marketplace add giovani-junior-dev/sdlc && claude plugin install sdlc@sdlc claude /sdlc:setup
Confere git, jq, gh e a versão do Claude Code (≥ 2.1.234); instala o time (claude-agent-kit) e as skills de entrevista e TDD; clona o gate de qualidade code-craftsman; grava a persona global. Depois, feche e abra o claude.
Por quê: método e time são dois plugins e uma skill; sem os três os outros comandos não existem.
/sdlc:models
Pergunta o provedor, o modelo de cada slot e a chave; grava ~/.claude-kit/profiles.json e secrets.env. A chave nunca aparece no chat.
Por quê: dev em modelo barato e planner/reviewer em Claude cortam o custo de um time rodando horas.
cd <projeto> claude /sdlc:adopt
Copia REVIEW.md, intent/, specs/, evals/ e .claude/sdlc/ sem sobrescrever nada; detecta a branch base; pergunta o modelo de cada papel e grava team.json; funde CLAUDE.md e settings.json mostrando o diff.
Por quê: os agentes leem contrato de arquivos, não de conversa.
/sdlc:up # na aba do planner: descreva a demanda
Abre o time inteiro: planner, dev (já num worktree próprio), reviewer, tester-e2e e document. O planner entrevista, planeja, inicia o pipeline e o time trabalha sozinho até done.
Por quê: sessões separadas conversam direto entre si sem passar por você.
# em %USERPROFILE%\.claude-kit\secrets.env TYPESAFE_API_KEY=apikey_...
No fim do build, o Jev confere cada REQ-N do plano contra o diff da branch e anota PASS, RETRY ou HUMAN. Sem a chave, nada muda. Resultado na aba Jev do /sdlc:painel.
Por quê: pega o "terminei" falso antes de gastar uma rodada do reviewer, por menos de US$ 0,001.
# no planner /clear /sdlc:up <novo-slug>
Reaproveita planner, reviewer, tester-e2e e document; cria só o dev da nova demanda. O estado fica em pipeline.json e roster.json, então nada se perde.
Por quê: /clear apaga a conversa, não a sessão: nome, modelo e endereço continuam.
Cada papel é uma sessão separada do Claude Code. Eles conversam direto entre si, o reviewer nunca é quem escreveu o código e o dev trabalha num worktree próprio.
Entrevista você até o intent aprovado, gera o plano com o planf3, passa cada plano pelo code-craftsman e conduz o time até a entrega com rubrica.
Nunca: implementa.
Implementa exatamente o que a spec aprovada define, com TDD vermelho-verde, e escreve a evidência na rubrica.
Nunca: replaneja, inventa requisito ou se declara pronto sozinho.
Roda build, lint e testes antes de opinar; quebra o plano em requisitos e julga cada um no código, com arquivo:linha.
Nunca: muda código: cada achado volta ao dev.
Valida na aplicação rodando: caminho feliz e casos de borda via Chrome DevTools/Playwright, com passos de reprodução por falha.
Nunca: conserta nada.
Documenta o que foi entregue a partir do diff, da rubrica e da saída dos testes: progresso, ADRs, bugs e mapa do código.
Nunca: especula nem toca em código.
Vigia CI, Kaneo e PRs paradas; quando algo quebra, escreve um intent novo e avisa o planner.
Nunca: corrige: detecta e descreve.
Classificador que confere cada REQ-N do plano contra o diff no fim do build e devolve probabilidades. A decisão sai do código.
Nunca: aprova sozinho: só barra ou pede humano.
O harness é sempre o Claude Code: tools, hooks, skills e comandos. O perfil do provedor só troca o endpoint, que precisa ser compatível com a API da Anthropic. Assim cada papel roda no modelo que você escolher.
Cadastro: /sdlc:models. Troca de um papel: /sdlc:adopt --dev deepseek.
| Provedor | Modelo padrão do catálogo | Bom para |
|---|---|---|
| Anthropic nativo | Sonnet · Opus · Haiku · Fable | planner e reviewer (recomendado) |
| DeepSeek (v4) | deepseek-v4-pro | dev, tester-e2e, document |
| GLM (Z.ai) | glm-5.3 | dev, tester-e2e, document |
| Kimi K3 | k3 | dev, tester-e2e, document |
| Qwen (Coding Plan) | qwen3.7-max | dev, tester-e2e, document |
| MiniMax | MiniMax-M2.7 | dev, tester-e2e, document |
| OpenCode Go | qwen3.8-max | dev, tester-e2e, document |
| Comando | Quem roda | Para quê |
|---|---|---|
| /sdlc:setup | você, uma vez por máquina | instalar e conferir o ambiente |
| /sdlc:models | você, uma vez por modelo | cadastrar provedor e chave |
| /sdlc:adopt | você, uma vez por repo | preparar o projeto e o team.json |
| /sdlc:up | você, por demanda | abrir o time |
| /sdlc:intent | planner | entrevista → intent/<slug>.md |
| /sdlc:team | planner | iniciar o pipeline com o time do roster |
| /sdlc:next | cada agente | fechar o estágio e passar o bastão |
| /entrega | planner | rubrica final da demanda |
| /sdlc:ops | sessão ops, opcional | vigiar CI e PRs e escrever intents novos |
| /sdlc:painel | você, quando quiser | quem roda ou espera você, pipeline, tokens, custo e Jev |