ce-compound

A documentation command that captures a recently solved problem while context is fresh so a team's knowledge compounds over time. It coordinates multiple subagents working in parallel to produce structured documentation in docs/solutions/ with YAML frontmatter for searchability and future reference. The premise is that the first time a problem is solved takes research, but once documented the next occurrence takes minutes, so each documented solution compounds the team's knowledge.

It supports both interactive and headless invocation. The default interactive mode asks the user to choose Full versus Lightweight, asks whether to search session history (Full only), prompts for consent on a Discoverability Check, and ends with a "What's next?" menu, presenting blocking questions through the platform's question tool. Headless mode, intended for automations and skill-to-skill invocation where no human is present, asks no blocking questions, runs Full mode without session history, applies the Discoverability Check edit silently when a gap exists, skips specialized reviews, and ends with a structured terminal report; the resulting document is identical to what an interactive Full run would produce. Mode is detected by a mode:headless token in the arguments, which is stripped before the remainder is treated as a brief context hint. Full mode researches, cross-references, and reviews the solution; Lightweight produces the same documentation in a single pass without duplicate detection or cross-referencing, suited to simple fixes or long sessions near context limits.

The primary deliverable is a single file: the final solution documentation. Phase 1 subagents return text data to the orchestrator and must not write files; only the orchestrator writes. Beyond the solution doc it may make small maintenance side-effect writes, namely creating or updating CONCEPTS.md (the project's shared domain vocabulary) in a Vocabulary Capture step when a qualifying term surfaces, and a small edit to an AGENTS.md or CLAUDE.md instruction file when the Discoverability Check finds a gap. A standalone request to bootstrap CONCEPTS.md from scratch is redirected to ce-compound-refresh, since this command only seeds the learning's area as a side effect.