⬆️ Promotion: 3-strikes → CLAUDE.md

Padrao visto 3 ou mais vezes prova valor. Viram regra em CLAUDE.md, originais arquivam.

Observacao #1 → knowledge/patterns/idempotency-stripe.md
Observacao #2 → knowledge/patterns/idempotency-retry.md
Observacao #3 → knowledge/patterns/idempotency-refund.md
                           │
                           ▼
              Script detecta similaridade
                           │
                           ▼
          promotions/pending.md criada
                           │
                           ▼
              Voce revisa e aprova
                           │
                           ▼
       CLAUDE.md: "Sempre usar idempotency
                    key em payment webhook."
                           │
                           ▼
      3 observacoes movem para archive/promoted/

Regex nao pega similaridade semantica. LLM pequeno resolve em segundos.

#!/usr/bin/env python3
# promote.py — versao LLM-assisted

def find_clusters(memories, threshold=3):
    # 1. Gera embedding de cada memoria
    embs = embed_all([m.body for m in memories])

    # 2. Clustering com similarity > 0.85
    clusters = []
    for i, emb_i in enumerate(embs):
        for cluster in clusters:
            if cosine(emb_i, cluster[0].emb) > 0.85:
                cluster.append(memories[i])
                break
        else:
            clusters.append([memories[i]])

    # 3. Retornar clusters com threshold+
    return [c for c in clusters if len(c) >= threshold]

# Uso
candidates = find_clusters(load_memories('knowledge/patterns/'))
for cluster in candidates:
    write_proposal(cluster, 'promotions/pending.md')

Formato prescritivo vence descritivo. Claude age sobre um, menciona o outro.

NUNCA promova automatico direto ao CLAUDE.md. Sempre com review.

# Script cria proposta
$ python3 promote.py
3 padroes candidatos criados em:
  ~/.memory/promotions/pending.md

# Voce revisa
$ cat ~/.memory/promotions/pending.md

## Proposta 1 (3 ocorrencias)
Origem: patterns/idempotency-{stripe,retry,refund}.md

Regra sugerida:
"Sempre usar idempotency key em payment webhook
 para evitar processamento duplicado."

[APROVAR] [REJEITAR] [EDITAR]

# Apos editar/aprovar
$ python3 promote.py --apply

Aprovou: 2 regras adicionadas a CLAUDE.md
Rejeitou: 1 proposta descartada
Movidas: 6 memorias originais para archive/promoted/

Arquivam, nao deletam. Rastreio preservado para revisao futura.

archive/promoted/
└── 2026-Q2/
    └── idempotency-webhook-rule/
        ├── SOURCE_MEMORIES/
        │   ├── idempotency-stripe.md
        │   ├── idempotency-retry.md
        │   └── idempotency-refund.md
        └── PROMOTED_RULE.md
            "Extraida em 2026-04-22. Adicionada a CLAUDE.md.
             Regra: 'Sempre usar idempotency key em payment webhook.'"

# Se 6 meses depois voce revisita regra:
# → acha rastreamento
# → ve as 3 observacoes originais
# → entende o porque completo

Seguindo o ciclo inteiro: 3 observacoes → regra permanente.