Cronicorn

applyTo: apps/web/**

**示例**：
- `10-ui-development.md` - 僅在`apps/web/**`目錄下工作時生效。
- `11-playwright-auth.md` - 僅在`apps/e2e/**`目錄下工作時生效。
這樣可減少認知負擔，僅顯示當前上下文相關的規則。

### 配置文件
#### settings.json
定義權限和鉤子：
**權限**：
- **允許**：安全的開發命令（`pnpm test`、`pnpm build`、`git status`）
- **禁止**：危險操作（`rm -rf`、強制推送、`.env`讀取）
- **保護**：鎖定文件、遷移腳本、CI工作流

**鉤子**：
- **工具使用後**：使用`pnpm lint:fix`在編輯/寫入後自動格式化TypeScript文件

#### CLAUDE.md
每次會話加載的項目記憶文件，包含：
- 項目概述和技術棧
- 單倉庫結構（8個應用 + 15個包）
- 常用命令和工作流
- 關鍵位置和約定
- 架構總結
該文件提供持久化上下文，讓Claude理解項目結構。

#### rules/*.md
按主題組織的模塊化規則。每個規則文件保持在約300行以內，專注於特定方面：
**核心規則（00 - 09）**：
- `00-core-principles.md` - YAGNI原則、簡單解決方案、垂直切片
- `01-hexagonal-architecture.md` - 端口與適配器、決策矩陣
- `02-testing-strategy.md` - 每個測試一個事務模式
- `03-typescript-esm.md` - ESM標準、項目引用
- `04-code-quality.md` - ESLint規則、文件命名

**應用特定規則（10 - 19）**：
- `10-ui-development.md` - TanStack Start + shadcn/ui（作用域：`apps/web/**`）
- `11-playwright-auth.md` - 認證優先的端到端測試（作用域：`apps/e2e/**`）

**流程規則（20 - 29）**：
- `20-adr-process.md` - ADR創建和任務ID
- `21-tech-debt-logging.md` - 強制記錄技術債

**工具規則（30 - 39）**：
- `30-git-workflow.md` - 常規提交、質量檢查

### 如何更新規則
#### 添加新規則
1. 選擇合適的編號範圍（00 - 09、10 - 19等）
2. 在`.claude/rules/`目錄下創建新的`.md`文件
3. 若需要路徑作用域，添加前置元數據：
   ```markdown
   ---
   applyTo: packages/domain/**
   ---