MÓDULO 3.4

📁 Modularização com references/

Quando dividir em arquivos separados. Por que variants, frameworks, anti-patterns e examples são arquivos distintos.

6
Tópicos
25
Minutos
Avanç.
Nível
Técnico
Tipo
1

⚖️ Quando dividir — os 3 critérios

Um arquivo vai para references/ quando cumpre os 3 critérios simultaneamente:

⚙️

Opcional

Nem toda sessão precisa. Se sempre usa, vai pro SKILL.md.

📏

Longo

Tabela extensa, catálogo, lista. Se for curto, fica inline.

🎯

Coeso

Um tema só. Se são dois temas, dividir em dois arquivos.

2

📝 variants.md

Catálogo das 7 variantes de ordem. Atende os 3 critérios: opcional (só a Fase 0 consulta), longo (7 × 6 linhas), coeso (um tema: ordenação).

# Variantes de ordem dos chapéus

## 1. Análise geral (padrão)
**Ordem:** Azul → Branco → Amarelo → Preto → Verde → Vermelho → Azul
**Lógica:** fatos primeiro, depois positivo, negativo...

## 2. Funcionalidade de produto
...
## 7. Análise rápida (condensada)
...
3

🎨 divergence-frameworks.md

Os 10 marcos (A-J) em detalhe. Só consultado quando o Chapéu Verde é ativado.

💡 Economia de contexto

Carregar os 10 marcos em toda sessão seria caro. Em pré-mortem, não precisa. Em sessão padrão, só o Verde usa. Sob demanda é 3-5× mais econômico.

4

🚨 anti-patterns.md

Catálogo de erros comuns. Usado na auto-revisão antes de entregar. "Ver anti-patterns.md" = "faça o checklist de qualidade".

# Anti-padrões

## Contaminação cruzada
**Sintoma:** "...mas por outro lado poderia..." dentro do Preto.
**Correção:** eliminar a frase contaminada. Cada chapéu é monolítico.

## Preto diluído por gentileza
**Sintoma:** "poderia talvez...", "há risco de mudanças".
**Correção:** trocar "poderia" por "vai". Se sobrevive, é risco real.
...
5

📚 examples.md

2-3 sessões completas ilustrativas. Só consultado quando o modelo precisa calibrar formato de saída.

💡 Few-shot por demanda

Modelos aprendem formato por imitação. Exemplos pesam muito para calibrar a forma, mas carregar todo turno é caro. Sob demanda é ideal.

6

🏷️ Padrões de nomenclatura

✓ Bons nomes

  • variants.md
  • anti-patterns.md
  • divergence-frameworks.md
  • examples.md

✗ Nomes ruins

  • DivergenceFrameworks.md (camelCase)
  • anti_patterns.md (underscore)
  • stuff.md (genérico)
  • mais-coisas-da-skill.md (verboso)

📝 Resumo do Módulo

✓
3 critérios para dividir - opcional + longo + coeso (todos).
✓
variants.md - catálogo das 7 ordens.
✓
divergence-frameworks.md - os 10 marcos detalhados.
✓
anti-patterns.md - checklist de auto-revisão.
✓
examples.md - sessões completas para calibrar formato.

Próximo Módulo:

3.5 - Isolamento como engenharia de prompt

← Módulo Anterior Próximo Módulo →