# Workflow: Brownfield Full-Stack Enhancement

> **Versão:** 1.0.0
> **Criado:** 2026-02-04
> **Tipo:** Desenvolvimento Brownfield
> **Status:** Documentação Oficial
> **Arquivo Fonte:** `.aiox-core/development/workflows/brownfield-fullstack.yaml`

---

## Visão Geral

O workflow **Brownfield Full-Stack Enhancement** e projetado para aprimorar aplicações full-stack existentes com novas funcionalidades, modernização ou mudanças significativas. Este workflow lida com análise de sistemas existentes e integração segura, garantindo que as modificacoes não quebrem funcionalidades ja estabelecidas.

### Quando Usar Este Workflow

**Use este workflow quando:**

- O aprimoramento requer stories coordenadas
- Mudancas arquiteturais sao necessarias
- Trabalho significativo de integração e requerido
- Avaliacao e mitigação de riscos sao necessarias
- Múltiplos membros da equipe trabalharao em mudanças relacionadas

**Tipos de Projeto Suportados:**

- `feature-addition` - Adição de novas funcionalidades
- `refactoring` - Refatoração de código existente
- `modernization` - Modernização de tecnologias
- `integration-enhancement` - Aprimoramento de integrações

---

## Diagrama Principal do Workflow

```mermaid
flowchart TB
    subgraph CLASSIFICATION["1. CLASSIFICAÇÃO DO ENHANCEMENT"]
        START[("Inicio: Brownfield Enhancement")] --> ANALYST_CLASSIFY
        ANALYST_CLASSIFY["@analyst<br/>Classificar escopo do enhancement"]
    end

    ANALYST_CLASSIFY --> DECISION_SIZE{{"Tamanho do Enhancement?"}}

    subgraph ROUTING["2. ROTEAMENTO POR TAMANHO"]
        DECISION_SIZE -->|"Single Story<br/>(< 4 horas)"| PM_STORY
        DECISION_SIZE -->|"Small Feature<br/>(1-3 Stories)"| PM_EPIC
        DECISION_SIZE -->|"Major Enhancement<br/>(Múltiplos Epics)"| ANALYST_DOCS

        PM_STORY["@pm<br/>brownfield-create-story"]
        PM_EPIC["@pm<br/>brownfield-create-epic"]
    end

    PM_STORY --> EXIT_STORY[/"Saida: Dev Implementation"/]
    PM_EPIC --> EXIT_EPIC[/"Saida: Story Creation"/]

    subgraph DOCUMENTATION["3. VERIFICAÇÃO DE DOCUMENTACAO"]
        ANALYST_DOCS["@analyst<br/>Verificar documentação existente"]
        ANALYST_DOCS --> DECISION_DOCS{{"Documentação Adequada?"}}
        DECISION_DOCS -->|Nao| ARCHITECT_DOCPROJ["@architect<br/>document-project"]
        DECISION_DOCS -->|Sim| PM_PRD["@pm<br/>Criar brownfield-prd.md"]
        ARCHITECT_DOCPROJ --> PM_PRD
    end

    subgraph PLANNING["4. PLANEJAMENTO"]
        PM_PRD --> DECISION_ARCH{{"Mudancas<br/>Arquiteturais?"}}
        DECISION_ARCH -->|Sim| ARCHITECT_ARCH["@architect<br/>Criar architecture.md"]
        DECISION_ARCH -->|Nao| PO_VALIDATE
        ARCHITECT_ARCH --> PO_VALIDATE["@po<br/>Validar artifacts<br/>(po-master-checklist)"]
    end

    subgraph VALIDATION["5. VALIDAÇÃO E CORREÇÃO"]
        PO_VALIDATE --> DECISION_ISSUES{{"PO encontrou<br/>problemas?"}}
        DECISION_ISSUES -->|Sim| FIX_ISSUES["Corrigir issues<br/>(agente relevante)"]
        FIX_ISSUES --> PO_VALIDATE
        DECISION_ISSUES -->|Nao| PO_SHARD["@po<br/>Shard documents"]
    end

    subgraph DEVELOPMENT["6. CICLO DE DESENVOLVIMENTO"]
        PO_SHARD --> SM_STORY["@sm<br/>Criar story"]
        SM_STORY --> DECISION_STORY_TYPE{{"Tipo de<br/>Documentação?"}}
        DECISION_STORY_TYPE -->|"PRD Sharded"| SM_NEXT["create-next-story"]
        DECISION_STORY_TYPE -->|"Brownfield Docs"| SM_BROWNFIELD["create-brownfield-story"]
        SM_NEXT --> DECISION_REVIEW{{"Revisar draft?"}}
        SM_BROWNFIELD --> DECISION_REVIEW
        DECISION_REVIEW -->|Sim| REVIEW_APPROVE["Revisar & Aprovar"]
        DECISION_REVIEW -->|Nao| DEV_IMPLEMENT
        REVIEW_APPROVE --> DEV_IMPLEMENT["@dev<br/>Implementar story"]
    end

    subgraph QA_CYCLE["7. CICLO DE QA"]
        DEV_IMPLEMENT --> DECISION_QA{{"QA Review?"}}
        DECISION_QA -->|Sim| QA_REVIEW["@qa<br/>Review implementation"]
        DECISION_QA -->|Nao| DECISION_MORE_STORIES
        QA_REVIEW --> DECISION_QA_ISSUES{{"Issues?"}}
        DECISION_QA_ISSUES -->|Sim| DEV_FIX["@dev<br/>Corrigir feedback"]
        DECISION_QA_ISSUES -->|Nao| DECISION_MORE_STORIES
        DEV_FIX --> QA_REVIEW
    end

    subgraph COMPLETION["8. FINALIZAÇÃO"]
        DECISION_MORE_STORIES{{"Mais stories?"}}
        DECISION_MORE_STORIES -->|Sim| SM_STORY
        DECISION_MORE_STORIES -->|Nao| DECISION_RETRO
        DECISION_RETRO{{"Retrospectiva?"}}
        DECISION_RETRO -->|Sim| PO_RETRO["@po<br/>Epic Retrospective"]
        DECISION_RETRO -->|Nao| COMPLETE
        PO_RETRO --> COMPLETE[("Projeto Completo")]
    end

    style START fill:#87CEEB
    style COMPLETE fill:#90EE90
    style EXIT_STORY fill:#90EE90
    style EXIT_EPIC fill:#90EE90
    style PM_STORY fill:#87CEEB
    style PM_EPIC fill:#87CEEB
    style PM_PRD fill:#FFE4B5
    style ARCHITECT_ARCH fill:#FFE4B5
    style PO_SHARD fill:#ADD8E6
    style SM_STORY fill:#ADD8E6
    style DEV_IMPLEMENT fill:#ADD8E6
    style REVIEW_APPROVE fill:#F0E68C
    style QA_REVIEW fill:#F0E68C
    style PO_RETRO fill:#F0E68C
```

---

## Diagrama Simplificado de Roteamento

```mermaid
flowchart LR
    subgraph INPUT["ENTRADA"]
        A["Enhancement Request"]
    end

    subgraph CLASSIFICATION["CLASSIFICAÇÃO"]
        B["@analyst<br/>Classificar Escopo"]
    end

    subgraph ROUTES["ROTAS"]
        C1["Single Story<br/>(< 4h)"]
        C2["Small Feature<br/>(1-3 stories)"]
        C3["Major Enhancement<br/>(múltiplos epics)"]
    end

    subgraph OUTPUT["SAIDA"]
        D1["brownfield-create-story<br/>@pm"]
        D2["brownfield-create-epic<br/>@pm"]
        D3["Workflow Completo<br/>(continua abaixo)"]
    end

    A --> B
    B --> C1 --> D1
    B --> C2 --> D2
    B --> C3 --> D3

    style A fill:#e1f5fe
    style D1 fill:#c8e6c9
    style D2 fill:#c8e6c9
    style D3 fill:#fff3e0
```

---

## Steps Detalhados

### Step 1: Classificação do Enhancement

| Atributo | Valor |
|----------|-------|
| **Agente** | @analyst (Atlas) |
| **Ação** | Classificar escopo do enhancement |
| **Input** | Descrição do enhancement pelo usuario |
| **Output** | Classificação: single_story / small_feature / major_enhancement |

