# Raw Sources

**Karpathy llm-wiki 三层架构的第 1 层**（独立于 wiki）。放**从外部捕获的不可变事实**：

```
brain/
├── raw/          ← 本目录（原始事实）
├── wiki/         ← LLM 从 raw 派生的综合视图
└── CLAUDE.md     ← schema
```

## 什么进 raw

**关键判断：是外部拿来的，不是自己写的**。

✅ 该进：
- 外部网页 scrape（ClawHub 扫描页面 / 阿里云文档 / 博客文章）
- API 响应快照（`aliyun ecs DescribeInstances` JSON / PyPI JSON）
- 第三方规范原文（Karpathy gist / 支付宝 API 文档 / MIT 许可证）
- 对话关键决策原话片段
- 外部文件（合同 PDF / 招标书 / 第三方给的数据表）
- 监控 / 错误截图 / incident 原始 log

❌ 不该进（各有归宿）：
- ADR → `brain/decisions/`
- SOP → `brain/sop/`
- 功能规格 → `brain/features/`
- LLM 派生页 → `brain/wiki/entities/` 或 `concepts/`
- 代码 / 测试 / 配置 → `src/` `test/` `.github/`

## 规则

- **Immutable**：raw 一旦建立不改内容（typo 除外）。外部事实变了**建新文件**，不覆盖老的
- **带时间戳**：每个 raw 文件开头 `captured_at: YYYY-MM-DDTHH:MMZ` 明确抓取时间（外部状态会变，raw 是"当时"的快照）
- **带来源**：`source: <URL or command>` 让后人能复现
- **LLM 只读**：wiki/entities/ 和 wiki/concepts/ 引用 raw 做派生，但不改写 raw

## 命名

- 外部网页 scrape → `<domain-slug>-<topic>-<YYYY-MM-DD>.md`（如 `clawhub-security-scan-xiangqin-2026-04-23.md`）
- API 响应 → `<service>-<endpoint>-<slug>-<YYYY-MM-DD>.json`
- 行业最佳实践 / 第三方规范原文 → `<org>-<doc-name>.md`
- 对话关键决策片段 → `<decision-slug>-<YYYY-MM-DD>.md`

## 当前清单

- [karpathy-llm-wiki-pattern.md](karpathy-llm-wiki-pattern.md) — Karpathy 原始 gist，本 brain 三层架构的来源
- [clawhub-security-scan-xiangqin-2026-04-23.md](clawhub-security-scan-xiangqin-2026-04-23.md) — v0.5.4 xiangqin skill 在 ClawHub 的安全扫描完整结果
- [distribution-channels-research-2026-04-23.md](distribution-channels-research-2026-04-23.md) — ClawHub vs skills.sh 审核/搜索/用户画像调研（agent sub-task 产出）

## 归档

见 [archive/](archive/index.md)（暂无归档；外部事实有更新时老 raw 本身不改，但可以归档到 archive/）。
