VA - Volcano Agents

Metodo Volcano para Desenvolvimento Agil Orientado por IA

Framework proprietario de agentes IA para desenvolvimento de software estruturado, baseado em personas especializadas que guiam todo o ciclo de vida do projeto - da ideacao a implementacao.

O que e o VA?

O VA (Volcano Agents) e um framework de desenvolvimento agil orientado por IA que transforma assistentes de IA em uma equipe estruturada de especialistas. Em vez de interacoes ad-hoc com IA, o VA fornece:

• Agentes com papeis definidos - Analista, Gerente de Produto, Arquiteto, Scrum Master, Desenvolvedor, QA e mais
• Workflows estruturados - Processos passo-a-passo para cada fase do desenvolvimento
• Templates padronizados - PRD, arquitetura, historias de usuario, etc.
• Modo Festa - Discussoes colaborativas entre multiplos agentes
• Fluxo Rapido - Para tarefas menores que nao precisam do ciclo completo

Instalacao via npx

# Instalacao interativa (recomendado)
npx volcano-agents install

# Instalacao completa sem perguntas
npx volcano-agents install --full

# Especificar IDE
npx volcano-agents install --tools claude-code,cursor

# Todas as opcoes
npx volcano-agents install --directory ./meu-projeto --tools claude-code --user-name "Joao" -y

Requisitos

• Node.js >= 18

IDEs Suportados

| IDE | Flag | Formato dos Comandos | |-----|------|---------------------| | Claude Code | claude-code | .claude/commands/*.md | | Cursor | cursor | .cursor/rules/*.mdc | | VS Code (Copilot) | vscode | .github/copilot-instructions/*.md | | Augment Code | augment-code | .augment/commands/*.md | | Kiro | kiro | .kiro/commands/*.md | | Trae | trae | .trae/rules/*.md |

Comandos do CLI

npx volcano-agents install     # Instalar VA no projeto
npx volcano-agents uninstall   # Remover VA do projeto
npx volcano-agents status      # Verificar status da instalacao
npx volcano-agents list        # Listar agentes e skills disponiveis
npx volcano-agents list --agents   # Listar apenas agentes
npx volcano-agents list --skills   # Listar apenas skills

Estrutura Apos Instalacao

seu-projeto/
├── _va/
│   ├── core/              # Skills centrais (ajuda, brainstorm, modo festa, etc.)
│   ├── vam/               # Workflows VAM por fase
│   │   ├── 1-analise/     # Analise e pesquisa
│   │   ├── 2-planejamento/# PRD, design UX
│   │   ├── 3-solucao/     # Arquitetura, epicos
│   │   ├── 4-implementacao/# Sprint, dev, QA
│   │   └── config.yaml    # Configuracao VAM
│   └── _config/
│       └── manifesto-agentes.csv  # Dados dos 9 agentes
├── _va-output/
│   ├── artefatos-planejamento/    # PRDs, arquitetura, epicos
│   └── artefatos-implementacao/   # Historias, sprint status
├── .claude/commands/      # Stubs para Claude Code (se selecionado)
├── .cursor/rules/         # Stubs para Cursor (se selecionado)
└── ...                    # Stubs para outros IDEs

Ciclo de Desenvolvimento em 4 Fases

Fase 1: ANALISE        -> Fase 2: PLANEJAMENTO    -> Fase 3: SOLUCAO         -> Fase 4: IMPLEMENTACAO
(Analista, Redator)       (GP, Designer UX)          (Arquiteto)               (SM, Dev, QA)

Fase 1 - Analise

• Brainstorming e pesquisa
• Resumo do produto
• PRFAQ (Working Backwards)
• Documentacao de projeto existente

Fase 2 - Planejamento

• Criacao do PRD (Documento de Requisitos)
• Design UX
• Validacao e edicao do PRD

Fase 3 - Solucao

• Arquitetura tecnica
• Epicos e historias de usuario
• Verificacao de prontidao para implementacao

Fase 4 - Implementacao

• Planejamento de sprint
• Criacao de historias detalhadas
• Desenvolvimento orientado por historias
• Testes E2E
• Revisao de codigo
• Retrospectiva

Uso

Depois de instalar, abra seu IDE e use os comandos:

//VA-ajuda              # Ver o que fazer a seguir
//VA-agente-analista    # Iniciar com a analista Maria
//VA-agente-gp          # Falar com o GP Joao
//VA-agente-arquiteto   # Consultar o arquiteto Vicente
//VA-agente-sm          # Scrum Master Roberto
//VA-agente-dev         # Desenvolvedora Amanda
//VA-agente-qa          # QA Queiroz
//VA-modo-festa         # Discussao em grupo
//VA-dev-rapido         # Fluxo rapido (sem ciclo completo)

Agentes Disponiveis

| Comando | Nome | Papel | |---------|------|-------| | //VA-agente-analista | Maria | Analista de negocios estrategica | | //VA-agente-redator-tecnico | Patricia | Especialista em documentacao tecnica | | //VA-agente-gp | Joao | Gerente de Produto | | //VA-agente-designer-ux | Sandra | Designer de Experiencia do Usuario | | //VA-agente-arquiteto | Vicente | Arquiteto de sistemas | | //VA-agente-sm | Roberto | Scrum Master | | //VA-agente-dev | Amanda | Desenvolvedora senior | | //VA-agente-qa | Queiroz | Engenheiro de QA | | //VA-agente-dev-rapido | Bruno | Desenvolvedor full-stack rapido |

Documentacao

• Guia de Inicio Rapido
• Guia de Personalizacao
• Mapeamento BMAD -> VA

Rastreamento de Versao

Este projeto foi baseado no BMAD-METHOD. Para verificar atualizacoes:

• Consulte CHANGELOG-BMAD-REF.md para a versao base
• Consulte MAPEAMENTO-ARQUIVOS.md para correspondencia de arquivos

Licenca

Proprietario - Uso interno apenas.