Prompt file imported from raphab3/workcycle (.github/prompts/2-core-flow.prompt.md). Copyright stays with the author.

Fase 2 — CORE FLOW: Decomposição em Módulos

Name: 2-core-flow
Author: raphab3

Você está na Fase 2: CORE FLOW. O Epic foi aprovado. Agora decomponha o sistema em fluxos lógicos e mapeie a arquitetura de implementação.

Regras desta Fase

Leia o epic.md antes de tudo — todo Core Flow deriva do Epic aprovado
Reuse a stack detectada no Epic e só complemente detalhes técnicos quando eles estiverem suportados pelo codebase ou pelo usuário
Identifique entre 3 e 8 fluxos (menos = granularidade insuficiente, mais = excesso de complexidade)
Para cada fluxo, defina: o que faz, quem usa, componentes envolvidos, dependências
Gere um diagrama Mermaid para o fluxo principal e para arquitetura geral
Identifique claramente as dependências entre fluxos (o que deve vir antes)

Estrutura de decomposição

1. Fluxos do Usuário (User Flows)

Mapeie a jornada do usuário pelos principais cenários:

Happy path (caminho ideal)
Caminhos alternativos
Estados de erro e recuperação

2. Módulos do Sistema

Para cada fluxo, identifique os módulos:

Camada	O que considerar
Frontend/UI	Telas, componentes, estados
BFF/API Gateway	Roteamento, autenticação, rate limiting
Backend/Services	Lógica de negócio, regras, validações
Data Layer	Modelos, queries, migrations
Integrações	APIs externas, webhooks, eventos
Infra	Jobs, queues, cache, storage

3. Dependências entre Fluxos

Mapeie quais fluxos bloqueiam outros:

[Fluxo A] → depende de → [Fluxo B]
[Fluxo C] → paralelo com → [Fluxo D]

Diagramas Mermaid

Diagrama de Arquitetura Geral

graph TD
    User([Usuário]) --> FE[Frontend]
    FE --> API[API Layer]
    API --> SVC[Service Layer]
    SVC --> DB[(Database)]
    SVC --> EXT[Serviços Externos]

Diagrama de Fluxo por Módulo

sequenceDiagram
    actor User
    participant UI
    participant API
    participant Service
    participant DB

    User->>UI: Ação
    UI->>API: Request
    API->>Service: Processa
    Service->>DB: Query
    DB-->>Service: Resultado
    Service-->>API: Response
    API-->>UI: Renderiza

Saída: `docs/planning/[epic-slug]/core-flow.md`

# Core Flow: [Nome do Epic]

> **Baseado em:** [link para epic.md] | **Data:** YYYY-MM-DD

## Visão Geral da Arquitetura

[Diagrama Mermaid da arquitetura geral]

## Fluxos

### CF-01: [Nome do Fluxo]
**Descrição:** O que esse fluxo faz e por quê existe  
**Usuários:** Quem aciona esse fluxo  
**Pré-condições:** O que precisa existir antes

**Componentes envolvidos:**
- Frontend: ...
- API: ...
- Service: ...
- DB: ...
- Integrações: ...

**Diagrama:**
[Mermaid do fluxo]

**Edge cases & regras de negócio:**
- ...

**Dependências:** [CF-XX, CF-XX]

---

### CF-02: [Nome do Fluxo]
...

---

## Mapa de Dependências

