#AI Dev Superpowers V3

Transforme qualquer IA de código em um desenvolvedor sênior com práticas TDD e padrões profissionais.

#O que é?

AI Dev Superpowers é um framework que configura agentes especializados, skills e regras para guiar IAs de código (Claude Code, Antigravity, Gemini, Cursor, etc.) a trabalharem com:

• TDD Mandatório — RED → GREEN → REFACTOR
• YAGNI — Só implemente o necessário
• DRY — Não repita código
• Evidências — Prove que funciona, não apenas afirme

---

#Instalação

#Método 1: One-Liner (Recomendado)

curl -sSL https://raw.githubusercontent.com/nandinhos/aidev-superpowers-v3/main/install.sh | bash

#Método 2: Manual

git clone https://github.com/nandinhos/aidev-superpowers-v3.git
export PATH="$PATH:$(pwd)/aidev-superpowers-v3/bin"
cd seu-projeto
aidev init

---

#🚀 Novidades da v4.8.0 — Fluxo Fluido de Ideias

#Brainstorm integrado ao ciclo de vida

O fluxo ganhou dois novos passos para evitar features mal definidas chegando ao código:

backlog/ → brainstorm/ → features/ → current/ → history/

Fluxo completo (5 passos):

aidev plan <titulo>           # Registra ideia bruta em backlog/
aidev brainstorm <backlog-id> # Explora ideia → .aidev/plans/brainstorm/
aidev create-feature <id>     # Promove brainstorm → .aidev/plans/features/
aidev start <feature-id>      # Inicia execução → current/
aidev done <sprint-id>        # Conclui sprint
aidev complete <feature-id>   # Arquiva → history/YYYY-MM/

• aidev brainstorm: cria documento estruturado com problema, abordagens, riscos e decisão preliminar. Suporta --auto para template sem interação.
• aidev create-feature: converte brainstorm em plano formal com sprints e critérios de aceite.
• Gate de proteção: aidev start bloqueia se a feature ainda está em brainstorm/ ou backlog/, orientando o próximo comando.
• Regra de sessão: verificar current/ ao iniciar qualquer sessão. Se houver feature ativa, retomar antes de qualquer outra tarefa.
• Novos triggers: palavras "backlog" e "brainstorm" ativam o modo agente em todos os runtimes.
• rules/INDEX.md: índice leve com referência rápida às 6 regras inegociáveis.
• _flc_cleanup_checkpoints(): mantém apenas os últimos 5 checkpoints JSON automaticamente.

---

#Ciclo de Vida de Features

┌──────────┐    ┌────────────┐    ┌──────────┐    ┌─────────┐    ┌─────────────────┐
│ backlog/ │───▶│ brainstorm/│───▶│features/ │───▶│current/ │───▶│ history/YYYY-MM/│
│  ideia   │    │ exploração │    │ planejada│    │executando│    │   concluída     │
└──────────┘    └────────────┘    └──────────┘    └─────────┘    └─────────────────┘

Regra inegociável: nunca mova arquivos manualmente. Use sempre os comandos CLI.

---

#O que é instalado?

seu-projeto/
├── .aidev/
│   ├── QUICKSTART.md         # Ativação rápida do modo agente
│   │
│   ├── plans/                # Ciclo de vida de features
│   │   ├── ROADMAP.md        # Roadmap mestre (gerado automaticamente)
│   │   ├── backlog/          # Ideias brutas (aidev plan)
│   │   ├── brainstorm/       # Exploração de ideias (aidev brainstorm)
│   │   ├── features/         # Features planejadas (aidev create-feature)
│   │   ├── current/          # Feature em execução (aidev start)
│   │   └── history/          # Features concluídas (aidev complete)
│   │
│   ├── agents/               # 12 agentes especializados
│   │   ├── orchestrator.md
│   │   ├── architect.md
│   │   ├── backend.md
│   │   ├── frontend.md
│   │   ├── code-reviewer.md
│   │   ├── qa.md
│   │   ├── devops.md
│   │   ├── legacy-analyzer.md
│   │   └── security-guardian.md
│   │
│   ├── skills/               # 7 skills guiadas
│   │   ├── brainstorming/
│   │   ├── writing-plans/
│   │   ├── test-driven-development/
│   │   ├── code-review/
│   │   ├── systematic-debugging/
│   │   ├── learned-lesson/
│   │   └── lesson-curation/
│   │
│   ├── rules/                # Regras do framework
│   │   ├── INDEX.md          # Índice de regras (v4.8.0)
│   │   ├── generic.md        # Regras universais
│   │   └── {stack}.md        # Regras por stack
│   │
│   ├── lib/                  # Scripts de automação
│   └── state/                # Estado persistente entre sessões
│
├── CLAUDE.md                 # Instruções para Claude Code
└── .mcp.json                 # Configuração MCP

---

#Comandos CLI

#Ciclo de vida de features

#Modo agente e ativação

#Diagnóstico e manutenção

#MCP e configuração

#Conhecimento e aprendizado

#Ativação do modo agente

# Via terminal
aidev agent | xclip    # Linux
aidev agent | pbcopy   # macOS

# Via chat com a IA
"modo agente" | "aidev" | "superpowers" | "brainstorm" | "backlog"

---

#Agentes

---

#Skills

---

#Configuração

# .aidev.yaml na raiz do projeto
mode: full          # full, minimal, custom
language: pt-br     # pt-br, en

platform:
  name: claude-code  # claude-code, gemini, cursor, antigravity

skills:
  - brainstorming
  - tdd
  - systematic-debugging
  - writing-plans

agents:
  - orchestrator
  - architect
  - backend
  - frontend
  - qa

rules:
  tdd: mandatory
  documentation: required

# Chaves de API: use .env na raiz (ignorado pelo git)
# CONTEXT7_API_KEY=sua_chave_aqui

---

#MCPs Suportados

O AI Dev configura automaticamente servidores MCP com fallback automático:

---

#Stacks Suportadas

---

#Histórico de versões

Ver CHANGELOG.md para histórico completo.

---

#Documentação

• Changelog completo
• Guia Técnico dos Agentes
• Guia de Customização
• Criando Skills
• Criando Agentes

---

#Testes

./tests/test-runner.sh                          # Todos os testes
./tests/test-runner.sh tests/unit/test-*.sh    # Unitários
./tests/test-runner.sh tests/integration/      # Integração
./tests/test-runner.sh tests/e2e/              # E2E

---

#Contribuindo

1. Fork o repositório
2. Crie uma branch: git checkout -b feature/minha-feature
3. Commit seguindo o padrão: tipo(escopo): descrição em português
4. Push e abra um Pull Request

---

#Licença

MIT License — veja LICENSE para detalhes.

---

Feito com dedicação para a comunidade de desenvolvedores.