用途:在 Engram 仓库中新增包、文件或目录,判断代码归属位置,以及添加测试、模板、资源或文档时使用。
主要放置规则:行为代码应靠近其所属领域,而非靠近恰好调用它的调用方;模板放在 internal/cloud/dashboard/*.templ,生成文件需提交入库;仪表盘样式放在 internal/cloud/dashboard/static/styles.css,除非确实需要新增静态资源;HTTP 处理器放在 server 包中,不放在 store 包;持久化查询放在 store/cloudstore,不放在处理器中。
文件创建规则:新增路由对应 dashboard/server 包中的处理器与测试;新增数据库行为对应 store/cloudstore 代码及聚焦测试;新增 UI 局部或页面对应 templ 组件与生成的 _templ.go;新增贡献指南需在同一次变更中更新 docs/catalog。
反模式:不要在同一文件中混用 SQL、HTML 与传输逻辑;不要为一次性辅助函数创建工具包;不要添加仅增加层次而不消除真实耦合的包分层。