Changelog

Todas as mudanças notáveis do Makuco. Versão atual: 3.3.0.

3.3.0

Adicionado

• Modo INVESTIGAÇÃO no makuco-analisar: bug entra pelo mesmo fluxo de uma feature nova. Você descreve o que quebrou; o agente resolve quais fontes o projeto realmente tem (código, log, métrica, tracker, borda), monta a cadeia causal com arquivo:linha fixado num commit, executa os falsificadores que só leem e manda a tese para um subagente adversarial tentar derrubar antes de escrever o laudo. Sai rca.md + refutacao.md, e daí para frente é o fluxo de sempre: PRD, PBIs de correção, makuco-desenvolver e makuco-code-review. A análise nunca corrige. Veja Investigação de bug.
• .makuco/integrations/observability.yml. O makuco init passa a criá-lo, inteiro comentado: não configura nada e não custa pergunta. Cada bloco é um papel (log, métrica, runtime, borda…), não um produto. A primeira investigação que precisar de um papel pergunta uma vez e grava a resposta; papel que o projeto não tem vira lacuna declarada no laudo. Veja Configurações → Observabilidade.
• Modo EXPRESS no makuco-analisar. Um card do Azure DevOps (ou requisitos colados) vira PRD e uma PBI num passo só, sem brainstorming, sem gate e sem decomposição. O card é lido inteiro — campos, comentários e todas as imagens, que são abertas uma a uma —, as lacunas são perguntadas antes de montar qualquer coisa, e o que a origem não diz fica visível como Não informado na origem — a confirmar. Nenhum work item é criado. Veja Analisar → Modo EXPRESS.
• Fontes de contexto do projeto. Os agentes passam a consultar as bases de conhecimento que o time já mantém — um servidor MCP, uma pasta no disco, um endereço web —, declaradas em .makuco/integrations/context-sources.yml ou, preferencialmente, publicadas no Hub como skill context-source-<nome>. O makuco init oferece declarar uma. Veja Configurações → Fontes de contexto.
• SonarQube e verificação de complexidade ficaram opcionais, e vêm desligados. O makuco init pergunta se o projeto quer esses dois gates e grava a escolha em .makuco/integrations/quality-gate.yml. Desligados, os agentes rodam só o que o projeto já tem — build, lint e testes — e mostram os dois gates como DESATIVADO. O makuco-mcp continua instalado. Veja Configurações → Gates de qualidade.
• O makuco-desenvolver conduz o review sozinho. Ao fechar a PBI ele chama o makuco-code-review e, com NECESSITA CORREÇÕES, corrige as tasks apontadas e pede nova rodada — até duas; depois, a decisão volta para você. A PBI só é concluída, e o card só é finalizado, depois que existe veredito. Veja Desenvolver → O ciclo de review.
• Dúvidas técnicas numa rodada só, antes da spec. O makuco-desenvolver varre o código e pergunta de uma vez o que a codebase não decide (ou decide com dois padrões vivos), com arquivo:linha em cada opção. As respostas viram a tabela Decisões técnicas da spec.md; o que ficar sem resposta é EM ABERTO e é reperguntado na execução.
• A nomenclatura é decidida antes do código, pela sua codebase. O idioma dos identificadores e o termo de cada conceito são resolvidos no começo: padrão claro no projeto é seguido; padrão ausente ou duplicado vira pergunta. "Domínio em inglês" passou a ser um default que só vale quando o projeto não decidiu, e o revisor mede contra o padrão do projeto.
• A pesquisa de codebase entrega valor operacional. O makuco-project-research passa a produzir o registro de risco (risks.md, o oitavo arquivo), as três tabelas de testes (matriz de cobertura, avaliação de paralelismo e comandos de gate), o guia de mudança ("ao mexer em X, verifique Y"), a armadilha que faz um comando documentado falhar em silêncio no topo do arquivo, e o rastro de data e commit no cabeçalho de todo arquivo gerado. Veja Configurações → O que a pesquisa entrega.

Alterado

