Distill de Regras

Escaneia habilidades instaladas, extrai princípios transversais que aparecem em múltiplas habilidades e os destila em regras — anexando a arquivos de regras existentes, revisando conteúdo desatualizado ou criando novos arquivos de regras.

Aplica o princípio de "coleta determinística + julgamento LLM": scripts coletam fatos exaustivamente, então um LLM releia o contexto completo e produz vereditos.

Quando Usar

• Manutenção periódica de regras (mensal ou após instalar novas habilidades)
• Após um inventário de habilidades revelar padrões que deveriam ser regras
• Quando as regras parecem incompletas em relação às habilidades que estão sendo usadas

Como Funciona

O processo de destilação de regras segue três fases:

Fase 1: Inventário (Coleta Determinística)

1a. Coletar inventário de habilidades

bash ~/.claude/skills/rules-distill/scripts/scan-skills.sh

1b. Coletar índice de regras

bash ~/.claude/skills/rules-distill/scripts/scan-rules.sh

1c. Apresentar ao usuário

Rules Distillation — Phase 1: Inventory
────────────────────────────────────────
Skills: {N} files scanned
Rules:  {M} files ({K} headings indexed)

Proceeding to cross-read analysis...

Fase 2: Releitura, Correspondência e Veredito (Julgamento LLM)

Extração e correspondência são unificadas em uma única passagem. Arquivos de regras são pequenos o suficiente (~800 linhas no total) para que o texto completo possa ser fornecido ao LLM — sem necessidade de pré-filtragem com grep.

Agrupamento em Lotes

Agrupe habilidades em agrupamentos temáticos com base em suas descrições. Analise cada agrupamento em um subagente com o texto completo das regras.

Mesclagem entre Lotes

Após a conclusão de todos os lotes, mescle candidatos entre os lotes:

• Deduplique candidatos com princípios iguais ou sobrepostos
• Reconfirme o requisito de "2+ habilidades" usando evidências de todos os lotes combinados — um princípio encontrado em 1 habilidade por lote, mas 2+ habilidades no total é válido

Prompt do Subagente

Inicie um Agente de propósito geral com o seguinte prompt:

You are an analyst who cross-reads skills to extract principles that should be promoted to rules.

## Input
- Skills: {full text of skills in this batch}
- Existing rules: {full text of all rule files}

## Extraction Criteria

Include a candidate ONLY if ALL of these are true:

1. **Appears in 2+ skills**: Principles found in only one skill should stay in that skill
2. **Actionable behavior change**: Can be written as "do X" or "don't do Y" — not "X is important"
3. **Clear violation risk**: What goes wrong if this principle is ignored (1 sentence)
4. **Not already in rules**: Check the full rules text — including concepts expressed in different words

## Matching & Verdict

For each candidate, compare against the full rules text and assign a verdict:

- **Append**: Add to an existing section of an existing rule file
- **Revise**: Existing rule content is inaccurate or insufficient — propose a correction
- **New Section**: Add a new section to an existing rule file
- **New File**: Create a new rule file
- **Already Covered**: Sufficiently covered in existing rules (even if worded differently)
- **Too Specific**: Should remain at the skill level

## Output Format (per candidate)

```json
{
  "principle": "1-2 frases em forma de 'faça X' / 'não faça Y'",
  "evidence": ["nome-da-habilidade: §Seção", "nome-da-habilidade: §Seção"],
  "violation_risk": "1 frase",
  "verdict": "Anexar / Revisar / Nova Seção / Novo Arquivo / Já Coberto / Muito Específico",
  "target_rule": "nome-do-arquivo §Seção, ou 'novo'",
  "confidence": "alto / médio / baixo",
  "draft": "Texto rascunhado para vereditos de Anexar/Nova Seção/Novo Arquivo",
  "revision": {
    "reason": "Por que o conteúdo existente está incorreto ou insuficiente (Apenas Revisar)",
    "before": "Texto atual a ser substituído (Apenas Revisar)",
    "after": "Texto de substituição proposto (Apenas Revisar)"
  }
}
```

## Exclude

- Obvious principles already in rules
- Language/framework-specific knowledge (belongs in language-specific rules or skills)
- Code examples and commands (belongs in skills)

Referência de Veredito

…