@cyning/harness 0.3.0

package/AGENTS.md

@@ -0,0 +1,20 @@
+# cyning-harness · Agent 入口
+
+> **范围**：本仓库 **仅** 维护 Harness 产品包模板与文档；**不含** 业务代码与 LLM Runtime。
+
+## 阅读顺序
+
+1. [`README.md`](README.md)
+2. [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)
+3. [`docs/ONBOARDING.md`](docs/ONBOARDING.md)
+4. 按任务进入 `harness/templates/` 或 `wizard/`
+
+## 修改纪律
+
+- 模板与 POINTER：**本仓真值**
+- 嵌入用户业务仓时：**复制生成**，勿假设本仓路径与用户仓一致
+- 版本发布：更新 `CHANGELOG.md` 与 git tag（`v0.x.y`）
+
+## 关键词
+
+`cyning-harness`、`graph`、`coding_wiki`、`standards`、`harness`、`invoke`、`wizard`

package/CHANGELOG.md

@@ -0,0 +1,127 @@
+# Changelog
+
+本仓库遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [Unreleased]
+
+## [0.3.0] - 2026-06-15
+
+### Added
+
+- **`@cyning/harness` npm CLI**：`init` · `upgrade` · `check`（薄封装 · 内部复用 `wizard/*.sh`）
+- **`.cyning-harness/manifest.json`**：install/upgrade 写入 · schema [`schema/manifest.v1.schema.json`](schema/manifest.v1.schema.json)
+- **S5 git-clean**：`harness-sync.sh apply` 前检测已跟踪文件变更 · `--force` / `HARNESS_SYNC_FORCE=1` 跳过
+- **集成测试**：`npm test`（空目录 init · upgrade 等价 upgrade.sh · S5）
+
+### Changed
+
+- `docs/ONBOARDING.md` · `README.md` · `wizard/README.md`：**npx 优先**，clone 路径为维护者/离线
+- `wizard/install.sh` · `wizard/upgrade.sh`：写入/更新 manifest · 支持 `HARNESS_VERSION`
+
+## [0.2.1] - 2026-06-13
+
+### Added
+
+- **done 分层索引模板**：`TASK_done_README.md` · `VIEW_done_by_domain.md` · `VIEW_done_thin_pointer.md` · `FRAGMENT_task_domain_infer_v1_zh.md`
+- **`install.sh`**：创建 `done/<domain>/` 子目录 · 首次嵌入 Hub 与 `_views` 薄指针（文件不存在时）
+
+### Changed
+
+- `harness/templates/README.md`：关账纪律与嵌入步骤
+- `docs/ONBOARDING.md` §6：task 关账与 done 分层索引
+
+## [0.2.0] - 2026-06-11
+
+### Added
+
+- **D3 IDE 适配**：`ide/adapters/CLAUDE.md.fragment.example` · `AGENTS.md.fragment.example`（单源 POINTER）
+- **`install.sh --ide`**：逗号列表 `cursor,claude,agents` → 写入 profile `tracks.ide_*`
+- **`harness-sync.sh` marker merge**：`<!-- cyning-harness:begin/end -->` 合并至仓根 `CLAUDE.md` / `AGENTS.md`
+
+### Changed
+
+- `wizard/profiles/harness-only.json` · `fullstack-node-py.json`：增 `ide_claude` / `ide_agents`（默认 `false`）
+- `ide/adapters/README.md` · `wizard/ONBOARDING_wizard_v1_zh.md` §3 · `docs/ONBOARDING.md`：v0.2 可执行勾选
+- `wizard/README.md`：§1 增 `--ide` 示例
+- `README.md` 当前版本 → **v0.2.0**
+
+### Notes
+
+- **backward-compat**：profile 无 `ide_claude`/`ide_agents` 时等同 v0.1.3（仅 `ide_cursor`）
+- **freeze_id**：`freeze_cyning_harness_v0_2_d3`（tag 由 CLOSE 棒独立打）
+
+## [0.1.3] - 2026-06-11
+
+### Added
+
+- **上游 PR task 模板**：`wizard/templates/TASK_TEMPLATE_upstream_pr_v1.md` — Harness 元信息 · 思考轮 §4 · 图谱闸 · 验收清单
+- **思考回填 FRAGMENT**：`wizard/templates/FRAGMENT_rethink_backfill_task_v1_zh.md` — Agent 须写回 task §4 + **思考轮控制**；22 可退回 10 补思考
+- **10/22 帽**：阶段 C task 预置 **R0+R1–R5** 五槽；可提前停/增轮须留 reason 与 residual_risks
+- **扫描 preset**：`kimi-c3-candidate`（排除 #565/#566/#583 · 无 open PR）
+
+### Changed
+
+- `wizard/bootstrap-oss-fork-meta.sh`：初始化时复制 task 模板 + FRAGMENT 至 `docs/tasks/` · `docs/harness/`
+- `examples/oss-fork/README.md`：§6 阶段 C3 工作流（思考回填 · 图谱闸 · PR 暂缓策略）
+- `wizard/README.md` · `docs/ONBOARDING.md`：v0.1.3 · `kimi-c3-candidate` 交叉引用
+- `wizard/scan-upstream-issues.sh`：`--format text` 作为 `table` 别名（修复 CLI 报错）
+
+### Notes
+
+- **试点证据**：MoonshotAI/kimi-code · C1 #622 merged · C2 #583 · C3 #580 local_done（PR 暂缓至 2026-06-13）
+- **不含**：D3 `CLAUDE.md` / `AGENTS.md.fragment`（规划 v0.2）
+
+## [0.1.2] - 2026-06-10
+
+### Added
+
+- **OSS fork 选题**：`wizard/scan-upstream-issues.sh` — `gh` + `jq` 扫描上游 issue、可选 PR 占坑检查、`table` / `markdown` / `json` 输出
+- **扫描预设**：`wizard/profiles/issue-scan-presets.json`（`kimi-open-bug` · `kimi-c2-candidate` · `kimi-open-all` · `kimi-open-enhancement`；可自定义 `--repo`）
+- **OSS fork 一键初始化**（v0.1.1 起累积、本版文档收口）：`wizard/bootstrap-oss-fork-meta.sh` · preset `oss-fork-meta` · 可选 `--stub-dir`
+- **examples/oss-fork/**：kimi-code 图谱快照指针；**双 worktree** 拓扑与 issue 扫描说明
+
+### Changed
+
+- `wizard/README.md`：§4 上游 Issue 扫描 · OSS fork 工作流交叉引用
+- `wizard/bootstrap-oss-fork-meta.sh`：完成提示含 worktree / `scan-upstream-issues` · 默认 `docs/tasks/done/`
+- `examples/oss-fork/README.md`：过程轨 vs 产品 PR 纪律（v0.1.2）
+
+### Notes
+
+- **不含**：D3 `CLAUDE.md` / `AGENTS.md.fragment`（规划 v0.2）· Starter 仍 10/22/30
+- **试点证据**：MoonshotAI/kimi-code fork · C1 PR #622 · 工作区 `ISSUE_SCAN_kimi_code_open_c2_v1_zh.md`
+
+## [0.1.1] - 2026-06-09
+
+### Added
+
+- **人工闸 P0**（ios_buy 事故跟进）：`HG-AUDIT-R1` 写入 Cursor 规则 · `30` 拒开工 STOP 模板 · `22` pending 时不附 30 Prompt
+- **wizard 脚本**：`install.sh` · `harness-sync.sh`（plan/apply）· `gate-check.sh` · `profiles/*.json`
+
+### Changed
+
+- `harness/prompts/30-execute-code.md`：输入改为「22 通过 **且** AUDIT approved」；强制首输出闸扫描
+- `ide/adapters/cursor-harness-starter.mdc.example`：并列 `HG-AUDIT-R1` 与 `HG-GRAPH-MODULES`
+
+## [0.1.0] - 2026-06-09
+
+**freeze_id**: `freeze_cyning_harness_v0_1`
+
+### Added
+
+- **T1 图谱轨** `graph/templates/`：`00_main` 双轨、`01_struct` 模块表、`99_mermaid_protocol`、`10_flow_MAIN` 示例
+- **T2 规范轨** `standards/`：L1/L2 TEMPLATE、`SOURCES`、`POINTER_workspace_truth`（不复制 Ink 全文）
+- **T3 过程轨** `harness/templates/` · `prompts/` · `invokes/TEMPLATE_invoke`；`TASK_graph_bootstrap` 含 **HG-GRAPH-MODULES**
+- **T4 Verify 轨** `ci/samples/`：`quality.yml.example`、`pytest.yml.example`
+- **T5 IDE + wizard**：`cursor-harness-starter.mdc.example` · `wizard/ONBOARDING_wizard_v1_zh.md`
+- **T6 golden**：`POINTER_gold_epic_serial.md` 链 M1 Epic（只读 POINTER）
+
+### Changed
+
+- 各轨 README 清单更新为 v0.1 已交付
+
+## [0.0.1] - 2026-06-09
+
+### Added
+
+- 初始架构与 README（无业务代码、无内置 LLM）

package/README.md

@@ -0,0 +1,133 @@
+# cyning-harness
+
+可 clone、可嵌入业务仓库的 **Harness 纪律包**（无业务代码，无内置 LLM）。
+
+> **设计哲学**：用 **本体论** 定义「Track / Hat / Gate / Artifact」与 **ICVO 四支柱**（Inform · Constrain · Verify · Orchestrate），把 AI Coding 的上下文、规则与验收变成 **可同步、可审计、不覆盖用户 task** 的仓库真值。  
+> **公众连载** 使用 **ICV 三支柱**（SDD 层）；**Orchestrate** 是对卷三过程编排的 **产品化命名**，见 [`docs/methodology/product/README.md`](docs/methodology/product/README.md) · [`docs/methodology/AUDIT_doc_consistency_2026-06-15_zh.md`](docs/methodology/AUDIT_doc_consistency_2026-06-15_zh.md)。  
+> **方法论总指引**：[`docs/methodology/README.md`](docs/methodology/README.md) · 本体 [`docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md`](docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md)
+
+---
+
+## 是什么
+
+**cyning-harness** 提供在任意软件项目中落地 AI 辅助研发纪律所需的 **模板、读序与过程约定**：
+
+| 轨 | 目录 | 作用 |
+|----|------|------|
+| 图谱 | `graph/` | 架构地图模板（`docs/_tech_graph` 嵌入用） |
+| Wiki | `coding_wiki/` | LLM 读序（stable / context / volatile） |
+| 规范 | `standards/` | L1/L2 编码规范模板 |
+| 过程 | `harness/` | task、prompts、invoke 约定 |
+| 验证 | `ci/` | CI 门禁样例 |
+| IDE | `ide/` | Cursor / Claude Code / AGENTS 入口片段 |
+| 向导 | `wizard/` | 安装与勾选式初始化 |
+
+**不提供：** 业务实现代码、LLM API、Agent 编排 SDK（与 LangChain 等互补 · 见本体 §7.5）。
+
+**边界（S2）：** sync **不覆盖** `docs/tasks/`、`reviews/`、`invokes/by-task/` — 纪律层与业务数据分离。
+
+---
+
+## Quick Start（npx · v0.3+）
+
+```bash
+# 新业务仓根
+npx @cyning/harness@latest init --preset harness-only --ide cursor,agents
+
+# 日常升级
+npx @cyning/harness upgrade
+npx @cyning/harness check
+```
+
+**维护者 / 离线（clone 路径）：**
+
+```bash
+git clone git@github.com:Cyning12/cyning-harness.git && cd cyning-harness
+/path/to/cyning-harness/wizard/install.sh --target /path/to/your-repo --preset harness-only --ide cursor,agents
+/path/to/cyning-harness/wizard/harness-sync.sh apply --target /path/to/your-repo
+```
+
+**P0 金样（10→22→30）：** [`examples/demo_checkout/README.md`](examples/demo_checkout/README.md) · [`docs/methodology/execution/P0_V0.2_GAP.md`](docs/methodology/execution/P0_V0.2_GAP.md)
+
+**Kimi Code fork：** `--preset oss-fork-meta` 或 [`wizard/bootstrap-oss-fork-meta.sh`](wizard/bootstrap-oss-fork-meta.sh) · 过程轨不进上游 PR。
+
+---
+
+## 典型工作流
+
+```text
+install / adopt  →  harness-sync plan/apply  →  @ task + prompts（10→22→30）
+                      ↑ 产品包 git pull 后 upgrade.sh
+30 前：gate-check.sh  ·  HG-AUDIT-R1 = approved
+```
+
+1. 阅读 [`docs/ONBOARDING.md`](docs/ONBOARDING.md)  
+2. [`wizard/install.sh`](wizard/install.sh) 或 [`adopt-existing.sh`](wizard/adopt-existing.sh)  
+3. 产品包更新：[`wizard/upgrade.sh`](wizard/upgrade.sh) 或 [`harness-sync.sh`](wizard/harness-sync.sh) `apply`  
+4. IDE `@` task + `docs/harness/prompts/`；30 前 [`gate-check.sh`](wizard/gate-check.sh)  
+
+---
+
+## 与通用 Agent 框架的差异（摘要）
+
+| 维度 | cyning-harness | LangChain / Semantic Kernel 等 |
+| --- | --- | --- |
+| 定位 | **纪律包** · SDD 过程审计 | Agent 编排 / 工具链 SDK |
+| 过程落盘 | AuditReview · InvokeSnapshot · HumanGate | 通常无一等过程制品 |
+| 同步边界 | S2 · 不覆盖用户 Task | 不适用 |
+
+完整对比：[`DESIGN_ONTOLOGY` §7.5](docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md)。
+
+---
+
+## 仓库结构
+
+```text
+cyning-harness/
+├── README.md
+├── docs/
+│   ├── README.md                  # 文档索引
+│   ├── methodology/               # ★ 方法论总指引
+│   │   ├── README.md
+│   │   ├── DOCUMENT_MAP_v1_zh.md
+│   │   ├── product/               # 产品设计本体
+│   │   ├── graph/                 # HGM
+│   │   ├── execution/             # P0 差距
+│   │   └── pointers/              # 工作区 / 治理 POINTER
+│   ├── ARCHITECTURE.md
+│   └── ONBOARDING.md
+├── examples/demo_checkout/
+├── wizard/ · harness/ · graph/ …
+└── golden/
+```
+
+---
+
+## 版本与状态
+
+| 项 | 值 |
+|----|-----|
+| 当前 | **v0.2.1** — P0 金样 · 方法论归集 · 本体 v1.2 |
+| 下一档 | **v0.3** — npx CLI · manifest · S5 git-clean |
+| 许可 | 私有；战略见 [`methodology/pointers/STRATEGY_ONTOLOGY_v1_zh.md`](docs/methodology/pointers/STRATEGY_ONTOLOGY_v1_zh.md) |
+
+---
+
+## 文档索引
+
+| 优先级 | 文档 |
+| --- | --- |
+| **总指引** | [`methodology/README.md`](docs/methodology/README.md) · [关系图](docs/methodology/DOCUMENT_MAP_v1_zh.md) · [路线 ROADMAP](docs/methodology/ROADMAP_v1_zh.md) |
+| **本体** | [DESIGN_ONTOLOGY v1.2](docs/methodology/product/DESIGN_ONTOLOGY_v1_zh.md) |
+| **落地** | [P0 差距](docs/methodology/execution/P0_V0.2_GAP.md) · [金样验收](examples/demo_checkout/ACCEPTANCE.md) |
+| **远期** | [HGM 草案](docs/methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md) |
+| **接入** | [ONBOARDING](docs/ONBOARDING.md) · [ARCHITECTURE](docs/ARCHITECTURE.md) |
+
+根目录 `docs/DESIGN_ONTOLOGY_v1_zh.md` 等为 **POINTER** · 兼容旧链接。
+
+---
+
+## 变更与 Agent
+
+- [CHANGELOG.md](CHANGELOG.md)
+- [AGENTS.md](AGENTS.md)

package/bin/harness.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { runCli } from '../lib/cli.js';
+
+runCli(process.argv.slice(2)).catch((err) => {
+  console.error(err.message || err);
+  process.exit(typeof err.exitCode === 'number' ? err.exitCode : 1);
+});

package/ci/samples/README.md

@@ -0,0 +1,42 @@
+# ci/samples · Verify 轨
+
+复制并改写为用户仓 **`.github/workflows/`** workflow。
+
+## v0.1 已交付（T4 · M2）
+
+| 样例 | 状态 | 适用栈 | 三门禁 |
+|------|------|--------|--------|
+| [`quality.yml.example`](./quality.yml.example) | ✅ | Node/TS · Next 等 | install → lint → test → build |
+| [`pytest.yml.example`](./pytest.yml.example) | ✅ | Python · FastAPI 等 | install → pytest |
+
+## 嵌入步骤
+
+```bash
+mkdir -p .github/workflows
+cp cyning-harness/ci/samples/quality.yml.example .github/workflows/quality.yml
+# 或
+cp cyning-harness/ci/samples/pytest.yml.example .github/workflows/pytest.yml
+```
+
+按 `package.json` / `requirements.txt` / Node 版本 / env 变量 **裁剪注释块**。
+
+## 金样 POINTER（Ink · 只读对照）
+
+| 栈 | 路径（工作区） |
+|----|----------------|
+| 前端 | `ai-ink-brain/.github/workflows/quality.yml` |
+| 后端 | `ai-ink-brain-api-python/.github/workflows/pytest.yml` |
+
+Ink workflow 含图谱 export、跨仓 checkout 等 **业务专有** 步骤；Starter 样例为 **最小三门禁**，按需从金样增量合并。
+
+## 与 Harness 关系
+
+- task `test_strategy: required` → 本地/CI 须与 workflow 命令一致
+- L2 模板 CI 对齐节：[`standards/TEMPLATE_CODING_BASELINE_L2_*.md`](../standards/)
+- ONBOARDING §5：五轨检查清单含 CI 样例已适配
+
+## 修订记录
+
+| 日期 | 说明 |
+|------|------|
+| 2026-06-09 | T4 M2 首版样例 |

package/ci/samples/pytest.yml.example

@@ -0,0 +1,49 @@
+# Harness Verify · 后端 pytest 样例（Python · FastAPI 等）
+#
+# 用途：复制为 .github/workflows/pytest.yml 并按仓裁剪。
+# 金样 POINTER（Ink）：Cyning12/ai-ink-brain-api-python · .github/workflows/pytest.yml
+# 本地路径（工作区对照）：ai-ink-brain-api-python/.github/workflows/pytest.yml
+#
+# 合并前必绿：pytest tests -m "not intent_eval and not intent_benchmark"（按仓调整 marker）
+
+name: pytest
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+      # - production   # 按需启用
+
+jobs:
+  pytest:
+    runs-on: ubuntu-latest
+    timeout-minutes: 25
+    env:
+      # CI dummy 环境变量 — 替换为你的 .env.example 文档化变量名
+      # 禁止在 workflow 中写入真实密钥
+      EXAMPLE_API_KEY: "dummy-ci-key"
+      DATABASE_URL: "postgresql://u:p@localhost:5432/test"
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"      # 改为你的版本
+          cache: "pip"
+          cache-dependency-path: requirements.txt
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: Run pytest
+        run: pytest tests -q --tb=short
+        # 有 slow/intent marker 时示例：
+        # run: pytest tests -m "not intent_eval and not intent_benchmark" -q --tb=short
+
+      # --- 可选：Ruff / mypy（L2 落地后启用）---
+      # - name: Ruff
+      #   run: ruff check .

package/ci/samples/quality.yml.example

@@ -0,0 +1,56 @@
+# Harness Verify · 前端 quality 样例（Node/TS · Next 等）
+#
+# 用途：复制为 .github/workflows/quality.yml 并按仓裁剪。
+# 金样 POINTER（Ink）：Cyning12/ai-ink-brain · .github/workflows/quality.yml
+# 本地路径（工作区对照）：ai-ink-brain/.github/workflows/quality.yml
+#
+# 合并前三门禁：pnpm install --frozen-lockfile → pnpm lint → pnpm test → pnpm build
+# npm/yarn 用户：替换 install/lint/test/build 命令与 cache 配置。
+
+name: quality
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+      # - production   # 按需启用
+
+jobs:
+  lint-and-build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      # 版本以 package.json 的 packageManager 为真源（pnpm）
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v5
+
+      - name: Setup Node
+        uses: actions/setup-node@v5
+        with:
+          node-version: "24"          # 改为你的 LTS
+          cache: "pnpm"
+          cache-dependency-path: pnpm-lock.yaml
+
+      - name: Install
+        run: pnpm install --frozen-lockfile
+
+      # --- 可选：图谱 / 契约检查（有 docs/_tech_graph/ 时启用）---
+      # - name: Setup Python
+      #   uses: actions/setup-python@v5
+      #   with:
+      #     python-version: "3.11"
+      # - name: Tech graph check
+      #   run: python3 tools/tech_graph_check.py --input docs/_tech_graph
+
+      - name: Lint
+        run: pnpm lint
+
+      - name: Test
+        run: pnpm test
+
+      - name: Build
+        run: pnpm build

package/coding_wiki/templates/README.md

@@ -0,0 +1,11 @@
+# coding_wiki · LLM 读序
+
+复制本目录文件到用户仓 **`docs/coding_wiki/`**。
+
+| 文件 | 层 | 说明 |
+|------|-----|------|
+| [`stable.md`](stable.md) | stable | 短摘要 · 规范十二条 · IDE 规则指针 |
+| [`context.md`](context.md) | context | L2、PROJECT_CONFIG 类指针 |
+| [`volatile.md`](volatile.md) | volatile | 本 task 必读（由 task 引用） |
+
+invoke §3 应 **pointer** 到本目录，勿重复贴长文。

package/coding_wiki/templates/context.md

@@ -0,0 +1,11 @@
+# coding_wiki · context
+
+> **层**：context · 项目级指针（变更频率低于 volatile）
+
+## 待填写
+
+- `docs/standards/CODING_*_L2_*.md`  
+- `docs/meta/PROJECT_CONFIG_*.md`（若有）  
+- `docs/_tech_graph/00_main.md` 读序  
+
+由安装向导或人工在接入业务仓时补全链接。

package/coding_wiki/templates/stable.md

@@ -0,0 +1,19 @@
+# coding_wiki · stable
+
+> **层**：stable · 每次会话可注入的短摘要（≤15 行正文建议）
+
+## 编码底线（L1 摘要占位）
+
+1. 最小改动 · 不扩 scope  
+2. 类型严格 · 禁 `any`（TS）  
+3. 错误结构化返回  
+4. 测试策略见 task `test_strategy`  
+5. 图谱优先于纯文本臆造  
+
+完整 L1：用户仓 `docs/standards/CODING_BASELINE_L1_*.md`（由 `standards/` 模板生成）。
+
+## IDE 入口
+
+- Cursor：`.cursor/rules/*`  
+- Claude Code：`CLAUDE.md`  
+- 通用：`AGENTS.md`

package/coding_wiki/templates/volatile.md

@@ -0,0 +1,15 @@
+# coding_wiki · volatile
+
+> **层**：volatile · **本 task 专属**；由 task「给执行帽必读」或 invoke §3 引用
+
+## 用法
+
+1. 每个 active task 在正文或 invoke 中 pointer 到本文件或 task 内小节  
+2. Epic 子 task 可共用 Epic 级 volatile 片段  
+3. 关账后归档或清空，避免 stale 上下文  
+
+## 本 task（占位）
+
+- task_slug：`<填写>`  
+- 必读图谱：`docs/_tech_graph/<flow>.md`  
+- `code_quality_bar`：`<strict | recommended | not_applicable>`  

package/docs/ARCHITECTURE.md

@@ -0,0 +1,71 @@
+# 架构说明
+
+## 1. 产品定位
+
+**cyning-harness** 是可分发的 **Harness 嵌入包**：
+
+- **输入**：开发者 clone 本仓，经 `wizard/` 选型
+- **输出**：在用户业务仓中生成或复制 `docs/_tech_graph`、`docs/coding_wiki`、`docs/standards`、`docs/tasks`、`docs/harness` 等约定目录
+- **执行壳**：用户自备 IDE 与 LLM（Cursor、Claude Code 等）；本仓 **不调用** LLM API
+
+## 2. 五轨模型
+
+```text
+┌─────────────┐
+│  graph/     │  L0 架构地图模板 · 模块表 · flow 增量
+├─────────────┤
+│ coding_wiki/│  L2 读序 · invoke 互链 · 抑制上下文膨胀
+├─────────────┤
+│ standards/  │  L1/L2 规范模板 · 按语言栈
+├─────────────┤
+│ harness/    │  task · prompts · invoke 过程轨
+├─────────────┤
+│ ci/         │  lint / test / build 样例
+└─────────────┘
+       ↑
+   ide/ 适配层（rules · CLAUDE.md · AGENTS 指针）
+   wizard/ 安装向导（勾选生成）
+```
+
+## 3. 与用户业务仓的关系
+
+| 本仓路径 | 嵌入目标（用户仓，示例） |
+|----------|-------------------------|
+| `graph/templates/*` | `docs/_tech_graph/` |
+| `coding_wiki/templates/*` | `docs/coding_wiki/` |
+| `standards/*` | `docs/standards/` |
+| `harness/templates/*` | `docs/tasks/`、`docs/harness/` |
+| `ci/samples/*` | `.github/workflows/` 等 |
+| `ide/adapters/*` | `.cursor/rules/`、`CLAUDE.md`、`AGENTS.md` |
+
+**原则：** 单源模板在本仓；用户仓为 **运行实例**，自行维护增量。
+
+## 4. 存量项目闸门（D4-a）
+
+改码类 task（30 帽）开工前，用户仓须：
+
+1. `docs/_tech_graph/01_struct.md` **模块边界表** 已填
+2. 人工闸 `HG-GRAPH-MODULES` = **approved**
+
+**不要求** 首次 onboarding 画完全部 flowchart；flow 随 task **增量** 维护。
+
+## 5. 版本演进（同仓扩展）
+
+| 版本线 | 能力 |
+|--------|------|
+| **v0.1** | 五轨模板 + wizard + 文档可跟做 |
+| **v0.2+** | `cli/`：`harness ctx` 读序组装（只读） |
+| **v0.3+** | `worker/`：可选执行 Worker（自配 LLM） |
+
+CLI/Worker 与模板 **同一仓库** 演进，避免多仓割裂。
+
+## 6. 目录真值
+
+以仓库根目录实际树为准；各子目录 `README.md` 说明该轨职责与待补模板清单。
+
+## 7. 产品设计本体
+
+Track / Hat / Sync / SDD 公理与扩展规则见 [`methodology/product/DESIGN_ONTOLOGY_v1_zh.md`](./methodology/product/DESIGN_ONTOLOGY_v1_zh.md)（**v1.2**）。  
+**方法论总指引**：[`methodology/README.md`](./methodology/README.md) · 关系图 [`methodology/DOCUMENT_MAP_v1_zh.md`](./methodology/DOCUMENT_MAP_v1_zh.md)  
+远期 **过程实例图 + 事件历史** 见 [`methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md`](./methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md)（HGM · v0.5+ 提案）。  
+与 **战略本体**（工作区 `docs/harness/guides/STRATEGY_ONTOLOGY_*`）分层：本文件描述 **产品如何实现**，战略文档描述 **对外演进**。

package/docs/DESIGN_ONTOLOGY_v1_zh.md

@@ -0,0 +1,9 @@
+# POINTER · 产品设计本体
+
+| 项 | 内容 |
+| --- | --- |
+| **真值** | [`methodology/product/DESIGN_ONTOLOGY_v1_zh.md`](./methodology/product/DESIGN_ONTOLOGY_v1_zh.md) |
+| **版本** | v1.2 · draft |
+| **总指引** | [`methodology/README.md`](./methodology/README.md) |
+
+**禁止**在本文件复制全文。

package/docs/HARNESS_GRAPH_MODEL_design_v0_zh.md

@@ -0,0 +1,6 @@
+# POINTER · HGM 设计草案
+
+| 项 | 内容 |
+| --- | --- |
+| **真值** | [`methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md`](./methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md) |
+| **对话归档** | [`methodology/graph/HARNESS_GRAPH_MODEL_dialogue_archive_v1_zh.md`](./methodology/graph/HARNESS_GRAPH_MODEL_dialogue_archive_v1_zh.md) |

package/docs/HARNESS_GRAPH_MODEL_dialogue_archive_v1_zh.md

@@ -0,0 +1,8 @@
+# POINTER · HGM 对话归档
+
+| 项 | 内容 |
+| --- | --- |
+| **真值** | [`methodology/graph/HARNESS_GRAPH_MODEL_dialogue_archive_v1_zh.md`](./methodology/graph/HARNESS_GRAPH_MODEL_dialogue_archive_v1_zh.md) |
+| **设计稿** | [`methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md`](./methodology/graph/HARNESS_GRAPH_MODEL_design_v0_zh.md) |
+
+**性质**：参考 · 非真值