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

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

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:

PO identifica issues
Agente relevante corrige
Documento atualizado e salvo em docs/
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:

Dev Agent (Nova sessão de chat): @dev
Implementa story aprovada
Atualiza File List com todas as mudanças
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:

QA Agent (Nova sessão de chat): @qa -> review-story
Review de senior dev com capacidade de refatoração
Corrige issues pequenos diretamente
Deixa checklist para itens restantes
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:

Dev Agent (Nova sessão de chat): Enderecar itens restantes
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:

Validar que epic foi completado corretamente
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

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

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

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

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

Decisão 5: QA Review

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

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

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

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

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

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

PO para SM

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

Criando story de {{documentation_type}}.

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

Workflow Completo

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:

Pause o workflow atual
Re-execute classificacao com @analyst
Fornecer mais contexto sobre integração e complexidade

Problema: Documentação inadequada não detectada

Sintoma: PRD criado sem contexto suficiente do sistema

Solucao:

Execute document-project manualmente com @architect
Atualize PRD com novos achados
Re-valide com @po

Problema: Ciclo infinito de validação PO

Sintoma: Issues continuam aparecendo apos correções

Solucao:

Agendar reuniao de sincronizacao com stakeholders
Documentar criterios de aceitação mais claros
Considerar reduzir escopo do enhancement

Problema: Story muito grande

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

Solucao:

Divida story em multiplas sub-stories
Re-avalie classificacao do enhancement
Considere usar brownfield-create-epic em vez de story única

Problema: Integracao quebrando funcionalidade existente

Sintoma: Testes de regressão falhando

Solucao:

Revise análise de impacto no PRD
Adicione mais testes de integração
Considere feature flags para rollout gradual

Problema: QA Review inconclusivo

Sintoma: Issues indo e voltando entre dev e QA

Solucao:

Documente criterios de aceitação mais claros
Agende pair-programming para issues complexos
Considere adicionar testes automatizados

Diagramas de Estado

Estado da Story

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

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

FilesExpand file tree

brownfield-fullstack-workflow.md

Latest commit

History

brownfield-fullstack-workflow.md

File metadata and controls

Workflow: Brownfield Full-Stack Enhancement

Visão Geral

Quando Usar Este Workflow

Diagrama Principal do Workflow

Diagrama Simplificado de Roteamento

Steps Detalhados

Step 1: Classificação do Enhancement

Step 2: Roteamento por Decisão

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

Step 4: Análise do Projeto (Condicional)

Step 5: Criação do PRD Brownfield

Step 6: Decisão de Arquitetura

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

Step 8: Validação pelo PO

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

Step 10: Sharding de Documentos

Step 11: Criação de Story

Step 12: Revisão de Draft (Opcional)

Step 13: Implementação

Step 14: Review de QA (Opcional)

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

Step 16: Ciclo de Desenvolvimento

Step 17: Retrospectiva do Epic (Opcional)

Step 18: Conclusão do Workflow

Agentes Participantes

Tasks Executadas

Pré-requisitos

Ambiente

Documentação

Ferramentas

Entradas e Saídas

Entradas do Workflow

Saídas do Workflow

Pontos de Decisão

Decisão 1: Tamanho do Enhancement

Decisão 2: Documentação Adequada

Decisão 3: Mudancas Arquiteturais

Decisão 4: Issues do PO

Decisão 5: QA Review

Handoff Prompts

Classificação Completa

Avaliacao de Documentação

Document Project para PM

PM para Decisão do Architect

Architect para PO

PO para SM

Criação de Story pelo SM

Workflow Completo

Troubleshooting

Problema: Enhancement mal classificado

Problema: Documentação inadequada não detectada

Problema: Ciclo infinito de validação PO

Problema: Story muito grande

Problema: Integracao quebrando funcionalidade existente

Problema: QA Review inconclusivo

Diagramas de Estado

Estado da Story

Estado do Epic

Métricas de Sucesso

Referências

Arquivos Core do Workflow

Arquivos de Agentes

Documentação Relacionada

Changelog