SKILL.md
Decay Scoring Skill
Sistema de pontuacao temporal automatica para nodes de conhecimento do corpus RAG.
Objetivo
Explicitar obsolescencia, priorizar revisao e preferir conteudo recente ou validado recentemente.
Algoritmo de Decay
decay_score = w_age * age_score + w_val * validation_score + w_access * access_score + w_type * type_bonus
Onde:
- w_age = 0.40 (peso da idade)
- w_val = 0.30 (peso da validacao)
- w_access = 0.20 (peso do acesso)
- w_type = 0.10 (bonus por tipo de conteudo)
Componentes
- Age Score (Decaimento Exponencial):
`` agescore = exp(-lambda * diasdesdecriacao) lambda = ln(2) / halflife_dias ``
- Validation Score:
`` validationscore = exp(-lambdaval * diasdesdevalidacao) lambda_val = ln(2) / 90 # Half-life de 90 dias ``
- Access Score:
`` accessscore = min(1.0, log(1 + acessos30d) / log(10)) * fator_recencia ``
- Type Bonus:
- concepts: 1.0 (mais estavel) - patterns: 0.9 - decisions: 0.7 - learnings: 0.5
Thresholds de Status
| Score | Status | Acao |
|---|---|---|
| 0.70-1.00 | fresh |
Nenhuma acao |
| 0.40-0.69 | aging |
Considerar validacao |
| 0.20-0.39 | stale |
Revisao recomendada |
| 0.00-0.19 | obsolete |
Curadoria necessaria |
Scripts
decay_calculator.py
Calcula scores de decay para todos os nodes do corpus.
# Calcular scores
python3 .claude/skills/decay-scoring/scripts/decay_calculator.py
# Atualizar nodes com scores
python3 .claude/skills/decay-scoring/scripts/decay_calculator.py --update-nodes
# Output JSON
python3 .claude/skills/decay-scoring/scripts/decay_calculator.py --json
decay_tracker.py
Rastreia acessos e validacoes de nodes.
# Registrar acesso
python3 .claude/skills/decay-scoring/scripts/decay_tracker.py access NODE_ID
# Registrar validacao
python3 .claude/skills/decay-scoring/scripts/decay_tracker.py validate NODE_ID
# Ver estatisticas
python3 .claude/skills/decay-scoring/scripts/decay_tracker.py stats
decay_trigger.py
Gera sugestoes de curadoria baseadas nos scores.
# Gerar relatorio
python3 .claude/skills/decay-scoring/scripts/decay_trigger.py
# Filtrar por prioridade
python3 .claude/skills/decay-scoring/scripts/decay_trigger.py --priority critical
Integracao
- ****: Adiciona contexto de decay ao recuperar informacoes
- rag-curator: Usa triggers para sugerir acoes de curadoria
- hybrid_search.py: Aplica boost de decay nos resultados de busca
- gate-evaluator: Valida saude do corpus antes de releases
Configuracao
Ver config/decay_config.yml para ajustar pesos, thresholds e half-lives.