Nébula
GitHub

Referência

Commands Skills Workflows

Comandos para uso combinado e isolado de Skills e Workflows, incluindo uso de Templates para Docs.

commands-skills-workflows.mdMARKDOWNLeitura: 1 minSeções: 15

Leitura obrigatória

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

Uso combinado (recomendado)

Template

Objetivo: <objetivo>
Workflow: Workflows/<workflow>.md
Skills:
- Skills/<skill1>.md
- Skills/<skill2>.md
 
Contexto:
- Docs/plan.md
- Docs/tasks.md
- Docs/control.md
 
Saída:
1) plano por etapas do workflow
2) execução guiada pelas skills
3) evidências
4) riscos e pendências

Exemplo: nova tela

Objetivo: Entregar nova tela com validação de fluxo e design.
Workflow: Workflows/new-screen.md
Skills:
- Skills/ui-ux.md
- Skills/flow.md
- Skills/tests.md
Contexto: Docs/pages.md, Docs/flow.md, Docs/design-system.md, Docs/tasks.md
Saída: implementação validada, e2e e atualização de control.

Exemplo: alteração de contrato

Objetivo: Atualizar contrato e propagar impacto sem quebra.
Workflow: Workflows/contract-change.md
Skills:
- Skills/contracts.md
- Skills/integration.md
- Skills/curl.md
Contexto: Docs/contract.yaml, Docs/architecture.md, Docs/entities.md
Saída: contrato atualizado, validações curl e riscos.

Uso isolado de Workflow (quando o escopo já está claro)

Template

Objetivo: <objetivo>
Workflow: Workflows/<workflow>.md
Modo: workflow isolado
Contexto: Docs/<artefatos da demanda>
Saída: execução conforme sequência recomendada do workflow.

Exemplo

Objetivo: Preparar release da milestone M2.
Workflow: Workflows/release.md
Modo: workflow isolado
Contexto: Docs/deploy.md, Docs/plan.md, Docs/control.md
Saída: checklist de release concluído e gate final.

Uso isolado de Skill (quando o foco é técnico pontual)

Template

Objetivo: <objetivo técnico específico>
Skill: Skills/<skill>.md
Modo: skill isolada
Contexto: Docs/<artefatos relacionados>
Saída: análise, execução e evidências técnicas do domínio.

Exemplo

Objetivo: Validar integração externa por contrato e curl.
Skill: Skills/curl.md
Modo: skill isolada
Contexto: Docs/contract.yaml, Docs/tasks.md
Saída: comandos executados, respostas e evidências registradas.

Uso de Templates para criar artefatos em Docs

Template de comando

Objetivo: Criar/editar artefato oficial em Docs usando template como modelo.
Template fonte: Templates/Full/<arquivo>.md
Destino oficial: Docs/<arquivo>.md
Workflow: Workflows/<workflow>.md
Saída: artefato em Docs atualizado e rastreável.

Exemplo

Objetivo: Estruturar plano operacional do ciclo.
Template fonte: Templates/Full/plan.md
Destino oficial: Docs/plan.md
Workflow: Workflows/initial-setup.md
Saída: fases, milestones, dependências e riscos iniciais.

Checklist de escolha rápida

  1. Demanda ampla e com dependências: workflow + skills.
  2. Demanda procedural clara: workflow isolado.
  3. Ajuste técnico pontual: skill isolada.
  4. Geração/edição documental: template + Docs + workflow.