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"
In this repository7 other files it gives its agents.
- .claude/CLAUDE.mdCLAUDE.md
- blueprint-verticalSkill
- cavemanSkill
- fabrica-listasSkill
- headroomSkill
- lean-ctxSkill
- pre-flight-checkSkill
The file
Files
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ção | O que registrar | Onde |
| Bug de compilação resolvido | Causa raiz + fix | RTK SCRATCHPAD (RTK-SCRATCHPAD.md) |
| Padrão arquitetural descoberto | Regra + exemplo | RTK SCRATCHPAD |
| Configuração não óbvia | Chave + valor + por quê | RTK SCRATCHPAD |
| Erro de runtime recorrente | Sintoma + solução | RTK SCRATCHPAD |
| Decisão de design tomada | Opção escolhida + rejeitada + motivo | Notas da sessão |
Nota (21-08-2026): neste projeto, o RTK SCRATCHPAD vive em
RTK-SCRATCHPAD.md(arquivo externo na raiz), NÃO emAGENTS.md/CLAUDE.md. Manter as duas gravando no mesmo arquivo lido automaticamente em toda sessão quebra a estabilidade do prefixo de cache (vermelhorias/21-08-2026-plano-acao-tokens-sob-pericia.md, item D). Se este projeto for usado como base para outro sem esse arquivo, criarRTK-SCRATCHPAD.mdantes de registrar a primeira entrada.
Passo a passo
- Detectar: erros resolvidos, padrões novos, configurações surpresa.
- Avaliar: é duradouro? Vai aparecer de novo? Outro agente precisaria saber?
- Registrar: adicionar (append) ao
RTK-SCRATCHPAD.md. - Formatar: usar o template abaixo.
- 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 futuroCategorias válidas
TIPO: erros de tipo TypeScriptBUILD: erros de build/bundlingRUNTIME: erros de execuçãoCONFIG: configurações não óbviasPADRAO: padrões arquiteturaisRLS: erros de Row Level SecurityMULTI-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 mutationsNUNCA 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.
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
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.

