Sistema de 8 agentes especializados para desenvolvimento de software com Claude Code, com Autopilot para execução automatizada do pipeline completo.
# Instalar globalmente
npm install -g @evolve.labs/devflow
# Inicializar no seu projeto
devflow init /caminho/para/seu-projeto
# Ou usar npx (sem instalar)
npx @evolve.labs/devflow initdevflow init # Agentes + estrutura de docs (padrao)
devflow init --agents-only # Apenas agentes (minimo)
devflow init --full # Tudo incluindo .gitignoredevflow init [path] # Inicializar DevFlow num projeto
devflow update [path] # Atualizar instalacao existente
devflow autopilot <spec-file> # Rodar autopilot nos agentes
devflow challenge [review-file] # Review adversarial com OpenAI (standalone)Flags do devflow update:
devflow update # Atualiza se houver nova versao
devflow update --force # Re-copia todos os arquivos mesmo se versao ja e igual
devflow update --source <path> # Usa repo local como fonte (dev workflow)
devflow update --force --source <path> # Forcado + repo localDev workflow (apos editar o repo local):
npm run reinstallpara atualizar o CLI global, depoisdevflow updateno projeto.
-
Claude Code CLI (
npm i -g @anthropic-ai/claude-code) - Node.js 18+
- Git (recomendado)
| # | Agente | Funcao | Uso |
|---|---|---|---|
| 1 | /agents:strategist | Planejamento & Produto | Requisitos, PRDs, user stories |
| 2 | /agents:architect | Design & Arquitetura | Decisoes tecnicas, ADRs, APIs |
| 3 | /agents:system-designer | System Design & Escala | SDDs, RFCs, capacity planning, SLOs |
| 4 | /agents:builder | Implementacao | Codigo, reviews, refactoring |
| 5 | /agents:guardian | Qualidade & Testes | Testes, regressao, performance, coverage |
| 6 | /agents:sentinel | Seguranca & Vulnerabilidades | OWASP, CVEs, CVSS, STRIDE, secrets |
| 7 | /agents:challenger | Review Adversarial (OpenAI) | Perspectiva externa independente (o3) |
| 8 | /agents:chronicler | Documentacao & Memoria | CHANGELOG, snapshots, stories |
Cada agente tem hard stops — limites rigidos que impedem de fazer trabalho de outros agentes.
Challenger requer
OPENAI_API_KEY— usa OpenAI o3 como perspectiva independente do Sentinel.
strategist → architect → system-designer → builder → guardian → sentinel → challenger → chronicler
Ativado automaticamente (sem argumento extra). Usa o Agent tool do Claude para criar workers isolados em paralelo.
/agents:builder implemente autenticacao JWTAtivado com o argumento team. Usa Claude Agent Teams (peers que se comunicam diretamente entre si).
/agents:builder team implemente autenticacao JWT
devflow initconfigura isso automaticamente. Para instalaçoes existentes:devflow update.
| Modo Padrao | Modo Team | |
|---|---|---|
| Trigger | sem argumento | argumento team
|
| Comunicacao | Pai → Filho | Peers direto |
| Setup | Automatico | Flag experimental |
| Custo | 1x tokens | 3-5x tokens |
| Quando usar | Sub-tarefas independentes | Debate/revisao entre peers |
Use /agents:team para orquestracao cross-domain com todos os 8 agentes em paralelo.
O autopilot executa os agentes em sequencia automaticamente com Persistent Memory, Adaptive Planning e Context Isolation.
# Rodar todas as fases
devflow autopilot docs/specs/minha-spec.md
# Adaptive: LLM decide quais fases rodar (TRIVIAL/SIMPLE/MODERATE/COMPLEX)
devflow autopilot docs/specs/minha-spec.md --adaptive
# Com Challenger (review adversarial OpenAI apos guardian)
devflow autopilot docs/specs/minha-spec.md --challenger
# Fases especificas
devflow autopilot docs/specs/minha-spec.md --phases "strategist,architect,builder"
# Desativar context isolation (usa todo o historico)
devflow autopilot docs/specs/minha-spec.md --full-context--phases <list> # Fases especificas (default: todos os 8 agentes)
--adaptive # LLM escolhe fases por complexidade
--full-context # Desativa context isolation (N-1 output por padrao)
--challenger # Review OpenAI apos guardian (requer OPENAI_API_KEY)
--challenger-model <model> # gpt-5.4 (default), o3-mini, o3
--no-update # Nao marcar tasks como concluidas automaticamente
--verbose # Tokens por fase + memory stats
--project <path> # Projeto alvo (default: cwd)# Review adversarial do guardian output (requer OPENAI_API_KEY)
devflow challenge
# Passando arquivo especifico
devflow challenge docs/security/guardian-review.md
# Com spec para contexto
devflow challenge docs/security/guardian-review.md --spec docs/specs/feature.md
# Modelo (gpt-5.4 padrao, o3 para casos criticos)
devflow challenge --model o3| Modelo | Custo/review | Quando usar |
|---|---|---|
gpt-5.4 |
~$0.01 | Padrao — rapido, code-focused |
o3-mini |
~$0.03 | Reasoning alternativo |
o3 |
~$0.28 | Seguranca critica, compliance, pagamentos |
Comandos do @chronicler que mantêm a documentação e o mapa do projeto sempre em dia, aterrados no código (nada inventado, segredos nunca entram):
/quick:wiki init # gera docs/wiki/ — wiki navegavel do codigo, otimizada para agentes
/quick:wiki update # atualiza so as paginas afetadas (diff desde o ultimo commit)
/quick:graph check # reconcilia o knowledge graph com as fontes (reporta drift)
/quick:graph regenerate # reconstroi .devflow/knowledge-graph.json a partir das fontes-
Repo Wiki (
docs/wiki/): indice emquickstart.md+ secoes por area real (architecture, workflows, api…). Todo no aponta para um arquivo que existe. -
Knowledge Graph (
.devflow/knowledge-graph.json): agentes, ADRs, features e docs conectados — regeneravel e verificavel. -
Diff-Impact no
@guardian: usa o grafo para calcular o ripple de uma mudanca e alimentar o Regression Map antes do merge.
seu-projeto/
├── .claude/
│ ├── settings.json # Agent Teams habilitado (automatico)
│ └── commands/
│ ├── agents/ # Definicoes dos 8 agentes + team
│ └── quick/ # Quick start commands
│
├── .devflow/
│ ├── agents/ # Metadata dos agentes
│ └── project.yaml # Estado + versao do projeto
│
└── docs/
├── decisions/ # ADRs
├── planning/ # Stories e specs
├── snapshots/ # Historico do projeto
└── system-design/ # SDDs, RFCs, capacity plans
├── sdd/
├── rfc/
├── capacity/
└── trade-offs/
| Versao | Features |
|---|---|
| v0.1.0 | Multi-agent system, Documentation automation |
| v0.2.0 | Structured metadata, Knowledge graph |
| v0.3.0 | Hard stops, Mandatory delegation |
| v0.4.0–v0.7.0 | Web IDE, System Designer agent, npm package |
| v0.8.0 | Autopilot terminal-based, CLI commands |
| v1.0.0 | Security hardening, npm global install fix |
| v1.1.1 | Dual Scaling Modes: Parallel Subagents + Claude Agent Teams |
| v1.2.0 | Remocao da Web IDE, Persistent Memory, Adaptive Autopilot, Context Isolation, Challenger |
| v1.2.5 | Agent Teams habilitado por padrao no init/update |
| v1.2.8 | Spawn templates com contexto obrigatorio para teammates |
| v1.2.9 | Cores por agente, scores do challenger, artefatos persistidos, complexidade adaptativa |
| v1.3.1 | Security fix SEG-01, /quick:refactor + /quick:debug, challenger.md reescrito, bug fixes |
| v1.4.0 | @sentinel: agente de segurança dedicado, @guardian refocado em testes + Regression Map |
| v1.5.0 | Repo Wiki + Knowledge Graph aterrado/regeneravel, Guardian Diff-Impact |
- Quick Start - Comece em 5 minutos
- Instalacao - Guia detalhado
- Arquitetura - Como funciona
- Changelog - Historico de mudancas
MIT License - veja LICENSE para detalhes.
DevFlow v1.5.0 - Desenvolvido por Evolve Labs
