From darkroom
Saves and recalls learnings (bugs, patterns, gotchas, perf, config, arch) across Claude sessions locally or via shared GitHub projects. Auto-invokes after non-obvious bug fixes.
npx claudepluginhub darkroomengineering/cc-settingsThis skill uses the workspace's default tool permissions.
Store learnings that survive across sessions. **Proactively store when you discover something valuable.**
Manages project learnings in markdown files: view index, add patterns/pitfalls/operational notes/decisions, search, prune, export for CLAUDE.md persistence across sessions.
Captures AI agent mistakes, corrections, gotchas from failed commands, debugging, unexpected API behavior; searches prior learnings before tasks to avoid pitfalls.
Persists learnings into a 5-layer memory hierarchy (CLAUDE.md files, memory/MEMORY.md) and consolidates by pruning outdated entries and promoting recurring patterns. Triggers on 'extract learnings', 'remember', 'dream'.
Share bugs, ideas, or general feedback.
Store learnings that survive across sessions. Proactively store when you discover something valuable.
| Tier | Flag | Storage | Scope |
|---|---|---|---|
| Local | (default) | ~/.claude/learnings/<project>/ | Personal to this developer |
| Shared | --shared | GitHub Project board | Team-wide, all agents |
Decision guide: If another team member's AI agent would benefit from knowing it, use --shared.
Store automatically when:
bun ~/.claude/src/scripts/learning.ts store "<category>" "<learning>" "[context]"
bun ~/.claude/src/scripts/learning.ts store --shared "<category>" "<learning>" "[context]"
This creates an entry in the project's GitHub Project board, accessible to any team member's AI agent. Requires gh CLI authenticated and a configured project number.
Categories: bug, pattern, gotcha, tool, perf, config, arch, test
Examples:
# Local: personal learning
bun ~/.claude/src/scripts/learning.ts store "bug" "useAuth hook causes hydration mismatch - wrap in dynamic import with ssr:false"
# Shared: team-wide gotcha
bun ~/.claude/src/scripts/learning.ts store --shared "gotcha" "Sanity API returns UTC dates - always convert to local before display"
# Shared: architecture decision
bun ~/.claude/src/scripts/learning.ts store --shared "arch" "Chose Lenis over native smooth-scroll for cross-browser consistency"
# Local: tool discovery
bun ~/.claude/src/scripts/learning.ts store "tool" "Use 'bun --bun' flag to enable native Bun APIs in scripts"
# Local learnings
bun ~/.claude/src/scripts/learning.ts recall [filter] [value]
# Shared team knowledge
bun ~/.claude/src/scripts/learning.ts recall shared
Local filters:
all - All learnings for current projectall-projects - List all projects with learningscategory <cat> - Filter by categorysearch <keyword> - Search in learning textrecent <n> - Most recent n learningsbun ~/.claude/src/scripts/learning.ts delete <id>
bun ~/.claude/src/scripts/learning.ts prune [days]
Surfaces learnings older than N days (default 90) for review. Stale learnings may reflect outdated patterns, deprecated APIs, or resolved issues. The command lists candidates — you confirm which to keep or delete.
When to prune:
~/.claude/learnings/<project>/learnings.jsondocs/knowledge-system.md for setup)--shared for team knowledge - Gotchas, decisions, conventions that affect everyone