Projeto Greenfield

Iniciando um novo projeto do zero com o AIOS. Este guia cobre as tres variantes de workflow greenfield e acompanha o ciclo de vida completo, do conceito a producao.

Quando Usar um Workflow Greenfield

Use um workflow greenfield quando estiver construindo uma aplicacao totalmente nova, sem codebase existente. Cenarios tipicos incluem:

• Novas aplicacoes web, plataformas SaaS ou apps empresariais
• Produtos Minimos Viaveis (MVPs) e prototipos
• Projetos que exigem documentacao abrangente desde o inicio
• Produtos de longo prazo com multiplos membros na equipe

Escolhendo a Variante Certa

O AIOS oferece tres variantes de workflow greenfield. Escolha com base no que voce esta construindo:

Todas as tres variantes compartilham a mesma estrutura geral, mas diferem nos agentes envolvidos e nos artefatos produzidos durante a fase de planejamento.

Fases do Workflow

Todo workflow greenfield segue quatro grandes fases:

Fase 0: Bootstrap do Ambiente

Antes de tudo, @devops (Gage) configura o ambiente de desenvolvimento.

@devops *environment-bootstrap

Este passo verifica e instala CLIs necessarias (git, gh, node, npm), autentica servicos (GitHub, Supabase, Railway), inicializa o repositorio Git e gera o scaffold do projeto. E ignorado automaticamente se .aios/environment-report.json ja existir.

Fase 1: Descoberta e Planejamento

Esta e a fase central de planejamento onde os agentes colaboram para produzir toda a documentacao do projeto.

Pontos de decisao chave:

• Se o architect sugerir mudancas no PRD, @pm atualiza o PRD antes da validacao.
• Se @po encontrar problemas na validacao, o agente relevante corrige antes de prosseguir.

Passos opcionais disponiveis nesta fase: sessoes de brainstorming, pesquisa de mercado, pesquisa de usuarios e pesquisa tecnica.

Fase 2: Fragmentacao de Documentos

Uma vez que todos os artefatos estejam validados, @po fragmenta o PRD e a arquitetura em arquivos menores prontos para desenvolvimento no IDE.

@po *shard-doc docs/prd.md

Isso produz:

• docs/prd/ — Secoes individuais do PRD
• docs/architecture/source-tree.md — Estrutura de diretorios do projeto
• docs/architecture/tech-stack.md — Stack tecnologico
• docs/architecture/coding-standards.md — Padroes de codificacao

Fase 3: Ciclo de Desenvolvimento

A fase iterativa de construcao onde stories sao criadas, implementadas e revisadas.

@sm *draft                     # Criar proxima story
@dev *develop {story-id}       # Implementar a story
@qa *review {story-id}         # Revisao QA (opcional)
@devops *push                  # Entregar quando aprovado

Cada story segue o ciclo de vida: Draft > Ready > InProgress > InReview > Done

O ciclo se repete para cada story do epic. Apos todas as stories estarem completas, @po pode executar uma retrospectiva de epic opcional.

Passo a Passo da Variante Full-Stack

A variante full-stack e a mais comum. Aqui esta o fluxo completo:

1. Bootstrap: @devops *environment-bootstrap — Configurar repo, CLIs, scaffold do projeto
2. Brief: @analyst cria o project brief com brainstorming opcional
3. PRD: @pm transforma o brief em um Documento de Requisitos detalhado
4. Frontend Spec: @ux-expert cria especificacoes de UI/UX a partir do PRD
5. Arquitetura: @architect projeta a arquitetura full-stack (pode sugerir mudancas no PRD)
6. Validacao: @po executa o master checklist em todos os artefatos
7. Fragmentacao: @po fragmenta documentos para desenvolvimento
8. Loop de Stories: @sm cria stories, @dev implementa, @qa revisa, repete
9. Retrospectiva: @po documenta aprendizados apos conclusao do epic

Pre-requisitos

Autenticacoes necessarias: GitHub (gh auth login), e opcionalmente Supabase e Railway.

Diferencas Entre as Variantes

Comandos de Inicio Rapido

# Projeto full-stack
*workflow greenfield-fullstack

# Servico backend ou API
*workflow greenfield-service

# Aplicacao frontend/UI
*workflow greenfield-ui

Solucao de Problemas