@jtf19/vibecoding-kit 0.1.0

package/adapters/claude/install.md

@@ -0,0 +1,70 @@
+# Claude Adapter
+
+## 作用
+
+提供 Claude 平台识别 Vibecoding Kit 的最小适配信息。
+
+## 文件
+
+```text
+plugin.json
+settings.example.json
+```
+
+## 接入方式
+
+1. 保留项目根目录 `CLAUDE.md`。
+2. 保留 `.vibecoding/skills/`。
+3. 保留 `.vibecoding/adapters/claude/`。
+4. 让 Claude 会话优先按文件路径读取 `.vibecoding/skills/using-vibecoding/SKILL.md`，不依赖平台原生 skill registry。
+5. 阶段结束时检查 `Workflow Handoff`，并显式处理 `next_skill`。
+
+## 业务项目降级交互协议
+
+Claude 安装入口保持轻量产品体验：根目录 `CLAUDE.md` 负责低成本任务分流和安全边界提醒，完整 workflow 只在风险、阶段切换或交接需要时进入。不要把 runtime stage 长表或源码仓库维护者路线图注入普通业务会话。
+
+## 摘要优先入口
+
+安装后仍以根目录 `CLAUDE.md` 作为 Claude 入口。会话开始或任务开始时，如果使用 `workflow --start` 辅助判断，先读取 `workflow_start.entry_summary`：它给出入口分类、预期 state gap 和下一步人工动作。当 `entry_summary.state_gap_is_expected=true` 时，底层 `blocked_reasons` 只用于排障，不应把无状态规划请求解释为 runtime failure。
+
+完成或判断能否交付时，先读取 `completion_evidence.task_completion_summary`，再按需下钻 readiness gates、evidence inventory 和 closeout detail。
+
+这些摘要只改变阅读顺序，不授予隐藏执行、自动写入、自动测试、subagent、平台 API、git、push、PR 或 merge 权限。
+
+## 首次会话验收
+
+P56 安装后首次会话验收只读取本地入口文本、session-start shape 或人工导出的 transcript，不连接平台 API、不执行 hook 之外的业务命令、不运行 workflow skill。验收通过应看到：按文件路径读取 `.vibecoding/skills/using-vibecoding/SKILL.md`、轻量分流、可见下一步、`injectsFullSkill=false`、`no_auto_execution`、`subagent=false`、`platform_api=false`、`git=false`。
+
+## Distribution maturity
+
+P62 `p62_adapter_plugin_maturity` 要求 Claude adapter 在分发检查中保持 marker 稳定：`adapter_packaging_consistency`、`install_experience_score`、`dry_run_auditable=true`、`adapter_marker_drift=false`、`platform_api=false`、`npm_publish=false`、`git_tag=false`、`github_release=false`、`marketplace_upload=false`。
+
+该成熟度只说明 plugin draft 可由 `vibe-plugin-pack --dry-run` 审计、可由 `--check` 回比 `adapters/claude/`；不表示发布、上传、调用 Claude API、项目级安装或自动执行。
+
+## Runtime Bridge 边界
+
+`plugin.json` 声明 `runtimeBridge` capability：`mode` 固定为 `manual`，可读取 `next --dry-run --dispatch-intent` 的只读 intent，也可人工读取 Stage 6 `next --confirm --dispatch` 产生的 `.vibecoding-state/dispatches/<timestamp>.json` dispatch envelope，并可用 Stage 6.5 `dispatches --list` / `dispatches --show` / `dispatches --verify` 做 read-only dispatch audit。Stage 7 可用 `dispatches --claim` / `dispatches --ack` / `dispatches --claims` 记录人工 pickup 状态，但不能自动执行 skill、调用 subagent、调用平台 API 或触碰 git。
+
+Claude adapter-ready 只表示可以人工读取 intent 或 dispatch envelope 后加载目标 skill，也可以人工 claim / ack pickup 状态；不表示调用 Claude API、自动执行 skill、自行写入 dispatch event、修改原始 dispatch event 或标记 event consumed。
+
+## Hook 边界
+
+Claude 侧以 `CLAUDE.md` 和 skill 提示为主。本适配不声明 runtime 自动调用链；`next_skill` 只是下一步建议，需要用户或 agent 显式继续。
+
+如果平台支持 SessionStart command，可使用安装后的轻量 bootstrap：
+
+```bash
+node .vibecoding/hooks/session-start/session-start.mjs --format claude
+```
+
+该 bootstrap 只输出项目已安装 Vibecoding、配置路径、轻量路由和边界说明；不会注入完整 skill、写 `.vibecoding-state/`、调用 runtime、subagent、MCP、daemon、平台 API、git 或 worktree。
+
+## 验收
+
+使用：
+
+```text
+我想给这个项目加一个新功能，先帮我规划一下。
+```
+
+期望进入 `vibe-brainstorming` 或 `vibe-planning`，不直接写代码。

