# AGENTS.md

本仓库是 **Stash UI**：一套独立的设计系统 + 组件库（React + CSS Modules + 设计令牌，零运行时依赖）。

改任何页面或组件之前：

1. 读 [`skills/stash-ui/SKILL.md`](skills/stash-ui/SKILL.md) —— AI 使用入口（任务分流 + 硬约束 + 验证命令）。
2. 需要细节时再读 [`DESIGN.md`](DESIGN.md)、[`docs/COMPONENTS.md`](docs/COMPONENTS.md)、
   [`docs/ADDING-A-COMPONENT.md`](docs/ADDING-A-COMPONENT.md)。

提交前必须通过：

```bash
npm run typecheck && npm run lint && npm run build
```

视觉改动还要截图核对（`scripts/screenshot.mjs`，深浅色各看一次）。