agentleFS
adeiltonpessiniadeiltonpessini/kit-memoria-ia/.claude/skills/licao-aprendida/SKILL.md

licao-aprendida

Skill0 starsChanged 6 days agoApache-2.0View on GitHub

Use quando um gotcha, bug de causa não óbvia ou passo caro for descoberto ("isso de novo", "não repetir", "anota a lição", retro do handoff): verifica a causa contra o código, escreve a lição em docs/knowledge/licoes/ e leva a regra para onde o próximo agente lê (playbook, skill, teste ou script).

The file

Files
SKILL.md

licao-aprendida: gotcha vira regra onde ela protege

Lição que só existe no arquivo morto não protege ninguém. O próximo agente lê o playbook da área dele, a skill que carregou e o teste que quebrou, não o acervo inteiro. Por isso a lição tem duas metades: o registro (docs/knowledge/licoes/) e a regra no lugar certo.

Quando

  • Bug cuja causa não era óbvia, ou que já aconteceu antes.
  • Passo que custou caro (tempo, contexto, cota, deploy desfeito) e tem jeito barato de evitar.
  • Item "Mudar" da retro do handoff que ainda não virou nada.
  • Não é para fato de estado do projeto (isso é handoff) nem para decisão de produto (isso é remember, tipo decisão).

Passo a passo

  1. Reproduza ou prove a causa hoje. Memória é pista: rode o comando, ache o caminho:linha. Sem prova, a lição fica como suspeita no handoff, não vira regra.
  2. Procure se já existe: rg -il "<termo>" docs/knowledge docs/agentes .claude/skills e node "$HOME/.kit-memoria-ia/kit.mjs" buscar "<termo>". Existe? Atualize verificada-em e a regra; não crie outra.
  3. Escreva: node "$HOME/.kit-memoria-ia/kit.mjs" lembrar "<regra curta>" --type licao. Preencha sintoma, causa verificada, regra no imperativo, como detectar e onde a regra mora.
  4. Leve a regra para onde ela age (escolha o mais forte que couber):
    ForçaOndeQuando
    1teste, gate ou guarda em scriptdá para detectar por máquina
    2"Armadilhas" do playbook do agente da área, se o projeto tiver umvale para uma área
    3AGENTS.md do projetovale para todo agente (raro: pesa em toda sessão)
    4skill relacionada (seção Gotchas)vale para um procedimento
    Uma linha, com link para a lição: - <regra> ([[licoes/<slug>]]).
  5. Commit junto: lição + regra no mesmo commit, docs(licao): <regra>.

Regras

  • Uma lição, uma regra. Título é a regra, não o sintoma ("cliente perde a assinatura ao reconectar sem sessão", não "fila bugada").
  • Sem nada de outro projeto: lição de outro repo não se copia; se o mecanismo é genérico, reescreva com o caso daqui.
  • Data absoluta e local. Lição contraditada pelo código atual é apagada ou corrigida, nunca deixada brigando.
  • Nunca segredo, IP de cliente ou token no exemplo.
  • Não é hook, não bloqueia nada: é hábito da revisão e da retro.

Faxina

Na consolidação (docs/knowledge/CONSOLIDATION.md), cada lição com verificada-em velho tem o "Como detectar" rodado de novo. Não detecta mais e o código mudou: atualize ou apague.

Relacionado: remember (decisão e handoff) · skill-smith (quando a lição vira procedimento novo).

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.