cc-devflow 4.5.0 → 4.5.1

package/CONTRIBUTING.zh-CN.md

@@ -0,0 +1,195 @@
+# 为 cc-devflow 做贡献
+
+[中文版](./CONTRIBUTING.zh-CN.md) | [English](./CONTRIBUTING.md)
+
+---
+
+请同时阅读 [行为准则](./CODE_OF_CONDUCT.zh-CN.md)。如果你要报告漏洞，请遵循 [安全策略](./SECURITY.zh-CN.md)，不要创建公开 issue。
+
+## 概览
+
+cc-devflow 现在是一个 skills-first 仓库，并且重新带回了可分发的 CLI。
+
+对外可见面只有这些：
+
+- `cc-roadmap`
+- `cc-plan`
+- `cc-investigate`
+- `cc-do`
+- `cc-check`
+- `cc-act`
+- `cc-devflow init`
+- `cc-devflow adapt`
+
+`lib/skill-runtime/` 可以保留共享运行时支撑，但它已经不是用户要直接理解或运行的工作流入口。
+
+仓库里也可以存在维护类 Skill，例如 `cc-spec-init`、`cc-simplify`、`docs-sync`，但它们不改变公开的 `cc-roadmap + PDCA/IDCA` 叙事。
+
+---
+
+## 开发环境
+
+### 前置条件
+
+- Node.js 18+
+- npm
+- Git
+
+### 安装
+
+```bash
+git clone https://github.com/YOUR_USERNAME/cc-devflow.git
+cd cc-devflow
+npm install
+```
+
+### 本地 CLI 冒烟验证
+
+如果你在源码仓库里开发，请使用仓库内入口：
+
+```bash
+node bin/cc-devflow-cli.js --help
+tmpdir=$(mktemp -d)
+node bin/cc-devflow-cli.js init --dir "$tmpdir"
+node bin/cc-devflow-cli.js adapt --cwd "$tmpdir" --platform codex
+rm -rf "$tmpdir"
+```
+
+如果要验证打包后的行为，运行：
+
+```bash
+npm pack
+node scripts/validate-publish.js
+```
+
+---
+
+## 项目结构
+
+```text
+cc-devflow/
+├── .claude/skills/            # 对外分发的 Skill
+├── bin/                       # CLI 入口
+├── config/                    # Adapter 配置
+├── docs/                      # 公开文档
+├── lib/adapters/              # 平台适配层
+├── lib/compiler/              # 多平台编译器
+├── lib/skill-runtime/         # 供 Skill 脚本复用的共享运行时与同目录测试
+├── README.md
+├── README.zh-CN.md
+└── package.json
+```
+
+### 常见贡献区域
+
+- `.claude/skills/`：Skill 行为、资源、引用、脚本
+- `bin/`：可分发 CLI 行为
+- `lib/compiler/`：skills/prompts 解析、转换、emitters、rules 生成
+- `lib/adapters/`：平台 adapter 配置与校验
+- `lib/skill-runtime/`：Skill 脚本复用的共享运行时支撑
+- `docs/`：对外文档
+
+---
+
+## 贡献规则
+
+### 1. 保持对外入口极简
+
+不要再把旧 `/flow:*` 或 `harness:*` CLI 写回新的用户文档。
+
+对外故事应该始终保持为：
+
+- 整包安装：`cc-devflow init`
+- 平台产物：`cc-devflow adapt`
+- 工作流执行：`cc-roadmap + PDCA/IDCA` 可见 Skill
+- capability 真相维护：`cc-spec-init`
+
+### 2. 保持 Skills-First 结构
+
+每个已发布 Skill 都应保持独立目录：
+
+```text
+.claude/skills/<skill>/
+├── SKILL.md
+├── PLAYBOOK.md
+├── assets/
+├── references/
+└── scripts/
+```
+
+如果你改了一个已发布 Skill，要把这些文件当成同一个契约：
+
+- `SKILL.md`
+- 本地 `CHANGELOG.md`
+- 被引用的 `PLAYBOOK.md`、`assets/`、`references/`、`scripts/`
+
+不要只改其中一部分，让其余说明继续过期。
+
+### 3. 保持分发包干净
+
+不要把瞬态文件放进模板或 tarball。
+
+典型脏文件包括：
+
+- `.claude/tsc-cache/`
+- `.DS_Store`
+- 本地编辑器和操作系统产生的垃圾文件
+
+### 4. 让运行时辅助层保持次要
+
+如果你改了 `lib/skill-runtime/`，请保持可测试，但不要再把它写成用户主入口。真正的公开 workflow 仍然属于已发布 Skill。
+
+---
+
+## 测试
+
+### 主测试命令
+
+```bash
+npm test
+```
+
+### CLI 回归测试
+
+```bash
+npm test -- --runInBand lib/skill-runtime/__tests__/cli-bootstrap.integration.test.js
+```
+
+### 发布校验
+
+```bash
+node scripts/validate-publish.js
+```
+
+它应该保证：
+
+- CLI 必需文件存在
+- 关键 Skill 存在
+- 打包 tarball 干净
+- 瞬态缓存不会被分发
+
+---
+
+## 文档规则
+
+- README 和快速开始默认写打包后 CLI 的用法
+- 贡献者文档才写 `node bin/cc-devflow-cli.js ...`
+- `skills.sh` 只作为单 Skill 分发路径来写
+- 不要把 `.claude/commands/` 写成必需结构
+- 不要把内部运行时辅助层写成受支持的公开工作流
+- 如果改了已发布 Skill，在同一个 PR 里同步该 Skill 的 `version`、本地 `CHANGELOG.md` 和受影响的公开文档
+- 主 workflow 仍然只讲 `cc-roadmap + PDCA/IDCA`；`cc-spec-init` / `cc-simplify` 等维护类 Skill 单独说明
+
+---
+
+## Pull Request
+
+这个仓库比较好的 PR，通常会干净地只做一类事：
+
+- 改进某个 Skill
+- 修复 CLI 分发行为
+- 修复编译器 / 适配行为
+- 清理陈旧文档
+- 增加有针对性的回归测试
+
+如果改动触碰了公开入口，记得在同一个 PR 里同步文档。