• SOLUÇÃO virou interrogatório de negócio. Em vez de técnicas de brainstorming, o modo percorre uma árvore de decisão (dor → fluxo → regras → limites) em rodadas de 3 a 5 perguntas, cada uma com a resposta recomendada. Requisitos e critérios de aceite são derivados das respostas, métrica de sucesso nunca é pedida, e pergunta técnica fica para o desenvolvimento.
• O review dimensiona a si mesmo. Mudança pequena e sem risco roda o perfil leve; qualquer sinal de risco (autenticação, entrada externa, segredo, dinheiro, migração, deleção) sobe o perfil por menor que seja o diff. O perfil é declarado no relatório, junto com o que não rodou.
• Cinco passes de review viraram três. Bugs e segurança fundiram em makuco-reviewer-correctness; qualidade e padrões, em makuco-reviewer-design; testes seguem em makuco-reviewer-tests. As skills antigas são oferecidas para remoção no próximo makuco update.
• Relatório de review mais enxuto. suggestion não é emitida por padrão (só com --completo) e minor tem teto de 5, agrupadas por causa.
• Rodada de correção é verificação, não review inteiro. A partir da segunda rodada, o review responde "foi corrigido?" e procura regressão só no diff da correção. Só bloqueiam os achados que ficaram abertos, os que a correção introduziu e critical novo; um major novo fora da correção vira observação. Achado que o agente considera falso-positivo é contestado por escrito, e a rodada seguinte responde mantido ou aceito.
• major deixa de ser re-verificado quando a prova já está à mão. critical continua passando pela verificação inteira.
• O gate caro roda uma vez só, depois que o review aprovou: cobertura, checklist e SonarQube não medem mais a PBI antes do review e de novo a cada rodada.
• Ter um sonar-project.properties no projeto não liga mais o gate do Sonar — quem liga é o quality-gate.yml. Com a complexidade desligada, os limites de tamanho de função e de arquivo também deixam de ser cobrados.
• Documento de codebase de versão anterior vira oferta, nunca regravação. A pesquisa distingue ausente, desatualizado e fresh, oferece completar as seções que faltam e, recusada, não grava nada. O tamanho de cada arquivo passou a ser conferido antes da gravação.

Corrigido

• O escopo incremental da re-review não funcionava: o commit revisado nunca era gravado, então toda rodada nova relia a branch inteira em silêncio. Agora ele é gravado de fato.

As skills instaladas num projeto só mudam depois de rodar makuco update (ou makuco init) nele.

---

3.2.0

Adicionado

• A CLI interativa. makuco sozinho deixou de imprimir um banner e passou a abrir uma interface no terminal que dirige o fluxo: lê os artefatos do projeto, deriva qual é o próximo passo, invoca a skill certa e mostra o agente trabalhando — mensagens, chamadas de ferramenta, diffs, pedidos de permissão e perguntas. Veja CLI Interativa.
• Tela inicial com três portas: desenvolver uma feature nova, continuar uma em andamento, ou abrir uma conversa vazia com o agente — sem skill, sem alvo e sem artefato.
• Comandos de barra na caixa de prompt: /workflow, /skills, /usage, /steps, /next, /skip, /model, /theme, /settings, /sidebar, /commit, /clear, /yolo e os demais. Lista completa em Comandos /.
• Toda skill do ambiente virou comando: /makuco-desenvolver, /makuco-backend, e também as suas próprias, de ~/.claude/skills/ e dos plugins habilitados. O texto depois do comando vira instrução para a skill.
• Lateral com o consumo de contexto, o uso da assinatura com barra e horário de reset, a árvore de arquivos do git e um botão Fazer commit.
• Visualizador de arquivo: clique num arquivo da lateral e leia o conteúdo com realce de sintaxe, com as linhas alteradas na sessão marcadas em verde. Markdown abre formatado.
• Commit em um clique, pensado para quem não usa git direto: escolha os arquivos, dê uma instrução opcional, e o agente aprende a convenção de mensagem do repositório, commita só o que foi marcado e empurra — perguntando antes quando a branch é main ou master.
• Perguntas do agente viram wizard: uma aba por pergunta, alternativas navegáveis pelo teclado ou pelo mouse, resposta escrita quando nenhuma opção serve, e Esc que pula sem matar o turno.
• Modo yolo (--yolo, /yolo ou Shift+Tab): a CLI encadeia os passos e aprova toda permissão sem perguntar, com o estado sempre visível na tela.
• Política de permissão: leitura local é auto-aprovável; editar, apagar, mover, executar e buscar na rede sempre perguntam. Veja Modos e permissões.
• makuco run <skill> [alvo]: roda um turno de analisar ou desenvolver sem interface, para script e automação. Veja Headless e CI.
• Cinco temas (one-dark, dark, light, dracula, nord) e escolha de modelo por provider, com modal de seleção e pré-visualização do tema.
• Aviso de versão nova no arranque, com atualização e reabertura automáticas.
• Título da aba do terminal: 🐦 Makuco — <pasta>:<branch>, limpo na saída.

