Showing preview only (8,745K chars total). The displayed content is truncated. Use the JSON API for full output.
Repository: EveryInc/compound-engineering-plugin
Branch: main
Commit: 4c63fd272e7e
Files: 685
Total size: 8.2 MB
Directory structure:
gitextract_fchwsspe/
├── .agents/
│ └── plugins/
│ └── marketplace.json
├── .agy/
│ └── INSTALL.md
├── .claude/
│ └── commands/
│ └── triage-prs.md
├── .claude-plugin/
│ ├── CHANGELOG.md
│ ├── marketplace.json
│ └── plugin.json
├── .cline/
│ ├── INSTALL.md
│ └── scripts/
│ └── install-skills.sh
├── .codex-plugin/
│ └── plugin.json
├── .compound-engineering/
│ └── config.local.example.yaml
├── .cursor-plugin/
│ ├── CHANGELOG.md
│ ├── marketplace.json
│ └── plugin.json
├── .devin-plugin/
│ └── plugin.json
├── .github/
│ ├── .release-please-manifest.json
│ ├── release-please-config.json
│ └── workflows/
│ ├── ci.yml
│ ├── release-pr.yml
│ └── release-preview.yml
├── .gitignore
├── .grok-plugin/
│ ├── marketplace.json
│ └── plugin.json
├── .kimi-plugin/
│ ├── marketplace.json
│ └── plugin.json
├── .opencode/
│ ├── INSTALL.md
│ └── plugins/
│ └── compound-engineering.js
├── .pi/
│ └── extensions/
│ └── compound-engineering.ts
├── AGENTS.md
├── CHANGELOG.md
├── CONCEPTS.md
├── GEMINI.md
├── LICENSE
├── PRIVACY.md
├── README.md
├── SECURITY.md
├── docs/
│ ├── brainstorms/
│ │ ├── 2026-02-14-copilot-converter-target-brainstorm.md
│ │ ├── 2026-02-17-copilot-skill-naming-brainstorm.md
│ │ ├── 2026-03-14-ce-plan-rewrite-requirements.md
│ │ ├── 2026-03-15-ce-ideate-skill-requirements.md
│ │ ├── 2026-03-16-issue-grounded-ideation-requirements.md
│ │ ├── 2026-03-17-release-automation-requirements.md
│ │ ├── 2026-03-18-auto-memory-integration-requirements.md
│ │ ├── 2026-03-22-frontend-design-skill-improvement.md
│ │ ├── 2026-03-23-plan-review-personas-requirements.md
│ │ ├── 2026-03-25-config-storage-redesign-requirements.md
│ │ ├── 2026-03-25-vonboarding-skill-requirements.md
│ │ ├── 2026-03-26-merge-deepen-into-plan-requirements.md
│ │ ├── 2026-03-27-ce-skill-prefix-rename-requirements.md
│ │ ├── 2026-03-28-ce-review-headless-mode-requirements.md
│ │ ├── 2026-03-29-iterative-optimization-loop-requirements.md
│ │ ├── 2026-03-29-testing-addressed-gate-requirements.md
│ │ ├── 2026-03-30-cli-readiness-review-persona-requirements.md
│ │ ├── 2026-03-31-codex-delegation-requirements.md
│ │ ├── 2026-04-01-cross-invocation-cluster-analysis-requirements.md
│ │ ├── 2026-04-02-slack-analyst-agent-requirements.md
│ │ ├── 2026-04-05-universal-planning-requirements.md
│ │ ├── 2026-04-17-ce-release-notes-skill-requirements.md
│ │ ├── 2026-04-17-ce-review-interactive-judgment-requirements.md
│ │ ├── 2026-04-18-ce-doc-review-autofix-and-interaction-requirements.md
│ │ ├── 2026-04-22-demo-reel-local-save-requirements.md
│ │ ├── 2026-04-24-surface-scope-earlier-requirements.md
│ │ ├── 2026-05-19-vscode-copilot-agent-tool-access-requirements.md
│ │ ├── 2026-06-04-ce-plan-approach-altitude-requirements.md
│ │ └── 2026-06-19-agentless-plugin-surface-reduction-requirements.md
│ ├── grok-marketplace-submission.md
│ ├── ideation/
│ │ └── 2026-06-28-ce-pov-skill-proposal.html
│ ├── plans/
│ │ ├── 2026-02-08-feat-convert-local-md-settings-for-opencode-codex-plan.md
│ │ ├── 2026-02-08-feat-pr-triage-and-merge-plan.md
│ │ ├── 2026-02-08-feat-simplify-plugin-settings-plan.md
│ │ ├── 2026-02-08-refactor-reduce-plugin-context-token-usage-plan.md
│ │ ├── 2026-02-09-refactor-dspy-ruby-skill-update-plan.md
│ │ ├── 2026-02-12-feat-add-cursor-cli-target-provider-plan.md
│ │ ├── 2026-02-14-feat-add-copilot-converter-target-plan.md
│ │ ├── 2026-02-14-feat-add-gemini-cli-target-provider-plan.md
│ │ ├── 2026-02-14-feat-auto-detect-install-and-gemini-sync-plan.md
│ │ ├── 2026-02-25-feat-windsurf-global-scope-support-plan.md
│ │ ├── 2026-03-01-feat-ce-command-aliases-backwards-compatible-deprecation-plan.md
│ │ ├── 2026-03-01-fix-setup-skill-non-claude-llm-fallback-plan.md
│ │ ├── 2026-03-03-feat-sync-claude-mcp-all-supported-providers-plan.md
│ │ ├── 2026-03-15-001-feat-ce-ideate-skill-plan.md
│ │ ├── 2026-03-16-001-feat-issue-grounded-ideation-plan.md
│ │ ├── 2026-03-17-001-feat-release-automation-migration-beta-plan.md
│ │ ├── 2026-03-18-001-feat-auto-memory-integration-beta-plan.md
│ │ ├── 2026-03-22-001-feat-frontend-design-skill-rewrite-beta-plan.md
│ │ ├── 2026-03-23-001-feat-ce-review-beta-pipeline-mode-beta-plan.md
│ │ ├── 2026-03-23-001-feat-plan-review-personas-beta-plan.md
│ │ ├── 2026-03-23-001-feat-promote-plan-beta-skills-to-stable-plan.md
│ │ ├── 2026-03-25-001-feat-onboarding-skill-plan.md
│ │ ├── 2026-03-25-002-refactor-config-storage-redesign-plan.md
│ │ ├── 2026-03-26-001-feat-adversarial-review-agents-plan.md
│ │ ├── 2026-03-26-001-refactor-merge-deepen-into-plan.md
│ │ ├── 2026-03-27-001-refactor-ce-skill-prefix-rename-plan.md
│ │ ├── 2026-03-28-001-feat-ce-review-headless-mode-plan.md
│ │ ├── 2026-03-29-001-feat-brainstorm-visual-aids-plan.md
│ │ ├── 2026-03-29-001-feat-iterative-optimization-loop-skill-beta-plan.md
│ │ ├── 2026-03-29-001-feat-testing-addressed-gate-plan.md
│ │ ├── 2026-03-29-002-feat-plan-visual-aids-plan.md
│ │ ├── 2026-03-29-002-feat-pr-feedback-clustering-plan.md
│ │ ├── 2026-03-29-003-feat-pr-description-visual-aids-plan.md
│ │ ├── 2026-03-30-001-feat-cli-readiness-review-persona-plan.md
│ │ ├── 2026-03-31-001-feat-codex-delegation-plan.md
│ │ ├── 2026-04-01-001-feat-cross-invocation-cluster-analysis-plan.md
│ │ ├── 2026-04-02-001-feat-slack-analyst-agent-plan.md
│ │ ├── 2026-04-05-001-feat-universal-planning-plan.md
│ │ ├── 2026-04-09-001-feat-ce-work-token-extraction-plan.md
│ │ ├── 2026-04-15-001-feat-ce-polish-skill-plan.md
│ │ ├── 2026-04-16-001-fix-ce-polish-beta-detection-gaps-plan.md
│ │ ├── 2026-04-17-001-feat-ce-ideate-mode-aware-v2-plan.md
│ │ ├── 2026-04-17-001-feat-ce-release-notes-skill-plan.md
│ │ ├── 2026-04-17-002-feat-ce-review-interactive-judgment-plan.md
│ │ ├── 2026-04-18-001-feat-ce-doc-review-autofix-and-interaction-overhaul-plan.md
│ │ ├── 2026-04-18-001-refactor-native-install-cleanup-plan.md
│ │ ├── 2026-04-20-001-feat-codex-native-plugin-manifests-plan.md
│ │ ├── 2026-04-20-001-fix-ce-compound-yaml-safety-plan.md
│ │ ├── 2026-04-21-001-feat-ce-plan-traceability-loop-plan.md
│ │ ├── 2026-04-21-001-refactor-ce-doc-review-anchored-confidence-scoring-plan.md
│ │ ├── 2026-04-21-002-refactor-ce-code-review-precision-and-validation-plan.md
│ │ ├── 2026-04-22-001-feat-demo-reel-local-save-plan.md
│ │ ├── 2026-04-25-001-fix-ce-code-review-lfg-defer-bias-plan.md
│ │ ├── 2026-04-26-feat-surface-scope-earlier-plan.md
│ │ ├── 2026-05-08-001-fix-ce-sessions-orchestration-refactor-plan.md
│ │ ├── 2026-05-11-001-feat-output-html-mode-plan.md
│ │ ├── 2026-06-02-001-feat-ce-code-review-safe-autofix-plan.md
│ │ ├── 2026-06-04-001-feat-ce-plan-approach-altitude-plan.md
│ │ ├── 2026-06-18-001-refactor-unified-plan-doc-artifact-plan.md
│ │ ├── 2026-06-22-001-feat-antigravity-target-remove-gemini-plan.md
│ │ ├── 2026-06-26-001-chore-remove-ce-work-beta-plan.html
│ │ ├── 2026-06-28-001-feat-ce-pov-skill-plan.md
│ │ ├── 2026-06-29-001-feat-shared-repo-grounding-cache-plan.md
│ │ ├── 2026-07-02-001-feat-ce-sweep-skill-plan.md
│ │ ├── 2026-07-02-002-feat-ce-explain-skill-plan.md
│ │ ├── 2026-07-05-001-feat-devin-cli-native-plugin-support-plan.md
│ │ ├── 2026-07-07-001-feat-pr-concept-teaching-plan.md
│ │ ├── 2026-07-08-001-fix-model-alias-map-latest-generations-plan.md
│ │ ├── 2026-07-09-001-feat-grok-plugin-support-plan.md
│ │ ├── 2026-07-09-001-fix-ce-test-browser-native-driver-plan.md
│ │ ├── 2026-07-09-002-feat-claude-code-fable-elevation-plan.md
│ │ ├── 2026-07-09-003-feat-doc-review-cross-model-plan.md
│ │ ├── 2026-07-11-001-feat-babysit-self-initiating-loop-plan.md
│ │ ├── 2026-07-13-001-feat-code-review-line-provenance-plan.md
│ │ ├── 2026-07-13-001-fix-ce-proof-v3-owner-lifecycle-plan.md
│ │ ├── 2026-07-13-002-feat-code-review-cross-model-provider-port-plan.md
│ │ ├── 2026-07-14-001-feat-session-settled-decisions-plan.md
│ │ ├── 2026-07-14-001-fix-detached-peer-job-lifecycle-plan.md
│ │ ├── babysit-non-convergence-detection.md
│ │ ├── feature_opencode-commands-as-md-and-config-merge.md
│ │ └── pipeline-mode-contract-and-lfg-babysit-consolidation.md
│ ├── residual-review-findings/
│ │ └── feat-ce-explain-skill.md
│ ├── skills/
│ │ ├── README.md
│ │ ├── ce-babysit-pr.md
│ │ ├── ce-brainstorm.md
│ │ ├── ce-code-review.md
│ │ ├── ce-commit-push-pr.md
│ │ ├── ce-commit.md
│ │ ├── ce-compound-refresh.md
│ │ ├── ce-compound.md
│ │ ├── ce-debug.md
│ │ ├── ce-doc-review.md
│ │ ├── ce-dogfood.md
│ │ ├── ce-explain.md
│ │ ├── ce-ideate.md
│ │ ├── ce-optimize.md
│ │ ├── ce-plan.md
│ │ ├── ce-polish.md
│ │ ├── ce-pov.md
│ │ ├── ce-product-pulse.md
│ │ ├── ce-promote.md
│ │ ├── ce-proof.md
│ │ ├── ce-resolve-pr-feedback.md
│ │ ├── ce-riffrec-feedback-analysis.md
│ │ ├── ce-setup.md
│ │ ├── ce-simplify-code.md
│ │ ├── ce-strategy.md
│ │ ├── ce-sweep.md
│ │ ├── ce-test-browser.md
│ │ ├── ce-test-xcode.md
│ │ ├── ce-work.md
│ │ ├── ce-worktree.md
│ │ └── lfg.md
│ ├── solutions/
│ │ ├── adding-converter-target-providers.md
│ │ ├── agent-friendly-cli-principles.md
│ │ ├── architecture-patterns/
│ │ │ └── host-native-browser-driver-selection.md
│ │ ├── best-practices/
│ │ │ ├── cache-invalidation-input-set-completeness.md
│ │ │ ├── ce-pipeline-end-to-end-learnings.md
│ │ │ ├── codex-delegation-best-practices.md
│ │ │ ├── conditional-visual-aids-in-generated-documents.md
│ │ │ ├── predictable-tmp-cache-ownership-check.md
│ │ │ ├── prefer-python-over-bash-for-pipeline-scripts.md
│ │ │ └── preserve-user-content-across-all-destructive-paths.md
│ │ ├── codex-skill-prompt-entrypoints.md
│ │ ├── conventions/
│ │ │ └── antigravity-target-empirical-format-verification.md
│ │ ├── developer-experience/
│ │ │ └── branch-based-plugin-install-and-testing.md
│ │ ├── integrations/
│ │ │ ├── colon-namespaced-names-break-windows-paths.md
│ │ │ ├── cross-platform-model-field-normalization.md
│ │ │ ├── kimi-native-plugin-manifest-support.md
│ │ │ ├── native-plugin-install-strategy.md
│ │ │ └── opencode-temperature-rejected-by-sonnet5-opus48.md
│ │ ├── plugin-versioning-requirements.md
│ │ ├── skill-design/
│ │ │ ├── arguments-token-is-claude-only-in-skill-bodies.md
│ │ │ ├── authoring-auto-invoke-standing-instructions.md
│ │ │ ├── beta-promotion-cleanup-registry-wiring.md
│ │ │ ├── beta-promotion-orchestration-contract.md
│ │ │ ├── beta-skills-framework.md
│ │ │ ├── bundled-script-path-resolution-across-harnesses.md
│ │ │ ├── ce-doc-review-calibration-patterns.md
│ │ │ ├── ce-prefix-required-for-skills-and-agents.md
│ │ │ ├── compound-refresh-skill-improvements.md
│ │ │ ├── confidence-anchored-scoring.md
│ │ │ ├── cross-harness-cross-model-tool-invocation.md
│ │ │ ├── cross-skill-shared-cache-primitive.md
│ │ │ ├── detached-job-lifecycle-for-delegated-work.md
│ │ │ ├── discoverability-check-for-documented-solutions.md
│ │ │ ├── fake-cli-harness-for-skill-judgment-evals.md
│ │ │ ├── frontier-model-skill-modernization-methodology.md
│ │ │ ├── git-workflow-skills-need-explicit-state-machines.md
│ │ │ ├── no-load-time-pre-resolution-for-fallible-context.md
│ │ │ ├── paired-old-vs-new-injection-skill-evals.md
│ │ │ ├── pass-paths-not-content-to-subagents.md
│ │ │ ├── portable-agent-skill-authoring.md
│ │ │ ├── post-menu-routing-belongs-inline.md
│ │ │ ├── requested-vs-verified-model-identity.md
│ │ │ ├── research-agent-pipeline-separation.md
│ │ │ ├── safe-auto-rubric-calibration.md
│ │ │ ├── script-first-skill-architecture.md
│ │ │ ├── strong-models-mask-defensive-skill-fixes.md
│ │ │ └── watch-loops-need-a-blocked-external-terminal-state.md
│ │ └── workflow/
│ │ ├── manual-release-please-github-releases.md
│ │ ├── release-please-version-drift-recovery.md
│ │ └── stale-local-base-contamination.md
│ └── specs/
│ ├── antigravity.md
│ ├── claude-code.md
│ ├── cline.md
│ ├── codex.md
│ ├── copilot.md
│ ├── cursor.md
│ ├── devin.md
│ ├── kimi.md
│ ├── kiro.md
│ └── opencode.md
├── package.json
├── plugin.json
├── scripts/
│ └── release/
│ ├── preview.ts
│ ├── sync-metadata.ts
│ └── validate.ts
├── skills/
│ ├── ce-babysit-pr/
│ │ ├── SKILL.md
│ │ ├── references/
│ │ │ └── watch-loop.md
│ │ └── scripts/
│ │ └── pr-snapshot
│ ├── ce-brainstorm/
│ │ ├── SKILL.md
│ │ ├── references/
│ │ │ ├── agents/
│ │ │ │ ├── repo-profiler.md
│ │ │ │ └── slack-researcher.md
│ │ │ ├── blindspot-pass.md
│ │ │ ├── brainstorm-sections.md
│ │ │ ├── handoff.md
│ │ │ ├── html-rendering.md
│ │ │ ├── markdown-rendering.md
│ │ │ ├── model-tiers.md
│ │ │ ├── product-pressure-test.md
│ │ │ ├── reasoning-elevation.md
│ │ │ ├── repo-profile-cache.md
│ │ │ ├── settled-decisions.md
│ │ │ ├── synthesis-summary.md
│ │ │ ├── universal-brainstorming.md
│ │ │ ├── verdict-routing.md
│ │ │ └── visual-probes.md
│ │ └── scripts/
│ │ ├── repo-profile-cache.py
│ │ └── visual-probe-server.js
│ ├── ce-code-review/
│ │ ├── SKILL.md
│ │ ├── references/
│ │ │ ├── action-class-rubric.md
│ │ │ ├── agents/
│ │ │ │ └── repo-profiler.md
│ │ │ ├── cross-model-review.md
│ │ │ ├── diff-scope.md
│ │ │ ├── findings-schema.json
│ │ │ ├── persona-catalog.md
│ │ │ ├── personas/
│ │ │ │ ├── adversarial-reviewer.md
│ │ │ │ ├── agent-native-reviewer.md
│ │ │ │ ├── api-contract-reviewer.md
│ │ │ │ ├── correctness-reviewer.md
│ │ │ │ ├── data-migration-reviewer.md
│ │ │ │ ├── deployment-verification-agent.md
│ │ │ │ ├── julik-frontend-races-reviewer.md
│ │ │ │ ├── learnings-researcher.md
│ │ │ │ ├── maintainability-reviewer.md
│ │ │ │ ├── performance-reviewer.md
│ │ │ │ ├── previous-comments-reviewer.md
│ │ │ │ ├── project-standards-reviewer.md
│ │ │ │ ├── reliability-reviewer.md
│ │ │ │ ├── security-reviewer.md
│ │ │ │ ├── swift-ios-reviewer.md
│ │ │ │ └── testing-reviewer.md
│ │ │ ├── repo-profile-cache.md
│ │ │ ├── review-output-template.md
│ │ │ ├── subagent-template.md
│ │ │ └── validator-template.md
│ │ └── scripts/
│ │ ├── cross-model-adversarial-review.sh
│ │ ├── peer-job-runner.py
│ │ └── repo-profile-cache.py
│ ├── ce-commit/
│ │ └── SKILL.md
│ ├── ce-commit-push-pr/
│ │ ├── SKILL.md
│ │ └── references/
│ │ ├── branch-creation.md
│ │ └── pr-description-writing.md
│ ├── ce-compound/
│ │ ├── SKILL.md
│ │ ├── assets/
│ │ │ └── resolution-template.md
│ │ ├── references/
│ │ │ ├── agents/
│ │ │ │ ├── best-practices-researcher.md
│ │ │ │ ├── data-integrity-guardian.md
│ │ │ │ ├── framework-docs-researcher.md
│ │ │ │ ├── pattern-recognition-specialist.md
│ │ │ │ ├── performance-oracle.md
│ │ │ │ ├── repo-profiler.md
│ │ │ │ ├── security-sentinel.md
│ │ │ │ └── session-historian.md
│ │ │ ├── concepts-vocabulary.md
│ │ │ ├── grounding-validation.md
│ │ │ ├── repo-profile-cache.md
│ │ │ ├── schema.yaml
│ │ │ └── yaml-schema.md
│ │ └── scripts/
│ │ ├── repo-profile-cache.py
│ │ ├── session-history/
│ │ │ ├── discover-sessions.sh
│ │ │ ├── extract-errors.py
│ │ │ ├── extract-metadata.py
│ │ │ └── extract-skeleton.py
│ │ ├── validate-doc-claims.py
│ │ └── validate-frontmatter.py
│ ├── ce-compound-refresh/
│ │ ├── SKILL.md
│ │ ├── assets/
│ │ │ └── resolution-template.md
│ │ ├── references/
│ │ │ ├── concepts-vocabulary.md
│ │ │ ├── per-action-flows.md
│ │ │ ├── schema.yaml
│ │ │ └── yaml-schema.md
│ │ └── scripts/
│ │ ├── validate-doc-claims.py
│ │ └── validate-frontmatter.py
│ ├── ce-debug/
│ │ ├── SKILL.md
│ │ ├── references/
│ │ │ ├── agents/
│ │ │ │ └── repo-profiler.md
│ │ │ ├── anti-patterns.md
│ │ │ ├── defense-in-depth.md
│ │ │ ├── investigation-techniques.md
│ │ │ ├── pipeline-mode.md
│ │ │ └── repo-profile-cache.md
│ │ └── scripts/
│ │ └── repo-profile-cache.py
│ ├── ce-doc-review/
│ │ ├── SKILL.md
│ │ ├── references/
│ │ │ ├── bulk-preview.md
│ │ │ ├── cross-model-eval.md
│ │ │ ├── cross-model-review.md
│ │ │ ├── findings-schema.json
│ │ │ ├── open-questions-defer.md
│ │ │ ├── personas/
│ │ │ │ ├── adversarial-document-reviewer.md
│ │ │ │ ├── coherence-reviewer.md
│ │ │ │ ├── design-lens-reviewer.md
│ │ │ │ ├── feasibility-reviewer.md
│ │ │ │ ├── product-lens-reviewer.md
│ │ │ │ ├── scope-guardian-reviewer.md
│ │ │ │ ├── security-lens-reviewer.md
│ │ │ │ └── whole-doc-reviewer.md
│ │ │ ├── review-output-template.md
│ │ │ ├── subagent-template.md
│ │ │ ├── synthesis-and-presentation.md
│ │ │ └── walkthrough.md
│ │ └── scripts/
│ │ ├── cross-model-doc-review.sh
│ │ └── peer-job-runner.py
│ ├── ce-dogfood/
│ │ ├── SKILL.md
│ │ └── references/
│ │ ├── dogfood-report-template.md
│ │ └── test-matrix-taxonomy.md
│ ├── ce-explain/
│ │ ├── SKILL.md
│ │ ├── references/
│ │ │ ├── agents/
│ │ │ │ ├── repo-profiler.md
│ │ │ │ └── work-recap-scout.md
│ │ │ ├── check-in.md
│ │ │ ├── destinations.md
│ │ │ ├── explainer-html.md
│ │ │ ├── explainer-markdown.md
│ │ │ ├── intake.md
│ │ │ └── repo-profile-cache.md
│ │ └── scripts/
│ │ └── repo-profile-cache.py
│ ├── ce-ideate/
│ │ ├── SKILL.md
│ │ ├── references/
│ │ │ ├── agents/
│ │ │ │ ├── issue-intelligence-analyst.md
│ │ │ │ ├── learnings-researcher.md
│ │ │ │ ├── repo-profiler.md
│ │ │ │ ├── slack-researcher.md
│ │ │ │ └── web-researcher.md
│ │ │ ├── divergent-ideation.md
│ │ │ ├── html-rendering.md
│ │ │ ├── ideation-sections.md
│ │ │ ├── markdown-rendering.md
│ │ │ ├── post-ideation-workflow.md
│ │ │ ├── repo-profile-cache.md
│ │ │ ├── universal-ideation.md
│ │ │ └── web-research-cache.md
│ │ └── scripts/
│ │ └── repo-profile-cache.py
│ ├── ce-optimize/
│ │ ├── SKILL.md
│ │ ├── references/
│ │ │ ├── agents/
│ │ │ │ ├── learnings-researcher.md
│ │ │ │ ├── repo-profiler.md
│ │ │ │ └── repo-research-analyst.md
│ │ │ ├── example-hard-spec.yaml
│ │ │ ├── example-judge-spec.yaml
│ │ │ ├── experiment-log-schema.yaml
│ │ │ ├── experiment-prompt-template.md
│ │ │ ├── judge-prompt-template.md
│ │ │ ├── optimize-spec-schema.yaml
│ │ │ ├── repo-profile-cache.md
│ │ │ └── usage-guide.md
│ │ └── scripts/
│ │ ├── experiment-worktree.sh
│ │ ├── measure.sh
│ │ ├── parallel-probe.sh
│ │ └── repo-profile-cache.py
│ ├── ce-plan/
│ │ ├── SKILL.md
│ │ ├── references/
│ │ │ ├── agents/
│ │ │ │ ├── agent-native-planning-strategist.md
│ │ │ │ ├── architecture-strategist.md
│ │ │ │ ├── best-practices-researcher.md
│ │ │ │ ├── data-integrity-guardian.md
│ │ │ │ ├── data-migration-reviewer.md
│ │ │ │ ├── deployment-verification-agent.md
│ │ │ │ ├── framework-docs-researcher.md
│ │ │ │ ├── git-history-analyzer.md
│ │ │ │ ├── learnings-researcher.md
│ │ │ │ ├── pattern-recognition-specialist.md
│ │ │ │ ├── performance-oracle.md
│ │ │ │ ├── repo-profiler.md
│ │ │ │ ├── repo-research-analyst.md
│ │ │ │ ├── security-sentinel.md
│ │ │ │ ├── slack-researcher.md
│ │ │ │ ├── spec-flow-analyzer.md
│ │ │ │ └── web-researcher.md
│ │ │ ├── approach-altitude.md
│ │ │ ├── deepening-workflow.md
│ │ │ ├── html-rendering.md
│ │ │ ├── markdown-rendering.md
│ │ │ ├── plan-handoff.md
│ │ │ ├── plan-sections.md
│ │ │ ├── reasoning-elevation.md
│ │ │ ├── repo-profile-cache.md
│ │ │ ├── settled-decisions.md
│ │ │ ├── synthesis-summary.md
│ │ │ └── universal-planning.md
│ │ └── scripts/
│ │ └── repo-profile-cache.py
│ ├── ce-polish/
│ │ ├── SKILL.md
│ │ ├── references/
│ │ │ ├── dev-server-astro.md
│ │ │ ├── dev-server-detection.md
│ │ │ ├── dev-server-next.md
│ │ │ ├── dev-server-nuxt.md
│ │ │ ├── dev-server-procfile.md
│ │ │ ├── dev-server-rails.md
│ │ │ ├── dev-server-remix.md
│ │ │ ├── dev-server-sveltekit.md
│ │ │ ├── dev-server-vite.md
│ │ │ ├── ide-detection.md
│ │ │ └── launch-json-schema.md
│ │ └── scripts/
│ │ ├── detect-project-type.sh
│ │ ├── read-launch-json.sh
│ │ ├── resolve-package-manager.sh
│ │ └── resolve-port.sh
│ ├── ce-pov/
│ │ ├── SKILL.md
│ │ ├── references/
│ │ │ ├── agents/
│ │ │ │ ├── external-evidence-researcher.md
│ │ │ │ ├── precedent-activity-scout.md
│ │ │ │ ├── project-grounding-scout.md
│ │ │ │ └── repo-profiler.md
│ │ │ ├── boundaries.md
│ │ │ ├── intake.md
│ │ │ ├── invocation.md
│ │ │ ├── method.md
│ │ │ ├── repo-profile-cache.md
│ │ │ └── report.md
│ │ └── scripts/
│ │ └── repo-profile-cache.py
│ ├── ce-product-pulse/
│ │ ├── SKILL.md
│ │ └── references/
│ │ ├── interview.md
│ │ └── report-template.md
│ ├── ce-promote/
│ │ ├── SKILL.md
│ │ └── references/
│ │ └── spiral-cli.md
│ ├── ce-proof/
│ │ └── SKILL.md
│ ├── ce-resolve-pr-feedback/
│ │ ├── SKILL.md
│ │ ├── references/
│ │ │ ├── agents/
│ │ │ │ └── pr-comment-resolver.md
│ │ │ ├── evaluation-rubric.md
│ │ │ ├── full-mode.md
│ │ │ └── targeted-mode.md
│ │ └── scripts/
│ │ ├── get-pr-comments
│ │ ├── get-thread-for-comment
│ │ ├── reply-to-pr-thread
│ │ └── resolve-pr-thread
│ ├── ce-riffrec-feedback-analysis/
│ │ ├── SKILL.md
│ │ ├── references/
│ │ │ ├── compound-engineering-feedback-format.md
│ │ │ ├── extensive-analysis.md
│ │ │ ├── install-riffrec.md
│ │ │ └── quick-bug-report.md
│ │ └── scripts/
│ │ └── analyze_riffrec_zip.py
│ ├── ce-setup/
│ │ ├── SKILL.md
│ │ ├── references/
│ │ │ └── config-template.yaml
│ │ └── scripts/
│ │ └── check-health
│ ├── ce-simplify-code/
│ │ ├── SKILL.md
│ │ └── references/
│ │ └── personas/
│ │ ├── code-quality-reviewer.md
│ │ ├── code-reuse-reviewer.md
│ │ └── efficiency-reviewer.md
│ ├── ce-strategy/
│ │ ├── SKILL.md
│ │ └── references/
│ │ ├── interview.md
│ │ └── strategy-template.md
│ ├── ce-sweep/
│ │ ├── SKILL.md
│ │ ├── references/
│ │ │ ├── agents/
│ │ │ │ └── media-analyzer.md
│ │ │ ├── interview.md
│ │ │ ├── model-tiers.md
│ │ │ ├── plan-template.md
│ │ │ ├── sources/
│ │ │ │ ├── email.md
│ │ │ │ ├── github-issues.md
│ │ │ │ └── slack.md
│ │ │ ├── state-schema.md
│ │ │ └── subagent-template.md
│ │ └── scripts/
│ │ ├── analyze_riffrec_zip.py
│ │ └── sweep-state.py
│ ├── ce-test-browser/
│ │ ├── SKILL.md
│ │ └── references/
│ │ ├── agent-browser-driver.md
│ │ └── pipeline-orchestration.md
│ ├── ce-test-xcode/
│ │ └── SKILL.md
│ ├── ce-work/
│ │ ├── SKILL.md
│ │ └── references/
│ │ ├── agents/
│ │ │ └── figma-design-sync.md
│ │ ├── execution-engines.md
│ │ ├── non-code-execution.md
│ │ ├── review-findings-followup.md
│ │ ├── shipping-workflow.md
│ │ └── tracker-defer.md
│ ├── ce-worktree/
│ │ └── SKILL.md
│ └── lfg/
│ ├── SKILL.md
│ └── references/
│ ├── review-followup.md
│ └── tracker-defer.md
├── src/
│ ├── commands/
│ │ ├── cleanup.ts
│ │ ├── convert.ts
│ │ ├── install.ts
│ │ ├── list.ts
│ │ └── plugin-path.ts
│ ├── converters/
│ │ ├── claude-to-antigravity.ts
│ │ ├── claude-to-codex.ts
│ │ ├── claude-to-copilot.ts
│ │ ├── claude-to-droid.ts
│ │ ├── claude-to-kiro.ts
│ │ ├── claude-to-opencode.ts
│ │ └── claude-to-pi.ts
│ ├── data/
│ │ └── plugin-legacy-artifacts.ts
│ ├── index.ts
│ ├── parsers/
│ │ └── claude.ts
│ ├── release/
│ │ ├── components.ts
│ │ ├── config.ts
│ │ ├── metadata.ts
│ │ └── types.ts
│ ├── targets/
│ │ ├── antigravity.ts
│ │ ├── codex.ts
│ │ ├── index.ts
│ │ ├── kiro.ts
│ │ ├── managed-artifacts.ts
│ │ ├── opencode.ts
│ │ └── pi.ts
│ ├── types/
│ │ ├── antigravity.ts
│ │ ├── claude.ts
│ │ ├── codex.ts
│ │ ├── copilot.ts
│ │ ├── droid.ts
│ │ ├── kiro.ts
│ │ ├── opencode.ts
│ │ └── pi.ts
│ └── utils/
│ ├── codex-agents.ts
│ ├── codex-content.ts
│ ├── detect-tools.ts
│ ├── files.ts
│ ├── frontmatter.ts
│ ├── json-config.ts
│ ├── legacy-cleanup.ts
│ ├── model.ts
│ ├── opencode-config.ts
│ ├── resolve-home.ts
│ ├── resolve-output.ts
│ ├── secrets.ts
│ └── symlink.ts
├── tests/
│ ├── antigravity-converter.test.ts
│ ├── antigravity-writer.test.ts
│ ├── ce-babysit-pr-contract.test.ts
│ ├── ce-babysit-pr-snapshot.test.ts
│ ├── ce-sweep-analyzer-parity.test.ts
│ ├── ce-test-browser-driver-policy.test.ts
│ ├── claude-parser.test.ts
│ ├── cli.test.ts
│ ├── cline-install-skills.test.ts
│ ├── codex-agents.test.ts
│ ├── codex-converter.test.ts
│ ├── codex-writer.test.ts
│ ├── commit-push-pr-contract.test.ts
│ ├── compound-support-files.test.ts
│ ├── converter.test.ts
│ ├── copilot-converter.test.ts
│ ├── cross-model-receipt-parity.test.ts
│ ├── detect-tools.test.ts
│ ├── doc-claims-validator.test.ts
│ ├── droid-converter.test.ts
│ ├── fixtures/
│ │ ├── ce-code-review-stable-numbering.md
│ │ ├── ce-doc-review/
│ │ │ ├── seeded-auth-plan.md
│ │ │ ├── seeded-feature-plan.md
│ │ │ └── seeded-plan.md
│ │ ├── custom-paths/
│ │ │ ├── .claude-plugin/
│ │ │ │ └── plugin.json
│ │ │ ├── agents/
│ │ │ │ └── default-agent.md
│ │ │ ├── commands/
│ │ │ │ └── default-command.md
│ │ │ ├── custom-agents/
│ │ │ │ └── custom-agent.md
│ │ │ ├── custom-commands/
│ │ │ │ └── custom-command.md
│ │ │ ├── custom-hooks/
│ │ │ │ └── hooks.json
│ │ │ ├── custom-skills/
│ │ │ │ └── custom-skill/
│ │ │ │ └── SKILL.md
│ │ │ ├── hooks/
│ │ │ │ └── hooks.json
│ │ │ └── skills/
│ │ │ └── default-skill/
│ │ │ └── SKILL.md
│ │ ├── invalid-command-path/
│ │ │ └── .claude-plugin/
│ │ │ └── plugin.json
│ │ ├── invalid-hooks-path/
│ │ │ └── .claude-plugin/
│ │ │ └── plugin.json
│ │ ├── invalid-mcp-path/
│ │ │ └── .claude-plugin/
│ │ │ └── plugin.json
│ │ ├── mcp-file/
│ │ │ ├── .claude-plugin/
│ │ │ │ └── plugin.json
│ │ │ └── .mcp.json
│ │ ├── peer-job-runner-unit.py
│ │ ├── sample-plugin/
│ │ │ ├── .claude-plugin/
│ │ │ │ └── plugin.json
│ │ │ ├── agents/
│ │ │ │ ├── agent-one.md
│ │ │ │ └── security-reviewer.md
│ │ │ ├── commands/
│ │ │ │ ├── command-one.md
│ │ │ │ ├── disabled-command.md
│ │ │ │ ├── model-command.md
│ │ │ │ ├── nested/
│ │ │ │ │ └── command-two.md
│ │ │ │ ├── pattern-command.md
│ │ │ │ ├── skill-command.md
│ │ │ │ └── todo-command.md
│ │ │ ├── hooks/
│ │ │ │ └── hooks.json
│ │ │ └── skills/
│ │ │ ├── agent-only-skill/
│ │ │ │ └── SKILL.md
│ │ │ ├── claude-only-skill/
│ │ │ │ └── SKILL.md
│ │ │ ├── disabled-skill/
│ │ │ │ └── SKILL.md
│ │ │ └── skill-one/
│ │ │ └── SKILL.md
│ │ └── session-history/
│ │ ├── claude-session.jsonl
│ │ ├── codex-session.jsonl
│ │ ├── cursor-session.jsonl
│ │ └── pi-session.jsonl
│ ├── frontmatter-validator.test.ts
│ ├── frontmatter.test.ts
│ ├── gpt-5-6-skill-migration.test.ts
│ ├── kiro-converter.test.ts
│ ├── kiro-writer.test.ts
│ ├── legacy-cleanup.test.ts
│ ├── legacy-registry-invariants.test.ts
│ ├── manifest-path-safety.test.ts
│ ├── model-utils.test.ts
│ ├── opencode-writer.test.ts
│ ├── path-sanitization.test.ts
│ ├── peer-job-runner-parity.test.ts
│ ├── pi-converter.test.ts
│ ├── pi-writer.test.ts
│ ├── pipeline-review-contract.test.ts
│ ├── plugin-legacy-artifacts.test.ts
│ ├── plugin-path.test.ts
│ ├── real-plugin-conversion.test.ts
│ ├── reasoning-elevation-parity.test.ts
│ ├── release-components.test.ts
│ ├── release-config.test.ts
│ ├── release-metadata.test.ts
│ ├── release-preview.test.ts
│ ├── repo-profile-cache-parity.test.ts
│ ├── repo-profile-cache.test.ts
│ ├── resolve-home.test.ts
│ ├── resolve-output.test.ts
│ ├── resolve-pr-feedback-pagination.test.ts
│ ├── review-skill-contract.test.ts
│ ├── session-history-scripts.test.ts
│ ├── settled-decisions-parity.test.ts
│ ├── skill-agent-ce-prefix.test.ts
│ ├── skill-conventions.test.ts
│ ├── skill-shell-safety.test.ts
│ ├── skills/
│ │ ├── ce-brainstorm-output-mode.test.ts
│ │ ├── ce-brainstorm-section-order.test.ts
│ │ ├── ce-brainstorm-visual-probe-server.test.ts
│ │ ├── ce-brainstorm-visual-probes.test.ts
│ │ ├── ce-code-review-cross-model-routes.test.ts
│ │ ├── ce-compound-readonly-enhancement.test.ts
│ │ ├── ce-doc-review-cross-model-routes.test.ts
│ │ ├── ce-explain-routing.test.ts
│ │ ├── ce-ideate-output-mode.test.ts
│ │ ├── ce-plan-handoff-routing.test.ts
│ │ ├── ce-plan-output-mode.test.ts
│ │ ├── ce-polish-dev-server.test.ts
│ │ ├── ce-polish-package-manager.test.ts
│ │ ├── ce-polish-project-type.test.ts
│ │ ├── ce-polish-resolve-port.test.ts
│ │ ├── ce-proof-contract.test.ts
│ │ ├── ce-resolve-pr-feedback-script-dir.test.ts
│ │ ├── ce-session-historian-no-skill-tool.test.ts
│ │ ├── ce-setup-check-health.test.ts
│ │ ├── ce-sweep-source-contract.test.ts
│ │ ├── ce-worktree.test.ts
│ │ ├── fenced-blocks.ts
│ │ ├── flatten-safety.test.ts
│ │ ├── html-output-invariants.test.ts
│ │ ├── peer-job-runner.test.ts
│ │ └── unified-plan-artifact-contract.test.ts
│ └── sweep-state.test.ts
└── tsconfig.json
================================================
FILE CONTENTS
================================================
================================================
FILE: .agents/plugins/marketplace.json
================================================
{
"name": "compound-engineering-plugin",
"interface": {
"displayName": "Compound Engineering"
},
"plugins": [
{
"name": "compound-engineering",
"source": {
"source": "url",
"url": "https://github.com/EveryInc/compound-engineering-plugin.git"
},
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "Coding"
}
]
}
================================================
FILE: .agy/INSTALL.md
================================================
# Installing Compound Engineering for Antigravity CLI (`agy`)
Antigravity installs CE as a native plugin bundle. The repository root is the plugin package: `plugin.json` plus the `skills/` directory. The committed `.agy/` subdirectory is a compatibility entry point for local checkouts that prefer an explicit bundle path.
## One-command install (recommended)
With [Antigravity CLI](https://antigravity.google) installed:
```bash
agy plugin install https://github.com/EveryInc/compound-engineering-plugin
```
Verify:
```bash
agy plugin list
agy plugin validate https://github.com/EveryInc/compound-engineering-plugin
```
No clone step is required. `agy` stages the plugin under `~/.gemini/antigravity-cli/plugins/compound-engineering/`.
## Local checkout install
Clone first when you need a specific branch, tag, or unpublished changes:
```bash
git clone https://github.com/EveryInc/compound-engineering-plugin
agy plugin install ./compound-engineering-plugin
```
Or install the bundled `.agy/` entry point (equivalent manifest via symlink):
```bash
agy plugin install ./compound-engineering-plugin/.agy
```
## Pin a release
Install from a release tag:
```bash
git clone --branch compound-engineering-vX.Y.Z --depth 1 \
https://github.com/EveryInc/compound-engineering-plugin.git
agy plugin install ./compound-engineering-plugin
```
Replace `X.Y.Z` with a tag from the [releases page](https://github.com/EveryInc/compound-engineering-plugin/releases).
## Local development
From your working copy:
```bash
agy plugin install "$PWD"
agy plugin validate "$PWD"
```
Edit skills under `skills/` and restart `agy` or start a new session to pick up prose changes.
## Context files
`agy` reads `GEMINI.md` and `AGENTS.md` as workspace context. Run `agy` from a project that includes those files, or from this checkout when developing CE itself.
## Uninstall
```bash
agy plugin uninstall compound-engineering
```
## Legacy Gemini CLI import
If you previously installed CE under Gemini CLI:
```bash
agy plugin import gemini
```
Prefer the native install commands above for new setups.
================================================
FILE: .claude/commands/triage-prs.md
================================================
---
name: triage-prs
description: Triage all open PRs with parallel agents, label, group, and review one-by-one
argument-hint: "[optional: repo owner/name or GitHub PRs URL]"
disable-model-invocation: true
allowed-tools: Bash(gh *), Bash(git log *)
---
# Triage Open Pull Requests
Review, label, and act on all open PRs for a repository using parallel review agents. Produces a grouped triage report, applies labels, cross-references with issues, and walks through each PR for merge/comment decisions.
## Step 0: Detect Repository
Detect repo context:
- Current repo: !`gh repo view --json nameWithOwner -q .nameWithOwner 2>/dev/null || echo "no repo detected"`
- Current branch: !`git branch --show-current 2>/dev/null`
If `$ARGUMENTS` contains a GitHub URL or `owner/repo`, use that instead. Confirm the repo with the user if ambiguous.
## Step 1: Gather Context (Parallel)
Run these in parallel:
1. **List all open PRs:**
```bash
gh pr list --repo OWNER/REPO --state open --limit 50
```
2. **List all open issues:**
```bash
gh issue list --repo OWNER/REPO --state open --limit 50
```
3. **List existing labels:**
```bash
gh label list --repo OWNER/REPO --limit 50
```
4. **Check recent merges** (to detect duplicate/superseded PRs):
```bash
git log --oneline -20 main
```
## Step 2: Batch PRs by Theme
Group PRs into review batches of 4-6 based on apparent type:
- **Bug fixes** - titles with `fix`, `bug`, error descriptions
- **Features** - titles with `feat`, `add`, new functionality
- **Documentation** - titles with `docs`, `readme`, terminology
- **Configuration/Setup** - titles with `config`, `setup`, `install`
- **Stale/Old** - PRs older than 30 days
## Step 3: Parallel Review (Team of Agents)
Spawn one review agent per batch using the Task tool. Each agent should:
For each PR in their batch:
1. Run `gh pr view --repo OWNER/REPO <number> --json title,body,files,additions,deletions,author,createdAt`
2. Run `gh pr diff --repo OWNER/REPO <number>` (pipe to `head -200` for large diffs)
3. Determine:
- **Description:** 1-2 sentence summary of the change
- **Label:** Which existing repo label fits best
- **Action:** merge / request changes / close / needs discussion
- **Related PRs:** Any PRs in this or other batches that touch the same files or feature
- **Quality notes:** Code quality, test coverage, staleness concerns
Instruct each agent to:
- Flag PRs that touch the same files (potential merge conflicts)
- Flag PRs that duplicate recently merged work
- Flag PRs that are part of a group solving the same problem differently
- Report findings as a markdown table
- Send findings back via message when done
## Step 4: Cross-Reference Issues
After all agents report, match issues to PRs:
- Check if any PR title/body mentions `Fixes #X` or `Closes #X`
- Check if any issue title matches a PR's topic
- Look for duplicate issues (same bug reported twice)
Build a mapping table:
```
| Issue | PR | Relationship |
|-------|-----|--------------|
| #158 | #159 | PR fixes issue |
```
## Step 5: Identify Themes
Group all issues into themes (3-6 themes):
- Count issues per theme
- Note which themes have PRs addressing them and which don't
- Flag themes with competing/overlapping PRs
## Step 6: Compile Triage Report
Present a single report with:
1. **Summary stats:** X open PRs, Y open issues, Z themes
2. **PR groups** with recommended actions:
- Group name and related PRs
- Per-PR: #, title, author, description, label, action
3. **Issue-to-PR mapping**
4. **Themes across issues**
5. **Suggested cleanup:** spam issues, duplicates, stale items
## Step 7: Apply Labels
After presenting the report, ask user:
> "Apply these labels to all PRs on GitHub?"
If yes, run `gh pr edit --repo OWNER/REPO <number> --add-label "<label>"` for each PR.
## Step 8: One-by-One Review
Use **AskUserQuestion** to ask:
> "Ready to walk through PRs one-by-one for merge/comment decisions?"
Then for each PR, ordered by priority (bug fixes first, then docs, then features, then stale):
### Show the PR:
```
### PR #<number> - <title>
Author: <author> | Files: <count> | +<additions>/-<deletions> | <age>
Label: <label>
<1-2 sentence description>
Fixes: <linked issues if any>
Related: <related PRs if any>
```
Show the diff (trimmed to key changes if large).
### Ask for decision:
Use **AskUserQuestion**:
- **Merge** - Merge this PR now
- **Comment & skip** - Leave a comment explaining why not merging, keep open
- **Close** - Close with a comment
- **Skip** - Move to next without action
### Execute decision:
- **Merge:** `gh pr merge --repo OWNER/REPO <number> --squash`
- If PR fixes an issue, close the issue too
- **Comment & skip:** `gh pr comment --repo OWNER/REPO <number> --body "<comment>"`
- Ask user what to say, or generate a grateful + specific comment
- **Close:** `gh pr close --repo OWNER/REPO <number> --comment "<reason>"`
- **Skip:** Move on
## Step 9: Post-Merge Cleanup
After all PRs are reviewed:
1. **Close resolved issues** that were fixed by merged PRs
2. **Close spam/off-topic issues** (confirm with user first)
3. **Summary of actions taken:**
```
## Triage Complete
Merged: X PRs
Commented: Y PRs
Closed: Z PRs
Skipped: W PRs
Issues closed: A
Labels applied: B
```
## Step 10: Post-Triage Options
Use **AskUserQuestion**:
1. **Run `/release-docs`** - Update documentation site if components changed
2. **Run `/changelog`** - Generate changelog for merged PRs
3. **Commit any local changes** - If version bumps needed
4. **Done** - Wrap up
## Important Notes
- **DO NOT merge without user approval** for each PR
- **DO NOT force push or destructive actions**
- Comments on declined PRs should be grateful and constructive
- When PRs conflict with each other, note this and suggest merge order
- When multiple PRs solve the same problem differently, flag for user to pick one
- Use Haiku model for review agents to save cost (they're doing read-only analysis)
================================================
FILE: .claude-plugin/CHANGELOG.md
================================================
# Changelog
## [1.0.3](https://github.com/EveryInc/compound-engineering-plugin/compare/marketplace-v1.0.2...marketplace-v1.0.3) (2026-06-24)
### Bug Fixes
* **metadata:** align plugin and marketplace metadata ([#987](https://github.com/EveryInc/compound-engineering-plugin/issues/987)) ([f57c682](https://github.com/EveryInc/compound-engineering-plugin/commit/f57c68257cbd792c25ef85047c426329c5c3f848))
================================================
FILE: .claude-plugin/marketplace.json
================================================
{
"name": "compound-engineering-plugin",
"owner": {
"name": "Kieran Klaassen and Trevin Chow"
},
"metadata": {
"description": "Plugin marketplace for Claude Code and Codex extensions",
"version": "1.0.3"
},
"plugins": [
{
"name": "compound-engineering",
"description": "Brainstorm, plan, debug, review, and compound learnings with AI agents",
"author": {
"name": "Kieran Klaassen and Trevin Chow"
},
"homepage": "https://github.com/EveryInc/compound-engineering-plugin",
"tags": [
"ai-powered",
"compound-engineering",
"workflow-automation",
"code-review",
"quality",
"knowledge-management"
],
"source": "./"
}
]
}
================================================
FILE: .claude-plugin/plugin.json
================================================
{
"name": "compound-engineering",
"version": "3.19.0",
"description": "Brainstorm, plan, debug, review, and compound learnings with AI agents",
"author": {
"name": "Kieran Klaassen and Trevin Chow"
},
"homepage": "https://every.to/source-code/my-ai-had-already-fixed-the-code-before-i-saw-it",
"repository": "https://github.com/EveryInc/compound-engineering-plugin",
"license": "MIT",
"keywords": [
"brainstorming",
"code-review",
"compound-engineering",
"debugging",
"ideation",
"workflows",
"workflow-automation"
]
}
================================================
FILE: .cline/INSTALL.md
================================================
# Installing Compound Engineering for Cline
Cline loads CE through native **skills** discovery — the same `SKILL.md` directories shipped in this repository's `skills/` folder. No Bun converter or generated copy step is required.
## Extension (VS Code, Cursor, JetBrains)
1. Install the [Cline extension](https://docs.cline.bot/getting-started/installing-cline) in your editor.
2. Enable **Settings -> Features -> Enable Skills**.
3. Link CE skills globally or into your project (see below).
4. Start a new Cline task. Skills such as `ce-brainstorm` and `ce-plan` appear when their descriptions match your request.
## Install skills
From a clone of this repository:
```bash
# Global (~/.cline/skills/) — available in every project
./compound-engineering-plugin/.cline/scripts/install-skills.sh --global
# Project (.cline/skills/ in the current directory)
./compound-engineering-plugin/.cline/scripts/install-skills.sh --project
```
The script creates symlinks so Cline reads the live skill directories from your checkout. Re-run it after `git pull` to refresh links when skill folder names change. It only ever creates or replaces CE-owned symlinks (links whose target resolves under this checkout's `skills/` tree); an existing `~/.cline/skills/<name>` pointing at your own skill, a fork, or another checkout is left untouched. Default installs also remove only manual-only symlinks that are CE-owned.
Skills marked `disable-model-invocation: true` (for example `ce-dogfood`, `ce-polish`, `ce-setup`) are **not** linked by default — Cline auto-activates from description matching and has no manual-only gate, so linking them would let them fire unintentionally. Those slash commands are unavailable until you opt in:
```bash
./compound-engineering-plugin/.cline/scripts/install-skills.sh --global --include-manual
```
`--include-manual` links manual-only skills so `/ce-polish` and similar commands work, with a warning that Cline may still auto-activate them when descriptions match. Omit the flag if you do not need those workflows on Cline.
## Pin a release
Clone the tag you want, then run the install script against that checkout:
```bash
git clone --branch compound-engineering-vX.Y.Z --depth 1 \
https://github.com/EveryInc/compound-engineering-plugin.git
./compound-engineering-plugin/.cline/scripts/install-skills.sh --global
```
Replace `X.Y.Z` with a tag from the [releases page](https://github.com/EveryInc/compound-engineering-plugin/releases).
## Local development
From your working copy:
```bash
/path/to/compound-engineering-plugin/.cline/scripts/install-skills.sh --global
```
Edit skills under `skills/` and start a new Cline task to pick up prose changes.
## Uninstall
Remove CE skill symlinks from `~/.cline/skills/` or `.cline/skills/`. Skill directory names match the folders under `skills/` (for example `ce-brainstorm`, `ce-plan`).
## Cline CLI
The Cline CLI supports separate `AgentPlugin` installs for custom tools and hooks. CE does not require a CLI plugin for its skills to work. Use the skills install script above when running Cline from the terminal.
================================================
FILE: .cline/scripts/install-skills.sh
================================================
#!/usr/bin/env bash
# Link Compound Engineering skills/ into Cline's skills discovery directory.
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
SKILLS_SRC="$REPO_ROOT/skills"
usage() {
cat <<'EOF'
Usage: install-skills.sh [--global | --project] [--include-manual]
--global Link skills into ~/.cline/skills/ (default)
--project Link skills into ./.cline/skills/ under the current directory
--include-manual Also link manual-only skills (disable-model-invocation: true).
Cline has no manual-only gate — linked manual skills may auto-activate.
Set CLINE_SKILLS_DIR to override the global destination.
EOF
exit 1
}
SCOPE="--global"
INCLUDE_MANUAL=false
while [[ $# -gt 0 ]]; do
case "$1" in
--global | --project)
SCOPE="$1"
shift
;;
--include-manual)
INCLUDE_MANUAL=true
shift
;;
*)
usage
;;
esac
done
if [[ "$SCOPE" == "--project" ]]; then
DEST="$(pwd)/.cline/skills"
else
DEST="${CLINE_SKILLS_DIR:-$HOME/.cline/skills}"
fi
if [[ ! -d "$SKILLS_SRC" ]]; then
echo "error: skills directory not found at $SKILLS_SRC" >&2
exit 1
fi
canonical_path() {
python3 -c 'import os, sys; print(os.path.realpath(sys.argv[1]))' "$1"
}
SKILLS_ROOT_CANON="$(canonical_path "$SKILLS_SRC")"
is_ce_owned_skill_link() {
local link_path="$1"
[[ -L "$link_path" ]] || return 1
local resolved
resolved="$(canonical_path "$link_path")"
[[ "$resolved" == "$SKILLS_ROOT_CANON/"* ]]
}
mkdir -p "$DEST"
linked=0
skipped=0
manual_omitted=0
manual_included=0
manual_removed=0
for skill_dir in "$SKILLS_SRC"/*/; do
[[ -f "${skill_dir}SKILL.md" ]] || continue
name="$(basename "$skill_dir")"
target="$DEST/$name"
is_manual=false
if grep -qE '^disable-model-invocation:[[:space:]]*true[[:space:]]*$' "${skill_dir}SKILL.md"; then
is_manual=true
if [[ "$INCLUDE_MANUAL" != "true" ]]; then
if is_ce_owned_skill_link "$target"; then
rm "$target"
echo "removed $name: stale CE manual-only symlink" >&2
manual_removed=$((manual_removed + 1))
fi
echo "skip $name: manual-only (disable-model-invocation)" >&2
manual_omitted=$((manual_omitted + 1))
continue
fi
echo "warn $name: manual-only skill linked — Cline may auto-activate when descriptions match" >&2
manual_included=$((manual_included + 1))
fi
if [[ -e "$target" && ! -L "$target" ]]; then
echo "skip $name: $target exists and is not a symlink" >&2
skipped=$((skipped + 1))
continue
fi
if [[ -L "$target" ]] && ! is_ce_owned_skill_link "$target"; then
echo "skip $name: $target is an existing user-managed symlink (not overwritten)" >&2
skipped=$((skipped + 1))
continue
fi
ln -sfn "$skill_dir" "$target"
if [[ "$is_manual" == "true" ]]; then
echo "linked $name (manual-only) -> $skill_dir"
else
echo "linked $name -> $skill_dir"
fi
linked=$((linked + 1))
done
if [[ "$INCLUDE_MANUAL" == "true" ]]; then
echo "done: $linked linked, $skipped skipped, $manual_included manual-only included (destination: $DEST)"
else
echo "done: $linked linked, $skipped skipped, $manual_omitted manual-only omitted, $manual_removed stale manual-only removed (destination: $DEST)"
fi
================================================
FILE: .codex-plugin/plugin.json
================================================
{
"name": "compound-engineering",
"version": "3.19.0",
"description": "Brainstorm, plan, debug, review, and compound learnings with AI agents",
"author": {
"name": "Kieran Klaassen and Trevin Chow"
},
"homepage": "https://every.to/source-code/my-ai-had-already-fixed-the-code-before-i-saw-it",
"repository": "https://github.com/EveryInc/compound-engineering-plugin",
"license": "MIT",
"keywords": [
"brainstorming",
"code-review",
"compound-engineering",
"debugging",
"ideation",
"workflows",
"workflow-automation"
],
"skills": "./skills/",
"interface": {
"displayName": "Compound Engineering",
"shortDescription": "Brainstorm, plan, debug, review, and compound learnings with AI agents",
"longDescription": "Compound Engineering guides AI agents through the full engineering loop: strategy, ideation, requirements, planning, execution, debugging, review, PR feedback, and captured learnings that make future work easier.",
"developerName": "Kieran Klaassen and Trevin Chow",
"category": "Coding",
"capabilities": [
"Interactive",
"Read",
"Write"
],
"websiteURL": "https://github.com/EveryInc/compound-engineering-plugin",
"privacyPolicyURL": "https://every.to/legal",
"termsOfServiceURL": "https://every.to/legal",
"defaultPrompt": [
"Brainstorm a new feature with me",
"Ideate and surprise me!",
"Simplify the code in my most-churned file"
],
"brandColor": "#C9EFFA",
"composerIcon": "./assets/icon.svg",
"logo": "./assets/logo.png",
"screenshots": []
}
}
================================================
FILE: .compound-engineering/config.local.example.yaml
================================================
# Compound Engineering -- local config
# Copy to .compound-engineering/config.local.yaml in your project root.
# All settings are optional. Invalid values fall through to defaults.
# --- Product pulse ---
# Settings written by /ce-product-pulse first-run interview. Re-run the skill with
# argument `setup` or `reconfigure` to edit interactively.
# pulse_product_name: "Spiral" # used in report titles (no default)
# pulse_lookback_default: 24h # 1h | 24h | 7d | 30d (default: 24h)
# pulse_primary_event: "session_started" # the event that means "user showed up"
# pulse_value_event: "task_completed" # the event that means "user got value"
# pulse_completion_events: "onboarded,first_purchase" # comma-separated, 0-3 events
# pulse_quality_scoring: false # true | false (default: false; AI products only)
# pulse_quality_dimension: "answer accuracy" # dimension scored 1-5 when pulse_quality_scoring is true
# pulse_analytics_source: posthog # posthog | mixpanel | custom (no default)
# pulse_tracing_source: sentry # sentry | datadog | custom (no default)
# pulse_payments_source: stripe # stripe | custom (no default)
# pulse_db_enabled: false # true | false (default: false; read-only DB if true)
# pulse_metric_sources: "retention_d7=posthog,nps=delighted" # strategy-metric -> source overrides; comma-separated 'metric=source' pairs; unlisted metrics fall back to pulse_analytics_source
# pulse_pending_metrics: "retention_d7,nps" # comma-separated strategy metrics awaiting instrumentation; render as 'no data'
# pulse_excluded_metrics: "north_star" # comma-separated strategy metrics intentionally not in pulse
# --- Output format ---
# Per-skill output format default. Selects the exclusive format the artifact
# is written in: `md` produces a markdown file, `html` produces a single
# self-contained HTML file. The two are mutually exclusive -- there is no
# sibling artifact. See DESIGN.md or your agent instructions to influence
# HTML styling. Precedence: a format request in your prompt for that run wins
# (e.g. "output:html" or "make it HTML"); a preference you established earlier
# (in-session, saved to memory, or in your agent instructions) overrides these
# keys (this config is the persisted fallback); pipeline contexts (e.g., LFG,
# disable-model-invocation) always force `md`.
# plan_output: html # md | html (default: md)
# brainstorm_output: html # md | html (default: md)
# ideate_output: md # md | html (default: html -- ideation docs are human-facing, so HTML is the default; set md to opt out)
# --- Fable elevation (Claude Code only) ---
# Claude Code ONLY; silently ignored on every other harness (Codex, Cursor, ...).
# When on, /ce-plan and /ce-brainstorm dispatch their reasoning-heavy step (plan
# authoring; approach generation) to the Fable model via a subagent, so you get
# higher-reasoning output even when your session model is cheaper -- no session
# switch. Per-skill so you can enable one without the other. You can also just
# say "use fable" in a prompt for a one-off. Invalid/commented/missing -> off.
# plan_use_fable: true # true | false (default: false)
# brainstorm_use_fable: true # true | false (default: false)
# fable_nudge: false # true | false (default: true -- one-time tip when elevation is available but off)
# --- PR concept teaching (ce-commit-push-pr) ---
# When a PR introduces a concept new to the codebase, the generated PR
# description gains a "New concepts" section teaching it. The section toggle is
# the single gate: off disables judgment, the section, the /ce-explain offer,
# and archival. Archival additionally writes the explainer to docs/explainers/
# and links it from the PR (full-workflow runs only; override per run with
# archive:on|off). Note: this file is gitignored and per-checkout -- fresh
# worktrees don't inherit it.
# pr_teaching_section: false # true | false (default: true)
# pr_teaching_archive: true # true | false (default: false; full-workflow runs only)
# --- ce-commit-push-pr babysit handoff ---
# After a full-workflow PR is opened, ce-commit-push-pr auto-invokes ce-babysit-pr
# to watch CI + incoming review and drive the PR toward merge-ready. Set false to
# opt out standing (per-run override: the babysit:off token).
# auto_babysit: false # true | false (default: true)
# --- ce-plan scoping confirmation ---
# By default /ce-plan pauses before research/plan-write to show a scoping
# summary and wait for you to confirm scope. Set this to skip that wait: ce-plan
# composes the summary for itself, records any inferred scope under an
# Assumptions section, announces that it's proceeding, and keeps going. It skips
# only that confirmation -- genuine blocking questions and the post-plan menu
# still appear. Override per run with `confirm:auto` (skip) or `confirm:ask`
# (force the gate on for one run).
# plan_skip_scoping_confirm: true # true | false (default: false)
# --- ce-promote ---
# Written automatically when you decline the Spiral setup offer in /ce-promote.
# Suppresses that one-time setup nudge in this project. Remove the key to re-enable.
# ce_promote_spiral_optout: true # true | (absent) (default: absent -- offer once)
# --- Sweep (ce-sweep) ---
# Feedback sources swept by /ce-sweep. Generic key: other skills may read this list.
# Each entry: type (slack | github-issues | email), id (short name), target (channel ID /
# owner/repo / mailbox), ack_action, closeout_action, sensitive (true withholds content
# from committed state/plan text), approved (standing approval for source-side writes).
# feedback_sources:
# - { type: slack, id: slack-alpha, target: C0XXXXXXX, ack_action: eyes, closeout_action: white_check_mark, sensitive: false, approved: true }
# - { type: github-issues, id: gh-issues, target: owner/repo, ack_action: "feedback:ack", closeout_action: "feedback:resolved", sensitive: false, approved: true }
# Sweep-owned settings.
# sweep_state_path: docs/feedback-sweep/state.yml # committed (multi-agent) or /tmp path (solo)
# sweep_ack_cap: 25 # max acks per source per run before the circuit breaker
# sweep_lease_ttl_minutes: 60 # single-writer lease staleness threshold
# sweep_shared_branch: false # true: push-gated lease for shared-docs-branch topology
================================================
FILE: .cursor-plugin/CHANGELOG.md
================================================
# Changelog
## [1.0.2](https://github.com/EveryInc/compound-engineering-plugin/compare/cursor-marketplace-v1.0.1...cursor-marketplace-v1.0.2) (2026-06-24)
### Bug Fixes
* **metadata:** align plugin and marketplace metadata ([#987](https://github.com/EveryInc/compound-engineering-plugin/issues/987)) ([f57c682](https://github.com/EveryInc/compound-engineering-plugin/commit/f57c68257cbd792c25ef85047c426329c5c3f848))
## [1.0.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cursor-marketplace-v1.0.0...cursor-marketplace-v1.0.1) (2026-03-19)
### Bug Fixes
* add cursor-marketplace as release-please component ([#315](https://github.com/EveryInc/compound-engineering-plugin/issues/315)) ([838aeb7](https://github.com/EveryInc/compound-engineering-plugin/commit/838aeb79d069b57a80d15ff61d83913919b81aef))
================================================
FILE: .cursor-plugin/marketplace.json
================================================
{
"name": "compound-engineering",
"owner": {
"name": "Kieran Klaassen",
"email": "kieran@every.to",
"url": "https://github.com/kieranklaassen"
},
"metadata": {
"description": "Cursor plugin marketplace for Every Inc plugins",
"version": "1.0.2"
},
"plugins": [
{
"name": "compound-engineering",
"source": ".",
"description": "Brainstorm, plan, debug, review, and compound learnings with AI agents"
}
]
}
================================================
FILE: .cursor-plugin/plugin.json
================================================
{
"name": "compound-engineering",
"displayName": "Compound Engineering",
"version": "3.19.0",
"description": "Brainstorm, plan, debug, review, and compound learnings with AI agents",
"author": {
"name": "Kieran Klaassen and Trevin Chow"
},
"homepage": "https://every.to/source-code/my-ai-had-already-fixed-the-code-before-i-saw-it",
"repository": "https://github.com/EveryInc/compound-engineering-plugin",
"license": "MIT",
"keywords": [
"cursor",
"plugin",
"ai-powered",
"compound-engineering",
"workflow-automation",
"code-review",
"rails",
"ruby",
"python",
"typescript",
"knowledge-management"
]
}
================================================
FILE: .devin-plugin/plugin.json
================================================
{
"name": "compound-engineering",
"version": "3.19.0",
"description": "Brainstorm, plan, debug, review, and compound learnings with AI agents",
"author": {
"name": "Kieran Klaassen and Trevin Chow"
},
"homepage": "https://every.to/source-code/my-ai-had-already-fixed-the-code-before-i-saw-it",
"repository": "https://github.com/EveryInc/compound-engineering-plugin",
"license": "MIT",
"keywords": [
"brainstorming",
"code-review",
"compound-engineering",
"debugging",
"ideation",
"workflows",
"workflow-automation"
]
}
================================================
FILE: .github/.release-please-manifest.json
================================================
{
".": "3.19.0",
".claude-plugin": "1.0.3",
".cursor-plugin": "1.0.2"
}
================================================
FILE: .github/release-please-config.json
================================================
{
"$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
"include-component-in-tag": true,
"release-search-depth": 20,
"commit-search-depth": 50,
"plugins": [],
"packages": {
".": {
"release-type": "simple",
"package-name": "compound-engineering",
"changelog-sections": [
{
"type": "feat",
"section": "Features",
"hidden": false
},
{
"type": "fix",
"section": "Bug Fixes",
"hidden": false
},
{
"type": "deps",
"section": "Dependencies",
"hidden": false
},
{
"type": "refactor",
"section": "Refactoring",
"hidden": false
}
],
"skip-changelog": true,
"exclude-paths": [
"SECURITY.md",
"PRIVACY.md",
"favicon.png",
"docs/",
"scripts/",
".github/",
".claude/",
".codex/",
".gemini/",
".cursor/",
".windsurf/",
".agents/plugins/marketplace.json",
".kimi-plugin/marketplace.json",
".claude-plugin/marketplace.json",
".cursor-plugin/marketplace.json",
".grok-plugin/marketplace.json"
],
"extra-files": [
{
"type": "json",
"path": "package.json",
"jsonpath": "$.version"
},
{
"type": "json",
"path": ".claude-plugin/plugin.json",
"jsonpath": "$.version"
},
{
"type": "json",
"path": ".cursor-plugin/plugin.json",
"jsonpath": "$.version"
},
{
"type": "json",
"path": ".codex-plugin/plugin.json",
"jsonpath": "$.version"
},
{
"type": "json",
"path": ".kimi-plugin/plugin.json",
"jsonpath": "$.version"
},
{
"type": "json",
"path": ".grok-plugin/plugin.json",
"jsonpath": "$.version"
},
{
"type": "json",
"path": ".devin-plugin/plugin.json",
"jsonpath": "$.version"
},
{
"type": "json",
"path": "plugin.json",
"jsonpath": "$.version"
}
]
},
".claude-plugin": {
"release-type": "simple",
"package-name": "marketplace",
"extra-files": [
{
"type": "json",
"path": "marketplace.json",
"jsonpath": "$.metadata.version"
}
]
},
".cursor-plugin": {
"release-type": "simple",
"package-name": "cursor-marketplace",
"extra-files": [
{
"type": "json",
"path": "marketplace.json",
"jsonpath": "$.metadata.version"
}
]
}
}
}
================================================
FILE: .github/workflows/ci.yml
================================================
name: CI
on:
push:
branches: [main]
pull_request:
workflow_dispatch:
jobs:
pr-title:
if: github.event_name == 'pull_request'
runs-on: ubuntu-latest
permissions:
pull-requests: read
steps:
- name: Validate PR title
uses: amannn/action-semantic-pull-request@v6.1.1
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
with:
requireScope: false
types: |
feat
fix
docs
refactor
chore
test
ci
build
perf
revert
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
# Full history so release:validate can read the base-branch (origin/main)
# release-please manifest when checking release-as pins for staleness.
with:
fetch-depth: 0
- name: Setup Bun
uses: oven-sh/setup-bun@v2
with:
bun-version: latest
- name: Install dependencies
run: bun install
- name: Validate release metadata
run: bun run release:validate
# Canonical schema check: runs `claude plugin validate --strict` against
# the marketplace catalog and the plugin manifest. The CLI must be
# installed via npm, not bun: `bun x` cannot run this package (bun blocks
# its required postinstall and cannot resolve its `claude` bin name), and
# `bun run` rewrites `npx` in package.json scripts to the broken `bun x`,
# so the script invokes a `claude` already on PATH instead.
#
# The validator version is pinned deliberately for reproducible CI: a
# floating @latest would track new upstream validation rules
# automatically but could break CI without any repo change. Bump the
# pin intentionally to adopt new `claude plugin validate` rules.
#
# plugin:validate must hit .claude-plugin/plugin.json — `validate .` only
# checks the marketplace. Root CLAUDE.md is a symlink to AGENTS.md so
# --strict stays green; see AGENTS.md "CI and Quality Gates".
- name: Validate plugin schema (claude plugin validate)
run: |
npm install -g @anthropic-ai/claude-code@2.1.175
bun run plugin:validate
- name: Run tests
run: bun test
================================================
FILE: .github/workflows/release-pr.yml
================================================
name: Release PR
on:
push:
branches: [main]
workflow_dispatch:
permissions:
contents: write
pull-requests: write
issues: write
concurrency:
group: release-pr-${{ github.ref }}
cancel-in-progress: true
jobs:
release-pr:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
with:
fetch-depth: 0
- name: Setup Bun
uses: oven-sh/setup-bun@v2
with:
bun-version: latest
- name: Install dependencies
run: bun install --frozen-lockfile
- name: Detect release PR merge
id: detect
run: |
MSG=$(git log -1 --format=%s)
if [[ "$MSG" == chore:\ release* ]]; then
echo "is_release_merge=true" >> "$GITHUB_OUTPUT"
else
echo "is_release_merge=false" >> "$GITHUB_OUTPUT"
fi
- name: Validate release metadata scripts
if: steps.detect.outputs.is_release_merge == 'false'
run: bun run release:validate
- name: Maintain release PR
id: release
uses: googleapis/release-please-action@v4.4.0
with:
token: ${{ secrets.GITHUB_TOKEN }}
config-file: .github/release-please-config.json
manifest-file: .github/.release-please-manifest.json
skip-labeling: false
================================================
FILE: .github/workflows/release-preview.yml
================================================
name: Release Preview
on:
workflow_dispatch:
inputs:
title:
description: "Conventional title to evaluate (defaults to the latest commit title on this ref)"
required: false
type: string
compound_engineering_bump:
description: "compound-engineering bump override"
required: false
type: choice
options: [auto, patch, minor, major]
default: auto
marketplace_bump:
description: "marketplace bump override"
required: false
type: choice
options: [auto, patch, minor, major]
default: auto
cursor_marketplace_bump:
description: "cursor-marketplace bump override"
required: false
type: choice
options: [auto, patch, minor, major]
default: auto
jobs:
preview:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
with:
fetch-depth: 0
- name: Setup Bun
uses: oven-sh/setup-bun@v2
with:
bun-version: latest
- name: Install dependencies
run: bun install --frozen-lockfile
- name: Determine title and changed files
id: inputs
shell: bash
run: |
TITLE="${{ github.event.inputs.title }}"
if [ -z "$TITLE" ]; then
TITLE="$(git log -1 --pretty=%s)"
fi
FILES="$(git diff --name-only HEAD~1...HEAD | tr '\n' ' ')"
echo "title=$TITLE" >> "$GITHUB_OUTPUT"
echo "files=$FILES" >> "$GITHUB_OUTPUT"
- name: Add preview note
run: |
echo "This preview currently evaluates the selected ref from its latest commit title and changed files." >> "$GITHUB_STEP_SUMMARY"
echo "It is side-effect free, but it does not yet reconstruct the full accumulated open release PR state." >> "$GITHUB_STEP_SUMMARY"
- name: Validate release metadata
run: bun run release:validate
- name: Preview release
shell: bash
run: |
TITLE='${{ steps.inputs.outputs.title }}'
FILES='${{ steps.inputs.outputs.files }}'
args=(--title "$TITLE" --json)
for file in $FILES; do
args+=(--file "$file")
done
args+=(--override "compound-engineering=${{ github.event.inputs.compound_engineering_bump || 'auto' }}")
args+=(--override "marketplace=${{ github.event.inputs.marketplace_bump || 'auto' }}")
args+=(--override "cursor-marketplace=${{ github.event.inputs.cursor_marketplace_bump || 'auto' }}")
bun run scripts/release/preview.ts "${args[@]}" | tee /tmp/release-preview.txt
- name: Publish preview summary
shell: bash
run: cat /tmp/release-preview.txt >> "$GITHUB_STEP_SUMMARY"
================================================
FILE: .gitignore
================================================
.DS_Store
*.log
node_modules/
.codex/
todos/
.worktrees
.context/
.claude/worktrees/
__pycache__/
*.pyc
.compound-engineering/*.local.yaml
================================================
FILE: .grok-plugin/marketplace.json
================================================
{
"name": "compound-engineering",
"description": "Compound Engineering plugin for Grok Build",
"owner": {
"name": "Kieran Klaassen and Trevin Chow"
},
"plugins": [
{
"name": "compound-engineering",
"description": "Brainstorm, plan, debug, review, and compound learnings with AI agents",
"category": "development",
"source": {
"source": "url",
"url": "https://github.com/EveryInc/compound-engineering-plugin.git"
},
"homepage": "https://github.com/EveryInc/compound-engineering-plugin",
"keywords": [
"compound-engineering",
"compound engineering",
"ce-plan",
"ce-work"
]
}
]
}
================================================
FILE: .grok-plugin/plugin.json
================================================
{
"name": "compound-engineering",
"version": "3.19.0",
"description": "Brainstorm, plan, debug, review, and compound learnings with AI agents",
"author": {
"name": "Kieran Klaassen and Trevin Chow"
},
"homepage": "https://every.to/source-code/my-ai-had-already-fixed-the-code-before-i-saw-it",
"repository": "https://github.com/EveryInc/compound-engineering-plugin",
"license": "MIT",
"keywords": [
"brainstorming",
"code-review",
"compound-engineering",
"debugging",
"ideation",
"workflows",
"workflow-automation"
],
"skills": "./skills/"
}
================================================
FILE: .kimi-plugin/marketplace.json
================================================
{
"version": "2",
"plugins": [
{
"id": "compound-engineering",
"displayName": "Compound Engineering",
"source": "https://github.com/EveryInc/compound-engineering-plugin"
}
]
}
================================================
FILE: .kimi-plugin/plugin.json
================================================
{
"name": "compound-engineering",
"version": "3.19.0",
"description": "Brainstorm, plan, debug, review, and compound learnings with AI agents",
"keywords": [
"brainstorming",
"code-review",
"compound-engineering",
"debugging",
"ideation",
"workflows",
"workflow-automation"
],
"author": "Kieran Klaassen and Trevin Chow",
"homepage": "https://every.to/source-code/my-ai-had-already-fixed-the-code-before-i-saw-it",
"license": "MIT",
"skills": "./skills/",
"interface": {
"displayName": "Compound Engineering",
"shortDescription": "Brainstorm, plan, debug, review, and compound learnings with AI agents",
"longDescription": "Compound Engineering guides AI agents through the full engineering loop: strategy, ideation, requirements, planning, execution, debugging, review, PR feedback, and captured learnings that make future work easier.",
"developerName": "Kieran Klaassen and Trevin Chow",
"websiteURL": "https://github.com/EveryInc/compound-engineering-plugin"
}
}
================================================
FILE: .opencode/INSTALL.md
================================================
# Installing Compound Engineering for OpenCode
Add Compound Engineering to the `plugin` array in your global or project `opencode.json`:
```json
{
"plugin": ["compound-engineering@git+https://github.com/EveryInc/compound-engineering-plugin.git"]
}
```
Restart OpenCode after changing the config. The OpenCode plugin registers the Compound Engineering skills directory directly; no Bun installer or generated skill copy is required.
To pin a release, add a tag. Replace `X.Y.Z` with the release you want — see the [releases page](https://github.com/EveryInc/compound-engineering-plugin/releases) for available tags:
```json
{
"plugin": ["compound-engineering@git+https://github.com/EveryInc/compound-engineering-plugin.git#compound-engineering-vX.Y.Z"]
}
```
## Local Development
From this checkout, point OpenCode at the package path:
```json
{
"plugin": ["/path/to/compound-engineering-plugin"]
}
```
Restart OpenCode after changing the package source.
================================================
FILE: .opencode/plugins/compound-engineering.js
================================================
import path from "path"
import { fileURLToPath } from "url"
const pluginDir = path.dirname(fileURLToPath(import.meta.url))
const skillsDir = path.resolve(pluginDir, "../../skills")
export const CompoundEngineeringPlugin = async () => ({
config: async (config) => {
config.skills = config.skills || {}
config.skills.paths = config.skills.paths || []
if (!config.skills.paths.includes(skillsDir)) {
config.skills.paths.push(skillsDir)
}
},
})
export default CompoundEngineeringPlugin
================================================
FILE: .pi/extensions/compound-engineering.ts
================================================
import { dirname, resolve } from "node:path"
import { fileURLToPath } from "node:url"
const extensionDir = dirname(fileURLToPath(import.meta.url))
const packageRoot = resolve(extensionDir, "../..")
const skillsDir = resolve(packageRoot, "skills")
export default function compoundEngineeringPiExtension(pi: any) {
pi.on("resources_discover", async () => ({
skillPaths: [skillsDir],
}))
}
================================================
FILE: AGENTS.md
================================================
# Agent Instructions
This repository is the root of the `compound-engineering` coding-agent plugin and the marketplace/catalog metadata used to distribute it.
It also contains:
- the Bun/TypeScript CLI that converts Claude Code plugins into other agent platform formats
- shared release and metadata infrastructure for the CLI, marketplace, and plugin
`AGENTS.md` is the canonical repo instruction file. Root `CLAUDE.md` is a symlink to `AGENTS.md` so Claude Code and other tools that look for `CLAUDE.md` still find it at the expected path. Keep that symlink (do not replace it with a regular file): a real root `CLAUDE.md` makes `claude plugin validate --strict` fail because this checkout is also the plugin root.
## Quick Start
```bash
bun install
bun test # full test suite (also runs in CI)
bun run release:validate # plugin/marketplace consistency (also runs in CI)
bun run plugin:validate # Claude marketplace + plugin schema (also runs in CI; needs `claude` on PATH)
```
## Working Agreement
- **Branching:** Create a feature branch for any non-trivial change. If already on the correct branch for the task, keep using it; do not create additional branches or worktrees unless explicitly requested.
- **Merge policy:** All changes to `main` go through pull requests. Direct pushes and direct merges are not allowed; branch protection on `main` enforces this by requiring the `test` status check to pass. The direct path bypasses `release:validate`, the test suite, and PR title validation — past direct merges have caused version drift requiring multi-PR recovery (see `docs/solutions/workflow/release-please-version-drift-recovery.md`).
- **Safety:** Do not delete or overwrite user data. Avoid destructive commands.
- **Testing:** Run `bun test` after changes that affect parsing, conversion, output, skill conventions, or other mechanical guards. Local `bun test` is the same suite CI runs — there is no separate local-only unit-test lane.
- **Release versioning:** Releases are prepared by release automation, not normal feature PRs. The repo has one root plugin/package release component (`compound-engineering`) plus marketplace components (`marketplace`, `cursor-marketplace`). GitHub release PRs and GitHub Releases are the canonical release-notes surface for new releases; root `CHANGELOG.md` is only a pointer to that history. Use conventional titles such as `feat:` and `fix:` so release automation can classify change intent, but do not hand-bump release-owned versions or hand-author release notes in routine PRs.
- **Output Paths:** Keep OpenCode output at `opencode.json` and `.opencode/{agents,skills,plugins}`. For OpenCode, commands go to `~/.config/opencode/commands/<name>.md`; `opencode.json` is deep-merged (never overwritten wholesale).
- **Scratch Space:** Default to OS temp. Use `.context/` only when explicitly justified by the rules below.
- **Default: OS temp** — covers most scratch, including per-run throwaway AND cross-invocation reusable, regardless of whether a repo is present or whether other skills may read the files. A stable OS-temp prefix handles cross-skill and cross-invocation coordination equally well as an in-repo path; repo-adjacency is rarely the relevant property.
- **Per-run throwaway**: `mktemp -d -t <prefix>-XXXXXX` (OS handles cleanup). Use for files consumed once and discarded — captured screenshots, stitched GIFs, intermediate build outputs, recordings, delegation prompts/results, single-run checkpoints. The resulting path is opaque (on macOS it resolves under `$TMPDIR`/`/var/folders/...`) — that is appropriate for throwaway files users are not meant to access.
- **Cross-invocation reusable**: stable path `/tmp/compound-engineering/<skill-name>/<run-id>/` — **not** `mktemp -d` — so later invocations of the same skill can discover sibling run-ids. Use `/tmp` directly rather than `$TMPDIR` so paths stay accessible: `$TMPDIR` on macOS resolves to `/var/folders/64/.../T/`, which is hostile for users who want to inspect checkpoints, grep them, or copy them out. The per-user isolation `$TMPDIR` provides is not valuable for cross-invocation reusable scratch where users are the intended audience. Use for caches keyed by session, checkpoints meant to survive context compaction within a loose session, or any state where later runs of the same skill need to locate prior outputs.
- **Exception: `.context/`** — use only when the artifact is genuinely bound to the CWD repo AND meets at least one of:
- (a) **User-curated**: the user is expected to inspect, manipulate, or manually curate the artifact outside the skill (e.g., a per-repo TODO database, a per-spec optimization log that survives across sessions on the same checkout).
- (b) **Repo+branch-inseparable**: the artifact's meaning is inseparable from this specific repo or branch (e.g., branch-specific resume state that a user expects to pick up again in the same checkout).
- (c) **Path is core UX**: surfacing the artifact path back to the user is a core part of the skill's output and that path is easier to communicate as a repo-relative location than an OS-temp one.
Namespace under `.context/compound-engineering/<workflow-or-skill-name>/`, add a per-run subdirectory when concurrent runs are plausible, and decide cleanup behavior per the artifact's lifecycle (per-run scratch clears on success; user-curated state persists). "Shared between skills" is not by itself sufficient — OS temp handles that equally well.
- **Durable outputs** (plans, specs, learnings, docs, final deliverables) belong in `docs/` or another repo-tracked location, not in either scratch tier.
- **Cross-platform note:** `/tmp` is writable on macOS (symlink to `/private/tmp`), Linux, and WSL. `mktemp -d -t <prefix>-XXXXXX` also works on all three. Skills authored here assume Unix-like shells; native Windows is not a current target.
- **Character encoding:**
- **Identifiers** (file names, agent names, command names): ASCII only -- converters and regex patterns depend on it.
- **Markdown tables:** Use pipe-delimited (`| col | col |`), never box-drawing characters.
- **Prose and skill content:** Unicode is fine (emoji, punctuation, etc.). Prefer ASCII arrows (`->`, `<-`) over Unicode arrows in code blocks and terminal examples.
## Directory Layout
```
src/ CLI entry point, parsers, converters, target writers
skills/ Compound Engineering plugin skills
.claude-plugin/ Claude plugin manifest and marketplace catalog metadata
.codex-plugin/ Codex plugin manifest
.cursor-plugin/ Cursor plugin manifest and marketplace catalog metadata
.opencode/ OpenCode package entrypoint and install docs
.pi/ Pi extension entrypoint
tests/ Converter, writer, and CLI tests + fixtures
docs/ Requirements, plans, solutions, and target specs
CONCEPTS.md Shared domain vocabulary (glossary of project-specific terms)
```
## Repo Surfaces
Changes in this repo may affect one or more of these surfaces:
- root plugin content under `skills/`, `AGENTS.md`, `README.md`, and platform manifests
- marketplace catalogs under `.claude-plugin/`, `.cursor-plugin/`, and `.agents/plugins/`
- the converter/install CLI in `src/` and `package.json`
Do not assume a repo change is "just CLI" or "just plugin" without checking which surface owns the affected files.
## Plugin Maintenance
When changing plugin content:
- Update substantive docs like `README.md` when the plugin behavior, inventory, or usage changes.
- When adding a user-facing skill, document it: create a `docs/skills/<skill-name>.md` page (purpose, novel mechanics, when to use, chain position — follow the shape of the existing pages) and add a catalog row under the right category in `docs/skills/README.md`, alongside the root `README.md` inventory row and the skill-count bump in `tests/release-metadata.test.ts`. Keep these in sync when a skill's purpose or inventory changes. This is convention, not yet validated by a test, so it is easy to miss — most skills have a page; the few that don't (e.g. `lfg`, `ce-dogfood-beta`) are the exception, not the rule.
- Do not hand-bump release-owned versions in plugin or marketplace manifests.
- Do not hand-add release entries to `CHANGELOG.md` or treat it as the canonical source for new releases.
- Run `bun run release:validate` if agents, commands, skills, MCP servers, or release-owned descriptions/counts may have changed.
- When removing a skill, agent, or command, add its name to both cleanup registries so stale flat-install artifacts are swept on upgrade:
- `STALE_SKILL_DIRS` / `STALE_AGENT_NAMES` / `STALE_PROMPT_FILES` in `src/utils/legacy-cleanup.ts`
- `EXTRA_LEGACY_ARTIFACTS_BY_PLUGIN["compound-engineering"]` in `src/data/plugin-legacy-artifacts.ts`
Useful validation commands:
```bash
bun run release:validate
cat .claude-plugin/marketplace.json | jq .
cat .claude-plugin/plugin.json | jq .
```
## Runtime vs Authoring Context
`AGENTS.md`, `CLAUDE.md` (symlink to `AGENTS.md`), and `GEMINI.md` are authoring context for this source repository. Skills are installed into end-user environments, where they run against the user's local instruction files, not this repo's. Behavioral rules that must affect a skill at runtime belong in that skill's `SKILL.md` or files under its own `references/` directory.
## Cross-Model Skill Authoring
This repository authors each skill once and distributes it across multiple agent models and harnesses. Before creating, materially revising, or reviewing a skill or skill-local persona, read `docs/solutions/skill-design/portable-agent-skill-authoring.md`.
That field guide is the canonical reasoning layer for outcome-first authoring, model and harness portability, protocol versus judgment, proportional authority, tool adapters, evidence-backed review, and targeted behavioral evaluation. It is not a template: apply only the sections relevant to the skill. The repository-specific rules elsewhere in this file supplement the guide and take precedence where they are more specific.
### Skill Prose Admission Rules
- Keep a line only when it states a falsifiable constraint, counters a known default tendency or observed shortcut, or supplies domain knowledge that materially changes a decision.
- Do not keep vague effort or quality language such as "be thorough" or "produce high-quality work" as a standalone instruction. Replace it with an observable rule, or retain a targeted effort cue only when it counters a documented runtime tendency and has been evaluated there.
- Do not append motivational rationale to a directive that already stands on its own.
- Repeat an instruction only at a demonstrated drift point where placement changes whether it fires. Protect genuinely required always-loaded duplicates with a parity test.
### Applying Feedback to Skills
Applying review, peer, or eval feedback to a skill is a material revision governed by the authoring guide. An item is not addressed because a sentence landed; it is addressed when a demonstrated gap is closed at its owning layer by the smallest mechanism. Before editing:
1. **Evidence** — classify each item as Change, Verify, or Consider using the guide's evidence rules. Do not edit the skill for Verify or Consider items.
2. **Owning layer** — for each Change, identify its owning layer: activation contract, outcome spine or skill boundary, runtime protocol, loading or placement, deterministic enforcement, or shared authoring rule.
3. **Mechanism** — fix the gap at its owning layer. Add prose only when it is the smallest mechanism that closes the gap, and then only the smallest falsifiable unit per the Skill Prose Admission Rules.
4. **Reconcile** — reread the affected block; remove or rewrite text the change makes conflicting, duplicated, or obsolete. Resolve conflicting feedback items rather than stacking both.
When evidence shows the same cause across skills, fix the shared guide, rule, or mechanism unless the skills' contracts materially differ.
For a multi-item round, record one line per item in the existing PR body or work note: `item -> Change|Verify|Consider | owning layer | mechanism - why`. A single-item fix still follows the steps above; the written line is optional. Reviewer wording is a hypothesis about mechanism, not authority over it — the reviewer's one-line prose fix is sometimes exactly right.
### Skill Loading Supplements
- Keep every load-bearing action, route, and reference-load instruction inline at the point where it must fire (`docs/solutions/skill-design/post-menu-routing-belongs-inline.md`).
- Do not inline a summary complete enough to suppress loading the authoritative reference.
- Extract a block to `references/` when it is conditional or late-sequence and a meaningful share of the skill (~20%+). Replace it with a 1-3 line condition and backtick path.
- Never use `@` for an extracted block; it inlines at load time and defeats extraction.
## Referencing Project Conventions in Skills
When a skill needs to discover a project convention at runtime — the issue tracker, coding standards, commit format, lint command, scope constraints, etc. — describe **what to look for in the agent's existing context**, not **which file to open**.
**On the read path, do not name instruction files (`AGENTS.md` / `CLAUDE.md` / `GEMINI.md` / `.cursor/rules`).** Phrase it as "the project's active instructions and conventions already in your context." Three reasons:
- **Redundant.** Every major harness auto-injects the project's root instruction file into context at session start (Claude Code loads `CLAUDE.md`, Codex `AGENTS.md`, Gemini `GEMINI.md`). Telling the agent to "read `AGENTS.md`" asks it to re-open content it already has.
- **Brittle / not portable.** The filename differs per harness, and this plugin is authored once and converted to all of them. A hardcoded "read `AGENTS.md` (or `CLAUDE.md`)" silently finds nothing on a harness that uses a different name.
- **Security smell.** Instructing an agent to go *read named instruction dotfiles* is the exact shape that prompt-injection defenses in some agent frameworks (e.g., Hermes) flag. Referencing context rather than filenames avoids tripping those guards.
**Name a concrete file only where the skill must do something a context reference can't express:**
- **Writing a convention back** (e.g., persisting `project_tracker: linear`) needs a target — name it minimally and as an example ("the project's root agent-instructions file, e.g., `AGENTS.md`; if it `@`-includes another, write to the substantive one").
- **Reading content that is genuinely not auto-loaded** — a subdirectory-scoped instruction file governing the area being changed, an optional project doc like `STRATEGY.md` / `CONCEPTS.md` / `README.md`, or any file a *fresh subagent* (which does not inherit the parent's loaded instructions) must open to do its job. Auditing tools that must enumerate every standards file (e.g., `ce-code-review`'s project-standards reviewer globbing all `CLAUDE.md`/`AGENTS.md`) are a legitimate exception — they review the files, they don't re-read them for context.
**Describe the capability, not the tool.** Pair this with naming the *category* of thing rather than a closed set: "the project's issue tracker (e.g., GitHub Issues, Linear, Jira)" and "whatever interface that tracker exposes (connector/MCP, documented API, or a documented CLI)" — never assume a specific CLI exists, and never treat a missing binary / env var / MCP server as proof the capability is unavailable.
## Validating Agent and Skill Changes
Behavioral changes to a plugin skill or skill-local persona (anything under `skills/`) need a different validation path than mechanical code changes, because of how Claude Code loads plugins.
- **Use the `skill-creator` skill to test changes.** Skill-creator is purpose-built for this: it spawns a generic subagent and injects the agent or skill content into the subagent's prompt at dispatch time, so each run reads the current source from disk. Invoke `/skill-creator` and use its eval workflow rather than reaching for ad-hoc workarounds.
- **Plugin agent and skill definitions both cache at session start.** Once a Claude Code session is open, dispatching a typed plugin agent runs the in-memory copy that was loaded when the session began. The same applies to skills: invoking a skill goes through the cached skill loader, so edits to skill scripts are also not tested via that path. File edits to either layer after session start do not propagate within the same session. Any iteration loop built around typed-agent dispatch or Skill-tool invocation in the same session is testing pre-edit content, not your changes.
- **Do NOT edit `~/.claude/plugins/cache/` or `~/.claude/plugins/marketplaces/` to try to force a reload.** Those paths are user machine state, not repo-managed. Modifying them does not reliably bypass the in-session cache (it didn't, in observed behavior), risks being silently overwritten by plugin updates, and is the wrong layer to test from. The skill-creator pattern is the proper approach; if you genuinely need fresh-loaded behavior of the typed-agent dispatch path, restart the Claude Code session — but skill-creator is preferred for fast iteration.
- **A version-matched cache is not automatically stale — confirm by content, not by version.** When this working tree is the local marketplace source, a session (re)start re-copies it into `~/.claude/plugins/cache/.../compound-engineering/<version>/` (a plain copy, no `.git`; `<version>` is the working tree's `.claude-plugin/plugin.json` version), so the loaded plugin can be identical to — and as current as — your edits. Do not assume the running copy is stale just because it lives under the cache path; equally, do not assume a matching `<version>` means it includes your latest change. Version match is necessary but not sufficient: edits within a release do not bump the version, so a matching segment proves only that the cache was built from this release, not that it captured your most recent edit. To know which copy is actually loaded, diff the specific cache file against the working-tree file — identical means the running plugin is your current edit and you can trust it; differing means the session predates the edit, so restart (or use skill-creator). Never infer "stale" or "current" from the version segment alone.
- **Mechanical changes do not have this restriction.** Skill scripts (e.g., `extract-metadata.py`), parser logic, conversion code, and anything `bun test` exercises always run the current source. The caching issue only affects LLM-driven skill prose behavior dispatched through the plugin loader.
## CI and Quality Gates
PR CI (`.github/workflows/ci.yml`) is the merge gate. It runs, in order: PR-title lint (PRs only), `bun run release:validate`, `bun run plugin:validate`, and `bun test`. Do not invent a parallel local-only mechanical suite — if a check is deterministic and should block merges, put it in one of those steps (usually `bun test`).
### What belongs where
| Kind of check | Where it lives | Notes |
|---|---|---|
| Deterministic invariants (frontmatter, parity, path safety, script behavior, converter/writer output, greppable skill contracts) | `bun test` / `release:validate` / `plugin:validate` | Must pass in CI |
| Skill *prose behavior* (routing judgment, restraint, cross-model peer outcomes) | `skill-creator` eval, local / PR evidence | Not a CI job; non-deterministic and needs a model |
That split is intentional. See `docs/solutions/skill-design/portable-agent-skill-authoring.md` ("Evaluate proportionally"). Mechanical checks belong in CI; behavioral agent evals are best-effort evidence, not an exhaustive CI matrix.
### Right-size new mechanical guards
When a review bot or human finds a greppable invariant that `bun test` missed:
1. Prefer **tightening an existing guard** over adding a new suite (e.g. widen a regex that already documents the rule).
2. Pin the **smallest falsifiable unit** — a token, enum, path, heading, or one fixture that would have failed on the regressing diff. Do not snapshot whole skill bodies or pin incidental wording.
3. If the failure needs an LLM to judge, keep it in skill-creator; do not fake it as a brittle string test.
### Maintaining `plugin:validate`
- `package.json` `plugin:validate` must validate **both** the marketplace catalog and the plugin manifest, with `--strict` on each. Paths: `.claude-plugin/marketplace.json` and `.claude-plugin/plugin.json`. Do **not** use `claude plugin validate .` — that resolves this repo as a marketplace only (because `.claude-plugin/marketplace.json` exists with `source: "./"`) and skips plugin-root checks.
- CI pins `@anthropic-ai/claude-code` for reproducible schema rules. Bump the pin deliberately when adopting new upstream rules; do not float `@latest`.
- Root `CLAUDE.md` must remain a **symlink** to `AGENTS.md` (path stays at the repo root where contributors expect it). Upstream warns on a regular-file plugin-root `CLAUDE.md` because it is not loaded as end-user project context; the symlink avoids that warning so `--strict` can stay on. Do not replace the symlink with a regular `@AGENTS.md` shim or relocate the file just for validators.
- If `--strict` starts failing again on `CLAUDE.md` after an upstream bump, check whether the symlink was materialized into a regular file (Windows/`core.symlinks=false` checkouts) or whether the validator started following symlinks — fix the layout or pin, do not silently drop `--strict`.
### When CI comments look "stale"
If CI claims a deferred warning or a missing gate, reproduce with the **pinned** `claude` version against `.claude-plugin/plugin.json` before treating the comment as current. Marketplace-only validation can hide plugin warnings.
## Coding Conventions
- Prefer explicit mappings over implicit magic when converting between platforms.
- Keep target-specific behavior in dedicated converters/writers instead of scattering conditionals across unrelated files.
- Preserve stable output paths and merge semantics for installed targets; do not casually change generated file locations.
- When adding or changing a target, update fixtures/tests alongside implementation rather than treating docs or examples as sufficient proof.
## Commit Conventions
- **Prefix is based on intent, not file type.** Use conventional prefixes (`feat:`, `fix:`, `docs:`, `refactor:`, etc.) but classify by what the change does, not the file extension. Files under `skills/` and plugin manifests are product code even though they are Markdown or JSON. Reserve `docs:` for files whose sole purpose is documentation (`README.md`, `docs/`, `CHANGELOG.md`).
- **Type selection — classify by intent, not diff shape.** Where `fix:` and `feat:` could both seem to fit, default to `fix:`: a change that remedies broken or missing behavior is `fix:` even when implemented by adding code, and net additions do not turn a fix into a `feat:`. Reserve `feat:` for capabilities the user could not previously accomplish where nothing was broken. Other conventional types (`chore:`, `refactor:`, `docs:`, `perf:`, `test:`, `ci:`, `build:`, `style:`) remain primary when they describe the change more precisely than either. Heuristic: if a regression test you could write today would have failed *before* the change, it's `fix:`. The user may override this default for a specific change.
- **Include a component scope.** The scope appears verbatim in the changelog. Pick the narrowest useful label: skill/agent name (`document-review`, `learnings-researcher`), CLI or marketplace area (`cli`, `marketplace`), or shared area when cross-cutting (`review`, `research`, `converters`). Never use `compound-engineering` — it's the entire plugin and tells the reader nothing. Omit scope only when no single label adds clarity.
- **Never use `!` or a `BREAKING CHANGE:` footer without explicit user confirmation.** These markers trigger release-please's automatic major version bump — a decision the user may not want even when a change is technically breaking. If a change appears breaking, surface that to the user and let them decide whether to apply the marker.
## Adding a New Target Provider
Only add a provider when the target format is stable, documented, and has a clear mapping for tools/permissions/hooks. Use this checklist:
1. **Define the target entry**
- Add a new handler in `src/targets/index.ts` with `implemented: false` until complete.
- Use a dedicated writer module (e.g., `src/targets/codex.ts`).
2. **Define types and mapping**
- Add provider-specific types under `src/types/`.
- Implement conversion logic in `src/converters/` (from Claude → provider).
- Keep mappings explicit: tools, permissions, hooks/events, model naming.
3. **Wire the CLI**
- Ensure `convert` and `install` support `--to <provider>` and `--also`.
- Keep behavior consistent with OpenCode (write to a clean provider root).
4. **Tests (required)**
- Extend fixtures in `tests/fixtures/sample-plugin`.
- Add spec coverage for mappings in `tests/converter.test.ts`.
- Add a writer test for the new provider output tree.
- Add a CLI test for the provider (similar to `tests/cli.test.ts`).
5. **Docs**
- Update README with the new `--to` option and output locations.
## Specialist Prompt Assets in Skills
The compound-engineering plugin no longer ships standalone agent definitions under `agents/`. When a skill needs a specialist persona, store it inside that skill directory, usually under `references/agents/` or `references/personas/`, and have the calling skill dispatch a generic subagent with that file's contents in the prompt.
Internal prompt asset file names should be descriptive and unprefixed because they are not externally exposed agent names.
Example:
- `references/agents/learnings-researcher.md` (correct)
- `references/agents/ce-learnings-researcher.md` (wrong for an internal prompt asset)
These prompt assets must not include YAML frontmatter. Model selection, tool constraints, and dispatch policy belong in the calling skill's `SKILL.md`, not in the prompt asset.
## File References in Skills
Each skill directory is a self-contained unit. A SKILL.md file must only reference files within its own directory tree (e.g., `references/`, `assets/`, `scripts/`) using relative paths from the skill root. Never reference files outside the skill directory — whether by relative traversal or absolute path.
Broken patterns:
- `../other-skill/references/schema.yaml` — relative traversal into a sibling skill
- `/home/user/compound-engineering-plugin/skills/other-skill/file.md` — absolute path to another skill
- `~/.claude/plugins/cache/marketplace/compound-engineering/1.0.0/skills/other-skill/file.md` — absolute path to an installed plugin location
Why this matters:
- **Runtime resolution:** Skills execute from the user's working directory, not the skill directory. Cross-directory paths and absolute paths will not resolve as expected.
- **Unpredictable install paths:** Plugins installed from the marketplace are cached at versioned paths. Absolute paths that worked in the source repo will not match the installed layout, and the version segment changes on every release.
- **Converter portability:** The CLI copies each skill directory as an isolated unit when converting to other agent platforms. Cross-directory references break because sibling directories are not included in the copy.
If two skills need the same supporting file, duplicate it into each skill's directory. Prefer small, self-contained reference files over shared dependencies.
> **Note (March 2026):** This constraint reflects current Claude Code skill resolution behavior and known path-resolution bugs ([#11011](https://github.com/anthropics/claude-code/issues/11011), [#17741](https://github.com/anthropics/claude-code/issues/17741), [#12541](https://github.com/anthropics/claude-code/issues/12541)). If Anthropic introduces a shared-files mechanism or cross-skill imports in the future, this guidance should be revisited with supporting documentation.
## Shared Repo-Grounding Profile Cache
Repo-grounding skills (`ce-pov`, `ce-plan`, `ce-optimize`, `ce-ideate`, `ce-brainstorm`, `ce-code-review`, plus lighter consumers `ce-compound` — which still derives **and persists** on a miss — and `ce-debug`, which only opportunistically reads `conventions.testing` and never derives/persists) reuse one cached **question-agnostic project profile** (stack, deps, conventions, structure) instead of each re-deriving it. The profile is git-keyed and stored at `/tmp/compound-engineering/repo-profile/<root-sha>/<inputs-digest>.json` (`inputs-digest` = sha256 of profile-input path+blob pairs at `HEAD`, so commits that do not touch those inputs share one entry).
The mechanism is three **byte-duplicated** assets per consuming skill (the plugin has no cross-skill import — see "File References in Skills"):
- `references/repo-profile-cache.md` — the schema + protocol (authoritative; read it before wiring a new consumer).
- `scripts/repo-profile-cache.py` — deterministic `get`/`put`, invoked via the `SKILL_DIR` anchor (never the legacy `${CLAUDE_SKILL_DIR}` guard).
- `references/agents/repo-profiler.md` — the persona that derives the profile on a miss.
Rules:
- A consumer resolves the agnostic profile through the cache (`get` → HIT load / MISS derive-and-`put` / NO-CACHE derive-fresh), then runs **only its question-specific grounding fresh**. The cache is an optimization, never a correctness dependency, and must never let a stale profile change an output.
- **Always re-globbed fresh, never cached:** the `docs/solutions/` enumeration and subdirectory-scoped instruction files. Caching them would risk serving a stale match (e.g. a just-written learning), and re-globbing is ~free.
- **Adding a consumer:** drop byte-identical copies of the three assets into the skill, add its name to `CONSUMER_SKILLS` in `tests/repo-profile-cache-parity.test.ts`, and wire its grounding phase. The parity test guards *file* drift; the per-consumer `skill-creator` eval (agnostic-from-cache, question-specific-fresh) guards *integration* drift.
- Any change to the schema or protocol must be edited in **all** copies (the parity test fails otherwise) and bump `PROFILE_SCHEMA_VERSION` in the helper so older cache entries invalidate. Renaming or moving a profile **field** additionally requires updating every consumer `SKILL.md` that reads a named field path (grep the consumers for it, e.g. `conventions.testing`, `vocabulary`) — those per-skill field reads are not byte-duplicated, so the parity test does not guard them.
## Platform-Specific Variables in Skills
This plugin is authored once and converted for multiple agent platforms (Claude Code, Codex, Gemini CLI, etc.). Do not use platform-specific environment variables or string substitutions (e.g., `${CLAUDE_PLUGIN_ROOT}`, `${CLAUDE_SKILL_DIR}`, `${CLAUDE_SESSION_ID}`, `CODEX_SANDBOX`, `CODEX_SESSION_ID`) in skill content without a graceful fallback that works when the variable is unavailable or unresolved.
How a bundled-file reference resolves depends on *who* resolves it and whether a shell is involved, so references fall into three tiers. Do not assume a bare `scripts/…` path behaves the same in all three.
**Tier 1 — Read-time file references (relative, no anchor):** When skill *content* points the agent at a co-located file to read (e.g., "read `references/schema.yaml`"), use a relative path from the skill root. The skill loader resolves these against the skill's own directory on all major platforms — no variable prefix needed. This is the rule in *File References in Skills* above.
**Tier 2 — Prose pointers to a bundled file the agent acts on (relative + a "from this skill's directory" cue):** When skill prose names a bundled file the agent will use but does *not* put it in an executed shell command (e.g., "drive the loop with `scripts/hitl-loop.template.sh`" or "generate the package with `scripts/review-package BASE HEAD`"), use a relative path plus an explicit "from this skill's directory" phrase. The cue tells the agent what to resolve against without the verbosity of an anchor.
**Tier 3 — Executed shell commands (the `SKILL_DIR` anchor):** When skill content puts a bundled script in a command the agent runs through the Bash tool — a fenced ` ```bash ` block **or** an inline `bash …` / `python …` — anchor it to the skill dir. The Bash tool's working directory is the user's **project**, not the skill directory, on Claude Code, Codex, and Cursor alike, so a bare `bash scripts/my-script.sh` resolves to `<project>/scripts/…`. Relative paths here *often still work* — a capable agent resolves them against the skill dir it loaded (which is how the agentskills.io spec and other ecosystems ship them) — but that relies on the agent translating the path, and the failure mode is a fenced block copied **verbatim** into a Bash call, which runs literally and misses (`exit 127`; recovery is a wasted round-trip that weaker models / mid-tier subagents botch). Anchoring bakes the resolution into the command, so it is **deterministic**. Use the anchor for executed shell as the house default — a conservative choice, not a claim that bare relative *cannot* work (recurring bug class: #764 `ce-worktree`, #811 `ce-code-review`, #898 `ce-compound`):
```
# set inline in the SAME command (shell state does not persist between Bash calls):
SKILL_DIR="<absolute path of the directory containing the SKILL.md you just read>";
bash "$SKILL_DIR/scripts/my-script.sh" ARG
```
**Keep the trailing `;` on the assignment line.** Some hosts (observed on Codex) flatten a fenced multi-line block into a single line by replacing the newline with a space before executing it. Without the `;`, `SKILL_DIR="…"` + newline + `bash "$SKILL_DIR/…"` collapses to the env-var-prefix form `SKILL_DIR="…" bash "$SKILL_DIR/…"`, where the shell expands `$SKILL_DIR` *before* the prefix assignment takes effect — so it expands to empty and the script path becomes `/scripts/my-script.sh` (`No such file or directory`). The trailing `;` makes the assignment a complete statement that survives flattening; it is load-bearing, not a style choice, so do not remove it.
An existence guard (`if [ -f "$SKILL_DIR/scripts/my-script.sh" ]; then … else echo "not found — re-check the SKILL.md path"; fi`) is optional — useful when there's a real fallback, but see the permission caveat below before guarding a pinned call.
`SKILL_DIR` is a **model-filled** value, not a harness variable: every harness loads SKILL.md from a real absolute path the agent knows, so the skill instructs the agent to set `SKILL_DIR` to that directory. This works identically on Claude Code, Codex, and Cursor precisely because it depends on no host-specific variable — `SKILL_DIR`, `CLAUDE_SKILL_DIR`, `CODEX_SKILL_DIR`, `AGENT_SKILL_DIR` are **not** env vars on any of them, yet the script runs because the agent supplies the path. This is the production pattern used by widely-installed cross-host skills (e.g. `last30days`). Two constraints: (1) shell state does **not** persist between separate Bash-tool calls, so `SKILL_DIR` cannot be set once and reused — each invocation must carry the absolute path (set it inline in the same command). (2) A script that needs its *own* directory (to read a sibling file) derives it from `BASH_SOURCE`, not `SKILL_DIR`, since `SKILL_DIR` is the orchestrator's shell var and is not exported to the child process — see `skills/ce-code-review/scripts/cross-model-adversarial-review.sh` for the reference implementation. `last30days` adopted this anchor for its critical multi-host engine after a path-resolution regression; it is the right tool when a script must run *reliably*, which is why it is the tier-3 default — but tiers 1 and 2 deliberately stay lighter.
**Avoid `${CLAUDE_SKILL_DIR}` here — in this cross-agent plugin it is a footgun, not a neutral alternative.** Every skill in this repo is authored once and installed across Claude Code, Codex, Cursor, and Gemini, and `${CLAUDE_SKILL_DIR}` is a Claude-Code-only SKILL.md *content* substitution (not an env var) that is **empty on every other host**. So a `${CLAUDE_SKILL_DIR}`-guarded call's `then` branch quietly never fires off-Claude — the **genuine silent skip** — and a Claude-only mechanism breaks on Codex/Cursor because the converter doesn't rewrite these paths and the native Codex install loads raw `SKILL.md` (no `ce_platforms` filtering). The model-filled `SKILL_DIR` anchor works on every host, so it is the right replacement wherever a `${CLAUDE_SKILL_DIR}`-guarded executed-shell call exists today (tier 3). Do not reach for `${CLAUDE_SKILL_DIR}` as a "portable" option — it isn't. Reach for it only for behavior that is genuinely Claude-Code-only and will *never* run on another harness — which, given this plugin's cross-host install model, is essentially never; treat any new use as a smell to justify or remove. (Existing guarded uses such as `ce-compound`'s `validate-frontmatter.py` survive off-Claude only via an inline `else` fallback and should migrate to the anchor.)
So: a skill's *core* behavior **can** live in a bundled script across hosts — invoke it via the `SKILL_DIR`-from-read-path anchor. You no longer need to avoid bundled scripts for portability; anchor them instead. Read-time references (`references/*.md`) still resolve against the skill dir on all targets and need no anchor.
**Permission caveat (Claude Code).** Claude Code's permission checker evaluates every subcommand of a compound command, and a bare `[ -f … ]` test is not pre-approved — so wrapping a pinned `bash "…sh"` call in an `if … then … fi` guard defeats a narrow `Bash(bash *…sh)` allow-rule and prompts on every run. If a bundled-script call must stay auto-approved via such a pin, keep it a single pinned command rather than guarding it inline. Note the model-filled `SKILL_DIR` anchor produces a *dynamic* absolute path that won't match a static `Bash(bash /…/scripts/x.sh)` pin regardless of guarding — so for the anchor, expect a one-time approval prompt per distinct command (or use a broader allow-rule); the static-pin trick mainly applies to the fixed `${CLAUDE_SKILL_DIR}` form.
**Do not use `!` load-time pre-resolution in skills.** The `!`cmd`` SKILL.md syntax runs `cmd` at skill load and inlines its stdout, but it is banned here (enforced by `tests/skill-shell-safety.test.ts`) for two unfixable reasons: it runs **only on Claude Code** — on Codex, Cursor, Gemini, and Grok the line is inert literal text — and on Claude Code a command that exits **non-zero aborts skill load** with a user-facing error. Every real use was git context (`git rev-parse …`, `gh pr view …`) whose non-zero exit is a *normal* state (no PR yet, no `origin/HEAD`, detached HEAD, not a repo), so the ordinary case broke the skill. The POSIX guards that force exit 0 (`2>/dev/null || echo SENTINEL`) then fail to parse under Windows PowerShell 5.1, which broke skill load there instead (issue #1066). No single command string both exits 0 on the expected-failure states and parses under both POSIX sh and PowerShell, so the construct cannot be made safe.
**Gather context at runtime instead.** Have the agent run one argv-style command per shell tool call (`git …`, `gh …`) — no `;`, `&&`, `||`, pipes, `$(…)`, or redirects — and interpret each exit status as control flow. This parses identically under POSIX sh and PowerShell because it is a single external-program invocation, and a non-zero exit becomes data the agent reads rather than a load-time abort. See `ce-commit` / `ce-commit-push-pr` for the pattern.
**When a platform variable is unavoidable:** resolve it at runtime with a single shell tool call and include explicit fallback instructions, so the agent knows what to do if the value is empty, a literal command string, or an error — e.g. run `jq -r .version "${CLAUDE_PLUGIN_ROOT}/.claude-plugin/plugin.json"`; if it resolved to a semantic version use it, otherwise fall back to the versionless behavior. This applies equally to any platform's variables — a skill converted from Codex, Gemini, or any other platform will have the same problem if it assumes platform-only variables exist without a fallback.
## Repository Docs Convention
- **Plans** live in `docs/plans/` — unified plan artifacts. New `ce-brainstorm` outputs are requirements-only unified plans (`artifact_readiness: requirements-only`); `ce-plan` enriches them to implementation-ready plans (`artifact_readiness: implementation-ready`). Historical `docs/brainstorms/*-requirements.*` files remain readable legacy inputs and should not be migrated just because a new plan is created.
- **Brainstorm evidence / legacy requirements** may live in `docs/brainstorms/` — historical requirements docs and specialized analysis artifacts such as `docs/brainstorms/riffrec-feedback/`. Do not treat this as the canonical output path for new `ce-brainstorm` artifacts.
- **Solutions** live in `docs/solutions/` — documented solutions to past problems (bugs, best practices, workflow patterns), organized by category with YAML frontmatter (`module`, `tags`, `problem_type`). Relevant when implementing or debugging in documented areas.
- **Specs** live in `docs/specs/` — target platform format specifications.
### Solution categories (`docs/solutions/`)
This repo builds a plugin *for* developers. Categorize solutions from the perspective of the end user (a developer using the plugin), not a contributor to this repo.
- **`developer-experience/`** — Issues with contributing to *this repo*: local dev setup, shell aliases, test ergonomics, CI friction. If the fix only matters to someone with a checkout of this repo, it belongs here.
- **`integrations/`** — Issues where plugin output doesn't work correctly on a target platform or OS. Cross-platform bugs, target writer output problems, and converter compatibility issues go here.
- **`workflow/`**, **`skill-design/`** — Plugin skill and agent design patterns, workflow improvements.
When in doubt: if the bug affects someone running `bun install compound-engineering` or `bun convert`, it's an integration or product issue, not developer-experience.
================================================
FILE: CHANGELOG.md
================================================
# Changelog
## [3.13.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.13.0...cli-v3.13.1) (2026-06-17)
### Bug Fixes
* **proof:** replace HITL review loop with one-way publish ([#957](https://github.com/EveryInc/compound-engineering-plugin/issues/957)) ([68dd787](https://github.com/EveryInc/compound-engineering-plugin/commit/68dd787f98c734f57f6e40f1e8a6e29cb8584719))
## [3.13.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.12.0...cli-v3.13.0) (2026-06-15)
### Features
* **ce-code-review:** add thematic triage grouping ([#845](https://github.com/EveryInc/compound-engineering-plugin/issues/845)) ([8092abe](https://github.com/EveryInc/compound-engineering-plugin/commit/8092abead5ab04355f55fb5ccddedfffd28c8901))
* **ce-ideate:** improve for Fable model ([#924](https://github.com/EveryInc/compound-engineering-plugin/issues/924)) ([622fbfa](https://github.com/EveryInc/compound-engineering-plugin/commit/622fbfa60de346101e3177af243c79430b189a42))
### Bug Fixes
* **ce-compound:** guard validate-frontmatter.py on non-Claude platforms ([#947](https://github.com/EveryInc/compound-engineering-plugin/issues/947)) ([5e6ecca](https://github.com/EveryInc/compound-engineering-plugin/commit/5e6eccabb10e46fb2c149d06f82c4f46299e44b5))
* **ce-worktree:** replace bundled-script creator with a portable isolation guardrail ([#948](https://github.com/EveryInc/compound-engineering-plugin/issues/948)) ([3437de3](https://github.com/EveryInc/compound-engineering-plugin/commit/3437de3049ea975bceec2688940d696e16cc5f87))
* **config-read:** read config via native tool, not $() pre-resolution ([#942](https://github.com/EveryInc/compound-engineering-plugin/issues/942)) ([0757e85](https://github.com/EveryInc/compound-engineering-plugin/commit/0757e859d21e860a1fc0424bfcbbb35a1e597771))
* **release:** bump marketplace catalogs for coding-tutor removal ([#951](https://github.com/EveryInc/compound-engineering-plugin/issues/951)) ([d4cb8ee](https://github.com/EveryInc/compound-engineering-plugin/commit/d4cb8eec0db5dc279f1671d3c362022c7617f615))
* **skills:** enforce content conventions in CI and fix violations ([#930](https://github.com/EveryInc/compound-engineering-plugin/issues/930)) ([c8e7d90](https://github.com/EveryInc/compound-engineering-plugin/commit/c8e7d908fa7e230dc8723639ea48498e3e499f3c))
## [3.12.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.11.2...cli-v3.12.0) (2026-06-09)
### Features
* HTML-first ideation docs and a status-free plan model ([#921](https://github.com/EveryInc/compound-engineering-plugin/issues/921)) ([e74e298](https://github.com/EveryInc/compound-engineering-plugin/commit/e74e29864fbfa2f800fc3e08509e2966e4947f1e))
## [3.11.2](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.11.1...cli-v3.11.2) (2026-06-06)
### Miscellaneous Chores
* **cli:** Synchronize compound-engineering versions
## [3.11.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.11.0...cli-v3.11.1) (2026-06-05)
### Miscellaneous Chores
* **cli:** Synchronize compound-engineering versions
## [3.11.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.10.0...cli-v3.11.0) (2026-06-04)
### Bug Fixes
* **ce-polish:** promote from beta to stable ([#880](https://github.com/EveryInc/compound-engineering-plugin/issues/880)) ([63b6b26](https://github.com/EveryInc/compound-engineering-plugin/commit/63b6b260c345ba70ce9d9a393eeedefb64e4e0a0))
## [3.10.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.9.4...cli-v3.10.0) (2026-06-03)
### Features
* **skill:** introduce CONCEPTS.md as shared vocabulary substrate ([#838](https://github.com/EveryInc/compound-engineering-plugin/issues/838)) ([7c4bb16](https://github.com/EveryInc/compound-engineering-plugin/commit/7c4bb16123412d97ded593fc785d206ecb9684bc))
## [3.9.4](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.9.3...cli-v3.9.4) (2026-05-31)
### Miscellaneous Chores
* **cli:** Synchronize compound-engineering versions
## [3.9.3](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.9.2...cli-v3.9.3) (2026-05-28)
### Miscellaneous Chores
* **cli:** Synchronize compound-engineering versions
## [3.9.2](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.9.1...cli-v3.9.2) (2026-05-27)
### Miscellaneous Chores
* **cli:** Synchronize compound-engineering versions
## [3.9.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.9.0...cli-v3.9.1) (2026-05-27)
### Miscellaneous Chores
* **cli:** Synchronize compound-engineering versions
## [3.9.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.8.4...cli-v3.9.0) (2026-05-26)
### Features
* **ce-plan,ce-brainstorm:** contract-driven sections + optional HTML output ([#826](https://github.com/EveryInc/compound-engineering-plugin/issues/826)) ([11e12e5](https://github.com/EveryInc/compound-engineering-plugin/commit/11e12e5739c6691a2020eb8b70a944587e7f265f))
## [3.8.4](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.8.3...cli-v3.8.4) (2026-05-21)
### Bug Fixes
* **agents:** rename .agent.md to .md for VS Code Copilot tool access ([#846](https://github.com/EveryInc/compound-engineering-plugin/issues/846)) ([796bea7](https://github.com/EveryInc/compound-engineering-plugin/commit/796bea75b74f3b101b53f7cc1c108aece0979e6b))
## [3.8.3](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.8.2...cli-v3.8.3) (2026-05-17)
### Bug Fixes
* **ce-coherence-reviewer:** remove Bash from tool allowlist ([#837](https://github.com/EveryInc/compound-engineering-plugin/issues/837)) ([82b8af4](https://github.com/EveryInc/compound-engineering-plugin/commit/82b8af415d9ca5577577fa80da0a6119fc8b661e))
## [3.8.2](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.8.1...cli-v3.8.2) (2026-05-14)
### Bug Fixes
* **codex:** respect CODEX_HOME for profile installs ([#830](https://github.com/EveryInc/compound-engineering-plugin/issues/830)) ([a0a08a1](https://github.com/EveryInc/compound-engineering-plugin/commit/a0a08a17cb178655baeabe4045b5164b3a5cef58))
## [3.8.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.8.0...cli-v3.8.1) (2026-05-11)
### Bug Fixes
* **ce-code-review:** replace resolve-base.sh with prose-driven base detection ([#815](https://github.com/EveryInc/compound-engineering-plugin/issues/815)) ([d090bde](https://github.com/EveryInc/compound-engineering-plugin/commit/d090bde0ff1bbc33ec3c3b2049cb4687e9d76532))
## [3.8.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.7.3...cli-v3.8.0) (2026-05-10)
### Miscellaneous Chores
* **cli:** Synchronize compound-engineering versions
## [3.7.3](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.7.2...cli-v3.7.3) (2026-05-08)
### Bug Fixes
* **ce-resolve-pr-feedback:** paginate GraphQL connections ([#807](https://github.com/EveryInc/compound-engineering-plugin/issues/807)) ([07a6d52](https://github.com/EveryInc/compound-engineering-plugin/commit/07a6d52879ed715e179ff11daaee47e02bc6ecc9))
## [3.7.2](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.7.1...cli-v3.7.2) (2026-05-08)
### Bug Fixes
* **ce-sessions:** unblock session-history on Claude Code ([#800](https://github.com/EveryInc/compound-engineering-plugin/issues/800)) ([81710ef](https://github.com/EveryInc/compound-engineering-plugin/commit/81710efad5666831715a630b04554a35946afb1d))
## [3.7.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.7.0...cli-v3.7.1) (2026-05-08)
### Miscellaneous Chores
* **cli:** Synchronize compound-engineering versions
## [3.7.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.6.1...cli-v3.7.0) (2026-05-07)
### Miscellaneous Chores
* **cli:** Synchronize compound-engineering versions
## [3.6.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.6.0...cli-v3.6.1) (2026-05-06)
### Bug Fixes
* **doc-review:** cut review noise on plans, scope personas to doc shape ([#780](https://github.com/EveryInc/compound-engineering-plugin/issues/780)) ([8349e75](https://github.com/EveryInc/compound-engineering-plugin/commit/8349e750b856d267b74fbbeb2fb135e4ff73eb91))
## [3.6.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.5.0...cli-v3.6.0) (2026-05-05)
### Features
* convert hooks to .codex/hooks.json for Codex target ([#742](https://github.com/EveryInc/compound-engineering-plugin/issues/742)) ([60b66dd](https://github.com/EveryInc/compound-engineering-plugin/commit/60b66dd904c3a81e0a25dd3bc61e2d94d8837f86))
### Bug Fixes
* **ce-plan:** render Implementation Units as headings, not bulleted list items ([#766](https://github.com/EveryInc/compound-engineering-plugin/issues/766)) ([be2efd7](https://github.com/EveryInc/compound-engineering-plugin/commit/be2efd7d7605c483ea9f068c6190b81a9d68e942))
* **ce-worktree:** resolve script path against skill dir, not user CWD ([#772](https://github.com/EveryInc/compound-engineering-plugin/issues/772)) ([4cc1ee6](https://github.com/EveryInc/compound-engineering-plugin/commit/4cc1ee6fe2a353cd0b8e7466ec27e9556b042ee3))
## [3.5.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.4.2...cli-v3.5.0) (2026-05-04)
### Features
* **riffrec-feedback-analysis:** add Riffrec feedback skill with three-path routing ([#747](https://github.com/EveryInc/compound-engineering-plugin/issues/747)) ([dde9256](https://github.com/EveryInc/compound-engineering-plugin/commit/dde9256362db90606d052c662dc8f2f0ae6b620b))
## [3.4.2](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.4.1...cli-v3.4.2) (2026-05-04)
### Bug Fixes
* **ce-code-review:** keep finding numbers stable ([#754](https://github.com/EveryInc/compound-engineering-plugin/issues/754)) ([e856756](https://github.com/EveryInc/compound-engineering-plugin/commit/e8567566b7ed779ea1964d6ffe97e8cb4ca79d73))
* **ce-compound, ce-sessions:** remove bash parameter expansion from ! backtick ([#752](https://github.com/EveryInc/compound-engineering-plugin/issues/752)) ([9539bf0](https://github.com/EveryInc/compound-engineering-plugin/commit/9539bf045deba099a20d306b2b118e3b019c633c))
## [3.4.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.4.0...cli-v3.4.1) (2026-05-01)
### Bug Fixes
* **ce-setup:** detect codex global skills ([#739](https://github.com/EveryInc/compound-engineering-plugin/issues/739)) ([887db6b](https://github.com/EveryInc/compound-engineering-plugin/commit/887db6b2ade997a2723debc15b5baf34fcf52fb4))
* **code-review:** grant Write to JSON-pipeline reviewer agents ([#741](https://github.com/EveryInc/compound-engineering-plugin/issues/741)) ([520a9eb](https://github.com/EveryInc/compound-engineering-plugin/commit/520a9ebea039f4f5d984cd7f31d8b8e60a9e0bc6))
## [3.4.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.3.2...cli-v3.4.0) (2026-05-01)
### Features
* **ce-strategy,ce-product-pulse:** add PM skills for upstream anchor and outcome pulse ([#614](https://github.com/EveryInc/compound-engineering-plugin/issues/614)) ([cb8f9b3](https://github.com/EveryInc/compound-engineering-plugin/commit/cb8f9b348391d28f31ce367b9ff308980939c96f))
* **ce-strategy:** move strategy doc to root and add frontmatter ([#732](https://github.com/EveryInc/compound-engineering-plugin/issues/732)) ([265cb42](https://github.com/EveryInc/compound-engineering-plugin/commit/265cb4280f22bbd2fd5cc45e338371442b6c1692))
### Bug Fixes
* **ce-compound,ce-sessions:** handle non-git CWD in pre-resolved git branch ([#731](https://github.com/EveryInc/compound-engineering-plugin/issues/731)) ([5e04534](https://github.com/EveryInc/compound-engineering-plugin/commit/5e045341372fc95d284268d514a53da5722c81d2))
* **ce-sessions:** 722 ce-compound and ce-sessions permission error ([#723](https://github.com/EveryInc/compound-engineering-plugin/issues/723)) ([8f80466](https://github.com/EveryInc/compound-engineering-plugin/commit/8f804669b184bc68ef6dbab4669fe0e431d8271a))
* **review:** default to harness-native code review, escalate on risk ([#721](https://github.com/EveryInc/compound-engineering-plugin/issues/721)) ([d217660](https://github.com/EveryInc/compound-engineering-plugin/commit/d217660b3d37acf38227abf5c57ba6f390ccaa1e))
## [3.3.2](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.3.1...cli-v3.3.2) (2026-04-29)
### Miscellaneous Chores
* **cli:** Synchronize compound-engineering versions
## [3.3.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.3.0...cli-v3.3.1) (2026-04-28)
### Bug Fixes
* **review:** queue reviewers when subagent slots fill ([#716](https://github.com/EveryInc/compound-engineering-plugin/issues/716)) ([d69a772](https://github.com/EveryInc/compound-engineering-plugin/commit/d69a772bb8682da23fa0b6a293245768e573254b))
## [3.3.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.2.0...cli-v3.3.0) (2026-04-28)
### Bug Fixes
* **ce-code-review:** restate model override at dispatch point ([#681](https://github.com/EveryInc/compound-engineering-plugin/issues/681)) ([9751d1a](https://github.com/EveryInc/compound-engineering-plugin/commit/9751d1a30a39fcfe17a9e052d32dbc9a5deafd02))
* **ce-plan:** inline post-generation menu routing so option 1 actually starts /ce-work ([#715](https://github.com/EveryInc/compound-engineering-plugin/issues/715)) ([0c515c0](https://github.com/EveryInc/compound-engineering-plugin/commit/0c515c06fe7efc77baf29b5512a768c930d50ba0))
* **ce-work-beta:** defer model and reasoning effort to Codex config ([#704](https://github.com/EveryInc/compound-engineering-plugin/issues/704)) ([4b5f28d](https://github.com/EveryInc/compound-engineering-plugin/commit/4b5f28da9746aae8f2c5dd715d7029d0ab2758a6))
* **skills:** replace shell antipatterns blocked by permission check ([#711](https://github.com/EveryInc/compound-engineering-plugin/issues/711)) ([1f0a77b](https://github.com/EveryInc/compound-engineering-plugin/commit/1f0a77bcc1e4edbf1b7979ea5cd13d1e553d4662))
## [3.2.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.1.0...cli-v3.2.0) (2026-04-26)
### Features
* **ce-compound:** add frontmatter parser-safety validator ([#697](https://github.com/EveryInc/compound-engineering-plugin/issues/697)) ([7eea2d1](https://github.com/EveryInc/compound-engineering-plugin/commit/7eea2d1cfe5c177e2d144b1e12f4957c75dac556))
### Bug Fixes
* **ce-code-review:** move run artifacts from .context/ to /tmp per AGENTS.md ([#690](https://github.com/EveryInc/compound-engineering-plugin/issues/690)) ([85e9a20](https://github.com/EveryInc/compound-engineering-plugin/commit/85e9a2073b09295b1a0771d4775d42b7142fd172))
* **ce-code-review:** replace LFG with best-judgment auto-resolve ([#685](https://github.com/EveryInc/compound-engineering-plugin/issues/685)) ([9ba41a1](https://github.com/EveryInc/compound-engineering-plugin/commit/9ba41a14cadfe2eee75fe50485f72f38b09df00b))
* **ce-code-review:** tighten autofix_class rubric for safe_auto/gated_auto boundary ([#695](https://github.com/EveryInc/compound-engineering-plugin/issues/695)) ([ad9577e](https://github.com/EveryInc/compound-engineering-plugin/commit/ad9577e7329cba31cffba71815cac6cef290ae1b))
* **ce-debug:** delegate commit/PR and add branch check ([#683](https://github.com/EveryInc/compound-engineering-plugin/issues/683)) ([1284290](https://github.com/EveryInc/compound-engineering-plugin/commit/1284290af27139c2df192488099626688fd4898b))
* **ce-demo-reel:** wait for network idle and reject blank frames ([#692](https://github.com/EveryInc/compound-engineering-plugin/issues/692)) ([f30404e](https://github.com/EveryInc/compound-engineering-plugin/commit/f30404e57bcbf7866c1a9524f4392f7dff8f3a0b))
* **ce-doc-review:** rename LFG path to best-judgment to avoid /lfg collision ([#691](https://github.com/EveryInc/compound-engineering-plugin/issues/691)) ([50bf65e](https://github.com/EveryInc/compound-engineering-plugin/commit/50bf65e88c556eaa1ae10c7d88d8e646274d7ae0))
* **session-historian:** cap deep-dives, add keyword filter primitive, tighten dispatch ([#699](https://github.com/EveryInc/compound-engineering-plugin/issues/699)) ([a91270c](https://github.com/EveryInc/compound-engineering-plugin/commit/a91270ccd2d5fba3e035275b7af2c4fec3f90b1c))
* **skills:** replace case statements blocked by permission check ([#701](https://github.com/EveryInc/compound-engineering-plugin/issues/701)) ([5952b20](https://github.com/EveryInc/compound-engineering-plugin/commit/5952b20d7f2a056f8d7d8719a2d20b6615aca9e4))
## [3.1.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.0.7...cli-v3.1.0) (2026-04-24)
### Features
* **ce-ideate:** subject gate, surprise-me, and warrant contract ([#671](https://github.com/EveryInc/compound-engineering-plugin/issues/671)) ([6514b1f](https://github.com/EveryInc/compound-engineering-plugin/commit/6514b1fce5df62582673fe7274c97a90e9aea45c))
* **ce-setup:** check for ast-grep CLI and agent skill ([#653](https://github.com/EveryInc/compound-engineering-plugin/issues/653)) ([23dc11b](https://github.com/EveryInc/compound-engineering-plugin/commit/23dc11b95ae46dc6be0308306de5c8f16329fe49))
* **codex:** native plugin install manifests + agents-only converter ([#616](https://github.com/EveryInc/compound-engineering-plugin/issues/616)) ([3ed4a4f](https://github.com/EveryInc/compound-engineering-plugin/commit/3ed4a4fa0f6f4d08144ae7598af391b4f070b649))
* **pi:** first-class support via pi-subagents + pi-ask-user ([#651](https://github.com/EveryInc/compound-engineering-plugin/issues/651)) ([7ddfbed](https://github.com/EveryInc/compound-engineering-plugin/commit/7ddfbed33b08e5ad0dc56a3ecc19adb9a10ebb2c))
### Bug Fixes
* **ce-update:** compare against main plugin.json, not release tags ([#660](https://github.com/EveryInc/compound-engineering-plugin/issues/660)) ([351d12e](https://github.com/EveryInc/compound-engineering-plugin/commit/351d12ec5b795bff4c5e633e9a64644f045340c6))
* **ce-update:** derive cache dir from CLAUDE_PLUGIN_ROOT parent ([#645](https://github.com/EveryInc/compound-engineering-plugin/issues/645)) ([6155b9d](https://github.com/EveryInc/compound-engineering-plugin/commit/6155b9de3c2d60ca424386f2dfcb0dfa7668f2c1))
* **lfg:** use platform-neutral skill references ([#642](https://github.com/EveryInc/compound-engineering-plugin/issues/642)) ([b104ce4](https://github.com/EveryInc/compound-engineering-plugin/commit/b104ce46bea4b1b9b0e9cfbdd9203dbc5a0aa510))
* **main:** recover version drift, fix stale test, document learnings ([#678](https://github.com/EveryInc/compound-engineering-plugin/issues/678)) ([bc8ae1a](https://github.com/EveryInc/compound-engineering-plugin/commit/bc8ae1a6b5375f7fbb8120104b3222391da470bb))
* **release:** remove stale release-as pin ([#674](https://github.com/EveryInc/compound-engineering-plugin/issues/674)) ([ab44d89](https://github.com/EveryInc/compound-engineering-plugin/commit/ab44d89b0b2b1f7dd57d9ce1604d42b0c11f6415))
* **skills:** cap skill descriptions at harness limit ([#643](https://github.com/EveryInc/compound-engineering-plugin/issues/643)) ([13f95ba](https://github.com/EveryInc/compound-engineering-plugin/commit/13f95ba6392f86aa8dd9b4430b84f0b7523c6c89))
## [3.0.3](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.0.2...cli-v3.0.3) (2026-04-24)
### Bug Fixes
* **release:** remove stale release-as pin ([#674](https://github.com/EveryInc/compound-engineering-plugin/issues/674)) ([ab44d89](https://github.com/EveryInc/compound-engineering-plugin/commit/ab44d89b0b2b1f7dd57d9ce1604d42b0c11f6415))
## [3.0.2](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.0.1...cli-v3.0.2) (2026-04-24)
### Features
* **ce-ideate:** subject gate, surprise-me, and warrant contract ([#671](https://github.com/EveryInc/compound-engineering-plugin/issues/671)) ([6514b1f](https://github.com/EveryInc/compound-engineering-plugin/commit/6514b1fce5df62582673fe7274c97a90e9aea45c))
### Bug Fixes
* **ce-update:** compare against main plugin.json, not release tags ([#660](https://github.com/EveryInc/compound-engineering-plugin/issues/660)) ([351d12e](https://github.com/EveryInc/compound-engineering-plugin/commit/351d12ec5b795bff4c5e633e9a64644f045340c6))
## [3.0.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.0.0...cli-v3.0.1) (2026-04-23)
### Miscellaneous Chores
* **cli:** Synchronize compound-engineering versions
## [3.0.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.68.1...cli-v3.0.0) (2026-04-22)
### ⚠ BREAKING CHANGES
* **cli:** rename all skills and agents to consistent ce- prefix ([#503](https://github.com/EveryInc/compound-engineering-plugin/issues/503))
### Features
* **ce-review:** add per-finding judgment loop to Interactive mode ([#590](https://github.com/EveryInc/compound-engineering-plugin/issues/590)) ([27cbaf8](https://github.com/EveryInc/compound-engineering-plugin/commit/27cbaf8161af8aad3260b58d0d9de03d6180a66c))
* **ce-setup:** check for ast-grep CLI and agent skill ([#653](https://github.com/EveryInc/compound-engineering-plugin/issues/653)) ([23dc11b](https://github.com/EveryInc/compound-engineering-plugin/commit/23dc11b95ae46dc6be0308306de5c8f16329fe49))
* **codex:** native plugin install manifests + agents-only converter ([#616](https://github.com/EveryInc/compound-engineering-plugin/issues/616)) ([3ed4a4f](https://github.com/EveryInc/compound-engineering-plugin/commit/3ed4a4fa0f6f4d08144ae7598af391b4f070b649))
* **doc-review, learnings-researcher:** tiers, chain grouping, rewrite ([#601](https://github.com/EveryInc/compound-engineering-plugin/issues/601)) ([c1f68d4](https://github.com/EveryInc/compound-engineering-plugin/commit/c1f68d4d55ebf6085eaa7c177bf5c2e7a2cfb62c))
* **pi:** first-class support via pi-subagents + pi-ask-user ([#651](https://github.com/EveryInc/compound-engineering-plugin/issues/651)) ([7ddfbed](https://github.com/EveryInc/compound-engineering-plugin/commit/7ddfbed33b08e5ad0dc56a3ecc19adb9a10ebb2c))
### Bug Fixes
* **ce-compound:** quote YAML array items starting with reserved indicators ([#613](https://github.com/EveryInc/compound-engineering-plugin/issues/613)) ([d8436b9](https://github.com/EveryInc/compound-engineering-plugin/commit/d8436b9a3c5b5370e51ec168a251ccb45f0d826e))
* **ce-release-notes:** backtick-wrap `<skill-name>` token in description ([#603](https://github.com/EveryInc/compound-engineering-plugin/issues/603)) ([2aee4d4](https://github.com/EveryInc/compound-engineering-plugin/commit/2aee4d42031892e7937640a003d11fad82420944))
* **ce-update:** derive cache dir from CLAUDE_PLUGIN_ROOT parent ([#645](https://github.com/EveryInc/compound-engineering-plugin/issues/645)) ([6155b9d](https://github.com/EveryInc/compound-engineering-plugin/commit/6155b9de3c2d60ca424386f2dfcb0dfa7668f2c1))
* **lfg:** use platform-neutral skill references ([#642](https://github.com/EveryInc/compound-engineering-plugin/issues/642)) ([b104ce4](https://github.com/EveryInc/compound-engineering-plugin/commit/b104ce46bea4b1b9b0e9cfbdd9203dbc5a0aa510))
* **skills:** cap skill descriptions at harness limit ([#643](https://github.com/EveryInc/compound-engineering-plugin/issues/643)) ([13f95ba](https://github.com/EveryInc/compound-engineering-plugin/commit/13f95ba6392f86aa8dd9b4430b84f0b7523c6c89))
### Code Refactoring
* **cli:** rename all skills and agents to consistent ce- prefix ([#503](https://github.com/EveryInc/compound-engineering-plugin/issues/503)) ([5c0ec91](https://github.com/EveryInc/compound-engineering-plugin/commit/5c0ec9137a7350534e32db91e8bad66f02693716))
## [2.68.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.68.0...cli-v2.68.1) (2026-04-18)
### Miscellaneous Chores
* **cli:** Synchronize compound-engineering versions
## [2.68.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.67.0...cli-v2.68.0) (2026-04-17)
### Features
* **ce-ideate:** mode-aware v2 ideation ([#588](https://github.com/EveryInc/compound-engineering-plugin/issues/588)) ([12aaad3](https://github.com/EveryInc/compound-engineering-plugin/commit/12aaad31ebd17686db1a75d1d3575da79d1dad2b))
* **ce-release-notes:** add skill for browsing plugin release history ([#589](https://github.com/EveryInc/compound-engineering-plugin/issues/589)) ([59dbaef](https://github.com/EveryInc/compound-engineering-plugin/commit/59dbaef37607354d103113f05c13b731eecbb690))
## [2.67.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.66.1...cli-v2.67.0) (2026-04-17)
### Features
* **ce-polish-beta:** human-in-the-loop polish phase between /ce:review and merge ([#568](https://github.com/EveryInc/compound-engineering-plugin/issues/568)) ([070092d](https://github.com/EveryInc/compound-engineering-plugin/commit/070092d997bcc3306016e9258150d3071f017ef8))
### Bug Fixes
* **ce-plan, ce-brainstorm:** reliable interactive handoff menus ([#575](https://github.com/EveryInc/compound-engineering-plugin/issues/575)) ([3d96c0f](https://github.com/EveryInc/compound-engineering-plugin/commit/3d96c0f074faf56fcdc835a0332e0f475dc8425f))
### Miscellaneous Chores
* **claude-permissions-optimizer:** drop skill in favor of /less-permission-prompts ([#583](https://github.com/EveryInc/compound-engineering-plugin/issues/583)) ([729fa19](https://github.com/EveryInc/compound-engineering-plugin/commit/729fa191b60305d8f3761f6441d1d3d15c5f48aa))
## [2.66.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.66.0...cli-v2.66.1) (2026-04-16)
### Miscellaneous Chores
* **cli:** Synchronize compound-engineering versions
## [2.66.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.65.0...cli-v2.66.0) (2026-04-15)
### Bug Fixes
* **converters:** preserve Codex agent sidecar scripts ([#563](https://github.com/EveryInc/compound-engineering-plugin/issues/563)) ([ee8e402](https://github.com/EveryInc/compound-engineering-plugin/commit/ee8e4028972252620f0dbfdbe1240204d22e6ea1))
* **converters:** preserve Codex config on no-MCP install ([#564](https://github.com/EveryInc/compound-engineering-plugin/issues/564)) ([ed778e6](https://github.com/EveryInc/compound-engineering-plugin/commit/ed778e62f1e0e8621df94e5d461b20833cff33e2))
## [2.65.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.64.0...cli-v2.65.0) (2026-04-11)
### Features
* **ce-setup:** unified setup skill with dependency management and config bootstrapping ([#345](https://github.com/EveryInc/compound-engineering-plugin/issues/345)) ([354dbb7](https://github.com/EveryInc/compound-engineering-plugin/commit/354dbb75828f0152f4cbbb3b50ce4511fa6710c7))
## [2.64.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.63.1...cli-v2.64.0) (2026-04-10)
### Features
* **ce-demo-reel:** add demo reel skill with Python capture pipeline ([#541](https://github.com/EveryInc/compound-engineering-plugin/issues/541)) ([b979143](https://github.com/EveryInc/compound-engineering-plugin/commit/b979143ad0460a985dd224e7f1858416d79551fb))
* **ce-update:** add plugin version check skill and ce_platforms filtering ([#532](https://github.com/EveryInc/compound-engineering-plugin/issues/532)) ([d37f0ed](https://github.com/EveryInc/compound-engineering-plugin/commit/d37f0ed16f94aaec2a7b435a0aaa018de5631ed3))
* **ce-work-beta:** add beta Codex delegation mode ([#476](https://github.com/EveryInc/compound-engineering-plugin/issues/476)) ([31b0686](https://github.com/EveryInc/compound-engineering-plugin/commit/31b0686c2e88808381560314f10ce276c86e11e2))
* **ce-work:** reduce token usage by extracting late-sequence references ([#540](https://github.com/EveryInc/compound-engineering-plugin/issues/540)) ([bb59547](https://github.com/EveryInc/compound-engineering-plugin/commit/bb59547a2efdd4e7213c149f51abd9c9a17016dd))
* **session-historian:** cross-platform session history agent and /ce-sessions skill ([#534](https://github.com/EveryInc/compound-engineering-plugin/issues/534)) ([3208ec7](https://github.com/EveryInc/compound-engineering-plugin/commit/3208ec71f8f2209abc76baf97e3967406755317d))
### Bug Fixes
* **openclaw:** use sync plugin registration ([#498](https://github.com/EveryInc/compound-engineering-plugin/issues/498)) ([2c05c43](https://github.com/EveryInc/compound-engineering-plugin/commit/2c05c43dc8b66ae37501e42a9747c07d82002185))
## [2.63.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.63.0...cli-v2.63.1) (2026-04-07)
### Miscellaneous Chores
* **cli:** Synchronize compound-engineering versions
## [2.63.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.62.1...cli-v2.63.0) (2026-04-06)
### Miscellaneous Chores
* **cli:** Synchronize compound-engineering versions
## [2.62.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.62.0...cli-v2.62.1) (2026-04-05)
### Bug Fixes
* **ce-brainstorm:** reduce token cost by extracting late-sequence content ([#511](https://github.com/EveryInc/compound-engineering-plugin/issues/511)) ([bdeb793](https://github.com/EveryInc/compound-engineering-plugin/commit/bdeb7935fcdb147b73107177769c2e968463d93f))
* **cli:** resolve repo-wide tsc --noEmit type errors ([#512](https://github.com/EveryInc/compound-engineering-plugin/issues/512)) ([3fa0c81](https://github.com/EveryInc/compound-engineering-plugin/commit/3fa0c815b286c9e11b28dc04c803529e73b79c1b))
## [2.62.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.61.0...cli-v2.62.0) (2026-04-03)
### Features
* **ce-plan:** reduce token usage by extracting conditional references ([#489](https://github.com/EveryInc/compound-engineering-plugin/issues/489)) ([fd562a0](https://github.com/EveryInc/compound-engineering-plugin/commit/fd562a0d0255d203d40fd53bb10d03a284a3c0e5))
### Bug Fixes
* **converters:** OpenCode subagent model and FQ agent name resolution ([#483](https://github.com/EveryInc/compound-engineering-plugin/issues/483)) ([577db53](https://github.com/EveryInc/compound-engineering-plugin/commit/577db53a2d2e237e900ef2079817cfe63df2d725))
* **converters:** remove invalid tools/infer from Copilot agent frontmatter ([#493](https://github.com/EveryInc/compound-engineering-plugin/issues/493)) ([6dcb4a3](https://github.com/EveryInc/compound-engineering-plugin/commit/6dcb4a3c553c94e95cb15b5af59aeb6693e6fd61))
* **mcp:** remove bundled context7 MCP server ([#486](https://github.com/EveryInc/compound-engineering-plugin/issues/486)) ([afdd9d4](https://github.com/EveryInc/compound-engineering-plugin/commit/afdd9d44651f834b1eed0b20e401ffbef5c8cd41))
## [2.61.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.60.0...cli-v2.61.0) (2026-04-01)
### Features
* **release:** document linked-versions policy ([#482](https://github.com/EveryInc/compound-engineering-plugin/issues/482)) ([96345ac](https://github.com/EveryInc/compound-engineering-plugin/commit/96345acf217333726af0dcfdaa24058a149365bb))
* **skill-design:** document skill file isolation and platform variable constraints ([#469](https://github.com/EveryInc/compound-engineering-plugin/issues/469)) ([0294652](https://github.com/EveryInc/compound-engineering-plugin/commit/0294652395cb62d5569f73ebfea543cfe8b514d6))
### Bug Fixes
* **converters:** preserve user config when writing MCP servers ([#479](https://github.com/EveryInc/compound-engineering-plugin/issues/479)) ([c65a698](https://github.com/EveryInc/compound-engineering-plugin/commit/c65a698d932d02e5fb4a948db4d000e21ed6ba4f))
## [2.60.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.59.0...cli-v2.60.0) (2026-03-31)
### Features
* **ce-brainstorm:** add conditional visual aids to requirements documents ([#437](https://github.com/EveryInc/compound-engineering-plugin/issues/437)) ([bd02ca7](https://github.com/EveryInc/compound-engineering-plugin/commit/bd02ca7df04cf2c1c6301de3774e99d283d3d3ca))
* **ce-compound:** add discoverability check for docs/solutions/ in instruction files ([#456](https://github.com/EveryInc/compound-engineering-plugin/issues/456)) ([5ac8a2c](https://github.com/EveryInc/compound-engineering-plugin/commit/5ac8a2c2c8c258458307e476d6693cc387deb27e))
* **ce-compound:** add track-based schema for bug vs knowledge learnings ([#445](https://github.com/EveryInc/compound-engineering-plugin/issues/445)) ([739109c](https://github.com/EveryInc/compound-engineering-plugin/commit/739109c03ccd45474331625f35730924d17f63ef))
* **ce-plan:** add conditional visual aids to plan documents ([#440](https://github.com/EveryInc/compound-engineering-plugin/issues/440)) ([4c7f51f](https://github.com/EveryInc/compound-engineering-plugin/commit/4c7f51f35bae56dd9c9dc2653372910c39b8b504))
* **ce-plan:** add interactive deepening mode for on-demand plan strengthening ([#443](https://github.com/EveryInc/compound-engineering-plugin/issues/443)) ([ca78057](https://github.com/EveryInc/compound-engineering-plugin/commit/ca78057241ec64f36c562e3720a388420bdb347f))
* **ce-review:** enforce table format, require question tool, fix autofix_class calibration ([#454](https://github.com/EveryInc/compound-engineering-plugin/issues/454)) ([847ce3f](https://github.com/EveryInc/compound-engineering-plugin/commit/847ce3f156a5cdf75667d9802e95d68e6b3c53a4))
* **ce-review:** improve signal-to-noise with confidence rubric, FP suppression, and intent verification ([#434](https://github.com/EveryInc/compound-engineering-plugin/issues/434)) ([03f5aa6](https://github.com/EveryInc/compound-engineering-plugin/commit/03f5aa65b098e2ab8e25670594e0f554ea3cafbe))
* **ce-work:** suggest branch rename when worktree name is meaningless ([#451](https://github.com/EveryInc/compound-engineering-plugin/issues/451)) ([e872e15](https://github.com/EveryInc/compound-engineering-plugin/commit/e872e15efa5514dcfea84a1a9e276bad3290cbc3))
* **cli-agent-readiness-reviewer:** add smart output defaults criterion ([#448](https://github.com/EveryInc/compound-engineering-plugin/issues/448)) ([a01a8aa](https://github.com/EveryInc/compound-engineering-plugin/commit/a01a8aa0d29474c031a5b403f4f9bfc42a23ad78))
* **converters:** centralize model field normalization across targets ([#442](https://github.com/EveryInc/compound-engineering-plugin/issues/442)) ([f93d10c](https://github.com/EveryInc/compound-engineering-plugin/commit/f93d10cf60a61b13c7765198d69f7c4cfa268ed6))
* **git-commit-push-pr:** add conditional visual aids to PR descriptions ([#444](https://github.com/EveryInc/compound-engineering-plugin/issues/444)) ([44e3e77](https://github.com/EveryInc/compound-engineering-plugin/commit/44e3e77dc039d31a86194b0254e4e92839d9d5e9))
* **git-commit-push-pr:** precompute shield badge version via skill preprocessing ([#464](https://github.com/EveryInc/compound-engineering-plugin/issues/464)) ([6ca7aef](https://github.com/EveryInc/compound-engineering-plugin/commit/6ca7aef7f33ebdf29f579cb4342c209d2bd40aad))
* **model:** add MiniMax provider prefix for cross-platform model normalization ([#463](https://github.com/EveryInc/compound-engineering-plugin/issues/463)) ([e372b43](https://github.com/EveryInc/compound-engineering-plugin/commit/e372b43d30378321ac815fe1ae101c1d5634d321))
* **resolve-pr-feedback:** add gated feedback clustering to detect systemic issues ([#441](https://github.com/EveryInc/compound-engineering-plugin/issues/441)) ([a301a08](https://github.com/EveryInc/compound-engineering-plugin/commit/a301a082057494e122294f4e7c1c3f5f87103f35))
* **skills:** clean up argument-hint across ce:* skills ([#436](https://github.com/EveryInc/compound-engineering-plugin/issues/436)) ([d2b24e0](https://github.com/EveryInc/compound-engineering-plugin/commit/d2b24e07f6f2fde11cac65258cb1e76927238b5d))
* **test-xcode:** add triggering context to skill description ([#466](https://github.com/EveryInc/compound-engineering-plugin/issues/466)) ([87facd0](https://github.com/EveryInc/compound-engineering-plugin/commit/87facd05dac94603780d75acb9da381dd7c61f1b))
* **testing:** close the testing gap in ce:work, ce:plan, and testing-reviewer ([#438](https://github.com/EveryInc/compound-engineering-plugin/issues/438)) ([35678b8](https://github.com/EveryInc/compound-engineering-plugin/commit/35678b8add6a603cf9939564bcd2df6b83338c52))
### Bug Fixes
* **ce-brainstorm:** distinguish verification from technical design in Phase 1.1 ([#465](https://github.com/EveryInc/compound-engineering-plugin/issues/465)) ([8ec31d7](https://github.com/EveryInc/compound-engineering-plugin/commit/8ec31d703fc9ed19bf6377da0a9a29da935b719d))
* **ce-compound:** require question tool for "What's next?" prompt ([#460](https://github.com/EveryInc/compound-engineering-plugin/issues/460)) ([9bf3b07](https://github.com/EveryInc/compound-engineering-plugin/commit/9bf3b07185a4aeb6490116edec48599b736dc86f))
* **ce-plan:** reinforce mandatory document-review after auto deepening ([#450](https://github.com/EveryInc/compound-engineering-plugin/issues/450)) ([42fa8c3](https://github.com/EveryInc/compound-engineering-plugin/commit/42fa8c3e084db464ee0e04673f7c38cd422b32d6))
* **ce-plan:** route confidence-gate pass to document-review ([#462](https://github.com/EveryInc/compound-engineering-plugin/issues/462)) ([1962f54](https://github.com/EveryInc/compound-engineering-plugin/commit/1962f546b5e5288c7ce5d8658f942faf71651c81))
* **ce-work:** make code review invocation mandatory by default ([#453](https://github.com/EveryInc/compound-engineering-plugin/issues/453)) ([7f3aba2](https://github.com/EveryInc/compound-engineering-plugin/commit/7f3aba29e84c3166de75438d554455a71f4f3c22))
* **document-review:** show contextual next-step in Phase 5 menu ([#459](https://github.com/EveryInc/compound-engineering-plugin/issues/459)) ([2b7283d](https://github.com/EveryInc/compound-engineering-plugin/commit/2b7283da7b48dc073670c5f4d116e58255f0ffcb))
* **git-commit-push-pr:** quiet expected no-pr gh exit ([#439](https://github.com/EveryInc/compound-engineering-plugin/issues/439)) ([1f49948](https://github.com/EveryInc/compound-engineering-plugin/commit/1f499482bc65456fa7dd0f73fb7f2fa58a4c5910))
* **resolve-pr-feedback:** add actionability filter and lower cluster gate to 3+ ([#461](https://github.com/EveryInc/compound-engineering-plugin/issues/461)) ([2619ad9](https://github.com/EveryInc/compound-engineering-plugin/commit/2619ad9f58e6c45968ec10d7f8aa7849fe43eb25))
* **review:** harden ce-review base resolution ([#452](https://github.com/EveryInc/compound-engineering-plugin/issues/452)) ([638b38a](https://github.com/EveryInc/compound-engineering-plugin/commit/638b38abd267d415ad2d6b72eba3dfe12beefad9))
## [2.59.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.58.1...cli-v2.59.0) (2026-03-29)
### Features
* **ce-review:** add headless mode for programmatic callers ([#430](https://github.com/EveryInc/compound-engineering-plugin/issues/430)) ([3706a97](https://github.com/EveryInc/compound-engineering-plugin/commit/3706a9764b6e73b7a155771956646ddef73f04a5))
* **ce-work:** accept bare prompts and add test discovery ([#423](https://github.com/EveryInc/compound-engineering-plugin/issues/423)) ([6dabae6](https://github.com/EveryInc/compound-engineering-plugin/commit/6dabae6683fb2c37dc47616f172835eacc105d11))
* **document-review:** collapse batch_confirm tier into auto ([#432](https://github.com/EveryInc/compound-engineering-plugin/issues/432)) ([0f5715d](https://github.com/EveryInc/compound-engineering-plugin/commit/0f5715d562fffc626ddfde7bd0e1652143710a44))
* **review:** make review mandatory across pipeline skills ([#433](https://github.com/EveryInc/compound-engineering-plugin/issues/433)) ([9caaf07](https://github.com/EveryInc/compound-engineering-plugin/commit/9caaf071d9b74fd938567542167768f6cdb7a56f))
## [2.58.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.58.0...cli-v2.58.1) (2026-03-28)
### Bug Fixes
* **release:** align cli and compound-engineering versions with linked-versions plugin ([0bd29c7](https://github.com/EveryInc/compound-engineering-plugin/commit/0bd29c7f2e930fc1198cc7ae833394bfabd47c40))
## [2.58.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.57.1...cli-v2.58.0) (2026-03-28)
### Features
* **document-review:** add headless mode for programmatic callers ([#425](https://github.com/EveryInc/compound-engineering-plugin/issues/425)) ([4e4a656](https://github.com/EveryInc/compound-engineering-plugin/commit/4e4a6563b4aa7375e9d1c54bd73442f3b675f100))
## [2.57.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.57.0...cli-v2.57.1) (2026-03-28)
### Bug Fixes
* **onboarding:** resolve section count contradiction with skip rule ([#421](https://github.com/EveryInc/compound-engineering-plugin/issues/421)) ([d2436e7](https://github.com/EveryInc/compound-engineering-plugin/commit/d2436e7c933129784c67799a5b9555bccce2e46d))
## [2.57.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.56.0...cli-v2.57.0) (2026-03-28)
### Features
* **ce-plan:** add decision matrix form, unchanged invariants, and risk table format ([#417](https://github.com/EveryInc/compound-engineering-plugin/issues/417)) ([ccb371e](https://github.com/EveryInc/compound-engineering-plugin/commit/ccb371e0b7917420f5ca2c58433f5fc057211f04))
### Bug Fixes
* **cli-agent-readiness-reviewer:** remove top-5 cap on improvements ([#419](https://github.com/EveryInc/compound-engineering-plugin/issues/419)) ([16eb8b6](https://github.com/EveryInc/compound-engineering-plugin/commit/16eb8b660790f8de820d0fba709316c7270703c1))
* **document-review:** enforce interactive questions and fix autofix classification ([#415](https://github.com/EveryInc/compound-engineering-plugin/issues/415)) ([d447296](https://github.com/EveryInc/compound-engineering-plugin/commit/d44729603da0c73d4959c372fac0198125a39c60))
## [2.56.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.55.0...cli-v2.56.0) (2026-03-27)
### Features
* add adversarial review agents for code and documents ([#403](https://github.com/EveryInc/compound-engineering-plugin/issues/403)) ([5e6cd5c](https://github.com/EveryInc/compound-engineering-plugin/commit/5e6cd5c90950588fb9b0bc3a5cbecba2a1387080))
* add CLI agent-readiness reviewer and principles guide ([#391](https://github.com/EveryInc/compound-engineering-plugin/issues/391)) ([13aa3fa](https://github.com/EveryInc/compound-engineering-plugin/commit/13aa3fa8465dce6c037e1bb8982a2edad13f199a))
* add project-standards-reviewer as always-on ce:review persona ([#402](https://github.com/EveryInc/compound-engineering-plugin/issues/402)) ([b30288c](https://github.com/EveryInc/compound-engineering-plugin/commit/b30288c44e500013afe30b34f744af57cae117db))
* **ce-brainstorm:** group requirements by logical concern, tighten autofix classification ([#412](https://github.com/EveryInc/compound-engineering-plugin/issues/412)) ([90684c4](https://github.com/EveryInc/compound-engineering-plugin/commit/90684c4e8272b41c098ef2452c40d86d460ea578))
* **ce-plan:** strengthen test scenario guidance across plan and work skills ([#410](https://github.com/EveryInc/compound-engineering-plugin/issues/410)) ([615ec5d](https://github.com/EveryInc/compound-engineering-plugin/commit/615ec5d3feb14785530bbfe2b4a50afe29ccbc47))
* **ce-review:** add base: and plan: arguments, extract scope detection ([#405](https://github.com/EveryInc/compound-engineering-plugin/issues/405)) ([914f9b0](https://github.com/EveryInc/compound-engineering-plugin/commit/914f9b0d9822786d9ba6dc2307a543ae5a25c6e9))
* **document-review:** smarter autofix, batch-confirm, and error/omission classification ([#401](https://github.com/EveryInc/compound-engineering-plugin/issues/401)) ([0863cfa](https://github.com/EveryInc/compound-engineering-plugin/commit/0863cfa4cbebcd121b0757abf374e5095d42f989))
* **onboarding:** add consumer perspective and split architecture diagrams ([#413](https://github.com/EveryInc/compound-engineering-plugin/issues/413)) ([31326a5](https://github.com/EveryInc/compound-engineering-plugin/commit/31326a54584a12c473944fa488bea26410fd6fce))
### Bug Fixes
* add strict YAML validation for plugin frontmatter ([#399](https://github.com/EveryInc/compound-engineering-plugin/issues/399)) ([0877b69](https://github.com/EveryInc/compound-engineering-plugin/commit/0877b693ced341cec699ea959dc39f8bd78f33ef))
* clarify commit prefix selection for markdown product code ([#407](https://github.com/EveryInc/compound-engineering-plugin/issues/407)) ([4a60ee2](https://github.com/EveryInc/compound-engineering-plugin/commit/4a60ee23b77c942111f3935d325ca5c80424ceb2))
* consolidate compound-docs into ce-compound skill ([#390](https://github.com/EveryInc/compound-engineering-plugin/issues/390)) ([daddb7d](https://github.com/EveryInc/compound-engineering-plugin/commit/daddb7d72f280a3bd9645c54d091844c198a324d))
* consolidate local dev README and fix shell aliases ([#396](https://github.com/EveryInc/compound-engineering-plugin/issues/396)) ([1bd63c2](https://github.com/EveryInc/compound-engineering-plugin/commit/1bd63c2c8931b63bcafe960ea6353372ea85512a))
* document SwiftUI Text link tap limitation in test-xcode skill ([#400](https://github.com/EveryInc/compound-engineering-plugin/issues/400)) ([6ddaec3](https://github.com/EveryInc/compound-engineering-plugin/commit/6ddaec3b6ed5b6a91aeaddadff3960714ef10dc1))
* harden git workflow skills with better state handling ([#406](https://github.com/EveryInc/compound-engineering-plugin/issues/406)) ([f83305e](https://github.com/EveryInc/compound-engineering-plugin/commit/f83305e22af09c37f452cf723c1b08bb0e7c8bdf))
* improve agent-native-reviewer with triage, prioritization, and stack-aware search ([#387](https://github.com/EveryInc/compound-engineering-plugin/issues/387)) ([e792166](https://github.com/EveryInc/compound-engineering-plugin/commit/e7921660ad42db8e9af56ec36f36ce8d1af13238))
* replace broken markdown link refs in skills ([#392](https://github.com/EveryInc/compound-engineering-plugin/issues/392)) ([506ad01](https://github.com/EveryInc/compound-engineering-plugin/commit/506ad01b4f056b0d8d0d440bfb7821f050aba156))
* sanitize colons in skill/agent names for Windows path compatibility ([#398](https://github.com/EveryInc/compound-engineering-plugin/issues/398)) ([b25480a](https://github.com/EveryInc/compound-engineering-plugin/commit/b25480af9eb1e69efa2fe30a8e7048f4c6aaa53c))
## [2.55.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.54.0...cli-v2.55.0) (2026-03-26)
### Features
* add branch-based plugin install for worktree workflows ([#395](https://github.com/EveryInc/compound-engineering-plugin/issues/395)) ([e09a742](https://github.com/EveryInc/compound-engineering-plugin/commit/e09a7426be6ba1cd86122e7519abfe3376849ade))
### Bug Fixes
* prevent orphaned opening paragraphs in PR descriptions ([#393](https://github.com/EveryInc/compound-engineering-plugin/issues/393)) ([4b44a94](https://github.com/EveryInc/compound-engineering-plugin/commit/4b44a94e23c8621771b8813caebce78060a61611))
## [2.54.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.53.0...cli-v2.54.0) (2026-03-26)
### Features
* add new `onboarding` skill to create onboarding guide for repo ([#384](https://github.com/EveryInc/compound-engineering-plugin/issues/384)) ([27b9831](https://github.com/EveryInc/compound-engineering-plugin/commit/27b9831084d69c4c8cf13d0a45c901268420de59))
* replace manual review agent config with ce:review delegation ([#381](https://github.com/EveryInc/compound-engineering-plugin/issues/381)) ([fed9fd6](https://github.com/EveryInc/compound-engineering-plugin/commit/fed9fd68db283c64ec11293f88a8ad7a6373e2fe))
### Bug Fixes
* add default-branch guard to commit skills ([#386](https://github.com/EveryInc/compound-engineering-plugin/issues/386)) ([31f07c0](https://github.com/EveryInc/compound-engineering-plugin/commit/31f07c00473e9d8bd6d447cf04081c0a9631e34a))
* one-step codex installs by preferring bundled plugins ([#383](https://github.com/EveryInc/compound-engineering-plugin/issues/383)) ([f819e43](https://github.com/EveryInc/compound-engineering-plugin/commit/f819e435a54f5d7df558df5a6bee1e616a5da837))
* scope commit-push-pr descriptions to full branch diff ([#385](https://github.com/EveryInc/compound-engineering-plugin/issues/385)) ([355e739](https://github.com/EveryInc/compound-engineering-plugin/commit/355e7392b21a28c8725f87a8f9c473a86543ce4a))
## [2.53.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.52.0...cli-v2.53.0) (2026-03-25)
### Features
* add git commit and branch helper skills ([#378](https://github.com/EveryInc/compound-engineering-plugin/issues/378)) ([fe08af2](https://github.com/EveryInc/compound-engineering-plugin/commit/fe08af2b417b707b6d3192a954af7ff2ab0fe667))
* improve `resolve-pr-feedback` skill ([#379](https://github.com/EveryInc/compound-engineering-plugin/issues/379)) ([2ba4f3f](https://github.com/EveryInc/compound-engineering-plugin/commit/2ba4f3fd58d4e57dfc6c314c2992c18ba1fb164b))
* improve commit-push-pr skill with net-result focus and badging ([#380](https://github.com/EveryInc/compound-engineering-plugin/issues/380)) ([efa798c](https://github.com/EveryInc/compound-engineering-plugin/commit/efa798c52cb9d62e9ef32283227a8df68278ff3a))
* integrate orphaned stack-specific reviewers into ce:review ([#375](https://github.com/EveryInc/compound-engineering-plugin/issues/375)) ([ce9016f](https://github.com/EveryInc/compound-engineering-plugin/commit/ce9016fac5fde9a52753cf94a4903088f05aeece))
### Bug Fixes
* guard CONTEXTUAL_RISK_FLAGS lookup against prototype pollution ([#377](https://github.com/EveryInc/compound-engineering-plugin/issues/377)) ([8ebc77b](https://github.com/EveryInc/compound-engineering-plugin/commit/8ebc77b8e6c71e5bef40fcded9131c4457a387d7))
## [2.52.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.51.0...cli-v2.52.0) (2026-03-25)
### Features
* add consolidation support and overlap detection to `ce:compound` and `ce:compound-refresh` skills ([#372](https://github.com/EveryInc/compound-engineering-plugin/issues/372)) ([fe27f85](https://github.com/EveryInc/compound-engineering-plugin/commit/fe27f85810268a8e713ef2c921f0aec1baf771d7))
* minimal config for conductor support ([#373](https://github.com/EveryInc/compound-engineering-plugin/issues/373)) ([aad31ad](https://github.com/EveryInc/compound-engineering-plugin/commit/aad31adcd3d528581e8b00e78943b21fbe2c47e8))
* optimize `ce:compound` speed and effectiveness ([#370](https://github.com/EveryInc/compound-engineering-plugin/issues/370)) ([4e3af07](https://github.com/EveryInc/compound-engineering-plugin/commit/4e3af079623ae678b9a79fab5d1726d78f242ec2))
* promote `ce:review-beta` to stable `ce:review` ([#371](https://github.com/EveryInc/compound-engineering-plugin/issues/371)) ([7c5ff44](https://github.com/EveryInc/compound-engineering-plugin/commit/7c5ff445e3065fd13e00bcd57041f6c35b36f90b))
* rationalize todo skill names and optimize skills ([#368](https://github.com/EveryInc/compound-engineering-plugin/issues/368)) ([2612ed6](https://github.com/EveryInc/compound-engineering-plugin/commit/2612ed6b3d86364c74dc024e4ce35dde63fefbf6))
## [2.51.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.50.0...cli-v2.51.0) (2026-03-24)
### Features
* add `ce:review-beta` with structured persona pipeline ([#348](https://github.com/EveryInc/compound-engineering-plugin/issues/348)) ([e932276](https://github.com/EveryInc/compound-engineering-plugin/commit/e9322768664e194521894fe770b87c7dabbb8a22))
* promote ce:plan-beta and deepen-plan-beta to stable ([#355](https://github.com/EveryInc/compound-engineering-plugin/issues/355)) ([169996a](https://github.com/EveryInc/compound-engineering-plugin/commit/169996a75e98a29db9e07b87b0911cc80270f732))
* redesign `document-review` skill with persona-based review ([#359](https://github.com/EveryInc/compound-engineering-plugin/issues/359)) ([18d22af](https://github.com/EveryInc/compound-engineering-plugin/commit/18d22afde2ae08a50c94efe7493775bc97d9a45a))
## [2.50.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.49.0...cli-v2.50.0) (2026-03-23)
### Features
* **ce-work:** add Codex delegation mode ([#328](https://github.com/EveryInc/compound-engineering-plugin/issues/328)) ([341c379](https://github.com/EveryInc/compound-engineering-plugin/commit/341c37916861c8bf413244de72f83b93b506575f))
* improve `feature-video` skill with GitHub native video upload ([#344](https://github.com/EveryInc/compound-engineering-plugin/issues/344)) ([4aa50e1](https://github.com/EveryInc/compound-engineering-plugin/commit/4aa50e1bada07e90f36282accb3cd81134e706cd))
* rewrite `frontend-design` skill with layered architecture and visual verification ([#343](https://github.com/EveryInc/compound-engineering-plugin/issues/343)) ([423e692](https://github.com/EveryInc/compound-engineering-plugin/commit/423e69272619e9e3c14750f5219cbf38684b6c96))
### Bug Fixes
* quote frontend-design skill description ([#353](https://github.com/EveryInc/compound-engineering-plugin/issues/353)) ([86342db](https://github.com/EveryInc/compound-engineering-plugin/commit/86342db36c0d09b65afe11241e095dda2ad2cdb0))
## [2.49.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.48.0...cli-v2.49.0) (2026-03-22)
### Features
* add execution mode toggle and context pressure bounds to parallel skills ([#336](https://github.com/EveryInc/compound-engineering-plugin/issues/336)) ([216d6df](https://github.com/EveryInc/compound-engineering-plugin/commit/216d6dfb2c9320c3354f8c9f30e831fca74865cd))
* fix skill transformation pipeline across all targets ([#334](https://github.com/EveryInc/compound-engineering-plugin/issues/334)) ([4087e1d](https://github.com/EveryInc/compound-engineering-plugin/commit/4087e1df82138f462a64542831224e2718afafa7))
* improve reproduce-bug skill, sync agent-browser, clean up redundant skills ([#333](https://github.com/EveryInc/compound-engineering-plugin/issues/333)) ([affba1a](https://github.com/EveryInc/compound-engineering-plugin/commit/affba1a6a0d9320b529d429ad06fd5a3b5200bd8))
### Bug Fixes
* gitignore .context/ directory for Conductor ([#331](https://github.com/EveryInc/compound-engineering-plugin/issues/331)) ([0f6448d](https://github.com/EveryInc/compound-engineering-plugin/commit/0f6448d81cbc47e66004b4ecb8fb835f75aeffe2))
## [2.48.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.47.0...cli-v2.48.0) (2026-03-22)
### Features
* **git-worktree:** auto-trust mise and direnv configs in new worktrees ([#312](https://github.com/EveryInc/compound-engineering-plugin/issues/312)) ([cfbfb67](https://github.com/EveryInc/compound-engineering-plugin/commit/cfbfb6710a846419cc07ad17d9dbb5b5a065801c))
* make skills platform-agnostic across coding agents ([#330](https://github.com/EveryInc/compound-engineering-plugin/issues/330)) ([52df90a](https://github.com/EveryInc/compound-engineering-plugin/commit/52df90a16688ee023bbdb203969adcc45d7d2ba2))
## [2.47.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.46.0...cli-v2.47.0) (2026-03-20)
### Features
* improve `repo-research-analyst` by adding a structured technology scan ([#327](https://github.com/EveryInc/compound-engineering-plugin/issues/327)) ([1c28d03](https://github.com/EveryInc/compound-engineering-plugin/commit/1c28d0321401ad50a51989f5e6293d773ac1a477))
### Bug Fixes
* **skills:** update ralph-wiggum references to ralph-loop in lfg/slfg ([#324](https://github.com/EveryInc/compound-engineering-plugin/issues/324)) ([ac756a2](https://github.com/EveryInc/compound-engineering-plugin/commit/ac756a267c5e3d5e4ceb2f99939dbb93491ac4d2))
## [2.46.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.45.0...cli-v2.46.0) (2026-03-20)
### Features
* add optional high-level technical design to plan-beta skills ([#322](https://github.com/EveryInc/compound-engineering-plugin/issues/322)) ([3ba4935](https://github.com/EveryInc/compound-engineering-plugin/commit/3ba4935926b05586da488119f215057164d97489))
### Bug Fixes
* **ci:** add npm registry auth to release publish job ([#319](https://github.com/EveryInc/compound-engineering-plugin/issues/319)) ([3361a38](https://github.com/EveryInc/compound-engineering-plugin/commit/3361a38108991237de51050283e781be847c6bd3))
## [2.45.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.44.0...cli-v2.45.0) (2026-03-19)
### Features
* edit resolve_todos_parallel skill for complete todo lifecycle ([#292](https://github.com/EveryInc/compound-engineering-plugin/issues/292)) ([88c89bc](https://github.com/EveryInc/compound-engineering-plugin/commit/88c89bc204c928d2f36e2d1f117d16c998ecd096))
* integrate claude code auto memory as supplementary data source for ce:compound and ce:compound-refresh ([#311](https://github.com/EveryInc/compound-engineering-plugin/issues/311)) ([5c1452d](https://github.com/EveryInc/compound-engineering-plugin/commit/5c1452d4cc80b623754dd6fe09c2e5b6ae86e72e))
### Bug Fixes
* add cursor-marketplace as release-please component ([#315](https://github.com/EveryInc/compound-engineering-plugin/issues/315)) ([838aeb7](https://github.com/EveryInc/compound-engineering-plugin/commit/838aeb79d069b57a80d15ff61d83913919b81aef))
## [2.44.0](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.43.2...cli-v2.44.0) (2026-03-18)
### Features
* **plugin:** add execution posture signaling to ce:plan-beta and ce:work ([#309](https://github.com/EveryInc/compound-engineering-plugin/issues/309)) ([748f72a](https://github.com/EveryInc/compound-engineering-plugin/commit/748f72a57f713893af03a4d8ed69c2311f492dbd))
## [2.43.2](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v2.43.1...cli-v2.43.2) (2026-03-18)
### Bug Fixes
* enable release-please labeling so it can find its own PRs ([a7d6e3f](https://github.com/EveryInc/compound-engineering-plugin/commit/a7d6e3fbba862d4e8b4e1a0510f0776e9e274b89))
* re-enable changelogs so release PRs accumulate correctly ([516bcc1](https://github.com/EveryInc/compound-engineering-plugin/commit/516bcc1dc4bf4e4756ae08775806494f5b43968a))
* reduce release-please search depth from 500 to 50 ([f1713b9](https://github.com/EveryInc/compound-engineering-plugin/commit/f1713b9dcd0deddc2485e8cf0594266232bf0019))
* remove close-stale-PR step that broke release creation ([178d6ec](https://github.com/EveryInc/compound-engineering-plugin/commit/178d6ec282512eaee71ab66d45832d22d75353ec))
## Changelog
Release notes now live in GitHub Releases for this repository:
https://github.com/EveryInc/compound-engineering-plugin/releases
Multi-component releases are published under component-specific tags such as:
- `cli-vX.Y.Z`
- `compound-engineering-vX.Y.Z`
- `coding-tutor-vX.Y.Z`
- `marketplace-vX.Y.Z`
Do not add new release entries here. New release notes are managed by release automation in GitHub.
================================================
FILE: CONCEPTS.md
================================================
# Concepts
Shared domain vocabulary for this project — entities, named processes, and status concepts with project-specific meaning. Seeded with core domain vocabulary, then accretes as ce-compound and ce-compound-refresh process learnings; direct edits are fine. Glossary only, not a spec or catch-all.
## The plugin and its parts
### Plugin
A distributable bundle of Skills, Agents, Commands, and Hooks (optionally MCP servers) described by a single manifest and installed into a coding-agent platform as one unit — the artifact the Converter translates for non-Claude Targets and the Marketplace distributes.
### Skill
A user-invoked capability defined in its own directory, and the primary entry point a user reaches for. A Skill orchestrates: it can progressively pull in its own reference files as needed and dispatch generic subagents seeded with Specialist prompt assets. Distinct from an Agent in that a Skill is user-invoked and coordinates, whereas an Agent or subagent is dispatched to perform scoped work.
### Agent
A specialized, single-purpose worker running in its own isolated context and returning a result, rather than conversing with the user. Also called a subagent. In the current plugin design, most CE specialist behavior is not exposed as standalone Agent definitions; Skills seed generic subagents with Skill-local prompt material instead.
### Specialist prompt asset
An internal prompt file owned by one Skill that defines a specialist persona or research/review role for a generic subagent. It is not an externally exposed plugin component: the owning Skill controls when it is loaded, which model or tool policy applies, and how its output is merged.
## Conversion
### Target
A destination coding-agent platform other than Claude Code (OpenCode, Codex, Pi, Antigravity, Kimi Code, and others) that the repo supports through native plugin metadata or a Converter/Writer pair. Also called a target provider when it uses the conversion path.
A Plugin is installed to a Target at one of two scopes: global (user-wide) or per-workspace.
### Native plugin surface
A platform-provided install contract that can consume this repo's committed plugin manifest or marketplace metadata directly, without generating a converted Bundle. When a Target has a native plugin surface, user-facing support usually belongs in platform metadata, release validation, and docs instead of a new Converter and Writer.
### Converter
The step that transforms a parsed Plugin into one Target's in-memory form, mapping tools, permissions, hooks, and model names explicitly rather than by convention.
### Writer
The step that emits a Target's converted Bundle onto disk, in that Target's expected paths and merge semantics. Paired with a Converter, one per Target.
### Bundle
The in-memory converted form of a Plugin for a single Target — the handoff a Converter produces and a Writer consumes.
### Install manifest
A per-plugin ledger, written by a Writer at install time, of exactly which skill, agent, prompt, and extension paths that install created on a Target — the record later installs consult to tell tool-owned content apart from user-managed content.
The load-bearing invariant is that a Writer never claims a path it did not write: a path the user has replaced (a symlink into a personal fork, a hand-authored directory) is excluded from the manifest and preserved on reinstall rather than overwritten, and the ledger is self-healing — removing the override lets the next install resume tracking that path. A path with no manifest entry — including one from an install predating the mechanism — reads as unowned and is therefore preserved.
### Marketplace
The catalog metadata listing installable plugins and their versions for distribution, kept consistent with each Plugin's manifest by release validation.
## Compound engineering
### Compound engineering
The methodology this project embodies: structure engineering work so each unit makes the next one easier, capturing reusable knowledge as you go so the toolset gets smarter with every use.
### Pipeline
The chained progression of Skills that carries a piece of work from strategy and ideation through brainstorm, plan, execution, and review, and closes by capturing what was learned. Each stage hands a durable artifact to the next, and research is gathered at the stage that needs it rather than re-gathered downstream.
### Learning
A documented solution to a past problem — a bug fix, a convention, or a workflow pattern — stored as the unit of compounded knowledge so future work can find and reuse it. Also called a solution doc. Carries structured metadata (category, tags, problem type) for retrieval; its creation date lives in the entry, not the filename.
### Pattern doc
Guidance generalized from several Learnings into a broader rule. Higher-leverage than any single incident-level Learning, and higher-risk when stale, because future work treats it as broadly applicable.
### Explainer
A dense, visual teaching artifact written for the developer personally — explaining a concept, a change, an idea, or a window of their own recent work — so the human keeps learning when agents do the writing. The complement of a Learning: a Learning teaches the repo's future work; an explainer teaches the human.
### Check-in
The active-recall step that can follow an explainer in the same session: the developer predicts or answers first and the explanation confirms or corrects — predict-then-reveal for changes, checked exercises for concepts. Skippable when the material does not warrant retention work.
### Concept-teaching section
A conditional section of a generated PR description, added by agent judgment when the change introduces a concept new to the codebase, that teaches the concept — what it is, why it was chosen here, and an example from the PR — so a reader can understand and re-explain the change without reading the diff. The passive, in-description counterpart of an Explainer.
## Skill orchestration
### Model tier
A semantic cost class for a dispatched sub-agent — extraction (cheapest capable, for retrieval and quoting), generation (mid-tier, for evidence-driven work and mechanical verification), or ceiling (the orchestrator's own model, inherited by omitting any model selection) — declared once per Skill and referenced by tier name so model names never hardcode into skill content.
When a platform cannot select models per agent, every role runs on the inherited model and cost control falls back to structure: read budgets and output caps.
### Evidence dossier
A bulk evidence artifact — verbatim quotes with source pointers, gathered by a cheap scout agent — written to scratch storage instead of returned inline, so the orchestrator carries only a short gist and downstream agents read the full dossier themselves.
### Load stub
The inline remnant left in a Skill when load-bearing content moves to a reference file: a load instruction that names what the reference contains and the failure mode of skipping it, while keeping no detail an agent could improvise from — making the load structurally necessary rather than advisory.
### Detached job
A delegated worker process launched into its own session so it outlives the shell tool call that started it, with its state — status word, log, identity, and result — kept in a durable job directory the orchestrator polls between turns instead of awaiting in place.
The launching call returns as soon as the job exists; supervision (idle and hard limits, process-tree reaping) runs inside the detached worker, while the caller keeps its own aggregate deadline and proceeds without the job when that passes. A job publishes exactly one terminal record, atomically, and nothing in the detached path may prompt for input.
### Model identity receipt
The serving backend's own report of which model actually handled a delegated run, recorded alongside the requested model so the two can disagree visibly. A run's model identity is verified only by such a receipt — never by the request parameters or the model's own text — and outputs without one are labeled as requested-but-unverified; logic that weights cross-model agreement follows the receipt, not the request.
## Review and workflow vocabulary
### Reviewer persona
A single-lens reviewer role that evaluates work from one specific perspective — security, correctness, scope, design, and so on. Review Skills dispatch a panel of personas as subagents and merge their findings.
### Confidence anchor
A discrete, self-scored confidence value on a fixed small scale, each level tied to a behavioral criterion the model can honestly apply, used to gate and rank review findings instead of a continuous score that invites false precision. Each review Skill sets its own actionable threshold; corroboration across personas promotes a finding by one level.
### Autofix class
The classification of a review finding by how safely its proposed fix can be applied: applied silently, applied only after user confirmation, left for a human to resolve, or recorded as advisory with no action.
### Headless mode
An explicit opt-in mode that runs a Skill unattended, with no user prompts — it produces a written report as its deliverable and conservatively defers genuinely ambiguous decisions rather than guessing.
### Session-settled decision
A decision examined and chosen by the user in the invoking conversation — a surfaced tradeoff or alternative followed by the user's choice — carried through the Pipeline as a provenance-labeled constraint (annotation stem `session-settled:`, classes `user-directed` and `user-approved`) that downstream skills augment but never re-ask, and contradict only on evidence. An unexamined assertion is a directive, not a settled decision, and receives exactly one in-pipeline challenge; agents never label their own unexamined proposals.
### Settlement test
The classification judgment a writer skill (ce-plan, ce-brainstorm) applies to conversation-carried decisions: settled if the decision survived examination in the conversation record, a directive if merely asserted, unlabeled if only ever agent-inferred. The test's outcome rules are protocol; the classification itself is agent judgment.
### Feedback source
A configured origin of customer or user feedback — a Slack channel, a GitHub Issues repo, an email inbox — declared once in the shared local config under a generic key so any Skill can read the list. Each source entry has its own identity and ingestion cursor; the Skill that ingests from it owns the per-item state, not the source declaration.
### Beta skill
A parallel copy of a stable Skill, suffixed `-beta`, used to trial a new version alongside the stable one without disrupting users. Invoked manually (model auto-invocation is disabled); promoting it to stable is more than a rename — every caller must move in the same change so none silently inherits stale defaults, and the retired beta name must be registered for stale-artifact cleanup so upgrading users don't keep a dead duplicate of the skill alongside the promoted one.
================================================
FILE: GEMINI.md
================================================
# Compound Engineering
This Gemini extension provides the Compound Engineering skill set for planning,
review, implementation, debugging, and release workflows.
Use the installed skills when they match the user's request. Treat this file as
runtime context for extension users, not contributor guidance for this source
repository. Do not apply this repository's `AGENTS.md` maintainer workflow to
the user's project.
================================================
FILE: LICENSE
================================================
MIT License
Copyright (c) 2025 Every
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
================================================
FILE: PRIVACY.md
================================================
# Privacy & Data Handling
This repository contains:
- a root plugin package made of markdown/config content
- a CLI (`@every-env/compound-plugin`) that converts and installs plugin content for different AI coding tools
## Summary
- The plugin package does not include telemetry or analytics code.
- The plugin package does not run a background service that uploads repository/workspace contents automatically.
- Data leaves your machine only when your host/tooling or an explicitly invoked integration performs a network request.
## What May Send Data
1. AI host/model providers
If you run the plugin in tools like Claude Code, Cursor, Codex, Gemini CLI, Copilot, Windsurf, etc., those tools may send prompts/context/code to their configured model providers. This behavior is controlled by those tools and providers, not by this plugin repository.
2. Optional integrations and tools
The plugin includes optional capabilities that can call external services when explicitly used, for example:
- Context7 MCP (`https://mcp.context7.com/mcp`) for documentation lookup
- Proof (`https://www.proofeditor.ai`) when using share/edit flows
- Other opt-in skills (for example image generation or cloud upload workflows) that call their own external APIs/services
If you do not invoke these integrations, they do not transmit your project data.
3. Package/installer infrastructure
Installing dependencies or packages (for example `npm`, `bunx`) communicates with package registries/CDNs according to your package manager configuration.
## Data Ownership and Retention
This repository does not operate a backend service for collecting or storing your project/workspace data. Data retention and processing for model prompts or optional integrations are governed by the external services you use.
## Security Reporting
If you identify a security issue in this repository, follow the disclosure process in [SECURITY.md](SECURITY.md).
================================================
FILE: README.md
================================================
# Compound Engineering
[](https://github.com/EveryInc/compound-engineering-plugin/actions/workflows/ci.yml)
AI skills that make each unit of engineering work easier than the last.
## Philosophy
**Each unit of engineering work should make subsequent units easier -- not harder.**
Traditional development accumulates technical debt. Every feature adds complexity. Every bug fix leaves behind a little more local knowledge that someone has to rediscover later. The codebase gets larger, the context gets harder to hold, and the next change becomes slower.
Compound engineering inverts this. 80% is in planning and review, 20% is in execution:
- Plan thoroughly before writing code with `/ce-brainstorm` and `/ce-plan` using one readiness-based plan artifact
- Review to catch issues and calibrate judgment with `/ce-code-review` and `/ce-doc-review`
- Codify knowledge so it is reusable with `/ce-compound`
- Keep quality high so future changes are easy
The point is not ceremony. The point is leverage. A good brainstorm makes the plan sharper. A good plan makes execution smaller. A good review catches the pattern, not just the bug. A good compound note means the next agent does not have to learn the same lesson from scratch.
**Learn more**
- [Skill documentation catalog](docs/skills/README.md)
- [Compound engineering: how Every codes with agents](https://every.to/chain-of-thought/compound-engineering-how-every-codes-with-agents)
- [The story behind compounding engineering](https://every.to/source-code/my-ai-had-already-fixed-the-code-before-i-saw-it)
## Workflow
The core loop is six steps: **brainstorm** the requirements, **plan** the implementation, **work** through the plan, **simplify** what you wrote, **review** the result, then **compound** the learning -- and repeat with better context.
| Skill | Purpose |
|-------|---------|
| [`/ce-brainstorm`](docs/skills/ce-brainstorm.md) | Interactive Q&A to think through a feature or problem and write a requirements-only unified plan before planning |
| [`/ce-plan`](docs/skills/ce-plan.md) | Enrich feature ideas or requirements-only plans into implementation-ready plans |
| [`/ce-work`](docs/skills/ce-work.md) | Execute implementation-ready plans with worktrees and task tracking |
| [`/ce-simplify-code`](docs/skills/ce-simplify-code.md) | Refine the freshly written code for clarity and reuse before review |
| [`/ce-code-review`](docs/skills/ce-code-review.md) | Multi-agent review against the plan before merging |
| [`/ce-compound`](docs/skills/ce-compound.md) | Capture the learning into `docs/solutions/` so the next loop starts smarter |
Each cycle compounds: `/ce-compound` writes learnings that the next `/ce-brainstorm` and `/ce-plan` read as grounding -- brainstorms sharpen plans, plans inform future plans, reviews catch more issues, patterns get documented. That return arrow is the whole point.
### Additional skills
These sit around the loop or get reached for on demand -- not every cycle needs them.
| Skill | When to reach for it |
|-------|---------|
| [`/ce-ideate`](docs/skills/ce-ideate.md) | *Before the loop*, when you don't yet know what to build -- generates and critically ranks grounded ideas, then routes the strongest one into `/ce-brainstorm` |
| [`/ce-strategy`](docs/skills/ce-strategy.md) | *Upstream anchor* -- creates and maintains `STRATEGY.md`, read as grounding by ideate, brainstorm, and plan so strategy choices flow into every feature |
| [`/ce-product-pulse`](docs/skills/ce-product-pulse.md) | *Outer loop* -- a time-windowed report on what users actually experienced (usage, performance, errors), saved to `docs/pulse-reports/`; its follow-ups feed back into ideation and brainstorming |
| [`/ce-debug`](docs/skills/ce-debug.md) | *Instead of brainstorm -> plan -> work* when the input is a bug rather than a feature -- reproduce, trace root cause, fix, then polish/review before PR handoff when warranted |
| [`/ce-pov`](docs/skills/ce-pov.md) | *On demand, before you commit* -- a decisive, project-grounded verdict on whether to adopt, switch to, or revisit an external technology, library, pattern, or platform; works cold or mid-session, and proposes the next step (`/ce-plan`, `/ce-brainstorm`, or a spike) from the verdict |
| [`/ce-explain`](docs/skills/ce-explain.md) | *On demand, to keep learning* -- turns a concept, a diff, an idea, or "what did I do this week?" into a dense, visual explainer written for you personally, with an optional check-in (predict-then-reveal for diffs, corrected exercises) that makes it stick |
For the full catalog and how each skill chains together, see [docs/skills](docs/skills/README.md). The complete inventory is [below](#full-skill-inventory).
## Quick Example
**Finding a direction** -- when you don't have a specific idea yet, ideate first, then carry the strongest survivor into the loop:
```text
/ce-ideate new drawing tools
/ce-ideate surprise me
/ce-ideate github issues # ground ideas in your open issues instead of a prompt
```
`/ce-ideate` does the homework first (codebase, past learnings, prior art on the web, optionally your issue tracker), then hands you a ranked set of grounded candidates to take into `/ce-brainstorm`.
**Standard feature loop** -- turn a rough idea into shipped, reviewed code:
```text
/ce-brainstorm make background job retries safer
/ce-plan
/ce-work
/ce-simplify-code
/ce-code-revi
gitextract_fchwsspe/ ├── .agents/ │ └── plugins/ │ └── marketplace.json ├── .agy/ │ └── INSTALL.md ├── .claude/ │ └── commands/ │ └── triage-prs.md ├── .claude-plugin/ │ ├── CHANGELOG.md │ ├── marketplace.json │ └── plugin.json ├── .cline/ │ ├── INSTALL.md │ └── scripts/ │ └── install-skills.sh ├── .codex-plugin/ │ └── plugin.json ├── .compound-engineering/ │ └── config.local.example.yaml ├── .cursor-plugin/ │ ├── CHANGELOG.md │ ├── marketplace.json │ └── plugin.json ├── .devin-plugin/ │ └── plugin.json ├── .github/ │ ├── .release-please-manifest.json │ ├── release-please-config.json │ └── workflows/ │ ├── ci.yml │ ├── release-pr.yml │ └── release-preview.yml ├── .gitignore ├── .grok-plugin/ │ ├── marketplace.json │ └── plugin.json ├── .kimi-plugin/ │ ├── marketplace.json │ └── plugin.json ├── .opencode/ │ ├── INSTALL.md │ └── plugins/ │ └── compound-engineering.js ├── .pi/ │ └── extensions/ │ └── compound-engineering.ts ├── AGENTS.md ├── CHANGELOG.md ├── CONCEPTS.md ├── GEMINI.md ├── LICENSE ├── PRIVACY.md ├── README.md ├── SECURITY.md ├── docs/ │ ├── brainstorms/ │ │ ├── 2026-02-14-copilot-converter-target-brainstorm.md │ │ ├── 2026-02-17-copilot-skill-naming-brainstorm.md │ │ ├── 2026-03-14-ce-plan-rewrite-requirements.md │ │ ├── 2026-03-15-ce-ideate-skill-requirements.md │ │ ├── 2026-03-16-issue-grounded-ideation-requirements.md │ │ ├── 2026-03-17-release-automation-requirements.md │ │ ├── 2026-03-18-auto-memory-integration-requirements.md │ │ ├── 2026-03-22-frontend-design-skill-improvement.md │ │ ├── 2026-03-23-plan-review-personas-requirements.md │ │ ├── 2026-03-25-config-storage-redesign-requirements.md │ │ ├── 2026-03-25-vonboarding-skill-requirements.md │ │ ├── 2026-03-26-merge-deepen-into-plan-requirements.md │ │ ├── 2026-03-27-ce-skill-prefix-rename-requirements.md │ │ ├── 2026-03-28-ce-review-headless-mode-requirements.md │ │ ├── 2026-03-29-iterative-optimization-loop-requirements.md │ │ ├── 2026-03-29-testing-addressed-gate-requirements.md │ │ ├── 2026-03-30-cli-readiness-review-persona-requirements.md │ │ ├── 2026-03-31-codex-delegation-requirements.md │ │ ├── 2026-04-01-cross-invocation-cluster-analysis-requirements.md │ │ ├── 2026-04-02-slack-analyst-agent-requirements.md │ │ ├── 2026-04-05-universal-planning-requirements.md │ │ ├── 2026-04-17-ce-release-notes-skill-requirements.md │ │ ├── 2026-04-17-ce-review-interactive-judgment-requirements.md │ │ ├── 2026-04-18-ce-doc-review-autofix-and-interaction-requirements.md │ │ ├── 2026-04-22-demo-reel-local-save-requirements.md │ │ ├── 2026-04-24-surface-scope-earlier-requirements.md │ │ ├── 2026-05-19-vscode-copilot-agent-tool-access-requirements.md │ │ ├── 2026-06-04-ce-plan-approach-altitude-requirements.md │ │ └── 2026-06-19-agentless-plugin-surface-reduction-requirements.md │ ├── grok-marketplace-submission.md │ ├── ideation/ │ │ └── 2026-06-28-ce-pov-skill-proposal.html │ ├── plans/ │ │ ├── 2026-02-08-feat-convert-local-md-settings-for-opencode-codex-plan.md │ │ ├── 2026-02-08-feat-pr-triage-and-merge-plan.md │ │ ├── 2026-02-08-feat-simplify-plugin-settings-plan.md │ │ ├── 2026-02-08-refactor-reduce-plugin-context-token-usage-plan.md │ │ ├── 2026-02-09-refactor-dspy-ruby-skill-update-plan.md │ │ ├── 2026-02-12-feat-add-cursor-cli-target-provider-plan.md │ │ ├── 2026-02-14-feat-add-copilot-converter-target-plan.md │ │ ├── 2026-02-14-feat-add-gemini-cli-target-provider-plan.md │ │ ├── 2026-02-14-feat-auto-detect-install-and-gemini-sync-plan.md │ │ ├── 2026-02-25-feat-windsurf-global-scope-support-plan.md │ │ ├── 2026-03-01-feat-ce-command-aliases-backwards-compatible-deprecation-plan.md │ │ ├── 2026-03-01-fix-setup-skill-non-claude-llm-fallback-plan.md │ │ ├── 2026-03-03-feat-sync-claude-mcp-all-supported-providers-plan.md │ │ ├── 2026-03-15-001-feat-ce-ideate-skill-plan.md │ │ ├── 2026-03-16-001-feat-issue-grounded-ideation-plan.md │ │ ├── 2026-03-17-001-feat-release-automation-migration-beta-plan.md │ │ ├── 2026-03-18-001-feat-auto-memory-integration-beta-plan.md │ │ ├── 2026-03-22-001-feat-frontend-design-skill-rewrite-beta-plan.md │ │ ├── 2026-03-23-001-feat-ce-review-beta-pipeline-mode-beta-plan.md │ │ ├── 2026-03-23-001-feat-plan-review-personas-beta-plan.md │ │ ├── 2026-03-23-001-feat-promote-plan-beta-skills-to-stable-plan.md │ │ ├── 2026-03-25-001-feat-onboarding-skill-plan.md │ │ ├── 2026-03-25-002-refactor-config-storage-redesign-plan.md │ │ ├── 2026-03-26-001-feat-adversarial-review-agents-plan.md │ │ ├── 2026-03-26-001-refactor-merge-deepen-into-plan.md │ │ ├── 2026-03-27-001-refactor-ce-skill-prefix-rename-plan.md │ │ ├── 2026-03-28-001-feat-ce-review-headless-mode-plan.md │ │ ├── 2026-03-29-001-feat-brainstorm-visual-aids-plan.md │ │ ├── 2026-03-29-001-feat-iterative-optimization-loop-skill-beta-plan.md │ │ ├── 2026-03-29-001-feat-testing-addressed-gate-plan.md │ │ ├── 2026-03-29-002-feat-plan-visual-aids-plan.md │ │ ├── 2026-03-29-002-feat-pr-feedback-clustering-plan.md │ │ ├── 2026-03-29-003-feat-pr-description-visual-aids-plan.md │ │ ├── 2026-03-30-001-feat-cli-readiness-review-persona-plan.md │ │ ├── 2026-03-31-001-feat-codex-delegation-plan.md │ │ ├── 2026-04-01-001-feat-cross-invocation-cluster-analysis-plan.md │ │ ├── 2026-04-02-001-feat-slack-analyst-agent-plan.md │ │ ├── 2026-04-05-001-feat-universal-planning-plan.md │ │ ├── 2026-04-09-001-feat-ce-work-token-extraction-plan.md │ │ ├── 2026-04-15-001-feat-ce-polish-skill-plan.md │ │ ├── 2026-04-16-001-fix-ce-polish-beta-detection-gaps-plan.md │ │ ├── 2026-04-17-001-feat-ce-ideate-mode-aware-v2-plan.md │ │ ├── 2026-04-17-001-feat-ce-release-notes-skill-plan.md │ │ ├── 2026-04-17-002-feat-ce-review-interactive-judgment-plan.md │ │ ├── 2026-04-18-001-feat-ce-doc-review-autofix-and-interaction-overhaul-plan.md │ │ ├── 2026-04-18-001-refactor-native-install-cleanup-plan.md │ │ ├── 2026-04-20-001-feat-codex-native-plugin-manifests-plan.md │ │ ├── 2026-04-20-001-fix-ce-compound-yaml-safety-plan.md │ │ ├── 2026-04-21-001-feat-ce-plan-traceability-loop-plan.md │ │ ├── 2026-04-21-001-refactor-ce-doc-review-anchored-confidence-scoring-plan.md │ │ ├── 2026-04-21-002-refactor-ce-code-review-precision-and-validation-plan.md │ │ ├── 2026-04-22-001-feat-demo-reel-local-save-plan.md │ │ ├── 2026-04-25-001-fix-ce-code-review-lfg-defer-bias-plan.md │ │ ├── 2026-04-26-feat-surface-scope-earlier-plan.md │ │ ├── 2026-05-08-001-fix-ce-sessions-orchestration-refactor-plan.md │ │ ├── 2026-05-11-001-feat-output-html-mode-plan.md │ │ ├── 2026-06-02-001-feat-ce-code-review-safe-autofix-plan.md │ │ ├── 2026-06-04-001-feat-ce-plan-approach-altitude-plan.md │ │ ├── 2026-06-18-001-refactor-unified-plan-doc-artifact-plan.md │ │ ├── 2026-06-22-001-feat-antigravity-target-remove-gemini-plan.md │ │ ├── 2026-06-26-001-chore-remove-ce-work-beta-plan.html │ │ ├── 2026-06-28-001-feat-ce-pov-skill-plan.md │ │ ├── 2026-06-29-001-feat-shared-repo-grounding-cache-plan.md │ │ ├── 2026-07-02-001-feat-ce-sweep-skill-plan.md │ │ ├── 2026-07-02-002-feat-ce-explain-skill-plan.md │ │ ├── 2026-07-05-001-feat-devin-cli-native-plugin-support-plan.md │ │ ├── 2026-07-07-001-feat-pr-concept-teaching-plan.md │ │ ├── 2026-07-08-001-fix-model-alias-map-latest-generations-plan.md │ │ ├── 2026-07-09-001-feat-grok-plugin-support-plan.md │ │ ├── 2026-07-09-001-fix-ce-test-browser-native-driver-plan.md │ │ ├── 2026-07-09-002-feat-claude-code-fable-elevation-plan.md │ │ ├── 2026-07-09-003-feat-doc-review-cross-model-plan.md │ │ ├── 2026-07-11-001-feat-babysit-self-initiating-loop-plan.md │ │ ├── 2026-07-13-001-feat-code-review-line-provenance-plan.md │ │ ├── 2026-07-13-001-fix-ce-proof-v3-owner-lifecycle-plan.md │ │ ├── 2026-07-13-002-feat-code-review-cross-model-provider-port-plan.md │ │ ├── 2026-07-14-001-feat-session-settled-decisions-plan.md │ │ ├── 2026-07-14-001-fix-detached-peer-job-lifecycle-plan.md │ │ ├── babysit-non-convergence-detection.md │ │ ├── feature_opencode-commands-as-md-and-config-merge.md │ │ └── pipeline-mode-contract-and-lfg-babysit-consolidation.md │ ├── residual-review-findings/ │ │ └── feat-ce-explain-skill.md │ ├── skills/ │ │ ├── README.md │ │ ├── ce-babysit-pr.md │ │ ├── ce-brainstorm.md │ │ ├── ce-code-review.md │ │ ├── ce-commit-push-pr.md │ │ ├── ce-commit.md │ │ ├── ce-compound-refresh.md │ │ ├── ce-compound.md │ │ ├── ce-debug.md │ │ ├── ce-doc-review.md │ │ ├── ce-dogfood.md │ │ ├── ce-explain.md │ │ ├── ce-ideate.md │ │ ├── ce-optimize.md │ │ ├── ce-plan.md │ │ ├── ce-polish.md │ │ ├── ce-pov.md │ │ ├── ce-product-pulse.md │ │ ├── ce-promote.md │ │ ├── ce-proof.md │ │ ├── ce-resolve-pr-feedback.md │ │ ├── ce-riffrec-feedback-analysis.md │ │ ├── ce-setup.md │ │ ├── ce-simplify-code.md │ │ ├── ce-strategy.md │ │ ├── ce-sweep.md │ │ ├── ce-test-browser.md │ │ ├── ce-test-xcode.md │ │ ├── ce-work.md │ │ ├── ce-worktree.md │ │ └── lfg.md │ ├── solutions/ │ │ ├── adding-converter-target-providers.md │ │ ├── agent-friendly-cli-principles.md │ │ ├── architecture-patterns/ │ │ │ └── host-native-browser-driver-selection.md │ │ ├── best-practices/ │ │ │ ├── cache-invalidation-input-set-completeness.md │ │ │ ├── ce-pipeline-end-to-end-learnings.md │ │ │ ├── codex-delegation-best-practices.md │ │ │ ├── conditional-visual-aids-in-generated-documents.md │ │ │ ├── predictable-tmp-cache-ownership-check.md │ │ │ ├── prefer-python-over-bash-for-pipeline-scripts.md │ │ │ └── preserve-user-content-across-all-destructive-paths.md │ │ ├── codex-skill-prompt-entrypoints.md │ │ ├── conventions/ │ │ │ └── antigravity-target-empirical-format-verification.md │ │ ├── developer-experience/ │ │ │ └── branch-based-plugin-install-and-testing.md │ │ ├── integrations/ │ │ │ ├── colon-namespaced-names-break-windows-paths.md │ │ │ ├── cross-platform-model-field-normalization.md │ │ │ ├── kimi-native-plugin-manifest-support.md │ │ │ ├── native-plugin-install-strategy.md │ │ │ └── opencode-temperature-rejected-by-sonnet5-opus48.md │ │ ├── plugin-versioning-requirements.md │ │ ├── skill-design/ │ │ │ ├── arguments-token-is-claude-only-in-skill-bodies.md │ │ │ ├── authoring-auto-invoke-standing-instructions.md │ │ │ ├── beta-promotion-cleanup-registry-wiring.md │ │ │ ├── beta-promotion-orchestration-contract.md │ │ │ ├── beta-skills-framework.md │ │ │ ├── bundled-script-path-resolution-across-harnesses.md │ │ │ ├── ce-doc-review-calibration-patterns.md │ │ │ ├── ce-prefix-required-for-skills-and-agents.md │ │ │ ├── compound-refresh-skill-improvements.md │ │ │ ├── confidence-anchored-scoring.md │ │ │ ├── cross-harness-cross-model-tool-invocation.md │ │ │ ├── cross-skill-shared-cache-primitive.md │ │ │ ├── detached-job-lifecycle-for-delegated-work.md │ │ │ ├── discoverability-check-for-documented-solutions.md │ │ │ ├── fake-cli-harness-for-skill-judgment-evals.md │ │ │ ├── frontier-model-skill-modernization-methodology.md │ │ │ ├── git-workflow-skills-need-explicit-state-machines.md │ │ │ ├── no-load-time-pre-resolution-for-fallible-context.md │ │ │ ├── paired-old-vs-new-injection-skill-evals.md │ │ │ ├── pass-paths-not-content-to-subagents.md │ │ │ ├── portable-agent-skill-authoring.md │ │ │ ├── post-menu-routing-belongs-inline.md │ │ │ ├── requested-vs-verified-model-identity.md │ │ │ ├── research-agent-pipeline-separation.md │ │ │ ├── safe-auto-rubric-calibration.md │ │ │ ├── script-first-skill-architecture.md │ │ │ ├── strong-models-mask-defensive-skill-fixes.md │ │ │ └── watch-loops-need-a-blocked-external-terminal-state.md │ │ └── workflow/ │ │ ├── manual-release-please-github-releases.md │ │ ├── release-please-version-drift-recovery.md │ │ └── stale-local-base-contamination.md │ └── specs/ │ ├── antigravity.md │ ├── claude-code.md │ ├── cline.md │ ├── codex.md │ ├── copilot.md │ ├── cursor.md │ ├── devin.md │ ├── kimi.md │ ├── kiro.md │ └── opencode.md ├── package.json ├── plugin.json ├── scripts/ │ └── release/ │ ├── preview.ts │ ├── sync-metadata.ts │ └── validate.ts ├── skills/ │ ├── ce-babysit-pr/ │ │ ├── SKILL.md │ │ ├── references/ │ │ │ └── watch-loop.md │ │ └── scripts/ │ │ └── pr-snapshot │ ├── ce-brainstorm/ │ │ ├── SKILL.md │ │ ├── references/ │ │ │ ├── agents/ │ │ │ │ ├── repo-profiler.md │ │ │ │ └── slack-researcher.md │ │ │ ├── blindspot-pass.md │ │ │ ├── brainstorm-sections.md │ │ │ ├── handoff.md │ │ │ ├── html-rendering.md │ │ │ ├── markdown-rendering.md │ │ │ ├── model-tiers.md │ │ │ ├── product-pressure-test.md │ │ │ ├── reasoning-elevation.md │ │ │ ├── repo-profile-cache.md │ │ │ ├── settled-decisions.md │ │ │ ├── synthesis-summary.md │ │ │ ├── universal-brainstorming.md │ │ │ ├── verdict-routing.md │ │ │ └── visual-probes.md │ │ └── scripts/ │ │ ├── repo-profile-cache.py │ │ └── visual-probe-server.js │ ├── ce-code-review/ │ │ ├── SKILL.md │ │ ├── references/ │ │ │ ├── action-class-rubric.md │ │ │ ├── agents/ │ │ │ │ └── repo-profiler.md │ │ │ ├── cross-model-review.md │ │ │ ├── diff-scope.md │ │ │ ├── findings-schema.json │ │ │ ├── persona-catalog.md │ │ │ ├── personas/ │ │ │ │ ├── adversarial-reviewer.md │ │ │ │ ├── agent-native-reviewer.md │ │ │ │ ├── api-contract-reviewer.md │ │ │ │ ├── correctness-reviewer.md │ │ │ │ ├── data-migration-reviewer.md │ │ │ │ ├── deployment-verification-agent.md │ │ │ │ ├── julik-frontend-races-reviewer.md │ │ │ │ ├── learnings-researcher.md │ │ │ │ ├── maintainability-reviewer.md │ │ │ │ ├── performance-reviewer.md │ │ │ │ ├── previous-comments-reviewer.md │ │ │ │ ├── project-standards-reviewer.md │ │ │ │ ├── reliability-reviewer.md │ │ │ │ ├── security-reviewer.md │ │ │ │ ├── swift-ios-reviewer.md │ │ │ │ └── testing-reviewer.md │ │ │ ├── repo-profile-cache.md │ │ │ ├── review-output-template.md │ │ │ ├── subagent-template.md │ │ │ └── validator-template.md │ │ └── scripts/ │ │ ├── cross-model-adversarial-review.sh │ │ ├── peer-job-runner.py │ │ └── repo-profile-cache.py │ ├── ce-commit/ │ │ └── SKILL.md │ ├── ce-commit-push-pr/ │ │ ├── SKILL.md │ │ └── references/ │ │ ├── branch-creation.md │ │ └── pr-description-writing.md │ ├── ce-compound/ │ │ ├── SKILL.md │ │ ├── assets/ │ │ │ └── resolution-template.md │ │ ├── references/ │ │ │ ├── agents/ │ │ │ │ ├── best-practices-researcher.md │ │ │ │ ├── data-integrity-guardian.md │ │ │ │ ├── framework-docs-researcher.md │ │ │ │ ├── pattern-recognition-specialist.md │ │ │ │ ├── performance-oracle.md │ │ │ │ ├── repo-profiler.md │ │ │ │ ├── security-sentinel.md │ │ │ │ └── session-historian.md │ │ │ ├── concepts-vocabulary.md │ │ │ ├── grounding-validation.md │ │ │ ├── repo-profile-cache.md │ │ │ ├── schema.yaml │ │ │ └── yaml-schema.md │ │ └── scripts/ │ │ ├── repo-profile-cache.py │ │ ├── session-history/ │ │ │ ├── discover-sessions.sh │ │ │ ├── extract-errors.py │ │ │ ├── extract-metadata.py │ │ │ └── extract-skeleton.py │ │ ├── validate-doc-claims.py │ │ └── validate-frontmatter.py │ ├── ce-compound-refresh/ │ │ ├── SKILL.md │ │ ├── assets/ │ │ │ └── resolution-template.md │ │ ├── references/ │ │ │ ├── concepts-vocabulary.md │ │ │ ├── per-action-flows.md │ │ │ ├── schema.yaml │ │ │ └── yaml-schema.md │ │ └── scripts/ │ │ ├── validate-doc-claims.py │ │ └── validate-frontmatter.py │ ├── ce-debug/ │ │ ├── SKILL.md │ │ ├── references/ │ │ │ ├── agents/ │ │ │ │ └── repo-profiler.md │ │ │ ├── anti-patterns.md │ │ │ ├── defense-in-depth.md │ │ │ ├── investigation-techniques.md │ │ │ ├── pipeline-mode.md │ │ │ └── repo-profile-cache.md │ │ └── scripts/ │ │ └── repo-profile-cache.py │ ├── ce-doc-review/ │ │ ├── SKILL.md │ │ ├── references/ │ │ │ ├── bulk-preview.md │ │ │ ├── cross-model-eval.md │ │ │ ├── cross-model-review.md │ │ │ ├── findings-schema.json │ │ │ ├── open-questions-defer.md │ │ │ ├── personas/ │ │ │ │ ├── adversarial-document-reviewer.md │ │ │ │ ├── coherence-reviewer.md │ │ │ │ ├── design-lens-reviewer.md │ │ │ │ ├── feasibility-reviewer.md │ │ │ │ ├── product-lens-reviewer.md │ │ │ │ ├── scope-guardian-reviewer.md │ │ │ │ ├── security-lens-reviewer.md │ │ │ │ └── whole-doc-reviewer.md │ │ │ ├── review-output-template.md │ │ │ ├── subagent-template.md │ │ │ ├── synthesis-and-presentation.md │ │ │ └── walkthrough.md │ │ └── scripts/ │ │ ├── cross-model-doc-review.sh │ │ └── peer-job-runner.py │ ├── ce-dogfood/ │ │ ├── SKILL.md │ │ └── references/ │ │ ├── dogfood-report-template.md │ │ └── test-matrix-taxonomy.md │ ├── ce-explain/ │ │ ├── SKILL.md │ │ ├── references/ │ │ │ ├── agents/ │ │ │ │ ├── repo-profiler.md │ │ │ │ └── work-recap-scout.md │ │ │ ├── check-in.md │ │ │ ├── destinations.md │ │ │ ├── explainer-html.md │ │ │ ├── explainer-markdown.md │ │ │ ├── intake.md │ │ │ └── repo-profile-cache.md │ │ └── scripts/ │ │ └── repo-profile-cache.py │ ├── ce-ideate/ │ │ ├── SKILL.md │ │ ├── references/ │ │ │ ├── agents/ │ │ │ │ ├── issue-intelligence-analyst.md │ │ │ │ ├── learnings-researcher.md │ │ │ │ ├── repo-profiler.md │ │ │ │ ├── slack-researcher.md │ │ │ │ └── web-researcher.md │ │ │ ├── divergent-ideation.md │ │ │ ├── html-rendering.md │ │ │ ├── ideation-sections.md │ │ │ ├── markdown-rendering.md │ │ │ ├── post-ideation-workflow.md │ │ │ ├── repo-profile-cache.md │ │ │ ├── universal-ideation.md │ │ │ └── web-research-cache.md │ │ └── scripts/ │ │ └── repo-profile-cache.py │ ├── ce-optimize/ │ │ ├── SKILL.md │ │ ├── references/ │ │ │ ├── agents/ │ │ │ │ ├── learnings-researcher.md │ │ │ │ ├── repo-profiler.md │ │ │ │ └── repo-research-analyst.md │ │ │ ├── example-hard-spec.yaml │ │ │ ├── example-judge-spec.yaml │ │ │ ├── experiment-log-schema.yaml │ │ │ ├── experiment-prompt-template.md │ │ │ ├── judge-prompt-template.md │ │ │ ├── optimize-spec-schema.yaml │ │ │ ├── repo-profile-cache.md │ │ │ └── usage-guide.md │ │ └── scripts/ │ │ ├── experiment-worktree.sh │ │ ├── measure.sh │ │ ├── parallel-probe.sh │ │ └── repo-profile-cache.py │ ├── ce-plan/ │ │ ├── SKILL.md │ │ ├── references/ │ │ │ ├── agents/ │ │ │ │ ├── agent-native-planning-strategist.md │ │ │ │ ├── architecture-strategist.md │ │ │ │ ├── best-practices-researcher.md │ │ │ │ ├── data-integrity-guardian.md │ │ │ │ ├── data-migration-reviewer.md │ │ │ │ ├── deployment-verification-agent.md │ │ │ │ ├── framework-docs-researcher.md │ │ │ │ ├── git-history-analyzer.md │ │ │ │ ├── learnings-researcher.md │ │ │ │ ├── pattern-recognition-specialist.md │ │ │ │ ├── performance-oracle.md │ │ │ │ ├── repo-profiler.md │ │ │ │ ├── repo-research-analyst.md │ │ │ │ ├── security-sentinel.md │ │ │ │ ├── slack-researcher.md │ │ │ │ ├── spec-flow-analyzer.md │ │ │ │ └── web-researcher.md │ │ │ ├── approach-altitude.md │ │ │ ├── deepening-workflow.md │ │ │ ├── html-rendering.md │ │ │ ├── markdown-rendering.md │ │ │ ├── plan-handoff.md │ │ │ ├── plan-sections.md │ │ │ ├── reasoning-elevation.md │ │ │ ├── repo-profile-cache.md │ │ │ ├── settled-decisions.md │ │ │ ├── synthesis-summary.md │ │ │ └── universal-planning.md │ │ └── scripts/ │ │ └── repo-profile-cache.py │ ├── ce-polish/ │ │ ├── SKILL.md │ │ ├── references/ │ │ │ ├── dev-server-astro.md │ │ │ ├── dev-server-detection.md │ │ │ ├── dev-server-next.md │ │ │ ├── dev-server-nuxt.md │ │ │ ├── dev-server-procfile.md │ │ │ ├── dev-server-rails.md │ │ │ ├── dev-server-remix.md │ │ │ ├── dev-server-sveltekit.md │ │ │ ├── dev-server-vite.md │ │ │ ├── ide-detection.md │ │ │ └── launch-json-schema.md │ │ └── scripts/ │ │ ├── detect-project-type.sh │ │ ├── read-launch-json.sh │ │ ├── resolve-package-manager.sh │ │ └── resolve-port.sh │ ├── ce-pov/ │ │ ├── SKILL.md │ │ ├── references/ │ │ │ ├── agents/ │ │ │ │ ├── external-evidence-researcher.md │ │ │ │ ├── precedent-activity-scout.md │ │ │ │ ├── project-grounding-scout.md │ │ │ │ └── repo-profiler.md │ │ │ ├── boundaries.md │ │ │ ├── intake.md │ │ │ ├── invocation.md │ │ │ ├── method.md │ │ │ ├── repo-profile-cache.md │ │ │ └── report.md │ │ └── scripts/ │ │ └── repo-profile-cache.py │ ├── ce-product-pulse/ │ │ ├── SKILL.md │ │ └── references/ │ │ ├── interview.md │ │ └── report-template.md │ ├── ce-promote/ │ │ ├── SKILL.md │ │ └── references/ │ │ └── spiral-cli.md │ ├── ce-proof/ │ │ └── SKILL.md │ ├── ce-resolve-pr-feedback/ │ │ ├── SKILL.md │ │ ├── references/ │ │ │ ├── agents/ │ │ │ │ └── pr-comment-resolver.md │ │ │ ├── evaluation-rubric.md │ │ │ ├── full-mode.md │ │ │ └── targeted-mode.md │ │ └── scripts/ │ │ ├── get-pr-comments │ │ ├── get-thread-for-comment │ │ ├── reply-to-pr-thread │ │ └── resolve-pr-thread │ ├── ce-riffrec-feedback-analysis/ │ │ ├── SKILL.md │ │ ├── references/ │ │ │ ├── compound-engineering-feedback-format.md │ │ │ ├── extensive-analysis.md │ │ │ ├── install-riffrec.md │ │ │ └── quick-bug-report.md │ │ └── scripts/ │ │ └── analyze_riffrec_zip.py │ ├── ce-setup/ │ │ ├── SKILL.md │ │ ├── references/ │ │ │ └── config-template.yaml │ │ └── scripts/ │ │ └── check-health │ ├── ce-simplify-code/ │ │ ├── SKILL.md │ │ └── references/ │ │ └── personas/ │ │ ├── code-quality-reviewer.md │ │ ├── code-reuse-reviewer.md │ │ └── efficiency-reviewer.md │ ├── ce-strategy/ │ │ ├── SKILL.md │ │ └── references/ │ │ ├── interview.md │ │ └── strategy-template.md │ ├── ce-sweep/ │ │ ├── SKILL.md │ │ ├── references/ │ │ │ ├── agents/ │ │ │ │ └── media-analyzer.md │ │ │ ├── interview.md │ │ │ ├── model-tiers.md │ │ │ ├── plan-template.md │ │ │ ├── sources/ │ │ │ │ ├── email.md │ │ │ │ ├── github-issues.md │ │ │ │ └── slack.md │ │ │ ├── state-schema.md │ │ │ └── subagent-template.md │ │ └── scripts/ │ │ ├── analyze_riffrec_zip.py │ │ └── sweep-state.py │ ├── ce-test-browser/ │ │ ├── SKILL.md │ │ └── references/ │ │ ├── agent-browser-driver.md │ │ └── pipeline-orchestration.md │ ├── ce-test-xcode/ │ │ └── SKILL.md │ ├── ce-work/ │ │ ├── SKILL.md │ │ └── references/ │ │ ├── agents/ │ │ │ └── figma-design-sync.md │ │ ├── execution-engines.md │ │ ├── non-code-execution.md │ │ ├── review-findings-followup.md │ │ ├── shipping-workflow.md │ │ └── tracker-defer.md │ ├── ce-worktree/ │ │ └── SKILL.md │ └── lfg/ │ ├── SKILL.md │ └── references/ │ ├── review-followup.md │ └── tracker-defer.md ├── src/ │ ├── commands/ │ │ ├── cleanup.ts │ │ ├── convert.ts │ │ ├── install.ts │ │ ├── list.ts │ │ └── plugin-path.ts │ ├── converters/ │ │ ├── claude-to-antigravity.ts │ │ ├── claude-to-codex.ts │ │ ├── claude-to-copilot.ts │ │ ├── claude-to-droid.ts │ │ ├── claude-to-kiro.ts │ │ ├── claude-to-opencode.ts │ │ └── claude-to-pi.ts │ ├── data/ │ │ └── plugin-legacy-artifacts.ts │ ├── index.ts │ ├── parsers/ │ │ └── claude.ts │ ├── release/ │ │ ├── components.ts │ │ ├── config.ts │ │ ├── metadata.ts │ │ └── types.ts │ ├── targets/ │ │ ├── antigravity.ts │ │ ├── codex.ts │ │ ├── index.ts │ │ ├── kiro.ts │ │ ├── managed-artifacts.ts │ │ ├── opencode.ts │ │ └── pi.ts │ ├── types/ │ │ ├── antigravity.ts │ │ ├── claude.ts │ │ ├── codex.ts │ │ ├── copilot.ts │ │ ├── droid.ts │ │ ├── kiro.ts │ │ ├── opencode.ts │ │ └── pi.ts │ └── utils/ │ ├── codex-agents.ts │ ├── codex-content.ts │ ├── detect-tools.ts │ ├── files.ts │ ├── frontmatter.ts │ ├── json-config.ts │ ├── legacy-cleanup.ts │ ├── model.ts │ ├── opencode-config.ts │ ├── resolve-home.ts │ ├── resolve-output.ts │ ├── secrets.ts │ └── symlink.ts ├── tests/ │ ├── antigravity-converter.test.ts │ ├── antigravity-writer.test.ts │ ├── ce-babysit-pr-contract.test.ts │ ├── ce-babysit-pr-snapshot.test.ts │ ├── ce-sweep-analyzer-parity.test.ts │ ├── ce-test-browser-driver-policy.test.ts │ ├── claude-parser.test.ts │ ├── cli.test.ts │ ├── cline-install-skills.test.ts │ ├── codex-agents.test.ts │ ├── codex-converter.test.ts │ ├── codex-writer.test.ts │ ├── commit-push-pr-contract.test.ts │ ├── compound-support-files.test.ts │ ├── converter.test.ts │ ├── copilot-converter.test.ts │ ├── cross-model-receipt-parity.test.ts │ ├── detect-tools.test.ts │ ├── doc-claims-validator.test.ts │ ├── droid-converter.test.ts │ ├── fixtures/ │ │ ├── ce-code-review-stable-numbering.md │ │ ├── ce-doc-review/ │ │ │ ├── seeded-auth-plan.md │ │ │ ├── seeded-feature-plan.md │ │ │ └── seeded-plan.md │ │ ├── custom-paths/ │ │ │ ├── .claude-plugin/ │ │ │ │ └── plugin.json │ │ │ ├── agents/ │ │ │ │ └── default-agent.md │ │ │ ├── commands/ │ │ │ │ └── default-command.md │ │ │ ├── custom-agents/ │ │ │ │ └── custom-agent.md │ │ │ ├── custom-commands/ │ │ │ │ └── custom-command.md │ │ │ ├── custom-hooks/ │ │ │ │ └── hooks.json │ │ │ ├── custom-skills/ │ │ │ │ └── custom-skill/ │ │ │ │ └── SKILL.md │ │ │ ├── hooks/ │ │ │ │ └── hooks.json │ │ │ └── skills/ │ │ │ └── default-skill/ │ │ │ └── SKILL.md │ │ ├── invalid-command-path/ │ │ │ └── .claude-plugin/ │ │ │ └── plugin.json │ │ ├── invalid-hooks-path/ │ │ │ └── .claude-plugin/ │ │ │ └── plugin.json │ │ ├── invalid-mcp-path/ │ │ │ └── .claude-plugin/ │ │ │ └── plugin.json │ │ ├── mcp-file/ │ │ │ ├── .claude-plugin/ │ │ │ │ └── plugin.json │ │ │ └── .mcp.json │ │ ├── peer-job-runner-unit.py │ │ ├── sample-plugin/ │ │ │ ├── .claude-plugin/ │ │ │ │ └── plugin.json │ │ │ ├── agents/ │ │ │ │ ├── agent-one.md │ │ │ │ └── security-reviewer.md │ │ │ ├── commands/ │ │ │ │ ├── command-one.md │ │ │ │ ├── disabled-command.md │ │ │ │ ├── model-command.md │ │ │ │ ├── nested/ │ │ │ │ │ └── command-two.md │ │ │ │ ├── pattern-command.md │ │ │ │ ├── skill-command.md │ │ │ │ └── todo-command.md │ │ │ ├── hooks/ │ │ │ │ └── hooks.json │ │ │ └── skills/ │ │ │ ├── agent-only-skill/ │ │ │ │ └── SKILL.md │ │ │ ├── claude-only-skill/ │ │ │ │ └── SKILL.md │ │ │ ├── disabled-skill/ │ │ │ │ └── SKILL.md │ │ │ └── skill-one/ │ │ │ └── SKILL.md │ │ └── session-history/ │ │ ├── claude-session.jsonl │ │ ├── codex-session.jsonl │ │ ├── cursor-session.jsonl │ │ └── pi-session.jsonl │ ├── frontmatter-validator.test.ts │ ├── frontmatter.test.ts │ ├── gpt-5-6-skill-migration.test.ts │ ├── kiro-converter.test.ts │ ├── kiro-writer.test.ts │ ├── legacy-cleanup.test.ts │ ├── legacy-registry-invariants.test.ts │ ├── manifest-path-safety.test.ts │ ├── model-utils.test.ts │ ├── opencode-writer.test.ts │ ├── path-sanitization.test.ts │ ├── peer-job-runner-parity.test.ts │ ├── pi-converter.test.ts │ ├── pi-writer.test.ts │ ├── pipeline-review-contract.test.ts │ ├── plugin-legacy-artifacts.test.ts │ ├── plugin-path.test.ts │ ├── real-plugin-conversion.test.ts │ ├── reasoning-elevation-parity.test.ts │ ├── release-components.test.ts │ ├── release-config.test.ts │ ├── release-metadata.test.ts │ ├── release-preview.test.ts │ ├── repo-profile-cache-parity.test.ts │ ├── repo-profile-cache.test.ts │ ├── resolve-home.test.ts │ ├── resolve-output.test.ts │ ├── resolve-pr-feedback-pagination.test.ts │ ├── review-skill-contract.test.ts │ ├── session-history-scripts.test.ts │ ├── settled-decisions-parity.test.ts │ ├── skill-agent-ce-prefix.test.ts │ ├── skill-conventions.test.ts │ ├── skill-shell-safety.test.ts │ ├── skills/ │ │ ├── ce-brainstorm-output-mode.test.ts │ │ ├── ce-brainstorm-section-order.test.ts │ │ ├── ce-brainstorm-visual-probe-server.test.ts │ │ ├── ce-brainstorm-visual-probes.test.ts │ │ ├── ce-code-review-cross-model-routes.test.ts │ │ ├── ce-compound-readonly-enhancement.test.ts │ │ ├── ce-doc-review-cross-model-routes.test.ts │ │ ├── ce-explain-routing.test.ts │ │ ├── ce-ideate-output-mode.test.ts │ │ ├── ce-plan-handoff-routing.test.ts │ │ ├── ce-plan-output-mode.test.ts │ │ ├── ce-polish-dev-server.test.ts │ │ ├── ce-polish-package-manager.test.ts │ │ ├── ce-polish-project-type.test.ts │ │ ├── ce-polish-resolve-port.test.ts │ │ ├── ce-proof-contract.test.ts │ │ ├── ce-resolve-pr-feedback-script-dir.test.ts │ │ ├── ce-session-historian-no-skill-tool.test.ts │ │ ├── ce-setup-check-health.test.ts │ │ ├── ce-sweep-source-contract.test.ts │ │ ├── ce-worktree.test.ts │ │ ├── fenced-blocks.ts │ │ ├── flatten-safety.test.ts │ │ ├── html-output-invariants.test.ts │ │ ├── peer-job-runner.test.ts │ │ └── unified-plan-artifact-contract.test.ts │ └── sweep-state.test.ts └── tsconfig.json
Condensed preview — 685 files, each showing path, character count, and a content snippet. Download the .json file or copy for the full structured content (8,873K chars).
[
{
"path": ".agents/plugins/marketplace.json",
"chars": 437,
"preview": "{\n \"name\": \"compound-engineering-plugin\",\n \"interface\": {\n \"displayName\": \"Compound Engineering\"\n },\n \"plugins\":..."
},
{
"path": ".agy/INSTALL.md",
"chars": 2105,
"preview": "# Installing Compound Engineering for Antigravity CLI (`agy`)\n\nAntigravity installs CE as a native plugin bundle. The re..."
},
{
"path": ".claude/commands/triage-prs.md",
"chars": 6040,
"preview": "---\nname: triage-prs\ndescription: Triage all open PRs with parallel agents, label, group, and review one-by-one\nargument..."
},
{
"path": ".claude-plugin/CHANGELOG.md",
"chars": 407,
"preview": "# Changelog\n\n## [1.0.3](https://github.com/EveryInc/compound-engineering-plugin/compare/marketplace-v1.0.2...marketplace..."
},
{
"path": ".claude-plugin/marketplace.json",
"chars": 753,
"preview": "{\n \"name\": \"compound-engineering-plugin\",\n \"owner\": {\n \"name\": \"Kieran Klaassen and Trevin Chow\"\n },\n \"metadata\":..."
},
{
"path": ".claude-plugin/plugin.json",
"chars": 571,
"preview": "{\n \"name\": \"compound-engineering\",\n \"version\": \"3.19.0\",\n \"description\": \"Brainstorm, plan, debug, review, and compou..."
},
{
"path": ".cline/INSTALL.md",
"chars": 3108,
"preview": "# Installing Compound Engineering for Cline\n\nCline loads CE through native **skills** discovery — the same `SKILL.md` di..."
},
{
"path": ".cline/scripts/install-skills.sh",
"chars": 3344,
"preview": "#!/usr/bin/env bash\n# Link Compound Engineering skills/ into Cline's skills discovery directory.\nset -euo pipefail\n\nSCRI..."
},
{
"path": ".codex-plugin/plugin.json",
"chars": 1616,
"preview": "{\n \"name\": \"compound-engineering\",\n \"version\": \"3.19.0\",\n \"description\": \"Brainstorm, plan, debug, review, and compou..."
},
{
"path": ".compound-engineering/config.local.example.yaml",
"chars": 6643,
"preview": "# Compound Engineering -- local config\n# Copy to .compound-engineering/config.local.yaml in your project root.\n# All set..."
},
{
"path": ".cursor-plugin/CHANGELOG.md",
"chars": 829,
"preview": "# Changelog\n\n## [1.0.2](https://github.com/EveryInc/compound-engineering-plugin/compare/cursor-marketplace-v1.0.1...curs..."
},
{
"path": ".cursor-plugin/marketplace.json",
"chars": 464,
"preview": "{\n \"name\": \"compound-engineering\",\n \"owner\": {\n \"name\": \"Kieran Klaassen\",\n \"email\": \"kieran@every.to\",\n \"url..."
},
{
"path": ".cursor-plugin/plugin.json",
"chars": 672,
"preview": "{\n \"name\": \"compound-engineering\",\n \"displayName\": \"Compound Engineering\",\n \"version\": \"3.19.0\",\n \"description\": \"Br..."
},
{
"path": ".devin-plugin/plugin.json",
"chars": 571,
"preview": "{\n \"name\": \"compound-engineering\",\n \"version\": \"3.19.0\",\n \"description\": \"Brainstorm, plan, debug, review, and compou..."
},
{
"path": ".github/.release-please-manifest.json",
"chars": 78,
"preview": "{\n \".\": \"3.19.0\",\n \".claude-plugin\": \"1.0.3\",\n \".cursor-plugin\": \"1.0.2\"\n}\n"
},
{
"path": ".github/release-please-config.json",
"chars": 2856,
"preview": "{\n \"$schema\": \"https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json\",\n \"include-compon..."
},
{
"path": ".github/workflows/ci.yml",
"chars": 2348,
"preview": "name: CI\n\non:\n push:\n branches: [main]\n pull_request:\n workflow_dispatch:\n\njobs:\n pr-title:\n if: github.event_..."
},
{
"path": ".github/workflows/release-pr.yml",
"chars": 1322,
"preview": "name: Release PR\n\non:\n push:\n branches: [main]\n workflow_dispatch:\n\npermissions:\n contents: write\n pull-requests:..."
},
{
"path": ".github/workflows/release-preview.yml",
"chars": 2788,
"preview": "name: Release Preview\n\non:\n workflow_dispatch:\n inputs:\n title:\n description: \"Conventional title to eva..."
},
{
"path": ".gitignore",
"chars": 140,
"preview": ".DS_Store\n*.log\nnode_modules/\n.codex/\ntodos/\n.worktrees\n.context/\n.claude/worktrees/\n__pycache__/\n*.pyc\n\n.compound-engin..."
},
{
"path": ".grok-plugin/marketplace.json",
"chars": 697,
"preview": "{\n \"name\": \"compound-engineering\",\n \"description\": \"Compound Engineering plugin for Grok Build\",\n \"owner\": {\n \"nam..."
},
{
"path": ".grok-plugin/plugin.json",
"chars": 596,
"preview": "{\n \"name\": \"compound-engineering\",\n \"version\": \"3.19.0\",\n \"description\": \"Brainstorm, plan, debug, review, and compou..."
},
{
"path": ".kimi-plugin/marketplace.json",
"chars": 208,
"preview": "{\n \"version\": \"2\",\n \"plugins\": [\n {\n \"id\": \"compound-engineering\",\n \"displayName\": \"Compound Engineering\"..."
},
{
"path": ".kimi-plugin/plugin.json",
"chars": 1037,
"preview": "{\n \"name\": \"compound-engineering\",\n \"version\": \"3.19.0\",\n \"description\": \"Brainstorm, plan, debug, review, and compou..."
},
{
"path": ".opencode/INSTALL.md",
"chars": 969,
"preview": "# Installing Compound Engineering for OpenCode\n\nAdd Compound Engineering to the `plugin` array in your global or project..."
},
{
"path": ".opencode/plugins/compound-engineering.js",
"chars": 511,
"preview": "import path from \"path\"\nimport { fileURLToPath } from \"url\"\n\nconst pluginDir = path.dirname(fileURLToPath(import.meta.ur..."
},
{
"path": ".pi/extensions/compound-engineering.ts",
"chars": 397,
"preview": "import { dirname, resolve } from \"node:path\"\nimport { fileURLToPath } from \"node:url\"\n\nconst extensionDir = dirname(file..."
},
{
"path": "AGENTS.md",
"chars": 42404,
"preview": "# Agent Instructions\n\nThis repository is the root of the `compound-engineering` coding-agent plugin and the marketplace/..."
},
{
"path": "CHANGELOG.md",
"chars": 59391,
"preview": "# Changelog\n\n## [3.13.1](https://github.com/EveryInc/compound-engineering-plugin/compare/cli-v3.13.0...cli-v3.13.1) (202..."
},
{
"path": "CONCEPTS.md",
"chars": 11114,
"preview": "# Concepts\n\nShared domain vocabulary for this project — entities, named processes, and status concepts with project-spec..."
},
{
"path": "GEMINI.md",
"chars": 419,
"preview": "# Compound Engineering\n\nThis Gemini extension provides the Compound Engineering skill set for planning,\nreview, implemen..."
},
{
"path": "LICENSE",
"chars": 1062,
"preview": "MIT License\n\nCopyright (c) 2025 Every\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof t..."
},
{
"path": "PRIVACY.md",
"chars": 1935,
"preview": "# Privacy & Data Handling\n\nThis repository contains:\n- a root plugin package made of markdown/config content\n- a CLI (`@..."
},
{
"path": "README.md",
"chars": 26395,
"preview": "# Compound Engineering\n\n[![Build Status](https://github.com/EveryInc/compound-engineering-plugin/actions/workflows/ci.ym..."
},
{
"path": "SECURITY.md",
"chars": 909,
"preview": "# Security Policy\n\n## Supported Versions\n\nSecurity fixes are applied to the latest version on `main`.\n\n## Reporting a Vu..."
},
{
"path": "docs/brainstorms/2026-02-14-copilot-converter-target-brainstorm.md",
"chars": 5295,
"preview": "---\ndate: 2026-02-14\ntopic: copilot-converter-target\n---\n\n# Add GitHub Copilot Converter Target\n\n## What We're Building..."
},
{
"path": "docs/brainstorms/2026-02-17-copilot-skill-naming-brainstorm.md",
"chars": 1393,
"preview": "---\ndate: 2026-02-17\ntopic: copilot-skill-naming\n---\n\n# Copilot Skill Naming: Preserve Namespace\n\n## What We're Building..."
},
{
"path": "docs/brainstorms/2026-03-14-ce-plan-rewrite-requirements.md",
"chars": 7547,
"preview": "---\ndate: 2026-03-14\ntopic: ce-plan-rewrite\n---\n\n# Rewrite `ce:plan` to Separate Planning from Implementation\n\n## Proble..."
},
{
"path": "docs/brainstorms/2026-03-15-ce-ideate-skill-requirements.md",
"chars": 9169,
"preview": "---\ndate: 2026-03-15\ntopic: ce-ideate-skill\n---\n\n# ce:ideate — Open-Ended Ideation Skill\n\n## Problem Frame\n\nThe ce:brain..."
},
{
"path": "docs/brainstorms/2026-03-16-issue-grounded-ideation-requirements.md",
"chars": 6642,
"preview": "---\ndate: 2026-03-16\ntopic: issue-grounded-ideation\n---\n\n# Issue-Grounded Ideation Mode for ce:ideate\n\n## Problem Frame..."
},
{
"path": "docs/brainstorms/2026-03-17-release-automation-requirements.md",
"chars": 9248,
"preview": "---\ndate: 2026-03-17\ntopic: release-automation\n---\n\n# Release Automation and Changelog Ownership\n\n## Problem Frame\n\nThe..."
},
{
"path": "docs/brainstorms/2026-03-18-auto-memory-integration-requirements.md",
"chars": 3718,
"preview": "---\ndate: 2026-03-18\ntopic: auto-memory-integration\n---\n\n# Auto Memory Integration for ce:compound and ce:compound-refre..."
},
{
"path": "docs/brainstorms/2026-03-22-frontend-design-skill-improvement.md",
"chars": 11088,
"preview": "# Frontend Design Skill Improvement\n\n**Date:** 2026-03-22\n**Status:** Design approved, pending implementation plan\n**Sco..."
},
{
"path": "docs/brainstorms/2026-03-23-plan-review-personas-requirements.md",
"chars": 7192,
"preview": "---\ndate: 2026-03-23\ntopic: plan-review-personas\n---\n\n# Persona-Based Plan Review for document-review\n\n## Problem Frame..."
},
{
"path": "docs/brainstorms/2026-03-25-config-storage-redesign-requirements.md",
"chars": 19125,
"preview": "---\ndate: 2026-03-25\ntopic: config-storage-redesign\n---\n\n# Config and Worktree-Safe Storage Redesign\n\n## Problem Frame..."
},
{
"path": "docs/brainstorms/2026-03-25-vonboarding-skill-requirements.md",
"chars": 5233,
"preview": "---\ndate: 2026-03-25\ntopic: onboarding-skill\n---\n\n# Onboarding: Codebase Onboarding Document Generator\n\n## Problem Frame..."
},
{
"path": "docs/brainstorms/2026-03-26-merge-deepen-into-plan-requirements.md",
"chars": 4072,
"preview": "---\ndate: 2026-03-26\ntopic: merge-deepen-into-plan\n---\n\n# Merge Deepen-Plan Into ce:plan\n\n## Problem Frame\n\nThe ce:plan..."
},
{
"path": "docs/brainstorms/2026-03-27-ce-skill-prefix-rename-requirements.md",
"chars": 22004,
"preview": "---\ndate: 2026-03-27\ntopic: ce-skill-prefix-rename\n---\n\n# Consistent `ce-` Prefix for All Skills and Agents\n\n## Problem..."
},
{
"path": "docs/brainstorms/2026-03-28-ce-review-headless-mode-requirements.md",
"chars": 4053,
"preview": "---\ndate: 2026-03-28\ntopic: ce-review-headless-mode\n---\n\n# ce:review Headless Mode\n\n## Problem Frame\n\nce:review currentl..."
},
{
"path": "docs/brainstorms/2026-03-29-iterative-optimization-loop-requirements.md",
"chars": 43658,
"preview": "# Iterative Optimization Loop Skill — Requirements Brainstorm\n\n## Problem Statement\n\nCE has strong knowledge-compounding..."
},
{
"path": "docs/brainstorms/2026-03-29-testing-addressed-gate-requirements.md",
"chars": 6678,
"preview": "---\ndate: 2026-03-29\ntopic: testing-addressed-gate\n---\n\n# Close the Testing Gap in ce:work and ce:plan\n\n## Problem Frame..."
},
{
"path": "docs/brainstorms/2026-03-30-cli-readiness-review-persona-requirements.md",
"chars": 5967,
"preview": "---\ndate: 2026-03-30\ntopic: cli-readiness-review-persona\n---\n\n# CLI Agent-Readiness Review Persona in ce:review\n\n## Prob..."
},
{
"path": "docs/brainstorms/2026-03-31-codex-delegation-requirements.md",
"chars": 20335,
"preview": "---\ndate: 2026-03-31\ntopic: codex-delegation\n---\n\n# Codex Delegation Mode for ce:work\n\n## Problem Frame\n\nUsers running c..."
},
{
"path": "docs/brainstorms/2026-04-01-cross-invocation-cluster-analysis-requirements.md",
"chars": 9337,
"preview": "---\ndate: 2026-04-01\ntopic: cross-invocation-cluster-analysis\n---\n\n# Cross-Invocation Cluster Analysis for resolve-pr-fe..."
},
{
"path": "docs/brainstorms/2026-04-02-slack-analyst-agent-requirements.md",
"chars": 7897,
"preview": "---\ndate: 2026-04-02\ntopic: ce-slack-researcher-agent\n---\n\n# Slack Analyst Agent\n\n## Problem Frame\n\nCoding agents operat..."
},
{
"path": "docs/brainstorms/2026-04-05-universal-planning-requirements.md",
"chars": 9336,
"preview": "---\ndate: 2026-04-05\ntopic: universal-planning\n---\n\n# Universal Planning: Non-Software Task Support for ce:plan and ce:b..."
},
{
"path": "docs/brainstorms/2026-04-17-ce-release-notes-skill-requirements.md",
"chars": 12439,
"preview": "---\ndate: 2026-04-17\ntopic: ce-release-notes-skill\n---\n\n# `ce-release-notes` Skill\n\n## Problem Frame\n\nThe `compound-engi..."
},
{
"path": "docs/brainstorms/2026-04-17-ce-review-interactive-judgment-requirements.md",
"chars": 19503,
"preview": "---\ndate: 2026-04-17\ntopic: ce-review-interactive-judgment\n---\n\n# ce:review Interactive Judgment Loop\n\n## Problem Frame..."
},
{
"path": "docs/brainstorms/2026-04-18-ce-doc-review-autofix-and-interaction-requirements.md",
"chars": 27174,
"preview": "---\ndate: 2026-04-18\ntopic: ce-doc-review-autofix-and-interaction\n---\n\n# ce-doc-review Autofix and Interaction Overhaul..."
},
{
"path": "docs/brainstorms/2026-04-22-demo-reel-local-save-requirements.md",
"chars": 2278,
"preview": "---\ndate: 2026-04-22\ntopic: demo-reel-local-save\n---\n\n# Demo Reel: Local Evidence Save\n\n## Problem Frame\n\nWhen `ce-demo-..."
},
{
"path": "docs/brainstorms/2026-04-24-surface-scope-earlier-requirements.md",
"chars": 14573,
"preview": "---\ndate: 2026-04-24\ntopic: surface-scope-earlier\n---\n\n# Surface Scope Earlier in ce-brainstorm and ce-plan\n\n## Problem..."
},
{
"path": "docs/brainstorms/2026-05-19-vscode-copilot-agent-tool-access-requirements.md",
"chars": 17331,
"preview": "---\ndate: 2026-05-19\ntopic: vscode-copilot-agent-tool-access\n---\n\n# VS Code Copilot Agent Tool Access for CE Plugin\n\n##..."
},
{
"path": "docs/brainstorms/2026-06-04-ce-plan-approach-altitude-requirements.md",
"chars": 14838,
"preview": "---\ntitle: \"ce-plan approach altitude — plan-for-a-plan as a first-class shape\"\ndate: 2026-06-04\ntopic: ce-plan-approach..."
},
{
"path": "docs/brainstorms/2026-06-19-agentless-plugin-surface-reduction-requirements.md",
"chars": 14033,
"preview": "---\ntitle: \"Agentless plugin surface reduction\"\ndate: 2026-06-19\ntopic: agentless-plugin-surface-reduction\n---\n\n# Agentl..."
},
{
"path": "docs/grok-marketplace-submission.md",
"chars": 3373,
"preview": "# Submitting Compound Engineering to the official xAI plugin marketplace\n\nMaintainer runbook for listing Compound Engine..."
},
{
"path": "docs/ideation/2026-06-28-ce-pov-skill-proposal.html",
"chars": 29294,
"preview": "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width, initia..."
},
{
"path": "docs/plans/2026-02-08-feat-convert-local-md-settings-for-opencode-codex-plan.md",
"chars": 7582,
"preview": "---\ntitle: Convert .local.md Settings for OpenCode and Codex\ntype: feat\ndate: 2026-02-08\n---\n\n# Convert .local.md Settin..."
},
{
"path": "docs/plans/2026-02-08-feat-pr-triage-and-merge-plan.md",
"chars": 5494,
"preview": "---\ntitle: PR Triage, Review & Merge\ntype: feat\ndate: 2026-02-08\n---\n\n# PR Triage, Review & Merge\n\n## Overview\n\nReview a..."
},
{
"path": "docs/plans/2026-02-08-feat-simplify-plugin-settings-plan.md",
"chars": 9550,
"preview": "---\ntitle: Simplify Plugin Settings with .local.md Pattern\ntype: feat\ndate: 2026-02-08\n---\n\n# Simplify Plugin Settings..."
},
{
"path": "docs/plans/2026-02-08-refactor-reduce-plugin-context-token-usage-plan.md",
"chars": 9600,
"preview": "---\ntitle: Reduce compound-engineering plugin context token usage\ntype: refactor\ndate: 2026-02-08\n---\n\n# Reduce compound..."
},
{
"path": "docs/plans/2026-02-09-refactor-dspy-ruby-skill-update-plan.md",
"chars": 5325,
"preview": "---\ntitle: \"refactor: Update dspy-ruby skill to DSPy.rb v0.34.3 API\"\ntype: refactor\ndate: 2026-02-09\n---\n\n# Update dspy-..."
},
{
"path": "docs/plans/2026-02-12-feat-add-cursor-cli-target-provider-plan.md",
"chars": 12728,
"preview": "---\ntitle: Add Cursor CLI as a Target Provider\ntype: feat\ndate: 2026-02-12\n---\n\n# Add Cursor CLI as a Target Provider\n\n#..."
},
{
"path": "docs/plans/2026-02-14-feat-add-copilot-converter-target-plan.md",
"chars": 11585,
"preview": "---\ntitle: \"feat: Add GitHub Copilot converter target\"\ntype: feat\ndate: 2026-02-14\nstatus: complete\n---\n\n# feat: Add Git..."
},
{
"path": "docs/plans/2026-02-14-feat-add-gemini-cli-target-provider-plan.md",
"chars": 15800,
"preview": "---\ntitle: Add Gemini CLI as a Target Provider\ntype: feat\nstatus: completed\ncompleted_date: 2026-02-14\ncompleted_by: \"Cl..."
},
{
"path": "docs/plans/2026-02-14-feat-auto-detect-install-and-gemini-sync-plan.md",
"chars": 12027,
"preview": "---\ntitle: Auto-detect install targets and add Gemini sync\ntype: feat\nstatus: completed\ndate: 2026-02-14\ncompleted_date:..."
},
{
"path": "docs/plans/2026-02-25-feat-windsurf-global-scope-support-plan.md",
"chars": 30075,
"preview": "---\ntitle: Windsurf Global Scope Support\ntype: feat\nstatus: completed\ndate: 2026-02-25\ndeepened: 2026-02-25\nprior: docs/..."
},
{
"path": "docs/plans/2026-03-01-feat-ce-command-aliases-backwards-compatible-deprecation-plan.md",
"chars": 13334,
"preview": "---\ntitle: \"feat: Add ce:* command aliases with backwards-compatible deprecation of workflows:*\"\ntype: feat\nstatus: comp..."
},
{
"path": "docs/plans/2026-03-01-fix-setup-skill-non-claude-llm-fallback-plan.md",
"chars": 8067,
"preview": "---\ntitle: \"fix: Setup skill fails silently on non-Claude LLMs due to AskUserQuestion dependency\"\ntype: fix\nstatus: acti..."
},
{
"path": "docs/plans/2026-03-03-feat-sync-claude-mcp-all-supported-providers-plan.md",
"chars": 23092,
"preview": "---\ntitle: \"feat: Sync Claude MCP servers to all supported providers\"\ntype: feat\ndate: 2026-03-03\nstatus: completed\ndeep..."
},
{
"path": "docs/plans/2026-03-15-001-feat-ce-ideate-skill-plan.md",
"chars": 28231,
"preview": "---\ntitle: \"feat: Add ce:ideate open-ended ideation skill\"\ntype: feat\nstatus: completed\ndate: 2026-03-15\norigin: docs/br..."
},
{
"path": "docs/plans/2026-03-16-001-feat-issue-grounded-ideation-plan.md",
"chars": 16462,
"preview": "---\ntitle: \"feat: Add issue-grounded ideation mode to ce:ideate\"\ntype: feat\nstatus: complete\ndate: 2026-03-16\norigin: do..."
},
{
"path": "docs/plans/2026-03-17-001-feat-release-automation-migration-beta-plan.md",
"chars": 39052,
"preview": "---\ntitle: \"feat: Migrate repo releases to manual release-please with centralized changelog\"\ntype: feat\nstatus: active\nd..."
},
{
"path": "docs/plans/2026-03-18-001-feat-auto-memory-integration-beta-plan.md",
"chars": 12938,
"preview": "---\ntitle: \"feat: Integrate auto memory as data source for ce:compound and ce:compound-refresh\"\ntype: feat\nstatus: compl..."
},
{
"path": "docs/plans/2026-03-22-001-feat-frontend-design-skill-rewrite-beta-plan.md",
"chars": 15823,
"preview": "---\ntitle: \"feat: Rewrite frontend-design skill with layered architecture and visual verification\"\ntype: feat\nstatus: co..."
},
{
"path": "docs/plans/2026-03-23-001-feat-ce-review-beta-pipeline-mode-beta-plan.md",
"chars": 19496,
"preview": "---\ntitle: \"feat: Make ce:review-beta autonomous and pipeline-safe\"\ntype: feat\nstatus: active\ndate: 2026-03-23\norigin: d..."
},
{
"path": "docs/plans/2026-03-23-001-feat-plan-review-personas-beta-plan.md",
"chars": 39597,
"preview": "---\ntitle: \"feat: Replace document-review with persona-based review pipeline\"\ntype: feat\nstatus: completed\ndate: 2026-03..."
},
{
"path": "docs/plans/2026-03-23-001-feat-promote-plan-beta-skills-to-stable-plan.md",
"chars": 6491,
"preview": "---\ntitle: \"feat: promote ce:plan-beta and deepen-plan-beta to stable\"\ntype: feat\nstatus: completed\ndate: 2026-03-23\n---..."
},
{
"path": "docs/plans/2026-03-25-001-feat-onboarding-skill-plan.md",
"chars": 19077,
"preview": "---\ntitle: \"feat: Add onboarding skill to generate ONBOARDING.md from repo crawl\"\ntype: feat\nstatus: complete\ndate: 2026..."
},
{
"path": "docs/plans/2026-03-25-002-refactor-config-storage-redesign-plan.md",
"chars": 39167,
"preview": "---\ntitle: \"refactor: Redesign config and worktree-safe storage for compound-engineering\"\ntype: refactor\nstatus: active..."
},
{
"path": "docs/plans/2026-03-26-001-feat-adversarial-review-agents-plan.md",
"chars": 25868,
"preview": "---\ntitle: \"feat: Add adversarial review agents for code and documents\"\ntype: feat\nstatus: completed\ndate: 2026-03-26\nde..."
},
{
"path": "docs/plans/2026-03-26-001-refactor-merge-deepen-into-plan.md",
"chars": 20942,
"preview": "---\ntitle: \"refactor: Merge deepen-plan into ce:plan as automatic confidence check\"\ntype: refactor\nstatus: completed\ndat..."
},
{
"path": "docs/plans/2026-03-27-001-refactor-ce-skill-prefix-rename-plan.md",
"chars": 34355,
"preview": "---\ntitle: \"refactor: Rename all skills and agents to consistent ce- prefix\"\ntype: refactor\nstatus: completed\ndate: 2026..."
},
{
"path": "docs/plans/2026-03-28-001-feat-ce-review-headless-mode-plan.md",
"chars": 21165,
"preview": "---\ntitle: \"feat(ce-review): Add headless mode for programmatic callers\"\ntype: feat\nstatus: completed\ndate: 2026-03-28\no..."
},
{
"path": "docs/plans/2026-03-29-001-feat-brainstorm-visual-aids-plan.md",
"chars": 15676,
"preview": "---\ntitle: \"feat(ce-brainstorm): Add conditional visual aids to requirements documents\"\ntype: feat\nstatus: completed\ndat..."
},
{
"path": "docs/plans/2026-03-29-001-feat-iterative-optimization-loop-skill-beta-plan.md",
"chars": 43648,
"preview": "---\ntitle: \"feat(ce-optimize): Add iterative optimization loop skill\"\ntype: feat\nstatus: completed\ndate: 2026-03-29\norig..."
},
{
"path": "docs/plans/2026-03-29-001-feat-testing-addressed-gate-plan.md",
"chars": 16882,
"preview": "---\ntitle: \"feat: Close the testing gap in ce:work, ce:plan, and testing-reviewer\"\ntype: feat\nstatus: active\ndate: 2026-..."
},
{
"path": "docs/plans/2026-03-29-002-feat-plan-visual-aids-plan.md",
"chars": 14714,
"preview": "---\ntitle: \"feat(ce-plan): Add conditional visual aids to plan documents\"\ntype: feat\nstatus: completed\ndate: 2026-03-29..."
},
{
"path": "docs/plans/2026-03-29-002-feat-pr-feedback-clustering-plan.md",
"chars": 32095,
"preview": "---\ntitle: \"feat(resolve-pr-feedback): Add feedback clustering to detect systemic issues\"\ntype: feat\nstatus: completed\nd..."
},
{
"path": "docs/plans/2026-03-29-003-feat-pr-description-visual-aids-plan.md",
"chars": 11305,
"preview": "---\ntitle: \"feat(git-commit-push-pr): Add conditional visual aids to PR descriptions\"\ntype: feat\nstatus: completed\ndate:..."
},
{
"path": "docs/plans/2026-03-30-001-feat-cli-readiness-review-persona-plan.md",
"chars": 11768,
"preview": "---\ntitle: \"feat: Add CLI agent-readiness conditional persona to ce:review\"\ntype: feat\nstatus: active\ndate: 2026-03-30\no..."
},
{
"path": "docs/plans/2026-03-31-001-feat-codex-delegation-plan.md",
"chars": 37291,
"preview": "---\ntitle: \"feat: Add Codex delegation mode to ce:work\"\ntype: feat\nstatus: completed\ndate: 2026-03-31\norigin: docs/brain..."
},
{
"path": "docs/plans/2026-04-01-001-feat-cross-invocation-cluster-analysis-plan.md",
"chars": 20942,
"preview": "---\ntitle: \"feat(resolve-pr-feedback): cross-invocation cluster analysis\"\ntype: feat\nstatus: completed\ndate: 2026-04-01..."
},
{
"path": "docs/plans/2026-04-02-001-feat-slack-analyst-agent-plan.md",
"chars": 23702,
"preview": "---\ntitle: \"feat(ce-slack-researcher): Add Slack analyst research agent with workflow integration\"\ntype: feat\nstatus: ac..."
},
{
"path": "docs/plans/2026-04-05-001-feat-universal-planning-plan.md",
"chars": 21728,
"preview": "---\ntitle: \"feat: Add universal planning support for non-software tasks\"\ntype: feat\nstatus: completed\ndate: 2026-04-05\no..."
},
{
"path": "docs/plans/2026-04-09-001-feat-ce-work-token-extraction-plan.md",
"chars": 13435,
"preview": "---\ntitle: \"feat(ce-work): reduce token usage by extracting late-sequence references\"\ntype: feat\nstatus: completed\ndate:..."
},
{
"path": "docs/plans/2026-04-15-001-feat-ce-polish-skill-plan.md",
"chars": 79889,
"preview": "---\ntitle: \"feat: Add /ce:polish skill for human-in-the-loop refinement before merge\"\ntype: feat\nstatus: active\ndate: 20..."
},
{
"path": "docs/plans/2026-04-16-001-fix-ce-polish-beta-detection-gaps-plan.md",
"chars": 41699,
"preview": "---\ntitle: \"fix: Close ce-polish-beta detection gaps from PR #568 feedback\"\ntype: fix\nstatus: active\ndate: 2026-04-16\n--..."
},
{
"path": "docs/plans/2026-04-17-001-feat-ce-ideate-mode-aware-v2-plan.md",
"chars": 77079,
"preview": "---\ntitle: \"feat: ce:ideate v2 — mode-aware ideation with web-researcher and opt-in persistence\"\ntype: feat\nstatus: acti..."
},
{
"path": "docs/plans/2026-04-17-001-feat-ce-release-notes-skill-plan.md",
"chars": 42340,
"preview": "---\ntitle: \"feat: ce:release-notes skill — conversational lookup over plugin releases\"\ntype: feat\nstatus: active\ndate: 2..."
},
{
"path": "docs/plans/2026-04-17-002-feat-ce-review-interactive-judgment-plan.md",
"chars": 64537,
"preview": "---\ntitle: \"feat: Add interactive judgment loop to ce:review\"\ntype: feat\nstatus: completed\ndate: 2026-04-17\norigin: docs..."
},
{
"path": "docs/plans/2026-04-18-001-feat-ce-doc-review-autofix-and-interaction-overhaul-plan.md",
"chars": 73395,
"preview": "---\ntitle: ce-doc-review Autofix and Interaction Overhaul\ntype: feat\nstatus: active\ndate: 2026-04-18\norigin: docs/brains..."
},
{
"path": "docs/plans/2026-04-18-001-refactor-native-install-cleanup-plan.md",
"chars": 27090,
"preview": "---\ntitle: \"refactor: Recenter installs on native packages and shared skill cleanup\"\ntype: refactor\nstatus: active\ndate:..."
},
{
"path": "docs/plans/2026-04-20-001-feat-codex-native-plugin-manifests-plan.md",
"chars": 41758,
"preview": "---\ntitle: \"feat: Ship Codex-format plugin manifests alongside Claude manifests\"\ntype: feat\nstatus: active\ndate: 2026-04..."
},
{
"path": "docs/plans/2026-04-20-001-fix-ce-compound-yaml-safety-plan.md",
"chars": 7377,
"preview": "---\ntitle: \"fix(ce-compound): quote YAML array items starting with reserved indicators\"\ntype: fix\nstatus: active\ndate: 2..."
},
{
"path": "docs/plans/2026-04-21-001-feat-ce-plan-traceability-loop-plan.md",
"chars": 39690,
"preview": "---\ntitle: \"feat: ce-plan U-IDs and origin traceability loop\"\ntype: feat\nstatus: active\ndate: 2026-04-21\n---\n\n# feat: ce..."
},
{
"path": "docs/plans/2026-04-21-001-refactor-ce-doc-review-anchored-confidence-scoring-plan.md",
"chars": 31498,
"preview": "---\ntitle: \"Refactor ce-doc-review confidence scoring to anchored rubric\"\ntype: refactor\nstatus: active\ndate: 2026-04-21..."
},
{
"path": "docs/plans/2026-04-21-002-refactor-ce-code-review-precision-and-validation-plan.md",
"chars": 50167,
"preview": "---\ntitle: \"refactor: Adopt anchored confidence, validation gate, and mode-aware precision in ce-code-review\"\ntype: refa..."
},
{
"path": "docs/plans/2026-04-22-001-feat-demo-reel-local-save-plan.md",
"chars": 10454,
"preview": "---\ntitle: \"feat(ce-demo-reel): Add local save as alternative to catbox upload\"\ntype: feat\nstatus: active\ndate: 2026-04-..."
},
{
"path": "docs/plans/2026-04-25-001-fix-ce-code-review-lfg-defer-bias-plan.md",
"chars": 38896,
"preview": "---\ntitle: \"fix: Remove LFG defer-bias and bulk-preview gate in ce-code-review\"\ntype: fix\nstatus: active\ndate: 2026-04-2..."
},
{
"path": "docs/plans/2026-04-26-feat-surface-scope-earlier-plan.md",
"chars": 42781,
"preview": "---\ntitle: \"feat: Surface scope earlier in ce-brainstorm and ce-plan via synthesis summaries\"\ntype: feat\nstatus: active..."
},
{
"path": "docs/plans/2026-05-08-001-fix-ce-sessions-orchestration-refactor-plan.md",
"chars": 57954,
"preview": "---\ntitle: \"fix: Refactor session-history orchestration to avoid subagent Skill-tool deadlock\"\ntype: fix\nstatus: complet..."
},
{
"path": "docs/plans/2026-05-11-001-feat-output-html-mode-plan.md",
"chars": 47586,
"preview": "---\ntitle: Add output:html mode to ce-plan and ce-brainstorm\ntype: feat\nstatus: active\ndate: 2026-05-11\n---\n\n# Add outpu..."
},
{
"path": "docs/plans/2026-06-02-001-feat-ce-code-review-safe-autofix-plan.md",
"chars": 14842,
"preview": "---\ntitle: \"feat: Safe self-applied fixes for ce-code-review\"\ntype: feat\nstatus: active\ndate: 2026-06-02\n---\n# feat: Saf..."
},
{
"path": "docs/plans/2026-06-04-001-feat-ce-plan-approach-altitude-plan.md",
"chars": 32027,
"preview": "---\ntitle: \"feat: ce-plan approach altitude — plan-for-a-plan as a first-class shape\"\ntype: feat\nstatus: active\ndate: 20..."
},
{
"path": "docs/plans/2026-06-18-001-refactor-unified-plan-doc-artifact-plan.md",
"chars": 72416,
"preview": "---\ntitle: \"refactor: Unify brainstorm and plan artifacts\"\ntype: refactor\ndate: 2026-06-18\n---\n\n# refactor: Unify brains..."
},
{
"path": "docs/plans/2026-06-22-001-feat-antigravity-target-remove-gemini-plan.md",
"chars": 22078,
"preview": "---\ntitle: \"feat: Add Antigravity (agy) target and remove Gemini CLI target\"\ndate: 2026-06-22\ntype: feat\nstatus: draft\no..."
},
{
"path": "docs/plans/2026-06-26-001-chore-remove-ce-work-beta-plan.html",
"chars": 30495,
"preview": "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<meta name=\"viewport\" content=\"width=device-width, initia..."
},
{
"path": "docs/plans/2026-06-28-001-feat-ce-pov-skill-plan.md",
"chars": 41307,
"preview": "---\ntitle: ce-pov Skill - Plan\ntype: feat\ndate: 2026-06-28\ntopic: ce-pov-skill\nartifact_contract: ce-unified-plan/v1\nart..."
},
{
"path": "docs/plans/2026-06-29-001-feat-shared-repo-grounding-cache-plan.md",
"chars": 32187,
"preview": "---\ntitle: Shared Repo-Grounding Profile Cache - Plan\ntype: feat\ndate: 2026-06-29\nartifact_contract: ce-unified-plan/v1..."
},
{
"path": "docs/plans/2026-07-02-001-feat-ce-sweep-skill-plan.md",
"chars": 52610,
"preview": "---\ntitle: ce-sweep Feedback Sweep Skill - Plan\ntype: feat\ndate: 2026-07-02\ntopic: ce-sweep-skill\nartifact_contract: ce-..."
},
{
"path": "docs/plans/2026-07-02-002-feat-ce-explain-skill-plan.md",
"chars": 33597,
"preview": "---\ntitle: ce-explain Skill - Plan\ntype: feat\ndate: 2026-07-02\ntopic: ce-explain-skill\nartifact_contract: ce-unified-pla..."
},
{
"path": "docs/plans/2026-07-05-001-feat-devin-cli-native-plugin-support-plan.md",
"chars": 18130,
"preview": "---\ntitle: Native Devin CLI Plugin Support - Plan\ntype: feat\ndate: 2026-07-05\nartifact_contract: ce-unified-plan/v1\narti..."
},
{
"path": "docs/plans/2026-07-07-001-feat-pr-concept-teaching-plan.md",
"chars": 31583,
"preview": "---\ntitle: PR Concept Teaching - Plan\ntype: feat\ndate: 2026-07-07\ntopic: pr-concept-teaching\nartifact_contract: ce-unifi..."
},
{
"path": "docs/plans/2026-07-08-001-fix-model-alias-map-latest-generations-plan.md",
"chars": 6752,
"preview": "---\ntitle: \"fix: Bump Claude family alias map to latest generations (Sonnet 5, Opus 4.8)\"\ndate: 2026-07-08\nartifact_cont..."
},
{
"path": "docs/plans/2026-07-09-001-feat-grok-plugin-support-plan.md",
"chars": 21961,
"preview": "---\nartifact_contract: ce-unified-plan/v1\nartifact_readiness: implementation-ready\nexecution: code\nproduct_contract_sour..."
},
{
"path": "docs/plans/2026-07-09-001-fix-ce-test-browser-native-driver-plan.md",
"chars": 4491,
"preview": "# Native Browser Driver Selection Implementation Plan\n\n> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:su..."
},
{
"path": "docs/plans/2026-07-09-002-feat-claude-code-fable-elevation-plan.md",
"chars": 39067,
"preview": "---\ntitle: Claude Code Fable Elevation - Plan\ntype: feat\ndate: 2026-07-09\ntopic: claude-code-fable-elevation\nartifact_co..."
},
{
"path": "docs/plans/2026-07-09-003-feat-doc-review-cross-model-plan.md",
"chars": 55266,
"preview": "---\ntitle: Cross-Model Adversarial Review for ce-doc-review - Plan\ntype: feat\ndate: 2026-07-09\ntopic: doc-review-cross-m..."
},
{
"path": "docs/plans/2026-07-11-001-feat-babysit-self-initiating-loop-plan.md",
"chars": 22493,
"preview": "---\ntitle: \"feat: ce-babysit-pr self-sustaining in-session watch loop + delegation-contract fix\"\ndate: 2026-07-11\nartifa..."
},
{
"path": "docs/plans/2026-07-13-001-feat-code-review-line-provenance-plan.md",
"chars": 13979,
"preview": "---\ntitle: \"feat: Surface load-bearing line provenance in ce-code-review findings\"\ndate: 2026-07-13\nartifact_contract: c..."
},
{
"path": "docs/plans/2026-07-13-001-fix-ce-proof-v3-owner-lifecycle-plan.md",
"chars": 16893,
"preview": "---\ntitle: \"fix: Migrate ce-proof to Proof v3 and owner credential lifecycle\"\ntype: fix\nstatus: active\ndate: 2026-07-13..."
},
{
"path": "docs/plans/2026-07-13-002-feat-code-review-cross-model-provider-port-plan.md",
"chars": 20886,
"preview": "---\ntitle: \"feat: Port doc-review cross-model provider mechanics to ce-code-review adversarial pass\"\ndate: 2026-07-13\nar..."
},
{
"path": "docs/plans/2026-07-14-001-feat-session-settled-decisions-plan.md",
"chars": 36157,
"preview": "---\ntitle: Session-Settled Decision Provenance - Plan\ntype: feat\ndate: 2026-07-14\nartifact_contract: ce-unified-plan/v1..."
},
{
"path": "docs/plans/2026-07-14-001-fix-detached-peer-job-lifecycle-plan.md",
"chars": 29642,
"preview": "---\ntitle: Detached Peer Job Lifecycle for Cross-Model Review - Plan\ntype: fix\ndate: 2026-07-14\nartifact_contract: ce-un..."
},
{
"path": "docs/plans/babysit-non-convergence-detection.md",
"chars": 10367,
"preview": "# Design note: non-convergence detection in the babysit pipeline loop\n\n> Status: design note for review. **Not** a `ce-u..."
},
{
"path": "docs/plans/feature_opencode-commands-as-md-and-config-merge.md",
"chars": 35434,
"preview": "# Feature: OpenCode Commands as .md Files, Config Merge, and Permissions Default Fix\n\n**Type:** feature + bug fix (conso..."
},
{
"path": "docs/plans/pipeline-mode-contract-and-lfg-babysit-consolidation.md",
"chars": 12990,
"preview": "# Plan: shared pipeline-mode contract + `lfg` ↔ `ce-babysit-pr` consolidation\n\n> Status: draft for review. Not a `ce-uni..."
},
{
"path": "docs/residual-review-findings/feat-ce-explain-skill.md",
"chars": 586,
"preview": "# Residual Review Findings\n\nSource: ce-code-review run `20260702-211155-42168d78` on branch `feat/ce-explain-skill` (pre..."
},
{
"path": "docs/skills/README.md",
"chars": 8073,
"preview": "# Skill Documentation\n\nEnd-user-facing documentation for compound-engineering plugin skills. Each page covers the skill'..."
},
{
"path": "docs/skills/ce-babysit-pr.md",
"chars": 14677,
"preview": "# `ce-babysit-pr`\n\n> Watch an open PR and keep it moving toward merge. React to CI failures and incoming review comments..."
},
{
"path": "docs/skills/ce-brainstorm.md",
"chars": 18916,
"preview": "# `ce-brainstorm`\n\n> Think through what something should become — collaboratively, one question at a time — then write a..."
},
{
"path": "docs/skills/ce-code-review.md",
"chars": 22192,
"preview": "# `ce-code-review`\n\n> Structured code review using tiered persona agents, confidence-gated findings, and a merge/dedup p..."
},
{
"path": "docs/skills/ce-commit-push-pr.md",
"chars": 18925,
"preview": "# `ce-commit-push-pr`\n\n> Go from working changes to an open PR with an adaptive, value-first description that scales in..."
},
{
"path": "docs/skills/ce-commit.md",
"chars": 10688,
"preview": "# `ce-commit`\n\n> Create a single, well-crafted git commit from working tree changes — convention-aware, sensitive-file-s..."
},
{
"path": "docs/skills/ce-compound-refresh.md",
"chars": 15047,
"preview": "# `ce-compound-refresh`\n\n> Maintain `docs/solutions/` over time — review existing learnings against the current codebase..."
},
{
"path": "docs/skills/ce-compound.md",
"chars": 20495,
"preview": "# `ce-compound`\n\n> Document a recently solved problem so the next encounter takes minutes instead of hours. Knowledge co..."
},
{
"path": "docs/skills/ce-debug.md",
"chars": 14855,
"preview": "# `ce-debug`\n\n> Find root causes systematically — trace the full causal chain before proposing any fix, refuse symptom-l..."
},
{
"path": "docs/skills/ce-doc-review.md",
"chars": 22818,
"preview": "# `ce-doc-review`\n\n> Review requirements or plan documents using parallel persona agents that surface role-specific issu..."
},
{
"path": "docs/skills/ce-dogfood.md",
"chars": 8786,
"preview": "# `ce-dogfood`\n\n> Hands-off, diff-scoped browser QA of the active branch — maps flows, drives a real browser, autonomous..."
},
{
"path": "docs/skills/ce-explain.md",
"chars": 5061,
"preview": "# `ce-explain`\n\n## TL;DR\n\nPoint it at a concept, a diff, an idea, or a window of your own recent work, and get a dense,..."
},
{
"path": "docs/skills/ce-ideate.md",
"chars": 16310,
"preview": "# `ce-ideate`\n\n> Discover strong, qualified directions worth exploring — across any domain — and let the rest fall away...."
},
{
"path": "docs/skills/ce-optimize.md",
"chars": 15029,
"preview": "# `ce-optimize`\n\n> Run metric-driven iterative optimization loops — define a measurable goal, build measurement scaffold..."
},
{
"path": "docs/skills/ce-plan.md",
"chars": 23358,
"preview": "# `ce-plan`\n\n> Establish the guardrails an implementation needs — decisions, units, files, tests, scope, risks — without..."
},
{
"path": "docs/skills/ce-polish.md",
"chars": 9964,
"preview": "# `ce-polish`\n\n> Start the dev server, open the feature in a browser, and iterate together — you say what feels off, fix..."
},
{
"path": "docs/skills/ce-pov.md",
"chars": 12801,
"preview": "# `ce-pov`\n\n> Form a decisive, project-grounded point of view on an external input — judge it against *this* project, no..."
},
{
"path": "docs/skills/ce-product-pulse.md",
"chars": 15491,
"preview": "# `ce-product-pulse`\n\n> Generate a time-windowed pulse report on what users experienced and how the product performed —..."
},
{
"path": "docs/skills/ce-promote.md",
"chars": 6374,
"preview": "# `ce-promote`\n\n> Turn a shipped feature into copy-pasteable, user-facing announcement copy — right inside the engineeri..."
},
{
"path": "docs/skills/ce-proof.md",
"chars": 11953,
"preview": "# `ce-proof`\n\n> Publish, share, view, comment on, and edit markdown documents via [Proof](https://www.proofeditor.ai), E..."
},
{
"path": "docs/skills/ce-resolve-pr-feedback.md",
"chars": 18467,
"preview": "# `ce-resolve-pr-feedback`\n\n> Evaluate, fix, and reply to PR review feedback in parallel. Fix what's real; don't churn o..."
},
{
"path": "docs/skills/ce-riffrec-feedback-analysis.md",
"chars": 12156,
"preview": "# `ce-riffrec-feedback-analysis`\n\n> Turn raw [Riffrec](https://github.com/kieranklaassen/riffrec) recordings into struct..."
},
{
"path": "docs/skills/ce-setup.md",
"chars": 5559,
"preview": "# `ce-setup`\n\n> Check Compound Engineering health, optional tool capabilities, and repo-local config safety.\n\n`ce-setup`..."
},
{
"path": "docs/skills/ce-simplify-code.md",
"chars": 20044,
"preview": "# `ce-simplify-code`\n\n> Refine recently changed code — three parallel reviewer agents find reuse, quality, and efficienc..."
},
{
"path": "docs/skills/ce-strategy.md",
"chars": 13526,
"preview": "# `ce-strategy`\n\n> Create or maintain `STRATEGY.md` — a short, durable anchor that captures what the product is, who it..."
},
{
"path": "docs/skills/ce-sweep.md",
"chars": 5331,
"preview": "# `/ce-sweep` — Recurring Feedback Sweep\n\n| | |\n|---|---|\n| **Purpose** | Sweep configured feedback sources for new item..."
},
{
"path": "docs/skills/ce-test-browser.md",
"chars": 14504,
"preview": "# `ce-test-browser`\n\n> Run end-to-end browser tests on pages affected by the current PR or branch using the best approve..."
},
{
"path": "docs/skills/ce-test-xcode.md",
"chars": 12298,
"preview": "# `ce-test-xcode`\n\n> Build and test iOS apps on the simulator using XcodeBuildMCP — captures screenshots, logs, and veri..."
},
{
"path": "docs/skills/ce-work.md",
"chars": 15925,
"preview": "# `ce-work`\n\n> Execute against the plan's guardrails — figure out the HOW with code in front of you, ship complete featu..."
},
{
"path": "docs/skills/ce-worktree.md",
"chars": 7113,
"preview": "# `ce-worktree`\n\n> Ensure work happens in an isolated git worktree without disturbing the current checkout — by detectin..."
},
{
"path": "docs/skills/lfg.md",
"chars": 5670,
"preview": "# `lfg`\n\n> Run the full hands-off engineering pipeline from planning through a green PR.\n\n`lfg` is the **autonomous pipe..."
},
{
"path": "docs/solutions/adding-converter-target-providers.md",
"chars": 25030,
"preview": "---\ntitle: Adding New Converter Target Providers\ncategory: architecture\ntags: [converter, target-provider, plugin-conver..."
},
{
"path": "docs/solutions/agent-friendly-cli-principles.md",
"chars": 21361,
"preview": "# Building Agent-Friendly CLIs: Practical Principles\n\nCLIs are a natural fit for agents — text in, text out, composable..."
},
{
"path": "docs/solutions/architecture-patterns/host-native-browser-driver-selection.md",
"chars": 4969,
"preview": "---\ntitle: \"Separate host-native browser capabilities from portable fallbacks\"\ndate: 2026-07-09\ncategory: architecture-p..."
},
{
"path": "docs/solutions/best-practices/cache-invalidation-input-set-completeness.md",
"chars": 5736,
"preview": "---\ntitle: A correctness cache needs a COMPLETE, schema-derived invalidation input set\ndate: 2026-06-29\ncategory: docs/s..."
},
{
"path": "docs/solutions/best-practices/ce-pipeline-end-to-end-learnings.md",
"chars": 19921,
"preview": "---\ntitle: \"End-to-end learnings from running the full CE pipeline on a substantial feature\"\ndate: 2026-04-17\ncategory:..."
},
{
"path": "docs/solutions/best-practices/codex-delegation-best-practices.md",
"chars": 15749,
"preview": "---\ntitle: \"Codex Delegation Best Practices\"\ndate: 2026-04-01\ncategory: best-practices\nmodule: \"Codex delegation / skill..."
},
{
"path": "docs/solutions/best-practices/conditional-visual-aids-in-generated-documents.md",
"chars": 15279,
"preview": "---\ntitle: Conditional visual aids in generated documents and PR descriptions\ndate: 2026-03-29\ncategory: best-practices..."
},
{
"path": "docs/solutions/best-practices/predictable-tmp-cache-ownership-check.md",
"chars": 4723,
"preview": "---\ntitle: A predictable-path cache in shared /tmp is a prompt-injection vector — ownership-check reads\ndate: 2026-06-29..."
},
{
"path": "docs/solutions/best-practices/prefer-python-over-bash-for-pipeline-scripts.md",
"chars": 4872,
"preview": "---\ntitle: \"Prefer Python over bash for multi-step pipeline scripts\"\ndate: 2026-04-09\nlast_refreshed: 2026-06-20\ncategor..."
},
{
"path": "docs/solutions/best-practices/preserve-user-content-across-all-destructive-paths.md",
"chars": 7330,
"preview": "---\ntitle: \"A preserve-user-content guard must cover every destructive path to the target, not just the main one\"\ndate:..."
},
{
"path": "docs/solutions/codex-skill-prompt-entrypoints.md",
"chars": 4393,
"preview": "---\ntitle: Codex native skills, legacy prompts, and converter entry points\ncategory: architecture\ntags: [codex, converte..."
},
{
"path": "docs/solutions/conventions/antigravity-target-empirical-format-verification.md",
"chars": 7210,
"preview": "---\ntitle: Verify a new target platform's plugin format against the CLI binary, not its docs\ndate: 2026-06-23\ncategory:..."
},
{
"path": "docs/solutions/developer-experience/branch-based-plugin-install-and-testing.md",
"chars": 9490,
"preview": "---\ntitle: \"Branch-based plugin install and testing for Claude Code plugins\"\ndate: 2026-03-26\nproblem_type: developer_ex..."
},
{
"path": "docs/solutions/integrations/colon-namespaced-names-break-windows-paths.md",
"chars": 5610,
"preview": "---\ntitle: \"Colon-namespaced skill names break filesystem paths on Windows\"\ndate: 2026-03-26\nlast_refreshed: 2026-06-20..."
},
{
"path": "docs/solutions/integrations/cross-platform-model-field-normalization.md",
"chars": 10032,
"preview": "---\ntitle: \"Cross-platform model field normalization for target converters\"\ndate: 2026-03-29\ncategory: integration-issue..."
},
{
"path": "docs/solutions/integrations/kimi-native-plugin-manifest-support.md",
"chars": 5197,
"preview": "---\ntitle: \"Use native Kimi plugin manifests instead of a converter target\"\ndate: 2026-06-24\ncategory: integrations\nmodu..."
},
{
"path": "docs/solutions/integrations/native-plugin-install-strategy.md",
"chars": 8621,
"preview": "---\ntitle: \"Native plugin install strategy for supported harnesses\"\ndate: 2026-06-19\nlast_updated: 2026-06-30\ncategory:..."
},
{
"path": "docs/solutions/integrations/opencode-temperature-rejected-by-sonnet5-opus48.md",
"chars": 7400,
"preview": "---\ntitle: OpenCode converter emits a temperature that Sonnet 5 / Opus 4.8 reject\nmodule: src/converters/claude-to-openc..."
},
{
"path": "docs/solutions/plugin-versioning-requirements.md",
"chars": 4002,
"preview": "---\ntitle: Plugin Versioning and Documentation Requirements\ncategory: workflow\ntags: [versioning, changelog, readme, plu..."
},
{
"path": "docs/solutions/skill-design/arguments-token-is-claude-only-in-skill-bodies.md",
"chars": 10834,
"preview": "---\ntitle: \"$ARGUMENTS is reliably substituted inside SKILL.md only on Claude Code — reason over the user's prompt inste..."
},
{
"path": "docs/solutions/skill-design/authoring-auto-invoke-standing-instructions.md",
"chars": 8310,
"preview": "---\ntitle: Authoring \"Make It Automatic\" auto-invoke guidance for CE skills\ndate: 2026-07-12\ncategory: skill-design\nmodu..."
}
]
// ... and 485 more files (download for full content)
About this extraction
This page contains the full source code of the EveryInc/compound-engineering-plugin GitHub repository, extracted and formatted as plain text for AI agents and large language models (LLMs). The extraction includes 685 files (8.2 MB), approximately 2.2M tokens. Use this with OpenClaw, Claude, ChatGPT, Cursor, Windsurf, or any other AI tool that accepts text input. You can copy the full output to your clipboard or download it as a .txt file.
Extracted by GitExtract — free GitHub repo to text converter for AI. Built by Nikandr Surkov.