claude-engineering-plugin/CHANGELOG.md

Changelog

This is the canonical changelog for the repository.

Historical entries below reflect the older repo-wide release model. After the release-please migration cutover, new entries are written here as component-scoped headings such as compound-engineering vX.Y.Z - YYYY-MM-DD and cli vX.Y.Z - YYYY-MM-DD.

All notable changes to the @every-env/compound-plugin CLI tool and other release-owned repo components will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Historical release numbering below follows the older repository v* tag line. Older entries remain intact for continuity.

2.42.0 (2026-03-17)

Bug Fixes

• add disable-model-invocation to beta skills and refine descriptions (72d4b0d)
• beta skill naming, plan file suffixes, and promotion checklist (ac53635)
• preserve skill-style document-review handoffs (b2b23dd)
• review fixes — stale refs, skill counts, and validation guidance (a83e11e)

Features

• add ce:plan-beta and deepen-plan-beta as standalone beta skills (ad53d3d)
• align ce-plan question tool guidance (df4c466)
• rewrite ce:plan to separate planning from implementation (38a47b1)
• teach ce:work to consume decision-first plans (859ef60)

2.41.1 (2026-03-17)

Bug Fixes

• sync plugin version to 2.41.0 and correct skill counts (5bc3a0f)

2.41.0 (2026-03-17)

Bug Fixes

• tune ce:ideate volume model and presentation format (3023bfc)

Features

• add issue-grounded ideation mode to ce:ideate (0fc6717)
• refine ce:ideate skill with per-agent volume model and cross-cutting synthesis (b762c76)

2.40.3 (2026-03-17)

Bug Fixes

• research agents prefer native tools over shell for repo exploration (b290690)

2.40.2 (2026-03-17)

Bug Fixes

• harden codex copied skill rewriting (#285) (6f561f9)

2.40.1 (2026-03-17)

Bug Fixes

• kiro: parse .mcp.json wrapper key and support remote MCP servers (#259) (dfff20e)

2.40.0 (2026-03-17)

Features

• specific model/harness/version in PR attribution (#283) (fdbd584)

2.39.0 (2026-03-16)

Bug Fixes

• drop 'CLI' suffix from Codex and Gemini platform names (ec8d685)
• make brainstorm handoff auto-chain and cross-platform (637653d)
• restore 'wait for the user's reply' fallback language (fca3a40)

Features

• add leverage check to brainstorm skill (0100245)
• instruct brainstorm skill to use platform blocking question tools (d2c4cee)
• refactor brainstorm skill into requirements-first workflow (4d80a59)

2.38.0 (2026-03-16)

Bug Fixes

• skill: align compound-refresh question tool guidance (c2582fa)
• skills: allow direct commit on main as non-default option (0c333b0)
• skills: autonomous mode adapts to available permissions (684814d)
• skills: enforce branch creation when committing on main (6969014)
• skills: enforce full report output in autonomous mode (2ae6fc4)
• skills: improve ce:compound-refresh interaction and auto-archive behavior (0dff943)
• skills: include tool constraint in subagent task prompts (db8c84a)
• skills: prevent auto-archive when problem domain is still active (4201361)
• skills: remove prescriptive branch naming in compound-refresh (e3e7748)
• skills: require specific branch names based on what was refreshed (b7e4391)
• skills: specify markdown format for autonomous report output (c271bd4)
• skills: steer compound-refresh subagents toward file tools over shell commands (187571c)
• skills: strengthen autonomous mode to prevent blocking on user input (d3aff58)
• skills: use actual branch name in commit options instead of 'this branch' (a47f7d6)

Features

• skills: add autonomous mode to ce:compound-refresh (699f484)
• skills: add ce:compound-refresh skill for learning and pattern maintenance (bd3088a)
• skills: add Phase 5 commit workflow to ce:compound-refresh (d4c12c3)
• skills: add smart triage, drift classification, and replacement subagents to ce:compound-refresh (95ad09d)

2.37.1 (2026-03-16)

Bug Fixes

• compound: remove overly defensive context budget precheck (#278) (#279) (84ca52e)

2.37.0 (2026-03-15)

Features

• sync agent-browser skill with upstream vercel-labs/agent-browser (24860ec)

2.36.5 (2026-03-15)

Bug Fixes

• create-agent-skills: remove literal dynamic context directives that break skill loading (4b4d1ae), closes anthropics/claude-code#27149 #13655

2.36.4 (2026-03-14)

Bug Fixes

• skills: use fully-qualified agent namespace in Task invocations (026602e), closes #251

2.36.3 (2026-03-13)

Bug Fixes

• targets: nest colon-separated command names into directories (a84682c), closes #226

2.36.2 (2026-03-13)

Bug Fixes

• plan: remove deprecated /technical_review references (0ab9184), closes #244

2.36.1 (2026-03-13)

Bug Fixes

• agents: update learnings-researcher model from haiku to inherit (30852b7), closes #249

2.36.0 (2026-03-11)

Bug Fixes

• hooks: wrap PreToolUse handlers in try-catch to prevent parallel tool call crashes (598222e), closes #85
• install: merge config instead of overwriting on opencode target (1db7680), closes #125
• review: add serial mode to prevent context limit crashes (d96671b), closes #166

Features

• compound: add context budget precheck and compact-safe mode (c4b1358), closes #198
• plan: add daily sequence number to plan filenames (e94ca04), closes #135
• plugin: release v2.39.0 with community contributions (d2ab6c0)

2.35.0 (2026-03-10)

Bug Fixes

• test-browser: detect dev server port from project config (94aedd5), closes #164

Features

• compound: add context budget precheck and compact-safe mode (7266062), closes #198
• plan: add daily sequence number to plan filenames (4fc6ddc), closes #135

2.34.7 (2026-03-10)

Bug Fixes

• test-browser: detect dev server port from project config (50cb89e), closes #164

2.34.6 (2026-03-10)

Bug Fixes

• mcp: add API key auth support for Context7 server (c649cfc), closes #153

2.34.5 (2026-03-10)

Bug Fixes

• lfg: enforce plan phase with explicit step gating (b07f43d), closes #227

2.34.4 (2026-03-04)

Bug Fixes

• openclaw: emit empty configSchema in plugin manifests (4e9899f), closes #224

2.34.3 (2026-03-03)

Bug Fixes

• release: keep changelog header stable (2fd29ff)

2.34.2 (2026-03-03)

Bug Fixes

• release: add package repository metadata (eab77bc)

2.34.1 (2026-03-03)

Bug Fixes

• release: align cli versioning with repo tags (7c58eee)

[2.34.0] - 2026-03-03

Added

• Sync parity across supported providers — sync now uses a shared target registry and supports MCP sync for Codex, Droid, Gemini, Copilot, Pi, Windsurf, Kiro, and Qwen, with OpenClaw kept validation-gated for skills-only sync.
• Personal command sync — Personal Claude commands from ~/.claude/commands/ now sync into provider-native command surfaces, including Codex prompts and generated skills, Gemini TOML commands, OpenCode command markdown, Windsurf workflows, and converted skills where that is the closest available equivalent.

Changed

• Global user config targets — Copilot sync now writes to ~/.copilot/ and Gemini sync writes to ~/.gemini/, matching current documented user-level config locations.
• Gemini skill deduplication — Gemini sync now avoids mirroring skills that Gemini already resolves from ~/.agents/skills, preventing duplicate skill conflict warnings after sync.

Fixed

• Safe skill sync replacement — When a real directory already exists at a symlink target (for example ~/.config/opencode/skills/proof), sync now logs a warning and skips instead of throwing an error.

---

[0.12.0] - 2026-03-01

Added

• Auto-detect install targets — install --to all and convert --to all auto-detect installed AI coding tools and install to all of them in one command
• Gemini sync — sync --target gemini symlinks personal skills to .gemini/skills/ and merges MCP servers into .gemini/settings.json
• Sync all targets — sync --target all syncs personal config to all detected tools
• Tool detection utility — Checks config directories for OpenCode, Codex, Droid, Cursor, Pi, and Gemini

---

[0.11.0] - 2026-03-01

Added

• OpenClaw target — --to openclaw converts plugins to OpenClaw format. Agents become .md files, commands become .md files, pass-through skills copy unchanged, and MCP servers are written to openclaw-extension.json. Output goes to ~/.openclaw/extensions/<plugin-name>/ by default. Use --openclaw-home to override. (#217) — thanks @TrendpilotAI!
• Qwen Code target — --to qwen converts plugins to Qwen Code extension format. Agents become .yaml files with Qwen-compatible fields, commands become .md files, MCP servers write to qwen-extension.json, and a QWEN.md context file is generated. Output goes to ~/.qwen/extensions/<plugin-name>/ by default. Use --qwen-home to override. (#220) — thanks @rlam3!
• Windsurf target — --to windsurf converts plugins to Windsurf format. Claude agents become Windsurf skills (skills/{name}/SKILL.md), commands become flat workflows (global_workflows/{name}.md for global scope, workflows/{name}.md for workspace), and pass-through skills copy unchanged. MCP servers write to mcp_config.json (machine-readable, merged with existing config). (#202) — thanks @rburnham52!
• Global scope support — New --scope global|workspace flag (generic, Windsurf as first adopter). --to windsurf defaults to global scope (~/.codeium/windsurf/), making installed skills, workflows, and MCP servers available across all projects. Use --scope workspace for project-level .windsurf/ output.
• mcp_config.json integration — Windsurf converter writes proper machine-readable MCP config supporting stdio, Streamable HTTP, and SSE transports. Merges with existing config (user entries preserved, plugin entries take precedence). Written with 0o600 permissions.
• Shared utilities — Extracted resolveTargetOutputRoot to src/utils/resolve-output.ts and hasPotentialSecrets to src/utils/secrets.ts to eliminate duplication.

Fixed

• OpenClaw code injection — generateEntryPoint now uses JSON.stringify() for all string interpolation (was escaping only ", leaving \n/\\ unguarded).
• Qwen plugin.manifest.name — context file header was # undefined due to using plugin.name (which doesn't exist on ClaudePlugin); fixed to plugin.manifest.name.
• Qwen remote MCP servers — curl fallback removed; HTTP/SSE servers are now skipped with a warning (Qwen only supports stdio transport).
• --openclaw-home / --qwen-home CLI flags — wired through to resolveTargetOutputRoot so custom home directories are respected.

---

[0.9.1] - 2026-02-20

Changed

• Remove docs/reports and docs/decisions directories — only docs/plans/ is retained as living documents that track implementation progress
• OpenCode commands as Markdown — commands are now .md files with deep-merged config, permissions default to none (#201) — thanks @0ut5ider!
• Fix changelog GitHub link (#215) — thanks @XSAM!
• Update Claude Code install command in README (#218) — thanks @ianguelman!

---

[0.9.0] - 2026-02-17

Added

• Kiro CLI target — --to kiro converts plugins to .kiro/ format with custom agent JSON configs, prompt files, skills, steering files, and mcp.json. Only stdio MCP servers are supported (#196) — thanks @krthr!

---

[0.8.0] - 2026-02-17

Added

• GitHub Copilot target — --to copilot converts plugins to .github/ format with .agent.md files, SKILL.md skills, and copilot-mcp-config.json. Also supports sync --target copilot (#192) — thanks @brayanjuls!
• Native Cursor plugin support — Cursor now installs via /add-plugin compound-engineering using Cursor's native plugin system instead of CLI conversion (#184) — thanks @ericzakariasson!

Removed

• Cursor CLI conversion target (--to cursor) — replaced by native Cursor plugin install

---

[0.6.0] - 2026-02-12

Added

• Droid sync target — sync --target droid symlinks personal skills to ~/.factory/skills/
• Cursor sync target — sync --target cursor symlinks skills to .cursor/skills/ and merges MCP servers into .cursor/mcp.json
• Pi target — First-class --to pi converter with MCPorter config and subagent compatibility (#181) — thanks @gvkhosla!

Fixed

• Bare Claude model alias resolution — Fixed OpenCode converter not resolving bare model aliases like claude-sonnet-4-5-20250514 (#182) — thanks @waltbeaman!

Changed

• Extracted shared expandHome / resolveTargetHome helpers to src/utils/resolve-home.ts, removing duplication across convert.ts, install.ts, and sync.ts

---

[0.5.2] - 2026-02-09

Fixed

• Fix cursor install defaulting to cwd instead of opencode config dir

[0.5.1] - 2026-02-08

• Initial npm publish