Matriz oficial de cenários possíveis no Framework Nébula.
Leitura obrigatória
commands-baseline.mdcommands-agents.mdcommands-direct-chat.mdcommands-skills-workflows.md
Matriz de cenários por workflow
| Cenário | Workflow principal | Modo com agentes | Modo sem agentes | Skills recomendadas | Docs mínimos |
|---|---|---|---|---|---|
| Bootstrap estrutural | Workflows/bootstrap-structure.md | ExecutionAgent -> QualityAgent | Responsável técnico + revisão de qualidade | implementation, scripts, tests | Docs/structure.md, Docs/tasks.md, Docs/control.md |
| Setup inicial | Workflows/initial-setup.md | ScopeAgent -> ProductAgent -> SystemAgent -> ExecutionAgent -> QualityAgent | Time humano em sequência | user-stories, contracts, ui-ux, flow, tests | Docs/brief.md, Docs/project.md, Docs/stack.md, Docs/plan.md |
| Nova feature | Workflows/new-feature.md | ProductAgent -> SystemAgent -> ExecutionAgent -> QualityAgent | Time humano por etapas | implementation, tests, contracts, flow | Docs/user-stories.md, Docs/plan.md, Docs/tasks.md |
| Nova tela | Workflows/new-screen.md | ProductAgent -> ExecutionAgent -> QualityAgent | Time humano por etapas | ui-ux, flow, tests | Docs/pages.md, Docs/flow.md, Docs/design-system.md |
| Nova integração | Workflows/new-integration.md | SystemAgent -> ExecutionAgent -> QualityAgent | Time humano por etapas | integration, contracts, curl, logs | Docs/architecture.md, Docs/contract.yaml, Docs/tasks.md |
| Alteração de contrato | Workflows/contract-change.md | SystemAgent -> ExecutionAgent -> QualityAgent | Time humano por etapas | contracts, integration, curl | Docs/contract.yaml, Docs/entities.md, Docs/architecture.md |
| Alteração de UI | Workflows/ui-change.md | ProductAgent -> ExecutionAgent -> QualityAgent | Time humano por etapas | ui-ux, flow, tests | Docs/pages.md, Docs/flow.md, Docs/design-system.md |
| Bug fix | Workflows/bug-fix.md | ExecutionAgent -> QualityAgent | Time humano + revisão de qualidade | logs, refactoring, tests | Docs/tasks.md, Docs/control.md |
| Refatoração de módulo | Workflows/module-refactoring.md | SystemAgent -> ExecutionAgent -> QualityAgent | Time humano por etapas | refactoring, contracts, tests | Docs/architecture.md, Docs/entities.md, Docs/tasks.md |
| Release | Workflows/release.md | ReleaseAgent -> QualityAgent | Time humano + porteiro de qualidade | deploy, scripts, tests, logs | Docs/deploy.md, Docs/control.md, Docs/tasks.md |
| Hotfix | Workflows/hotfix.md | RecoveryAgent -> QualityAgent -> ReleaseAgent (se necessário) | Time humano emergencial + validação | logs, deploy, curl, tests | Docs/control.md, Docs/deploy.md, Docs/tasks.md |
Cenários por tipo de objetivo
Início de projeto
- Setup inicial.
- Bootstrap estrutural.
- Planejamento da primeira milestone.
Evolução funcional
- Nova feature.
- Nova tela.
- Alteração de UI.
Evolução técnica
- Nova integração.
- Alteração de contrato.
- Refatoração de módulo.
Operação e incidentes
- Release.
- Bug fix.
- Hotfix.
Comandos rápidos por cenário (resumo)
Feature
Objetivo: Entregar feature X
Workflow: Workflows/new-feature.md
Modo: com agentes
Agente inicial: ProductAgent
Contexto: Docs/user-stories.md, Docs/plan.md, Docs/tasks.mdBug
Objetivo: Corrigir bug Y
Workflow: Workflows/bug-fix.md
Modo: sem agentes
Skills: Skills/logs.md, Skills/tests.md
Contexto: Docs/tasks.md, Docs/control.mdRelease
Objetivo: Publicar milestone Mx
Workflow: Workflows/release.md
Modo: com agentes
Agente inicial: ReleaseAgent
Contexto: Docs/deploy.md, Docs/control.mdHotfix
Objetivo: Conter incidente crítico Z
Workflow: Workflows/hotfix.md
Modo: com agentes
Agente inicial: RecoveryAgent
Contexto: Docs/control.md, Docs/deploy.mdDefinição de pronto transversal
- Workflow seguido integralmente.
- Artefatos em Docs atualizados.
- Evidências registradas em Docs/tasks.md.
- Quality Gate aprovado.
- Docs/control.md atualizado com riscos e pendências.