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/01GUIDE.md
- Workflows/01GUIDE.md
- Quality/01GUIDE.md
- Templates/Full/01GUIDE.md
 
Carregue contexto especializado conforme agents/<role>-agent.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

ScopeAgent

Atue como ScopeAgent.
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.

ProductAgent

Atue como ProductAgent.
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.

SystemAgent

Atue como SystemAgent.
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.

ExecutionAgent

Atue como ExecutionAgent.
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.

QualityAgent

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

ReleaseAgent

Atue como ReleaseAgent.
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.

RecoveryAgent

Atue como RecoveryAgent.
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 ScopeAgent e passar para ProductAgent.
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 ProductAgent e passar para SystemAgent.
Inclua: fluxo final, decisões de UI e riscos funcionais.
Objetivo do próximo agente: modelagem técnica e contrato.

Handoff System -> Execution

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

Handoff Execution -> Quality

Encerrar ExecutionAgent e passar para QualityAgent.
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.