package/adapters/claude/plugin.json

@@ -0,0 +1,38 @@
+{
+  "name": "vibe-coding-kit",
+  "description": "Vibecoding workflow skills for planning, debugging, implementation, review, verification, and context compaction.",
+  "version": "0.1.0",
+  "author": {
+    "name": "vibe-coding-kit"
+  },
+  "license": "MIT",
+  "keywords": [
+    "vibecoding",
+    "skills",
+    "planning",
+    "debugging",
+    "verification",
+    "workflow"
+  ],
+  "layout": {
+    "repoSkills": "../../skills/",
+    "installedSkills": ".vibecoding/skills/",
+    "installedAdapter": ".vibecoding/adapters/claude/",
+    "entryFile": "CLAUDE.md"
+  },
+  "runtimeBridge": {
+    "supported": true,
+    "mode": "manual",
+    "canReadDispatchIntent": true,
+    "canAutoExecuteSkill": false,
+    "canCallSubagent": false,
+    "canTouchGit": false
+  },
+  "sessionStartBootstrap": {
+    "supported": true,
+    "command": "node .vibecoding/hooks/session-start/session-start.mjs --format claude",
+    "injectsFullSkill": false,
+    "writesRuntimeState": false,
+    "autoRunsNextSkill": false
+  }
+}

package/adapters/claude/settings.example.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo Load using-vibecoding before development tasks."
+          }
+        ]
+      }
+    ]
+  }
+}

package/adapters/codex/hooks.example.json

@@ -0,0 +1,15 @@
+{
+  "session_start": [
+    {
+      "message": "Vibecoding Kit installed. For development tasks, read .vibecoding/skills/using-vibecoding/SKILL.md by file path; use lightweight routing; do not treat missing native skill registration as a missing entry."
+    },
+    {
+      "command": "node .vibecoding/hooks/session-start/session-start.mjs --format codex"
+    }
+  ],
+  "workflow_handoff": [
+    {
+      "message": "Check Workflow Handoff before continuing. next_skill is a recommendation, not an automatic workflow chain."
+    }
+  ]
+}

package/adapters/codex/install.md

