@every-env/compound-plugin 2.39.0 → 2.40.1

package/CHANGELOG.md

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 Release numbering now follows the repository `v*` tag line. Starting at `v2.34.0`, the root CLI package and this changelog stay on that shared version stream. Older entries below retain the previous `0.x` CLI numbering.
 
+## [2.40.1](https://github.com/EveryInc/compound-engineering-plugin/compare/v2.40.0...v2.40.1) (2026-03-17)
+
+
+### Bug Fixes
+
+* **kiro:** parse .mcp.json wrapper key and support remote MCP servers ([#259](https://github.com/EveryInc/compound-engineering-plugin/issues/259)) ([dfff20e](https://github.com/EveryInc/compound-engineering-plugin/commit/dfff20e1adab891b4645a53d0581d4b20577e3f1))
+
+# [2.40.0](https://github.com/EveryInc/compound-engineering-plugin/compare/v2.39.0...v2.40.0) (2026-03-17)
+
+
+### Features
+
+* specific model/harness/version in PR attribution ([#283](https://github.com/EveryInc/compound-engineering-plugin/issues/283)) ([fdbd584](https://github.com/EveryInc/compound-engineering-plugin/commit/fdbd584bac40ca373275b1b339ab81db65ac0958))
+
 # [2.39.0](https://github.com/EveryInc/compound-engineering-plugin/compare/v2.38.0...v2.39.0) (2026-03-16)
 
 

package/CLAUDE.md

@@ -359,14 +359,27 @@ Follow these patterns for commit messages:
 - `Fix [issue]` - Bug fixes
 - `Simplify [component] to [improvement]` - Refactoring
 
-Include the Claude Code footer:
+Include the attribution footer (fill in your actual values):
 
 ```
-🤖 Generated with [Claude Code](https://claude.com/claude-code)
+🤖 Generated with [MODEL] via [HARNESS](HARNESS_URL) + Compound Engineering v[VERSION]
 
-Co-Authored-By: Claude <noreply@anthropic.com>
+Co-Authored-By: [MODEL] ([CONTEXT] context, [THINKING]) <noreply@anthropic.com>
 ```
 
+**Fill in at commit/PR time:**
+
+| Placeholder | Value | Example |
+|-------------|-------|---------|
+| Placeholder | Value | Example |
+|-------------|-------|---------|
+| `[MODEL]` | Model name | Claude Opus 4.6, GPT-5.4 |
+| `[CONTEXT]` | Context window (if known) | 200K, 1M |
+| `[THINKING]` | Thinking level (if known) | extended thinking |
+| `[HARNESS]` | Tool running you | Claude Code, Codex, Gemini CLI |
+| `[HARNESS_URL]` | Link to that tool | `https://claude.com/claude-code` |
+| `[VERSION]` | `plugin.json` → `version` | 2.40.0 |
+
 ## Resources to search for when needing more information
 
 - [Claude Code Plugin Documentation](https://docs.claude.com/en/docs/claude-code/plugins)

package/docs/solutions/adding-converter-target-providers.md

@@ -687,7 +687,7 @@ Use this checklist when adding a new target provider:
 
 ## Related Files
 
-- `/C:/Source/compound-engineering-plugin/.claude-plugin/plugin.json` — Version and component counts
-- `/C:/Source/compound-engineering-plugin/CHANGELOG.md` — Recent additions and patterns
-- `/C:/Source/compound-engineering-plugin/README.md` — Usage examples for all targets
-- `/C:/Source/compound-engineering-plugin/docs/solutions/plugin-versioning-requirements.md` — Checklist for releases
+- `plugins/compound-engineering/.claude-plugin/plugin.json` — Version and component counts
+- `CHANGELOG.md` — Recent additions and patterns
+- `README.md` — Usage examples for all targets
+- `docs/solutions/plugin-versioning-requirements.md` — Checklist for releases

package/docs/solutions/plugin-versioning-requirements.md

@@ -72,8 +72,8 @@ This documentation serves as a reminder. When Claude Code works on this plugin,
 
 ## Related Files
 
-- `/Users/kieranklaassen/compound-engineering-plugin/plugins/compound-engineering/.claude-plugin/plugin.json`
-- `/Users/kieranklaassen/compound-engineering-plugin/plugins/compound-engineering/CHANGELOG.md`
-- `/Users/kieranklaassen/compound-engineering-plugin/plugins/compound-engineering/README.md`
-- `/Users/kieranklaassen/compound-engineering-plugin/package.json`
-- `/Users/kieranklaassen/compound-engineering-plugin/CHANGELOG.md`
+- `plugins/compound-engineering/.claude-plugin/plugin.json`
+- `plugins/compound-engineering/CHANGELOG.md`
+- `plugins/compound-engineering/README.md`
+- `package.json`
+- `CHANGELOG.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@every-env/compound-plugin",
-  "version": "2.39.0",
+  "version": "2.40.1",
   "type": "module",
   "private": false,
   "bin": {

package/plugins/compound-engineering/AGENTS.md

@@ -0,0 +1,110 @@
+# Plugin Instructions
+
+These instructions apply when working under `plugins/compound-engineering/`.
+They supplement the repo-root `AGENTS.md`.
+
+# Compounding Engineering Plugin Development
+
+## Versioning Requirements
+
+**IMPORTANT**: Routine PRs should not cut releases for this plugin.
+
+The repo uses an automatied release process to prepare plugin releases, including version selection and changelog generation. Because multiple PRs may merge before the next release, contributors cannot know the final released version from within an individual PR.
+
+### Contributor Rules
+
+- Do **not** manually bump `.claude-plugin/plugin.json` version in a normal feature PR.
+- Do **not** manually bump `.claude-plugin/marketplace.json` plugin version in a normal feature PR.
+- Do **not** cut a release section in `CHANGELOG.md` for a normal feature PR.
+- Do update substantive docs that are part of the actual change, such as `README.md`, component tables, usage instructions, or counts when they would otherwise become inaccurate.
+
+### Pre-Commit Checklist
+
+Before committing ANY changes:
+
+- [ ] No manual release-version bump in `.claude-plugin/plugin.json`
+- [ ] No manual release-version bump in `.claude-plugin/marketplace.json`
+- [ ] No manual release entry added to `CHANGELOG.md`
+- [ ] README.md component counts verified
+- [ ] README.md tables accurate (agents, commands, skills)
+- [ ] plugin.json description matches current counts
+
+### Directory Structure
+
+```
+agents/
+├── review/     # Code review agents
+├── research/   # Research and analysis agents
+├── design/     # Design and UI agents
+└── docs/       # Documentation agents
+
+skills/
+├── ce-*/          # Core workflow skills (ce:plan, ce:review, etc.)
+├── workflows-*/   # Deprecated aliases for ce:* skills
+└── */             # All other skills
+```
+
+> **Note:** Commands were migrated to skills in v2.39.0. All former
+> `/command-name` slash commands now live under `skills/command-name/SKILL.md`
+> and work identically in Claude Code. Other targets may convert or map these references differently.
+
+## Command Naming Convention
+
+**Workflow commands** use `ce:` prefix to unambiguously identify them as compound-engineering commands:
+- `/ce:brainstorm` - Explore requirements and approaches before planning
+- `/ce:plan` - Create implementation plans
+- `/ce:review` - Run comprehensive code reviews
+- `/ce:work` - Execute work items systematically
+- `/ce:compound` - Document solved problems
+
+**Why `ce:`?** Claude Code has built-in `/plan` and `/review` commands. The `ce:` namespace (short for compound-engineering) makes it immediately clear these commands belong to this plugin. The legacy `workflows:` prefix is still supported as deprecated aliases that forward to the `ce:*` equivalents.
+
+## Skill Compliance Checklist
+
+When adding or modifying skills, verify compliance with the skill spec:
+
+### YAML Frontmatter (Required)
+
+- [ ] `name:` present and matches directory name (lowercase-with-hyphens)
+- [ ] `description:` present and describes **what it does and when to use it** (per official spec: "Explains code with diagrams. Use when exploring how code works.")
+
+### Reference Links (Required if references/ exists)
+
+- [ ] All files in `references/` are linked as `[filename.md](./references/filename.md)`
+- [ ] All files in `assets/` are linked as `[filename](./assets/filename)`
+- [ ] All files in `scripts/` are linked as `[filename](./scripts/filename)`
+- [ ] No bare backtick references like `` `references/file.md` `` - use proper markdown links
+
+### Writing Style
+
+- [ ] Use imperative/infinitive form (verb-first instructions)
+- [ ] Avoid second person ("you should") - use objective language ("To accomplish X, do Y")
+
+### Cross-Platform User Interaction
+
+- [ ] When a skill needs to ask the user a question, instruct use of the platform's blocking question tool and name the known equivalents (`AskUserQuestion` in Claude Code, `request_user_input` in Codex, `ask_user` in Gemini)
+- [ ] Include a fallback for environments without a question tool (e.g., present numbered options and wait for the user's reply before proceeding)
+
+### Cross-Platform Reference Rules
+
+This plugin is authored once, then converted for other agent platforms. Commands and agents are transformed during that conversion, but `plugin.skills` are usually copied almost exactly as written.
+
+- [ ] Because of that, slash references inside command or agent content are acceptable when they point to real published commands; target-specific conversion can remap them.
+- [ ] Inside a pass-through `SKILL.md`, do not assume slash references will be remapped for another platform. Write references according to what will still make sense after the skill is copied as-is.
+- [ ] When one skill refers to another skill, prefer semantic wording such as "load the `document-review` skill" rather than slash syntax.
+- [ ] Use slash syntax only when referring to an actual published command or workflow such as `/ce:work` or `/deepen-plan`.
+
+### Quick Validation Command
+
+```bash
+# Check for unlinked references in a skill
+grep -E '`(references|assets|scripts)/[^`]+`' skills/*/SKILL.md
+# Should return nothing if all refs are properly linked
+
+# Check description format - should describe what + when
+grep -E '^description:' skills/*/SKILL.md
+```
+
+## Documentation
+
+See `docs/solutions/plugin-versioning-requirements.md` for detailed versioning workflow.

package/plugins/compound-engineering/CLAUDE.md

@@ -1,97 +1 @@
-# Compounding Engineering Plugin Development
-
-## Versioning Requirements
-
-**IMPORTANT**: Routine PRs should not cut releases for this plugin.
-
-The repo uses an automatied release process to prepare plugin releases, including version selection and changelog generation. Because multiple PRs may merge before the next release, contributors cannot know the final released version from within an individual PR.
-
-### Contributor Rules
-
-- Do **not** manually bump `.claude-plugin/plugin.json` version in a normal feature PR.
-- Do **not** manually bump `.claude-plugin/marketplace.json` plugin version in a normal feature PR.
-- Do **not** cut a release section in `CHANGELOG.md` for a normal feature PR.
-- Do update substantive docs that are part of the actual change, such as `README.md`, component tables, usage instructions, or counts when they would otherwise become inaccurate.
-
-### Pre-Commit Checklist
-
-Before committing ANY changes:
-
-- [ ] No manual release-version bump in `.claude-plugin/plugin.json`
-- [ ] No manual release-version bump in `.claude-plugin/marketplace.json`
-- [ ] No manual release entry added to `CHANGELOG.md`
-- [ ] README.md component counts verified
-- [ ] README.md tables accurate (agents, commands, skills)
-- [ ] plugin.json description matches current counts
-
-### Directory Structure
-
-```
-agents/
-├── review/     # Code review agents
-├── research/   # Research and analysis agents
-├── design/     # Design and UI agents
-├── workflow/   # Workflow automation agents
-└── docs/       # Documentation agents
-
-skills/
-├── ce-*/          # Core workflow skills (ce:plan, ce:review, etc.)
-├── workflows-*/   # Deprecated aliases for ce:* skills
-└── */             # All other skills
-```
-
-> **Note:** Commands were migrated to skills in v2.39.0. All former
-> `/command-name` slash commands now live under `skills/command-name/SKILL.md`
-> and work identically (Claude Code 2.1.3+ merged the two formats).
-
-## Command Naming Convention
-
-**Workflow commands** use `ce:` prefix to unambiguously identify them as compound-engineering commands:
-- `/ce:plan` - Create implementation plans
-- `/ce:review` - Run comprehensive code reviews
-- `/ce:work` - Execute work items systematically
-- `/ce:compound` - Document solved problems
-- `/ce:brainstorm` - Explore requirements and approaches before planning
-
-**Why `ce:`?** Claude Code has built-in `/plan` and `/review` commands. The `ce:` namespace (short for compound-engineering) makes it immediately clear these commands belong to this plugin. The legacy `workflows:` prefix is still supported as deprecated aliases that forward to the `ce:*` equivalents.
-
-## Skill Compliance Checklist
-
-When adding or modifying skills, verify compliance with skill-creator spec:
-
-### YAML Frontmatter (Required)
-
-- [ ] `name:` present and matches directory name (lowercase-with-hyphens)
-- [ ] `description:` present and describes **what it does and when to use it** (per official spec: "Explains code with diagrams. Use when exploring how code works.")
-
-### Reference Links (Required if references/ exists)
-
-- [ ] All files in `references/` are linked as `[filename.md](./references/filename.md)`
-- [ ] All files in `assets/` are linked as `[filename](./assets/filename)`
-- [ ] All files in `scripts/` are linked as `[filename](./scripts/filename)`
-- [ ] No bare backtick references like `` `references/file.md` `` - use proper markdown links
-
-### Writing Style
-
-- [ ] Use imperative/infinitive form (verb-first instructions)
-- [ ] Avoid second person ("you should") - use objective language ("To accomplish X, do Y")
-
-### Cross-Platform User Interaction
-
-- [ ] When a skill needs to ask the user a question, instruct use of the platform's blocking question tool and name the known equivalents (`AskUserQuestion` in Claude Code, `request_user_input` in Codex, `ask_user` in Gemini)
-- [ ] Include a fallback for environments without a question tool (e.g., present numbered options and wait for the user's reply before proceeding)
-
-### Quick Validation Command
-
-```bash
-# Check for unlinked references in a skill
-grep -E '`(references|assets|scripts)/[^`]+`' skills/*/SKILL.md
-# Should return nothing if all refs are properly linked
-
-# Check description format - should describe what + when
-grep -E '^description:' skills/*/SKILL.md
-```
-
-## Documentation
-
-See `docs/solutions/plugin-versioning-requirements.md` for detailed versioning workflow.
+@AGENTS.md

package/plugins/compound-engineering/skills/ce-work/SKILL.md

@@ -228,13 +228,28 @@ This command takes a work document (plan, specification, or todo file) and execu
 
    Brief explanation if needed.
 
-   🤖 Generated with [Claude Code](https://claude.com/claude-code)
+   🤖 Generated with [MODEL] via [HARNESS](HARNESS_URL) + Compound Engineering v[VERSION]
 
-   Co-Authored-By: Claude <noreply@anthropic.com>
+   Co-Authored-By: [MODEL] ([CONTEXT] context, [THINKING]) <noreply@anthropic.com>
    EOF
    )"
    ```
 
+   **Fill in at commit/PR time:**
+
+   | Placeholder | Value | Example |
+   |-------------|-------|---------|
+   | Placeholder | Value | Example |
+   |-------------|-------|---------|
+   | `[MODEL]` | Model name | Claude Opus 4.6, GPT-5.4 |
+   | `[CONTEXT]` | Context window (if known) | 200K, 1M |
+   | `[THINKING]` | Thinking level (if known) | extended thinking |
+   | `[HARNESS]` | Tool running you | Claude Code, Codex, Gemini CLI |
+   | `[HARNESS_URL]` | Link to that tool | `https://claude.com/claude-code` |
+   | `[VERSION]` | `plugin.json` → `version` | 2.40.0 |
+
+   Subagents creating commits/PRs are equally responsible for accurate attribution.
+
 2. **Capture and Upload Screenshots for UI Changes** (REQUIRED for any UI work)
 
    For **any** design changes, new views, or UI modifications, you MUST capture and upload screenshots:
@@ -308,7 +323,8 @@ This command takes a work document (plan, specification, or todo file) and execu
 
    ---
 
-   [![Compound Engineered](https://img.shields.io/badge/Compound-Engineered-6366f1)](https://github.com/EveryInc/compound-engineering-plugin) 🤖 Generated with [Claude Code](https://claude.com/claude-code)
+   [![Compound Engineering v[VERSION]](https://img.shields.io/badge/Compound_Engineering-v[VERSION]-6366f1)](https://github.com/EveryInc/compound-engineering-plugin)
+   🤖 Generated with [MODEL] ([CONTEXT] context, [THINKING]) via [HARNESS](HARNESS_URL)
    EOF
    )"
    ```
@@ -445,7 +461,7 @@ Before creating PR, verify:
 - [ ] Commit messages follow conventional format
 - [ ] PR description includes Post-Deploy Monitoring & Validation section (or explicit no-impact rationale)
 - [ ] PR description includes summary, testing notes, and screenshots
-- [ ] PR description includes Compound Engineered badge
+- [ ] PR description includes Compound Engineered badge with accurate model, harness, and version
 
 ## When to Use Reviewer Agents
 

package/src/converters/claude-to-kiro.ts

@@ -53,7 +53,7 @@ export function convertClaudeToKiro(
     convertCommandToSkill(command, usedSkillNames, agentNames),
   )
 
-  // Convert MCP servers (stdio only)
+  // Convert MCP servers (stdio and remote)
   const mcpServers = convertMcpServers(plugin.mcpServers)
 
   // Build steering files from CLAUDE.md
@@ -177,19 +177,20 @@ function convertMcpServers(
 
   const result: Record<string, KiroMcpServer> = {}
   for (const [name, server] of Object.entries(servers)) {
-    if (!server.command) {
+    if (server.command) {
+      const entry: KiroMcpServer = { command: server.command }
+      if (server.args && server.args.length > 0) entry.args = server.args
+      if (server.env && Object.keys(server.env).length > 0) entry.env = server.env
+      result[name] = entry
+    } else if (server.url) {
+      const entry: KiroMcpServer = { url: server.url }
+      if (server.headers && Object.keys(server.headers).length > 0) entry.headers = server.headers
+      result[name] = entry
+    } else {
       console.warn(
-        `Warning: MCP server "${name}" has no command (HTTP/SSE transport). Kiro only supports stdio. Skipping.`,
+        `Warning: MCP server "${name}" has no command or url. Skipping.`,
       )
-      continue
     }
-
-    const entry: KiroMcpServer = { command: server.command }
-    if (server.args && server.args.length > 0) entry.args = server.args
-    if (server.env && Object.keys(server.env).length > 0) entry.env = server.env
-
-    console.log(`MCP server "${name}" will execute: ${server.command}${server.args ? " " + server.args.join(" ") : ""}`)
-    result[name] = entry
   }
   return result
 }

package/src/parsers/claude.ts

@@ -158,7 +158,8 @@ async function loadMcpServers(
 
   const mcpPath = path.join(root, ".mcp.json")
   if (await pathExists(mcpPath)) {
-    return readJson<Record<string, ClaudeMcpServer>>(mcpPath)
+    const raw = await readJson<Record<string, unknown>>(mcpPath)
+    return unwrapMcpServers(raw)
   }
 
   return undefined
@@ -232,12 +233,20 @@ async function loadMcpPaths(
   for (const entry of toPathList(value)) {
     const resolved = resolveWithinRoot(root, entry, "mcpServers path")
     if (await pathExists(resolved)) {
-      configs.push(await readJson<Record<string, ClaudeMcpServer>>(resolved))
+      const raw = await readJson<Record<string, unknown>>(resolved)
+      configs.push(unwrapMcpServers(raw))
     }
   }
   return configs
 }
 
+function unwrapMcpServers(raw: Record<string, unknown>): Record<string, ClaudeMcpServer> {
+  if (raw.mcpServers && typeof raw.mcpServers === "object") {
+    return raw.mcpServers as Record<string, ClaudeMcpServer>
+  }
+  return raw as Record<string, ClaudeMcpServer>
+}
+
 function mergeMcpConfigs(configs: Record<string, ClaudeMcpServer>[]): Record<string, ClaudeMcpServer> {
   return configs.reduce((acc, config) => ({ ...acc, ...config }), {})
 }

package/tests/kiro-converter.test.ts

@@ -174,7 +174,24 @@ describe("convertClaudeToKiro", () => {
     expect(bundle.mcpServers.local.args).toEqual(["hello"])
   })
 
-  test("MCP HTTP servers skipped with warning", () => {
+  test("MCP HTTP servers converted with url", () => {
+    const plugin: ClaudePlugin = {
+      ...fixturePlugin,
+      mcpServers: {
+        httpServer: { url: "https://example.com/mcp" },
+      },
+      agents: [],
+      commands: [],
+      skills: [],
+    }
+
+    const bundle = convertClaudeToKiro(plugin, defaultOptions)
+
+    expect(Object.keys(bundle.mcpServers)).toHaveLength(1)
+    expect(bundle.mcpServers.httpServer).toEqual({ url: "https://example.com/mcp" })
+  })
+
+  test("MCP servers with no command or url skipped with warning", () => {
     const warnings: string[] = []
     const originalWarn = console.warn
     console.warn = (msg: string) => warnings.push(msg)
@@ -182,7 +199,7 @@ describe("convertClaudeToKiro", () => {
     const plugin: ClaudePlugin = {
       ...fixturePlugin,
       mcpServers: {
-        httpServer: { url: "https://example.com/mcp" },
+        broken: {} as any,
       },
       agents: [],
       commands: [],
@@ -193,7 +210,7 @@ describe("convertClaudeToKiro", () => {
     console.warn = originalWarn
 
     expect(Object.keys(bundle.mcpServers)).toHaveLength(0)
-    expect(warnings.some((w) => w.includes("no command") || w.includes("HTTP"))).toBe(true)
+    expect(warnings.some((w) => w.includes("no command or url"))).toBe(true)
   })
 
   test("plugin with zero agents produces empty agents array", () => {