aireadmelisted

# AIREADME — AI 原生跨项目文档体系 为每个项目维护一个 `AIREADME/` 文件夹 = 该项目的 **AI 真相源**。双用途： 1. **跨项目了解** — 别的项目读 `../<proj>/AIREADME/` 搞懂本项目（架构 / 部署 / 契约）。 2. **防偏差** — 本项目自己的 agent 读 CORE / DECISIONS / ARCHITECTURE，不跑偏。 逐文件"写什么 / 不写什么 / 何时更新 / 哪些 N/A"的完整规范在**同目录 `STANDARD.md`**——执行任何模式前**必读它**。 ## 模式 | 现状 / 触发 | 模式 | |---|---| | 项目无 `AIREADME/` | **init** | | 已有 `AIREADME/` | **update** | | "检查 / lint" | **check** | ## init 流程 1. **读 `STANDARD.md`** 拿 12 文件规范 + 边界表 + 项目类型 N/A 矩阵 + 占位规范。 2. **判项目类型**（code / infra / docs·meta / product）→ 按 STANDARD 矩阵定哪些文件实写、哪些 N/A 占位。**monorepo（多 app/包）仍只建一份根 AIREADME**——子 app/包是组件、在 ARCHITECTURE 描述，不各自建 AIREADME。 3. **摸清本项目**（素材来源）： - repo 结构（`find -maxdepth 2`，排除 `node_modules/` `vendor/` `upstream/` 等 vendored 目录）、`README.md`、`docs/`、已有 `PRD/SPEC/INFRA/ROADMAP/OPS/USAGE/ARCHIVE` - 配置：`package.json` / `Cargo.toml` / `docker-compose.yml` / `.env.example` / `CLAUDE.md` - `git log --oneline -20` + `git tag`（→ CHANGELOG）+ 最新 commit SHA（→ INDEX 同步锚点）。**无任何 commit**（立项/pre-code）→ 锚点暂占位，且首 commit 必须在删根前（见 Step 7）。 - **（可选）本项目的 Claude Code 项目记忆**：若该项目在 Claude Code 用过、积累了项目记忆（路径 = 项目绝对路径每个 `/` 换 `-` → `~/.claude/projects/<dashed-path>/memory/`），读 `MEMORY.md` + 相关文件当耐久知识源。**目录不存在 → 跳过此源**（多数项目没有，正常）。 4. **已有文档定归属**（成熟 repo 关键，**这步只决定、不删**）：repo 已有 PRD/SPEC/INFRA/OPS/USAGE/ARCHIVE 等 → **按内容拆、不按文件名**（一个旧 doc 常跨多个 AIREADME 文件，映射见 STANDARD「旧文档迁入」）：重叠的标记**蒸馏迁入**、例外标记**指向/保留**，**绝不复制**（红线 4）。**vendored / 上游目录**（`upstream/` `vendor/` 等）：不吸收其 README/CLAUDE/