跳转到内容

仓库边界

Plumego 不只是一些 Go 包。它还有一层控制面,用来告诉人和 agent 在改代码前如何先完成工作分类。

如果问题仍是服务如何组装,请先读参考应用。当问题变成归属判断时,再使用这一页。

docs -> 解释意图和学习路径
specs -> 定义机器可读边界
tasks -> 约束执行范围和验证
code -> 实现已经分类清楚的行为
问题事实来源示例文件
面向人的预期路径是什么?Docswebsite/src/content/docsdocs/reference/canonical-style-guide.md
某类工作由哪个模块负责?Specsspecs/task-routing.yamlspecs/extension-taxonomy.yaml
哪些 import 关系被允许?Specsspecs/dependency-rules.yaml
milestone 的范围是什么?Taskstasks/milestones/active/M-NNN-short-name/M-NNN.md
可运行服务应该从哪里复制结构?Reference appreference/standard-service
某个包本地承诺什么?Module manifest目标 <module>/module.yaml
工作类型先从这里开始再检查
内核、生命周期、route attachment稳定根 primer目标模块 module.yaml
Transport contract、错误模型、响应形态contract primer调用点和 docs snippet
可选能力、协议、租户、网关、数据或观测工作对应 x/* 家族发布策略和扩展成熟度
应用本地启动或 wiringreference/standard-service服务本地测试和 route map
仓库规则、边界或执行顺序docsspecstasks对应 checker 或 milestone 验收条件
步骤检查项
1行为归哪个 稳定根 或 x/* 家族负责?
2哪个 docs 页面解释预期路径?
3哪个 spec 约束 routing、taxonomy 或 dependency?
4哪个 module.yaml 定义本地 scope 和 checks?
5如果是 milestone 工作,哪个 task card 或 milestone 定义 done?
不是应该看
package 级 API referencepackage docs 和模块 primer
跳过 module.yaml 的理由被触达模块的 module.yaml
发布兼容性承诺发布策略
可运行服务导览参考应用