我有不少文档在 docs 目录下，但是每次更新都需要提 PR
  1. 是不是应该放 GitHub 的 wiki 里面
  2. 但如果放 wiki 里面 AI 分析怎么能够更顺利的在本地读到文档？

## 对比

| | `docs/` in repo | GitHub Wiki |
|---|---|---|
| **更新流程** | 需要 PR review | 直接编辑，无需 PR |
| **AI 本地读取** | 天然可用，就在工作目录里 | 需要额外 clone wiki repo |
| **版本与代码同步** | 天然同步（同一 commit） | 独立历史，可能漂移 |
| **搜索** | grep/IDE 直接搜 | 需要切到 wiki repo |
| **权限控制** | 跟代码一致 | 单独的 wiki 权限 |

## 建议

**两者都用，按性质分类：**

1. **留在 `docs/`**：与代码强相关的文档（架构决策、API 规范、troubleshooting、STRUCTURE.md）——这些应该跟代码版本绑定，PR review 是合理的。

2. **放 Wiki**：研究提案、调研笔记、会议记录、操作手册等——更新频繁、不需要严格 review 的内容。

## 让 AI 顺利读到 Wiki

GitHub Wiki 本身就是一个独立的 git repo，地址是：

```
git@github.com:<org>/<repo>.wiki.git
```

最简单的做法是在项目根目录 clone 它作为 submodule 或者直接 gitignore 掉的本地目录：

```bash
# 一次性设置
git clone git@github.com:<org>/investibook.wiki.git .wiki

# .gitignore 里加上
.wiki/
```

这样 AI（包括 Claude Code）在本地工作时可以直接读 `.wiki/` 下的 markdown 文件，和读 `docs/` 没有区别。

如果想更自动化，可以加个 Makefile target：

```makefile
wiki:
	@if [ -d .wiki ]; then cd .wiki && git pull; else git clone git@github.com:<org>/investibook.wiki.git .wiki; fi
```

## 总结

- 不需要二选一
- 需要 review 的放 `docs/`，轻量快速更新的放 Wiki
- 本地 clone wiki repo 到 `.wiki/` 就解决了 AI 可读性问题