Capture knowledge from solved problems to prevent re-discovery. Creates searchable solution documents after non-trivial debugging, fixes, or investigations.
Capture knowledge from solved problems to prevent re-discovery. Creates searchable solution documents after non-trivial debugging, fixes, or investigations.
/compound [--category <category>] [--from-commit <hash>]
--category: Override auto-detected category (see categories below)--from-commit: Extract context from a specific commit instead of current state| Category | When to Use |
|---|---|
build-errors | Build/compile failures, dependency resolution |
test-failures | Test failures, flaky tests, fixture issues |
runtime-errors |
| Crashes, unhandled exceptions, unexpected behavior |
performance | Slow queries, memory leaks, optimization wins |
database | Migration issues, schema problems, query optimization |
security | Vulnerability fixes, auth issues, data exposure |
integration | API issues, third-party service problems, webhook failures |
deployment | CI/CD failures, environment issues, infrastructure |
logic-errors | Incorrect business logic, edge cases, race conditions |
When this skill is invoked:
Autonomy:
Quality:
Collect from the current session or recent git history:
If --from-commit is specified:
git show {hash} --stat
git log {hash} -1 --format="%B"
git diff {hash}^..{hash}
# Search existing solutions for similar problems
ls docs/solutions/
grep -r "{key_error_term}" docs/solutions/ || true
If a similar solution exists:
Directory structure:
docs/solutions/{category}/{YYYY-MM-DD}-{slug}.md
Template:
---