@sushanglewis/lincoln 1.5.5 → 1.6.2

package/framework/.claude/stages/product-prototype.yaml

@@ -1,15 +1,24 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: product-prototype
 name: Product Prototype
-description: Generates UI specs, field specs, and optionally Pencil prototypes (prototype.pen is produced by UI after the UX node).
-templates:
-- interview-to-knowledge
-- existing-project-iteration
+description: 基于已确认设计文档生成字段规格、UI 规格和可交互 HTML 原型（pages/prototype/**/*.html）。Pencil 原型（prototype.pen）为可选，由 UI 在 UX 节点之后按需产出。
+workflows:
 - design-spike
+- existing-project-iteration
+- interview-to-knowledge
 - oss-first-design
 prerequisite_stage: product-design-docs
 next_stage: tdd-development-plan
 human_gate: true
+execution_mode: both
+primary_action: build-product-prototype
+variables:
+- process_slug
+- design_id
+artifact_templates:
+  '{process_slug}/pages/docs/ui-spec.html': .claude/templates/issue-package/page-doc-structured.html.tpl
+  '{process_slug}/pages/docs/fields.html': .claude/templates/issue-package/page-doc-structured.html.tpl
+  '{process_slug}/pages/prototype/**/*.html': .claude/templates/issue-package/page-prototype-structured.html.tpl
 agent:
   primary: lc-designer
   reviewers:
@@ -31,19 +40,13 @@ artifacts:
   - '{process_slug}/pages/prototype/**/*.html'
   optional:
   - '{process_slug}/designs/{design_id}/prototype.pen'
+references:
+  skill_prompt: .claude/skills/build-product-prototype/SKILL.md
+  agent_guide: .claude/agents/designer.md
 context:
-  goal: 将已确认的产品设计文档转化为开发可用的 UI/字段规格 HTML 文档与高保真 HTML 交互原型。`prototype.pen` 由 UI 在 UX 节点之后产出，因此在本阶段 PM→UX 交接中视为 optional。所有产物通过 {process_slug}/index.html 门户访问。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 本阶段设有 human_gate，必须获得人类 PM 显式确认后才能进入下一阶段。
-
-    - `{process_slug}/pages/prototype/**/*.html` 为 required 高保真 HTML 交互原型；`prototype.pen` 为 optional UI 阶段产物。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  goal: 将已确认的产品设计文档转化为开发可用的 UI/字段规格 HTML 文档与高保真 HTML 交互原型。HTML 原型是本阶段的主要评审产物；`prototype.pen` 由 UI 在 UX 节点之后按需产出，在本阶段视为 optional。所有产物通过 {process_slug}/index.html 门户访问。
+  execution: 调用 build-product-prototype skill 基于已确认的设计文档生成 fields.html、ui-spec.html 以及 pages/prototype/ 下的高保真 HTML 交互原型；Pencil 原型（prototype.pen）为 optional，仅在 PM 明确要求时由 UI 在 UX 节点之后产出。
+  constraints: '- `{process_slug}/pages/prototype/**/*.html` 为 required 高保真 HTML 交互原型；`prototype.pen` 为 optional UI 阶段产物。'
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/propose.yaml

@@ -1,13 +1,22 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: propose
 name: Propose
 description: 'Generates a complete OpenSpec change proposal including
 
   proposal.md, design.md, tasks.md, and specs/ directory.'
-templates: all
+workflows:
+- bug-fix
+- existing-project-iteration
+- interview-to-knowledge
+- oss-first-design
 prerequisite_stage: tdd-development-plan
 next_stage: split
 human_gate: false
+execution_mode: both
+primary_action: propose-with-openspec
+variables:
+- process_slug
+- change_name
 agent:
   primary: lc-engineer
   reviewers:
@@ -16,6 +25,7 @@ agent:
   handoff_to: lc-pm
 skills:
   required:
+  - lincoln:propose-with-openspec
   - openspec:propose
   optional:
   - superpowers:verification-before-completion
@@ -26,16 +36,13 @@ artifacts:
   - '{process_slug}/openspec/changes/{change_name}/design.md'
   - '{process_slug}/openspec/changes/{change_name}/tasks.md'
   - '{process_slug}/openspec/changes/{change_name}/specs/'
+references:
+  skill_prompt: .claude/skills/propose-with-openspec/SKILL.md
+  agent_guide: .claude/agents/engineer.md
 context:
   goal: 基于已确认的 TDD 研发计划，调用 OpenSpec CLI 生成标准变更提案 artifact 目录（`{process_slug}/openspec/changes/{change_name}/`），将
     TDD 计划转化为结构化的 OpenSpec 变更提案，作为后续 GitHub Issues 拆分和研发实现的依据。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: 调用 propose-with-openspec skill，通过 OpenSpec CLI 读取 tdd-plan.html 并生成标准变更提案目录，包含 proposal.md、design.md、tasks.md 与 specs/，作为后续 GitHub Issues 拆分与研发实现的依据。
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/split.yaml

@@ -1,13 +1,19 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: split
 name: Split
 description: 'Breaks OpenSpec tasks into parallel, independently implementable
 
   GitHub Issues with clear boundaries and acceptance criteria.'
-templates: all
+workflows:
+- bug-fix
+- existing-project-iteration
+- interview-to-knowledge
+- oss-first-design
 prerequisite_stage: propose
 next_stage: implement
 human_gate: false
+execution_mode: both
+primary_action: split-to-github
 agent:
   primary: lc-pm
   reviewers:
@@ -16,6 +22,7 @@ agent:
   handoff_to: lc-engineer
 skills:
   required:
+  - lincoln:split-to-github
   - superpowers:dispatching-parallel-agents
   optional:
   - gsd:phase
@@ -23,15 +30,12 @@ skills:
 artifacts:
   required:
   - .github/linked-issues.yaml
+references:
+  skill_prompt: .claude/skills/split-to-github/SKILL.md
+  agent_guide: .claude/agents/pm.md
 context:
   goal: 将 OpenSpec 变更提案中的 tasks 拆分为可执行的 GitHub Issues，建立从需求到代码追踪的完整链路。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: 调用 split-to-github skill 读取 OpenSpec 变更提案中的 tasks，拆分为边界清晰、可独立实施的 GitHub Issues，并写入 .github/linked-issues.yaml 维护任务与 issue 的双向映射。
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/sync-knowledge.yaml

@@ -1,4 +1,4 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: sync-knowledge
 name: Sync Knowledge
 description: 'After PR merge, updates Obsidian vault and archives milestone
@@ -6,16 +6,30 @@ description: 'After PR merge, updates Obsidian vault and archives milestone
   artifacts, generating feature docs, decision docs, and interview
 
   summaries.'
-templates: all
+workflows:
+- bug-fix
+- design-spike
+- existing-project-iteration
+- interview-to-knowledge
+- oss-first-design
 prerequisite_stage: implement
 next_stage: null
 human_gate: false
+execution_mode: both
+primary_action: sync-to-knowledge
+variables:
+- pr_number
+- session_id
+- requirement_id
+- feature_slug
+- decision_id
 agent:
   primary: lc-knowledge-curator
   reviewers:
   - lc-release-coordinator
 skills:
   required:
+  - lincoln:sync-to-knowledge
   - gsd:docs-update
   optional:
   - gsd:forensics
@@ -31,15 +45,12 @@ artifacts:
   - knowledge/02-requirements/{requirement_id}.md
   - knowledge/03-features/{feature_slug}.md
   - knowledge/04-decisions/{decision_id}.md
+references:
+  skill_prompt: .claude/skills/sync-to-knowledge/SKILL.md
+  agent_guide: .claude/agents/knowledge-curator.md
 context:
   goal: PR 合并后，将代码变更、Issue 讨论、设计决策沉淀到项目 Obsidian 知识库，确保业务知识和技术知识双轨保存，形成可追溯的知识资产。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: "调用 sync-to-knowledge skill 在 PR 合并后将代码变更、Issue 讨论与设计决策写入 Obsidian vault（knowledge/01-interviews、02-requirements、03-features、04-decisions），并在 .github/lincoln-sync-queue/pr-{pr_number}.yaml 记录同步状态。"
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/tdd-development-plan.yaml

@@ -1,13 +1,23 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: tdd-development-plan
 name: TDD Development Plan
 description: 'Produces tdd-plan.html with red/green/refactor sequences,
 
   test scenarios, and task slices ready for OpenSpec proposal.'
-templates: all
+workflows:
+- bug-fix
+- existing-project-iteration
+- interview-to-knowledge
+- oss-first-design
 prerequisite_stage: product-prototype
 next_stage: propose
 human_gate: false
+execution_mode: both
+primary_action: plan-tdd-development
+variables:
+- process_slug
+artifact_templates:
+  '{process_slug}/pages/docs/tdd-plan.html': .claude/templates/issue-package/page-doc.html.tpl
 agent:
   primary: lc-engineer
   reviewers:
@@ -16,6 +26,7 @@ agent:
   handoff_to: lc-engineer
 skills:
   required:
+  - lincoln:plan-tdd-development
   - superpowers:writing-plans
   - superpowers:test-driven-development
   optional:
@@ -25,15 +36,12 @@ skills:
 artifacts:
   required:
   - '{process_slug}/pages/docs/tdd-plan.html'
+references:
+  skill_prompt: .claude/skills/plan-tdd-development/SKILL.md
+  agent_guide: .claude/agents/engineer.md
 context:
   goal: 基于已确认的产品设计文档、字段规格、UI 规格和 Pencil 原型，生成可执行的测试驱动研发计划（`tdd-plan.html`），作为从产品设计到 OpenSpec 变更提案的桥梁。所有产物通过 {process_slug}/index.html 门户访问。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: "调用 plan-tdd-development skill 基于已确认的产品设计文档、字段规格、UI 规格和 Pencil 原型，生成包含验收映射、测试场景与任务切片的 tdd-plan.html，作为 OpenSpec 提案的输入。"
 gates:
   entry:
   - check: previous_stage_completed

package/framework/.claude/stages/workflow-router.yaml

@@ -1,4 +1,4 @@
-schema_version: 2.0.0
+schema_version: 3.0.0
 id: workflow-router
 name: Workflow Router
 description: 'Entry point. Runs session intake (overview recon, situation judgment,
@@ -6,10 +6,19 @@ description: 'Entry point. Runs session intake (overview recon, situation judgme
   Johari confirmation) on cold start, assesses repository context, selects the most
 
   appropriate workflow template, and initializes workflow-stage.'
-templates: all
+workflows:
+- bug-fix
+- design-spike
+- existing-project-iteration
+- oss-first-design
+- pm-research
 prerequisite_stage: null
 next_stage: null
 human_gate: true
+execution_mode: both
+primary_action: lc-workflow-router
+variables:
+- process_slug
 agent:
   primary: lc-pm
   reviewers:
@@ -17,6 +26,7 @@ agent:
   handoff_to: lc-pm
 skills:
   required:
+  - lincoln:lc-workflow-router
   - superpowers:bootstrap
   optional:
   - gsd:new-project
@@ -25,19 +35,13 @@ skills:
 artifacts:
   required:
   - '{process_slug}/workflow-stage.yaml'
+references:
+  skill_prompt: .claude/skills/lc-workflow-router/SKILL.md
+  agent_guide: .claude/agents/pm.md
 context:
   goal: 在会话启动时先做概览级摸排与处境判断（冷启动开场引导），经用户确认后选择最适合的 Lincoln 工作流模板。
-  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
-
-    - 开场摸排为概览级：只读操作 ≤ 8 次，不读源码实现，不做深度扫描（禁用 lc-build-codebase-knowledge）。
-
-    - 禁止修改 {process_slug}/recordings/ 中的原始文件。
-
-    - 本阶段设有 human_gate，必须获得人类 PM 显式确认后才能进入下一阶段。
-
-    - 门控评估优先使用 AI 能力：读取产物并推理其完整性，而非仅依赖脚本化检查。
-
-    - 详细执行步骤、模板与工具见对应 skill prompt 和 .claude/agents/<primary_agent>.md。'
+  execution: 调用 lc-workflow-router skill 的 intake 流程：执行概览级摸排与处境判断，向人类 PM 提出 Johari 确认问题，经用户确认目标与执行路径后选择最匹配的工作流模板并初始化 {process_slug}/workflow-stage.yaml。
+  constraints: '- 开场摸排为概览级：只读操作 ≤ 8 次，不读源码实现，不做深度扫描（禁用 lc-build-codebase-knowledge）。'
 gates:
   entry: []
   exit:

package/framework/.claude/workflows/bug-fix.yaml

@@ -66,6 +66,7 @@ workflow:
     - id: implement
       name: 研发实现
       description: 按 TDD 实施并完成验证
+      action: implement
       human_gate: true
 
     - id: sync-knowledge

package/framework/.claude/workflows/existing-project-iteration.yaml

@@ -91,6 +91,7 @@ workflow:
     - id: implement
       name: 研发实现
       description: 按 TDD 实施并完成验证
+      action: implement
       human_gate: true
 
     - id: sync-knowledge

package/framework/.claude/workflows/interview-to-knowledge.yaml

@@ -154,6 +154,7 @@ workflow:
     - id: implement
       name: 研发实现
       description: 人类研发团队基于 Issues 开发并提交 PR
+      action: implement
       entry_checks:
         - check: issues_ready
           args: ["{session_id}"]

package/framework/.claude/workflows/oss-first-design.yaml

@@ -85,6 +85,7 @@ workflow:
     - id: implement
       name: 研发实现
       description: 按 TDD 实施并完成验证
