code-agents

Coleção de subagentes para Claude Code.

Desenvolvidos como material de apoio ao curso Dev com IA, usando Laravel/PHP como base — mas aplicáveis a qualquer stack.

Agentes disponíveis

Agente	Invocação	O que faz
biblioteca	use o agente biblioteca	Gerencia catálogo de livros via API REST, com busca automática de metadados na Open Library
code-reviewer	use o agente code-reviewer	Checklist básico de segurança e qualidade: SQL injection, XSS, secrets, N+1, memory leaks
code-reviewer-better	use o agente code-reviewer	Fluxo completo com OWASP Top 10, critérios de severidade (CRITICAL/HIGH/MEDIUM/LOW) e relatório estruturado
migration-expert	use o agente migration-expert	Cria e revisa migrations Laravel com boas práticas de schema, indexes e reversibilidade

Atenção: code-reviewer.md e code-reviewer-better.md têm o mesmo name no frontmatter. Mantenha apenas um deles no diretório .claude/agents/ — caso contrário o comportamento é indefinido.

Instalação

Clone este repositório dentro do seu projeto:

cd seu-projeto
git clone git@github-curso:maisquedev/code-agents.git .claude/agents

Ou como submódulo Git, para manter atualizações:

git submodule add git@github-curso:maisquedev/code-agents.git .claude/agents

Estrutura

.claude/agents/
├── biblioteca.md
├── code-reviewer.md
├── code-reviewer-better.md
├── migration-expert.md
└── docs/
    ├── exemplo-biblioteca.md
    └── texto-para-CLAUDE.md

Transparência de subagentes

O arquivo docs/texto-para-CLAUDE.md é um trecho para adicionar ao CLAUDE.md do seu projeto. Ele instrui o Claude a exibir um relatório sempre que subagentes forem utilizados, mostrando quais foram invocados, quais arquivos acessaram e se rodaram em paralelo.

Para ativar, copie o conteúdo do arquivo para o CLAUDE.md na raiz do seu projeto:

cat .claude/agents/docs/texto-para-CLAUDE.md >> CLAUDE.md

Links úteis

Subagentes no Claude Code

• Build with Claude Code — Subagents

Frontmatter YAML

• YAML front matter — Assemble
• Front Matter — Jekyll
• Usar front matter YAML — GitHub Docs

---

Sobre este repositório

Este repositório é parte do curso Dev com IA — um curso prático para desenvolvedores que querem usar inteligência artificial no dia a dia do trabalho, de verdade, sem enrolação.

Você aprende a criar seus próprios agentes, automatizar tarefas repetitivas e escrever código melhor e mais rápido com a ajuda do Claude Code — usando Laravel como exemplo, mas com conceitos que funcionam em qualquer linguagem.

🔗 Saiba mais em dev-com-ia.sim10.com

---

Licença MIT