docs: clean Aligner migration metadata

Ariver

2026-07-13 14a1efc86d0295be3a0d3fe1ebe7b8080266da2d

docs: clean Aligner migration metadata

 .gitignore

@@ -1,4 +1,5 @@
.DS_Store
._*

# SwiftPM
.build/

 C1.source/AGENTS.md

@@ -1,11 +1,11 @@
# C1.source/AGENTS.md - 源码目录规则

适用于 `/Users/ar/Projects/Aligner2/03-O/C1.source`。
适用于 `/Users/ar/Projects/Aligner/03-O/C1.source`。

## 当前事实

- 本目录是 SwiftPM 源码根目录。
- 本目录不是 Git 根目录；Git 命令在 `/Users/ar/Projects/Aligner2/03-O` 下执行。
- 本目录不是 Git 根目录；Git 命令在 `/Users/ar/Projects/Aligner/03-O` 下执行。
- App 名：`Aligner`。
- Bundle ID：`com.ar.Aligner`。
- 最低 macOS：`14.0`。
@@ -14,13 +14,15 @@

## 读取顺序

1. `/Users/ar/Projects/Aligner2/AGENTS.md`
2. `/Users/ar/Projects/Aligner2/PROJECT.md`
3. `/Users/ar/Projects/Aligner2/GLOSSARY.md`
4. `/Users/ar/Projects/Aligner2/03-O/README.md`
5. `/Users/ar/Projects/Aligner2/03-O/C1.source/CODEGRAPH.md`
6. 当前任务相关的 Round / 架构文档
7. UI 修改时读 `/Users/ar/Projects/Aligner2/DESIGN.md`
1. `/Users/ar/Projects/Aligner/AGENTS.md`
2. `/Users/ar/Projects/Aligner/PROJECT.md`
3. `/Users/ar/Projects/Aligner/00-H/初心与Go-No-Go.md`
4. `/Users/ar/Projects/Aligner/02-P/plan-progress.markdown`
5. `/Users/ar/Projects/Aligner/GLOSSARY.md`
6. `/Users/ar/Projects/Aligner/03-O/README.md`
7. `/Users/ar/Projects/Aligner/03-O/C1.source/CODEGRAPH.md`
8. 当前任务相关的 Round / 架构文档
9. UI 修改时读 `/Users/ar/Projects/Aligner/DESIGN.md`

## 代码边界

@@ -42,19 +44,21 @@

## 验证

从 `/Users/ar/Projects/Aligner2/03-O/C1.source` 执行：
从 `/Users/ar/Projects/Aligner/03-O/C1.source` 执行：

```bash
set -o pipefail; swift build 2>&1 | head -c 6000
set -o pipefail; swift test 2>&1 | head -c 6000
swift build
swift test
```

打包时执行：

```bash
set -o pipefail; /Users/ar/Projects/Aligner2/03-O/C3.tools/package-app.sh 2>&1 | head -c 6000
/Users/ar/Projects/Aligner/03-O/C3.tools/package-app.sh
```

如需限制终端输出，使用执行工具的输出上限或写入日志文件，不在标准验证命令后追加截断管道。

如果不能运行验证，说明具体原因和剩余风险。

## 修改规则

 C1.source/CODEGRAPH.md

@@ -6,7 +6,7 @@

这是 Aligner 自维护的轻量工程地图，用来减少后续任务的代码定位成本和上下文重建 token。它不是完整架构文档，也不是自动生成的调用图；它只记录稳定入口、影响面、QA 入口和已保护行为。

Aligner2 同时维护两类代码地图：
Aligner 同时维护两类代码地图：

