agentleFS
Totes-MickGOATsTotes-MickGOATs/opus-pocus/skills/the-pensieve/SKILL.md

the-pensieve

Skill9 starsChanged 3 months agoMITView on GitHub

Instrument the repo for a measurement week after instruction-layer changes — count what actually happens (advisory re-fires, review-loop rounds, subagent bounces, tokens injected per prompt, session outcomes) so the next round of changes is decided by numbers, not vibes. Use after landing /opus-pocus fixes, before/after any Avada Verbosa ablation round, or for "did those CLAUDE.md changes help", "measure Claude's behavior in this repo", "set up instruction telemetry". Produces the counter list, where each number comes from, and the week-end readout format. NOT for application performance metrics — instruction-layer behavior only.

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 3 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Every other spell changes the instruction layer.

    line 10
  2. Distinctive:

    Add repo-specific counters for whatever the audit flagged worst — measure where the disease was.

    line 29
  3. Very specific:

    Read the Needs column before promising anything.

    line 31
  4. Distinctive:

    One week of normal work: Not a demo session; the numbers must come from real tasks.

    line 50

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

🔮 The Pensieve

"A week of numbers in the basin. Vibes are not telemetry."

Every other spell changes the instruction layer. This one finds out whether the changes worked. The alternative — another audit — just re-applies the same judgment that wrote the instructions; only behavior counts.

The counters

Instrument what the spells claim to improve. Core set:

CounterNeedsWhat it validatesSource
Stop/advisory re-fires per session — same advisory, unchanged statehooks + transcriptsFinite Recursum's fingerprint fixesHook logs, or grep transcripts for the advisory headers
Review-loop rounds per task — review→fix→re-review depthtranscriptsLoop caps workingTranscripts / task logs
Subagent bounces per branch — how often incomplete work goes backagentsDefinition-of-done clarityDispatch logs, PR/branch history
Tokens injected per prompt by hookshooksMuffliato HookusInstrument emitters to log output bytes; or measure injected blocks in transcripts
Wrong-agent routings — dispatched then redirectedagents + transcriptsDescriptio ReducioTranscripts: dispatches followed by a different agent doing the work
Rule citations of stale facts — model quotes something no longer truenoneObliviate FossiliumReview of session outputs; user corrections
User corrections per session — times the human had to redirecttranscriptsEverythingTranscripts: user messages contradicting the previous assistant turn
Session outcome — task done / partial / abandonednoneThe bottom lineEnd-of-session state

Add repo-specific counters for whatever the audit flagged worst — measure where the disease was.

Read the Needs column before promising anything. A repo with no hooks cannot measure advisory re-fires or injected tokens; a repo with no subagents cannot measure bounces or wrong routings. Five of these eight have a prerequisite most small repos do not meet.

Method

  1. Cheap instrumentation only, and confirm the source exists before you promise the counter. A log line in an existing hook, or a grep over transcripts the harness already writes. On Claude Code those are JSONL under ~/.claude/projects/<url-encoded-cwd>/*.jsonl — the path is undocumented and version-specific, so check it (ls ~/.claude/projects/*/ | head) before committing to any transcript-backed counter. A counter whose source you never confirmed is exactly the unexercised check this book grades elsewhere. If it is not there, drop the counter and name which ones you dropped.
  2. Drop every counter whose subject is zero. A week of three real numbers beats a table of eight where five sit permanently at 0 and read as improvement. If a counter needs new infrastructure, drop it too.
  3. Baseline first when possible. Counters before the fixes land make the delta real. When fixes already landed, the week still gives an absolute floor for the NEXT round.
  4. One week of normal work. Not a demo session; the numbers must come from real tasks. Note confounds (an unusual crunch, a new team member, a model version change mid-week).
  5. No steering to the numbers. Nobody works differently because the counters run — the point is observing the default.

Bounds

  • Scope: instrumentation design and readout. This pass changes no instruction text and proposes no fixes.
  • Cap: about 8 counters, and fewer is better. Drop any counter needing new infrastructure, and any whose subject count is zero in this repo — three real numbers beat eight where five are structurally stuck at 0.
  • Done when the counter list, its sources, and the readout format are written. The numbers arrive a week later.
  • Quote once, at read time; mark anything you cannot re-confirm UNVERIFIED rather than re-reading to check yourself.
  • See skills/opus-pocus/references/casting-safety.md for the full rules.

The readout

At week's end, one table: counter · baseline (if any) · this week · verdict (improved / unchanged / worse / can't-tell). Then the decision each number drives:

  • Improved → the fix stands; note it as measured in the repo's decision records.
  • Unchanged → the instruction text wasn't the bottleneck; candidate for Avada Verbosa.
  • Worse → bisect the landed fixes (they're in themed commits — Avada Verbosa's rule).
  • Can't-tell → the counter was bad, not the fix; redesign the counter before re-running.

The readout — not another audit — decides whether to run the next ritual, and which spells it needs. That closes the loop: audit → fix → measure → audit only what measurement indicts.

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.