agentleFS
otavioserraotavioserra/conn2flow-ai-workspace/.claude/skills/mdd-memory-gardening/SKILL.md

mdd-memory-gardening

Skill4 starsChanged 34 days agoMITView on GitHub

LEIA SOMENTE quando a memória de execução atingir o alerta de 50 KB / 200 linhas ou o teto de 75 KB / 300 linhas. É proibido podar arquivos saudáveis ou acionar esta skill apenas pelo fim da sessão.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

Memory Gardening MDD (compatível com satélites MDD)

🚫 PROIBIDO PODAR se a memória de execução estiver abaixo de 50 KB e 200 linhas. Ignorar a skill no final da sessão caso o arquivo esteja saudável.

⚡ Gatilho Obrigatório

  • TRIGGER: Quando memory/04-memory-engineering-execution.md atingir 50 KB ou 200 linhas (alerta preventivo). A poda torna-se obrigatória ao atingir 75 KB ou 300 linhas.
  • SKIP APENAS SE: O arquivo estiver abaixo de 50 KB e 200 linhas. Encerramento de sessão ou conclusão de batch, isoladamente, nunca acionam esta skill.
  • CONSEQUÊNCIA DE IGNORAR: Degradação cognitiva do agente por excesso de contexto (prompt bloat), aumento de custos de inferência e esquecimento de diretrizes críticas.

📦 Regra dos 10 Ativos na Raiz MDD

Além da memória de execução, a raiz das pastas de controle tem janela fixa de 10 arquivos ativos:

  • memory/human-requests/: no máximo 10 requisições soltas, além de CURRENT.md e README.md. As demais vão para memory/human-requests/archive/.
  • memory/implementation/: no máximo 10 relatórios de lote soltos, além de BATCH-INDEX.md. Os demais vão para memory/implementation/archive/.
  • DECISION-LOG.md, BATCH-INDEX.md e VALIDATION-CHECKLIST.md seguem com no máximo 10 itens correntes, com o histórico resumido em tabela apontando para archive/.

Nunca mova arquivos manualmente: ao arquivar, todo link de markdown que apontava para o caminho antigo em BATCH-INDEX.md, VALIDATION-CHECKLIST.md, DECISION-LOG.md e CURRENT.md precisa ser reescrito. Use o cliente MDD para manutenção autorizada:

mdd compact --path RAIZ_ABSOLUTA          # auditoria, sem escrita
mdd compact --path RAIZ_ABSOLUTA --apply  # somente manutenção autorizada

Use o suporte MDD real do cliente; não invente ai:archive-mdd nem passe memory ao arquivador legado. Preserve original integral e síntese rastreável em memory/raw/archive/original/ e memory/raw/archive/compacted/ antes de podar memory/04-memory-engineering-execution.md. Atualize índices via mdd index e valide links.


🧠 Poda da Memória de Execução

  1. Meça bytes e linhas e leia a memória de execução completa (ou rode c2f ai:prune-memories).
  2. Se o arquivo estiver abaixo de 50 KB e 200 linhas, pare e registre que a memória está saudável; não reescreva o conteúdo.
  3. Entre 50 KB / 200 linhas e 75 KB / 300 linhas, emita alerta preventivo e planeje a manutenção sem poda automática.
  4. Ao atingir 75 KB ou 300 linhas, execute a poda obrigatória.
  5. Preserve as 20 a 25 tarefas, aprendizados e pendências mais recentes.
  6. Destile regras recorrentes para skills Core ou específicas do projeto.
  7. Nunca altere a memória de Chefia sem instrução humana explícita.
  8. Reescreva a memória visando cerca de 25 KB.
  9. Valide frontmatter, descoberta das skills e o diff Git recuperável.
  10. Registre tamanhos e evidências no checklist do batch.

MDD: faxina segura de worktrees em seis passos

Esta seção é manutenção de worktrees, independente do gatilho de poda de memória. A skill se chama mdd-memory-gardening; memory/ é a raiz da matriz e dos satélites migrados. Não pode memória saudável para fechar lote.

  1. Inventarie com git worktree list --porcelain; confirme raízes absolutas, autores/datas, origens em environment.json e no pipeline. Exclua árvore principal e qualquer worktree usada como origem de projeto.
  2. Atualize refs com git fetch e confira commits fora de origin/main (git log origin/main..HEAD na worktree), alterações staged/unstaged com git diff --ignore-cr-at-eol e git diff --cached --ignore-cr-at-eol, além de git ls-files --others --exclude-standard. Os três requisitos são cumulativos: zero commits exclusivos, zero alteração real e zero arquivo não rastreado. Não use --force para contornar mudanças; liste trabalho pendente ao humano.
  3. No Windows, valide o alvo e inventarie junctions (cmd /c "dir /AL <pasta>") e referências recebidas de outras worktrees. Reaponte dependências antes da remoção; desfaça somente cada junction com cmd /c "rmdir <pasta><atalho>" sem /S, seguindo Armadilha 18. Não componha operações de exclusão entre shells.
  4. Confirme ausência dos links e execute git worktree remove no caminho literal autorizado. Se Git recusar por sujeira, preserve a árvore e reporte; não use --force, clean, reset nem exclusão recursiva manual.
  5. Confira vendor/node_modules das árvores principais e demais worktrees; só então apague branch local integrada com git branch -d (nunca -D) e rode git worktree prune.
  6. Registre árvores removidas/preservadas, motivos e integridade dos destinos. Atualize árvore principal com git merge --ff-only origin/main apenas se estiver limpa e a atualização estiver autorizada; divergência exige avaliação, nunca mescla automática de trabalho alheio.

Na governança MDD, aplique o teto ativo de 50 KB da memory/02-policy.md antes de ampliar documento; preserve original e síntese. Não execute o arquivador legado na matriz migrada presumindo compatibilidade. mdd compact particiona documentos grandes e gera extratos estruturais; não substitui a síntese semântica autorizada da memória de execução.

REQ-071: canonical engineering memories

MDD repositories use memory/03-memory-engineering-chief.md and memory/04-memory-engineering-execution.md. A preventive 50 KiB ceiling triggers maintenance planning; 75 KiB is a critical alert. Archive pruned execution history under memory/raw/archive/original/ and memory/raw/archive/compacted/, preserving full originals and traceable summaries before reducing the active file to about 25 KiB and 20–25 recent records. Keep unresolved items, update index.md and repair links. Use memory/raw/active/ for temporary shareable observations. Do not prune as part of a filename migration. Legacy boilerplates require an explicit migration before applying this MDD workflow.

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.