@sushanglewis/lincoln 1.6.3 → 1.7.0

package/framework/.claude/stages/phase-1-p0-design.yaml

@@ -0,0 +1,44 @@
+schema_version: 3.0.0
+id: phase-1-p0-design
+name: Phase 1 P0 Design
+description: 'Design Phase 1 / P0 recommendations from the LEW-70 research baseline:
+
+  SecurityAnalyzer + ConfirmationPolicy, harness distribution for
+
+  Claude Code/Codex/OpenCode, and declarative hook/MCP configuration.
+
+  '
+prerequisite_stage: explore-opensource
+next_stage: phase-1-p0-implement
+human_gate: true
+agent:
+  primary: lc-architect
+  reviewers:
+  - lc-engineer
+  handoff_to: lc-pm
+skills:
+  required: []
+  optional: []
+artifacts:
+  required:
+  - '{process_slug}/designs/phase-1-p0-harness-security-design.md'
+context:
+  goal: 'Produce an approved design document for the highest-priority borrowable
+
+    patterns before any implementation PR is opened.
+
+    '
+  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
+
+    - human_gate 必须获得人类 PM 显式确认。
+
+    '
+gates:
+  entry:
+  - check: previous_stage_completed
+    args:
+    - explore-opensource
+  exit:
+  - check: artifacts_present
+workflows:
+- framework-self-improvement

package/framework/.claude/stages/phase-1-p0-implement.yaml

@@ -0,0 +1,47 @@
+schema_version: 3.0.0
+id: phase-1-p0-implement
+name: Phase 1 P0 Implement
+description: 'Implement Phase 1 / P0 recommendations from the approved design document.
+
+  '
+prerequisite_stage: phase-1-p0-design
+next_stage: phase-2-p1-design
+human_gate: false
+agent:
+  primary: lc-engineer
+  reviewers:
+  - lc-qa
+  handoff_to: lc-pm
+skills:
+  required: []
+  optional: []
+artifacts:
+  required:
+  - .claude/policies/security.yaml
+  - .claude/hooks/pre-tool-use.sh
+  - .claude/hooks/hooks.yaml
+  - .claude/mcp/mcp.yaml
+  - .claude/harnesses/codex.yaml
+  - .claude/harnesses/opencode.yaml
+  - scripts/security_analyzer.py
+  - scripts/lincoln_harness_adapter.py
+  - scripts/lincoln-setup.py
+  - scripts/check-harness-drift.sh
+context:
+  goal: 'Implement the approved P0 design and verify with tests and static checks.
+
+    '
+  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
+
+    - 所有变更必须通过测试与 static-check.sh。
+
+    '
+gates:
+  entry:
+  - check: previous_stage_completed
+    args:
+    - phase-1-p0-design
+  exit:
+  - check: artifacts_present
+workflows:
+- framework-self-improvement

package/framework/.claude/stages/phase-2-p1-design.yaml

@@ -0,0 +1,53 @@
+schema_version: 3.0.0
+id: phase-2-p1-design
+name: Phase 2 P1 Design
+description: 'Design Phase 2 / P1 recommendations from the LEW-70 research baseline:
+
+  friction-based learning + recall precheck, EventLog + Condenser,
+
+  skill marketplace + git caching, sub-agent delegation, and MR knowledge mining.
+
+  '
+prerequisite_stage: phase-1-p0-implement
+next_stage: phase-2-p1-implement
+human_gate: true
+agent:
+  primary: lc-architect
+  reviewers:
+  - lc-engineer
+  - lc-researcher
+  handoff_to: lc-pm
+  parallel_specialists:
+  - lc-architect
+  - lc-security-reviewer
+  merge_strategy: priority
+  output_schema: .claude/schemas/design-review-feedback.json
+skills:
+  required: []
+  optional: []
+artifacts:
+  required:
+  - '{process_slug}/designs/phase-2-p1-learning-eventlog-subagents-design.md'
+context:
+  goal: 'Produce an approved design document for P1 borrowable patterns before
+
+    any implementation PR is opened.
+
+    '
+  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
+
+    - human_gate 必须获得人类 PM 显式确认。
+
+    - Lincoln 不自研底层执行器；所有设计必须适配 Claude Code / Codex / OpenCode。
+
+    '
+gates:
+  entry:
+  - check: previous_stage_completed
+    args:
+    - phase-1-p0-implement
+  exit:
+  - check: artifacts_present
+  - check: human_approved
+workflows:
+- framework-self-improvement

package/framework/.claude/stages/phase-2-p1-implement.yaml

@@ -0,0 +1,45 @@
+schema_version: 3.0.0
+id: phase-2-p1-implement
+name: Phase 2 P1 Implement
+description: 'Implement Phase 2 / P1 recommendations from the approved design document.
+
+  '
+prerequisite_stage: phase-2-p1-design
+next_stage: product-design-docs
+human_gate: false
+agent:
+  primary: lc-engineer
+  reviewers:
+  - lc-qa
+  handoff_to: lc-pm
+skills:
+  required: []
+  optional: []
+artifacts:
+  required:
+  - .claude/policies/friction.yaml
+  - .claude/schemas/design-review-feedback.json
+  - scripts/lincoln_friction.py
+  - scripts/lincoln_recall.py
+  - scripts/lincoln_condenser.py
+  - scripts/lincoln_mr_mine.py
+  - scripts/lincoln_trace.py
+  - scripts/stage_loader.py
+context:
+  goal: 'Implement the approved P1 design and verify with tests and static checks.
+
+    '
+  constraints: '- 仅通过 scripts/stage_loader.py 更新 {process_slug}/workflow-stage.yaml。
+
+    - 所有变更必须通过测试与 static-check.sh。
+
+    '
+gates:
+  entry:
+  - check: previous_stage_completed
+    args:
+    - phase-2-p1-design
+  exit:
+  - check: artifacts_present
+workflows:
+- framework-self-improvement

package/framework/.claude/workflows/framework-self-improvement.yaml

