convez.ai
AgenteAutomaçãoIntermediário
realtrung

AGENTS.md — Workflow TDD para Agentes IA

realtrung/AGENTS.md

TDD iterativo com execução autônoma para agentes de código

Ver no GitHub
InicialPluginScore · de 0 a 100

Framework 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.md

1 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

Estrelas
2
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

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, write task-report.md, update delivered.md; no per-task approval gates.
  • Slice run mode — the run-slice skill 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

License

CC0 1.0

Ver o original no GitHub

Bom para

Relacionados