AGENTS.md — Workflow TDD para Agentes IA
realtrung/AGENTS.md
TDD iterativo com execução autônoma para agentes de código
Ver no GitHubFramework disciplinado para agentes de código que organiza trabalho em iterações, slices e tarefas, aplicando Test-Driven Development (Red-Green-Refactor) com documentação persistente. Automatiza loops de execução autônoma, mantendo contexto de produto e status em arquivos `.building/`.
Instalação
npx convez-ai realtrung/AGENTS.md1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Coordenar agentes IA em projetos de desenvolvimento com ciclos de teste estruturados
- Manter documentação viva (product context, planos, deliverables) entre sessões
- Executar slices inteiras end-to-end seguindo RGR (Red-Green-Refactor)
- Rastrear progresso de tarefas e artefatos sem aprovações manuais por tarefa
Veredito

Abordagem robusta e opinativa para estruturar agentes IA em fluxos de trabalho previsíveis. Ideal para quem quer rigor de TDD + autonomia do agente, mas exige disciplina na documentação e compreensão clara de iterações/slices/tarefas.
README
A tradução para o português deste README ainda está na fila.
AGENTS.md
A disciplined workflow for AI coding agents — iteration-based planning, test-driven execution, and lightweight documentation that persists across sessions.
What it does
Five constraints that keep agents focused:
- Iteration → Slice → Task hierarchy — work flows top-down; one task at a time.
- Autonomous execution loop — write
task-plan.md, implement, writetask-report.md, updatedelivered.md; no per-task approval gates. - Slice run mode — the
run-sliceskill executes an entire slice end-to-end, task by task, following the RGR cycle. - Test-Driven Development — follow the Red-Green-Refactor cycle with typed commits (
test,feat,refactor) for each phase. .building/docs — product context, iteration plans, status tracking, and delivered outcomes.
Quick start
curl -O https://raw.githubusercontent.com/realtrung/agents.md/main/AGENTS.md
For Claude Code, symlink it:
ln -s AGENTS.md CLAUDE.md
The spec
Read the full workflow: AGENTS.md