Agentic Codebase

O que ele constrói para você

• Transforma seus "que raios?!" em proteções.
• Cada "não, não é assim" vira uma regra.
• Transforma "por que você fez isso?!" em um hook que impede.
• Cada .env que seu agente espiou vira uma proteção.
• Cada prompt que você digitou três vezes vira uma skill.
• Cada PR que você revisou à mão vira um agente revisor.
• Cada "sim, execute" que você clicou vira uma permissão.
• Tudo que você reexplica a cada sessão vai para CLAUDE.md.
• Cada serviço que você menciona vira um rascunho de MCP.
• Seus xingamentos, refatorados em regras.

Ele leu cada vez que você gritou com seu agente. Depois corrigiu o motivo.

[!IMPORTANT]

🔒 Roda 100% na sua máquina

• Esta ferramenta não envia nada, para lugar nenhum. Sem servidores. Sem conta. Sem telemetria.
• Zero chamadas de rede. Apenas biblioteca padrão do Python. Nada para pip install.
• Transcrições precisam do seu "sim", a cada execução. Apenas seus prompts. Segredos removidos antes de qualquer coisa ser escrita.
• Nunca lê segredos. Sem valores de .env. Sem arquivos de credenciais.
• Nunca toca na sua branch. Constrói em agentic-setup/<date>. Nunca faz push.

Seu agente continua falando com o próprio modelo, como sempre. Esta ferramenta não adiciona nada por cima.

Instalar

Um comando. Funciona para ambos.

npx skills add Agentic-Studio-Pvt-Ltd/agentic-codebase

Depois, no seu agente:

run agentic-codebase on this repo

Requisitos: Python 3.9+. git opcional.

/plugin marketplace add Agentic-Studio-Pvt-Ltd/agentic-codebase
/plugin install agentic-codebase@agentic-codebase

[!WARNING] Codex: confie no repositório primeiro. Repositório não confiável → AGENTS.md, hooks e regras silenciosamente não carregam. Defina trust_level = "trusted" para o repositório em ${CODEX_HOME:-~/.codex}/config.toml.

Antes / Depois

BEFORE                         AFTER
my-app/                        my-app/
├── CLAUDE.md                  ├── CLAUDE.md             + indexed section
└── src/                       ├── .claude/
                               │   ├── rules/            one per code zone
                               │   ├── skills/           setup-manager, review-pr, qa …
                               │   ├── agents/           pr-reviewer, db-inspector …
                               │   └── settings.json     hooks + permissions
                               ├── .mcp.json             drafts, you authenticate
                               ├── docs/agentic-setup/   plan.md · report.md
                               └── src/

_{Exemplo no Claude Code. O Codex recebe o mesmo formato. Veja a tabela abaixo.}

O que ele gera

Cada arquivo: um ID · uma data · a evidência por trás dele · "Seguro para excluir ou editar."

Quanto ele constrói

• Sem limites. Tudo que seu código e histórico suportam.
• Você corta no plano. Nada é escrito antes de você aprovar.
• Cada arquivo rastreia uma contagem. Sem evidência → não é construído.
• Pulado apenas se: sem evidência · já coberto · baixa confiança.
• setup-manager: mantém a configuração atualizada
• pr-reviewer + review-pr: revisão de PR
• qa: qualquer aplicação web
• db-inspector + query-db: qualquer banco de dados, somente leitura
• security-auditor: revisão de segurança
• designer + new-component: repositórios de UI
• product-analyst + skills de analytics: repositórios com analytics
• 3 hooks de proteção: vazamento de env · comandos destrutivos · gerenciador de pacotes errado
• Permissões: seus comandos permitidos, .env* negados
• Regras: uma por zona de código
• Skills de fluxo de trabalho: qualquer coisa que você pedir 3+ vezes

Como funciona

Segurança

Não fará

• Configurar servidores MCP com credenciais. Apenas rascunhos, você autentica
• Cursor, Windsurf, Gemini CLI
• Versão hospedada ou web
• Detecção de drift (no roadmap)
• Reescrever, mover ou renomear sua configuração existente
• Fazer push ou abrir um PR

Desinstalar

[!NOTE] Desfaça a partir de report.md, não daqui. Está escrito para sua execução exata, incluindo arquivos gitignorados e não rastreados que uma exclusão de branch não toca.

Contribuindo

• Leia CLAUDE.md primeiro.
• scripts/: analisadores. Apenas stdlib. Sem rede. Saída JSON.
• SKILL.md + references/: o fluxo de trabalho. Agnóstico de agente.
• adapters/: o único lugar onde caminhos e formatos específicos de agente vivem.

for s in discover mine_git mine_transcripts verify_artifacts; do
  python3 skills/agentic-codebase/scripts/$s.py --selftest
done
python3 -m unittest discover -s tests -v

Licença

MIT. Atribuição bem-vinda, nunca obrigatória. Remova e tudo continua funcionando.