- `codegraph`：人工维护的本文件，记录模块边界、关键入口、受保护行为、QA 入口和最后验证基线。
- `codebase-memory`：`codebase-memory-mcp` 生成的自动代码知识图谱，保存到 `../.codebase-memory/graph.db.zst`，用于查询调用链、影响面、死代码候选和架构概览。
@@ -27,12 +27,12 @@
- 最近本地验收候选包：`0.1.12 / 20260625.2320`
- 最后冻结前验证：2026-06-28，`swift build`、`swift test`、`round015-entitlement-fixture-qa.sh`、`round1-main-ui-qa.sh` 通过；主 UI QA 日志目录 `/tmp/aligner-round01-main-ui-qa-20260628_210821`。
- 发布事实：`0.1.12` 是本地 QA 候选代码冻结 / rollback baseline；不是正式官网 release，Developer ID、notarization、staple、Gatekeeper、macOS 14 Phase C、下载源和正式发布 manifest 仍未闭环。
- Git 根目录：`/Users/ar/Projects/Aligner2/03-O`
- SwiftPM 根目录：`/Users/ar/Projects/Aligner2/03-O/C1.source`
- codebase-memory 共享产物：`/Users/ar/Projects/Aligner2/03-O/.codebase-memory/graph.db.zst`
- codebase-memory 项目名：`Users-ar-Projects-Aligner2-03-O`
- codebase-memory 索引范围：`C1.source`、`C3.tools`
- codebase-memory 当前规模：`3988` nodes / `12382` edges
- Git 根目录：`/Users/ar/Projects/Aligner/03-O`
- SwiftPM 根目录：`/Users/ar/Projects/Aligner/03-O/C1.source`
- codebase-memory 共享产物：`/Users/ar/Projects/Aligner/03-O/.codebase-memory/graph.db.zst`
- codebase-memory 当前状态：stale；`03-O/.codebase-memory/artifact.json` 仍指向旧项目名 `Users-ar-Projects-Aligner2-03-O` 和 commit `1fea9bfc8a7639bb3573a7cf2a449ab55065ab9e`，不得作为当前代码事实源。
- codebase-memory 预期索引范围：`C1.source`、`C3.tools`
- codebase-memory 旧产物规模：`3988` nodes / `12382` edges

## 更新触发


 C3.tools/README.md

New file
@@ -0,0 +1,11 @@
# C3.tools

本目录保存 Aligner 的构建、诊断、QA 和发布辅助脚本。

## 规则

- 工具脚本必须服务于当前源码和交付流程。
- QA、打包、发布辅助脚本优先放这里，而不是散落在源码目录或构建产物目录。
- 脚本新增或改名后，如影响工程入口，更新 `../C1.source/CODEGRAPH.md`。
- 如脚本成为长期 QA / 发布门禁入口，同步更新 `../K2.项目管理/QA成果地图.md` 或相关交付流程文档。
- 临时一次性脚本用完后记录结论，不沉淀为长期工具。

 K1.业务知识/README.md

New file
@@ -0,0 +1,13 @@
# K1.业务知识

本目录保存长期有效的产品、领域和系统行为知识。

适合放入这里的内容：

- Aligner 长期产品决策。
- 用户任务、领域规则、系统能力和限制。
- 可复用的错误文案、验收口径和领域知识。
- 长期有效的技术约束、状态模型和系统行为知识。
- `成果地图.md` 中索引到的稳定成果和事实源。

不放 Round 过程记录；过程记录留在 `02-P/`。

 K1.业务知识/设计成果地图.md

@@ -1,4 +1,4 @@
# Aligner2 设计成果地图
# Aligner 设计成果地图

> 状态：迁移初稿
> Owner：设计总监
@@ -29,7 +29,7 @@

## 3. 关键设计证据

建议随 Aligner2 保留或索引的关键证据：
建议随 Aligner 保留或索引的关键证据：

- `02-P/Round01-QuickSwitch-MVP/02.ui设计稿/1.quick-switch-light-glass-v2-effect-20260527.png`
- `02-P/Round01-QuickSwitch-MVP/02.ui设计稿/2.quick-switch-dark-v3-effect-20260527.png`

 K2.项目管理/QA成果地图.md