Alterado

• A sessão pertence à skill, não ao alvo. PBIs seguidos da mesma skill reaproveitam o processo vivo em vez de pagar uma abertura por alvo — uma feature de seis PBIs paga uma, não seis.
• Quem conduz os passos internos é o agente. A CLI escolhe qual skill rodar e em qual alvo, e passa o alvo como sugestão para o agente conferir contra o disco. Ela não tenta controlar os passos de dentro da skill.
• A CLI para e pede licença sempre que um alvo fecha, antes de seguir para o próximo. O modo yolo é o que dispensa essa parada.
• .makuco/config.yml ganhou as chaves provider, models, autoApprove, theme e sidebar, com precedência padrões < ~/.makuco < projeto < flags. Veja Configuração.

Requisitos

• Node.js ≥ 20 para instalar. O runtime da interface (Bun) vem no pacote — não instale com --no-optional nem --omit=optional.
• Claude Code instalado e autenticado para a CLI interativa. O makuco init, o makuco update e o makuco unit sync continuam sem essa dependência.

---

3.1.0

Adicionado

• Comando makuco unit sync: traz o conteúdo novo da unidade do seu time sem reinstalar o projeto inteiro. Antes, a única forma de atualizar a unidade era rodar o makuco init de novo, que repergunta tudo. O que você não mexeu atualiza sozinho, o que você customizou abre uma pergunta, e o que você apagou volta.
• Comandos makuco skill add, makuco agent add e makuco prompt add: instalam uma skill, um agente ou um prompt de qualquer unidade, não só da que configura o seu projeto. O item passa a ser atualizado junto com o resto.
• Fixar a versão de um item, para quando você não quer que ele mude sozinho. Sem fixar, ele acompanha o que a unidade publica.
• Catálogo web do Makuco Hub: consulte as unidades publicadas e o que cada uma oferece antes de instalar.

Alterado

• O conteúdo das unidades passa a vir do Makuco Hub. Unidade nova aparece na lista sem exigir versão nova da CLI, e o que é instalado fica registrado no projeto — é isso que permite atualizar depois sem perguntar tudo de novo.
• O makuco update cuida só do que vem no pacote da CLI. O conteúdo da unidade tem comando próprio agora. Quando há conteúdo de unidade no projeto, o update avisa e manda rodar o makuco unit sync, para a unidade não ficar parada em silêncio.
• Nada é substituído sem uma cópia de segurança. Antes de trocar qualquer arquivo que você alterou, a versão anterior é guardada no projeto.
• Aviso antes de instalar conteúdo que executa código na sua máquina — ele vem do Hub e roda com as suas permissões.

Removido

• A configuração de unidade por clone de repositório com chave SSH. Quem usava esse caminho passa a receber o conteúdo pelo Hub, e a chave SSH deixa de ser pré-requisito para instalar o Makuco. Corte direto, sem coexistência.

---

3.0.0

Adicionado

• Skill makuco-code-review: revisão de ponta a ponta que você invoca direto, fechando o ciclo analisar → desenvolver → code-review. Roda sete passes — conformidade com a spec, análise do diff, qualidade, testes, segurança, bugs e padrões do projeto —, confere cada critério de aceite contra o código e devolve APROVADO ou NECESSITA CORREÇÕES. Nunca altera código: os achados voltam para o makuco-desenvolver.
• Contexto por repositório: cada repo ganha um OVERVIEW.md (papel no negócio, quem consome, mapa de módulos) e, quando é grande, um doc por módulo. A leitura de contexto passa a começar por aí em vez de abrir tudo.
• Índice de repositórios no MAKUCO.md com o papel de negócio e o mapa de módulos de cada repo — dá para ir direto ao assunto sem abrir outro arquivo.
• A pesquisa de projeto pergunta o escopo antes de começar e mostra o custo, e pode ser retomada de onde parou em vez de refazer tudo.
• Testes de conteúdo das skills no npm test: estrutura, links, contratos entre os arquivos e as regras que cada skill promete cumprir.
• Skills makuco-analisar (oportunidade → PRD + PBIs validadas por INVEST, nos modos DESCOBERTA e SOLUÇÃO) e makuco-desenvolver (PBI → código commitado, com spec, tasks atômicas e gates), que junto com o makuco-code-review formam o trio que conduz o trabalho de ponta a ponta.
• Skills especialistas de domínio makuco-backend, makuco-frontend e makuco-ux, acionadas por roteamento por gap derivado dos docs de codebase do próprio projeto — sem tabela de palavras-chave de stack.
• Integração opcional com Azure DevOps pela skill makuco-azure-devops, com tipos, estados e campos resolvidos do config do projeto ou descobertos em runtime. Sem ela, o Makuco roda 100% local-only.
• Comando makuco update: atualiza os ativos instalados preservando o que você alterou, com --check, --verbose, --policy e --allow-downgrade.
• Clone de repositórios pela CLI durante o makuco init, com suporte a workspace multi-repo em repos/.

