Skip to content

task-observer: new docs/ai/long-running-workstreams from 2026-05-22#31

Open
divad12 wants to merge 1 commit into
masterfrom
task-observer/long-running-workstreams-2026-05-22
Open

task-observer: new docs/ai/long-running-workstreams from 2026-05-22#31
divad12 wants to merge 1 commit into
masterfrom
task-observer/long-running-workstreams-2026-05-22

Conversation

@divad12
Copy link
Copy Markdown
Owner

@divad12 divad12 commented May 22, 2026

Target

new-global-doc: docs/ai/long-running-workstreams.md

Observations addressed

  • Observation 9 (journology/log.md): Long-running self-guided workstreams need a scratch control surface → changed: new doc with three-section scratch.md pattern (Current Truth, Next Steps, Archaeology) and contract rules for keeping it alive across compactions
  • Observation 10 (journology/log.md): Scratch files need compaction-time maintenance rules → changed: added compaction re-read ritual, 200-line garbage-collection trigger, and rule that Current Truth must stay sharper than Archaeology; also added routing row to AGENTS.md adaptive-docs table

Generated by Claude Code

Introduces docs/ai/long-running-workstreams.md with a scratch.md
contract for multi-hour autonomous workstreams: three-section structure
(Current Truth, Next Steps, Archaeology), compaction re-read rules,
and garbage-collection requirements to prevent transcript growth.

Also adds routing row to AGENTS.md adaptive-docs table.

Addresses journology/log.md Obs 009, 010.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant