thiagoloumart

full-way-vibe-coding

Sistema operacional dual-domain (D1 software, D2 processo empresarial,

thiagoloumart 0 Updated 1mo ago

Resources

10
GitHub

Install

npx skillscat add thiagoloumart/full-way-vibe-coding

Install via the SkillsCat registry.

SKILL.md

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:

  1. O que você entrega hoje — ou quer entregar — tem código executando sozinho, pessoas executando passos, ou pessoas aplicando critérios?
  2. Onde estaria o erro mais caro: bug de código, passo de processo pulado, ou critério mal aplicado?
  3. 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.