package/README.md

@@ -1,129 +1,111 @@
-# 🚀 cc-devflow
+# cc-devflow
 
-> Roadmap plus PDCA and IDCA skills for agent coding
+> Agent-first development workflow for roadmap, planning, investigation, implementation, verification, and shipping.
 
-CC-DevFlow is a stripped-down workflow for the agent coding era. It gives you one front-door planning skill, `cc-roadmap`, then lets each requirement enter one of two closed loops: the planning loop `cc-plan -> cc-do -> cc-check -> cc-act`, or the investigation loop `cc-investigate -> cc-do -> cc-check -> cc-act`.
+[![GitHub stars](https://img.shields.io/github/stars/Dimon94/cc-devflow?style=social)](https://github.com/Dimon94/cc-devflow/stargazers)
+[![npm version](https://img.shields.io/npm/v/cc-devflow.svg)](https://www.npmjs.com/package/cc-devflow)
+[![Node.js >=18](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](./package.json)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
 
-[中文文档](./README.zh-CN.md) | [English](./README.md)
+[中文文档](./README.zh-CN.md) | [English](./README.md) | [Getting Started](./docs/guides/getting-started.md) | [Contributing](./CONTRIBUTING.md) | [Security](./SECURITY.md)
 
----
-
-## 🎯 One-Line Introduction
-
-CC-DevFlow exposes six visible skills:
-
-- `cc-roadmap`: build the project's mid and long-range roadmap
-- `cc-plan`: clarify a roadmap item, design it, and turn it into tasks
-- `cc-investigate`: freeze symptom, reproduction, root cause, and repair tasks before fixing a bug
-- `cc-do`: implement, resume, repair from investigation, and apply review feedback
-- `cc-check`: verify with evidence
-- `cc-act`: ship, sync docs, and feed the result into the next cycle
-
-## ✨ Core Features
-
-- **Minimal visible surface**: one `cc-roadmap` skill plus two entry loops that share the same `cc-do -> cc-check -> cc-act` tail
-- **Multi-platform CLI restored**: `cc-devflow` is back as the distributable CLI for `.claude` installation plus multi-platform adaptation for Codex, Cursor, Qwen, and Antigravity
-- **skills.sh-compatible skill layout**: `.claude/skills/<skill>/SKILL.md` stays compatible with single-skill distribution on skills.sh
-- **Skill-local resources**: each skill carries its own templates, references, and scripts
-- **Explicit, not hidden**: no default context injection, read the files you actually need
-- **Task-template first**: keep `planning/tasks.md` and `task-manifest.json` as the execution backbone
-- **Skill pack first**: the repository distributes `.claude` skills, playbooks, and assets as one pack
-- **Evidence before done**: verification, doc sync, PR brief, and release note live at the end of the loop
-- **Roadmap-first**: decide medium-range direction once, then execute through PDCA or IDCA
-
-## 🧠 Mental Model
+CC-DevFlow is a small, explicit workflow system for agent coding. It gives an AI agent one roadmap entry point, then routes every change through either a feature loop or a bug-investigation loop before work can be called done.
 
 ```text
 cc-roadmap
 
-PDCA: cc-plan -> cc-do -> cc-check -> cc-act
+PDCA: cc-plan        -> cc-do -> cc-check -> cc-act
 IDCA: cc-investigate -> cc-do -> cc-check -> cc-act
 ```
 
-Use `cc-roadmap` to decide the next 1-3 stages of the product.
+## Why cc-devflow
 
-Use `cc-plan` when the next problem is scope, design, and task freezing.
+- **Small public surface**: six visible workflow skills plus a CLI for installation and platform adaptation.
+- **Evidence before done**: implementation must pass through verification proof before shipping or handoff.
+- **Skill-first distribution**: the public contract lives in `.claude/skills/<skill>/SKILL.md` and `PLAYBOOK.md`, not in hidden runtime behavior.
+- **Multi-platform output**: install once, then adapt for Codex, Cursor, Qwen, Antigravity, and related agent environments.
+- **Durable project memory**: roadmap, specs, planning, review, and handoff artifacts stay in `devflow/`; temporary worker scratch stays outside durable truth.
 
-Use `cc-investigate` when the next problem is root cause, reproduction, and repair boundary.
+## Quick Start
 
-Both loops converge into the same `cc-do -> cc-check -> cc-act` tail.
+Prerequisites:
 
-The visible state machine lives in the public skills themselves. The pack is intentionally skill-first: routing, reroutes, recovery, and evidence rules are described in `SKILL.md` and `PLAYBOOK.md`, while `lib/skill-runtime/` is limited to shared support code that those skills reuse.
+- Node.js 18+
+- npm or a compatible package runner
+- A Git repository
+- Claude Code or another supported agent environment
 
-## 🚀 Install
+Install the whole skill pack:
 
-The built-in CLI is back to the classic `init + adapt` model.
+```bash
+npx cc-devflow@latest init --dir /path/to/your/project
+```
 
-For the packaged CLI, the default entry stays simple:
+Generate platform outputs:
 
 ```bash
-npx cc-devflow init --dir /path/to/your/project
+npx cc-devflow@latest adapt --cwd /path/to/your/project --platform codex
+npx cc-devflow@latest adapt --cwd /path/to/your/project --platform cursor
+npx cc-devflow@latest adapt --cwd /path/to/your/project --platform qwen
+npx cc-devflow@latest adapt --cwd /path/to/your/project --platform antigravity
 ```
 
-After installation, the restored CLI supports both pack installation and multi-platform adaptation:
+Refresh every supported platform output:
 
 ```bash
-npx cc-devflow init --dir /path/to/your/project
-npx cc-devflow init --dir /path/to/your/project --force
-npx cc-devflow adapt --cwd /path/to/your/project --platform codex
-npx cc-devflow adapt --cwd /path/to/your/project --platform cursor
-npx cc-devflow adapt --cwd /path/to/your/project --platform qwen
-npx cc-devflow adapt --cwd /path/to/your/project --platform antigravity
+npx cc-devflow@latest adapt --cwd /path/to/your/project --all
 ```
 
-Whole-pack installation ships the six visible workflow skills plus the maintenance skills `cc-spec-init` and `cc-simplify`.
-`init --force` now force-upgrades only the managed distributed skills and preserves unrelated project files under `.claude`.
+After installation, ask your agent to use the workflow skills directly. Start with `cc-roadmap` for product direction, use `cc-plan` for new work, use `cc-investigate` for bugs, then continue through `cc-do`, `cc-check`, and `cc-act`.
 
-If you are running from a source checkout instead of an installed package, use `node bin/cc-devflow-cli.js ...` or `npm exec -- cc-devflow ...`.
+## Workflow Skills
 
-## ⚙️ Personal YAML Config
+| Skill | Use it when | Main output |
+| --- | --- | --- |
+| `cc-roadmap` | You need product direction, staged scope, or backlog order | `devflow/ROADMAP.md`, `devflow/BACKLOG.md` |
+| `cc-plan` | A feature or change needs scope, design, and task freezing | `planning/design.md`, `planning/tasks.md`, `task-manifest.json` |
+| `cc-investigate` | A bug needs symptom, reproduction, root cause, and repair boundary | `planning/analysis.md`, `planning/tasks.md`, `task-manifest.json` |
+| `cc-do` | Planned or investigated work needs implementation | code, tests, checkpoints, scratch runtime |
+| `cc-check` | Work needs fresh verification evidence | `report-card.json` |
+| `cc-act` | Verified work needs a PR, local handoff, release note, or closeout | one final handoff file |
 
-CC-DevFlow reads personal/project YAML config at runtime before durable workflow documents are written. Create one or more config files:
+Maintenance skills are shipped with the pack:
 
-```text
-~/.cc-devflow/config.yml
-<repo>/.cc-devflow/config.yml
-<repo>/.cc-devflow/config.local.yml
-```
+- `cc-spec-init`: initialize and maintain durable capability specs under `devflow/specs/`
+- `cc-simplify`: review changed code for reuse, quality, efficiency, and spec drift
 
-Precedence is deterministic: defaults < user < project < local < env < CLI. `output.document_language` is machine-enforced and currently supports only `en` and `zh-CN`. Non-standard user preferences belong under `agent_preferences`; they are advisory and never override workflow contracts.
+## Planning Quality Gates
 
-Example:
+`cc-roadmap` now records planning posture and evidence maturity before recommending a route. That keeps idea-stage, active-user, paying-customer, infrastructure, and recovery work from being forced through the same questions. Developer-facing or operator-facing roadmap items also carry target user, time to first value, magic moment, and adoption bottleneck into `cc-plan`.
 
-```yaml
-version: 1
-output:
-  document_language: zh-CN
-agent_preferences:
-  general:
-    - Start with the conclusion.
-  documentation:
-    - Keep headings short and avoid marketing language.
-```
+`cc-plan` freezes more implementation decisions before `cc-do` starts. Non-trivial plans compare minimal viable and ideal architecture options, full designs include decision horizon plus error/rescue mapping, and test-first plans record test framework evidence, coverage quality, and mandatory regression tests when existing behavior changes.
 
-Create or edit config with:
+## Installation Modes
 
-```bash
-npx cc-devflow config init --cwd /path/to/your/project --project
-npx cc-devflow config set output.document_language zh-CN --cwd /path/to/your/project --project
-npx cc-devflow config set output.document_language zh-CN --user
-```
+### Whole-pack install
 
-Inspect and diagnose the resolved policy with:
+Use this when you want the complete `.claude` skill pack:
 
 ```bash
-npx cc-devflow config resolve --cwd /path/to/your/project --format policy
-npx cc-devflow config get output.document_language --cwd /path/to/your/project
-npx cc-devflow config doctor --cwd /path/to/your/project
+npx cc-devflow@latest init --dir /path/to/your/project
+npx cc-devflow@latest init --dir /path/to/your/project --force
 ```
 
-See `config/user-config.template.yml` for the full sample.
+`--force` upgrades only cc-devflow-managed distributed skills and preserves unrelated project files under `.claude`.
 
-## 🧩 skills.sh Distribution
+### Source checkout
 
-[skills.sh](https://skills.sh/) is supported only as a distribution channel for the new `.claude` skills.
+When developing this repository locally:
 
-Because skills.sh installs skills one by one, use it to pull the specific skills you want:
+```bash
+node bin/cc-devflow-cli.js --help
+node bin/cc-devflow-cli.js init --dir /tmp/example-project
+node bin/cc-devflow-cli.js adapt --cwd /tmp/example-project --platform codex
+```
+
+### Single-skill install with skills.sh
+
+[skills.sh](https://skills.sh/) is supported as a single-skill distribution channel:
 
 ```bash
 npx skills add https://github.com/Dimon94/cc-devflow --skill cc-roadmap
@@ -132,50 +114,64 @@ npx skills add https://github.com/Dimon94/cc-devflow --skill cc-investigate
 npx skills add https://github.com/Dimon94/cc-devflow --skill cc-do
 npx skills add https://github.com/Dimon94/cc-devflow --skill cc-check
 npx skills add https://github.com/Dimon94/cc-devflow --skill cc-act
-npx skills add https://github.com/Dimon94/cc-devflow --skill cc-spec-init
-npx skills add https://github.com/Dimon94/cc-devflow --skill cc-simplify
 ```
 
-Use `cc-devflow init` when you want the whole `.claude` pack.
+Use `cc-devflow init` for the full pack, `cc-devflow adapt` for generated platform outputs, and `skills add` only when you want one skill at a time.
 
-Use `cc-devflow adapt` when you want generated multi-platform outputs.
+## Configuration
 
-Use skills.sh when you want to install or refresh a single skill.
+CC-DevFlow reads layered YAML config before durable workflow documents are written:
 
-## 🔁 Upgrade
+```text
+~/.cc-devflow/config.yml
+<repo>/.cc-devflow/config.yml
+<repo>/.cc-devflow/config.local.yml
+```
 
-Refresh the packaged `.claude` bundle with the latest CLI:
+Precedence is deterministic: defaults < user < project < local < environment < CLI. `output.document_language` is machine-enforced and currently supports `en` and `zh-CN`. Non-standard preferences belong under `agent_preferences`; they guide style but do not override workflow contracts.
 
-```bash
-npx cc-devflow@latest init --dir /path/to/your/project
-npx cc-devflow@latest adapt --cwd /path/to/your/project --all
+```yaml
+version: 1
+output:
+  document_language: en
+agent_preferences:
+  general:
+    - Start with the conclusion.
+  documentation:
+    - Keep headings short and avoid marketing language.
 ```
 
-Upgrade installed skills with the skills CLI lifecycle commands:
+Useful commands:
 
 ```bash
-npx skills check
-npx skills update
+npx cc-devflow config init --cwd /path/to/your/project --project
+npx cc-devflow config set output.document_language zh-CN --cwd /path/to/your/project --project
+npx cc-devflow config resolve --cwd /path/to/your/project --format policy
+npx cc-devflow config doctor --cwd /path/to/your/project
 ```
 
-If you only want to refresh one skill immediately, re-run its `npx skills add ... --skill ...` command.
+See [`config/user-config.template.yml`](./config/user-config.template.yml) for the full sample.
 
-## 🧱 Repository Format
+## Repository Format
 
-CC-DevFlow keeps the `.claude` skill folders compatible with skills.sh single-skill distribution:
+Distributed skills live in `.claude/skills/`:
 
-- one skill per folder
-- one `SKILL.md` per distributed skill
-- YAML frontmatter at the top of each `SKILL.md`
-- public skills declare structured runtime contract fields in frontmatter: `triggers`, `reads`, structured `writes`, `effects`, `entry_gate`, `exit_criteria`, `reroutes`, `recovery_modes`, `tool_budget`
-- bundled local resources beside the skill, such as `PLAYBOOK.md`, `assets/`, `scripts/`, and `references/`
+```text
+.claude/skills/<skill>/
+├── SKILL.md
+├── PLAYBOOK.md
+├── assets/
+├── references/
+└── scripts/
+```
 
-Public skills also carry two explicit text contracts:
+Each shipped skill keeps its runtime contract local:
 
-- `SKILL.md` includes a `Harness Contract` section
-- `PLAYBOOK.md` includes a `Visible State Machine` section
+- `SKILL.md` has YAML frontmatter plus the `Harness Contract`
+- `PLAYBOOK.md` has the `Visible State Machine`
+- local resources stay beside the skill that owns them
 
-In this repository, the distributed skill folders are:
+The currently distributed skill folders are:
 
 - `.claude/skills/cc-roadmap/`
 - `.claude/skills/cc-plan/`
@@ -186,58 +182,53 @@ In this repository, the distributed skill folders are:
 - `.claude/skills/cc-spec-init/`
 - `.claude/skills/cc-simplify/`
 
-## 🛠️ Use
-
-The skill sequence remains:
+## Durable vs Ephemeral
 
-```text
-1. cc-roadmap
-2. choose cc-plan or cc-investigate
-3. cc-do
-4. cc-check
-5. cc-act
-6. repeat
-```
+- `devflow/specs/` stores durable capability truth: `INDEX.md` plus `capabilities/*.md`.
+- New change directories use `REQ-<number>-<description>` for requirements or `FIX-<number>-<description>` for bug fixes.
+- `devflow/changes/<change>/` stores durable change truth: `change-state.json`, `change-meta.json`, planning docs, `task-manifest.json`, `team-state.json`, task `checkpoint.json`, `report-card.json`, and one final handoff file.
+- `devflow/workspaces/<change>/` stores ephemeral runtime scratch such as worker assignment, journals, prompts, and session logs.
+- Regenerable files should not be persisted under `devflow/changes/`.
 
-You do not need to remember command names.
+For complete artifact examples, start with [`docs/examples/START-HERE.md`](./docs/examples/START-HERE.md). Example version bindings live in [`docs/examples/example-bindings.json`](./docs/examples/example-bindings.json).
 
-The `cc-devflow` CLI remains the whole-pack installation and adaptation path.
+## Development
 
-skills.sh remains the single-skill distribution path for distributed `.claude/skills/*`.
+```bash
+git clone https://github.com/Dimon94/cc-devflow.git
+cd cc-devflow
+npm install
+npm test
+npm run verify
+```
 
-## 📦 Outputs
+Publish validation:
 
-- `cc-roadmap` writes `devflow/ROADMAP.md` and `devflow/BACKLOG.md`; helper sync can also maintain `devflow/roadmap-tracking.json` as the shared roadmap/backlog truth source
-- `cc-spec-init` writes `devflow/specs/INDEX.md`, capability specs, and `change-meta.json`
-- `cc-plan` writes `planning/design.md`, `planning/tasks.md`, `task-manifest.json`, and `change-meta.json`
-- `cc-investigate` writes `planning/analysis.md`, `planning/tasks.md`, `task-manifest.json`, and `change-meta.json`
-- `cc-do` writes code, tests, task `checkpoint.json`, and workspace scratch runtime
-- `cc-check` writes `report-card.json`
-- `cc-act` writes exactly one final handoff file: `handoff/pr-brief.md`, `handoff/resume-index.md`, or `handoff/release-note.md`
+```bash
+npm run verify:publish
+```
 
-## Durable vs Ephemeral
+The main contributor guide is [`CONTRIBUTING.md`](./CONTRIBUTING.md). It explains the public surface rules, local CLI smoke tests, documentation rules, and PR expectations.
 
-- `devflow/specs/` stores durable capability truth: `INDEX.md` plus `capabilities/*.md`.
-- New change directories must be named `REQ-<number>-<description>` for requirements or `FIX-<number>-<description>` for bug fixes; old lowercase directories are compatibility reads only.
-- `devflow/changes/<change>/` stores durable change truth only: `change-state.json`, `change-meta.json`, planning docs, `task-manifest.json`, `team-state.json`, task `checkpoint.json`, `report-card.json`, and one final handoff file.
-- `devflow/workspaces/<change>/` stores ephemeral runtime scratch such as worker assignment, journals, prompts, and session logs.
-- If a file can be regenerated from durable truth, it should not be persisted under `devflow/changes/`.
+## Community
 
-See [docs/examples/START-HERE.md](./docs/examples/START-HERE.md) for the single entry page to the example set. Example version bindings live in [docs/examples/example-bindings.json](./docs/examples/example-bindings.json).
+- Star the project if the workflow is useful: [GitHub stars](https://github.com/Dimon94/cc-devflow/stargazers)
+- Open issues for reproducible bugs, stale docs, or missing platform adapters.
+- Keep PRs focused: one skill, one CLI behavior, one compiler/adaptation fix, or one documentation cleanup.
+- If a shipped skill changes, update its `version`, local `CHANGELOG.md`, examples, and affected public docs in the same PR.
+- Read the [Code of Conduct](./CODE_OF_CONDUCT.md) before participating in project discussions.
+- Report vulnerabilities through the [Security Policy](./SECURITY.md), not public issues.
 
-## Principles
+## Star History
 
-- Roadmap before execution
-- Plan before feature code
-- Investigate before bug repair
-- Root cause before fix
-- Evidence before done
-- Ship, then feed the result into the next plan
+<a href="https://www.star-history.com/#Dimon94/cc-devflow&Date">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Dimon94/cc-devflow&type=Date&theme=dark" />
+    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Dimon94/cc-devflow&type=Date" />
+    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Dimon94/cc-devflow&type=Date" />
+  </picture>
+</a>
 
-## Verification
+## License
 
-```bash
-find .claude/skills -mindepth 2 -maxdepth 2 -name SKILL.md | sort
-find .claude/skills -mindepth 2 -maxdepth 3 -type f | sort
-npm run verify
-```
+[MIT](./LICENSE)