Nébula
GitHub

Operação

Without Agents

Explica como aplicar o mesmo método sem agentes, com o time humano assumindo os papéis de execução e validação.

without-agents.mdMARKDOWNLeitura: 4 minSeções: 25

Modo de execução em que o time humano assume explicitamente os papéis de escopo, produto, sistema, execução e qualidade — sem agentes especializados. O Nébula funciona integralmente nesse modo: a governança, os workflows, a qualidade e a rastreabilidade são idênticos ao modo com agentes. A diferença é quem orquestra.

Fonte: Manual/03NO-AGENTS.md + Manual/06SCENARIOS-NO-AGENTS.md + Manual/17EXECUTION-BASELINE.md
Pré-requisito: Manual/17EXECUTION-BASELINE.md (Execution Baseline)
Alternativa com agentes: Docs/with-agents.md


Como ler este documento

O Manual usa a arquitetura Baseline + Delta:

  • Baseline (Manual/17EXECUTION-BASELINE.md) — fluxo comum a todos os modos
  • Delta (Manual/03NO-AGENTS.md) — o que muda especificamente sem agentes

Este documento consolida os dois para uso direto.


Baseline — Fluxo Comum de Execução

A sequência base é a mesma, com ou sem agentes:

1. Definir objetivo, escopo e restrições da task
2. Selecionar 1 workflow principal em Workflows/
3. Definir skills de suporte técnico em Skills/
4. Editar os artefatos oficiais de Docs/ da demanda
5. Executar o trabalho técnico
6. Aplicar Quality Gate e registrar evidências
7. Encerrar a task com rastreabilidade em Docs/control.md

Regra de Ouro (Baseline)

Templates em Templates/ são modelo.
Artefatos oficiais do projeto são editados em Docs/.
Protótipos HTML ficam em Prototype/.

O que não muda no modo sem agentes

- Docs/ continua sendo a fonte de verdade
- Workflow continua obrigatório por task
- Tasks e Control continuam sendo atualizados
- Quality Gate continua obrigatório antes de fechar task
- Bootstrap estrutural continua restrito à primeira task
- Exatamente 1 commit por task concluída

Artefatos mínimos por task

Docs/plan.md     — plano da fase em andamento
Docs/tasks.md    — lista de tasks com critérios de aceite
Docs/control.md  — painel de rastreabilidade e status

Delta — O que muda no modo sem agentes

Sem agentes, o time humano assume explicitamente 4 funções que no modo com agentes são delegadas:

1. O papel de orquestração é do responsável técnico humano
2. A atribuição de etapas é feita manualmente por membros do time
3. O controle de handoff é explicitado em Docs/control.md
4. As revisões de qualidade são conduzidas pelo time antes do fechamento

Papéis que o Time Assume

No modo com agentes, cada papel tem um agente. No modo sem agentes, o time distribui:

PapelResponsabilidadeQuem assume
EscopoBrief, objetivo, restriçõesPM ou líder técnico
ProdutoUS, pages, flow, protótipoDesigner ou PM
SistemaArquitetura, entities, contratoTech lead ou arquiteto
ExecuçãoPlan, tasks, implementaçãoDev responsável da task
QualidadeGate, validação, evidênciasRevisor ou tech lead
Importante

Mesmo sem agentes, esses papéis devem estar explicitamente atribuídos em cada task de Docs/tasks.md. Papel sem dono é responsabilidade without que cai no esquecimento.


Operação Mínima Recomendada

1. Definir responsável técnico da task
2. Escolher 1 workflow principal em Workflows/
3. Selecionar templates Full ou Quick conforme profundidade
4. Editar os artefatos oficiais em Docs/
5. Validar com Quality/gate.md
6. Registrar evidências e commit em Docs/tasks.md e Docs/control.md

Workflows Disponíveis

