Nébula
GitHub

Referência

Commands Agents

Catálogo completo de comandos com agentes, incluindo prompt-base por papel e handoffs.

commands-agents.mdMARKDOWNLeitura: 1 minSeções: 15

Catálogo operacional de comandos para uso com agentes do Nébula.

Leitura obrigatória antes de usar este catálogo:

  1. commands-baseline.md
  2. agents.md
  3. workflows.md

Prompt-base para qualquer agente

Atue como <AgentName>.
Objetivo: <objetivo da task>
Workflow: Workflows/<workflow>.md
 
Carregue contexto base:
- GUIDE.md
- Skills/README.md
- Workflows/README.md
- Quality/README.md
- Templates/Full/README.md
 
Carregue contexto especializado conforme agents/<role>.md.
Carregue contexto de execução em Docs/plan.md, Docs/tasks.md e Docs/control.md.
 
Saída obrigatória:
1) plano
2) execução
3) evidências
4) riscos e pendências para Docs/control.md

Comandos por agente

Scope

Atue como Scope.
Objetivo: Definir escopo da demanda e consolidar Docs/brief.md e Docs/project.md.
Workflow: Workflows/initial-setup.md
Contexto: Docs/brief.md, Docs/project.md, Docs/plan.md
Saída: escopo in/out, restrições, objetivos mensuráveis, riscos iniciais.

Product

Atue como Product.
Objetivo: Estruturar requisito funcional e jornada de usuário.
Workflow: Workflows/new-feature.md
Contexto: Docs/project.md, Docs/user-stories.md, Docs/pages.md, Docs/flow.md
Saída: histórias, fluxo, riscos de jornada e impactos de UI.

System

Atue como System.
Objetivo: Consolidar modelagem técnica e contrato.
Workflow: Workflows/new-integration.md
Contexto: Docs/entities.md, Docs/architecture.md, Docs/contract.yaml
Saída: fronteiras, contrato, impacto técnico e mitigação.

Execution

Atue como Execution.
Objetivo: Executar a TASK-<id> com rastreabilidade.
Workflow: Workflows/bug-fix.md
Contexto: Docs/plan.md, Docs/tasks.md, Docs/control.md
Saída: plano, alterações, evidências e atualização da task.

Quality

Atue como Quality.
Objetivo: Aplicar Quality Gate para fechamento da TASK-<id>.
Workflow: Workflows/release.md
Contexto: Docs/tasks.md, Docs/control.md, Quality/validation-rules.md
Saída: aprovado/reprovado, evidências faltantes e pendências.

Release

Atue como Release.
Objetivo: Preparar e validar release da milestone atual.
Workflow: Workflows/release.md
Contexto: Docs/deploy.md, Docs/plan.md, Docs/control.md
Saída: checklist de rollout, validações, rollback e status final.

Recovery

Atue como Recovery.
Objetivo: Conter incidente crítico com menor risco.
Workflow: Workflows/hotfix.md
Contexto: Docs/control.md, Docs/deploy.md, logs atuais
Saída: causa provável, contenção, fix, validação pós-fix e risco residual.

Comandos de handoff entre agentes

Handoff Scope -> Product

Encerrar Scope e passar para Product.
Inclua: resumo do escopo, critérios de sucesso e restrições.
Objetivo do próximo agente: detalhar User Stories e fluxo.

Handoff Product -> System

Encerrar Product e passar para System.
Inclua: fluxo final, decisões de UI e riscos funcionais.
Objetivo do próximo agente: modelagem técnica e contrato.

Handoff System -> Execution

Encerrar System e passar para Execution.
Inclua: contrato final, fronteiras e riscos técnicos.
Objetivo do próximo agente: quebrar e executar tasks.

Handoff Execution -> Quality

Encerrar Execution e passar para Quality.
Inclua: hash de commit, arquivos tocados e evidências executadas.
Objetivo do próximo agente: decisão de gate.

Checklist mínimo antes de enviar o comando

  1. Agente correto para o objetivo.
  2. Workflow declarado.
  3. Contexto de Docs/ explícito.
  4. Formato de saída declarado.
  5. Regras de governança explícitas quando necessário.