# Sources Index And Traceability

## Purpose
建立知识库的来源索引、追溯矩阵和冲突处理规则，确保所有核心规则可回溯。

## When to Use
- 新增或修改知识库规则前
- 发现两份来源说法不一致时
- 需要证明某条 SOP 来自哪里时

## Inputs
- `20260306-基于规范编程的开发模式与工作流.md`
- `20260304-AI自动化开发流水线与可靠性工程(1).md`
- `20260202-ralphy任务清单开发流程(3).md`
- `workflow.zip`
- `skills.zip`

## Outputs
- 源资产摘要索引
- 规则追溯矩阵
- 冲突处理顺序

## Primary Agent/Model
`GPT-5.4 Pro xhigh`

## Secondary Agent/Model
`Claude Opus 4.6`

## Required Skills
- 无强制 skill；必要时参考 `spec-reviewing` 的一致性思路

## Steps
1. 先看每个源资产对应的 digest 页面。
2. 判断这条规则是阶段骨架、质量原则、技能约束还是执行经验。
3. 若多个来源重叠，按“更具体、更晚、更新、更可执行”的顺序裁决。
4. 若裁决影响主流程或白名单，写 ADR 后再更新知识库正文。

## Exit Criteria
- 每条核心规则都能指向至少一个源资产
- 冲突规则已记录取舍和去向
- 不需要回看原始大段会议文本即可找到规则入口

## Failure Recovery
- 如果某条规则找不到来源，先降级为“待确认”，不要写入正式 SOP
- 如果来源冲突无法消解，写 ADR 并保留冲突说明

## Related Templates
- [`../templates/analysis-template.md`](../templates/analysis-template.md)
- [`../templates/agent-handoff-template.md`](../templates/agent-handoff-template.md)

## Source Digest 列表

| 源资产 | Digest |
|---|---|
| `20260306-基于规范编程的开发模式与工作流.md` | [`2026-03-06-spec-driven-workflow.md`](./2026-03-06-spec-driven-workflow.md) |
| `20260304-AI自动化开发流水线与可靠性工程(1).md` | [`2026-03-04-ai-pipeline-reliability.md`](./2026-03-04-ai-pipeline-reliability.md) |
| `20260202-ralphy任务清单开发流程(3).md` | [`2026-02-02-ralphy-task-list-flow.md`](./2026-02-02-ralphy-task-list-flow.md) |
| `workflow.zip` | [`workflow-zip-digest.md`](./workflow-zip-digest.md) |
| `skills.zip` | [`skills-zip-digest.md`](./skills-zip-digest.md) |

## 追溯矩阵

| 主题 | 主要来源 | 落点 |
|---|---|---|
| Spec 驱动、`CLAUDE.md`、调研到实施的链路 | `20260306...md` | `foundations/spec-driven-development.md`, `workflows/stage-0-setup.md`, `playbooks/new-project-from-scaffold.md` |
| 可靠性数学、Gap、简化与重构收敛 | `20260304...md` | `foundations/reliability-and-convergence.md`, `foundations/refactoring-and-gap-closure.md`, `workflows/stage-4-alignment.md`, `workflows/stage-5-refinement.md` |
| Ralphy 自包含任务标题与配置规则 | `20260202...md`, `skills.zip` | `templates/todo-yaml-template.md`, `workflows/stage-3-code.md` |
| 7 阶段流程骨架 | `workflow.zip` | `workflows/README.md` 与全部阶段页 |
| 技能到阶段的映射 | `skills.zip` | `workflows/`, `templates/`, `orchestration/` |

## 冲突处理顺序
1. `skills.zip` 中技能规则优先于泛化的阶段口述，前提是它更具体。
2. 两份会议整理冲突时，优先更晚的文档。
3. `workflow.zip` 提供流程骨架，不覆盖后续更具体的技能行为约束。
4. 一切正式取舍写入 [`../decisions/ADR-2026-03-21-source-precedence-and-conflict-resolution.md`](../decisions/ADR-2026-03-21-source-precedence-and-conflict-resolution.md)。