Alterado

• Você não invoca mais nenhum agente. Sobraram três, e dois são acionados pelas skills: o makuco-copy-writer ao final de cada etapa que produz artefato canônico, e o makuco-documentation pelo makuco-code-review quando o veredito é APROVADO. O makuco-quick é o único que você chama direto.
• Documentação deixou de depender da sua memória. Antes o artefato de review mandava você rodar o makuco-documentation à mão, e documentação esquecida era o caso comum. Agora o review a aciona ao aprovar, atualiza os docs afetados e grava learnings.md. Em NECESSITA CORREÇÕES nada é acionado; em modo diff avulso também não, porque não há PBI nem stage para gravar.
• As rotas de Próximo passo dos artefatos agora apontam para as skills. Antes o review.md mandava você voltar para um agente de implementação; agora manda para o makuco-desenvolver, que é onde o trabalho realmente acontece.
• Fora do stage estimate, nada mudou nos artefatos nem no status.yml. Os mesmos stages continuam sendo gravados, com os mesmos nomes — quem gravava era um agente, agora é uma skill.
• Contexto é lido em camadas — visão geral, depois o módulo do assunto, depois o detalhe técnico — em vez de carregar todos os docs de uma vez.
• Pesquisa de projeto ficou muito mais barata: indexar um monólito custa o mesmo que indexar um utilitário, e etapa já feita e atualizada não roda de novo.
• Falta de contexto em vários repositórios não dispara mais pesquisa completa em todos — só no repositório que a tarefa toca.
• makuco init sempre cria a pasta repos/ e atualiza o índice, mesmo quando nenhum repositório é clonado.
• makuco init não reescreve o MAKUCO.md quando nada mudou, evitando diff falso no git.

Removido

• Nove agentes saíram do pacote, junto com os prompts que os disparavam. Oito deles faziam uma etapa que hoje uma das três skills orquestradoras já faz de ponta a ponta, e manter as duas entradas significava manter duas descrições da mesma etapa, divergindo com o tempo. O que sai e para onde vai:
  • makuco-discovery, makuco-structure, makuco-business-analyst, makuco-technical-analyst → makuco-analisar
  • makuco-specify, makuco-plan, makuco-codegen → makuco-desenvolver
  • makuco-reviewer → makuco-code-review
  • makuco-estimate → sem substituto; a estimativa saiu do fluxo
• Com o makuco-estimate saíram também a skill de formatação makuco-artifact-estimate e o stage estimate do status.yml — sem produtor, os dois eram peso morto. Os campos horas_ia/horas_humano/horas_estimadas continuam no frontmatter das tasks, agora como opcionais: quem quiser preencher, preenche.
• Prompts makuco-specify, makuco-plan e makuco-codegen. Sobra o start-makuco, que monta a base de conhecimento do projeto e não depende de agente nenhum.
• Quem vinha da v2 perde os nove agentes no próximo makuco init. Se você dependia de um deles, a substituição está na lista acima — exceto a estimativa, que não tem.

Corrigido

• Analisar, desenvolver e o quality gate resolvem tudo no próprio fluxo, sem abrir sessões separadas no meio do caminho.
• Analisar avisa antes de criar uma segunda análise para uma feature que já tem documentos, em vez de duplicar em silêncio.
• O índice de repositórios não perde mais as descrições ao clonar repositórios novos.
• MAKUCO.md com um dos marcadores do índice faltando não é mais reescrito: o CLI avisa qual falta, em vez de apagar o conteúdo entre eles.

2.1.1

Alterado

• Atualização de dependências internas para melhorar a confiabilidade e segurança do projeto

2.1.0

Adicionado

• Integração com makuco-docs-mcp para leitura de contexto de produto e negócio pelos agentes
• Seleção automática de produto: o agente pergunta e lembra a escolha, sem precisar configurar manualmente

2.0.6

Alterado

• Melhorias internas na organização do código

2.0.5

Corrigido

• Melhorias na confiabilidade durante a instalação e configuração inicial do projeto
• Correções de qualidade de código

