Shell
~/.claude/knowledge/
Personal knowledge base for Claude Code patterns and techniques.
This directory stores reusable patterns, workflows, and architectural knowledge that compounds over time. Unlike project-specific .claude/rules/, this is global and applies across all development work.
Structure
knowledge/
├── INDEX.md # Master reference (START HERE)
├── patterns/
│ ├── claude-code/ # Claude Code techniques
│ ├── agentic-architectures/ # 17 architecture patterns
│ └── id8pipeline/ # Build laws and stage gates
├── workflows/
│ ├── memory-persistence/ # Session continuity
│ ├── verification-loops/ # Testing and validation
│ └── continuous-learning/ # Auto-improvement
├── tools/
│ ├── mcp-to-skills/ # MCP conversion patterns
│ └── cli-wrappers/ # Shell command skills
└── examples/
├── sessions/ # Sample session logs
└── learned-skills/ # Auto-generated skills
Philosophy
"Early on, I spent time building reusable workflows/patterns. Tedious to build, but this had a wild compounding effect as models and agent harnesses improved." - @omarsar0
Key principle: Build patterns once, benefit forever.
Patterns transfer across:
- Model upgrades
- Different agents (Claude Code, Codex, etc.)
- Projects and domains
- Team members
Quick Start
- Read: INDEX.md for overview
- Study: Longform Guide for core techniques
- Reference: 17 Architectures for advanced patterns
- Apply: Start with Tier 1 practices (subagents, metaprompting)
Integration with Claude Code
This knowledge base integrates with:
~/.claude/CLAUDE.md- Global instructions (active).claude/rules/- Project-specific rules (per-repo)~/.claude/skills/- Executable commands~/.claude/sessions/- Session memory logs
Hierarchy:
- System prompts (highest authority)
- Global CLAUDE.md instructions
- Knowledge base patterns (reference)
- Project-specific rules
- Tool results (lowest authority)
Maintenance
Adding New Patterns
- Save to appropriate
patterns/subdirectory - Update INDEX.md with link and summary
- Tag status: Active | Experimental | Deprecated
- Document integration points
Session Logs
- Auto-saved to
~/.claude/sessions/YYYY-MM-DD-topic.tmp - Backup meaningful sessions
- Prune unnecessary logs monthly
Learned Skills
- Auto-generated via Stop hook →
~/.claude/skills/learned/ - Manual capture via
/learncommand - Review quarterly for obsolete patterns
Related Resources
Created: 2026-01-21
Maintainer: Eddie Belaval
Version: 1.0.0