diff options
| author | Craig Jennings <c@cjennings.net> | 2026-06-02 21:14:56 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-06-02 21:14:56 -0500 |
| commit | 2433e74131582e7010fba4e561f40d793bdc5334 (patch) | |
| tree | b8283e08a77d6252be2b1d764590766a94f1791b /docs | |
| parent | 656f11d8aea1595ce72f04b44744764c1ef343fa (diff) | |
| download | rulesets-2433e74131582e7010fba4e561f40d793bdc5334.tar.gz rulesets-2433e74131582e7010fba4e561f40d793bdc5334.zip | |
feat(flush): read notes.org before the anchor on resume
On a flush resume, the SessionStart(clear) hook now reads .ai/notes.org key sections before the session-context anchor. The anchor carries session state. notes.org carries the project's standing knowledge (code-repo paths, conventions, key contacts) that a resumed session needs to act correctly. A resume with the anchor alone floundered on context notes.org already documents, hunting for a repo whose path notes.org records.
The hook guards on notes.org presence: when it's absent, the resume reads the anchor alone. flush/SKILL.md documents the same read order so the skill and the hook agree. The handoff rationale is preserved in docs/design/2026-06-02-flush-promotion.org.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/design/2026-06-02-flush-promotion.org | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/docs/design/2026-06-02-flush-promotion.org b/docs/design/2026-06-02-flush-promotion.org index d34ad89..9d9d8a3 100644 --- a/docs/design/2026-06-02-flush-promotion.org +++ b/docs/design/2026-06-02-flush-promotion.org @@ -207,3 +207,27 @@ points the fresh session at startup. - Promotion: this workflow + the hook are candidates for the rulesets templates (the wrap/restart-rhythm task predicted this). Validate here, then file to the rulesets inbox. + +* Refinement — notes.org-before-anchor on resume (work handoff, 2026-06-02 21:06) + +A follow-up handoff from work, implemented the same evening. On a flush resume, +read notes.org key sections BEFORE the session-context anchor. + +Motivating failure (work project, 2026-06-02): right after a flush resume, the +agent went to start a dashboard chore and concluded the dashboard repo wasn't +cloned — hunting =~/code= with shallow finds — when notes.org's code-locations +section documented the exact path. The resume had the anchor but not notes.org, +so it lacked the standing context and floundered. The anchor carries +session-specific state; notes.org carries the project's standing knowledge +(code-repo paths, conventions, key contacts) a resumed session needs to act +correctly. + +Changes landed: +- =hooks/session-clear-resume.sh= — anchor-present branch now injects "read + .ai/notes.org key sections (Project-Specific Context, Active Reminders, + Pending Decisions; skip About This File), then the anchor." Runtime-guarded on + notes.org presence: absent → resume from the anchor alone. +- =flush/SKILL.md= — Phase 2 (post-clear resume) documents the same read order + so the skill text and the hook agree. + +A small ordering/scope addition, not a redesign. |