tacape
Coding-work harness that helps agents complete and verify work through action-first structure and language-agnostic engineering rules.
Open source Open in the app JSON README (API)
About
Coding-work harness that helps agents complete and verify work through action-first structure and language-agnostic engineering rules.
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- mateussatoh
- Origin
- gemini
- Category
- ferramentas
- Version
- 0.7.0
- Stars
- 1
- Last push
- 2026-07-26T21:06:43Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
mateussatoh/tacape
README
<p align="center"> <strong>tacape</strong> </p> <p align="center"> <img src="./tacape-banner.png" width="474" height="281" alt="Banner do Tacape"> </p> <p align="center"> Um harness para agentes concluírem e verificarem trabalho de código. </p> <p align="center"> <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> <a href="./INSTALL.md"><img src="https://img.shields.io/badge/funciona_com-agentes-b5651d?style=flat" alt="Agentes"></a> <a href="LICENSE"><img src="https://img.shields.io/github/license/mateussatoh/tacape?style=flat" alt="Licença"></a> </p> ## O que é 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. ## O contrato 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. ## Comunicação `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. ```text /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. ## Conteúdo para leitores 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. ## Princípios de engenharia 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`](./skills/tacape-code/SKILL.md). ## Instalação ### Claude Code ```bash claude plugin marketplace add mateussatoh/tacape claude plugin install tacape@tacape ``` ### Codex ```bash codex plugin marketplace add mateussatoh/tacape --ref main codex plugin add tacape@tacape ``` ### Gemini CLI ```bash gemini extensions install https://github.com/mateussatoh/tacape ``` ### Outros agentes ```bash curl -fsSL https://raw.githubusercontent.com/mateussatoh/tacape/main/AGENTS.md -o AGENTS.md ``` Instalação completa, statusline e desinstalação: [INSTALL.md](./INSTALL.md). ## Skills | Skill | Uso | |---|---| | `tacape` | Contrato da sessão, comunicação e conteúdo para leitores | | `tacape-code` | Escrever, refatorar e revisar código | | `tacape-commit` | Criar mensagens Conventional Commits | | `tacape-review` | Revisar diffs e ordenar achados por severidade | ## Verificação ```bash 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çã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. ## Licença MIT.