# Project Conventions

> 本工作区属于用户 `__USERNAME__`，由 AbleFlow 平台开通时从模板生成。

## 工作边界 — 严格限定

本项目的所有操作**必须限制在 `/home/core/dev/__USERNAME__/` 内部**。

- **禁止**读取、修改、创建 `/home/core/dev/__USERNAME__/` 之外的任何文件
- **禁止**访问上级目录 `../`、`/home/core/dev/` 或其他兄弟项目
- **禁止**引用外部项目的代码、数据或配置
- 所有路径必须使用**绝对路径**或相对于项目根的路径

（以上边界同时由 `.claude/settings.json` 的权限规则强制执行。）

## Directory Structure

```
/home/core/dev/__USERNAME__/
├── CLAUDE.md                             # 项目约定（本文件）
├── .gitignore                            # Git 忽略规则
├── .mcp.json                             # MCP 数据源配置
├── index.html                            # 工作区看板
├── scripts/                              # 脚本代码
├── workspace/                            # 工作目录（按日期组织）
│   └── YYMMDD/                           # 当日工作目录，如 260519
│       ├── data/                         # 中间数据 (CSV/JSON)
│       ├── output/                       # 生成产物 (pptx, xlsx, docx, zip)
│       └── README.md                     # 工作日志
├── wiki/                                 # auto-wiki 知识库（按主题隔离）
│   └── {topic}/                          # 如 personal-pension、treasury-futures
│       ├── meta.yaml
│       ├── index.md
│       ├── data.db                       # 结构化数据（SQLite）
│       └── sources/ entities/ concepts/ analyses/
└── .claude/
    ├── settings.json                     # 权限规则（平台管理，请勿修改）
    ├── skills/                           # Skill 仓库（git clone，平台统一升级，只读）
    └── hooks/                            # 自定义 hooks
```

## 文件管理规则

| 类型 | 存放位置 |
|------|---------|
| 日常工作 | `workspace/YYMMDD/`，配 README.md 记录进展，跨日任务沿用起始日目录 |
| 一次性脚本 | 所属工作目录内，不散落根目录 |
| 知识沉淀 | `wiki/{topic}/` |
| 根目录 | 零污染：不允许留下临时文件、中间产物 |

## Git

本目录是一个 Git 仓库，远端为 `git.ablemind.cc/__USERNAME__/workspace`（私有）。阶段性成果请提交并 push，作为版本史与备份。`.gitignore` 已排除中间数据与大产物。

## 记忆

Claude Code 的跨会话记忆由运行时自动管理（位于 `~/.claude/projects/` 下），随平台持久化，无需手动维护目录。

## 模型与密钥

模型配置（`ANTHROPIC_*`）由平台写入 `~/.claude/settings.json`，可在 flow.ablemind.cc 的设置页查看与修改，不要写进本目录的任何文件。