@@ -0,0 +1,72 @@
+# Codex Adapter
+
+## 作用
+
+提供 Codex 插件入口和 hooks 示例。
+
+## 文件
+
+```text
+plugin.json
+hooks.example.json
+```
+
+## 接入方式
+
+1. 保留项目根目录 `AGENTS.md`，并让会话入口优先按文件路径读取 `.vibecoding/skills/using-vibecoding/SKILL.md` 完成轻量判断，不依赖平台原生 skill registry。
+2. 保留 `.vibecoding/skills/`。
+3. 保留 `.vibecoding/adapters/codex/`。
+4. 使用 `plugin.json` 作为 Codex 插件 manifest。
+5. 按需合并 `hooks.example.json`，用于会话入口提示和 handoff 检查提示。
+
+## 业务项目降级交互协议
+
+Codex 安装入口保持轻量产品体验：根目录 `AGENTS.md` 负责低成本任务分流和安全边界提醒，完整 workflow 只在风险、阶段切换或交接需要时进入。不要把 runtime stage 长表或源码仓库维护者路线图注入普通业务会话。
+
+## 摘要优先入口
+
+安装后仍以根目录 `AGENTS.md` 作为 Codex 入口。会话开始或任务开始时，如果使用 `workflow --start` 辅助判断，先读取 `workflow_start.entry_summary`：它给出入口分类、预期 state gap 和下一步人工动作。当 `entry_summary.state_gap_is_expected=true` 时，底层 `blocked_reasons` 只用于排障，不应把无状态规划请求解释为 runtime failure。
+
+完成或判断能否交付时，先读取 `completion_evidence.task_completion_summary`，再按需下钻 readiness gates、evidence inventory 和 closeout detail。
+
+这些摘要只改变阅读顺序，不授予隐藏执行、自动写入、自动测试、subagent、平台 API、git、push、PR 或 merge 权限。
+
+## 首次会话验收
+
+P56 安装后首次会话验收只读取本地入口文本、session-start shape 或人工导出的 transcript，不连接平台 API、不执行 hook 之外的业务命令、不运行 workflow skill。验收通过应看到：按文件路径读取 `.vibecoding/skills/using-vibecoding/SKILL.md`、轻量分流、可见下一步、`injectsFullSkill=false`、`no_auto_execution`、`subagent=false`、`platform_api=false`、`git=false`。
+
+## Distribution maturity
+
+P62 `p62_adapter_plugin_maturity` 要求 Codex adapter 在分发检查中保持 marker 稳定：`adapter_packaging_consistency`、`install_experience_score`、`dry_run_auditable=true`、`adapter_marker_drift=false`、`platform_api=false`、`npm_publish=false`、`git_tag=false`、`github_release=false`、`marketplace_upload=false`。
+
+该成熟度只说明 plugin draft 可由 `vibe-plugin-pack --dry-run` 审计、可由 `--check` 回比 `adapters/codex/`；不表示发布、上传、调用 Codex API、项目级安装或自动执行。
+
+## Runtime Bridge 边界
+
+`plugin.json` 声明 `runtimeBridge` capability：`mode` 固定为 `manual`，可读取 `next --dry-run --dispatch-intent` 的只读 intent，也可人工读取 Stage 6 `next --confirm --dispatch` 产生的 `.vibecoding-state/dispatches/<timestamp>.json` dispatch envelope，并可用 Stage 6.5 `dispatches --list` / `dispatches --show` / `dispatches --verify` 做 read-only dispatch audit。Stage 7 可用 `dispatches --claim` / `dispatches --ack` / `dispatches --claims` 记录人工 pickup 状态，但不能自动执行 skill、调用 subagent、调用平台 API 或触碰 git。
+
+Codex adapter-ready 只表示可以人工读取 intent 或 dispatch envelope 后继续目标 workflow skill，也可以人工 claim / ack pickup 状态；不表示 Codex 自动调用平台 API、自动执行 skill、自行写入 dispatch event、修改原始 dispatch event 或标记 event consumed。Cursor / Codex 仍共用 `AGENTS.md` 入口语义。
+
+## Hook 边界
+
+`hooks.example.json` 只提供提示配置参考，用于提醒 agent 选择 workflow、检查 `Workflow Handoff` 和显式处理 `next_skill`。
+
+它不表示 Codex 会自动执行下一个 skill，也不维护 runtime 状态机。
+
+如果平台支持 session_start command，可使用安装后的轻量 bootstrap：
+
+```bash
+node .vibecoding/hooks/session-start/session-start.mjs --format codex
+```
+
+该 bootstrap 只输出项目已安装 Vibecoding、配置路径、轻量路由和边界说明；不会注入完整 skill、写 `.vibecoding-state/`、调用 runtime、subagent、MCP、daemon、平台 API、git 或 worktree。
+
+## 验收
+
+使用：
+
+```text
+这个功能不工作，帮我排查。
+```
+
+期望进入 `vibe-systematic-debugging`。

