Versão: 1.0.0 Criado: 2026-02-04 Owner: @pm (Morgan) Status: Documentação Oficial
Este documento descreve o sistema completo do agente Product Manager (PM) do AIOX, incluindo todos os arquivos envolvidos, fluxos de trabalho, comandos disponiveis e integracoes entre agentes.
O agente PM e projetado para:
- Criar e gerenciar Product Requirements Documents (PRDs) para projetos greenfield e brownfield
- Definir e estruturar epics com planejamento de qualidade integrado
- Conduzir pesquisa estrategica e analise de mercado
- Corrigir desvios de curso durante o desenvolvimento
- Fragmentar documentos grandes em partes gerenciaveis
- Colaborar com outros agentes para garantir alinhamento estrategico
| Atributo | Valor |
|---|---|
| Nome | Morgan |
| ID | pm |
| Titulo | Product Manager |
| Icone | 📋 |
| Arquetipo | Strategist |
| Signo | Capricornio |
| Tom | Estrategico |
| Assinatura | "-- Morgan, planejando o futuro 📊" |
| Arquivo | Propósito |
|---|---|
.aiox-core/development/agents/pm.md |
Definição core do agente PM |
.claude/commands/AIOX/agents/pm.md |
Comando Claude Code para ativar @pm |
| Arquivo | Comando | Propósito |
|---|---|---|
.aiox-core/development/tasks/create-doc.md |
*create-prd |
Cria documentos a partir de templates YAML |
.aiox-core/development/tasks/correct-course.md |
*correct-course |
Analisa e corrige desvios de projeto |
.aiox-core/development/tasks/create-deep-research-prompt.md |
*research |
Gera prompts de pesquisa profunda |
.aiox-core/development/tasks/brownfield-create-epic.md |
*create-epic |
Cria epics para projetos brownfield |
.aiox-core/development/tasks/brownfield-create-story.md |
*create-story |
Cria stories para brownfield |
.aiox-core/development/tasks/execute-checklist.md |
*checklist |
Executa validação de checklists |
.aiox-core/development/tasks/shard-doc.md |
*shard-prd |
Fragmenta documentos grandes |
| Arquivo | Propósito |
|---|---|
.aiox-core/product/templates/prd-tmpl.yaml |
Template PRD para projetos greenfield |
.aiox-core/product/templates/brownfield-prd-tmpl.yaml |
Template PRD para projetos brownfield |
| Arquivo | Propósito |
|---|---|
.aiox-core/product/checklists/pm-checklist.md |
Checklist de validação de PRD |
.aiox-core/product/checklists/change-checklist.md |
Checklist para navegacao de mudancas |
| Arquivo | Fase | Propósito |
|---|---|---|
.aiox-core/development/workflows/brownfield-discovery.yaml |
Fase 10 | Criacao de epics e stories pos-discovery |
flowchart TB
subgraph INPUTS["📥 ENTRADAS"]
BRIEF["📋 Project Brief"]
RESEARCH["🔍 Pesquisa de Mercado"]
BRAINSTORM["💡 Brainstorming"]
EXISTING["🏗️ Projeto Existente<br/>(Brownfield)"]
end
subgraph PM_CORE["📋 @pm (Morgan) - CORE"]
CREATE_PRD["*create-prd<br/>Criar PRD Greenfield"]
CREATE_BF_PRD["*create-brownfield-prd<br/>Criar PRD Brownfield"]
CREATE_EPIC["*create-epic<br/>Criar Epic"]
CREATE_STORY["*create-story<br/>Criar Story"]
RESEARCH_CMD["*research<br/>Pesquisa Profunda"]
CORRECT["*correct-course<br/>Corrigir Desvios"]
SHARD["*shard-prd<br/>Fragmentar Documento"]
end
subgraph TEMPLATES["📄 TEMPLATES"]
PRD_TMPL["prd-tmpl.yaml"]
BF_PRD_TMPL["brownfield-prd-tmpl.yaml"]
end
subgraph CHECKLISTS["✅ CHECKLISTS"]
PM_CHECK["pm-checklist.md"]
CHANGE_CHECK["change-checklist.md"]
end
subgraph OUTPUTS["📤 SAÍDAS"]
PRD["docs/prd.md"]
EPICS["docs/stories/epic-*.md"]
STORIES["docs/stories/STORY-*.md"]
RESEARCH_OUT["Research Prompt"]
CHANGE_PROPOSAL["Sprint Change Proposal"]
end
BRIEF --> CREATE_PRD
RESEARCH --> CREATE_PRD
BRAINSTORM --> RESEARCH_CMD
EXISTING --> CREATE_BF_PRD
EXISTING --> CREATE_EPIC
CREATE_PRD --> PRD_TMPL
CREATE_BF_PRD --> BF_PRD_TMPL
PRD_TMPL --> PRD
BF_PRD_TMPL --> PRD
PRD --> PM_CHECK
PM_CHECK --> SHARD
CREATE_EPIC --> EPICS
CREATE_STORY --> STORIES
RESEARCH_CMD --> RESEARCH_OUT
CORRECT --> CHANGE_CHECK
CHANGE_CHECK --> CHANGE_PROPOSAL
SHARD --> PRD
style PM_CORE fill:#e3f2fd
style TEMPLATES fill:#fff8e1
style CHECKLISTS fill:#f3e5f5
style OUTPUTS fill:#e8f5e9
flowchart TD
START[Iniciar *create-prd] --> CHECK_BRIEF{Project Brief<br/>disponível?}
CHECK_BRIEF -->|Sim| LOAD_BRIEF[Carregar Brief]
CHECK_BRIEF -->|Não| RECOMMEND[Recomendar criar Brief<br/>ou coletar informações]
LOAD_BRIEF --> GOALS[1. Goals and Context]
RECOMMEND --> GOALS
GOALS --> REQUIREMENTS[2. Requirements<br/>FR + NFR]
REQUIREMENTS --> UI_GOALS{PRD tem<br/>requisitos UI/UX?}
UI_GOALS -->|Sim| UI_SECTION[3. UI Design Goals]
UI_GOALS -->|Não| TECH
UI_SECTION --> TECH[4. Technical Assumptions]
TECH --> EPIC_LIST[5. Epic List<br/>Aprovação de estrutura]
EPIC_LIST --> EPIC_DETAILS[6. Epic Details<br/>Stories + ACs]
EPIC_DETAILS --> CHECKLIST[7. Executar pm-checklist]
CHECKLIST --> NEXT_STEPS[8. Next Steps<br/>Prompts para @architect e @ux-expert]
NEXT_STEPS --> OUTPUT[📄 docs/prd.md]
style START fill:#c8e6c9
style OUTPUT fill:#c8e6c9
style CHECKLIST fill:#fff9c4
flowchart TD
START[Iniciar *create-brownfield-prd] --> ASSESS{Avaliar Complexidade<br/>da Enhancement}
ASSESS -->|Simples<br/>1-2 sessões| RECOMMEND_SIMPLE["Recomendar:<br/>*create-epic ou<br/>*create-story"]
ASSESS -->|Significativo<br/>Múltiplas stories| CONTINUE[Continuar PRD Brownfield]
CONTINUE --> CHECK_DOC{document-project<br/>foi executado?}
CHECK_DOC -->|Sim| LOAD_DOC[Carregar análise existente]
CHECK_DOC -->|Não| ANALYZE[Analisar projeto<br/>ou recomendar document-project]
LOAD_DOC --> OVERVIEW[1. Existing Project Overview]
ANALYZE --> OVERVIEW
OVERVIEW --> SCOPE[2. Enhancement Scope Definition]
SCOPE --> REQUIREMENTS[3. Requirements<br/>FR + NFR + CR]
REQUIREMENTS --> UI{Enhancement<br/>inclui UI?}
UI -->|Sim| UI_ENHANCE[4. UI Enhancement Goals]
UI -->|Não| TECH
UI_ENHANCE --> TECH[5. Technical Constraints]
TECH --> EPIC_STRUCT[6. Epic Structure]
EPIC_STRUCT --> STORIES[7. Stories com<br/>Integration Verification]
STORIES --> OUTPUT[📄 docs/prd.md<br/>Brownfield]
style START fill:#c8e6c9
style OUTPUT fill:#c8e6c9
style RECOMMEND_SIMPLE fill:#ffcdd2
stateDiagram-v2
[*] --> BRIEF: Project Brief criado
BRIEF --> DRAFT: *create-prd iniciado
DRAFT --> REVIEW: Seções completadas
REVIEW --> APPROVED: pm-checklist PASS
REVIEW --> REVISION: pm-checklist FAIL
REVISION --> DRAFT: Correções aplicadas
APPROVED --> SHARDED: *shard-prd executado
SHARDED --> ARCHITECT: Handoff para @architect
ARCHITECT --> ACTIVE: Desenvolvimento iniciado
ACTIVE --> CHANGE: Desvio detectado
CHANGE --> COURSE_CORRECT: *correct-course
COURSE_CORRECT --> ACTIVE: Proposta aprovada
ACTIVE --> COMPLETED: MVP entregue
note right of DRAFT: 📝 Em elaboração
note right of REVIEW: 🔍 Validando checklist
note right of APPROVED: ✅ Pronto para arquitetura
note right of SHARDED: 📚 Documentos fragmentados
note right of ACTIVE: 🚧 Em desenvolvimento
note right of COMPLETED: ✅ MVP entregue
| Comando | Task File | Template | Descrição |
|---|---|---|---|
*create-prd |
create-doc.md |
prd-tmpl.yaml |
Cria PRD para projeto greenfield |
*create-brownfield-prd |
create-doc.md |
brownfield-prd-tmpl.yaml |
Cria PRD para projeto brownfield |
*shard-prd |
shard-doc.md |
N/A | Fragmenta PRD em arquivos menores |
*doc-out |
create-doc.md |
N/A | Gera documento completo |
| Comando | Task File | Descrição |
|---|---|---|
*create-epic |
brownfield-create-epic.md |
Cria epic para enhancement brownfield |
*create-story |
brownfield-create-story.md |
Cria story isolada para brownfield |
*research {topic} |
create-deep-research-prompt.md |
Gera prompt de pesquisa profunda |
*correct-course |
correct-course.md |
Navega mudancas e desvios |
| Comando | Descrição |
|---|---|
*help |
Mostra todos os comandos disponiveis |
*session-info |
Mostra detalhes da sessao atual |
*guide |
Guia de uso completo do agente |
*yolo |
Alterna modo de confirmacao |
*exit |
Sai do modo PM |
Propósito: Criar documentos de requisitos de produto usando templates YAML interativos.
Modos de Execucao:
- YOLO Mode - Autonomo, minima interacao (0-1 prompts)
- Interactive Mode [PADRAO] - Checkpoints de decisao (5-10 prompts)
- Pre-Flight Planning - Planejamento completo upfront
Fluxo de Processamento:
flowchart LR
A[Parse YAML Template] --> B[Set Preferences]
B --> C[Process Sections]
C --> D{elicit: true?}
D -->|Sim| E[Apresentar Opcoes 1-9<br/>AGUARDAR resposta]
D -->|Não| F[Continuar]
E --> F
F --> G[Salvar Arquivo]
G --> H{Mais secoes?}
H -->|Sim| C
H -->|Não| I[Documento Completo]
Formato de Elicitacao Obrigatorio:
- Opcao 1: Sempre "Proceed to next section"
- Opcoes 2-9: Metodos de elicitacao do
data/elicitation-methods - Termina com: "Select 1-9 or just type your question/feedback:"
Propósito: Criar epics focados para enhancements brownfield menores (1-3 stories).
Quando Usar:
- Enhancement completavel em 1-3 stories
- Sem mudancas arquiteturais significativas
- Segue padroes existentes do projeto
- Complexidade de integracao minima
Estrutura do Epic:
## Epic: {{Enhancement Name}} - Brownfield Enhancement
### Epic Goal
{{1-2 sentencas descrevendo objetivo e valor}}
### Epic Description
**Existing System Context:**
- Current relevant functionality
- Technology stack
- Integration points
**Enhancement Details:**
- What's being added/changed
- How it integrates
- Success criteria
### Stories (com Quality Planning)
1. **Story 1: {{Title}}**
- Description
- **Predicted Agents**: @dev, @db-sage, etc.
- **Quality Gates**: Pre-Commit, Pre-PR, Pre-Deployment
### Risk Mitigation
- Primary Risk
- Mitigation Strategy
- Rollback PlanGuia de Atribuicao de Agentes:
| Tipo de Mudanca | Agentes Preditos |
|---|---|
| Database Changes | @dev, @db-sage |
| API/Backend Changes | @dev, @architect |
| Frontend/UI Changes | @dev, @ux-expert |
| Deployment/Infrastructure | @dev, @github-devops |
| Security Features | @dev (foco OWASP) |
Propósito: Gerar prompts de pesquisa estruturados para analise profunda.
Tipos de Pesquisa Disponiveis:
| # | Tipo | Descrição |
|---|---|---|
| 1 | Product Validation Research | Validar hipoteses e market fit |
| 2 | Market Opportunity Research | Analisar tamanho e potencial de mercado |
| 3 | User & Customer Research | Personas, jobs-to-be-done, pain points |
| 4 | Competitive Intelligence Research | Analise de concorrentes |
| 5 | Technology & Innovation Research | Tendencias tecnologicas |
| 6 | Industry & Ecosystem Research | Value chains e ecossistema |
| 7 | Strategic Options Research | Avaliar direcoes estrategicas |
| 8 | Risk & Feasibility Research | Identificar e avaliar riscos |
| 9 | Custom Research Focus | Pesquisa personalizada |
Estrutura do Research Prompt:
## Research Objective
[Declaracao clara do objetivo]
## Background Context
[Contexto do brief, brainstorming, ou inputs]
## Research Questions
### Primary Questions (Must Answer)
1. [Pergunta especifica e acionavel]
### Secondary Questions (Nice to Have)
1. [Pergunta de suporte]
## Research Methodology
### Information Sources
### Analysis Frameworks
### Data Requirements
## Expected Deliverables
### Executive Summary
### Detailed Analysis
### Supporting Materials
## Success Criteria
[Como avaliar se a pesquisa atingiu objetivos]Propósito: Navegar mudancas significativas durante o desenvolvimento usando o change-checklist.md.
Fluxo de Correcao de Curso:
flowchart TD
TRIGGER[Mudanca Detectada] --> SETUP[1. Setup Inicial<br/>Modo de Interacao]
SETUP --> CHECKLIST[2. Executar Checklist<br/>Secoes 1-4]
CHECKLIST --> DRAFT[3. Rascunhar Mudancas<br/>Propostas]
DRAFT --> PROPOSAL[4. Gerar Sprint<br/>Change Proposal]
PROPOSAL --> FINALIZE[5. Finalizar e<br/>Determinar Proximos Passos]
subgraph PROPOSAL_CONTENT["Sprint Change Proposal"]
ISSUE[Issue Summary]
EPIC_IMPACT[Epic Impact]
ARTIFACT_ADJUST[Artifact Adjustments]
PATH[Recommended Path]
MVP_IMPACT[MVP Impact]
ACTION[Action Plan]
HANDOFF[Agent Handoff Plan]
end
FINALIZE --> HANDOFF_DECISION{Natureza das<br/>Mudancas?}
HANDOFF_DECISION -->|Implementavel| IMPLEMENT[Implementar via<br/>@po/@sm]
HANDOFF_DECISION -->|Requer Replan| ESCALATE[Escalar para<br/>@pm/@architect]
Secoes do Change Checklist:
- Understand the Trigger & Context
- Epic Impact Assessment
- Artifact Conflict & Impact Analysis
- Path Forward Evaluation
- Sprint Change Proposal Components
- Final Review & Handoff
flowchart TB
subgraph PM_BOX["📋 @pm (Morgan) - Product Manager"]
PM_DESC["Cria PRDs, epics, pesquisa estrategica<br/>Corrige desvios de curso"]
PM_CMDS["Comandos:<br/>*create-prd, *create-epic<br/>*research, *correct-course"]
end
subgraph PO_BOX["🎯 @po (Pax) - Product Owner"]
PO_DESC["Gerencia backlog, valida stories<br/>Prioriza trabalho"]
PO_CMDS["Comandos:<br/>*backlog-*, *sync-story<br/>*validate-story-draft"]
end
subgraph SM_BOX["🌊 @sm (River) - Scrum Master"]
SM_DESC["Cria stories detalhadas<br/>Coordena sprints"]
SM_CMDS["Comandos:<br/>*create-next-story<br/>Sprint planning"]
end
subgraph ARCHITECT_BOX["🏗️ @architect (Aria) - Architect"]
ARCH_DESC["Design de arquitetura<br/>Decisoes tecnicas"]
ARCH_CMDS["Comandos:<br/>*create-architecture<br/>*document-project"]
end
subgraph ANALYST_BOX["🔍 @analyst (Atlas) - Analyst"]
ANALYST_DESC["Pesquisa de mercado<br/>Insights e dados"]
ANALYST_CMDS["Comandos:<br/>*brainstorm<br/>*analyze"]
end
PM_BOX -->|"PRD aprovado<br/>Handoff para arquitetura"| ARCHITECT_BOX
PM_BOX -->|"Epic criado<br/>Delega criação de stories"| SM_BOX
PM_BOX -->|"Recebe insights"| ANALYST_BOX
PM_BOX -->|"Fornece direcao<br/>estrategica"| PO_BOX
PO_BOX -->|"Valida stories<br/>Prioriza backlog"| SM_BOX
ANALYST_BOX -->|"Fornece pesquisa<br/>para PRD"| PM_BOX
style PM_BOX fill:#e3f2fd
style PO_BOX fill:#fff3e0
style SM_BOX fill:#e8f5e9
style ARCHITECT_BOX fill:#fce4ec
style ANALYST_BOX fill:#f3e5f5
| De | Para | Gatilho | Artefato |
|---|---|---|---|
| @pm | @architect | PRD aprovado | docs/prd.md + Architect Prompt |
| @pm | @ux-expert | PRD com UI | docs/prd.md + UX Expert Prompt |
| @pm | @sm | Epic criado | Epic doc + Story Manager Handoff |
| @pm | @po | PRD para validação | PRD Draft |
| @analyst | @pm | Pesquisa completa | Research findings |
| @pm | @pm (self) | Desvio detectado | Sprint Change Proposal |
flowchart LR
subgraph PHASE_1_9["FASES 1-9: Discovery & Assessment"]
ARCH["@architect"]
DATA["@data-engineer"]
UX["@ux-design-expert"]
QA["@qa"]
ANALYST["@analyst"]
end
subgraph PHASE_10["FASE 10: Planning"]
PM["@pm"]
EPIC["*brownfield-create-epic"]
STORY["*brownfield-create-story"]
end
PHASE_1_9 -->|"Assessment completo<br/>docs/prd/technical-debt-assessment.md"| PM
PM --> EPIC
EPIC --> STORY
STORY -->|"Stories prontas<br/>docs/stories/story-*.md"| DEV["@dev"]
style PM fill:#e3f2fd
style EPIC fill:#fff9c4
style STORY fill:#fff9c4
| Secao | ID | Elicit | Descrição |
|---|---|---|---|
| Goals and Background | goals-context | Nao | Objetivos e contexto do projeto |
| Requirements | requirements | Sim | FR + NFR |
| UI Design Goals | ui-goals | Sim | Visão UX/UI (condicional) |
| Technical Assumptions | technical-assumptions | Sim | Decisoes tecnicas |
| Epic List | epic-list | Sim | Lista de epics para aprovacao |
| Epic Details | epic-details | Sim | Stories e ACs detalhados |
| Checklist Results | checklist-results | Nao | Resultados do pm-checklist |
| Next Steps | next-steps | Nao | Prompts para proximos agentes |
| Secao | ID | Elicit | Descrição |
|---|---|---|---|
| Intro Analysis | intro-analysis | Nao | Analise do projeto existente |
| Requirements | requirements | Sim | FR + NFR + CR (Compatibility) |
| UI Enhancement Goals | ui-enhancement-goals | Nao | Integracao com UI existente |
| Technical Constraints | technical-constraints | Nao | Restricoes e integracao |
| Epic Structure | epic-structure | Sim | Estrutura do epic |
| Epic Details | epic-details | Sim | Stories com Integration Verification |
9 Categorias de Validacao:
| # | Categoria | Foco |
|---|---|---|
| 1 | Problem Definition & Context | Problema, goals, user research |
| 2 | MVP Scope Definition | Core functionality, boundaries, validation |
| 3 | User Experience Requirements | Journeys, usability, UI |
| 4 | Functional Requirements | Features, quality, user stories |
| 5 | Non-Functional Requirements | Performance, security, reliability |
| 6 | Epic & Story Structure | Epics, breakdown, first epic |
| 7 | Technical Guidance | Architecture, decisions, implementation |
| 8 | Cross-Functional Requirements | Data, integration, operations |
| 9 | Clarity & Communication | Documentation, stakeholder alignment |
Status de Categoria:
- PASS: 90%+ completo
- PARTIAL: 60-89% completo
- FAIL: <60% completo
Decisao Final:
- READY FOR ARCHITECT: PRD completo e estruturado
- NEEDS REFINEMENT: Requer trabalho adicional
6 Secoes de Navegacao:
| # | Secao | Propósito |
|---|---|---|
| 1 | Understand Trigger & Context | Identificar issue e impacto inicial |
| 2 | Epic Impact Assessment | Analisar impacto em epics atuais e futuros |
| 3 | Artifact Conflict Analysis | Revisar PRD, Architecture, Frontend Spec |
| 4 | Path Forward Evaluation | Avaliar opcoes (ajuste, rollback, re-scope) |
| 5 | Sprint Change Proposal | Componentes da proposta |
| 6 | Final Review & Handoff | Aprovacao e proximos passos |
- Sempre comece com Project Brief - O brief fornece fundacao essencial
- Use modo Interactive - Para PRDs complexos, a elicitacao e crucial
- Valide com checklist - Execute pm-checklist antes de handoff
- Fragmente documentos grandes - Use
*shard-prdpara manutenibilidade - Documente decisoes - Rationale para escolhas tecnicas e de escopo
- Avalie escopo primeiro - Se > 3 stories, considere PRD completo
- Analise projeto existente - Entenda padroes antes de propor mudancas
- Planeje quality gates - Inclua validação apropriada para cada story
- Identifique agents especializados - Atribua experts conforme tipo de mudanca
- Inclua rollback plan - Sempre tenha estrategia de reversao
- Nao pule para solucoes - Entenda completamente o problema primeiro
- Avalie impacto em cascata - Mudancas ripple through do projeto
- Documente trade-offs - Seja honesto sobre custos e beneficios
- Obtenha aprovacao explicita - Nunca assuma concordancia implicita
- Defina criterios de sucesso - Como saberemos se a mudanca funcionou?
Causas Comuns:
- Problema não claramente definido
- MVP muito grande ou muito pequeno
- Requisitos ambiguos
Solucao:
- Revise categorias com FAIL
- Refine requisitos especificos
- Valide escopo com stakeholders
Causas Comuns:
- Tentando fazer muito em um epic
- Mudancas arquiteturais necessarias
Solucao:
- Divida em multiplos epics
- Considere PRD brownfield completo
- Consulte @architect para decisoes tecnicas
Causas Comuns:
- Requisito descoberto tarde
- Limitacao tecnica encontrada
- Pivot baseado em feedback
Solucao:
- Execute
*correct-course - Siga change-checklist
- Documente proposta e obtenha aprovacao
Causas Comuns:
- Caminho incorreto
- Template renomeado
Solucao:
- Verifique
.aiox-core/product/templates/ - Liste templates disponiveis com create-doc
- Atualize referencia no agente se necessario
- Agent Definition: pm.md
- Task: create-doc.md
- Task: brownfield-create-epic.md
- Task: correct-course.md
- Template: prd-tmpl.yaml
- Template: brownfield-prd-tmpl.yaml
- Checklist: pm-checklist.md
- Checklist: change-checklist.md
- Workflow: brownfield-discovery.yaml
| Aspecto | Detalhes |
|---|---|
| Total de Tasks | 7 task files |
| Templates | 2 (PRD greenfield + brownfield) |
| Checklists | 2 (PM validation + Change navigation) |
| Workflows | 1 (Brownfield Discovery - Fase 10) |
| Comandos Principais | 7 (*create-prd, *create-epic, *research, etc.) |
| Agentes Colaboradores | @po, @sm, @architect, @analyst, @ux-expert |
| Handoff Principal | PM -> Architect (PRD aprovado) |
| Data | Autor | Descrição |
|---|---|---|
| 2026-02-04 | Technical Doc Specialist | Documento inicial criado |
| 2026-02-04 | Technical Doc Specialist | Adicionados diagramas Mermaid (6 flowcharts + 1 stateDiagram) |
-- Morgan, planejando o futuro 📊