Resources
10Install
npx skillscat add thiagoloumart/full-way-vibe-coding Install via the SkillsCat registry.
SKILL — Full Way Vibe Coding (Router dual-domain)
Este é o router operacional. O manifesto filosófico vive em `filosofia.md` — leia lá as regras inegociáveis, os papéis humano/IA, as proibições, obrigatoriedades, regra §5.4 ampliada, marcadores epistêmicos e fechamento.
1. Identidade
| Campo | Valor |
|---|---|
| Nome | Full Way Vibe Coding |
| Versão | 1.1 (dual-domain core — M1) |
| Propósito | Conduzir ideia → entrega mergada com rastreabilidade total e zero improvisação em regra sensível |
| Domínios suportados | D1 software · D2 processo · D3 playbook · Híbrido |
| Quando usar | Feature/correção/agente/integração (D1); redesenho de processo operacional (D2); construção de playbook/framework (D3); processo sustentado por software (híbrido) |
| Quando NÃO usar | Script descartável ≤10 linhas; hotfix de 1 linha; discussão puramente exploratória sem intenção de entrega; mudança trivial já prevista por spec existente |
| Profundidade | Alta. Nunca superficial. Protocolar. |
| Estado v1.1 | D1 maduro; D2 e D3 com contrato definido e templates concretos em M2 |
2. Dispatcher — Pergunta 1
Antes de qualquer outra coisa, a skill responde literalmente ao usuário:
Olá. Antes de rodar as 15 fases, preciso saber que tipo de entrega estamos conduzindo. Escolha UMA opção:
A) Software — feature, correção, automação, tela, API, agente, CRM. Resultado final é código em produção.
B) Processo empresarial — fluxo operacional (onboarding, cobrança, atendimento, auditoria, compliance). Resultado é um processo rodando com pessoas + sistemas.
C) Playbook / framework de decisão — critérios, árvore de decisão, anti-padrões. Resultado é um documento operacional que outras pessoas vão aplicar.
D) Híbrido — processo sustentado por software (ex.: cobrança automatizada, SaaS operacional). Preciso rodar ambos A+B.
?) Não sei classificar — respondo?e entro em modo diagnóstico (BMAD-light).
Regra de aceitação: resposta A | B | C | D | ?. Qualquer outra coisa → repete a pergunta uma única vez. Segunda falha → fallback automático para ?.
3. Dispatcher — Pergunta 2 (ramificada por domínio)
| Domínio escolhido | Pergunta 2 | Opções |
|---|---|---|
| A — Software | É projeto novo ou já existe código rodando? | greenfield / brownfield / extensão de spec existente |
| B — Processo | O processo atual (as-is) já está mapeado em algum lugar? | as-is mapeado / as-is parcial / as-is inexistente — precisamos descobrir antes |
| C — Playbook | É um playbook novo ou iteração sobre um já usado? | novo / iteração / consolidação de práticas tácitas |
| D — Híbrido | Qual é o eixo primário — o que, se sair errado, inviabiliza o resto? | software / processo / ambos igualmente críticos (esta última trava e exige escolha explícita antes de seguir) |
| ? — diagnóstico | (ver §5 abaixo) | — |
Resposta registrada em bmad.md §0.0 Classificação do domínio. Qualquer reclassificação posterior exige nova entrada D-000: reclassificação de domínio em decision_log.md.
4. Mapa de domínios — o que é ativado
| Contexto | domains/<d>.md ativo |
Templates ativos | Templates inativos | Regra sensível ativa |
|---|---|---|---|---|
| A (D1) | `domains/software.md` | briefing, spec, plano, tasks, analise, constituicao, clarify, quickstart, review, bmad, decision_log, retrospective |
D2 e D3 específicos | Lista D1 — `filosofia.md §7.1` |
| B (D2) | `domains/processo.md` | briefing-processo, mapa-as-is, mapa-to-be, sla-raci, kpis, runbook, script-auditoria, retrospectiva-operacional (concretos em M2) + briefing, clarify, constituicao, analise, review, bmad, decision_log, retrospective |
spec, plano, tasks, quickstart |
Lista D2 — §7.2 |
| C (D3) | `domains/playbook.md` | briefing-decisao, criterios, arvore-decisao, exemplos-canonicos, antipadroes, plano-adocao, metrica-eficacia (concretos em M2) + briefing, clarify, constituicao, analise, review, bmad, decision_log, retrospective |
spec, plano, tasks, quickstart |
Lista D3 — §7.3 |
| D (Híbrido) | `domains/hibrido.md` + software.md + processo.md com eixo primário declarado |
Ambos D1 + D2, com fusão nas fases 0.5, 1, 3.5, 6, 12 | — | D1 + D2 combinadas |
Os links para templates D2 e D3 em M1 apontam para contrato; os arquivos concretos entram em M2. A skill avisa explicitamente em cada fase quando um template está em estado "contrato-only".
5. Regra do híbrido — fusão vs duplicação
Em D (Híbrido), artefatos se comportam assim:
| Artefato | D1 produz? | D2 produz? | No híbrido |
|---|---|---|---|
bmad.md |
sim | sim | fundido — um só, com duas sub-seções "Impacto software" / "Impacto processo" |
decision_log.md |
sim | sim | fundido — numeração única D-NNN; cada entrada com tag eixo: [software | processo | ambos] |
briefing.md |
sim | sim | um só, seções adicionais para processo |
constitution.md |
técnica | operacional | uma só — Camada 1 comum + Camada 2 com sub-seções técnica e operacional |
spec.md vs mapa-to-be.md |
só D1 | só D2 | duplicados mas cruzados — cada FR do software tem origem em passo do to-be; linter (M2) exige rastreabilidade bidirecional |
plan.md / runbook.md |
plan | runbook | duplicados — plano de software referencia runbook operacional quando há handoff |
quickstart.md / script-auditoria.md |
só D1 | só D2 | duplicados, ambos obrigatórios |
review.md / retrospectiva-operacional.md |
só D1 | só D2 | duplicados, ambos obrigatórios |
O eixo primário (declarado na Pergunta 2 do dispatcher) define quem puxa a agenda em conflito: ordem de execução na Fase 7 e dono do [RISCO ASSUMIDO] final na Fase 6.
Detalhe operacional em `domains/hibrido.md`.
6. Fallback "não sei classificar"
Resposta ? ativa BMAD-diagnóstico com 3 perguntas fechadas antes do fluxo começar:
- O que você entrega hoje — ou quer entregar — tem código executando sozinho, pessoas executando passos, ou pessoas aplicando critérios?
- Onde estaria o erro mais caro: bug de código, passo de processo pulado, ou critério mal aplicado?
- O ciclo reinicia quando você ship um release, o processo roda de novo no próximo caso, ou alguém precisa decidir de novo?
Tabela de decisão:
| Resposta 1 | Resposta 2 | Resposta 3 | Domínio |
|---|---|---|---|
| código | bug | release | D1 |
| pessoas (passos) | passo pulado | próximo caso | D2 |
| pessoas (critério) | critério | decisão | D3 |
| código + pessoas | qualquer | qualquer | D (Híbrido) |
| empate | — | — | D (Híbrido) com pedido de declarar eixo primário |
O resultado volta ao §2/§3 com ? resolvido.
7. Fluxo operacional — 15 fases (0 → 12)
Cada fase tem arquivo em `fases/` com entradas, saídas, perguntas-padrão, riscos, gate de avanço, invalidação e sinal de travamento. Sob cada nome: uma linha de "materialização por domínio" apontando para domains/<d>.md.
| # | Fase | Saída padrão | Materialização |
|---|---|---|---|
| 0 | Recepção + módulos | lista de módulos + escolha | D1/D2/D3 |
| 0.5 | BMAD | bmad.md + decision_log.md |
D1/D2/D3 |
| 1 | Briefing | briefing.md (+ extensões D2/D3) |
D1/D2/D3 |
| 2 | Spec / Mapa to-be / Critérios | spec.md (D1) · mapa-to-be.md (D2) · criterios.md + arvore-decisao.md (D3) |
D1/D2/D3 |
| 3 | Clarify | clarify.md com decisões sensíveis assinadas |
D1/D2/D3 |
| 3.5 | Constituição — bicamada | constitution.md com Camada 1 (invariantes) + Camada 2 (escolhas) |
D1/D2/D3 |
| 4 | Plano / Plano-adoção | plan.md (D1) · plano-piloto + adoção (D2) · plano-adocao.md (D3) |
D1/D2/D3 |
| 5 | Tasks | tasks.md (D1) · tarefas operacionais (D2/D3) |
D1/D2/D3 |
| 6 | Analyze (GATE) | analyze.md com matrizes cruzadas |
D1/D2/D3 |
| 7 | Implementação / Piloto | código (D1) · execução piloto (D2) · decisões reais (D3) | D1/D2/D3 |
| 8 | Testes / Validação | suíte verde (D1) · auditoria controlada (D2) · validação por par sênior (D3) | D1/D2/D3 |
| 9 | Quickstart / Runbook | quickstart.md (D1) · runbook.md (D2) · guia-uso.md (D3) |
D1/D2/D3 |
| 10 | Review | review.md aprovada |
D1/D2/D3 |
| 11 | Merge / Go-live / Publicação | master atualizada (D1) · go-live + comunicado (D2) · playbook v1.0 oficial (D3) | D1/D2/D3 |
| 12 | Retrospective | retrospective.md com decisões revisitadas + propostas de ADR |
D1/D2/D3 |
8. Marcadores obrigatórios
Válidos em todos os domínios (ver `filosofia.md §8`):
[INFERÊNCIA]— deduzido plausivelmente.[NEEDS CLARIFICATION: tema]— falta input; bloqueia avanço.[DECISÃO HUMANA: tema]— regra sensível; exige assinatura humana.[RISCO ASSUMIDO]— humano avança conscientemente; revisitado em Fase 12.
9. Regras inegociáveis
Resumo executivo (detalhes em `filosofia.md`):
- Nunca começar pelo código (ou pela execução, ou pela publicação do playbook).
- Toda entrega passa por BMAD antes do briefing.
- Toda spec/mapa-to-be/critérios passa por clarificação.
- Toda implementação/piloto respeita a Constituição (Camada 1 inviolável em ciclo).
- Toda implementação gera ou mantém testes (D1) / auditoria (D2) / validação por par (D3).
- Toda entrega é revisada antes do merge/go-live/publicação.
- Regra sensível nunca é decidida pela IA — ver `filosofia.md §7`.
10. Protocolo de travamento
Quando falta informação materialmente impeditiva, há conflito irreconciliável ou a IA está prestes a decidir regra sensível — trava formalmente. Ver `protocolos/travamento.md`.
Formato resumido:
🛑 Travando — <fase>
📍 Onde travou: ...
🎯 Por que travou: ...
❓ Perguntas objetivas: ...
💡 Opções possíveis: A / B / C
✅ Recomendação: ...
⏳ Aguardando decisão humana.11. Estrutura de saída da skill
A cada turno, a skill responde no padrão:
📥 Ideia reformulada: <frase>
🌐 Domínio: <D1 | D2 | D3 | Híbrido (eixo=<software|processo>)>
📂 Classificação: <greenfield | brownfield | as-is mapeado | novo playbook | ...>
🎯 Módulos detectados: <lista>
⭐ Módulo alvo do ciclo: <qual>
🧭 Fase atual: <0–12>
📄 Artefato em construção: <arquivo>
──────────────────────────────────
<conteúdo da fase>
──────────────────────────────────
✅ Gate de avanço: <critério>
➡️ Próximo passo: <o que acontece quando o gate for cumprido>12. Protocolos transversais (pastas)
- `fases/` — ciclo passo a passo.
- `templates/` — artefatos prontos para preencher (com YAML front-matter).
- `checklists/` — gates de qualidade por fase.
- `protocolos/` — regras transversais (travamento, antialucinação, brownfield, decisão MVP, erros e retry, perguntas-padrão, agentes e automações).
- `domains/` — adaptadores por domínio (software, processo, playbook, híbrido).
- `governanca/` — ADR global, versionamento, métricas.
- `harness/` — rollout do enforcement mecânico (M2 ativa linter + GitHub Action).
13. Fechamento (Manual §31, nos 3 domínios)
Não desenvolver por impulso. Não mudar processo por impulso. Não decidir por impulso.
Desenvolver por protocolo.
A IA não substitui clareza. Ela multiplica clareza.