compound-docs

To persist solved problems for knowledge retrieval, document the solutions in plain language and store them under docs/solutions/. This creates a searchable knowledge base that AI agents can access in future sessions.

The best way to document solutions for AI reuse is to write concise, plain-language instructions and store them in the docs/solutions/ directory. This centralizes learnings, enabling quick retrieval and pattern promotion across projects.

Yes, documenting solutions for knowledge persistence requires YAML frontmatter in the SKILL.md file. This structured metadata ensures your documented solutions can be properly indexed and retrieved by AI agents.

Yes, you can attach optional artifacts like scripts, references, and assets when documenting solved problems. These supplementary files provide additional context alongside the plain-language instructions in your knowledge base.

AI agents lose context and fail to retrieve past solutions because the knowledge is not persisted. Documenting solved problems under docs/solutions/ ensures learning continuity and enables quick retrieval across AI sessions.