grimoire-tidy

Installation
SKILL.md

Keep .grimoire/ compact, not a permanent task log. Specs are requirements contracts with continuing value; tickets primarily support multi-step execution and handoff. Retire completed redundant documents when the gates below pass; do not delete useful specs merely because implementation is complete. Status alone neither permits nor blocks retirement, including for inactive unfinished artifacts.

Scope and authority

Explicit invocation is required because cleanup may delete documents. Audit and planning requests are read-only; an execution request authorizes eligible cleanup without per-file reconfirmation. Ask before expanding scope or proceeding with uncertain destructive changes. Do not initialize a missing store, implement features, change requirements or acceptance criteria, or invent architectural decisions.

Establish the selected root and inventory every Git-tracked file with git ls-files, including working-tree modifications. Stop if tracked status cannot be established. Do not follow symlinks outside the authorized root. Read every document proposed for change in full, its related tracked specs/tickets, and relevant tracked evidence. Report unread or inaccessible areas; inventory is not content review. For large stores, work in coherent groups without silently sampling.

Exclude pre-existing untracked files: do not read, extract from, edit, or delete them; report paths only when useful. Authorized outputs created during this run may be read back, edited, and verified even while untracked. Never overwrite an excluded path. Do not automatically commit, stage, stash, or archive.

Keep changes inside .grimoire/, except authorized incoming-reference repairs in repository documentation. Source code, tests, agent configuration, and tooling need separate authorization; retain candidates whose deletion requires unauthorized repairs. Do not create tests merely to justify retirement.

Knowledge destinations

Follow the existing directory structure. For context or ADR changes, consult grimoire-record; preserve ADR history rather than treating decisions as disposable execution notes. Inventory specialized areas such as map/ and refactor/, but consult their owners before proposing changes. Preserve unfamiliar formats by default.

Installs
9
GitHub Stars
3
First Seen
Sep 17, 2026