docs: reorganize docs directory layout

- group repository docs under architecture, development, milestones, reference, and specs
- update README and repository skill references to the new paths
- keep docs root ready for a future docs/wiki subtree

Signed-off-by: Chen Miao <chenmiao.ku@gmail.com>

Author: ChenMiaoi

.codex/skills/criew-development/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: criew-development
-description: Repository-specific workflow and coding rules for the CRIEW codebase. Use when modifying or reviewing CRIEW Rust code, TUI behavior, sync/IMAP/reply/patch workflows, migrations, tests, docs, or config, and whenever the task must follow `docs/code-guildline.md` or `docs/code-guildline-cn.md`.
+description: Repository-specific workflow and coding rules for the CRIEW codebase. Use when modifying or reviewing CRIEW Rust code, TUI behavior, sync/IMAP/reply/patch workflows, migrations, tests, docs, or config, and whenever the task must follow `docs/development/code-guildline.md` or `docs/development/code-guildline-cn.md`.
 ---
 
 # Criew Development
@@ -14,14 +14,14 @@ Read the repository docs first, then make focused changes that preserve the curr
 
 Read the relevant repository docs before editing code.
 
-- Read `docs/code-guildline.md` first for the canonical coding rules.
-- Read `docs/code-guildline-cn.md` when the user works in Chinese or explicitly asks for the Chinese guideline.
+- Read `docs/development/code-guildline.md` first for the canonical coding rules.
+- Read `docs/development/code-guildline-cn.md` when the user works in Chinese or explicitly asks for the Chinese guideline.
 - Read `README.md` or `README-zh.md` before changing user-visible behavior, install steps, naming, or operator workflow.
-- Read `docs/design.md` before changing architecture, module boundaries, sync flow, or data-model assumptions.
-- Read `docs/reply-format-spec.md` before changing reply composition, quoting, headers, or send flow.
-- Read `docs/config.example.toml` before changing config keys, defaults, or path semantics.
+- Read `docs/architecture/design.md` before changing architecture, module boundaries, sync flow, or data-model assumptions.
+- Read `docs/specs/reply-format-spec.md` before changing reply composition, quoting, headers, or send flow.
+- Read `docs/reference/config.example.toml` before changing config keys, defaults, or path semantics.
 
-Treat `docs/code-guildline.md` as the priority source when a local convention is unclear.
+Treat `docs/development/code-guildline.md` as the priority source when a local convention is unclear.
 Then follow tool-enforced rules and the existing style in the touched module.
 
 ## Keep The CRIEW Boundaries
@@ -41,7 +41,7 @@ Do not reintroduce legacy Courier naming.
 
 ## Apply The Coding Rules Directly
 
-Implement changes in the style required by `docs/code-guildline.md`.
+Implement changes in the style required by `docs/development/code-guildline.md`.
 
 - Prefer descriptive, behavior-accurate names.
 - Encode units in names when the type system does not.
@@ -96,6 +96,6 @@ If time or environment constraints prevent a command from running, report that c
 
 Load extra repository docs only when the task needs them.
 
-- Read `docs/mvp-milestones.md` and `docs/reply-mvp-milestones.md` for historical intent or rollout sequencing.
-- Read `docs/vim-mvp-milestones.md` and `docs/code-preview-vim-prototype.md` for Vim-mode and code-preview behavior.
+- Read `docs/milestones/mvp-milestones.md` and `docs/milestones/reply-mvp-milestones.md` for historical intent or rollout sequencing.
+- Read `docs/milestones/vim-mvp-milestones.md` and `docs/specs/code-preview-vim-prototype.md` for Vim-mode and code-preview behavior.
 - Read `src/ui/tui/tests.rs` before extending TUI behavior that already has test coverage.

README-zh.md

@@ -13,7 +13,16 @@ CRIEW 是一个面向 Linux kernel patch 邮件工作流的 Rust TUI 工具，
 
 English README: [README.md](README.md)
 
