git:20260328.a1c860d to git:20260328.6388128
11 added, 0 removed. Audit A to A.
# Knowledge Base
Aggregated tacit knowledge from Claude Code work sessions.
One entry per file with YAML frontmatter.
## Structure
```
.claude/knowledge/
├── CLAUDE.md # This index
└── entries/ # One entry per file (YAML frontmatter)
└── YYYY/
└── MM/
└── YYYYMMDD-HHMMSS-author-slug.md
```
- Entries are organized by year/month subdirectories
- `rg` and `fd` recurse into subdirectories automatically — search commands remain unchanged
- Legacy flat entries (directly under `entries/`) remain functional
## Search
```bash
# Fuzzy search by filename
fd -e md . .claude/knowledge/entries/ | fzf
# Search by tag
rg '#pitfall' .claude/knowledge/entries/
rg '#docker.*#pitfall' .claude/knowledge/entries/
# List all titles
rg '^title:' .claude/knowledge/entries/
# Active entries only
rg '^status: active' .claude/knowledge/entries/
```
## Tag Registry
Add new tags here. Reuse existing tags when possible.
`#pitfall`
`#environment-specific`
+ ## Entry Types
+
+ | Type | Meaning |
+ |------|---------|
+ | `knowledge` | Standalone verified fact (default if omitted) |
+ | `overview` | Topic entry point — summary + detail links |
+ | `detail` | Focused entry referenced from an overview |
+ | `fragment` | Isolated observation, not yet promoted |
+ | `synthesis` | Cross-cutting insight from multiple entries |
+
## Rules
- Entries are mutable — edit in place, rely on git for history
- Use `deprecated` only when knowledge is genuinely obsolete
- New entries use `YYYY/MM/YYYYMMDD-HHMMSS-author-slug.md` naming (year/month subdirectory + timestamp + author for collision avoidance)
- Do NOT add links to subdirectory CLAUDE.md files — use tag search to find entries
- Existing entries without timestamp prefix remain as-is (no rename)
+ - New tags **must** be added to the Tag Registry within the same operation
- See `/record-knowledge` skill for full details