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.mdRegra 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ídaArtefatos 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 statusDelta — 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 fechamentoPapéis que o Time Assume
No modo com agentes, cada papel tem um agente. No modo sem agentes, o time distribui:
| Papel | Responsabilidade | Quem assume |
|---|---|---|
| Escopo | Brief, objetivo, restrições | PM ou líder técnico |
| Produto | US, pages, flow, protótipo | Designer ou PM |
| Sistema | Arquitetura, entities, contrato | Tech lead ou arquiteto |
| Execução | Plan, tasks, implementação | Dev responsável da task |
| Qualidade | Gate, validação, evidências | Revisor ou tech lead |
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.mdWorkflows Disponíveis
| Workflow | Quando usar |
|---|---|
bootstrap-structure.md | Primeira task de qualquer projeto — cria a árvore |
initial-setup.md | Configuração inicial de ambiente, dependências e pipeline |
new-feature.md | Feature nova com backend e/ou frontend |
new-screen.md | Tela nova sem mudança de API |
new-integration.md | Integração com serviço externo |
contract-change.md | Mudança no contrato de API |
module-refactoring.md | Refatoração de módulo existente |
ui-change.md | Mudança visual ou de componente sem nova lógica |
bug-fix.md | Correção de bug em fluxo normal |
hotfix.md | Correção urgente em produção |
release.md | Publicação e entrega de versão |
Mapeamento de Cenários sem Agentes
| Cenário | Workflow principal | Skills sugeridas |
|---|---|---|
| Novo produto interno | initial-setup.md + new-screen.md | implementation.md, ui-ux.md |
| Feature com API e UI | new-feature.md | implementation.md, contracts.md |
| Integração externa | new-integration.md | contracts.md, implementation.md |
| Mudança de UI | ui-change.md | ui-ux.md |
| Refatoração | module-refactoring.md | implementation.md, tests.md |
| Bug em produção | bug-fix.md | implementation.md, tests.md |
| Hotfix urgente | hotfix.md | implementation.md |
| Release | release.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 GateCard 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ênciasEvidê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.mdChecklist 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 controlQuando usar sem agentes vs com agentes
| Critério | Sem agentes | Com 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
| Erro | Correção |
|---|---|
| Operar sem agente e também sem workflow | Workflow é obrigatório — sem ele não há rastreabilidade de processo |
| Atualizar só o código e esquecer os Docs | Docs/ é a fonte de verdade — task sem Docs atualizados não está encerrada |
| Fechar task sem evidência de Gate | Quality Gate sem evidência é gate não aplicado |
| Papéis não atribuídos explicitamente | Registrar responsável por papel em cada task |
| Mais de 1 commit por task | 1 task = 1 commit = 1 entrada no control |
| Bootstrap em task de edição | Bootstrap é exclusivo da primeira task |