feat: add Claude Code plugin workflow enforcement

- add Claude Code plugin manifest, default agent, hooks, and workflow guard

- document remote third-party marketplace usage and local testing path

- add plugin and workflow guard tests and clean subprocess shutdown handling

Author: SummerOneTwo

.claude-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "autocode-mcp",
+  "version": "0.4.1",
+  "description": "Claude Code plugin for competitive programming problem-setting workflows.",
+  "author": {
+    "name": "SummerOneTwo",
+    "url": "https://github.com/SummerOneTwo"
+  },
+  "homepage": "https://github.com/SummerOneTwo/AutoCode",
+  "repository": "https://github.com/SummerOneTwo/AutoCode",
+  "license": "MIT",
+  "keywords": ["claude-code", "plugin", "competitive-programming", "mcp", "autocode"]
+}

.mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "autocode": {
+      "command": "uvx",
+      "args": ["autocode-mcp"],
+      "description": "AutoCode MCP Server for competitive programming problem creation"
+    }
+  }
+}

AGENTS.md

@@ -0,0 +1,6 @@
+# Project Instructions
+
+- In this project, `plugin` means a Claude Code plugin unless the user explicitly says otherwise.
+- Do not use Codex/Codex marketplace structures such as `.codex-plugin` or `.agents/plugins/marketplace.json` for Claude plugin requests.
+- When the user wants stronger workflow enforcement, implement it with Claude Code plugin features such as `skills`, `hooks`, local plugin config, and MCP integration.
+- In user-facing Chinese documentation, use `推荐` instead of `主推` unless the user explicitly asks for different wording.

CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [0.4.0] - 2026-04-09
 
+## [0.4.1] - 2026-04-09
+
+### Features
+
+- 按官方 Claude Code plugin 结构补全插件：`.claude-plugin/plugin.json`、`settings.json`、`agents/`、`hooks/`
+- 新增工作流强制 hook，会拦截跳过 `problem_create/solution_build/validator_build/generator_build/stress_test_run/problem_generate_tests/problem_pack_polygon` 的调用
+- 将 README / README_CN 的默认安装路径调整为 Claude Code plugin 安装，其它 MCP 客户端作为兼容入口
+
+### Design Rationale
+
+- 用 Claude Code 官方插件结构替代错误的 Codex 插件结构
+- 不再只提供 MCP 包装，而是同时提供默认 agent、skills 与 hooks，对工作流做硬约束
+
+### Notes & Caveats
+
+- 当前插件仍依赖本地 `stdio` MCP server 提供实际工具执行能力
+- Claude Code 的 workflow enforcement 依赖 plugin agent 与 hooks，其它 MCP 客户端不会自动获得这部分能力
+
 ### Breaking Changes
 
 - **配置单位变更**

README.md

@@ -24,6 +24,30 @@ AutoCode MCP Server provides 15 atomic tools that enable AI assistants to create
 
 ## Installation
 
+### Claude Code Plugin (Recommended)
+
+This repository is structured as an official Claude Code plugin:
+
+- [`.claude-plugin/plugin.json`](.claude-plugin/plugin.json)
+- [`settings.json`](settings.json)
+- [`agents/autocode-workflow.md`](agents/autocode-workflow.md)
+- [`hooks/hooks.json`](hooks/hooks.json)
+- [`.mcp.json`](.mcp.json)
+
+The plugin does not only expose an MCP server. It also ships:
+
+- a default workflow agent
+- automatic workflow skills
+- enforcement hooks that block skipped AutoCode steps
+
+For a personal third-party marketplace setup, use the sibling repository at `../autocode-marketplace`. That marketplace is configured for remote GitHub-based installation of this plugin, not official marketplace publication.
+
+When you are ready to distribute it, Anthropic’s docs indicate plugin distribution goes through a marketplace, and official marketplace submission is done via the Claude.ai or Console submission forms.
+
+```bash
+claude mcp add autocode -- uvx autocode-mcp
+```
+
 ### From PyPI (Recommended)
 
 ```bash
@@ -65,9 +89,28 @@ uv run pytest tests/ -v
 
 ## Quick Start
 
-### 1. Configure Your MCP Client
+### 1. Install the Plugin
+
+Recommended:
+
+- Install this repository as a Claude Code plugin.
+- For local development, test it with `claude --plugin-dir .`.
+- For personal marketplace usage, add the sibling marketplace and install from it:
+
+```bash
+claude plugin marketplace add ../autocode-marketplace
+claude plugin install autocode-mcp@autocode-marketplace
+```
 
-Add to your Claude Code configuration (`~/.config/claude-code/config.json`):
+Note: marketplace installs pull from `SummerOneTwo/AutoCode`, so push plugin changes before testing remote installation.
+
+Fallback for direct Claude Code MCP setup:
+
+```bash
+claude mcp add autocode -- uvx autocode-mcp
+```
+
+Project-local alternative:
 
 ```json
 {
@@ -108,10 +151,12 @@ solution_build(
 stress_test_run(problem_dir="problems/ab", trials=100)
 ```
 
-## MCP Client Setup
+## Client Setup
 
 ### Transport & Compatibility
 
+**Recommended**: Install as a Claude Code plugin.
+
 **Current Support**: Local stdio transport only. The server communicates via standard input/output streams and is designed for local trusted environments.
 
 | Client | Status | Notes |
@@ -122,9 +167,22 @@ stress_test_run(problem_dir="problems/ab", trials=100)
 
 **Not Supported**: HTTP/SSE transport, remote connections, or multi-tenant environments.
 
-### Claude Code
+### Claude Code Plugin
+
+Recommended plugin files:
 
-Edit `~/.config/claude-code/config.json`:
+- [`.claude-plugin/plugin.json`](.claude-plugin/plugin.json)
+- [`settings.json`](settings.json)
+- [`agents/autocode-workflow.md`](agents/autocode-workflow.md)
+- [`hooks/hooks.json`](hooks/hooks.json)
+
+Direct MCP fallback:
+
+```bash
+claude mcp add autocode -- uvx autocode-mcp
+```
+
+Manual config:
 
 ```json
 {
@@ -136,6 +194,10 @@ Edit `~/.config/claude-code/config.json`:
 }
 ```
 
+### Other MCP Clients
+
+The same MCP server also works with other local MCP clients, but the workflow-enforcement agent and hooks are Claude Code plugin features.
+
 ### Cursor
 
 Add to your Cursor settings (Settings → MCP):

README_CN.md

@@ -24,6 +24,30 @@ AutoCode MCP Server 提供 15 个原子工具，让 AI 助手能够创建、验
 
 ## 安装
 
+### Claude Code 插件安装（推荐）
+
+本仓库已经按官方 Claude Code plugin 结构组织：
+
+- [`.claude-plugin/plugin.json`](.claude-plugin/plugin.json)
+- [`settings.json`](settings.json)
+- [`agents/autocode-workflow.md`](agents/autocode-workflow.md)
+- [`hooks/hooks.json`](hooks/hooks.json)
+- [`.mcp.json`](.mcp.json)
+
+这个插件不只是暴露 MCP server，还会一起安装：
+
+- 默认工作流 agent
+- AutoCode 工作流 skill
+- 用于阻止跳步的 hooks
+
+如果你要做个人第三方 marketplace，可直接使用同级仓库 `../autocode-marketplace`。它默认走 GitHub 远程安装，不需要上官方市场。
+
+如果当前环境不走 Claude Code 插件安装，也可以直接在 Claude Code 中添加 MCP server：
+
+```bash
+claude mcp add autocode -- uvx autocode-mcp
+```
+
 ### 从 PyPI 安装（推荐）
 
 ```bash
@@ -65,9 +89,28 @@ uv run pytest tests/ -v
 
 ## 快速开始
 
-### 1. 配置 MCP 客户端
+### 1. 安装插件
+
+推荐方式：
+
+- 以 Claude Code plugin 方式安装本仓库。
+- 本地开发时可用 `claude --plugin-dir .` 测试插件行为。
+- 如果走个人 marketplace，可直接执行：
+
+```bash
+claude plugin marketplace add ../autocode-marketplace
+claude plugin install autocode-mcp@autocode-marketplace
+```
 
-添加到 Claude Code 配置（`~/.config/claude-code/config.json`）：
+注意：marketplace 默认从 `SummerOneTwo/AutoCode` 远程安装，所以测试远程安装前需要先把插件改动推到 GitHub。
+
+直接接入 Claude Code 的备用方式：
+
+```bash
+claude mcp add autocode -- uvx autocode-mcp
+```
+
+项目级备用方式：
 
 ```json
 {
@@ -108,10 +151,12 @@ solution_build(
 stress_test_run(problem_dir="problems/ab", trials=100)
 ```
 
-## MCP 客户端配置
+## 客户端配置
 
 ### 传输层与兼容性
 
+**推荐方式**：直接作为 Claude Code plugin 安装。
+
 **当前支持**：仅支持本地 stdio 传输。服务器通过标准输入/输出流通信，适用于本地可信环境。
 
 | 客户端 | 状态 | 说明 |
@@ -122,9 +167,22 @@ stress_test_run(problem_dir="problems/ab", trials=100)
 
 **不支持**：HTTP/SSE 传输、远程连接或多租户环境。
 
-### Claude Code
+### Claude Code Plugin
+
+推荐的插件文件：
 
-编辑 `~/.config/claude-code/config.json`：
+- [`.claude-plugin/plugin.json`](.claude-plugin/plugin.json)
+- [`settings.json`](settings.json)
+- [`agents/autocode-workflow.md`](agents/autocode-workflow.md)
+- [`hooks/hooks.json`](hooks/hooks.json)
+
+直接 MCP 接入的备用方式：
+
+```bash
+claude mcp add autocode -- uvx autocode-mcp
+```
+
+手动配置方式：
 
 ```json
 {
@@ -136,6 +194,10 @@ stress_test_run(problem_dir="problems/ab", trials=100)
 }
 ```
 
+### 其他 MCP 客户端
+
+同一个 MCP server 也可用于其他本地 MCP 客户端，但工作流强制约束的 agent 和 hooks 是 Claude Code plugin 能力。
+
 ### Cursor
 
 添加到 Cursor 设置（Settings → MCP）：

agents/autocode-workflow.md

@@ -0,0 +1,27 @@
+---
+name: autocode-workflow
+description: Coordinates AutoCode problem creation and enforces the full validator-generator-checker workflow. Use proactively for any competitive programming problem-setting task.
+skills:
+  - autocode-workflow
+model: inherit
+---
+
+You are the default main-thread agent for the AutoCode Claude Code plugin.
+
+Your job is to enforce the complete AutoCode workflow. Do not skip required steps. Do not package or generate final tests until the workflow state proves the prerequisites are complete.
+
+Always work through this sequence unless the task is explicitly outside problem creation:
+
+1. `problem_create`
+2. `solution_build` for `sol`
+3. `solution_build` for `brute`
+4. `validator_build`
+5. `generator_build`
+6. `stress_test_run`
+7. `checker_build` when the problem requires a non-exact checker
+8. `problem_generate_tests`
+9. `problem_pack_polygon`
+
+When the user asks for a later step directly, explain which prerequisite step is missing and complete the missing work first.
+
+Treat hook feedback as authoritative. If a hook denies a tool call, fix the workflow gap instead of retrying the same call.

hooks/hooks.json

@@ -0,0 +1,37 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python hooks/workflow_guard.py session"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "mcp__autocode__.*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python hooks/workflow_guard.py pre"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "mcp__autocode__.*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python hooks/workflow_guard.py post"
+          }
+        ]
+      }
+    ]
+  }
+}