Agentes de Código
Ferramentas de assistência por IA utilizadas no desenvolvimento do local_helico. Cada desenvolvedor instala individualmente; os artefatos de runtime são ignorados pelo Git.
Princípio
Configuração compartilhada do projeto (regras, hooks, agentes) é versionada no repositório. Frameworks e skills instalados localmente são ignorados — cada desenvolvedor instala na sua máquina.
Agentes em uso
Claude Code
| Papel | IDE principal de desenvolvimento assistido por IA |
| Repositório | anthropics/claude-code |
| Instalação | npm install -g @anthropic-ai/claude-code |
| Configuração do projeto | .claude/ (versionado) — agents, commands, rules, hooks |
Claude Code é o agente principal. A configuração compartilhada do projeto fica em .claude/ e inclui:
- Agents (
.claude/agents/) — definições de agentes do workflow GSD - Commands (
.claude/commands/) — comandos customizados (GSD, VIGIM) - Rules (
.claude/rules/) — regras de governança (autoridade, handoff, lifecycle) - Hooks (
.claude/hooks/) — guards de workflow, SYNAPSE engine, session digest
GSD (Get Shit Done / gstack)
| Papel | Workflow de planejamento e execução de fases |
| Repositório | gsd-build/get-shit-done |
| Instalação | Skill do Claude Code — instalado via skill system |
| Configuração do projeto | .claude/get-shit-done/ (versionado) |
Skill integrado ao Claude Code que organiza o desenvolvimento em fases com planejamento, execução e verificação. Templates e workflows em .claude/get-shit-done/.
Caveman
| Papel | Comunicação comprimida, commit messages, code review, subagents |
| Repositório | JuliusBrussee/caveman |
| Instalação | Skill do Claude Code — ver README do repositório |
| Artefatos locais | .agents/, .claude/skills/, skills-lock.json (ignorados pelo Git) |
Skills que reduzem consumo de tokens (~75%) via comunicação comprimida. Inclui:
- caveman — modo de comunicação comprimida
- caveman-commit — mensagens de commit no formato Conventional Commits
- caveman-review — code review ultra-comprimido
- caveman-compress — compressão de arquivos de memória
- cavecrew — delegação para subagentes especializados (investigator, builder, reviewer)
AIOX
| Papel | Framework de orquestração multi-agente (SDC, QA Loop, Spec Pipeline) |
| Repositório | SynkraAI/aiox-core |
| Instalação | npx aiox-core install |
| Artefatos locais | .aiox-core/, .claude/commands/AIOX/ (ignorados pelo Git) |
Framework de workflows multi-agente com papéis definidos (@dev, @qa, @pm, @sm, @po, @architect, @devops). A instalação gera personas de agentes em .claude/commands/AIOX/ — esses arquivos são locais e não devem ser commitados.
VIGIM
| Papel | Vocabulário canônico (DDD), documentação, inventário de conteúdo |
| Origem | Interno (MIDDAG) — estendido de local/middag/.vigim/ |
| Configuração do projeto | .vigim/ (versionado, exceto data/) |
Sistema interno de gestão de vocabulário de domínio e pipeline de documentação, estendido do framework local_middag. Termos canônicos em .vigim/ddd/terms/, schemas LinkML em .vigim/ddd/linkml/.
Configuração complementar
.aiignore (Junie)
Arquivo de exclusão para o agente Junie (JetBrains AI). Protege diretórios core (/classes, /db, /lang, /ui) de edições não supervisionadas. Versionado no repositório.
O que é ignorado pelo Git
# Frameworks e skills de agentes (instalação local)
.aiox-core/ # AIOX framework
.claude/commands/AIOX/ # AIOX agent personas (geradas na instalação)
.agents/ # Caveman skills
.claude/skills/ # Symlinks para .agents/
skills-lock.json # Lock de versões caveman
.claude/settings.local.json # Permissões e hooks locaisEsses artefatos são de runtime — cada desenvolvedor instala e configura na sua máquina.