package/adapters/codex/plugin.json

@@ -0,0 +1,58 @@
+{
+  "name": "vibe-coding-kit",
+  "version": "0.1.0",
+  "description": "Vibecoding workflow skills for planning, debugging, implementation, review, and verification.",
+  "author": {
+    "name": "vibe-coding-kit"
+  },
+  "license": "MIT",
+  "keywords": [
+    "vibecoding",
+    "skills",
+    "planning",
+    "debugging",
+    "verification",
+    "workflow"
+  ],
+  "skills": "../../skills/",
+  "installedSkills": ".vibecoding/skills/",
+  "layout": {
+    "repoSkills": "../../skills/",
+    "installedSkills": ".vibecoding/skills/",
+    "installedAdapter": ".vibecoding/adapters/codex/",
+    "entryFile": "AGENTS.md"
+  },
+  "hooks": "./hooks.example.json",
+  "runtimeBridge": {
+    "supported": true,
+    "mode": "manual",
+    "canReadDispatchIntent": true,
+    "canAutoExecuteSkill": false,
+    "canCallSubagent": false,
+    "canTouchGit": false
+  },
+  "sessionStartBootstrap": {
+    "supported": true,
+    "command": "node .vibecoding/hooks/session-start/session-start.mjs --format codex",
+    "injectsFullSkill": false,
+    "writesRuntimeState": false,
+    "autoRunsNextSkill": false
+  },
+  "interface": {
+    "displayName": "Vibecoding Kit",
+    "shortDescription": "Practical vibecoding workflows for coding agents",
+    "longDescription": "Use Vibecoding Kit to guide coding agents through planning, debugging, implementation, review, verification, and context compaction.",
+    "developerName": "vibe-coding-kit",
+    "category": "Coding",
+    "capabilities": [
+      "Interactive",
+      "Read",
+      "Write"
+    ],
+    "defaultPrompt": [
+      "Plan a new feature before implementation.",
+      "Debug a broken behavior with evidence first.",
+      "Verify whether this work is ready to ship."
+    ]
+  }
+}

package/adapters/cursor/hooks.example.json

@@ -0,0 +1,17 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "message": "Vibecoding Kit installed. For development tasks, read .vibecoding/skills/using-vibecoding/SKILL.md by file path; use lightweight routing; do not treat missing native skill registration as a missing entry."
+      },
+      {
+        "command": "node .vibecoding/hooks/session-start/session-start.mjs --format cursor"
+      }
+    ],
+    "WorkflowHandoff": [
+      {
+        "message": "Check Workflow Handoff before continuing. next_skill is a recommendation, not an automatic workflow chain."
+      }
+    ]
+  }
+}

package/adapters/cursor/install.md

