plan-mvp

plan-mvp is a skill for Claude Code, Codex from weiyi88/cc-code. It costs 29 tokens per session (2,320 once invoked), scanned A, original, MIT.

A planning workflow for defining a complete minimum viable product from the beginning. It gathers decisions in planning mode and records the product, interface, project, data, and API documents for a later implementation workflow.

In plain words
What is it for?
Use it to map the product flow, sketch key screens, identify differences between the current project and the target, split work into stages, and produce approved build documents.
Why use it?
It prevents coding from starting with missing requirements or unresolved configuration choices. Asking one question at a time helps expose unclear behaviour before the plan is finalised.

Skill for Claude CodeCodex

Written for Claude Code and Codex: allowed-tools in frontmatter, but also agents/openai.yaml present. Also seen: names the ExitPlanMode tool; mentions Claude Code; mentions Codex.

Part of the cc-code plugin — 17 skills, 3 agents, 1 hook shipped together

Good fit Use it to map the product flow, sketch key screens, identify differences between the current project and the target, split work into stages, and produce approved build documents.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/weiyi88/cc-code/plan-mvp
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add weiyi88/cc-code --skill plan-mvp
Clone the repo
git clone --depth 1 https://github.com/weiyi88/cc-code

Made for: Claude Code, Codex.

Or install cc-code, the plugin that ships this one along with the rest of its 17 skills, 3 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for plan-mvp

README.md
[![agentmods](https://agentmods.dev/badge/skills/weiyi88/cc-code/plan-mvp/github.svg)](https://agentmods.dev/skills/weiyi88/cc-code/plan-mvp)
Your own site
<a href="https://agentmods.dev/skills/weiyi88/cc-code/plan-mvp"><img src="https://agentmods.dev/badge/skills/weiyi88/cc-code/plan-mvp/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for plan-mvp

Your own site · 80×15
<a href="https://agentmods.dev/skills/weiyi88/cc-code/plan-mvp"><img src="https://agentmods.dev/badge/skills/weiyi88/cc-code/plan-mvp.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,320 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00029 $0.02320
Opus 5.5 $0.00012 $0.00928
Sonnet 5.5 $0.00006 $0.00464
Haiku 4.5 $0.00003 $0.00232

Measured today against content hash 1d4a42bbae02, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

plan-mvp scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/plan-mvp/SKILL.md · 158 lines

How it starts

The opening of the file, as written. The whole thing — 158 lines — stays where its author put it; the contents beside it link to each section on GitHub.

/cc-code:plan-mvp — MVP 规划器(第一动作即 plan 模式)

⭐⭐⭐ 触发后第一动作 = call EnterPlanMode 工具。 ⚙️ 引擎分支(双端同一条规则):无 EnterPlanMode 工具的引擎(如 Codex)→ 第一动作改跑 Bash mkdir -p .cc_code/.runtime && touch .cc_code/.runtime/plan-lock 开护栏(此后写盘被 gate.sh 拦),出关经主人确认落盘清单后 rm .cc_code/.runtime/plan-lock。 所有探测 / 三件套 / 交谈都在 plan 模式内做,没有 plan 外窗口。 AI 从第一秒就在 plan only,Write/Edit 被锁死,无法逃避。 产出全部规划产物:prd / ux(PM 域)+ project / data / api(Architect 域)。 落盘即定稿:对话内的逐点交谈就是主人的确认,落盘后无二次验收;想改直接改对应文件或重跑本命令。

⛔ 三条铁律(违反即失败)

铁律 1:第一动作 call EnterPlanMode

触发后,在 call EnterPlanMode 之前,不许做任何动作:

  • ❌ 不许先 Read Agent.md / status.md
  • ❌ 不许先探测项目
  • ❌ 不许先输出三件套
  • ❌ 不许先输出"请主人审阅决策清单"
  • ✅ 唯一允许的第一动作:call EnterPlanMode 工具

进入 plan 模式后,再做 Read / 探测 / 输出三件套 / 交谈(plan 模式允许 Read/Glob/Grep 和文字输出)。

铁律 2:禁批量决策清单

⛔ 禁止「全量输出决策清单,可全量接受 / 逐项修订 / 否决某项」。 必须逐点提问:一次只问一个模糊点,等主人答,再问下一个。

铁律 3:逐点循环至通顺

plan 模式内一直逐点提问,直到项目距 MVP 的所有逻辑 + 配置完全通顺,才 call ExitPlanMode。


一、流程

触发 /cc-code:plan-mvp
     ↓
Step0 ⭐ call EnterPlanMode 工具(第一动作,不许先做别的)
     ↓ ──── 进入 plan 模式(只能 Read/Glob/Grep + 文字输出)────
Step1 Read Agent.md + status.md(同步角色与坐标)
Step2 探测项目(Read/Glob/Grep,守上下文最小化)
Step3 输出三件套(ascii 文字):
      ├─ 项目逻辑图(ascii:架构 + 业务生命周期 + 数据流)
      ├─ 前端原型图(ascii:关键页面 / 核心流程线框)
      └─ MVP 差异点表格(ascii 框线:模块/现状/目标/gap/风险)
      ⚠️ 三件套是探测输出,辅助交谈,不是 ux.md
Step4 逐点循环提问(一次一个模糊点,不批量):
      ├─ 列出当前一个逻辑/配置模糊点
      ├─ 主人答疑 → 更新认知
      └─ 检查:所有逻辑+配置通顺?
         ├─ 否 → 问下一个
         └─ 是 → Step5
     ↓ ──── 通顺后 ────
Step5 call ExitPlanMode → 主人 approve
     ↓ ──── 退出 plan 模式 ────
Step6 分批切角色落盘(⭐免请示:对话定稿即授权):
      ├─ PM 批:Write prd.md(旧版归档 backup/YYYY-MM/)+ ux.md
      │    └─ Edit Agent.md「当前激活角色」→ PM → 落盘 → 复位
      └─ Architect 批:Write project.md / data.md / api.md
           └─ 阶段拆分(phaseN)并入 project.md 对应章节(Dev 按此分阶段编码)
Step7 顺手更新 status.md 坐标 → 提示走 /cc-code:agent-mvp

二、为什么第一动作就进 plan(最硬设计)

旧设计有「阶段一 plan 外探测 + 三件套」,AI 在 plan 外就有机会输出决策清单逃避 EnterPlanMode。 新设计第一动作就进 plan,AI 没有 plan 外窗口,从第一秒就在 plan only,Write/Edit 被锁死,无法逃避。

Read the full file on GitHub · 158 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed 1d4a42bbae02
  2. 1mo ago Changed · +1 lines 8dbb41707fea
  3. 1mo ago Changed · -152 tokens per session 24eaa8ff3d70
  4. 1mo ago First seen · 157 lines · 181 tokens per session scan A 290c8b378ba6

Subscribe to this mod's changes

plan-mvp is a skill published in the GitHub repository weiyi88/cc-code (5 stars, last pushed yesterday), licensed MIT. It adds 29 tokens to every session and 2,320 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-13.