# agent-graph-flow

> **Um agente de IA que entrega software rápido, usando as melhores práticas de
> engenharia de software, com custo de token brutalmente baixo.**

Local-first. Sem Docker, sem infra externa. O PRD vira um **grafo de execução
persistente** (SQLite); o agente roda um ciclo autônomo **SHAPE → BUILD → SHIP**
com guardrails (TDD obrigatório, DoD, WIP=1, sandbox `workspace-write`), e mede o
próprio custo de tokens.

É o nascimento enxuto da RFC [`token-economy-redesign`](docs/strategy/token-economy-redesign.md):
copia o motor provado do `graph-flow` e **omite por nascimento** o dashboard React,
a API REST, a captura web e os verticais — ~53% de superfície cara que desvia da promessa.

## Por que agora

Em 1-jun-2026 o GitHub Copilot migrou todos os planos para billing medido por token.
A dor do mercado virou "custo imprevisível e alto". A resposta deste projeto é
**custo brutalmente baixo e previsível**, com disciplina de engenharia de verdade
(não vibe-coding): estrutura determinística > loop de agente solto
(Agentless, AutoCodeRover, ACI).

## Status

🚀 **M0-M5 completo (v0.13).** Core engine, TUI visualization, orchestrator, parity scanner,
quality gate 95/95, multi-provider, artifact reuse, CLI↔TUI parity — todos entregues.
Proximo ciclo: v0.14 (integration gaps). Ver roadmap em `CLAUDE.md`.

## Dev

```bash
npm install
npm run dev -- --help     # smoke
npm test                  # vitest
npm run typecheck
npm run build             # tsup → dist/
```

## Licença

AGPL-3.0-or-later.