workflows-compound

Automating documentation of solved problems is handled by generating structured markdown files with YAML frontmatter under docs/solutions. The Skill orchestrates parallel research subagents to capture execution context and cross-references, producing a single categorized markdown file per solution.

Using YAML frontmatter in markdown files enables easy indexing, linking, and retrieval of team documentation. The Skill automatically assigns a category and stores the final document in docs/solutions/[category]/[filename].md, building a connected knowledge graph.

Parallel subagent orchestration for solution docs runs in two phases: Phase 1 dispatches parallel research subagents to gather execution context, and Phase 2 assembles findings into a single markdown file with YAML frontmatter and cross-references.

Capturing execution context learnings and cross-referencing related docs and issues is automated during the documentation generation process. This builds a connected knowledge graph within the structured markdown output stored in docs/solutions.

No external dependencies are required to generate structured markdown files for team collaboration. The Skill operates independently using its internal two-phase orchestration and parallel subagents to produce the final documentation artifacts.

Automated documentation generation for solved problems is not suited for ad-hoc or incomplete fixes lacking a converged solution. It is designed for finalized problems where structured markdown with frontmatter and cross-references will compound long-term team knowledge.