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

Add script & skill documentation requirement to Documentation Standards

Browse Source 
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 <noreply@anthropic.com>
This commit is contained in:
Paul O'Reilly
2026-03-13 12:07:32 +13:00
parent e846ab4eb2
commit a5c6373f63
1 changed files with 11 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
CLAUDE.md
View File

@@ -133,6 +133,17 @@ Human-readable project documentation:
- Milestone table with status - Milestone table with status
- Scripts section listing every script with purpose and usage - 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-<name>.md` — Purpose, usage, how it works, gotchas
- **Skills:** `memory/skill-<name>.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 ## Knowledge Distillation Pipeline
Three skills form a continuous learning pipeline across projects: Three skills form a continuous learning pipeline across projects: