Solution Knowledge Base

Turn a problem you just solved into a durable, categorized entry under docs/solutions/ so the next plan, the next reviewer, and the next debugging session can find it. This is the capture half of a compound knowledge loop: solved problems become grounding for future work. The lifecycle half (Keep / Update / Consolidate / Replace / Delete) lives in [[solution-refresh]].

Everything this skill does is local and zero-outbound: it reads the current session / repo and writes one Markdown file. It never uploads the solution, never calls an external model, and never shares across projects.

When to Use This Skill

Use when:

• A non-trivial bug was just fixed and the root cause is understood (capture it before the context is lost).
• A hard-won insight about how the system behaves emerged ("the installer copies scripts by explicit name", "this API silently truncates on #").
• The user says "document how we fixed that", "save this solution", "capture this for next time", or "add this to the knowledge base".
• A debugging or investigation session is wrapping up with a concrete resolution.

When NOT to use: