{
  "markdown": "<p align=\"center\">\n  <strong>tacape</strong>\n</p>\n\n<p align=\"center\">\n  <img src=\"./tacape-banner.png\" width=\"474\" height=\"281\" alt=\"Banner do Tacape\">\n</p>\n\n<p align=\"center\">\n  Um harness para agentes concluírem e verificarem trabalho de código.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/mateussatoh/tacape/stargazers\"><img src=\"https://img.shields.io/github/stars/mateussatoh/tacape?style=flat&color=b5651d\" alt=\"Stars\"></a>\n  <a href=\"./INSTALL.md\"><img src=\"https://img.shields.io/badge/funciona_com-agentes-b5651d?style=flat\" alt=\"Agentes\"></a>\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/github/license/mateussatoh/tacape?style=flat\" alt=\"Licença\"></a>\n</p>\n\n## O que é\n\nTacape é 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\nNã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.\n\n## O contrato\n\nPara bugs, features, refactors e reviews, Tacape exige que o agente:\n\n1. Encontre os arquivos, chamadores e testes relevantes antes de editar.\n2. Declare a ação ou o status atual de forma clara.\n3. Faça a mudança completa, sem caminhos obsoletos ou trabalho pela metade.\n4. Verifique o comportamento com teste focado ou smoke path.\n5. Relate o resultado, a evidência e o próximo passo apenas se ainda houver trabalho.\n\nO objetivo é simples: agentes devem concluir e verificar trabalho de código.\n\n## Comunicação\n\n`standard` é o modo padrão: prosa profissional normal, idioma do usuário preservado, ação visível e etapas numeradas quando necessário.\n\n`concise` deixa atualizações mais enxutas, sem sacrificar gramática, segurança ou verificação.\n\n`off` desliga apenas a formatação de comunicação. Os contratos de execução, segurança e verificação continuam aplicáveis.\n\n```text\n/tacape:tacape             mostra o modo atual\n/tacape:tacape standard    usa prosa profissional normal\n/tacape:tacape concise     remove filler e repetição\n/tacape:tacape off         desliga a camada de comunicação\n```\n\nValores antigos ou desconhecidos em `~/.claude/.tacape-mode` voltam para `standard`. `TACAPE_MODE` substitui o modo para uma sessão.\n\n## Conteúdo para leitores\n\nQuando 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:\n\n- **Venda ou marketing:** benefício, prova e próximo passo.\n- **Produto ou UI:** compreensão, escaneabilidade e conclusão da tarefa.\n- **Conteúdo técnico:** precisão, pré-requisitos, exemplos e limites.\n- **Prosa editorial:** voz, fluxo e entendimento do leitor.\n\nRegras 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.\n\n## Princípios de engenharia\n\nTacape aplica princípios independentes de linguagem e framework:\n\n- código pesquisável, simples e seguro de editar;\n- abstrações tardias e módulos com fronteiras claras;\n- erros visíveis, validação nas bordas e estados inválidos difíceis de representar;\n- tempo explícito, segredos protegidos e confirmação antes de ações irreversíveis;\n- testes que defendem comportamento observável.\n\nLeia o conjunto completo em [`skills/tacape-code/SKILL.md`](./skills/tacape-code/SKILL.md).\n\n## Instalação\n\n### Claude Code\n\n```bash\nclaude plugin marketplace add mateussatoh/tacape\nclaude plugin install tacape@tacape\n```\n\n### Codex\n\n```bash\ncodex plugin marketplace add mateussatoh/tacape --ref main\ncodex plugin add tacape@tacape\n```\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/mateussatoh/tacape\n```\n\n### Outros agentes\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/mateussatoh/tacape/main/AGENTS.md -o AGENTS.md\n```\n\nInstalação completa, statusline e desinstalação: [INSTALL.md](./INSTALL.md).\n\n## Skills\n\n| Skill | Uso |\n|---|---|\n| `tacape` | Contrato da sessão, comunicação e conteúdo para leitores |\n| `tacape-code` | Escrever, refatorar e revisar código |\n| `tacape-commit` | Criar mensagens Conventional Commits |\n| `tacape-review` | Revisar diffs e ordenar achados por severidade |\n\n## Verificação\n\n```bash\nbash tests/run.sh\n```\n\nA 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.\n\n## Contribuição\n\nContribuiçõ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.\n\n## Licença\n\nMIT.\n",
  "bytes": 4704,
  "sha": "5687c5683ad06936f8fb9507a8381527055c1e39b392e26a150767d8608c0791",
  "repo_slug": "mateussatoh/tacape",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_mateussatoh_tacape_185a73e5/readme"
}