agentleFS
Heverton-webHeverton-web/fabrica-universal/.claude/skills/rtk-memory/SKILL.md

rtk-memory

Skill0 starsChanged 3 months agoMITView on GitHub

Gerencia aprendizado persistente para evitar repetição de análise. Registra erros resolvidos, decisões arquiteturais e padrões descobertos em memória de longo prazo. Triggers: "rtk-memory", "registrar erro", "salvar aprendizado", "anotar padrão", "rtk scratchpad", "memória persistente", "não esquecer"

The file

Files
SKILL.md

RTK Memory

Protocolo de registro de aprendizado persistente. Objetivo: nunca re-analisar o mesmo erro ou re-descobrir o mesmo padrão.

Quando registrar

SituaçãoO que registrarOnde
Bug de compilação resolvidoCausa raiz + fixRTK SCRATCHPAD (RTK-SCRATCHPAD.md)
Padrão arquitetural descobertoRegra + exemploRTK SCRATCHPAD
Configuração não óbviaChave + valor + por quêRTK SCRATCHPAD
Erro de runtime recorrenteSintoma + soluçãoRTK SCRATCHPAD
Decisão de design tomadaOpção escolhida + rejeitada + motivoNotas da sessão

Nota (21-08-2026): neste projeto, o RTK SCRATCHPAD vive em RTK-SCRATCHPAD.md (arquivo externo na raiz), NÃO em AGENTS.md/CLAUDE.md. Manter as duas gravando no mesmo arquivo lido automaticamente em toda sessão quebra a estabilidade do prefixo de cache (ver melhorias/21-08-2026-plano-acao-tokens-sob-pericia.md, item D). Se este projeto for usado como base para outro sem esse arquivo, criar RTK-SCRATCHPAD.md antes de registrar a primeira entrada.

Passo a passo

  1. Detectar: erros resolvidos, padrões novos, configurações surpresa.
  2. Avaliar: é duradouro? Vai aparecer de novo? Outro agente precisaria saber?
  3. Registrar: adicionar (append) ao RTK-SCRATCHPAD.md.
  4. Formatar: usar o template abaixo.
  5. Verificar: não duplicar entradas existentes.

Formato de registro

### [DATA] Categoria: Título curto
- **Causa**: o que causava o problema
- **Fix**: como foi resolvido
- **Arquivo**: path/para/arquivo.ts:linha
- **Prevenção**: como evitar no futuro

Categorias válidas

  • TIPO: erros de tipo TypeScript
  • BUILD: erros de build/bundling
  • RUNTIME: erros de execução
  • CONFIG: configurações não óbvias
  • PADRAO: padrões arquiteturais
  • RLS: erros de Row Level Security
  • MULTI-TENANT: problemas de empresa_id

Local de escrita

Sempre adicionar (append no final) do RTK-SCRATCHPAD.md na raiz do projeto — nunca em AGENTS.md/CLAUDE.md (ver nota acima).

## RTK SCRATCHPAD

### [2025-01-15] TIPO: UUID vs string
- **Causa**: Supabase retorna UUID como string, mas tipos esperam UUID
- **Fix**: usar `as UUID` ou validar com regex
- **Arquivo**: service.ts:24
- **Prevenção**: sempre tipar empresa_id como UUID nos types

### [2025-01-15] RLS: empresa_id obrigatório
- **Causa**: INSERT sem empresa_id é bloqueado pelo RLS
- **Fix**: sempre incluir empresa_id do useAuth()
- **Arquivo**: todos os service.ts
- **Prevenção**: hook useAuth() sempre chamado antes de mutations

NUNCA fazer

  • NUNCA registrar erros temporários (typos, erros de digitação).
  • NUNCA registrar informações que já estão no código (não documentar o óbvio).
  • NUNCA alterar registros existentes — apenas adicionar novos.
  • NUNCA registrar senhas, tokens ou credenciais.
  • NUNCA registrar decisões que são óbvias pelo contexto.
  • NUNCA duplicar entrada se similar já existe — atualizar a existente.
  • NUNCA usar RTK Memory como substituto para código bem tipado.

Interação com outras skills

  • pre-flight-check: erros novos do pre-flight devem ser registrados.
  • caveman: registrado em formato comprimido.
  • lean-ctx: padrões descobertos via lean-ctx são registrados.
  • headroom: erros extraídos via headroom são registrados se novos.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.