lessons-learned SKILL.md skillA

lessons-learned from ljferrer/workauditrefine is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add ljferrer/workauditrefine/lessons-learned@git:20261030.b0f6bab

Pins git:20261030.b0f6bab in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
ljferrer/workauditrefine
Path
skills/lessons-learned/SKILL.md
Versions recorded
5
Latest version
git:20261030.b0f6bab, committed Oct 30, 2026
First version recorded
Aug 30, 2026
Size
32,128 bytes
Repository stars
11
License
MIT

Audit and tidy this project's Claude memory store (the MEMORY.md index plus its [[wikilinked]] topic files) — fan out agents to verify every memory against the live repo, classify stale vs durable, then compress / re-anchor / retire and rewrite the index, fault-tolerantly (backup → stage → verify → atomic swap). Always a full pass over the local repo's memory. Use when the user runs /lessons-learned, wants a memory housekeeping or "lessons learned" round, asks whether MEMORY.md is too large /…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# /lessons-learned — fault-tolerant memory housekeeping

You run a **full pass** over this project's Claude memory store: verify every memory against the **live repo**, decide what is stale vs. still relevant, then **compress / re-anchor / retire / merge** the topic files and rewrite the `MEMORY.md` index. The pass is **fault-tolerant to interruption** (laptop closing mid-run) and **reports at every phase**.

## `migrate` mode — one-time two-root adoption

If the arguments contain the word **`migrate`** (`/lessons-learned migrate`), do **not** run the housekeeping phases below.

When the arguments contain `migrate`, read [`references/migration.md`](references/migration.md) — its **pre-flight opt-in gate** (resolving `memory.commitLearnings`; a decline aborts with nothing staged or moved) runs before the playbook: `migrate` dry-run → agent-assisted retype of the `untyped` bucket → `migrate --apply` (archives `[RESOLVED]` lessons) → keywords backfill → move the operator-confirmed `project`-typed set into `docs/learnings/` and open the reviewed learnings PR (gate 2 by hand, `lint` fail-closed). Three warnings the playbook expands on:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add ljferrer/workauditrefine/lessons-learned@sha256:66bfb07b8da8ab06

The line at the top of this page pins the label git:20261030.b0f6bab, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_rooebeyqwpanhej6.svg)](https://markdownregistry.com/a/art_rooebeyqwpanhej6)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 30, 2026 and Oct 30, 2026, about one every 15 days.

versioncommittedcommitsizeaudit
git:20261030.b0f6bab latest2026-10-30 b0f6bab 32,128 BA view · diff
git:20261030.444196a2026-10-30 444196a 32,128 BA view · diff
git:20261030.e0512aa2026-10-30 e0512aa 32,052 BA view · diff
git:20261030.6d3bb732026-10-30 6d3bb73 31,460 BA view · diff
git:20260830.769f6512026-08-30 769f651 31,384 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (32128 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

ljferrer/workauditrefine · 11 stars · license MIT · pushed 2026-11-04 · branch master

API

GET https://markdownregistry.com/api/v1/artifacts/art_rooebeyqwpanhej6
GET https://markdownregistry.com/api/v1/resolve?ref=ljferrer/workauditrefine/lessons-learned
GET https://markdownregistry.com/api/v1/blob/66bfb07b8da8ab06c66ffd042fc8ec38711c53795de010da0cd00d0e43632129

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from ljferrer/workauditrefine

CLAUDE.md CLAUDE.md file
ljferrer/workauditrefine · CLAUDE.md
git:20261031.5d21f2a · audit A · 11 stars
aftermath SKILL.md skill
ljferrer/workauditrefine · skills/aftermath/SKILL.md · Evidence-gated cleanup after WAR work lands — delete stray WAR branches, reap orphaned run worktrees, close done…
git:20260806.b607909 · audit A · 11 stars
red-team SKILL.md skill
ljferrer/workauditrefine · skills/red-team/SKILL.md · Adversarially verify a proposed plan before you execute it. Reads the plan, derives a hybrid attack strategy (a…
git:20261030.8fef1e1 · audit A · 11 stars
snipe SKILL.md skill
ljferrer/workauditrefine · skills/snipe/SKILL.md · Launch a quick one-shot audit — 1-5 read-only WAR auditor seats against the current changes, verdicts reported in chat…
git:20261031.145ae52 · audit A · 11 stars
survey-corps SKILL.md skill
ljferrer/workauditrefine · skills/survey-corps/SKILL.md · Survey this repo's memory lessons and open GitHub issues into war-shaped design specs — first mine qualifying hot…
git:20261030.b0f6bab · audit A · 11 stars
war-campaign SKILL.md skill
ljferrer/workauditrefine · skills/war-campaign/SKILL.md · Run a queue of WAR plans unattended — the hopper. Seeds a campaign ledger from an explicit plan list or a roadmap file…
git:20260904.5cc2f00 · audit A · 11 stars
war-help SKILL.md skill
ljferrer/workauditrefine · skills/war-help/SKILL.md · Print the WAR orientation card — what WAR is, the command set (/war-strategy → /war-room → /red-team → /war →…
git:20261031.5d21f2a · audit A · 11 stars
war-machine SKILL.md skill
ljferrer/workauditrefine · skills/war-machine/SKILL.md · Convert design specs into merged implementation plans plus a campaign roadmap — the middle step of the WAR pipeline…
git:20261030.0645294 · audit A · 11 stars
war-review SKILL.md skill
ljferrer/workauditrefine · skills/war-review/SKILL.md · Post-run telemetry and friction review for a completed /war run — reads the newest (or --run-pinned) run manifest under…
git:20261029.79dc6a0 · audit A · 11 stars
war-room SKILL.md skill
ljferrer/workauditrefine · skills/war-room/SKILL.md · Interview the user to produce a WAR run configuration at .claude/war/config.json — per-role model and reasoning effort…
git:20261104.8e648bd · audit A · 11 stars
war-strategy SKILL.md skill
ljferrer/workauditrefine · skills/war-strategy/SKILL.md · Two modes. Bare invoke runs the WAR plan-authoring interview itself, per the in-repo doctrine…
git:20261030.8fef1e1 · audit A · 11 stars
war SKILL.md skill
ljferrer/workauditrefine · skills/war/SKILL.md · Execute a detailed multi-phase implementation plan with a team of agents — Work, Audit, Refine, then capture learnings…
git:20261104.8e648bd · audit A · 11 stars

Every file in ljferrer/workauditrefine

Browse by kind, by grade A, or by owner.