@@ -0,0 +1,72 @@
+# Cursor Adapter
+
+## 作用
+
+提供 Cursor 项目中的 Vibecoding Kit 插件入口和 hook 示例。
+
+## 文件
+
+```text
+plugin.json
+hooks.example.json
+```
+
+## 接入方式
+
+1. 保留项目根目录 `AGENTS.md`，并让会话入口优先按文件路径读取 `.vibecoding/skills/using-vibecoding/SKILL.md` 完成轻量判断，不依赖平台原生 skill registry。
+2. 保留 `.vibecoding/skills/`。
+3. 保留 `.vibecoding/adapters/cursor/`。
+4. 使用 `plugin.json` 描述 Cursor 侧插件元信息。
+5. 按需参考 `hooks.example.json` 配置会话入口提示和 handoff 检查提示。
+
+## 业务项目降级交互协议
+
+Cursor 安装入口保持轻量产品体验：根目录 `AGENTS.md` 负责低成本任务分流和安全边界提醒，完整 workflow 只在风险、阶段切换或交接需要时进入。不要把 runtime stage 长表或源码仓库维护者路线图注入普通业务会话。
+
+## 摘要优先入口
+
+安装后仍以根目录 `AGENTS.md` 作为 Cursor 入口。会话开始或任务开始时，如果使用 `workflow --start` 辅助判断，先读取 `workflow_start.entry_summary`：它给出入口分类、预期 state gap 和下一步人工动作。当 `entry_summary.state_gap_is_expected=true` 时，底层 `blocked_reasons` 只用于排障，不应把无状态规划请求解释为 runtime failure。
+
+完成或判断能否交付时，先读取 `completion_evidence.task_completion_summary`，再按需下钻 readiness gates、evidence inventory 和 closeout detail。
+
+这些摘要只改变阅读顺序，不授予隐藏执行、自动写入、自动测试、subagent、平台 API、git、push、PR 或 merge 权限。
+
+## 首次会话验收
+
+P56 安装后首次会话验收只读取本地入口文本、session-start shape 或人工导出的 transcript，不连接平台 API、不执行 hook 之外的业务命令、不运行 workflow skill。验收通过应看到：按文件路径读取 `.vibecoding/skills/using-vibecoding/SKILL.md`、轻量分流、可见下一步、`injectsFullSkill=false`、`no_auto_execution`、`subagent=false`、`platform_api=false`、`git=false`。
+
+## Distribution maturity
+
+P62 `p62_adapter_plugin_maturity` 要求 Cursor adapter 在分发检查中保持 marker 稳定：`adapter_packaging_consistency`、`install_experience_score`、`dry_run_auditable=true`、`adapter_marker_drift=false`、`platform_api=false`、`npm_publish=false`、`git_tag=false`、`github_release=false`、`marketplace_upload=false`。
+
+该成熟度只说明 plugin draft 可由 `vibe-plugin-pack --dry-run` 审计、可由 `--check` 回比 `adapters/cursor/`；不表示发布、上传、调用 Cursor API、项目级安装或自动执行。
+
+## Runtime Bridge 边界
+
+`plugin.json` 声明 `runtimeBridge` capability：`mode` 固定为 `manual`，可读取 `next --dry-run --dispatch-intent` 的只读 intent，也可人工读取 Stage 6 `next --confirm --dispatch` 产生的 `.vibecoding-state/dispatches/<timestamp>.json` dispatch envelope，并可用 Stage 6.5 `dispatches --list` / `dispatches --show` / `dispatches --verify` 做 read-only dispatch audit。Stage 7 可用 `dispatches --claim` / `dispatches --ack` / `dispatches --claims` 记录人工 pickup 状态，但不能自动执行 skill、调用 subagent、调用平台 API 或触碰 git。
+
+Cursor adapter-ready 只表示可以人工读取 intent 或 dispatch envelope 后继续目标 workflow skill，也可以人工 claim / ack pickup 状态；不表示 Cursor 自动调用平台 API、自动执行 skill、自行写入 dispatch event、修改原始 dispatch event 或标记 event consumed。Cursor / Codex 仍共用 `AGENTS.md` 入口语义。
+
+## Hook 边界
+
+`hooks.example.json` 只提供提示配置参考，用于提醒 agent 选择 workflow、检查 `Workflow Handoff` 和显式处理 `next_skill`。
+
+它不表示 Cursor 会自动执行下一个 skill，也不维护 runtime 状态机。
+
+如果平台支持 SessionStart command，可使用安装后的轻量 bootstrap：
+
+```bash
+node .vibecoding/hooks/session-start/session-start.mjs --format cursor
+```
+
+该 bootstrap 只输出项目已安装 Vibecoding、配置路径、轻量路由和边界说明；不会注入完整 skill、写 `.vibecoding-state/`、调用 runtime、subagent、MCP、daemon、平台 API、git 或 worktree。
+
+## 验收
+
+使用：
+
+```text
+实现完成了，帮我确认能不能交付。
+```
+
+期望进入 `vibe-verification-before-completion`；证据充分后建议 `vibe-finishing-a-development-branch`。

package/adapters/cursor/plugin.json

@@ -0,0 +1,42 @@
+{
+  "name": "vibe-coding-kit",
+  "displayName": "Vibecoding Kit",
+  "description": "Workflow skills and hooks for practical vibecoding.",
+  "version": "0.1.0",
+  "author": {
+    "name": "vibe-coding-kit"
+  },
+  "license": "MIT",
+  "keywords": [
+    "vibecoding",
+    "skills",
+    "planning",
+    "debugging",
+    "verification",
+    "workflow"
+  ],
+  "skills": "../../skills/",
+  "installedSkills": ".vibecoding/skills/",
+  "layout": {
+    "repoSkills": "../../skills/",
+    "installedSkills": ".vibecoding/skills/",
+    "installedAdapter": ".vibecoding/adapters/cursor/",
+    "entryFile": "AGENTS.md"
+  },
+  "runtimeBridge": {
+    "supported": true,
+    "mode": "manual",
+    "canReadDispatchIntent": true,
+    "canAutoExecuteSkill": false,
+    "canCallSubagent": false,
+    "canTouchGit": false
+  },
+  "sessionStartBootstrap": {
+    "supported": true,
+    "command": "node .vibecoding/hooks/session-start/session-start.mjs --format cursor",
+    "injectsFullSkill": false,
+    "writesRuntimeState": false,
+    "autoRunsNextSkill": false
+  },
+  "hooks": "./hooks.example.json"
+}

package/adapters/opencode/install.md

