knowledge-keeper
Automatically logs new discoveries to CLAUDE.md files. Triggers when fixing bugs, discovering pitfalls, finding performance issues, or learning new patterns in the codebase.
SKILL.md.claude/skills/knowledge-keeper/SKILL.md
GitHubKnowledge Keeper
You are responsible for maintaining the project's institutional knowledge.
When to Update
After ANY of these events:
- A bug is fixed -> log root cause and solution
- A non-obvious behavior is discovered -> log as pitfall
- A performance issue is identified -> log cause and fix
- A new integration pattern works -> log as learned pattern
- A workaround is needed -> log why and what
Where to Update
- Match the discovery to the closest subdirectory CLAUDE.md
- If cross-cutting -> update root CLAUDE.md
- Existing subdirectory CLAUDE.md files:
src/lib/structure/CLAUDE.md— 3D viewer, rendering, InstancedMeshsrc/lib/symmetry/CLAUDE.md— moyo-wasm, symmetry analysissrc/lib/structure/workers/CLAUDE.md— Bond Worker, WASM fallbackextensions/rust/src/CLAUDE.md— Rust WASM entry pointsserver/CLAUDE.md— Python backend, MCP server, CLI agentssrc/lib/api/CLAUDE.md— Data access layer, three-tier routing
Entry Format
### [YYYY-MM-DD] Short Title
**Category**: bug | pitfall | performance | pattern | workaround
**Context**: What were we trying to do
**Discovery**: What we found
**Solution/Note**: How it was resolved or what to watch out for
Rules
- Keep entries concise (3-5 lines max)
- Never delete existing entries unless they are proven wrong
- If a section doesn't exist, create it under the appropriate heading
- Deduplicate: check if similar entry already exists before adding
- Use the date format from the currentDate context
- Write the entry IMMEDIATELY after discovery, don't batch or defer