compound-docs

Installation
Summary

Automatically capture solved problems as searchable documentation with category-based organization and YAML validation.

  • Auto-triggers after confirmation phrases like "that worked" or "it's fixed"; documents non-trivial problems with investigation history, root cause, and prevention guidance
  • Enforces strict YAML frontmatter validation against enum-defined problem types and severity levels before file creation
  • Organizes solutions into category directories (e.g., docs/solutions/performance-issues/) with single-file-per-problem architecture for fast lookup
  • Detects similar existing issues and offers cross-referencing; identifies common patterns across 3+ related problems for promotion to critical patterns
  • Provides post-documentation decision menu to link related issues, add to learning skills, or create new skills from extracted patterns
SKILL.md

compound-docs Skill

Purpose: Automatically document solved problems to build searchable institutional knowledge with category-based organization (enum-validated problem types).

Overview

This skill captures problem solutions immediately after confirmation, creating structured documentation that serves as a searchable knowledge base for future sessions.

Organization: Single-file architecture - each problem documented as one markdown file in its symptom category directory (e.g., docs/solutions/performance-issues/n-plus-one-briefs.md). Files use YAML frontmatter for metadata and searchability.


<critical_sequence name="documentation-capture" enforce_order="strict">

7-Step Process

Related skills

More from everyinc/compound-engineering-plugin

Installs
1.5K
GitHub Stars
16.7K
First Seen
Jan 20, 2026