← ClaudeAtlas

icm-maintainlisted

Keep an ICM workspace structurally true across sessions — a read-only integrity checker (catalog rows, orphan files, broken links, frontmatter, binding line budgets on hot files, decision review-by clocks, expired ledger entries, stale briefing, stale external-number stamps, date drift, truncation against .bak copies), a bounded maintenance run with an explicit "authorized to fix" list and a "never" list, a five-minute compaction routine for over-budget hot files, and a budgeted maintenance log. Use when (1) starting or ending a session in an ICM workspace ("run the check", "is the workspace clean"); (2) a scheduled or unattended maintenance session runs; (3) the checker FAILs a hot-file budget and something must be compacted; (4) a file was just written and may have been truncated; (5) the owner asks "what needs me", "what drifted", or "why is the catalog out of date"; or (6) setting per-workspace budgets and protected files in icm-ops.json. Detects and stages; a person applies the subtractive fixes.
xnfinite/icm-ops · ★ 0 · AI & Automation · score 73
Install: claude install-skill xnfinite/icm-ops
# icm-maintain A context workspace decays under use: hot files regrow, catalog rows point at moved files, a review date passes and nobody notices, a ledger entry expires in silence, a briefing goes stale while still sounding current. This skill is the routine that keeps that from compounding — mechanical first, judgment second, and never more authority than an unattended session can be trusted with. The system should not wait for someone to remember it. This skill operates on an ICM workspace — Interpretable Context Methodology, Van Clief & McDermott, arXiv:2603.16021 (https://arxiv.org/abs/2603.16021). Build the workspace with their `icm-architect` skill (https://github.com/RinDig/icm-architect), or by hand from the paper: a front desk (`CLAUDE.md` / `AGENTS.md`), `00-catalog/CATALOG.md`, and dated markdown files with frontmatter — the `example/` tree in the icm-ops repo is a complete minimal one. This pack is a layer on top of the method, not part of it. ## The checker ``` python <skill folder>/scripts/icm_check.py <workspace-root> python <skill folder>/scripts/icm_check.py <workspace-root> --json ``` The skill folder is usually `.claude/skills/icm-maintain/`, `.agents/skills/icm-maintain/`, `~/.claude/skills/icm-maintain/`, or `skills/icm-maintain/` in a clone of the icm-ops repo. Options: `--json` (the findings as a machine-readable object for a test or a hook), `--config PATH` (an `icm-ops.json` that is not at the root), `--today YYYY-MM-DD` (pins the clock for tes