From a5c6373f63560cf0bed58bed98d778c4afd8d659 Mon Sep 17 00:00:00 2001 From: Paul O'Reilly Date: Fri, 13 Mar 2026 12:07:32 +1300 Subject: [PATCH] Add script & skill documentation requirement to Documentation Standards Every script in claude-foundations and skill in custom-claude-skills must have a memory file in claude-foundations/memory/ with an index entry in MEMORY.md, so future sessions can discover tooling without reading sources. Co-Authored-By: Claude Opus 4.6 --- CLAUDE.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 52eda0f..ac050a3 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -133,6 +133,17 @@ Human-readable project documentation: - Milestone table with status - Scripts section listing every script with purpose and usage +## Script & Skill Documentation + +Every script in `claude-foundations` and every skill in `custom-claude-skills` must have a corresponding memory file in `claude-foundations/memory/`: + +- **Scripts:** `memory/script-.md` — Purpose, usage, how it works, gotchas +- **Skills:** `memory/skill-.md` — Purpose, usage, how it works, gotchas, which projects use it + +Each memory file should be self-contained and referenced from `claude-foundations/MEMORY.md` (the index). This ensures that future sessions can quickly understand what tooling exists and how it works, without having to read every script and SKILL.md from scratch. + +**When creating a new script or skill:** Create the memory file and update the MEMORY.md index as part of the same commit. + ## Knowledge Distillation Pipeline Three skills form a continuous learning pipeline across projects: