Codex Gigas: Jardim Digital como Base de Skills para Agentes
O Codex Gigas é o jardim digital que sustenta este plano de estudos: cada nota que você lê aqui também alimenta as skills descritas em agentic-best-practices.
Duas funções, um repositório
O projeto nasceu como caderno de estudos, mas cresceu para cumprir dois papéis distintos e complementares:
- Base de material de estudo: notas atômicas em
src/notas/, conectadas por[[wikilinks]]e organizadas por categoria (Frontend, Backend, LLM, Visão Computacional etc.). O objetivo é reter e revisar conhecimento técnico — desde React até algoritmos de detecção de objetos como r-cnn. - Fábrica de skills para agentes de IA: o mesmo conteúdo vira insumo para
.claude/skills/, pastas que empacotam um fluxo de trabalho (ex: skill-ui-validation) em instruções reutilizáveis por outros projetos.
Como uma nota vira skill
O caminho de uma ideia até virar automação segue sempre a mesma direção:
- Nota primeiro. Um problema recorrente (ex: CSS quebrando sem o agente perceber) vira nota documentando o “porquê” e o “como”.
- Extração do procedimento. Se o fluxo é repetível e vale a pena travar como processo, ele migra para um
SKILL.md— um contrato rígido de passos que qualquer agente deve seguir. - Roteamento via
CLAUDE.md. O arquivo mestre do projeto aponta o gatilho (“sempre que alterar CSS…”) para a skill, sem poluir as instruções globais com o procedimento inteiro. - Portabilidade. A skill, sendo apenas Markdown + scripts, é copiável para
.claude/skills/de qualquer outro repositório — o Codex Gigas funciona como um catálogo de skills validadas em produção neste próprio jardim.
⚠️ Armadilha: nem toda nota vira skill. Só vale extrair quando o processo é repetitivo, tem passos verificáveis (lint, testes, screenshots) e economiza contexto que, do contrário, precisaria ser reexplicado a cada sessão.
Por que bilíngue
Cada nota nasce em par (<slug>.md PT-BR + <slug>.en.md EN) porque parte do objetivo é praticar technical-english — uma das lacunas identificadas no plano de estudos — enquanto o conteúdo técnico permanece útil para consumo por agentes e por outras pessoas independentemente do idioma de origem.
Relacionadas: agentic-best-practices · skill-ui-validation · plano de estudos.