4.4 KiB
name, description
| name | description |
|---|---|
| start | Orquestrador do pipeline de trabalho novo — brainstorm → discover → spec → plan → execute. Use quando iniciar sistema novo, feature grande, ou projecto com múltiplos componentes. Impede saltar para execução sem planeamento. |
/start — Pipeline de trabalho novo
Orquestra as 5 fases obrigatórias para qualquer trabalho novo não-trivial. Anti-pattern que combate: saltar directamente para código sem brainstorm/spec/plan.
Quando usar
USAR quando:
- Utilizador pede sistema/pipeline/feature nova com >2 componentes
- Trabalho estimado >1h ou >3 ficheiros
- Projecto novo em
05-Projectos/ouDev/ - Qualquer tarefa em que a abordagem não está obviamente definida
NÃO usar quando:
- Bugfix / correcção pontual
- Operação unitária conhecida
- Continuação de plano já existente
- Admin / manutenção / diagnóstico
Protocolo (5 fases sequenciais)
Fase 1 — Brainstorming (obrigatório)
Invocar superpowers:brainstorming skill OU project-manager:brainstorm skill.
Objectivos:
- Explorar 3+ abordagens alternativas
- Identificar requisitos explícitos e implícitos
- Listar trade-offs conhecidos
- Detectar ambiguidades que precisam de clarificação do utilizador
Output: secção "Brainstorming" com alternativas consideradas.
Fase 2 — Discover / Research (obrigatório)
Invocar project-manager:discover skill.
Verificar em paralelo:
- Codebase actual — existem componentes reutilizáveis? Glob + Grep
- NotebookLM — há notebook relevante?
mcp__notebooklm-mcp__notebook_list+ query - Hub — procedimentos, QRs, decisões anteriores? Grep em
Hub/06-Operacoes/ - Memórias — contexto de sessões anteriores?
mcp__mem0__search_memories - Web (se externo) — context7, WebSearch para libs/frameworks
- Desk CRM — tarefa associada? Projecto relacionado?
Output: secção "Discovery" com fontes consultadas e descobertas relevantes.
Fase 3 — SPEC (obrigatório)
Invocar gestao:spec-coauthor OU project-manager:spec (skill spec create).
Gerar SPEC.md no directório do projecto (Hub/05-Projectos/NOME/ ou Dev/NOME/) com:
- Porquê — problema que resolve
- Escopo — o que entra
- Não-escopo — o que NÃO entra (crítico contra scope creep)
- Critérios de sucesso — como saber que está pronto
- Arquitectura — diagrama ou descrição dos componentes
- Riscos — o que pode correr mal
- Plano faseado — divisão em MVPs
Aguardar aprovação do utilizador. Marcar como aprovado com <!-- APPROVED: YYYY-MM-DD --> no topo.
Fase 4 — Plan detalhado (obrigatório)
Invocar superpowers:writing-plans skill.
Traduzir SPEC em plano executável:
- Lista numerada de passos concretos
- Cada passo tem: acção, comando/código esperado, critério de validação
- Ordem de execução e dependências
- Checkpoints de revisão humana
Guardar em Hub/05-Projectos/NOME/PLAN.md ou .claude/plans/NOME.md.
Fase 5 — Execução (finalmente)
Invocar superpowers:executing-plans ou superpowers:subagent-driven-development.
Durante execução:
- Seguir PLAN.md passo a passo
- Marcar progresso em TodoWrite
- Validar cada passo antes do seguinte
- Comentar no Desk CRM task associada
- Se desviar do spec → parar e actualizar SPEC.md primeiro (scope creep alert)
Output esperado da skill
Ao invocar /start "descrição do trabalho":
/start detectou novo trabalho: "descrição"
Fase actual: 1 — Brainstorming
Próxima: Discovery
[invoca brainstorming skill automaticamente]
Skill não salta fases. Se utilizador insistir em saltar, avisa mas aceita override explícito (/start --skip-to=execute).
Anti-patterns
- NUNCA começar Fase 5 (execução) sem Fases 1-4 completas
- NUNCA criar código antes de SPEC.md aprovado
- NUNCA inventar decisões arquitecturais sem brainstorming documentado
- NUNCA tratar "pareceu boa ideia" como substituto de discovery
- SEMPRE criar SPEC.md no repositório do projecto (não em
/tmpou inline) - SEMPRE aguardar aprovação explícita entre fases críticas
Integração com spec-gate.sh
O hook spec-gate.sh (PreToolUse Write|Edit) valida que existe SPEC.md aprovado antes de permitir edições em /Dev. Esta skill garante que esse SPEC é criado via pipeline correcto antes de chegar à execução.
Para bypass temporário (quick fixes, 30min): /spec bypass.
Skill v1.0.0 | 2026-04-08 | Descomplicar®