Skip to content

Agentes de Código

Ferramentas de assistência por IA recomendadas para o projeto — instalação, papel e configuração

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 locais

Esses artefatos são de runtime — cada desenvolvedor instala e configura na sua máquina.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close