task-observer: new docs/ai/long-running-workstreams from 2026-06-26#68
task-observer: new docs/ai/long-running-workstreams from 2026-06-26#68divad12 wants to merge 1 commit into
Conversation
Incorporates observations 009 and 010 from journology/log.md: - Scratch control surface pattern (Current Truth, Next Steps, Archaeology) - Compaction-time maintenance rules (update truth, compact archaeology, garbage-collect before continuing)
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 1613c1a330
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| @@ -0,0 +1,46 @@ | |||
| > **IMPORTANT: Before reading, check if you already read this file earlier in this session. If yes, skip the read and announce "Context already loaded: long-running-workstreams.md (re-using from earlier)". If no, read it and announce "Context loaded: long-running-workstreams.md".** | |||
There was a problem hiding this comment.
Re-read after compaction instead of skipping
When a long-running session resumes after /compact, this banner tells the agent to skip re-reading the file if it knows it was loaded earlier in the same session, but the contract below is specifically needed after compaction/resume and even expects garbage-collection on every re-read after compaction. In that scenario the agent can miss the Current Truth/Next Steps cleanup and continue from stale scratch state; add a compaction/resume exception to the skip rule.
Useful? React with 👍 / 👎.
Target
new-global-doc:
docs/ai/long-running-workstreams.mdObservations addressed
docs/ai/long-running-workstreams.mdwith the scratch.md pattern (Current Truth section, Next Steps queue, Archaeology section); also added routing table entry in.claude/AGENTS.md.Generated by Claude Code