**Processo:**

O analista determina a complexidade do enhancement para rotear ao caminho apropriado. A pergunta-chave ao usuario e:

> "Voce pode descrever o escopo do enhancement? E uma pequena correcao, uma adicao de feature, ou um enhancement maior que requer mudanças arquiteturais?"

**Critérios de Classificação:**

- **Single Story** (< 4 horas): Use task `brownfield-create-story`
- **Small Feature** (1-3 stories): Use task `brownfield-create-epic`
- **Major Enhancement** (múltiplos epics): Continue com workflow completo

---

### Step 2: Roteamento por Decisão

| Rota | Agente | Task | Proxima Ação |
|------|--------|------|--------------|
| `single_story` | @pm | `brownfield-create-story` | Sair do workflow apos criacao da story |
| `small_feature` | @pm | `brownfield-create-epic` | Sair do workflow apos criacao do epic |
| `major_enhancement` | - | - | Continuar para o proximo step |

---

### Step 3: Verificação de Documentação

| Atributo | Valor |
|----------|-------|
| **Agente** | @analyst (Atlas) |
| **Ação** | Verificar documentação existente |
| **Condição** | Apenas para `major_enhancement` |
| **Input** | Codebase e documentação existente |
| **Output** | Avaliacao: documentação_adequada / documentação_inadequada |

**Checklist de Verificação:**

- [ ] Documentos de arquitetura existem?
- [ ] Especificações de API estao atualizadas?
- [ ] Padrões de codificação estao documentados?
- [ ] Documentação esta atual e abrangente?

**Decisão:**

- **Se adequada**: Pular `document-project`, prosseguir para criacao do PRD
- **Se inadequada**: Executar `document-project` primeiro

---

### Step 4: Análise do Projeto (Condicional)

| Atributo | Valor |
|----------|-------|
| **Agente** | @architect (Aria) |
| **Task** | `document-project` |
| **Condição** | Executar se documentação for inadequada |
| **Input** | Codebase existente |
| **Output** | `brownfield-architecture.md` (ou múltiplos documentos) |

**Propósito:**

Capturar o estado atual do sistema, divida técnica e restrições. Os achados sao passados para a criacao do PRD.

**Arquivo de Task:** `.aiox-core/development/tasks/document-project.md`

---

### Step 5: Criação do PRD Brownfield

| Atributo | Valor |
|----------|-------|
| **Agente** | @pm (Morgan) |
| **Template** | `brownfield-prd-tmpl` |
| **Requisito** | Documentação existente ou análise do Step 4 |
| **Output** | `docs/prd.md` |

**Instruções:**

- Se `document-project` foi executado, referencie sua saida para evitar re-análise
- Se pulado, use documentação existente do projeto
- **IMPORTANTE**: Copie o `prd.md` final para a pasta `docs/` do projeto

---

### Step 6: Decisão de Arquitetura

| Atributo | Valor |
|----------|-------|
| **Agentes** | @pm (Morgan) / @architect (Aria) |
| **Ação** | Determinar se documento de arquitetura e necessario |
| **Condição** | Apos criacao do PRD |

**Critérios para criar documento de arquitetura:**

- [ ] Novos padrões arquiteturais necessarios
- [ ] Novas bibliotecas/frameworks a serem adotados
- [ ] Mudancas de plataforma/infraestrutura
- [ ] Seguir padrões existentes? -> Pular para criacao de story

---

### Step 7: Criação de Arquitetura (Condicional)

| Atributo | Valor |
|----------|-------|
| **Agente** | @architect (Aria) |
| **Template** | `brownfield-architecture-tmpl` |
| **Requisito** | `prd.md` |
| **Condição** | Mudancas arquiteturais necessarias |
| **Output** | `docs/architecture.md` |

**Instruções:**

Crie documento de arquitetura APENAS para mudanças arquiteturais significativas.

**IMPORTANTE**: Copie o `architecture.md` final para a pasta `docs/` do projeto

---

### Step 8: Validação pelo PO

| Atributo | Valor |
|----------|-------|
| **Agente** | @po (Pax) |
| **Checklist** | `po-master-checklist` |
| **Input** | Todos os artefatos criados |
| **Output** | Validação ou lista de issues |

