| phase |
plan |
type |
wave |
depends_on |
files_modified |
autonomous |
requirements |
must_haves |
| 01-conflict-inventory-and-decision-matrix |
01 |
execute |
1 |
|
| .planning/phases/01-conflict-inventory-and-decision-matrix/01-PLAN.md |
| .planning/phases/01-conflict-inventory-and-decision-matrix/conflict-inventory.csv |
| .planning/phases/01-conflict-inventory-and-decision-matrix/conflict-inventory.md |
| .planning/phases/01-conflict-inventory-and-decision-matrix/titan-decision-matrix.md |
| .planning/phases/01-conflict-inventory-and-decision-matrix/audit-evidence.md |
|
true |
|
| truths |
artifacts |
key_links |
| 团队可以看到 merge 覆写热点的文件级证据、风险分级与来源提交。 |
| 团队可以看到 Titan 重叠代码路径及每个热点的 keep/replace/hybrid 决策。 |
| 后续阶段可以直接使用本阶段产物作为“旧视觉+新逻辑”执行输入。 |
|
| path |
provides |
| .planning/phases/01-conflict-inventory-and-decision-matrix/conflict-inventory.csv |
可审计冲突清单(文件、提交、风险、类别) |
|
| path |
provides |
| .planning/phases/01-conflict-inventory-and-decision-matrix/conflict-inventory.md |
冲突清单说明与分级口径 |
|
| path |
provides |
| .planning/phases/01-conflict-inventory-and-decision-matrix/titan-decision-matrix.md |
Titan overlap 决策矩阵(keep/replace/hybrid) |
|
| path |
provides |
| .planning/phases/01-conflict-inventory-and-decision-matrix/audit-evidence.md |
命令级证据链(可复现) |
|
|
| from |
to |
via |
pattern |
| git merge/author 历史 |
conflict-inventory.csv |
冲突提交 + Titan 触达聚合 |
git show -m + git log --author='[Tt]itan' |
|
| from |
to |
via |
pattern |
| conflict-inventory.csv |
titan-decision-matrix.md |
按风险与重叠分层决策 |
P0/P1 + keep/replace/hybrid |
|
|
|
构建可审计的冲突盘点与 Titan 重叠决策基线,形成后续“旧视觉+新逻辑”执行阶段的唯一输入源。
Purpose: 在不做大规模功能实现的前提下,先把 merge 覆写风险与 Titan overlap 决策透明化、证据化。
Output: conflict-inventory.csv、conflict-inventory.md、titan-decision-matrix.md、audit-evidence.md。
@.planning/PROJECT.md
@.planning/REQUIREMENTS.md
@.planning/ROADMAP.md
@.planning/phases/01-conflict-inventory-and-decision-matrix/01-RESEARCH.md
@.planning/codebase/ARCHITECTURE.md
@.planning/codebase/STRUCTURE.md
@.planning/codebase/CONCERNS.md
Wave 1 - Task 1: 生成可复现证据链与原始热点集合
.planning/phases/01-conflict-inventory-and-decision-matrix/audit-evidence.md
- Test 1: 必须列出用于提取 merge 覆写热点的命令与提交列表(含冲突语义 merge 提交)。
- Test 2: 必须列出用于提取 Titan overlap 的命令与结果摘要(作者轨 + 语义轨)。
- Test 3: 任一命令复跑后可得到同类型输出结构(允许计数随仓库演进变化)。
基于 01-RESEARCH 既有方法
,固定并执行审计命令链
:merge 提交采集、`git show -m` 文件提取、Titan 作者触达与“移植 Titan main”语义提交提取
;将命令、时间、分支、输出摘要写入 `audit-evidence.md`,确保可复现与可审查。仅做证据整理,不修改业务代码。
test -s .planning/phases/01-conflict-inventory-and-decision-matrix/audit-evidence.md && rg -n "git show -m|git log --all --author='\\[Tt\\]itan'|7342cc08|merge" .planning/phases/01-conflict-inventory-and-decision-matrix/audit-evidence.md
`audit-evidence.md` 包含完整命令链、执行上下文、结果摘要,并可支持他人复跑验证。
Wave 2 - Task 2: 产出可审计冲突清单
(MERGE-01
)
.planning/phases/01-conflict-inventory-and-decision-matrix/conflict-inventory.csv
.planning/phases/01-conflict-inventory-and-decision-matrix/conflict-inventory.md
- Test 1: CSV 至少包含字段 `file_path, merge_hotspot_count, titan_touch_count, change_class, behavior_critical, risk_level, evidence_refs`。
- Test 2: 每条记录必须有 evidence_refs 指向具体提交或命令结果。
- Test 3: Markdown 文档明确风险分级规则
(P0/P1/P2
)与 change_class
(visual-only/logic-only/mixed
)。
依据 Wave 1 证据,形成文件级冲突清单:汇总 merge 热点频次、Titan 触达频次、行为关键度,按研究中的三轴口径完成风险分级与类别标注;输出机器可消费 CSV + 人类可审阅说明文档,满足 MERGE-01 的“文件级证据 + 风险分类”要求。
test -s .planning/phases/01-conflict-inventory-and-decision-matrix/conflict-inventory.csv && test -s .planning/phases/01-conflict-inventory-and-decision-matrix/conflict-inventory.md && head -n 1 .planning/phases/01-conflict-inventory-and-decision-matrix/conflict-inventory.csv | rg "file_path,merge_hotspot_count,titan_touch_count,change_class,behavior_critical,risk_level,evidence_refs" && rg -n "P0|P1|P2|visual-only|logic-only|mixed" .planning/phases/01-conflict-inventory-and-decision-matrix/conflict-inventory.md
冲突清单可直接回答“哪些文件被 merge 覆写风险影响、风险多高、证据来自哪里”。
Wave 3 - Task 3: 产出 Titan 重叠决策矩阵并绑定后续输入
(MERGE-03
)
.planning/phases/01-conflict-inventory-and-decision-matrix/titan-decision-matrix.md
- Test 1: 每个 Titan overlap 热点都有 `decision`
(keep/replace/hybrid
)与 `rationale`。
- Test 2: 每条决策都包含“旧视觉+新逻辑”落地指引
(L0/L1/L2 边界)。
- Test 3: 每条决策都包含后续阶段入口(建议归属 Phase 2 或 Phase 3
)。
基于冲突清单筛选 Titan overlap 文件,形成决策矩阵:逐项定义 keep/replace/hybrid、给出可审计依据与冲突化解理由
,并明确后续执行归属
(逻辑归 Phase 2、视觉归 Phase 3
)。确保输出是后续“旧视觉+新逻辑”实施的直接输入,不在本阶段实现功能改动。
test -s .planning/phases/01-conflict-inventory-and-decision-matrix/titan-decision-matrix.md && rg -n "keep|replace|hybrid|L0|L1|L2|Phase 2|Phase 3|rationale" .planning/phases/01-conflict-inventory-and-decision-matrix/titan-decision-matrix.md
决策矩阵可直接回答“Titan overlap 该保留什么、替换什么、为什么,以及后续在哪个阶段执行”。
<threat_model>
Trust Boundaries
| Boundary |
Description |
git history -> planning artifacts |
来自历史提交的证据在写入计划产物前需要防止误读与遗漏 |
planning artifacts -> next-phase execution |
错误决策会传递到后续实现阶段并造成行为回归 |
STRIDE Threat Register
| Threat ID |
Category |
Component |
Disposition |
Mitigation Plan |
| T-01-01 |
T (Tampering) |
conflict-inventory.csv |
mitigate |
所有记录必须带 evidence_refs,且在 audit-evidence.md 可追溯到具体命令/提交 |
| T-01-02 |
R (Repudiation) |
titan-decision-matrix.md |
mitigate |
每条 keep/replace/hybrid 必须包含 rationale 与来源证据,避免无法追责 |
| T-01-03 |
I (Information Disclosure) |
audit-evidence.md |
accept |
仅记录仓库公开代码提交信息,不写入密钥/凭据;若发现敏感值立即脱敏 |
| T-01-04 |
D (Denial of Service) |
验证命令链 |
accept |
验证命令限定在本地文本扫描与 git 查询,不引入重型构建任务 |
| </threat_model> |
|
|
|
|
1. 执行 Wave 1-3 各任务的 `` 命令,全部返回 0。
2. 抽查 `conflict-inventory.csv` 中 P0 文件,能在 `audit-evidence.md` 找到对应证据。
3. 抽查 `titan-decision-matrix.md` 至少 3 条记录,确认均有 `decision + rationale + Phase 2/3 输入`。
<success_criteria>
- 满足 MERGE-01:存在文件级冲突清单,且每条有证据引用与风险分级。
- 满足 MERGE-03:存在 Titan overlap 决策矩阵,且每条有 keep/replace/hybrid 明确结论。
- 产物可作为后续“旧视觉+新逻辑”执行输入:每个热点有 L0/L1/L2 边界与阶段归属。
- Phase 01 不引入业务功能实现,仅交付可审计规划资产。
</success_criteria>
After completion, create `.planning/phases/01-conflict-inventory-and-decision-matrix/01-SUMMARY.md`