@@ -0,0 +1,95 @@
+# OpenCode Adapter
+
+## 作用
+
+提供 OpenCode bootstrap adapter 合同示例。
+
+## 文件
+
+```text
+plugin.json
+plugin.js
+install.md
+```
+
+## 接入方式
+
+1. 保留 `.vibecoding/skills/`，并把它作为 OpenCode skill path。
+2. 使用 `plugin.js` 中的合同示例生成 bootstrap context。
+3. 会话入口只提示轻量路由：按文件路径读取 `.vibecoding/skills/using-vibecoding/SKILL.md`；如果平台原生 skill registry 未注册，不应判定入口缺失。
+4. `legacy-workflow-discipline` 只增强入口纪律摘要，不默认注入完整 skill。
+
+## 业务项目降级交互协议
+
+OpenCode bootstrap 保持轻量产品体验：会话入口只提供任务分流、skill-loading guidance 和安全边界提醒，完整 workflow 只在风险、阶段切换或交接需要时进入。不要把 runtime stage 长表或源码仓库维护者路线图注入普通业务会话。
+
+## 摘要优先入口
+
+OpenCode adapter 使用摘要优先入口。会话开始或任务开始时，如果使用 `workflow --start` 辅助判断，先读取 `workflow_start.entry_summary`：它给出入口分类、预期 state gap 和下一步人工动作。当 `entry_summary.state_gap_is_expected=true` 时，底层 `blocked_reasons` 只用于排障，不应把无状态规划请求解释为 runtime failure。
+
+完成或判断能否交付时，先读取 `completion_evidence.task_completion_summary`，再按需下钻 readiness gates、evidence inventory 和 closeout detail。
+
+这些摘要只改变阅读顺序，不授予隐藏执行、自动写入、自动测试、subagent、平台 API、git、push、PR 或 merge 权限。
+
+## 首次会话验收
+
+P56 安装后首次会话验收只读取本地入口文本、session-start shape 或人工导出的 transcript，不连接平台 API、不执行 hook 之外的业务命令、不运行 workflow skill。验收通过应看到：按文件路径读取 `.vibecoding/skills/using-vibecoding/SKILL.md`、轻量分流、可见下一步、`injectsFullSkill=false`、`no_auto_execution`、`subagent=false`、`platform_api=false`、`git=false`。
+
+## Bootstrap 合同
+
+```bash
+node .vibecoding/hooks/session-start/session-start.mjs --format opencode
+```
+
+该 bootstrap 只输出项目已安装 Vibecoding、配置路径、轻量路由和边界说明；不会注入完整 skill、写 `.vibecoding-state/`、调用 runtime、subagent、MCP、daemon、平台 API、git 或 worktree。
+
+## Strict bootstrap acceptance
+
+`legacy-workflow-discipline` 可读取 `strictBootstrapAcceptance`：`bootstrap_marker` / `dedupe_marker` 用于识别一次会话中的 Vibecoding 入口，`cache_policy` 允许 adapter 在会话内缓存入口摘要，`session_compact_reinjects=true` 表示压缩后可以重新放回同一入口摘要，`tool_mapping` 只说明 OpenCode 工具等价关系。
+
+该合同保持 `injectsFullSkill=false`。它提供 skill-loading guidance 和去重证据，不自动执行 skill、不调用 subagent、不调用平台 API、不写 `.vibecoding-state/`、不写源码、不触碰 git。
+
+## Transcript export 示例
+
+Adapter 可以手动记录或导出本地 transcript JSON，供只读 intake 检查使用。该导出只包含文本 turn、本地 artifact ref、观察到的 marker 和边界字段；不连接 OpenCode 平台 API、不执行 skill、不调用 subagent/MCP/model、不运行命令、不触碰 git。
+
+最小形状：
+
+```json
+{
+  "platform": "opencode",
+  "source": {
+    "export_kind": "manual_local_transcript_json"
+  },
+  "turns": [
+    { "role": "assistant", "content": "using-vibecoding lightweight route selected" }
+  ],
+  "observed": {
+    "commands": [],
+    "markers": ["using-vibecoding", "validation_strategy_present"]
+  },
+  "artifact_refs": [],
+  "boundary_assertions": {
+    "platform_api": false,
+    "command_execution": false,
+    "skill_execution": false,
+    "subagent": false,
+    "git": false
+  },
+  "export_digest": "0000000000000000000000000000000000000000000000000000000000000000"
+}
+```
+
+完整示例主题由 `tools/vibe-runtime/runtime-platform-transcript-example-pack.mjs` 覆盖：session-start、workflow entry、SDD brief/report/review chain、review blocker、resume dedupe、completion evidence。保存到项目内本地 JSON 后，只能通过 `evals --transcript-intake --from-file <json> --json --root <project-root>` 读取验证；runtime 不会执行 transcript 中出现的命令文本。
+
+## Distribution maturity
+
+P62 `p62_adapter_plugin_maturity` 要求 OpenCode adapter 在分发检查中保持 marker 稳定：`adapter_packaging_consistency`、`install_experience_score`、`dry_run_auditable=true`、`adapter_marker_drift=false`、`platform_api=false`、`npm_publish=false`、`git_tag=false`、`github_release=false`、`marketplace_upload=false`。
+
+该成熟度只说明 plugin draft 可由 `vibe-plugin-pack --dry-run` 审计、可由 `--check` 回比 `adapters/opencode/`；不表示发布、上传、调用 OpenCode API、项目级安装或自动执行。
+
+## Runtime Bridge 边界
+
+`plugin.json` 声明 `runtimeBridge` capability：`mode` 固定为 `manual`，可读取只读 dispatch intent 或人工确认产生的 sidecar，但不能自动执行 skill、调用 subagent、调用平台 API 或触碰 git。
+
+OpenCode adapter-ready 只表示可以人工读取 intent 或 sidecar 后继续目标 workflow skill；不表示 OpenCode 自动调用平台 API、自动执行 skill、修改源码或写 git。

package/adapters/opencode/plugin.js

