claude-plugins: state-hygiene skill - archive files go in a subdir, not state top level

This commit is contained in:
damocles 2026-07-27 13:48:52 +02:00 committed by mara
commit 896dfc6194

View file

@ -29,10 +29,13 @@ duplicated.
## Keeping a notes file lean
- Split into a **live file** (only what's currently active/gated/relevant -
this is what you re-read every turn, keep it short) and an **archive**
(resolved/closed work, moved out of the hot path, never deleted).
this is what you re-read every turn, keep it short) and an **archive
subdirectory** (e.g. `state/notes-archive/`) for resolved/closed work,
moved out of the hot path, never deleted. Don't drop archived files
loose at the top level of `state/` alongside the live files - a
dedicated subdir keeps `ls state/` showing only what's live.
- Archive in **dated, per-topic chunks** - `YYYY-MM-DD-<topic>.md` - not one
ever-growing archive blob. `ls` on the archive dir should read like a
ever-growing archive blob. `ls` on the archive subdir should read like a
timeline.
- When you finish a piece of work, collapse its entry in the live file to a
one-line "done" summary and move the full detail into a new dated