```mermaid
graph LR
    CF01[CF-01: ...] --> CF02[CF-02: ...]
    CF01 --> CF03[CF-03: ...]
    CF02 --> CF04[CF-04: ...]

Ordem de Implementação Sugerida

Ordem	Fluxo	Motivo
1	CF-01	Base do sistema, sem dependências
2	CF-02	Depende de CF-01
...	...	...

Gerado por PLANNER — Fase 2/3


---

Após gerar o arquivo, pergunte:
> _"O Core Flow cobre todos os cenários do Epic? A ordem de implementação faz sentido? Podemos gerar os tickets?"_

# Fase 2 — CORE FLOW: Decomposição em Módulos Você está na **Fase 2: CORE FLOW**. O Epic foi aprovado. Agora decomponha o sistema em fluxos lógicos e mapeie a arquitetura de implementação. --- ## Regras desta Fase - **Leia o `epic.md` antes de tudo** — todo Core Flow deriva do Epic aprovado - Reuse a **stack detectada no Epic** e só complemente detalhes técnicos quando eles estiverem suportados pelo codebase ou pelo usuário - Identifique entre **3 e 8 fluxos** (menos = granularidade insuficiente, mais = excesso de complexidade) - Para cada fluxo, defina: o que faz, quem usa, componentes envolvidos, dependências - Gere um **diagrama Mermaid** para o fluxo principal e para arquitetura geral - Identifique claramente as **dependências entre fluxos** (o que deve vir antes) --- ## Estrutura de decomposição ### 1. Fluxos do Usuário (User Flows) Mapeie a jornada do usuário pelos principais cenários: - Happy path (caminho ideal) - Caminhos alternativos - Estados de erro e recuperação ### 2. Módulos do Sistema Para cada fluxo, identifique os módulos: | Camada | O que considerar | |--------|-----------------| | **Frontend/UI** | Telas, componentes, estados | | **BFF/API Gateway** | Roteamento, autenticação, rate limiting | | **Backend/Services** | Lógica de negócio, regras, validações | | **Data Layer** | Modelos, queries, migrations | | **Integrações** | APIs externas, webhooks, eventos | | **Infra** | Jobs, queues, cache, storage | ### 3. Dependências entre Fluxos Mapeie quais fluxos bloqueiam outros: ``` [Fluxo A] → depende de → [Fluxo B] [Fluxo C] → paralelo com → [Fluxo D] ``` --- ## Diagramas Mermaid ### Diagrama de Arquitetura Geral ```mermaid graph TD User([Usuário]) --> FE[Frontend] FE --> API[API Layer] API --> SVC[Service Layer] SVC --> DB[(Database)] SVC --> EXT[Serviços Externos] ``` ### Diagrama de Fluxo por Módulo ```mermaid sequenceDiagram actor User participant UI participant API participant Service participant DB User->>UI: Ação UI->>API: Request API->>Service: Processa Service->>DB: Query DB-->>Service: Resultado Service-->>API: Response API-->>UI: Renderiza ``` --- ## Saída: `docs/planning/[epic-slug]/core-flow.md` ```markdown # Core Flow: [Nome do Epic] > **Baseado em:** [link para epic.md] | **Data:** YYYY-MM-DD ## Visão Geral da Arquitetura [Diagrama Mermaid da arquitetura geral] ## Fluxos ### CF-01: [Nome do Fluxo] **Descrição:** O que esse fluxo faz e por quê existe **Usuários:** Quem aciona esse fluxo **Pré-condições:** O que precisa existir antes **Componentes envolvidos:** - Frontend: ... - API: ... - Service: ... - DB: ... - Integrações: ... **Diagrama:** [Mermaid do fluxo] **Edge cases & regras de negócio:** - ... **Dependências:** [CF-XX, CF-XX] --- ### CF-02: [Nome do Fluxo] ... --- ## Mapa de Dependências ```mermaid graph LR CF01[CF-01: ...] --> CF02[CF-02: ...] CF01 --> CF03[CF-03: ...] CF02 --> CF04[CF-04: ...] ``` ## Ordem de Implementação Sugerida | Ordem | Fluxo | Motivo | |-------|-------|--------| | 1 | CF-01 | Base do sistema, sem dependências | | 2 | CF-02 | Depende de CF-01 | | ... | ... | ... | --- *Gerado por PLANNER — Fase 2/3* ``` --- Após gerar o arquivo, pergunte: > _"O Core Flow cobre todos os cenários do Epic? A ordem de implementação faz sentido? Podemos gerar os tickets?"_

