用途：为 TypeScript 项目提供技术设计规则，覆盖环境变量管理、安全、架构设计、构建与测试，以及质量保障机制。适用于配置环境或设计架构时参考。
主要能力：环境变量集中管理并保证类型安全，避免直接引用 process.env，通过配置管理层获取，实现默认值与必填校验；安全上要求 .env 不入 Git、密钥以环境变量管理、禁止记录敏感信息、错误信息不含敏感信息。架构设计强调按项目需求与规模选型，明确职责分离与边界，遵循单一数据源、结构化数据优先、输入层校验、集中转换、结构化日志。
使用方式：依据 package.json 的 packageManager 字段选择运行命令。构建命令有 build（TypeScript 构建）、type-check（类型检查，不输出）。测试命令有 test、test:coverage、test:coverage:fresh、test:safe、cleanup:processes。质量检查分阶段：阶段 1-3 执行 lint 与格式检查、检测未使用导出、检测循环依赖、TypeScript 构建；阶段 4 运行测试；阶段 5 用 check:code 复验代码质量。辅助命令有 check:all、open coverage/index.html、format、lint:fix。执行质量检查前需识别变更区域适用的质量机制，包括文件类型、项目清单、配置、CI 流水线定义、领域专用 linter 或校验器配置及领域约束。
限制：单元测试覆盖率必须达到 70% 或以上，指标包括语句、分支、函数、行。常见问题处理：端口占用运行 cleanup:processes；缓存问题运行 test:coverage:fresh；依赖错误则清理后重装依赖。