tacape

Um harness para agentes concluírem e verificarem trabalho de código.

Tacape é um harness de trabalho para agentes de código. Ele orienta o agente a encontrar o contexto certo, realizar a mudança completa e verificar o comportamento antes de declarar sucesso.

Não é linter, framework ou substituto das regras do projeto. AGENTS.md, CLAUDE.md e as convenções visíveis do repositório alvo sempre têm precedência.

Para bugs, features, refactors e reviews, Tacape exige que o agente:

1. Encontre os arquivos, chamadores e testes relevantes antes de editar.
2. Declare a ação ou o status atual de forma clara.
3. Faça a mudança completa, sem caminhos obsoletos ou trabalho pela metade.
4. Verifique o comportamento com teste focado ou smoke path.
5. Relate o resultado, a evidência e o próximo passo apenas se ainda houver trabalho.

O objetivo é simples: agentes devem concluir e verificar trabalho de código.

standard é o modo padrão: prosa profissional normal, idioma do usuário preservado, ação visível e etapas numeradas quando necessário.

concise deixa atualizações mais enxutas, sem sacrificar gramática, segurança ou verificação.

off desliga apenas a formatação de comunicação. Os contratos de execução, segurança e verificação continuam aplicáveis.

/tacape:tacape             mostra o modo atual
/tacape:tacape standard    usa prosa profissional normal
/tacape:tacape concise     remove filler e repetição
/tacape:tacape off         desliga a camada de comunicação

Valores antigos ou desconhecidos em ~/.claude/.tacape-mode voltam para standard. TACAPE_MODE substitui o modo para uma sessão.

Quando o pedido produz texto que alguém vai ler ou copiar, Tacape infere público e objetivo em vez de aplicar uma voz de agente:

• Venda ou marketing: benefício, prova e próximo passo.
• Produto ou UI: compreensão, escaneabilidade e conclusão da tarefa.
• Conteúdo técnico: precisão, pré-requisitos, exemplos e limites.
• Prosa editorial: voz, fluxo e entendimento do leitor.

Regras de ação, status e concise servem para a explicação do agente. Elas não se aplicam dentro do artefato solicitado. Evite em dashes em texto voltado a leitores, mas isso é uma preferência de escrita, nunca um hook, CI ou bloqueio de escrita.

Tacape aplica princípios independentes de linguagem e framework:

• código pesquisável, simples e seguro de editar;
• abstrações tardias e módulos com fronteiras claras;
• erros visíveis, validação nas bordas e estados inválidos difíceis de representar;
• tempo explícito, segredos protegidos e confirmação antes de ações irreversíveis;
• testes que defendem comportamento observável.

Leia o conjunto completo em skills/tacape-code/SKILL.md.

claude plugin marketplace add mateussatoh/tacape
claude plugin install tacape@tacape

codex plugin marketplace add mateussatoh/tacape --ref main
codex plugin add tacape@tacape

gemini extensions install https://github.com/mateussatoh/tacape

curl -fsSL https://raw.githubusercontent.com/mateussatoh/tacape/main/AGENTS.md -o AGENTS.md

Instalação completa, statusline e desinstalação: INSTALL.md.

bash tests/run.sh

A suíte verifica os manifestos, os modos de comunicação, a statusline e a consistência entre o contrato portátil e o skill da sessão.

Contribuições úteis trazem um caso reproduzível, uma mudança de contrato clara e a verificação correspondente. Não acrescente regras que substituam convenções do repositório alvo.

MIT.