DIÁRIO DE BORDO

Changelog

Cada versão do plugin, da fundação do método à governança autônoma do time. Todo PR que toca o plugin sobe a versão.

38versões documentadas
322commits no main
58decisões registradas (D1–D59)
38 diasda 0.1.0 à 0.22.2
  1. 2026-10-09
    0.22.2NOVOGovernança autônomasdlc 0.22.0–0.22.2 · kit 0.16.0 · D57MARCO
    • Um time por projeto. O /sdlc:up não pede mais slug. As sessões são <papel>-<projeto>, e o dev é dev-<projeto>. O mesmo time executa todas as demandas: cada demanda tem o próprio slug e a própria branch, e o dev só troca de branch. O planner nunca pede time novo para tarefa nova.
    • Autônomo por padrão. O time decide sozinho tudo o que está fora da lista fechada de escala (credencial, produção, ação irreversível, regra de negócio ambígua).
    • Plano em pasta própria. Fica em docs/planos/<plano>/ e se divide em front-end, back-end ou geral, depois em módulos e depois em fases, cada fase com o seu spec.md. O backlog mostra o lado, o módulo e a fase de cada item.
    • Rubrica com o parecer de todos. Cada tarefa tem rubrica-<tarefa>.md, com uma seção do dev, do reviewer, do tester-e2e e do document. O planner consolida a rubrica da fase e a do módulo, e tudo vai para o git por PR de docs.
    • E2E no navegador, com checklist. O tester gera o checklist da tarefa e testa cada item no navegador visível, guardando a evidência. Item aberto ou falho barra o estágio.
    • Portões por código. A demanda não fecha sem rubrica completa, e o e2e não passa com checklist pendente.
    • Suíte final 100% verde. No fim do plano, backlog.sh final roda a suíte inteira no código já mergeado (recusa checkout desatualizado). Só com tudo verde sai a rubrica-final.md, e o resultado fica num arquivo protegido.
    • Trava contra edição pelo Bash. Os arquivos de estado (pipeline, selo, backlog, resultado da suíte) passam a ser protegidos também contra escrita pelo terminal, não só pelo editor.
    • Novos comandos no planner: /rubricas: planos, fases e rubricas, com a suíte final ✓ ou ✕; Enter abre a rubrica. /prs: PRs entregues, com link e merge. A faixa de progresso agora mostra o plano, o lado, o módulo e a fase atuais.
  2. 2026-10-07
    0.20.3CORREÇÃOSegredo não aparece mais na saída do update-all
    • O claude plugin update repete o comando dos hooks, e esse comando pode trazer variáveis com token (por exemplo AI_MEMORY_AUTH_TOKEN=...).
    • Agora todo valor de *TOKEN*, *SECRET*, *KEY* e *PASS* sai como <redacted>, com ou sem aspas.
  3. 2026-10-07
    0.20.2NOVOscr é o estilo padrão de toda sessãoD56
    • Em toda sessão. Toda resposta final começa com [scr] e segue o scr: simplifique, comprima, reescreva. Vale em qualquer sessão do Claude Code, não só no time.
    • O que não muda. Código, commits e PRs continuam normais. eli, foc, ref e /caveman seguem disponíveis sob pedido. Os agents do time mantêm o próprio estilo: [scr] no planner, [eli] nos outros.
    • Caveman desligado. O update-all grava defaultMode: "off" na configuração do plugin caveman e tira CAVEMAN_DEFAULT_MODE do ~/.claude/settings.json, porque essa variável vence a configuração.
    • Outras máquinas. Rode /sdlc:setup ou o update-all uma vez e abra uma sessão nova.
  4. 2026-10-07
    0.20.1NOVOFaixa mais fiel: mostra a demanda em curso mesmo quando ela não está no backlog, como um hotfix aberto à parte.
    • Faixa mais fiel. A faixa da fábrica mostra a demanda em curso mesmo quando ela não está no backlog, como um hotfix aberto à parte.
    • Máquina nova. O tutorial do README explica como os mods chegam a outra máquina: instalar ou atualizar o plugin sdlc, ter o Claude Code ≥ 2.1.287 e abrir uma sessão nova. Não há passo extra.
    • Versão mínima. O /sdlc:setup passa a exigir o Claude Code 2.1.287, a primeira versão com mods.
  5. 2026-10-06
    0.20.0NOVOA fábrica dentro do Claude Codekit 0.15.0 · D55MARCO
    • Feito com os mods do Claude Code, interfaces desenhadas no próprio terminal. Sem servidor, e nada sai da máquina.
    • Faixa de progresso. Fica sempre acima do prompt do planner, por exemplo: Fábrica · backlog 12/14 · 86% ▓▓▓▓▓▓▓▓░ · agora: wa-documento-pasta em pr · ⚠ 1. Relê os arquivos a cada 5 s. O ⚠ conta demanda bloqueada e pendência urgente.
    • /fabrica. Painel com três abas: b Backlog: cada demanda com status, PR e merge; d Demanda: os estágios da demanda atual (✓ feito, ▶ em curso, · falta), com o tempo de cada um; p Pendências.
    • /pendencias. Painel com os grupos Urgente e Pode esperar: 1–9 marca ou desmarca; r manda "Resolva as pendências selecionadas…" ao planner; i ignora.
    • Abre sozinho. O painel aparece quando surge pendência nova, sem tirar o foco do prompt. Para usar as teclas, digite /pendencias.
    • Pendências em arquivo (kit 0.15.0). O planner grava em specs/pendencias.json só o que passa no filtro de pendência real; trivial e opcional ficam fora. Cada item tem texto, evidência, dono, o que destrava e urgência. O planner preserva o que você marcou ou ignorou.
    • Só no planner. Faixa e painéis aparecem apenas na sessão do planner (SDLC_ROLE=planner) de projeto adotado. Em qualquer outra sessão do Claude Code o mod não registra comando nem lê arquivo.
  6. 2026-09-30
    0.19.0NOVOTravas determinísticas · Velocidade com o Jevkit 0.14.0 · D53 · D54MARCO
    • Travas determinísticas (D53), inspirado no Canny: só fatos bloqueiam, e nada sai da máquina.
    • Segredo nunca vai para arquivo. O agent é barrado ao gravar chave real (AWS, GitHub, Stripe live, OpenAI, Anthropic, chave privada) em código ou por comando. Isentos: .env ignorado pelo git; a chave de exemplo oficial da AWS; .claude/sdlc/permitir-segredo, onde o planner libera fixtures de teste.
    • Teste não some às escondidas. Remover caso de teste, pôr .skip/.only ou apagar arquivo de teste é barrado. Se for intencional, o planner libera em .claude/sdlc/permitir-teste. it.each conta as linhas da tabela.
    • Teste vermelho não se esconde no tail. npm test | tail passa a rodar com pipefail, então a falha aparece.
    • Sem repetir o mesmo erro. Mesmo comando, mesma falha e o código sem mudar entre uma tentativa e outra: na 2ª vez o agent recebe um aviso, e a 4ª é barrada. Quem edita o código entre as tentativas segue normal, como no TDD.
    • Velocidade com o Jev (D54), inspirado num vídeo da AI Labs sobre usos do Jev e na regra do Canny "o Jev aconselha, não bloqueia".
    • Triagem antes do review. Antes do primeiro review, o Jev responde se o diff mexe em autenticação, dados, pagamento, testes, API pública ou infra. Tudo "não" → review rápido. Qualquer risco, ou diff grande → review completo, como antes.
    • Aviso de regra por área. Quando o dev edita código, o Jev avisa se a mudança provavelmente quebra uma regra do projeto, como "nunca hex/rgb em componente". É só aviso, nunca bloqueio, e tem limite de chamadas por sessão.
    • Privacidade. O diff vai ao Jev já sem tokens e senhas, e "jev_diff": false no team.json desliga o envio no projeto.
  7. 2026-09-29
    0.18.0NOVOSó o planner fala com você · CI no loop, PR draft e CI local · curl com o Jevkit 0.13.0 · D52 · D50 · D51
    • Só o planner fala com você (D52). Dev, reviewer, tester e document nunca pedem nada ao usuário. Bloqueio vira mensagem ao planner, que resolve ou te chama numa mensagem só, pela lista fechada de escala.
    • CI no loop, PR draft e CI local (D50). PR draft que vira pronta. O time abre a PR como draft, e o script a marca como pronta só no fim: review aprovado, E2E ok, docs feitas e CI não vermelha. No modo normal você só vê PR pronta.
    • CI vermelha volta na hora. Na revisão da PR, o script lê a CI: falha que rodou volta ao dev com o link; CI pendente não faz o review esperar.
    • Modo "ci": "local". Para quem não usa GitHub Actions pago. O merge-pr ignora os checks do GitHub e roda de novo, localmente, o verify no commit exato da PR. A CI do GitHub, se existir, vira segunda camada.
    • Billing do Actions detectado. Job que nem iniciou (falta de cota ou pagamento) vira bloqueio para o humano, sem devolver ao dev um problema que não é dele.
    • curl com o Jev, no lugar do bloqueio total (D51). Antes: a regra deny bloqueava qualquer curl, até para localhost, e os agents ficavam pedindo ao humano.
    • Agora: localhost passa direto; para fora, o Jev classifica: teste de API passa; envio de dump, .env ou segredo é bloqueado e vai ao planner; o comando é redigido antes de ir ao Jev; pega curl atrás de timeout, xargs, if e similares, de heredoc executado e de proxy.
    • Correções. Ninguém edita pipeline.json nem .selo à mão. O update-all leva as regras novas do protected-paths aos projetos já adotados.
  8. 2026-09-29
    0.17.0NOVOO loop converge sozinhokit 0.12.0 · D49
    • Inspirado no Archon: o time corrige, revisa de novo e só para quando está pronto.
    • Revisão de continuação. Da 2ª rodada em diante, o reviewer confere só os achados anteriores e o que mudou desde o último commit revisado, sem revisar tudo de novo. Se o dev reescreveu o histórico (amend, rebase), a revisão volta a ser completa.
    • O dev pode contestar. Achado errado não prende mais o loop. O dev contesta com evidência (--note "contesto <gap>: …"), e o reviewer decide: aceita ou mantém com contra-evidência. Contestação sem evidência não vale.
    • Veredito replan. Quando corrigir exigiria sair do plano, o reviewer ou o tester devolvem replan, em vez de queimar tentativas. O planner replaneja uma vez sozinho e reabre a demanda. Só o 2º replan chega ao humano.
    • Mais fôlego. A feature passa de 3 para 5 tentativas antes de escalar, porque feature de verdade precisa de 4 a 6 rodadas.
    • O painel mostra o status replanejar.
    • Adiado: reaproveitar teste que já estava vermelho na base. A revisão independente provou que, do jeito que foi feito, ele deixaria passar um teste quebrado pelo dev em projeto JS. Volta redesenhado.
  9. 2026-09-28
    0.16.0NOVORubrica de entrega, e bug corrigido pelo time · Autocompactação dos agents · Commits sem co-autorkit 0.11.0 · D46 · D47 · D48
    • Toda demanda termina com uma rubrica, e não com uma lista de bugs (D46).
    • Acabou o pedido de aprovação para corrigir bug. Bug achado na demanda volta ao dev pelo loop. Bug fora do escopo é registrado em docs/bugs.json, e o planner abre o hotfix sozinho. No modo autônomo, o hotfix entra na frente da fila (/sdlc:backlog hotfix).
    • O humano só é chamado numa lista fechada: falta de credencial ou acesso, regra de negócio ambígua, ação irreversível ou em produção, feature nova, sessão que não volta, loop esgotado depois de um replanejamento. Intent, plano e merge continuam com o humano.
    • Autocompactação dos agents (D47). Agents em modelos não-Anthropic (DeepSeek, GLM) travavam perto de 1M tokens e só voltavam com /clear.
    • Agora os perfis com janela de 1M compactam por volta de 500 mil tokens, bem antes do limite.
    • No fim de cada estágio, o agent do time (menos o planner) que passou de 150 mil tokens compacta sozinho. A compactação guarda o papel, as decisões e "onde parei", e descarta o que é de estágios já fechados.
    • npx . update no claude-agent-kit mescla as configurações novas nos perfis já instalados, sem apagar nada.
    • Commits sem co-autor (D48). A atribuição do Claude Code fica desligada por configuração, no projeto e no usuário. Nenhum agent assina commit ou PR como co-autor.
    • Relançar só parte do time não apaga mais os outros papéis do roster.
  10. 2026-09-28
    0.15.1NOVOPR só de docs no modo autônomokit 0.10.1 · D45
    • PR de intents, planos e docs não tem pipeline, e o time travava esperando o humano mergear.
    • O planner pede a revisão com [docs-pr <N>] e mergeia com merge-pr.sh --docs <N>. As condições: review aprovado sobre o commit atual da PR, CI verde e diff só em intent/, specs/ e docs/.
  11. 2026-09-28
    0.15.0NOVOGates por código: o agent propõe, o script decide · Painel: alertas e temposkit 0.10.0 · D43 · D44MARCO
    • Inspirado no super-simple-software-factory.
    • Verify: no pass do build, o pipeline roda os comandos de teste, lint e build do projeto (team.json → verify). Vermelho volta ao dev com o log. O /sdlc:adopt preenche a lista a partir do package.json.
    • Fronteira: o pipeline tira uma foto do código no início do estágio. Reviewer, tester ou document que mexer onde não pode (inclusive via Bash, commit ou git checkout) bloqueia a demanda para o planner. Nada é desfeito automaticamente.
    • Veredito coerente: para aprovar, o reviewer grava um JSON com cada requisito e a evidência, feito sobre o commit atual. Aprovação com item bloqueante é recusada. Reprovar exige dizer qual requisito falhou.
    • Selo: o estado da demanda (pipeline.json) só muda pelo script. Edição fora dele é detectada.
    • O reviewer não roda a suíte de novo quando o verify já passou no mesmo commit, o que economiza tokens.
    • Painel: alertas e tempos (D44). Alerta quando o dono do estágio está sem sessão, parado sem passar o bastão ou em silêncio há muito tempo.
    • Tempo por estágio e por papel no histórico da demanda.
  12. 2026-09-27
    0.14.0NOVOAba Fábrica no painelD42
    • Uma aba nova no /sdlc:painel mostra: o modo (autônomo ou não) e os agents vivos; o backlog e o loop: progresso, demanda atual, PR e merge; a divisão do dev: partes, modelo escolhido pelo Jev, suítes; as travas acionadas pelos hooks e os merges recusados.
    • Selos no cartão de cada projeto: autônomo, backlog x/y, travas.
  13. 2026-09-27
    0.13.0NOVOModo autônomo por projeto · Divisão obrigatória do dev e atualização completa · Guardrailskit 0.9.2 · D40 · D39 · D41MARCO
    • Modo autônomo por projeto (D40). Ligar: /sdlc:up <slug> --autonomo. Ligado, o time leva cada demanda do plano ao merge sem gate humano de PR. Desligar: --sem-autonomo.
    • Só o planner mexe no GitHub (push, PR, merge). Os outros agents commitam local. Force push e push em main são barrados para todos.
    • Merge seguro (merge-pr.sh): só com review da PR aprovado, CI verde, sem conflito e base certa. Merge recusado devolve a demanda ao dev.
    • Loop do backlog: specs/backlog.json + /sdlc:backlog. O planner fecha uma demanda e puxa a próxima sozinho até acabar o planejamento.
    • Testado de ponta a ponta num repositório real do GitHub.
    • Divisão obrigatória do dev e atualização completa (D39). Antes de codar, o dev monta o mapa requisito → arquivos. Com 2 ou mais grupos separados, ele sempre divide em subagents.
    • O update-all (chamado pelo /sdlc:setup) atualiza os plugins do usuário e de cada projeto, a persona e a atualização automática. Nenhum projeto fica preso em versão antiga.
    • Guardrails (D41). Apagar ou arquivar repositório pede confirmação humana, em qualquer sessão, mesmo em bypass. Aprovado, executa.
    • Agents sem bloqueio de ferramentas. Os agents do time herdam todas as ferramentas e MCPs (ai-memory, Kaneo, Chrome, web).
  14. 2026-09-25
    0.10.1DOCSA persona global aponta para _setup/README.md no ai-memory, a fonte única para instalar ou atualizar uma máquina.
    • A persona global aponta para _setup/README.md no ai-memory, a fonte única para instalar ou atualizar uma máquina. O ponteiro agora vive no template, então o /sdlc:setup não o apaga mais.
  15. 2026-09-25
    0.10.0NOVOO dev divide a tarefa em subagents, e o Jev escolhe o modelo de cada partekit 0.8.0 · D38MARCO
    • Com duas ou mais partes em arquivos separados, o dev grava specs/<slug>/partes.json e roda o comando novo /sdlc:nivel.
    • O Jev (TypeSafe) dá uma nota de complexidade para cada parte, numa chamada só. A nota vira haiku, sonnet ou opus.
    • O dev abre um subagent por parte, em paralelo, cada um no seu worktree. Depois junta tudo na branch dele e roda a suíte completa.
    • O nível aponta para o slot do perfil do dev. Com GPT, Qwen, MiniMax ou OpenCode Go, cada nível usa o modelo configurado ali. Teste com opencode-go: haiku → qwen3.8-flash, opus → qwen3.8-max.
    • Travas: Confiança baixa → sonnet. Jev fora do ar ou sem chave → modelo do próprio dev, sem bloquear. Parte com teste vermelho → refaz um nível acima.
    • Custo típico: cerca de mil tokens por tarefa, menos de US$ 0,0001.
    • O painel conta uma chamada do Jev por tarefa, não uma por parte.
  16. 2026-09-25
    0.9.3NOVOMemória com escopo explícito · Hooks só em projeto adotadokit 0.7.1 · D36 · D37
    • O projeto da memória é o campo project do .ai-memory.toml na raiz do repo, e nunca o nome da pasta, do worktree ou da branch.
    • A busca usa o projeto e o _global. A gravação usa workspace + project. Lição que vale para qualquer projeto vai para o escopo global.
    • O /sdlc:adopt cria o .ai-memory.toml: o nome vem do repo do remote ou da flag --memory-project, e --memory-exclude deixa o arquivo fora do git.
    • O /sdlc:setup e o /sdlc:adopt avisam quando os hooks do ai-memory não têm AI_MEMORY_PROJECT_STRATEGY=repo-root.
    • Hooks só em projeto adotado (D37). As regras do sdlc só valem em projeto que tem .claude/sdlc/. Em qualquer outro projeto, nenhum hook do método bloqueia.
    • O gate de deploy barra só a execução de um deploy de produção. Texto que só cita as palavras (mensagem de commit, grep) passa.
  17. 2026-09-25
    0.9.1NOVOai-memory como cérebro principalkit 0.7.0 · D35
    • A persona global manda consultar a memória antes de planejar ou decidir, e gravar ao fechar trabalho: entrega, merge ou fim de sessão.
    • No time, o planner aciona o document depois de cada entrega, merge ou encerramento. O document grava um capítulo em notes/entrega-<slug>.md.
  18. 2026-09-25
    0.9.0NOVOPlanner só planeja; estilo visível na respostakit 0.6.0 · D34
    • Hook novo planner-paths: o planner não escreve código fora de specs/, docs/, intent/ e .claude/. Todo código vai ao dev do time.
    • O hook no-spawn barra só quem executa o lançador do time. Ler ou citar o arquivo passa.
    • O planner responde sempre no estilo scr (simplifique, comprima, reescreva), com a etiqueta [scr] na primeira linha. Dev, reviewer, tester-e2e e document respondem no estilo eli (explicação curta), com [eli]. A etiqueta mostra que o agent roda a versão nova.
    • Atualização automática: autoUpdate ligado para sdlc e claude-agent-kit. O Claude Code avisa quando atualiza; basta reiniciar o time.
  19. 2026-09-24
    0.8.2DOCSPersona global: foco no problema atual até fechar.
    • Persona global: foco no problema atual até fechar. Outros problemas achados no caminho viram uma linha registrada, sem proposta de solução. O próximo só abre quando o atual fecha ou o usuário manda trocar.
  20. 2026-09-23
    0.8.1NOVOMerge com autorizaçãokit 0.4.4 · D32
    • gh pr merge saiu da lista de comandos bloqueados.
    • Sem autorização, o planner ou o dev perguntam quem faz o merge e mostram a PR e o resultado do review.
    • Com autorização do usuário, dada para uma PR ou como regra permanente ("PR aprovada no review pode mergear"), eles fazem o merge.
  21. 2026-09-22
    0.8.0NOVOJev confere a entrega do build em modo sombra; aba Jev no painel com chamadas, custo e respostas (D31).MARCO
  22. 2026-09-18
    0.7.2NOVO/sdlc:models repassa o auth_header do catálogo de provedores.
  23. 2026-09-18
    0.7.1DOCSPerfil de provedor ganha auth_header: suporte ao OpenCode Go (D30).
  24. 2026-09-11
    0.7.0NOVOComando /sdlc:painel: observabilidade de tarefas, sessões, tokens e custo (D29).MARCO
  25. 2026-09-05
    0.6.0DOCSUm time por projeto: vários projetos em paralelo na mesma máquina (D26).
  26. 2026-09-05
    0.5.1NOVOKaneo substitui o Linear; persona com pesquisa obrigatória e bloco de pendências.
  27. 2026-09-05
    0.5.0NOVOroster.json e hook no-spawn: só o /sdlc:up abre sessões (D24).MARCO
  28. 2026-09-04
    0.4.4DOCSModelo recomendado por papel e troca via /sdlc:adopt --<papel>.
  29. 2026-09-04
    0.4.3CORREÇÃOInventário por pasta do projeto no /sdlc:team e no /sdlc:up.
  30. 2026-09-04
    0.4.2CORREÇÃO/sdlc:models encontra o catálogo do kit.
  31. 2026-09-04
    0.4.1NOVO/sdlc:up abre as abas no workspace do projeto no herdr.
  32. 2026-09-04
    0.4.0MANUT.Versão 0.4.0 e teste de estrutura atualizado.
  33. 2026-09-04
    0.3.3CORREÇÃOSlug normalizado no /sdlc:up (o herdr exige minúsculas).
  34. 2026-09-04
    0.3.2NOVOpr_base por projeto: worktree e PR nascem da branch base configurada.
  35. 2026-09-03
    0.3.1DOCSREADME vira guia completo: instalação, modelos, adoção, uso e problemas.
  36. 2026-09-03
    0.3.0NOVOTime no herdr com modelo por papel (team.json).MARCO
  37. 2026-09-03
    0.2.0CORREÇÃOInstalação reinstala cache incompleto; regra de versionamento.
  38. 2026-09-02
    0.1.0NOVOFundação do método: persona, contrato com o kit, decisões e skills.MARCO

Como atualizar

claude plugin marketplace update sdlc && claude plugin update sdlc@sdlc
claude plugin marketplace update claude-agent-kit && claude plugin update claude-agent-kit@claude-agent-kit
/sdlc:setup

Depois rode /sdlc:setup. Ele roda o update-all, que atualiza os plugins do usuário e de cada projeto (escopo de projeto incluído), a persona, a atualização automática e os guardrails.

Para aplicar a janela de contexto nova aos perfis de modelo já instalados, rode npx . update na pasta do claude-agent-kit.

Sessões abertas só carregam a versão nova quando são reabertas. Reinicie o time inteiro de uma vez; relançar só parte dele mistura versões.