**Arquivo de Checklist:** `.aiox-core/product/checklists/po-master-checklist.md`

**Processo:**

Valida todos os documentos quanto a:
- Seguranca de integração
- Completude
- Alinhamento com requisitos
- Riscos brownfield especificos

---

### Step 9: Correção de Issues (Condicional)

| Atributo | Valor |
|----------|-------|
| **Agente** | Variável (depende do issue) |
| **Condição** | PO encontrou problemas |
| **Ação** | Corrigir e re-exportar documentos atualizados |

**Fluxo:**

1. PO identifica issues
2. Agente relevante corrige
3. Documento atualizado e salvo em `docs/`
4. Retorna para validação do PO

---

### Step 10: Sharding de Documentos

| Atributo | Valor |
|----------|-------|
| **Agente** | @po (Pax) |
| **Task** | `shard-doc` |
| **Input** | Documentos validados no projeto |
| **Output** | `docs/prd/` e `docs/architecture/` com conteúdo fragmentado |

**Opções de Execução:**

- **Opcao A**: Use agente PO para shard: `@po` e peca para fragmentar `docs/prd.md`
- **Opcao B**: Manual: Arraste a task `shard-doc` + `docs/prd.md` no chat

**Arquivo de Task:** `.aiox-core/development/tasks/shard-doc.md`

---

### Step 11: Criação de Story

| Atributo | Valor |
|----------|-------|
| **Agente** | @sm (River) |
| **Repete** | Para cada epic ou enhancement |
| **Input** | Documentos fragmentados ou docs brownfield |
| **Output** | `story.md` em status "Draft" |

**Decisão de Task:**

| Tipo de Documentação | Task |
|---------------------|------|
| PRD Sharded | `create-next-story` |
| Brownfield Docs | `create-brownfield-story` |

**Arquivos de Task:**
- `.aiox-core/development/tasks/create-next-story.md`
- `.aiox-core/development/tasks/create-brownfield-story.md`

---

### Step 12: Revisão de Draft (Opcional)

| Atributo | Valor |
|----------|-------|
| **Agentes** | @analyst / @pm |
| **Condição** | Usuario deseja revisao da story |
| **Input** | `story.md` em Draft |
| **Output** | Story atualizada: Draft -> Approved |

**Nota:** Task `story-review` em desenvolvimento.

---

### Step 13: Implementação

| Atributo | Valor |
|----------|-------|
| **Agente** | @dev (Dex) |
| **Requisito** | Story aprovada |
| **Output** | Arquivos de implementacao |

**Instruções:**

1. Dev Agent (Nova sessão de chat): `@dev`
2. Implementa story aprovada
3. Atualiza File List com todas as mudanças
4. Marca story como "Review" quando completo

---

### Step 14: Review de QA (Opcional)

| Atributo | Valor |
|----------|-------|
| **Agente** | @qa (Quinn) |
| **Task** | `review-story` |
| **Requisito** | Arquivos implementados |
| **Output** | Implementação revisada |

**Processo:**

1. QA Agent (Nova sessão de chat): `@qa` -> `review-story`
2. Review de senior dev com capacidade de refatoração
3. Corrige issues pequenos diretamente
4. Deixa checklist para itens restantes
5. Atualiza status da story (Review -> Done ou permanece Review)

---

### Step 15: Correção de Feedback do QA (Condicional)

| Atributo | Valor |
|----------|-------|
| **Agente** | @dev (Dex) |
| **Condição** | QA deixou itens não verificados |
| **Ação** | Endereca itens restantes |

**Fluxo:**

1. Dev Agent (Nova sessão de chat): Enderecar itens restantes
2. Retornar para QA para aprovacao final

---

### Step 16: Ciclo de Desenvolvimento

**Repete:** Ciclo SM -> Dev -> QA para todas as stories do epic

Continua ate que todas as stories no PRD estejam completas.

---

### Step 17: Retrospectiva do Epic (Opcional)

| Atributo | Valor |
|----------|-------|
| **Agente** | @po (Pax) |
| **Condição** | Epic completo |
| **Output** | `epic-retrospective.md` |

**Processo:**