+      action: implement
       human_gate: true
 
     - id: sync-knowledge

package/framework/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "lincoln",
       "description": "AI-Native product R&D collaboration system for Conductor + Claude Code. Orchestrates stages, gates, artifacts, skills, and roles across product, design, and engineering into a repeatable workflow from recordings to GitHub Issues to Obsidian knowledge base.",
-      "version": "1.5.5",
+      "version": "1.6.2",
       "author": {
         "name": "Lincoln contributors"
       },
@@ -28,5 +28,5 @@
       ]
     }
   ],
-  "version": "1.5.5"
+  "version": "1.6.2"
 }

package/framework/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lincoln",
-  "version": "1.5.5",
+  "version": "1.6.2",
   "description": "AI-Native product R&D collaboration system for Conductor + Claude Code + OpenSpec + GitHub + Obsidian",
   "author": {
     "name": "Lincoln contributors"
@@ -32,6 +32,7 @@
     "./.claude/skills/lc-handoff/",
     "./.claude/skills/lc-init-branch/",
     "./.claude/skills/lc-market-research/",
+    "./.claude/skills/lc-one-id/",
     "./.claude/skills/lc-product-research/",
     "./.claude/skills/lc-research-report/",
     "./.claude/skills/lc-research-scope/",

package/framework/.version-bump.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.5.5",
+  "version": "1.6.2",
   "manifests": [
     {
       "path": ".claude-plugin/plugin.json",

package/framework/README.en.md

@@ -10,9 +10,9 @@ Lincoln is an AI-Native R&D workflow system spanning **IDEs, agent harnesses, co
 
 ## Latest Release
 
-[![Release](https://img.shields.io/badge/release-v1.6.0-blue)](RELEASE.md)
+[![Release](https://img.shields.io/badge/release-v1.6.2-blue)](RELEASE.md)
 
-**v1.6.0** is released: Lincoln switches to a global npm plugin model. Install with `npm install -g @sushanglewis/lincoln`; projects opt in via `.lincoln.yaml`.
+**v1.6.2** is released: Lincoln switches to a global npm plugin model. Install with `npm install -g @sushanglewis/lincoln`; projects opt in via `.lincoln.yaml`.
 
 See the full release notes in [RELEASE.md](RELEASE.md).
 
@@ -37,9 +37,22 @@ Open the repo and tell the Agent what you want in plain language. Lincoln will r
 
 ```bash
 npm install -g @sushanglewis/lincoln
+```
+
+`npm install -g` installs the CLI and bundled framework payload. After installation, an interactive bootstrap starts and lets you choose which agent harnesses to install Lincoln into (`Claude Code`, `Codex`, `OpenCode`).
+
+For a non-interactive install, run:
+
+```bash
 lincoln install --yes
 ```
 
+You can also target specific harnesses:
+
+```bash
+lincoln install --yes --harnesses claude-code,opencode
+```
+
 > **Note**: `npm install -g` only installs the CLI and bundled framework payload; **you must run `lincoln install`** to sync hooks, agents, skills, scripts, and the full runtime framework to `~/.claude/`, `~/.codex/`, and `~/.opencode/`.
 
 If you previously installed the legacy `lincoln-install` package, uninstall it first (its bin names conflict with the new package):

package/framework/README.md

@@ -10,9 +10,9 @@ Lincoln 是一个贯穿 **IDE、Agent Harness、代码托管、知识管理、
 
 ## 最新版本
 
-[![Release](https://img.shields.io/badge/release-v1.6.0-blue)](RELEASE.md)
+[![Release](https://img.shields.io/badge/release-v1.6.2-blue)](RELEASE.md)
 
-**v1.6.0** 已发布：Lincoln 切换为全局 npm 插件模型，通过 `npm install -g @sushanglewis/lincoln` 安装，项目侧使用 `.lincoln.yaml` 选择性激活。
+**v1.6.2** 已发布：Lincoln 切换为全局 npm 插件模型，通过 `npm install -g @sushanglewis/lincoln` 安装，项目侧使用 `.lincoln.yaml` 选择性激活。
 
 查看完整发布说明：[RELEASE.md](RELEASE.md)
 
@@ -37,10 +37,23 @@ Lincoln 是一个贯穿 **IDE、Agent Harness、代码托管、知识管理、
 
 ```bash
 npm install -g @sushanglewis/lincoln
+```
+
+`npm install -g` 会把 CLI 和框架 payload 安装到 npm 全局目录；安装完成后会自动进入引导程序，让你选择要安装到的 agent harness（`Claude Code`、`Codex`、`OpenCode`）。
+
+如果你希望非交互式安装，可以直接运行：
+
+```bash
 lincoln install --yes
 ```
 
-> **注意**：`npm install -g` 只是把 CLI 和框架 payload 安装到 npm 全局目录；**必须执行 `lincoln install`**，才会把 hooks、agents、skills、scripts 等完整运行时体系同步到 `~/.claude/`、`~/.codex/`、`~/.opencode/`。
+也可以只安装到指定的 harness：
+
+```bash
+lincoln install --yes --harnesses claude-code,opencode
+```
+
+> **注意**：**必须执行 `lincoln install`**，才会把 hooks、agents、skills、scripts 等完整运行时体系同步到 `~/.claude/`、`~/.codex/`、`~/.opencode/`。
 
 如果之前安装过旧版 `lincoln-install`，需要先卸载（旧包与新版 bin 名冲突）：
 

package/framework/RELEASE.md

@@ -1,7 +1,55 @@
+# Lincoln v1.6.2 Release Notes
+
+**Release date:** 2026-08-12
+
+## Highlights
+
+- **全局插件模式下 `lc-init-branch` 使用全局模板** — 修复 `lc-init-branch` 命令映射指向项目本地 `scripts/init-lincoln-branch.sh` 的问题。现在它会调用 `"$LINCOLN_ROOT/scripts/init-lincoln-branch.sh"`，确保新建 issue 工作包读取 `~/.lincoln/current/` 下的最新模板，而不是项目里遗留的旧版本 `.claude/templates/issue-package/`。
+- **迁移提示更新** — `lc-init-branch` skill 文档的示例命令改为使用 `$LINCOLN_ROOT`，与全局插件模型保持一致。
+
+## Migration Notes
+
+- 已使用全局插件模式的项目，运行 `lincoln migrate-project --yes` 清理本地旧 `.claude/` 文件后，再通过 `lc-init-branch` 初始化工作包即可生效。
+- 如果已手动安装 Lincoln 1.6.1，可编辑 `~/.claude/harnesses/command-map.yaml` 中 `lc-init-branch` 的 action 为 `bash "$LINCOLN_ROOT/scripts/init-lincoln-branch.sh"`，或升级到 1.6.2 后重新 `lincoln install`。
+
+---
+
+# Lincoln v1.6.1 Release Notes
+
+**Release date:** 2026-08-11
+
+## Highlights
+
+- **lc-one-id skill** — Agent 现在可通过工具描述学习 one-id 查询，按 `feature/*`、`page/*`、`field/*`、`doc/*` 稳定 ID 追溯上游产物，避免 downstream 阶段凭路径猜测。
+- **Agent one-id 约束** — `.claude/agents/default.md` 明确要求：需要按 ID 追溯产物时调用 `lc-one-id` skill。
+- **Portal 注解对齐** — 修复 `lincoln_render.py` 把 HTML 注释内的占位 `<meta>` 误当作已存在标签的 bug，结构化数据里的 `annotations` 现在会正确注入为独立 `<meta>` 标签，被 portal 索引扫描到。
+- **command-map 刷新** — 自动注册 `lc-skill-one-id` 命令入口。
+
+## Tooling
+
+- `scripts/lincoln_id.py` 增加可执行权限，配合 skill prompt 直接调用。
+
+## Migration Notes
+
+- 无需迁移；已有 issue package 的 `index.html` portal 会在下次 `record-artifacts` 或 `lincoln_index.py` 刷新后自动获得完整注解。
+
+---
+
 # Lincoln v1.6.0 Release Notes
 
 **Release date:** 2026-08-06
 
+## Release Automation Contract
+
+Starting from this release, every PR merged into `main` automatically triggers a patch release:
+
+1. `.github/workflows/release-on-merge.yml` bumps the patch version in `.version-bump.json` and all linked manifests.
+2. The workflow updates the version badge and callout in `README.md` and `README.en.md`.
+3. The workflow commits the version bump, pushes it to `main`, and pushes a `lincoln-vX.Y.Z` tag.
+4. `.github/workflows/publish-lincoln.yml` publishes the npm package and creates a GitHub Release using the matching section from this file.
+
+To include curated release notes for a version, add a new section to this file before merging the release-triggering PR.
+
 ## Highlights
 
 Lincoln v1.6.0 moves the framework from a vendored-per-project model to a global npm plugin. Users now install `@sushanglewis/lincoln` once and run `lincoln install` to sync the framework to `~/.claude/`, `~/.codex/`, and `~/.opencode/`. Projects opt in with a single `.lincoln.yaml` marker; unmarked projects keep Lincoln inactive by default.