Document repository delivery standards

.env.example

@@ -32,6 +32,8 @@ ARK_CODING_BASE_URL=https://ark.cn-beijing.volces.com/api/coding/v3
 # - DIRECT_URL：迁移(pnpm db:migrate)用「直连」(端口 5432)——池化连接不适合跑 DDL。
 DATABASE_URL=postgres://postgres.xxxx:password@aws-0-region.pooler.supabase.com:6543/postgres
 DIRECT_URL=postgres://postgres.xxxx:password@aws-0-region.pooler.supabase.com:5432/postgres
+# 测试只允许连接物理隔离的 thread-chat-test 数据库；测试 Drizzle 配置不会回退到 DATABASE_URL。
+TEST_DATABASE_URL=postgres://postgres:postgres@localhost:5432/thread-chat-test
 # 可选：每实例连接数上限（Serverless + 池化下宜小）；直连想启用预处理语句设 DB_PREPARE=true。
 # DB_POOL_MAX=10
 # DB_PREPARE=false

.gitignore

@@ -40,3 +40,5 @@ next-env.d.ts
 # thread-chat e2e 验收脚本的截图输出
 e2e/thread-chat/shots/
 .vercel
+
+.local-backups

AGENTS.md

@@ -15,3 +15,30 @@ project-wide instructions. `CLAUDE.md` is the single source of truth for shared
 development commands, workflow rules, architecture, and implementation notes.
 
 If an instruction in this file conflicts with `CLAUDE.md`, follow this file.
+
+## 交付物卫生规则
+
+### 注释
+
+- 注释只写「从代码本身看不出来的为什么」（non-obvious why）
+- 禁止出现：修改历史、曾经的做法、"原本/之前/改为"、本次对话中讨论过的内容
+- 不为「没有做的东西」写注释或测试，
+  唯一例外：该空缺会被后来者误认为 bug 并试图"修复"时，
+  才允许一句话说明这是有意的（intentionally absent）
+
+### PR / Commit
+
+- 标题与描述只描述最终行为：这个 diff 让系统变成了什么
+- 禁止出现：被否决的方案、中间尝试、「应要求移除了 X」之类的痕迹
+- 用户的反馈已经体现在 diff 里，不需要文字复述
+
+### 文档 / UI 文案
+
+- 只服务产品和读者，禁止写入思考过程、实现理由、调试记录、下一步计划
+- 内容只保留最终状态，不带讨论痕迹
+
+### 提交前自检（每行新增文本都要过一遍）
+
+问：「一个从没看过这场对话的工程师，只看最终代码，
+这行文字还提供增量信息吗？」
+答「否」→ 删掉。

CLAUDE.md

@@ -6,6 +6,8 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 所有输出内容必须使用中文（代码、文件路径、命令等技术内容除外）。
 
+面向用户解释架构或状态变化时，这类从后端状态转换为前端显示状态的过程统一称为“状态映射”，不要使用晦涩的同义术语。
+
 ## Commands
 
 Package manager is **pnpm** (pnpm-lock.yaml / pnpm-workspace.yaml).