{ "prompt": "# Fase 2 — CORE FLOW: Decomposição em Módulos\n\nVocê está na **Fase 2: CORE FLOW**. O Epic foi aprovado. Agora decomponha o sistema em fluxos lógicos e mapeie a arquitetura de implementação.\n\n---\n\n## Regras desta Fase\n\n- **Leia o `epic.md` antes de tudo** — todo Core Flow deriva do Epic aprovado\n- Reuse a **stack detectada no Epic** e só complemente detalhes técnicos quando eles estiverem suportados pelo codebase ou pelo usuário\n- Identifique entre **3 e 8 fluxos** (menos = granularidade insuficiente, mais = excesso de complexidade)\n- Para cada fluxo, defina: o que faz, quem usa, componentes envolvidos, dependências\n- Gere um **diagrama Mermaid** para o fluxo principal e para arquitetura geral\n- Identifique claramente as **dependências entre fluxos** (o que deve vir antes)\n\n---\n\n## Estrutura de decomposição\n\n### 1. Fluxos do Usuário (User Flows)\nMapeie a jornada do usuário pelos principais cenários:\n- Happy path (caminho ideal)\n- Caminhos alternativos\n- Estados de erro e recuperação\n\n### 2. Módulos do Sistema\nPara cada fluxo, identifique os módulos:\n\n| Camada | O que considerar |\n|--------|-----------------|\n| **Frontend/UI** | Telas, componentes, estados |\n| **BFF/API Gateway** | Roteamento, autenticação, rate limiting |\n| **Backend/Services** | Lógica de negócio, regras, validações |\n| **Data Layer** | Modelos, queries, migrations |\n| **Integrações** | APIs externas, webhooks, eventos |\n| **Infra** | Jobs, queues, cache, storage |\n\n### 3. Dependências entre Fluxos\nMapeie quais fluxos bloqueiam outros:\n```\n[Fluxo A] → depende de → [Fluxo B]\n[Fluxo C] → paralelo com → [Fluxo D]\n```\n\n---\n\n## Diagramas Mermaid\n\n### Diagrama de Arquitetura Geral\n```mermaid\ngraph TD\n User([Usuário]) --> FE[Frontend]\n FE --> API[API Layer]\n API --> SVC[Service Layer]\n SVC --> DB[(Database)]\n SVC --> EXT[Serviços Externos]\n```\n\n### Diagrama de Fluxo por Módulo\n```mermaid\nsequenceDiagram\n actor User\n participant UI\n participant API\n participant Service\n participant DB\n\n User->>UI: Ação\n UI->>API: Request\n API->>Service: Processa\n Service->>DB: Query\n DB-->>Service: Resultado\n Service-->>API: Response\n API-->>UI: Renderiza\n```\n\n---\n\n## Saída: `docs/planning/[epic-slug]/core-flow.md`\n\n```markdown\n# Core Flow: [Nome do Epic]\n\n> **Baseado em:** [link para epic.md] | **Data:** YYYY-MM-DD\n\n## Visão Geral da Arquitetura\n\n[Diagrama Mermaid da arquitetura geral]\n\n## Fluxos\n\n### CF-01: [Nome do Fluxo]\n**Descrição:** O que esse fluxo faz e por quê existe \n**Usuários:** Quem aciona esse fluxo \n**Pré-condições:** O que precisa existir antes\n\n**Componentes envolvidos:**\n- Frontend: ...\n- API: ...\n- Service: ...\n- DB: ...\n- Integrações: ...\n\n**Diagrama:**\n[Mermaid do fluxo]\n\n**Edge cases & regras de negócio:**\n- ...\n\n**Dependências:** [CF-XX, CF-XX]\n\n---\n\n### CF-02: [Nome do Fluxo]\n...\n\n---\n\n## Mapa de Dependências\n\n```mermaid\ngraph LR\n CF01[CF-01: ...] --> CF02[CF-02: ...]\n CF01 --> CF03[CF-03: ...]\n CF02 --> CF04[CF-04: ...]\n```\n\n## Ordem de Implementação Sugerida\n\n| Ordem | Fluxo | Motivo |\n|-------|-------|--------|\n| 1 | CF-01 | Base do sistema, sem dependências |\n| 2 | CF-02 | Depende de CF-01 |\n| ... | ... | ... |\n\n---\n*Gerado por PLANNER — Fase 2/3*\n```\n\n---\n\nApós gerar o arquivo, pergunte:\n> _\"O Core Flow cobre todos os cenários do Epic? A ordem de implementação faz sentido? Podemos gerar os tickets?\"_", "variables": [], "notes": "Você está na **Fase 2: CORE FLOW**. O Epic foi aprovado. Agora decomponha o sistema em fluxos lógicos e mapeie a arquitetura de implementação.", "metadata": { "source": { "provider": "github-prompts", "repository": "https://github.com/raphab3/workcycle", "path": ".github/prompts/2-core-flow.prompt.md", "ref": "5e9b7c08b05e63e810c40df47c8b2e32079bd0a0", "url": "https://github.com/raphab3/workcycle/blob/5e9b7c08b05e63e810c40df47c8b2e32079bd0a0/.github/prompts/2-core-flow.prompt.md", "key": "raphab3/workcycle/.github/prompts/2-core-flow.prompt.md" } } }

2-core-flow

About

Fase 2 — CORE FLOW: Decomposição em Módulos

Regras desta Fase

Estrutura de decomposição

1. Fluxos do Usuário (User Flows)

2. Módulos do Sistema

3. Dependências entre Fluxos

Diagramas Mermaid

Diagrama de Arquitetura Geral

Diagrama de Fluxo por Módulo

Saída: `docs/planning/[epic-slug]/core-flow.md`

Ordem de Implementação Sugerida

Use it

Manifest

Reviews

About

Fase 2 — CORE FLOW: Decomposição em Módulos

Regras desta Fase

Estrutura de decomposição

1. Fluxos do Usuário (User Flows)

2. Módulos do Sistema

3. Dependências entre Fluxos

Diagramas Mermaid

Diagrama de Arquitetura Geral

Diagrama de Fluxo por Módulo

Saída: docs/planning/[epic-slug]/core-flow.md

Ordem de Implementação Sugerida

Use it

Manifest

Reviews

Saída: `docs/planning/[epic-slug]/core-flow.md`