用途:原型是回答问题的废弃代码,问题决定形状。用于在承诺实现前充实设计,例如健全性检查数据模型或状态机、模拟 UI、探索设计选项。
分支选择:若问题是“这个逻辑/状态模型感觉对吗”,走 LOGIC 分支,构建小型交互式终端应用,把状态机推入难以纸上推理的案例;若问题是“这应该看起来像什么”,走 UI 分支,在单个路由上生成几个截然不同的 UI 变体,通过 URL 搜索参数和浮动底部栏切换。若问题模糊且无法联系用户,默认选择与周围代码更匹配的分支(后端模块→逻辑;页面或组件→UI),并在原型顶部陈述假设。
通用规则:从第一天起就标记为废弃,放在实际使用位置附近,命名让读者看出是原型而非生产代码;UI 路由遵守项目既有路由约定,不发明新的顶级结构。一个命令即可运行,使用项目现有任务运行器(如 pnpm <name>、python <path>、bun <path>)。默认无持久性,状态存于内存;若问题涉及数据库,用临时 DB 或带清晰“原型——擦除我”名称的本地文件。跳过抛光:无测试、无多余错误处理、无抽象。暴露状态:每次操作后(逻辑)或每次变体切换时(UI)打印或渲染完整相关状态。完成后删除或吸收:删除原型,或将验证过的决策折叠进真实代码,不要让它腐烂在仓库中。
完成后:唯一值得保留的是答案,将其捕获到持久位置(提交消息、ADR、issue 或原型旁的 NOTES.md)并记录它回答的问题;若用户不在,留下占位符以便后续填写裁决。
限制:资料未提供具体安装命令、平台支持、收费或价格信息。