1. Validar que epic foi completado corretamente
2. Documentar aprendizados e melhorias

**Nota:** Task `epic-retrospective` em desenvolvimento.

---

### Step 18: Conclusão do Workflow

**Status:** Todas as stories implementadas e revisadas

**Referencia:** `.aiox-core/data/aiox-kb.md#IDE Development Workflow`

---

## Agentes Participantes

| Agente | Nome | Papel no Workflow | Steps |
|--------|------|-------------------|-------|
| @analyst | Atlas | Classificação de escopo, verificacao de documentação | 1, 3 |
| @architect | Aria | Documentação de projeto, design de arquitetura | 4, 6, 7 |
| @pm | Morgan | Criação de PRD, epics e stories simples | 2, 5, 6 |
| @po | Pax | Validação de artefatos, sharding, retrospectiva | 8, 10, 17 |
| @sm | River | Criação detalhada de stories | 11 |
| @dev | Dex | Implementação de stories | 13, 15 |
| @qa | Quinn | Review de implementacao | 14 |

---

## Tasks Executadas

| Task | Step | Agente | Propósito |
|------|------|--------|-----------|
| `brownfield-create-story` | 2 | @pm | Criar story única para enhancements simples |
| `brownfield-create-epic` | 2 | @pm | Criar epic focado com 1-3 stories |
| `document-project` | 4 | @architect | Documentar estado atual do sistema brownfield |
| `brownfield-prd-tmpl` | 5 | @pm | Template para PRD de projeto brownfield |
| `brownfield-architecture-tmpl` | 7 | @architect | Template para arquitetura brownfield |
| `po-master-checklist` | 8 | @po | Validação abrangente de artefatos |
| `shard-doc` | 10 | @po | Fragmentar documentos em arquivos menores |
| `create-next-story` | 11 | @sm | Criar story de PRD sharded |
| `create-brownfield-story` | 11 | @sm | Criar story de docs brownfield |
| `review-story` | 14 | @qa | Review de implementacao |

---

## Pré-requisitos

Antes de iniciar este workflow, certifique-se de:

### Ambiente

- [ ] Acesso ao repositório do projeto existente
- [ ] Ambiente de desenvolvimento configurado
- [ ] Dependencias instaladas

### Documentação

- [ ] Entendimento básico do sistema existente
- [ ] Acesso a documentação existente (se houver)
- [ ] Requisitos do enhancement claros

### Ferramentas

- [ ] GitHub CLI configurado (`gh auth status`)
- [ ] Acesso ao PM tool (ClickUp/GitHub/Jira) se aplicável
- [ ] Core config AIOX configurado (`.aiox-core/core-config.yaml`)

---

## Entradas e Saídas

### Entradas do Workflow

| Entrada | Origem | Formato | Obrigatório |
|---------|--------|---------|-------------|
| Enhancement Request | Usuario | Descrição textual | Sim |
| Codebase Existente | Repositorio | Codigo fonte | Sim |
| Documentação Existente | `docs/` | Markdown | Nao |
| Requisitos de Stakeholders | Usuario/PM tool | Texto/Tickets | Nao |

### Saídas do Workflow

| Saida | Destino | Formato | Condição |
|-------|---------|---------|----------|
| `brownfield-architecture.md` | `docs/` | Markdown | Se doc inadequada |
| `prd.md` | `docs/` | Markdown | Major enhancement |
| `architecture.md` | `docs/` | Markdown | Se mudanças arquiteturais |
| Stories fragmentados | `docs/stories/` | Markdown | Sempre |
| Codigo implementado | `src/` | Vários | Sempre |
| `epic-retrospective.md` | `docs/` | Markdown | Opcional |

---

## Pontos de Decisão

### Decisão 1: Tamanho do Enhancement

```mermaid
flowchart LR
    A[Enhancement Request] --> B{Tamanho?}
    B -->|"< 4 horas"| C[Single Story]
    B -->|"1-3 Stories"| D[Small Feature]
    B -->|"Múltiplos Epics"| E[Major Enhancement]
    C --> F[Sair: Dev Implementation]
    D --> G[Sair: Story Creation]
    E --> H[Continuar Workflow]
```

### Decisão 2: Documentação Adequada

