
Octopus
O problema
Todo time que adota um AI coding agent em escala acaba escrevendo
o mesmo tipo de configuração várias vezes: as convenções de código
do projeto, as convenções de commit do time, os guardrails de
segurança, os playbooks de on-call, os rituais de post-mortem.
Essa config vira tribal: um CLAUDE.md longo, uma
pasta de .cursor/rules/*, um
copilot-instructions.md pela metade. Cada agent fala
um dialeto diferente da mesma ideia.
O Octopus é a camada de configuração que fica acima de todos eles. Uma única fonte de verdade — bundles, skills, hooks, roles, knowledge — que compila para o formato que cada agent espera. Adicionar um agent novo, mudar uma coding rule, lançar um audit novo: uma edição só, todas as superfícies atualizadas.
Os cinco primitivos
- Bundles —
pacotes opinados de skills + roles + rules afinados para um
arquétipo de time (
starter,quality,docs,backend,growth). - Skills —
protocolos que o agent engaja por match de descrição ou
invocação explícita (
debug,doc-prd,refactor-deepen,audit-config, mais 30+). - Commands
— slash commands que fixam uma skill específica em uma invocação
tipada (
/octopus:debug,/octopus:context-handoff, …). - Hooks — scripts de ciclo de vida que reforçam disciplina automaticamente: formatar ao salvar, bloquear git destrutivo, propor updates no CLAUDE.md no fim da sessão.
- Roles —
personas para as quais o usuário pode delegar
(
@architect,@backend-developer,@writer, …) que escopam o comportamento do agent para uma tarefa.
Instalar
macOS / Linux
curl -fsSL https://github.com/leocosta/octopus/releases/latest/download/install.sh | bashWindows (PowerShell)
irm https://github.com/leocosta/octopus/releases/latest/download/install.ps1 | iex
Depois rode octopus update dentro de qualquer repo
para gerar os arquivos de configuração dos agents. Walkthrough
completo na página de
Início Rápido.
Workflows em destaque
- TDD em uma nova feature — fatias verticais tracer-bullet, testes de integração, banimento explícito de slicing horizontal.
- Audit pré-merge em mudança de billing — compõe auditorias de security + money + tenant + cross-stack contract em paralelo.
- Handoff de uma sessão — compacta a conversa em um doc tmp com sugestões prescritivas de próximas skills para o agent sucessor.