From 9d3d5f8986b60abe632f06da4930f1819393f158 Mon Sep 17 00:00:00 2001 From: Paul O'Reilly Date: Fri, 13 Mar 2026 11:52:40 +1300 Subject: [PATCH] Add CONTEXT.md index and context-loading task MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit First use of the CONTEXT.md pattern — thin index pointing to context/ topic files, loaded by context-load at session start. Co-Authored-By: Claude Opus 4.6 --- CONTEXT.md | 7 +++++++ context/context-loading.md | 19 +++++++++++++++++++ 2 files changed, 26 insertions(+) create mode 100644 CONTEXT.md create mode 100644 context/context-loading.md diff --git a/CONTEXT.md b/CONTEXT.md new file mode 100644 index 0000000..dc8b3de --- /dev/null +++ b/CONTEXT.md @@ -0,0 +1,7 @@ +# Context — claude-foundations + +Current work focus and active tasks. Used by `context-load` to orient agents at session start. + +## Active + +- [Context loading improvements](context/context-loading.md) — Testing and refining the `context-load` and `start-claude` scripts diff --git a/context/context-loading.md b/context/context-loading.md new file mode 100644 index 0000000..7f363ef --- /dev/null +++ b/context/context-loading.md @@ -0,0 +1,19 @@ +# Context Loading Improvements + +## Status +In progress — testing and iterating. + +## What exists +- `scripts/context-load` — Walks from cwd upward, loads CLAUDE.md, CONTEXT.md, MEMORY.md, BESTPRACTICES.md files, directory trees (depth 3), cwd `*.md` files, and git-status-report output. Deduplicates via symlink resolution. +- `scripts/start-claude` — Wrapper that runs `context-load` and passes result via `--append-system-prompt` to the `claude` CLI. +- Both symlinked into `~/sbin/`. + +## What to test +- Run `start-claude` from different project directories and verify context is complete and correctly ordered +- Check token budget — is the output too large for some projects? +- Verify CONTEXT.md and BESTPRACTICES.md are picked up when they exist +- Confirm git-status-report output is clean (no ANSI artefacts) + +## Future direction +- CONTEXT.md will be the primary mechanism for orienting independent agents running in Docker containers +- Each agent gets the full context load, with its starting prompt pointing to the relevant CONTEXT.md entry