[!info] related notes

• 所属 MOC: AI MOC
• 前置概念: Karpathy Guidelines Skill
• 并列概念: Deep Module
• 易混淆概念: Design It Twice
• 关系笔记: Matt Pocock Skills 与 Karpathy Guidelines 的区别

Simplicity First

一句话定义

只为当前真实问题写必要的代码，不提前为未来假想场景引入抽象、配置和扩展点。

核心机制 / 工作原理

AI 很容易把“最佳实践”误用成“提前复杂化”。这个原则通过压制投机式设计，让复杂度只在真实需求到来后再增长。

最小例子 / 最小场景

需求只是“添加一个计算折扣的函数”时，先写 calculate_discount(amount, percent)，而不是一上来设计策略模式和多种 calculator class。

边界与易混淆点

• 不是反对架构，而是反对过早架构
• 当前需求确实需要多变场景时，才评估相应抽象
• 最少代码不是唯一目标；输入校验、错误处理和必要测试不能因“简洁”被省略

Related notes

• AI MOC
• Agent MOC
• Coding Agent MOC
• Goal-Driven Execution