@@ -1,4 +1,4 @@
# Aligner2 QA 成果地图
# Aligner QA 成果地图

> 状态：迁移初稿
> 用途：让新 QA / 新 Agent 快速知道有哪些门禁、脚本、证据和风险。
@@ -77,16 +77,16 @@
| `0.1.3 / 20260620.1337` | historical tagged candidate | 旧 Git HEAD / tag 基线 |
| `0.1.12 / 20260625.2320` | frozen local QA baseline | tag `v0.1.12-build20260625.2320`，本地 manifest `sourceStatus=clean`；不是正式官网 release |

## 5. Aligner2 接收 QA 结果
## 5. Aligner 接收 QA 结果

2026-06-28 已完成本地接收验证：

```bash
cd /Users/ar/Projects/Aligner2/03-O/C1.source
cd /Users/ar/Projects/Aligner/03-O/C1.source
swift build
swift test

cd /Users/ar/Projects/Aligner2/03-O
cd /Users/ar/Projects/Aligner/03-O
C3.tools/round015-entitlement-fixture-qa.sh
C3.tools/round1-main-ui-qa.sh
```

 K2.项目管理/README.md

New file
@@ -0,0 +1,14 @@
# K2.项目管理

本目录保存长期有效的项目管理、协作、复盘和交付经验。

适合放入这里的内容：

- Aligner 项目级 SOP。
- QA 门禁和验证地图。
- 阶段复盘。
- 交付验收经验。
- 新 Agent / 新 session 接手指南。
- 多角色协作规则的项目特例。

不复制全局规则；全局规则只在本项目有特例时才补充说明。

 K2.项目管理/新窗口接手指南.md

@@ -1,10 +1,10 @@
# Aligner2 新窗口接手指南
# Aligner 新窗口接手指南

> 用途：验证 Aligner2 是否能让新电脑、新 session、新 Agent 不依赖旧长会话接上工作。
> 用途：验证 Aligner 是否能让新电脑、新 session、新 Agent 不依赖旧长会话接上工作。

## 1. 接手目标

接手者只读取 Aligner2 项目内文件，应该能回答：
接手者只读取 Aligner 项目内文件，应该能回答：

- 项目是什么，当前产品重点是什么。
- 当前做到哪，哪些是已完成成果，哪些仍在进行。
@@ -17,15 +17,16 @@
根目录 `AGENTS.md` 是唯一入口；本指南不另设独立读取顺序。新窗口接手时按 `AGENTS.md` 的顺序执行：

1. `PROJECT.md`
2. `02-P/plan-progress.markdown`
3. `02-P/角色协作宪章.md`
4. `03-O/K2.项目管理/新窗口接手指南.md`
5. `GLOSSARY.md`
6. `INDEX.md`
7. 就近的 `AGENTS.md`
8. `03-O/C1.source/CODEGRAPH.md`
9. `DESIGN.md`
10. 当前任务相关的 `02-P/` 下有效 Round / PRD / QA / 架构文档
2. `00-H/初心与Go-No-Go.md`
3. `02-P/plan-progress.markdown`
4. `02-P/角色协作宪章.md`
5. `03-O/K2.项目管理/新窗口接手指南.md`
6. `GLOSSARY.md`
7. `INDEX.md`
8. 就近的 `AGENTS.md`
9. `03-O/C1.source/CODEGRAPH.md`
10. `DESIGN.md`
11. 当前任务相关的 `02-P/` 下有效 Round / PRD / QA / 架构文档

不得从旧长会话、旧 `GTD.md` 或历史 Round TODO 直接领取活跃任务。

@@ -33,9 +34,9 @@

