Skip to content
Shell
3.0 KB
Raw Blame

~/.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

  1. Read: INDEX.md for overview
  2. Study: Longform Guide for core techniques
  3. Reference: 17 Architectures for advanced patterns
  4. 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:

  1. System prompts (highest authority)
  2. Global CLAUDE.md instructions
  3. Knowledge base patterns (reference)
  4. Project-specific rules
  5. Tool results (lowest authority)

Maintenance

Adding New Patterns

  1. Save to appropriate patterns/ subdirectory
  2. Update INDEX.md with link and summary
  3. Tag status: Active | Experimental | Deprecated
  4. 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 /learn command
  • Review quarterly for obsolete patterns

Related Resources


Created: 2026-01-21
Maintainer: Eddie Belaval
Version: 1.0.0