@@ -0,0 +1,56 @@
+export const VIBECODING_OPENCODE_PLUGIN_CONTRACT = Object.freeze({
+  name: 'vibecoding-kit',
+  skills: {
+    paths: ['.vibecoding/skills'],
+    entrySkill: 'using-vibecoding',
+  },
+  strictBootstrapAcceptance: {
+    profile: 'superpowers-parity',
+    bootstrap_marker: 'vibecoding:using-vibecoding bootstrap',
+    dedupe_marker: 'vibecoding:using-vibecoding bootstrap',
+    cache_policy: 'adapter-local bootstrap context may be cached for a session',
+    session_compact_reinjects: true,
+    injectsFullSkill: false,
+    tool_mapping: {
+      invokeSkill: 'OpenCode native skill loader',
+      taskList: 'OpenCode todo tool when available',
+      readFiles: 'OpenCode read tool',
+      editFiles: 'OpenCode patch/edit tool',
+      shell: 'OpenCode shell tool with explicit user-controlled commands',
+      subagent: 'manual only unless the user explicitly authorizes a bounded adapter action',
+    },
+  },
+  sessionStartBootstrap: {
+    command: 'node .vibecoding/hooks/session-start/session-start.mjs --format opencode',
+    contextShape: 'additional_context',
+    injectsFullSkill: false,
+    writesRuntimeState: false,
+    autoRunsNextSkill: false,
+  },
+  boundaries: {
+    hiddenExecution: false,
+    runtimeStateWrite: false,
+    platformApi: false,
+    modelInvocation: false,
+    gitWrite: false,
+    sourceWrite: false,
+  },
+});
+
+export default function vibecodingOpenCodePlugin() {
+  return {
+    name: VIBECODING_OPENCODE_PLUGIN_CONTRACT.name,
+    skills: VIBECODING_OPENCODE_PLUGIN_CONTRACT.skills,
+    transformMessage(message) {
+      return {
+        ...message,
+        vibecoding_context: {
+          summary: 'For development tasks, read .vibecoding/skills/using-vibecoding/SKILL.md by file path; missing native skill registration is not a missing entry.',
+          bootstrap_command: VIBECODING_OPENCODE_PLUGIN_CONTRACT.sessionStartBootstrap.command,
+          strict_bootstrap_acceptance: VIBECODING_OPENCODE_PLUGIN_CONTRACT.strictBootstrapAcceptance,
+          boundaries: VIBECODING_OPENCODE_PLUGIN_CONTRACT.boundaries,
+        },
+      };
+    },
+  };
+}

package/adapters/opencode/plugin.json

@@ -0,0 +1,58 @@
+{
+  "name": "vibe-coding-kit",
+  "displayName": "Vibecoding Kit",
+  "description": "Workflow skills and lightweight session bootstrap contract for OpenCode.",
+  "version": "0.1.0",
+  "author": {
+    "name": "vibe-coding-kit"
+  },
+  "license": "MIT",
+  "keywords": [
+    "vibecoding",
+    "skills",
+    "planning",
+    "debugging",
+    "verification",
+    "workflow"
+  ],
+  "skills": "../../skills/",
+  "installedSkills": ".vibecoding/skills/",
+  "layout": {
+    "repoSkills": "../../skills/",
+    "installedSkills": ".vibecoding/skills/",
+    "installedAdapter": ".vibecoding/adapters/opencode/",
+    "entryFile": "AGENTS.md"
+  },
+  "runtimeBridge": {
+    "supported": true,
+    "mode": "manual",
+    "canReadDispatchIntent": true,
+    "canAutoExecuteSkill": false,
+    "canCallSubagent": false,
+    "canTouchGit": false
+  },
+  "strictBootstrapAcceptance": {
+    "profile": "superpowers-parity",
+    "bootstrap_marker": "vibecoding:using-vibecoding bootstrap",
+    "dedupe_marker": "vibecoding:using-vibecoding bootstrap",
+    "cache_policy": "adapter-local bootstrap context may be cached for a session",
+    "session_compact_reinjects": true,
+    "injectsFullSkill": false,
+    "tool_mapping": [
+      "invokeSkill",
+      "taskList",
+      "readFiles",
+      "editFiles",
+      "shell",
+      "subagent"
+    ]
+  },
+  "sessionStartBootstrap": {
+    "supported": true,
+    "command": "node .vibecoding/hooks/session-start/session-start.mjs --format opencode",
+    "injectsFullSkill": false,
+    "writesRuntimeState": false,
+    "autoRunsNextSkill": false
+  },
+  "platformSample": "./plugin.js"
+}