# Modra 使用约定（复制到你项目的 AGENTS.md / CLAUDE.md / .cursor/rules）

本项目使用 Modra 设计系统（站点：https://modra.feinian.net）。生成或修改 UI 代码时：

1. 先阅读 https://modra.feinian.net/ai/integration-guide.md，按其中「AI 接入流程」执行。
2. 使用任何组件前，先读取 https://modra.feinian.net/ai/components/<slug>.md 确认导出与 props，**禁止臆造 prop**。
3. 组件统一从 `@modra/react` 根入口导入；样式使用语义类（`bg-primary`、`text-muted-foreground`…），不硬编码颜色，不手写 `dark:` 颜色。
4. 使用逻辑属性类（`ps-/pe-/ms-/me-`）而非 `pl-/pr-/ml-/mr-`。
5. 用到 `DataTable`、`Form`、`Command`、日期类组件时，确认已安装对应 peer 依赖。
6. 新增依赖走内网 registry：`--registry https://npm.feinian.net/`，认证读取环境变量 `NPM_TOKEN`；缺少 token 时停下来询问用户，不要提交 token。
7. 完整索引：https://modra.feinian.net/llms.txt；全文：https://modra.feinian.net/llms-full.txt。
8. 已接入 MCP 时优先使用：`claude mcp add --transport http modra https://modra.feinian.net/mcp`（工具：`get_integration_guide`、`list_components`、`get_component`、`search_components`、`get_design_tokens`、`get_agents_md`）。