```mermaid
flowchart LR
    A[Verificar Docs] --> B{Adequada?}
    B -->|Sim| C[Pular document-project]
    B -->|Nao| D[Executar document-project]
    C --> E[Criar PRD]
    D --> E
```

### Decisão 3: Mudancas Arquiteturais

```mermaid
flowchart LR
    A[Revisar PRD] --> B{Mudancas Arquiteturais?}
    B -->|Novos padrões| C[Criar architecture.md]
    B -->|Novas libs| C
    B -->|Mudancas infra| C
    B -->|Seguir existente| D[Pular para validação]
    C --> D
```

### Decisão 4: Issues do PO

```mermaid
flowchart LR
    A[Validação PO] --> B{Issues?}
    B -->|Sim| C[Corrigir Issues]
    C --> A
    B -->|Nao| D[Prosseguir]
```

### Decisão 5: QA Review

```mermaid
flowchart LR
    A[Implementação] --> B{QA Review?}
    B -->|Sim| C[Executar Review]
    C --> D{Issues?}
    D -->|Sim| E[Dev Fix]
    E --> C
    D -->|Nao| F[Proxima Story]
    B -->|Nao| F
```

---

## Handoff Prompts

### Classificação Completa

```text
Enhancement classificado como: {{enhancement_type}}

Se single_story: Procedendo com brownfield-create-story task para implementacao imediata.
Se small_feature: Criando epic focado com brownfield-create-epic task.
Se major_enhancement: Continuando com workflow de planejamento abrangente.
```

### Avaliacao de Documentação

```text
Avaliacao de documentação completa:

Se adequada: Documentação existente e suficiente. Procedendo diretamente para criacao do PRD.
Se inadequada: Executando document-project para capturar estado atual do sistema antes do PRD.
```

### Document Project para PM

```text
Análise do projeto completa. Principais achados documentados em:
- {{document_list}}

Use estes achados para informar a criacao do PRD e evitar re-analisar os mesmos aspectos.
```

### PM para Decisão do Architect

```text
PRD completo e salvo como docs/prd.md.
Mudancas arquiteturais identificadas: {{sim/não}}

Se sim: Procedendo para criar documento de arquitetura para: {{mudanças_especificas}}
Se não: Nenhuma mudanca arquitetural necessaria. Procedendo para validação.
```

### Architect para PO

```text
Arquitetura completa. Salve como docs/architecture.md.
Por favor, valide todos os artefatos quanto a seguranca de integração.
```

### PO para SM

```text
Todos os artefatos validados.
Tipo de documentação disponivel: {{sharded_prd / brownfield_docs}}

Se sharded: Use task create-next-story padrao.
Se brownfield: Use task create-brownfield-story para lidar com formatos de documentação variados.
```

### Criação de Story pelo SM

```text
Criando story de {{documentation_type}}.

Se contexto faltando: Pode ser necessario coletar contexto adicional do usuario durante criacao da story.
```

### Workflow Completo

```text
Todos os artefatos de planejamento validados e desenvolvimento pode comecar.
Stories serao criadas baseadas no formato de documentação disponivel.
```

---

## Troubleshooting

### Problema: Enhancement mal classificado

**Sintoma:** Workflow simples usado para enhancement complexo ou vice-versa

**Solucao:**
1. Pause o workflow atual
2. Re-execute classificacao com @analyst
3. Fornecer mais contexto sobre integração e complexidade

### Problema: Documentação inadequada não detectada

**Sintoma:** PRD criado sem contexto suficiente do sistema

**Solucao:**
1. Execute `document-project` manualmente com @architect
2. Atualize PRD com novos achados
3. Re-valide com @po

### Problema: Ciclo infinito de validação PO

**Sintoma:** Issues continuam aparecendo apos correções

**Solucao:**
1. Agendar reuniao de sincronizacao com stakeholders
2. Documentar criterios de aceitação mais claros
3. Considerar reduzir escopo do enhancement

### Problema: Story muito grande

**Sintoma:** Story não pode ser completada em uma sessão

**Solucao:**
1. Divida story em multiplas sub-stories
2. Re-avalie classificacao do enhancement
3. Considere usar `brownfield-create-epic` em vez de story única

