Files
..

Skill Documentation

End-user-facing documentation for compound-engineering plugin skills. Each page covers the skill's high-level purpose, novel mechanics, use cases, and chain position relative to other skills.

For runtime behavior and contributor reference, the SKILL.md in each skill's source folder under skills/ is authoritative.

Checkout-local defaults shared across skills are documented in Compound Engineering configuration.

Artifact paths shown throughout these pages (docs/plans/, docs/solutions/, docs/ideation/, and the rest) are the defaults. A project can relocate every CE artifact folder under one repo-relative root with docs_root; when it is set, read the shown paths as <your-docs_root>/plans/, <your-docs_root>/solutions/, and so on. See Artifact root.


The compound-engineering core loop

   [/ce-ideate]       (optional) "What's worth exploring?"
        │
        ▼
┌─→ /ce-brainstorm    "What does this need to be?"
│       │
│       ▼
│   /ce-plan          "What's needed to accomplish this?"
│       │
│       ▼
│   /ce-work          "Build it."
│       │
│       ▼
└── /ce-compound      "Capture what we learned."

/ce-compound is the closer that makes the loop compound: it writes learnings into docs/solutions/, which the next iteration's /ce-brainstorm and /ce-plan read as grounding. That return arrow is the whole point. /ce-ideate is an optional prelude for when you don't yet know what to work on. Everything else in this catalog is either an anchor around the loop or an on-demand tool used when a specific need arises, not a step you walk through every time.


The Core Loop

The steps of every engineering iteration. /ce-ideate runs only when you need to find a direction first; the other four run in order per piece of work.

Skill Description
/ce-ideate Optional first step: discover grounded directions worth exploring (six frames, tagged basis, adversarial cut)
/ce-brainstorm Define what something should become: one question at a time, ask only decisions, named gap lenses, requirements-only unified plan
/ce-plan Bound execution with guardrails (U-IDs, test scenarios, automatic confidence check). WHAT decisions, not HOW code
/ce-work Execute an implementation-ready plan: figure out the HOW with code in front of you, then ship through quality gates
/ce-compound Close the loop by writing what you learned into docs/solutions/ so the next iteration can read it

Around the Loop

Skills that anchor, feed, or maintain the loop without being steps inside it.

Skill Description
/ce-strategy Create or maintain STRATEGY.md, the upstream anchor ce-ideate, ce-brainstorm, and ce-plan read as grounding
/ce-product-pulse Outer observation loop: a time-windowed report on usage, performance, errors, and follow-ups, saved to docs/pulse-reports/
/ce-sweep Recurring feedback sweep: ingest Slack/GitHub items (email experimental), acknowledge at source, and keep an /lfg-ready rolling plan
/ce-compound-refresh Maintain docs/solutions/ over time (Keep / Update / Consolidate / Replace / Delete), Interactive or Autofix

On-Demand

Invoked when a specific need arises, not part of any chain.

Skill Description
/ce-pov A project-grounded verdict: adopt/hold/reject, a document take, or a position on supplied approaches. Optional named/oracle panel.
/ce-explain A durable teaching document for a concept, a diff, an idea, or a window of recent work. Optional opt-in check-in.
/ce-prototype Build a throwaway prototype so someone can experience how the product should work, feel, or read, then write those decisions into an existing plan or continue into brainstorm or plan
/ce-debug Find the root cause of broken behavior: causal chain, predictions, then an optional fix and PR handoff
/ce-code-review Structured review of a diff or PR: skill-local personas, confidence-gated findings
/ce-doc-review Structured review of a requirements or plan document: findings, not a holistic verdict
/ce-simplify-code Refine recently changed code for reuse, quality, and efficiency, with behavior preserved
/ce-optimize Metric-driven optimization loops with parallel experiments and a durable experiment log
/ce-retune Retune a skill corpus for a new model: baseline, noise floor, then measured cut passes

Research & Context

Skill Description
/ce-riffrec-feedback-analysis Turn a Riffrec recording into structured feedback: a quick bug in chat, or an extensive analysis that hands off to ce-brainstorm

Git Workflow

Skill Description
/ce-commit Local git commit(s) only: convention-aware, named-file staging, file-level splits (up to three). No push.
/ce-commit-push-pr Working changes to an open PR. Three modes: full ship, rewrite an existing description, or description-only from a URL.
/ce-babysit-pr Watch an open PR over time: incoming review via /ce-resolve-pr-feedback, CI via /ce-debug. Does not merge under target or stack-ready; stack-land can merge a confirmed managed stack.
/ce-worktree Isolate work in a git worktree: detect existing isolation, prefer the host's native tool, else plain git

Autonomous Pipeline

Skill Description
/lfg Hands-off pipeline through an open PR (plan, implement, review, ship, bounded CI watch). Pushes without prompting when a remote exists; local commits only otherwise. Does not merge.

Frontend Design

Skill Description
/ce-polish Conversational UX polish on a feature that already works: start the dev server, open a browser, iterate. Manual invoke only.

Collaboration

Skill Description
/ce-proof Publish, view, comment on, or pull markdown via Proof. One-way publish; not a review skill.

Workflow Utilities

Skill Description
/ce-promote Draft announcement copy for a shipped feature (X, changelog, LinkedIn, email, blog, demo). Drafts only; never posts.
/ce-resolve-pr-feedback One pass to evaluate, fix, and reply to PR review comments, including nitpicks. Babysit is the watch that calls this.
/ce-dogfood Hands-off browser QA of the branch: map flows, fix small breakages, write a report. Manual invoke only.
/ce-test-browser End-to-end browser tests of the current diff using a host-native browser with agent-browser fallback. Does not check out a PR or branch.
/ce-test-xcode Build and test an iOS app on the simulator (screenshots, logs, human verification). Not XCUITest.
/ce-setup Diagnose optional tool capabilities and create or repair repo config.yaml
/ce-handoff Write a session handoff, or find and orient from a selected source. Does not auto-continue.

See also

For the top-level install and usage guide, see README.md. Each skill's authoritative runtime spec is in skills/<skill>/SKILL.md.