skynet/claude-foundations
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add question-reframing guidance to CLAUDE.md; commit accumulated project files

Browse Source 
- CLAUDE.md: add "Question the question" and "One clarifying question" rules
  to Tone and Interaction — XY problem detection, false premise checks, and
  explicit reframe pattern before answering
- Add claude/ detail-file directory (topic docs referenced from CLAUDE.md)
- Add ABOUT.md, FUTURE.md
- Update memory/, scripts/, settings.yaml with accumulated session changes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Paul O'Reilly
2026-05-25 09:37:28 +12:00
parent 6dfa20c47c
commit f41c22d0ac
29 changed files with 689 additions and 352 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
memory/script-context-load.md
View File

@@ -9,22 +9,27 @@ Gathers project context for a Claude Code session by walking from cwd upward, co
## What it loads (in order)
1. Every `CLAUDE.md` found walking up from cwd (top-down order) + directory tree (depth 3) from each
2. Every `CONTEXT.md` found walking up (top-down)
3. Every `MEMORY.md` found walking up (top-down)
4. Every `BESTPRACTICES.md` found walking up (top-down)
5. All `*.md` files in cwd (deduped against already-emitted files)
6. `git-status-report` output from the highest-level CLAUDE.md directory
1. **Paths** to every `CLAUDE.md` found walking up from cwd (not contents — Claude Code loads those natively via `claudeMd`), annotated with `description:` from sibling `ABOUT.md` if present
2. **Paths** to every project `CLAUDE.md` found under each CLAUDE.md directory (depth 2-4) — for project discovery, also annotated with ABOUT.md descriptions
3. Every `CONTEXT.md` found walking up (top-down) — full contents
4. Every `MEMORY.md` found walking up (top-down) — full contents
5. Every `BESTPRACTICES.md` found walking up (top-down) — full contents
## What it does NOT load
- CLAUDE.md contents (loaded natively by Claude Code)
- Directory trees (Claude can run `tree` on demand for fresh results)
- README.md files (human-oriented, read on demand)
- git-status-report (moved to `/housekeeping` skill)
## How it works
- Uses `discover_upward()` to walk from `$PWD` to `/`, collecting directories
- Resolves symlinks via `readlink -f` to deduplicate (e.g., `~/dev/claude/CLAUDE.md` symlink to `claude-foundations/CLAUDE.md`)
- Emits each file with a structured header (`=== FILE: ... ===`) for easy parsing
- Tree output uses `tree` with fallback to `find`
- ANSI codes are stripped from git-status-report output
- Uses `find` to discover project CLAUDE.md files under each hierarchy directory
## Gotchas
- Only walks **upward** from cwd — does not descend into subdirectories. Launch from within a project directory to get that project's context.
- Only walks **upward** from cwd for index files — but scans **downward** for project CLAUDE.md discovery. Launch from within a project directory to get that project's context.
- Index files (MEMORY.md, CONTEXT.md, BESTPRACTICES.md) should be thin indexes, not large documents, since they're injected into the system prompt.