### Problema: Integracao quebrando funcionalidade existente

**Sintoma:** Testes de regressão falhando

**Solucao:**
1. Revise análise de impacto no PRD
2. Adicione mais testes de integração
3. Considere feature flags para rollout gradual

### Problema: QA Review inconclusivo

**Sintoma:** Issues indo e voltando entre dev e QA

**Solucao:**
1. Documente criterios de aceitação mais claros
2. Agende pair-programming para issues complexos
3. Considere adicionar testes automatizados

---

## Diagramas de Estado

### Estado da Story

```mermaid
stateDiagram-v2
    [*] --> Draft: Story Criada
    Draft --> Approved: Revisão OK
    Draft --> Draft: Revisão com Ajustes
    Approved --> InProgress: Dev Inicia
    InProgress --> Review: Dev Completa
    Review --> InProgress: QA Issues
    Review --> Done: QA Aprovado
    Done --> [*]

    note right of Draft: Story criada pelo SM
    note right of Approved: Pronta para desenvolvimento
    note right of Review: Aguardando QA
    note right of Done: Completa e verificada
```

### Estado do Epic

```mermaid
stateDiagram-v2
    [*] --> Planning: Enhancement Classificado
    Planning --> Documented: Docs Criados
    Documented --> Validated: PO Aprovou
    Validated --> InDevelopment: Stories Criadas
    InDevelopment --> InDevelopment: Mais Stories
    InDevelopment --> Retrospective: Todas Stories Done
    Retrospective --> Complete: Retro Feita
    Complete --> [*]
```

---

## Métricas de Sucesso

| Métrica | Descrição | Alvo |
|---------|-----------|------|
| Precisão de Classificação | % de enhancements corretamente classificados | > 90% |
| Tempo ate PRD | Dias desde request ate PRD aprovado | < 3 dias |
| Issues por Validação | Numero medio de issues encontrados por PO | < 3 |
| Ciclos de QA | Numero medio de ida-e-volta dev/QA | < 2 |
| Regressão Zero | % de releases sem bugs de regressão | 100% |

---

## Referências

### Arquivos Core do Workflow

| Arquivo | Propósito |
|---------|-----------|
| `.aiox-core/development/workflows/brownfield-fullstack.yaml` | Definição do workflow |
| `.aiox-core/development/tasks/brownfield-create-story.md` | Task para criar story simples |
| `.aiox-core/development/tasks/brownfield-create-epic.md` | Task para criar epic |
| `.aiox-core/development/tasks/document-project.md` | Task para documentar projeto existente |
| `.aiox-core/development/tasks/shard-doc.md` | Task para fragmentar documentos |
| `.aiox-core/development/tasks/create-brownfield-story.md` | Task para criar story brownfield |
| `.aiox-core/development/tasks/create-next-story.md` | Task para criar story de PRD |
| `.aiox-core/product/checklists/po-master-checklist.md` | Checklist de validação PO |

### Arquivos de Agentes

| Arquivo | Agente |
|---------|--------|
| `.aiox-core/development/agents/analyst.md` | @analyst (Atlas) |
| `.aiox-core/development/agents/architect.md` | @architect (Aria) |
| `.aiox-core/development/agents/pm.md` | @pm (Morgan) |
| `.aiox-core/development/agents/po.md` | @po (Pax) |
| `.aiox-core/development/agents/sm.md` | @sm (River) |
| `.aiox-core/development/agents/dev.md` | @dev (Dex) |
| `.aiox-core/development/agents/qa.md` | @qa (Quinn) |

### Documentação Relacionada

| Documento | Propósito |
|-----------|-----------|
| `docs/guides/BACKLOG-MANAGEMENT-SYSTEM.md` | Sistema de gestão de backlog |
| `docs/guides/workflows/GREENFIELD-SERVICE-WORKFLOW.md` | Workflow para projetos greenfield |
| `.aiox-core/working-in-the-brownfield.md` | Guia de trabalho brownfield |

---

## Changelog

| Data | Autor | Descrição |
|------|-------|-----------|
| 2026-02-04 | @analyst | Documento inicial criado |

---

*-- Atlas, decodificando complexidade em clareza*