Skip to content

task-observer: new docs/ai/scratch-files from 2026-06-22#60

Open
divad12 wants to merge 1 commit into
masterfrom
task-observer/scratch-files-2026-06-22
Open

task-observer: new docs/ai/scratch-files from 2026-06-22#60
divad12 wants to merge 1 commit into
masterfrom
task-observer/scratch-files-2026-06-22

Conversation

@divad12

@divad12 divad12 commented Jun 22, 2026

Copy link
Copy Markdown
Owner

Target

new-global-doc: docs/ai/scratch-files.md

Observations addressed

  • Observation 009 (journology/log.md): Long-running self-guided workstreams need a scratch control surface → created: docs/ai/scratch-files.md documenting the three-section pattern (Current Truth / Next Steps / Archaeology) and the principle that the only required resumption intervention should be "What's next? Write it down, then do it."
  • Observation 010 (journology/log.md): Scratch Files Need Compaction-Time Maintenance Rules → added: "Compaction cleanup" contract rule — after compaction, move completed Next Steps to Archaeology, delete duplicated detail, compact Current Truth before proceeding; added the size gauge (>2 min re-read = overdue)

Also adds a routing table row to .claude/AGENTS.md per the new-doc convention.


Generated by Claude Code

Addresses observations 009 and 010 from journology/log.md:
- Document the scratch-file pattern for long-running autonomous workstreams
- Add compaction-cleanup maintenance rules
- Add routing table row to AGENTS.md
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