Files
Nexus/docs/changelog/2026-05-22-implementation-standards-rule.md
T
Your Name aa65f10c52 docs: Phase 2 audit records, project memory, WSL guide
Audit docs:
- docs/reports/audit-phase-2{a-j}-line-walk.md: per-file line walk findings
- docs/reports/audit-phase-2-findings-matrix.md: 63 findings (52 fixed, 3 partial, 7 accepted)
- docs/reports/2026-05-23-full-audit-report.md: full audit consolidation
- docs/reports/audit-full-vs-phase2-reconciliation.md: cross-reference
- docs/reports/audit-phase-2-walk-closure.md: closure sign-off

Project docs:
- docs/project/phase-2-audit-remediation.md: SSOT for all fixes
- docs/project/alert-push-policy.md: dashboard alert design decisions
- docs/project/production-verification-checklist.md: first-deploy checklist
- docs/project/script-execution.md: script platform design
- docs/project/wsl-integration-test.md: WSL code-only verification guide
- docs/project/line-walk-audit-standard.md: audit methodology
- docs/project/mysql-mcp-setup.md: MCP config guide

Changelogs: 18 entries (2026-05-22 to 2026-05-23)
Project memory: CLAUDE.md, AGENTS.md updated to reflect current state
Deploy: nginx_https.conf template updated

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-23 15:27:40 +08:00

1.5 KiB
Raw Blame History

Changelog — 完美实现与文档纪律全局规则

日期: 2026-05-22
类型: 流程 / 规范
动机: 将「完美实现、禁止降级/妥协/技术债、文档先行、每次修改留 changelog」固化为项目全局约束,供 Cursor 与所有 Agent 会话强制执行。

变更摘要

  1. 新增 Cursor 全局规则 .cursor/rules/perfect-implementation.mdcalwaysApply: true
  2. CLAUDE.mdAGENTS.md 增加「实现原则」章节,与规则文件交叉引用
  3. 明确文档路径与执行顺序:设计文档 → 技术文档 → 实现 → changelog

涉及文件

文件 操作
.cursor/rules/perfect-implementation.mdc 新增
CLAUDE.md 增补实现原则与文档纪律
AGENTS.md 增补实现原则表格
docs/changelog/2026-05-22-implementation-standards-rule.md 新增(本文件)

规则要点

  • 禁止:为实现而实现、降级实现、妥协实现、留技术债
  • 无法完美实现:必须停下与用户沟通后才能换方案
  • 设计前:docs/design/specs/YYYY-MM-DD-*-design.md
  • 开发前:docs/design/plans/docs/reports/ 技术文档;缺文档模块改动时补全
  • 每次修改:docs/changelog/YYYY-MM-DD-*.md

验证

  • .cursor/rules/perfect-implementation.mdc 存在且 alwaysApply: true
  • CLAUDE.md / AGENTS.md 已同步
  • 主仓库 Nexus/CLAUDE.md 若与 worktree 分叉,合并时需同步本节

部署/迁移

无需重启服务;规则在下次 Cursor 会话中自动生效。