compound-docslisted
Install: claude install-skill stevengonsalvez/agents-in-a-box
> **Internal Module**: Called by `/reflect` for knowledge capture.
> Use `/reflect` directly, or `/reflect --knowledge` for knowledge-only capture.
# Compound-Docs — Knowledge Note Generator
## Purpose
Generate structured learning documents from solved problems. This module handles:
1. Context gathering (problem, root cause, solution, files, tags)
2. Category auto-detection
3. Learning document generation (YAML frontmatter + markdown)
4. Entity sidecar generation for GraphRAG indexing
5. Saving to `docs/solutions/` and promoting to global KB
## Context to Gather
1. **Problem**: Error message, observed vs expected behavior
2. **Root Cause**: What actually caused it, why
3. **Solution**: What fixed it, key insight, steps
4. **Files**: Which files were modified or had the bug
5. **Tags**: Technologies involved, searchable keywords
## Category Auto-Detection
| Category | Indicators |
|----------|------------|
| `build-errors` | Compile errors, CI failures, bundling |
| `performance-issues` | Slowdowns, memory leaks, optimization |
| `security-fixes` | Vulnerabilities, auth issues, secrets |
| `testing-patterns` | Test strategies, flaky tests |
| `debugging-sessions` | Complex investigations |
| `architecture-decisions` | Design choices, patterns |
| `api-integrations` | Third-party APIs, SDKs |
| `dependency-issues` | Package conflicts, upgrades |
| `deployment-fixes` | Production incidents |
| `database-migrations` | Schema changes, data fixes |
| `ui-patterns` | Frontend