diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a1cae92
--- /dev/null
+++ b/README.md
@@ -0,0 +1,44 @@
+# monitor-ai — 告警监控中心
+
+tlyq.ai 统一基础设施告警监控中心，监控容器/端点健康状态，通过企业微信多 Webhook 推送告警。
+
+## 功能
+
+- 多维度健康检查（HTTP / Docker）
+- 多 Webhook 渠道告警推送（企业微信）
+- 告警去重、冷却机制、级别过滤、免打扰时段、抖动检测
+- OIDC SSO + LDAP 备选 + localadmin 认证
+- RBAC 权限（admin/editor/viewer）
+- 审计日志（所有写操作记录）
+- 暗色/亮色/自动主题切换
+
+## 技术栈
+
+- Next.js 15 App Router（output: standalone）
+- SQLite（execFileSync + sqlite3 CLI）
+- Tailwind CSS v4 + TLYQ 设计系统
+- lucide-react 图标
+
+## 本地开发
+
+```bash
+npm install
+npm run dev          # http://localhost:6181
+```
+
+## 环境变量
+
+见 `.env.example`，本地开发使用 `.env.local`。
+
+## 端口
+
+| 环境 | 端口 |
+|------|------|
+| 本地开发 | 6181 |
+| 生产部署 | 6181 |
+
+## 文档
+
+- 设计方案：`docs/superpowers/specs/2026-06-30-monitor-ai-design.md`
+- 实施计划：`docs/superpowers/plans/2026-06-30-monitor-ai-implementation.md`
+- CLAUDE.md：项目级 AI 指导文档