| 项 | 当前值 |
| --- | --- |
| 工作区 | `/Users/ar/Projects/Aligner2` |
| Git 根目录 | `/Users/ar/Projects/Aligner2/03-O` |
| SwiftPM 根目录 | `/Users/ar/Projects/Aligner2/03-O/C1.source` |
| 工作区 | `/Users/ar/Projects/Aligner` |
| Git 根目录 | `/Users/ar/Projects/Aligner/03-O` |
| SwiftPM 根目录 | `/Users/ar/Projects/Aligner/03-O/C1.source` |
| 当前产品重点 | Quick Switch / 快捷三栏 |
| 当前迁移基线 | 旧 Aligner dirty 工作树已冻结为本地 QA 候选 rollback baseline |
| 最新本地候选 | `0.1.12 / 20260625.2320` |
@@ -61,12 +62,12 @@
## 5. 接手自检命令

```bash
cd /Users/ar/Projects/Aligner2/03-O
cd /Users/ar/Projects/Aligner/03-O
git status --short --branch
git diff --check
codebase-memory-mcp cli list_projects '{}'

cd /Users/ar/Projects/Aligner2/03-O/C1.source
cd /Users/ar/Projects/Aligner/03-O/C1.source
swift build
swift test
```
@@ -97,7 +98,7 @@

已验证：

- 能说明 Aligner2 的迁移目的、当前产品重点、Git / SwiftPM 根目录。
- 能说明 Aligner 的迁移目的、当前产品重点、Git / SwiftPM 根目录。
- 能识别 `plan-progress.markdown` 是唯一活跃任务入口。
- 能说明角色边界和不可踩踏规则。
- 能定位 `CODEGRAPH.md`、`codebase-memory`、QA 成果地图和接收验证记录。

 K2.项目管理/研发交付验收流程.md

@@ -2,8 +2,8 @@

> 状态：当前有效
> 建立日期：2026-05-30
> 适用范围：Aligner2 每个涉及代码实现、脚本实现、构建产物或用户可见行为变更的开发事项。
> 任务记录入口：`/Users/ar/Projects/Aligner2/02-P/plan-progress.markdown`
> 适用范围：Aligner 每个涉及代码实现、脚本实现、构建产物或用户可见行为变更的开发事项。
> 任务记录入口：`/Users/ar/Projects/Aligner/02-P/plan-progress.markdown`

## 流程定义

@@ -61,8 +61,8 @@

## 当前配套依据

- `/Users/ar/Projects/Aligner2/02-P/plan-progress.markdown`：统一活跃任务、状态、阻塞和验收证据入口。
- `/Users/ar/Projects/Aligner2/02-P/AGENTS.md`：过程文档规则，要求测试计划和验收记录写入当前 Round 的 QA 区域，长期流程经验沉淀到 `03-O/K2.项目管理/`。
- `/Users/ar/Projects/Aligner/02-P/plan-progress.markdown`：统一活跃任务、状态、阻塞和验收证据入口。
- `/Users/ar/Projects/Aligner/02-P/AGENTS.md`：过程文档规则，要求测试计划和验收记录写入当前 Round 的 QA 区域，长期流程经验沉淀到 `03-O/K2.项目管理/`。
- `/Users/ar/.codex/rules/qa-workflow.md`：QA 通用规则，要求覆盖真实用户节奏、窗口层级、过渡过程和可复核证据。
- 当前 Round 的 PRD / QA / 架构文档：定义本轮范围、验收口径和具体测试矩阵。


 K3.运营与发布资料/README.md

New file
@@ -0,0 +1,15 @@
# K3.运营与发布资料

本目录保存 Aligner 的官网、商店、营销、支持和法务资料。

## 子目录

- `Website/`：官网页面、素材、站点脚本
- `AppStoreConnect/`：渠道元数据、审核说明、商店材料
- `Marketing/`：营销图、演示图、传播素材
- `Support-Legal/`：支持、隐私、协议、法务资料

## 规则

- 运营与发布资料不与源码、过程文档混放。
- 渠道资料和法务资料只有进入稳定使用后，才在此长期维护。