@@ -0,0 +1,100 @@
+workflow:
+  name: framework-self-improvement
+  version: 1.0.0
+  description: 持续改进 Lincoln 框架本身的工作流（安全门控、harness 分发、摩擦学习、事件追踪、子代理委托）
+  execution_mode: team
+  engine: everything-claude-code
+
+  steps:
+    - id: workflow-router
+      name: 工作流路由
+      description: 会话开场引导后，选择最适合当前场景的工作流模板
+      action: lc-workflow-router
+
+    - id: clarify
+      name: 需求澄清
+      description: 与人类 PM 多轮澄清，形成统一需求文档
+      human_gate: true
+      action: clarify-requirements
+      artifacts:
+        - "{process_slug}/pages/docs/requirements.html"
+      exit_checks:
+        - check: requirements_has_background_problem_solution_acceptance
+        - check: human_approved
+
+    - id: explore-opensource
+      name: 开源方案探索
+      description: 调研可复用的开源方案并记录决策
+      action: lc-explore-opensource
+      artifacts:
+        - "{process_slug}/docs/research/{change_name}-oss-options.md"
+      exit_checks:
+        - check: oss_research_complete
+
+    - id: phase-1-p0-design
+      name: Phase 1 P0 设计
+      description: 设计 P0 安全门控与 harness 分发方案
+      human_gate: true
+      action: draft-product-design
+      artifacts:
+        - "{process_slug}/designs/phase-1-p0-harness-security-design.md"
+      exit_checks:
+        - check: design_docs_complete
+        - check: design_docs_human_approved
+
+    - id: phase-1-p0-implement
+      name: Phase 1 P0 实现
+      description: 实现 P0 安全门控与 harness 分发
+      action: implement
+      artifacts:
+        - ".claude/policies/security.yaml"
+        - ".claude/hooks/pre-tool-use.sh"
+        - ".claude/hooks/hooks.yaml"
+        - ".claude/mcp/mcp.yaml"
+        - ".claude/harnesses/codex.yaml"
+        - ".claude/harnesses/opencode.yaml"
+        - "scripts/security_analyzer.py"
+        - "scripts/lincoln_harness_adapter.py"
+        - "scripts/lincoln-setup.py"
+        - "scripts/check-harness-drift.sh"
+      exit_checks:
+        - check: artifacts_present
+
+    - id: phase-2-p1-design
+      name: Phase 2 P1 设计
+      description: 设计 P1 摩擦学习、事件追踪扩展、子代理委托与 MR 知识挖掘方案
+      human_gate: true
+      action: draft-product-design
+      artifacts:
+        - "{process_slug}/designs/phase-2-p1-learning-eventlog-subagents-design.md"
+      exit_checks:
+        - check: design_docs_complete
+        - check: design_docs_human_approved
+
+    - id: phase-2-p1-implement
+      name: Phase 2 P1 实现
+      description: 实现 P1 摩擦学习、事件追踪扩展、子代理委托与 MR 知识挖掘
+      action: implement
+      artifacts:
+        - ".claude/policies/friction.yaml"
+        - ".claude/schemas/design-review-feedback.json"
+        - "scripts/lincoln_friction.py"
+        - "scripts/lincoln_recall.py"
+        - "scripts/lincoln_condenser.py"
+        - "scripts/lincoln_mr_mine.py"
+        - "scripts/lincoln_trace.py"
+        - "scripts/stage_loader.py"
+      exit_checks:
+        - check: artifacts_present
+
+    - id: sync-knowledge
+      name: 同步到知识库
+      description: 将业务与技术知识沉淀到 Obsidian vault
+      trigger: on_pr_merge
+      action: sync-to-knowledge
+      artifacts:
+        - "knowledge/03-features/{feature_slug}.md"
+      exit_checks:
+        - check: feature_doc_has_business_and_technical_sections
+        - check: feature_doc_has_links
+        - check: no_conflict_with_existing_knowledge

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

@@ -46,6 +46,7 @@ workflow:
       human_gate: true
       artifacts:
         - "{process_slug}/pages/docs/requirements.html"
+        - "{process_slug}/pages/docs/stakeholders.html"
         - "{process_slug}/pages/docs/user-stories.html"
         - "{process_slug}/pages/docs/prd.html"
       optional_artifacts:

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.6.3",
+      "version": "1.7.0",
       "author": {
         "name": "Lincoln contributors"
       },
@@ -28,5 +28,5 @@
       ]
     }
   ],
-  "version": "1.6.3"
+  "version": "1.7.0"
 }

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

