reference-design

用途：围绕一颗 IC 发展出可复用的参考资料级设计，而不是仅生成封装包装。适用于把数据手册、应用笔记或评估设计翻译为 Zener 组件包。\n\n主要能力与规则：先复用后创建，先搜索现有 registry/workspace 包；新工作在 components/<NAME>/ 下，registry 中旧 reference/ 包只作只读示例。.kicad_sym 是元件接口与引脚的权威来源，.zen 中的 API 需与其对齐；.zen 文档字符串是正式设计文档，README 只放用法示例。需关注 pcb build 警告，尤其是 BOM/可采购性警告（如 bom.match_generic）。对不明确的无源件、strap、时序或振荡器细节不得猜测，需证据或停下询问。只模仿强范例，弱/生成式包仅用于引脚查询与起步结构。保留 # pcb:sch 注释并在重命名时同步更新。\n\n使用方式：用 component-search 搜索 registry；缺失时导入 IC，用 pcb doc --package ... 与源码比对。新建用 pcb new package components/<NAME>，已有则演进现有包。文件按 docstring、load/helper、io/config、内部网络、主 IC 与支撑电路、布局元数据排序。构建用 pcb build components/<NAME>，完成用 pcb fmt components/<NAME>。可采购性规则以 registry/.pcb/stdlib/bom/match_generics.zen 为准，接近 house value 的取整需在 docstring 或注释说明理由。\n\n限制：数据手册未明确支撑电路、拓扑仍依赖未决系统选择、元件/符号质量太差、只与现有包微差、或设计漂向通用 breakout 时，应停止或索要证据。命名按功能型 MPN，去掉温度等级、包装、RoHS 等非功能后缀并以 x 替代；不同封装/引脚需建单独包。