2.0.4

Corrigido

• Maior confiabilidade na configuração inicial do projeto
• Melhorias na integração com o proxy de terminal

2.0.3

Adicionado

• Skill de referências/artefatos para os agentes
• Instrução explícita para salvar artefatos em assets/

Alterado

• Agentes atualizados para uso da nova skill de referências/artefatos

2.0.2

Corrigido

• Ajustes internos na geração de artefatos

2.0.1

Adicionado

• Permissões base para o agente Claude Code, incluindo acesso a comandos Bash para operações de arquivos e diretórios, com restrições específicas para segurança.

2.0.0

Adicionado

• Novo fluxo spec-driven: handoff de sessão, gerenciamento de estado e templates de tarefas
• Agente de modo rápido (makuco-quick) para mudanças simplificadas
• Agente de copywriter (makuco-copy-writer) para criação de conteúdo
• Guia de uso do framework Makuco com estrutura, agentes e fluxos de trabalho
• Template de status para acompanhamento de progresso de features
• Suporte a referências de protótipos nos agentes de codegen, discovery e revisão

Alterado

• Reescrita dos agentes: makuco-codegen, makuco-plan, makuco-reviewer e makuco-specify
• Atualização de referências de ferramentas nos agentes de análise de negócio, discovery e técnico
• Constraint rigoroso aplicado ao agente de revisão (makuco-reviewer)

Removido

• Agente arquiteto (makuco-architect) substituído pelo novo fluxo de agentes
• Documentação obsoleta de gerenciamento de estado, validação e geração de spec

1.1.1

Adicionado

• Melhorias na experiência

1.1.0

Adicionado

• Modo de comunicação Caveman: respostas mais concisas e econômicas em tokens
• Otimização de tokens nas operações de desenvolvimento via proxy de terminal
• Configuração global centralizada com controle de verbosidade dos agentes
• Feedback visual durante a execução dos comandos (indicador de progresso e cores)

Alterado

• Maior estabilidade e flexibilidade na configuração do projeto

1.0.22

Adicionado

• Suporte ao Claude no MCP
• Integração com Figma no MCP com novos prompts

1.0.21

Adicionado

• Suporte ao Figma nos arquivos de configuração

1.0.20

Adicionado

• Skills para boas práticas de código, revisão de segurança, geração de spec, escrita de tarefas e práticas de testes

Alterado

• Melhorias no agente arquiteto para geração de diagramas

1.0.19

Adicionado

• Agentes Makuco para arquitetura, análise de negócio, geração de código, prompting e especificação

1.0.18

Alterado

• Agente arquiteto integrado ao MCP Makuco para geração de diagramas

1.0.17

Corrigido

• Melhorias gerais de qualidade

1.0.16

Adicionado

• Skill de diagrama PlantUML no agente arquiteto

Removido

• Conversão de diagrama PlantUML para imagem

1.0.15

Adicionado

• Suporte à criação de arquivos de prompt durante a inicialização

1.0.14

Adicionado

• Skill de pesquisa de projeto Makuco e documentação relacionada

Alterado

• Melhoria na organização dos arquivos de prompt e quality gate

1.0.13

Alterado

• Melhorias internas de configuração e estabilidade

1.0.12

Adicionado

• Suporte ao gerenciamento de diretórios de skills customizados
• Melhorias no pipeline de CI/CD

1.0.11

• Ajustes de versionamento e configuração do pipeline de publicação.

1.0.10

• Atualizada a configuração do registro npm e do publish no Azure Artifacts.

1.0.9

• Adicionadas instruções de configuração do SonarQube e MCP.

1.0.8

• Adicionado MAKUCO.md para referência dos agentes Makuco.

1.0.7

• Criado template para prompt, refatorado system-prompt dos agentes de planejamento e codificação.

1.0.6

• Adicionados agentes de análise e arquitetura, criadas skills para criação de requisitos e diagramas.

1.0.5

• Adicionado agente de especificação, para melhoria do workflow, seguindo a metodologia SDD.

1.0.4

• Refatorado o processo de configuração para melhorar a experiência do usuário e corrigir bugs relacionados à criação de arquivos de configuração.

1.0.3

• Melhorado tratamento de erros e estabilidade geral.

1.0.2

• Adicionada a enumeração de unidades e a configuração para a unidade Lughy no processo de inicialização do Makuco CLI.

1.0.1

• Adicionados agentes de frontend, mobile e geração de código.

1.0.0

• Configuração inicial do Makuco CLI.