[!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