code-that-fits-in-your-head

用途：这是一套面向可持续软件的工程启发式集合，源自 Mark Seemann 2021 年著作，并附有明确标注的“智能体时代”补充内容。适用于编写、评审、调试、排查、安全审查或搭建项目等任务，帮助人在智能体大量产出代码后仍能理解、运维与扩展系统。\n\n主要能力：内容按章节组织，覆盖基础理念（可持续性、可读性、复杂度控制、代码即负债）、代码库搭建（git、构建自动化、警告视为错误）、由外向内 TDD、封装（不变量、DTO 与领域模型、parse-don't-validate）、分解（圈复杂度、内聚耦合）、API 设计（CQS、命名优先于注释）、关注点分离（装饰器、日志）、团队与 git、演进（特性开关、Strangler、版本管理）、故障排查（科学方法、二分法）、安全（STRIDE 威胁建模）、代码导航与工具度量（复杂度、循环、重复、死代码、变异测试）及实践术语表。\n\n使用方式：先识别任务类型，阅读 guidelines.md 将任务与症状映射到具体参考文件，再按“渐进披露”只加载当前任务相关的文件并应用规则；存疑时查阅 practices-glossary。若某规则在仓库中反复有用，可通过 workflows/operationalize-finding.md 将其固化为门禁并写入项目智能体指令。还提供评审代码、新增特性、修复缺陷、威胁建模等组合工作流。\n\n限制：agent-native 目录是编者补充，不属于原书内容，不应归功于 Seemann；原文未提供具体价格、平台或效果数据；代码示例以 C# 为主，规则本身语言中立。分类：编程与开发。