Menu
Institutional memory for your project. Commands: record, consult, review. Usage: /awareness-ledger [command] [args]
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Evaluate code to prevent common AI coding mistakes โ dead code, duplication, complexity hotspots, reinvented helpers, leftover scaffolding. Two functions plus a pre-write advisor. Use after writing or editing code, when asked to review code quality, clean up the codebase, find unused code, find duplicates, check complexity, or evaluate what an AI just wrote. Commands: review (post-write), sweep (full codebase).
Skill router. Pass a task description; route consults the index and dispatches to the right skill+function via the Skill tool. Usage: /route <task description>
Create, audit, optimize Claude Code skills. Commands: skills, list, new, strip, optimize, agents, hooks, verify, inline, ledger, cascade, checksums, convert, shell-safety, route, backup, restore
Evaluate text for AI-generated signatures (AI tells) โ em-dash overuse, rhetorical colons, pipeline artifacts, hedging cadence, sycophancy leakage โ before it ships. Use when reviewing, scrubbing, or finishing written/communication output. Commands: scan (mechanical), evaluate (judgment-class), scrub (bounded fix loop).
| name | awareness-ledger |
| description | Institutional memory for your project. Commands: record, consult, review. Usage: /awareness-ledger [command] [args] |
| allowed-tools | Read, Glob, Grep, Write, Edit, Task, TaskCreate, TaskUpdate, TaskList, TaskGet |
Institutional memory for this project โ captures incidents (INC), decisions (DEC), patterns (PAT), and flows (FLW) so diagnostic findings and architectural decisions survive across sessions and teammates.
| Command | Action |
|---|---|
/awareness-ledger record [type] | Record a new INC / DEC / PAT / FLW entry |
/awareness-ledger consult [topic] | Consult the ledger before a plan/change (agent-assisted) |
/awareness-ledger review | Health check: stale entries, missing links, statistics |
During research and planning โ before formulating any plan, recommendation, or code change proposal โ automatically consult the ledger:
ledger/index.md and match tags against the files,
directories, and components under discussion. This is free โ the index is small.references/consultation-protocol.md.Skip auto-consultation for: changes to .claude/ infrastructure files; trivial
edits (typos, formatting, comments); areas with no tag overlap in the index.
When the current conversation produces institutional knowledge, suggest recording it after resolving the immediate issue โ never interrupt active problem-solving.
Suggest capture when you encounter:
Capture is always user-confirmed. Agents suggest, the user decides. Directives are sacred โ never auto-record.
references/templates.md.TYPE-YYYY-MM-DD-slug and write the filled record to the matching
ledger/<incidents|decisions|patterns|flows>/ subdirectory.ledger/index.md (By Tag, By Status, Relationship Map, Statistics).Follow references/consultation-protocol.md: triage the topic โ spawn agents
proportionally (one match โ one agent, multiple โ full panel, empty ledger โ skip)
โ synthesize into the Consultation Briefing โ suggest capture if warranted.
Scan all records for: stale active entries, broken Related: links, tag drift,
and proposed records never confirmed. Report statistics and recommended cleanups.
references/templates.md โ record formats (INC/DEC/PAT/FLW), status lifecycle, index rulesreferences/consultation-protocol.md โ triage, proportional agent spawning, synthesisreferences/capture-triggers.md โ conversation signals that warrant a record vs. auto memory