WorkflowQuando usar
bootstrap-structure.mdPrimeira task de qualquer projeto — cria a árvore
initial-setup.mdConfiguração inicial de ambiente, dependências e pipeline
new-feature.mdFeature nova com backend e/ou frontend
new-screen.mdTela nova sem mudança de API
new-integration.mdIntegração com serviço externo
contract-change.mdMudança no contrato de API
module-refactoring.mdRefatoração de módulo existente
ui-change.mdMudança visual ou de componente sem nova lógica
bug-fix.mdCorreção de bug em fluxo normal
hotfix.mdCorreção urgente em produção
release.mdPublicação e entrega de versão

Mapeamento de Cenários sem Agentes

CenárioWorkflow principalSkills sugeridas
Novo produto internoinitial-setup.md + new-screen.mdimplementation.md, ui-ux.md
Feature com API e UInew-feature.mdimplementation.md, contracts.md
Integração externanew-integration.mdcontracts.md, implementation.md
Mudança de UIui-change.mdui-ux.md
Refatoraçãomodule-refactoring.mdimplementation.md, tests.md
Bug em produçãobug-fix.mdimplementation.md, tests.md
Hotfix urgentehotfix.mdimplementation.md
Releaserelease.md

Exemplo de chamada (modo sem agentes)

Quero executar a TASK-008 sem agentes especializados.
Siga o workflow Workflows/bug-fix.md.
 
Carregue o contexto:
- GUIDE.md
- Workflows/bug-fix.md
- Skills/implementation.md
- Docs/tasks.md
- Docs/control.md
- Quality/gate.md
 
Retorne:
1) análise do problema
2) plano de correção
3) execução com evidências
4) bloqueios e próximo passo
5) Quality Gate

Card de Cenário sem Agentes (template)

# [Nome do cenário]
 
## Contexto
[o que motivou — gatilho]
 
## Objetivo
[resultado esperado]
 
## Responsável técnico
[nome ou papel]
 
## Workflow
Workflows/[workflow].md
 
## Skills
- Skills/[skill].md
 
## Docs editados
- Docs/plan.md
- Docs/tasks.md
- Docs/control.md
 
## Papéis atribuídos
- Escopo: [quem]
- Produto: [quem]
- Sistema: [quem]
- Execução: [quem]
- Qualidade: [quem]
 
## Etapas
1. Planejar
2. Executar
3. Validar
4. Encerrar
 
## Evidências
- Quality Gate aprovado
- hash do commit
- riscos e pendências

Evidências de fechamento

Docs oficiais atualizados:   Docs/tasks.md e Docs/control.md refletem a task encerrada
Responsável técnico definido: task.md tem nome do responsável
Quality Gate aprovado:       critérios de Quality/gate.md cumpridos
Hash do commit:              1 commit por task, hash registrado no control
Riscos e pendências:         documentados em Docs/control.md

Checklist do modo sem agentes

( ) Responsável técnico da task definido e registrado em tasks.md
( ) Workflow principal definido e seguido
( ) Papéis de escopo, produto, sistema, execução e qualidade atribuídos
( ) Docs editados com rastreabilidade de mudança
( ) Skills consultadas e registradas
( ) Evidências do Quality Gate anexadas
( ) Hash do commit registrado em control.md
( ) Riscos e pendências atualizados no control

Quando usar sem agentes vs com agentes

CritérioSem agentesCom agentes
Demanda simples e bem definida
Time pequeno ou baixa complexidade
Preferência por orquestração manual
Demanda cruza múltiplos domínios
Alto risco de interpretação
Time quer clareza de papel por domínio

Erros comuns

ErroCorreção
Operar sem agente e também sem workflowWorkflow é obrigatório — sem ele não há rastreabilidade de processo
Atualizar só o código e esquecer os DocsDocs/ é a fonte de verdade — task sem Docs atualizados não está encerrada
Fechar task sem evidência de GateQuality Gate sem evidência é gate não aplicado
Papéis não atribuídos explicitamenteRegistrar responsável por papel em cada task
Mais de 1 commit por task1 task = 1 commit = 1 entrada no control
Bootstrap em task de ediçãoBootstrap é exclusivo da primeira task