feat(best-practices): pointer CLAUDE.md so agents know the library exists

The 237KB library was mounted at /workspace/best-practices/ in every
consuming ConfigMap but nothing in the prompt mentioned it (directory
targets never enter the context manifest). New ~90-word CLAUDE.md file
target enters the system prompt: points at INDEX.md, instructs reading
only task-relevant topics.

Claude-Session: https://claude.ac/code/session_012arAwUuBQrpnMzJ36mEVBk
This commit is contained in:
Paul O'Reilly
2026-08-19 09:34:31 +12:00
parent 1ce42a9e59
commit 73acc6a11d
2 changed files with 12 additions and 0 deletions

View File

@@ -0,0 +1,7 @@
# Best Practices Library
A library of cross-project best-practices docs is mounted at `/workspace/best-practices/`.
- Start with `/workspace/best-practices/INDEX.md` — one line per topic saying when to read it.
- Read ONLY the topic file(s) relevant to your current task (e.g. `test-driven-development.md` for coding against tests, `api-design.md` for HTTP API work, `scripting.md` for shell scripts).
- Do not read the whole library; each file is 10-60KB. Pick from the index.