-## 当前能力
+## 导航
+
+- [项目概览](#项目概览)
+- [安装与配置](#安装与配置)
+- [使用](#使用)
+- [延伸阅读](#延伸阅读)
+
+## 项目概览
+
+### 当前能力
 
 - 同步 `lore.kernel.org` 邮件列表，并按 checkpoint 做增量更新
 - 同步真实 IMAP `INBOX`，内置 `My Inbox` 订阅
@@ -22,7 +31,7 @@ English README: [README.md](README.md)
 - 在 TUI 中撰写回信，并通过 `git send-email` 发送
 - 浏览本地 kernel tree，支持内联 Vim-like 编辑和外部 Vim 编辑
 
-## 发布基线
+### 发布基线
 
 `v0.0.1` 是 CRIEW 第一版对外支持的发布基线。
 从 `v0.0.1` 开始，项目只使用 CRIEW 这一套命名：
@@ -32,7 +41,7 @@ English README: [README.md](README.md)
 如果你之前测试过 rename 落定前的预发布快照，或者更早打出的 `v0.0.1` tag，
 请重新拉取代码或重新安装，并按当前命名重新初始化 CRIEW 运行目录。
 
-## 依赖
+### 依赖
 
 - Rust stable
 - Git
@@ -51,9 +60,11 @@ criew doctor
 
 它会检查 `b4`、`git send-email`、git 邮件身份和 IMAP 连接状态。
 
-## 安装
+## 安装与配置
 
-### 从 crates.io 安装
+### 安装
+
+#### 从 crates.io 安装
 
 ```bash
 cargo install criew
@@ -64,7 +75,7 @@ cargo install criew
 CRIEW 会在首次需要时把它展开到 `~/.criew/vendor/b4/`。
 这个 fallback 仍然需要系统可用的 Python 3。
 
-### 从源码仓库安装
+#### 从源码仓库安装
 
 如果你希望直接使用工作区里的 `./vendor/b4/b4.sh`，建议递归拉取子模块：
 
@@ -80,7 +91,7 @@ cargo install --path . --locked
 git submodule update --init --recursive
 ```
 
-### 直接从 GitHub 安装
+#### 直接从 GitHub 安装
 
 ```bash
 cargo install --git https://github.com/ChenMiaoi/CRIEW.git --locked criew
@@ -89,14 +100,16 @@ cargo install --git https://github.com/ChenMiaoi/CRIEW.git --locked criew
 这种方式下，建议你自行通过 `b4.path`、`CRIEW_B4_PATH` 或系统 `PATH` 提供 `b4`。
 如果 checkout 里也带着 `vendor/b4`，CRIEW 也能像源码模式一样直接使用它。
 
-### 开发时直接运行
+#### 开发时直接运行
 
 ```bash
 cargo run -- doctor
 cargo run -- tui
 ```
 
-## 配置
+### 配置
+
+#### 默认路径
 
 默认配置文件路径：
 
@@ -110,7 +123,9 @@ cargo run -- tui
 ~/.criew/
 ```
 
-首次运行时，CRIEW 会自动生成一个最小配置文件。完整示例见 [docs/config.example.toml](docs/config.example.toml)。
+#### 常见配置
+
+首次运行时，CRIEW 会自动生成一个最小配置文件。完整示例见 [docs/reference/config.example.toml](docs/reference/config.example.toml)。
 
 一个常见配置如下：
 
@@ -130,6 +145,8 @@ encryption = "ssl"
 tree = "/path/to/linux"
 ```
 
+#### 配置说明
+
 配置说明：
 
 - 相对路径会相对于配置文件所在目录解析
@@ -141,39 +158,43 @@ tree = "/path/to/linux"
 - `ui.inbox_auto_sync_interval_secs` 默认是 `30`
 - `~/.courier`、`courier-config.toml`、`courier.db`、`COURIER_B4_PATH`、`COURIER_IMAP_PROXY` 从 `v0.0.1` 起都不再受支持
 
-## 基本使用
+## 使用
+
+### 基本使用
 
-### 1. 环境自检
+#### 1. 环境自检
 
 ```bash
 criew doctor
 ```
 
-### 2. 同步 lore 邮箱
+#### 2. 同步 lore 邮箱
 
 ```bash
 criew sync --mailbox io-uring
 ```
 
-### 3. 同步真实 IMAP 收件箱
+#### 3. 同步真实 IMAP 收件箱
 
 ```bash
 criew sync --mailbox INBOX
 ```
 
-### 4. 使用本地 `.eml` fixture 调试
+#### 4. 使用本地 `.eml` fixture 调试
 
 ```bash
 criew sync --mailbox test --fixture-dir ./fixtures
 ```
 
-### 5. 启动 TUI
+#### 5. 启动 TUI
 
 ```bash
 criew tui
 ```
 
-## TUI 常用操作
+### TUI 常用操作
+
+#### 键位
 
 - `:` 打开命令栏
 - `y` / `n` 启用或禁用当前订阅
@@ -184,6 +205,8 @@ criew tui
 - `r` 或 `e` 打开回信面板
 - `Tab` 在 Mail 页面和 Code Browser 页面之间切换
 
+#### 命令栏命令
+
 命令栏常见命令：
 
 - `sync`
@@ -194,10 +217,12 @@ criew tui
 - `quit`
 - `!<shell command>`
 
+#### 后台同步
+
 如果 IMAP 配置完整，`My Inbox` 会参与启动自动同步，并在 TUI 保持打开时按配置周期持续做后台增量同步。
 启用的邮件列表订阅也会在 TUI 保持打开时按同一周期做后台增量同步，以持续拉取 Linux lore 和 QEMU GNU archive 上的新邮件。
 
-## 回复邮件
+### 回复邮件
 
 CRIEW 的 Reply Panel 会自动填充：
 
@@ -210,16 +235,18 @@ CRIEW 的 Reply Panel 会自动填充：
 
 同时会生成符合 kernel 邮件习惯的引用正文模板。发送时，底层走 `git send-email`。
 
-## 相关文档
+## 延伸阅读
+
+### 相关文档
 
 - [README.md](README.md): 英文项目说明
-- [docs/config.example.toml](docs/config.example.toml): 配置示例
-- [docs/design.md](docs/design.md): 设计文档
-- [docs/reply-format-spec.md](docs/reply-format-spec.md): 回信格式规范
-- [docs/mvp-milestones.md](docs/mvp-milestones.md): 历史里程碑
-- [docs/reply-mvp-milestones.md](docs/reply-mvp-milestones.md): 回信功能演进记录
+- [docs/reference/config.example.toml](docs/reference/config.example.toml): 配置示例
+- [docs/architecture/design.md](docs/architecture/design.md): 设计文档
+- [docs/specs/reply-format-spec.md](docs/specs/reply-format-spec.md): 回信格式规范
+- [docs/milestones/mvp-milestones.md](docs/milestones/mvp-milestones.md): 历史里程碑
+- [docs/milestones/reply-mvp-milestones.md](docs/milestones/reply-mvp-milestones.md): 回信功能演进记录
 
-## 开发
+### 开发
 
 ```bash
 cargo fmt --all -- --check
@@ -228,7 +255,7 @@ cargo test --all-targets --all-features
 ./scripts/check-coverage.sh
 ```
 
-## License
+### License
 
 CRIEW 自身的 Rust 代码使用 [LGPL-2.1](LICENSE) 许可证发布。
 打包进来的 vendored 组件保留各自上游许可证，包括 `vendor/b4`（GPL-2.0）