@@ -1,6 +1,6 @@
 {
   "name": "lincoln",
-  "version": "1.6.3",
+  "version": "1.7.0",
   "description": "AI-Native product R&D collaboration system for Conductor + Claude Code + OpenSpec + GitHub + Obsidian",
   "author": {
     "name": "Lincoln contributors"

package/framework/.version-bump.json

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

package/framework/README.en.md

@@ -2,6 +2,8 @@
 
 > [中文](README.md) | English
 
+**TL;DR** — Lincoln is an AI-Native R&D workflow system that brings stage-driven discipline, human gates, and repeatable SOPs to Claude Code, Codex, and OpenCode — from requirements to shipped knowledge.
+
 Lincoln is an AI-Native R&D workflow system spanning **IDEs, agent harnesses, code hosting, knowledge management, skills, plugins, and automation**. It runs on **stages** for rhythm, **gates** for quality, and **repeatable SOPs** as its backbone, chaining requirements clarification, product design, prototyping, TDD planning, OpenSpec proposals, task splitting, implementation, and knowledge-base distillation into one human-AI collaborative pipeline.
 
 - **Whole lifecycle, not a point tool**: every stage has explicit role, skill, and artifact contracts — agents step in at the right moments instead of replacing human judgment.
@@ -10,9 +12,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.3-blue)](RELEASE.md)
+[![Release](https://img.shields.io/badge/release-v1.7.0-blue)](RELEASE.md)
 
-**v1.6.3** is released: Lincoln switches to a global npm plugin model. Install with `npm install -g @sushanglewis/lincoln`; projects opt in via `.lincoln.yaml`.
+**v1.7.0** is released: SecurityAnalyzer pre-tool-use gating, Trace 2.0 event log, session friction scoring and knowledge recall, plus multi-dimensional stakeholder analysis in the clarify stage.
 
 See the full release notes in [RELEASE.md](RELEASE.md).
 
@@ -113,7 +115,11 @@ First time? Read [USAGE.md](USAGE.md) for the full installation and usage guide.
 
 ### Stage-Driven Workflow Engine
 
-Each stage is defined in `.claude/stages/<stage-id>.yaml` with its role, skills, gates, and artifacts. The `workflow-stage.yaml` runtime state drives agent context injection, while Lincoln's stage loader handles stage validation, artifact recording, and gate advancement.
+Each stage is defined in `.claude/stages/<stage-id>.yaml` with its role, skills, gates, and artifacts. The `workflow-stage.yaml` runtime state drives agent context injection, while Lincoln's stage loader handles stage validation, artifact recording, and gate advancement. `--render-stage` batch rendering generates all missing artifact pages declared by a stage in a single command.
+
+### Artifact Traceability
+
+Lincoln assigns stable IDs such as `feature/*`, `page/*`, `field/*`, and `doc/*` to requirements, pages, fields, documents, and other artifacts. Downstream stages trace upstream work by ID instead of guessing paths. To trace an artifact, just tell the Agent "Look up doc/requirement-001".
 
 ### Preset SOP Workflow Templates
 
@@ -128,14 +134,14 @@ Each stage is defined in `.claude/stages/<stage-id>.yaml` with its role, skills,
 
 See [`.claude/workflows/README.md`](.claude/workflows/README.md) for the full template catalog.
 
-### Issue Work Packages (HTML Portal)
+### Markdown-First Issue Work Packages
 
 Every requirement maps to one GitHub issue and one Lincoln feature branch. The `issue-<N>/` work package contains:
 
 - `index.html` — human-facing portal aggregating stage status, navigation, and artifacts
 - `workflow-stage.yaml` — machine-readable state and handoff protocol
 - `documents.yaml` — artifact index and human-approval status
-- `pages/docs/` — HTML pages for requirements, PRDs, designs, TDD plans
+- `pages/docs/` — pages for requirements, PRDs, designs, TDD plans; narrative docs are Markdown-first and can be authored as Markdown chapters with `mermaid` diagrams, rendered by the local `mermaid.min.js` runtime
 - `pages/prototype/` — interactive HTML prototypes
 - `handoffs/` — stage handoff documents
 
@@ -154,6 +160,7 @@ Lincoln is AI-Native — **you don't need to type terminal commands**. Describe
 | List all active Lincoln branches | Lists stage status and blockers for every issue branch |
 | Run benchmark | Generates a Lincoln session benchmark report |
 | Start the PM research workflow | Enters the `pm-research` research chain |
+| Look up doc/requirement-001 | Traces the artifact by stable ID |
 
 More commands and usage details are in [USAGE.md](USAGE.md).
 
@@ -201,6 +208,18 @@ Before submitting a PR, please read:
 - [OpenSpec docs](https://github.com/Fission-AI/openspec)
 - [Obsidian WikiLinks](https://help.obsidian.md/Linking+notes+and+files/Internal+links)
 
+## Release History
+
+| Version | Date | Key capabilities |
+|---|---|---|
+| v1.7.0 | 2026-09-05 | SecurityAnalyzer gating; Trace 2.0 event log; friction scoring/knowledge recall/trace condensation/MR mining; parallel specialist delegation; stakeholder analysis model |
+| v1.6.3 | 2026-08-15 | Markdown-first issue-package documents; `--render-stage` batch rendering; local `mermaid.min.js` runtime |
+| v1.6.2 | 2026-08-12 | `lc-init-branch` reads global Lincoln templates |
+| v1.6.1 | 2026-08-11 | `lc-one-id` artifact traceability; portal annotation alignment |
+| v1.6.0 | 2026-08-06 | Global npm plugin model; `@sushanglewis/lincoln` CLI; release-on-merge automation |
+
+See [RELEASE.md](RELEASE.md) for full release notes.
+
 ## License
 
 Lincoln is released under the [MIT License](LICENSE), Copyright (c) 2026 苏尚lewis (sushanglewis).

package/framework/README.md

@@ -2,6 +2,8 @@
 
 > 中文 | [English](README.en.md)
 
+**TL;DR** — Lincoln is an AI-Native R&D workflow system that brings stage-driven discipline, human gates, and repeatable SOPs to Claude Code, Codex, and OpenCode — from requirements to shipped knowledge.
+
 Lincoln 是一个贯穿 **IDE、Agent Harness、代码托管、知识管理、技能、插件与自动化程序** 的 AI-Native 研发工作流体系。它以**阶段**为节奏、以**门控**为质量保障、以**可重复 SOP** 为骨架，把需求澄清、产品设计、原型、TDD 计划、OpenSpec 提案、任务拆分、研发实现和知识库沉淀串成一条可人机协作的流水线。
 
 - **全流程，而非单点工具**：每个阶段都有明确的角色、技能与产物约定——Agent 在恰当的节点介入，而不是替代人的判断。
@@ -10,9 +12,9 @@ Lincoln 是一个贯穿 **IDE、Agent Harness、代码托管、知识管理、
 
 ## 最新版本
 
-[![Release](https://img.shields.io/badge/release-v1.6.3-blue)](RELEASE.md)
+[![Release](https://img.shields.io/badge/release-v1.7.0-blue)](RELEASE.md)
 
-**v1.6.3** 已发布：Lincoln 切换为全局 npm 插件模型，通过 `npm install -g @sushanglewis/lincoln` 安装，项目侧使用 `.lincoln.yaml` 选择性激活。
+**v1.7.0** 已发布：新增 SecurityAnalyzer 安全门控、Trace 2.0 事件日志与会话摩擦学习/知识召回能力，clarify 阶段支持多维度相关者分析。
 
 查看完整发布说明：[RELEASE.md](RELEASE.md)
 
@@ -113,7 +115,11 @@ lincoln migrate-project --yes       # 确认迁移
 
 ### 阶段驱动的工作流引擎
 
-每个阶段定义在 `.claude/stages/<stage-id>.yaml`，内含角色、可调用的技能、门控条件与产物要求。`workflow-stage.yaml` 作为运行时状态，由 Lincoln 的阶段加载器驱动阶段校验、产物记录与 gate 推进。
+每个阶段定义在 `.claude/stages/<stage-id>.yaml`，内含角色、可调用的技能、门控条件与产物要求。`workflow-stage.yaml` 作为运行时状态，由 Lincoln 的阶段加载器驱动阶段校验、产物记录与 gate 推进。`--render-stage` 批量渲染可一次生成某阶段声明的所有缺失文档页面。
+
+### 产物追溯
+
+Lincoln 为需求、页面、字段、文档等产物分配 `feature/*`、`page/*`、`field/*`、`doc/*` 稳定 ID。下游阶段按 ID 追溯上游产物，避免路径猜测带来的漂移。需要追溯时，直接对 Agent 说「查一下 doc/需求-001」即可。
 
 ### 预设 SOP 工作流模板
 
@@ -128,14 +134,14 @@ lincoln migrate-project --yes       # 确认迁移
 
 完整模板说明见 [`.claude/workflows/README.md`](.claude/workflows/README.md)。
 
-### Issue 工作包（HTML 门户）
+### Markdown-first Issue 工作包
 
 每个需求对应一个 GitHub issue 和一个 Lincoln feature 分支。工作包目录 `issue-<N>/` 包含：
 
 - `index.html` — 人读门户，聚合阶段状态、导航与产物
 - `workflow-stage.yaml` — 机器状态与 handoff 协议
 - `documents.yaml` — 产物索引与 human 确认状态
-- `pages/docs/` — 需求、PRD、设计、TDD 计划等 HTML 页面
+- `pages/docs/` — 需求、PRD、设计、TDD 计划等页面，叙事类文档采用 Markdown-first，可直接用 Markdown 章节和 `mermaid` 流程图编写，渲染时自动加载本地 `mermaid.min.js` 运行时
 - `pages/prototype/` — 可交互原型 HTML 页面
 - `handoffs/` — 阶段交接文档
 
@@ -154,6 +160,7 @@ Lincoln 是 AI-Native 工作流——**你不需要在终端输入任何命令**
 | 列出所有活跃分支 | 列出所有 issue 分支的阶段状态与等待对象 |
 | 运行 benchmark | 生成 Lincoln 会话基准评测报告 |
 | 启动 PM 研究工作流 | 进入 `pm-research` 研究链路 |
+| 查一下 doc/需求-001 | 调用 `lc-one-id` 按稳定 ID 追溯产物 |
 
 更多命令与用法见 [USAGE.md](USAGE.md)。
 
@@ -201,6 +208,18 @@ Lincoln 的 `.claude/` 是开放的系统提示层，欢迎基于同一套元模
 - [OpenSpec 文档](https://github.com/Fission-AI/openspec)
 - [Obsidian WikiLinks](https://help.obsidian.md/Linking+notes+and+files/Internal+links)
 
+## 版本记录
+
+| 版本 | 日期 | 关键能力 |
+|---|---|---|
+| v1.7.0 | 2026-09-05 | SecurityAnalyzer 安全门控；Trace 2.0 事件日志；摩擦学习/知识召回/Trace 浓缩/MR 挖掘；并行专家子代理委托；相关者分析模型 |
+| v1.6.3 | 2026-08-15 | Markdown-first issue-package 文档；`--render-stage` 批量渲染；Mermaid 图表本地渲染 |
+| v1.6.2 | 2026-08-12 | `lc-init-branch` 改读全局 Lincoln 模板 |
+| v1.6.1 | 2026-08-11 | `lc-one-id` 产物追溯 skill；portal 注解对齐 |
+| v1.6.0 | 2026-08-06 | 全局 npm 插件模型；`@sushanglewis/lincoln` CLI；release-on-merge 自动化 |
+
+完整发布说明见 [RELEASE.md](RELEASE.md)。
+
 ## License
 
 Lincoln 本体以 [MIT License](LICENSE) 发布，Copyright (c) 2026 苏尚lewis (sushanglewis)。

package/framework/RELEASE.md

@@ -1,3 +1,25 @@
+# Lincoln v1.7.0 Release Notes
+
+**Release date:** 2026-09-05
+
+## Highlights
+
+- **SecurityAnalyzer pre-tool-use 安全门控 (#115)** — 新增 `scripts/security_analyzer.py` 与 `.claude/policies/security.yaml`：对 Bash 副作用命令（`rm -rf`、强推、危险重定向等）做风险分类与策略匹配，命中时要求人类确认后才允许执行；包含路径规范化与命令分段解析的防绕过修复。
+- **Harness 分发能力翻转 (#115)** — hooks/skills 从默认关闭翻转为默认启用（opt-out）；新增 `.claude/harnesses/hooks.yaml` 与 `.claude/harnesses/mcp.yaml` 声明式配置，`lincoln_harness_adapter.py` 为 codex/opencode 生成对应产物，保持三 harness 无漂移。
+- **Trace 2.0 事件日志 (#115)** — Trace schema 升级到 2.0.0：阶段生命周期、gate 审批、产物记录、工作流完成等事件自动落盘到实例级 `.trace/`，支持 `node_id` 关联与后续审计分析。
+- **P1 学习能力四件套 (#115)** — 会话结束时 `lincoln_friction.py` 对会话摩擦打分（`friction.yaml` 策略）；会话开始时 `lincoln_recall.py` 按当前阶段召回相关知识；`lincoln_condenser.py` 对超长 trace 做浓缩摘要；`lincoln_mr_mine.py` 提供 GitHub PR/MR 模式挖掘 CLI。
+- **并行专家子代理委托 (#115)** — stage 定义新增 `agent.parallel_specialists`、`merge_strategy`（priority/vote/consensus）与 `output_schema`，`stage_loader` 在阶段准入时校验委托配置；新增 `lc-security-reviewer` 安全审查角色与设计评审反馈 JSON schema。
+- **framework-self-improvement 工作流 (#115)** — 注册 `phase-1-p0-design/implement`、`phase-2-p1-design/implement` 四个阶段，形成「调研 → 设计 → 实现 → 学习」的框架自我改进闭环，并接入 `lc-wf-framework-self-improvement` 命令。
+- **多维度相关者分析模型 (#114)** — `clarify` 阶段新增 `stakeholders.html` 必需产物，`clarify-requirements` prompt 增加相关者识别/影响力-态度分析步骤，PM 角色职责同步更新。
+
+## Migration Notes
+
+- 全局插件用户升级：`npm update -g @sushanglewis/lincoln` 后重跑 `lincoln install --yes`，把新 hooks、安全策略与技能同步到 `~/.claude/`（以及 codex/opencode 对应目录）。
+- 安全门控默认生效且为人类确认制（confirm_required），不是自动阻断；策略可在项目 `.claude/policies/security.yaml` 中按需调整。
+- 无破坏性变更：现有 issue 工作包、`.lincoln.yaml` 激活方式与阶段协议均保持兼容。
+
+---
+
 # Lincoln v1.6.3 Release Notes
 
 **Release date:** 2026-08-14

package/framework/SKILL.md

@@ -1,24 +1,33 @@
 ---
 name: Lincoln
-description: Lincoln AI-Native R&D workflow system — terminal installer and agent harness templates
+description: Lincoln AI-Native R&D workflow system — global npm plugin and agent harness templates
 ---
 
 # Lincoln
 
-After this skill is installed, launch the guided terminal installer to set up Lincoln in your project:
+After this skill is installed, set up Lincoln globally on your machine:
 
 ```bash
-npx lincoln-install
+npm install -g @sushanglewis/lincoln
+lincoln install --yes
 ```
 
-The installer will walk you through selecting an agent harness (Claude Code, Cursor, Codex, OpenCode, etc.), optional dependencies, and project configuration. For CI or scripting, use `--no-tui --format json` or `--yes --dry-run`.
+`npm install -g` installs the CLI and bundled framework payload. `lincoln install --yes` syncs hooks, agents, skills, scripts, and the full runtime framework to `~/.claude/`, `~/.codex/`, and `~/.opencode/`.
 
-To update an existing Lincoln project to the latest release while preserving your user data, run:
+You can also target specific harnesses:
 
 ```bash
-npx lincoln-update
+lincoln install --yes --harnesses claude-code,opencode
+```
+
+To update an existing Lincoln installation while preserving your user data, run:
+
+```bash
+lincoln update
 ```
 
 Use `--dry-run` to preview changes or `--no-tui --format json` for scripted updates.
 
 For the agent-mediated setup flow, ask your Agent to run `/lc-setup` instead.
+
+> **Deprecated**: the old `npx lincoln-install` / `npx lincoln-update` wrappers are still present but no longer recommended. If your project previously used the vendored framework model, run `lincoln migrate-project --yes` to switch to the global plugin model.