Plumego 不只是一些 Go 包。它还有一层控制面,用来告诉人和 agent 在改代码前如何先完成工作分类。
如果问题仍是服务如何组装,请先读参考应用。当问题变成归属判断时,再使用这一页。
| 问题 |
事实来源 |
示例文件 |
| 面向人的预期路径是什么? |
Docs |
website/src/content/docs、docs/reference/canonical-style-guide.md |
| 某类工作由哪个模块负责? |
Specs |
specs/task-routing.yaml、specs/extension-taxonomy.yaml |
| 哪些 import 关系被允许? |
Specs |
specs/dependency-rules.yaml |
| milestone 的范围是什么? |
Tasks |
tasks/milestones/active/M-NNN-short-name/M-NNN.md |
| 可运行服务应该从哪里复制结构? |
Reference app |
reference/standard-service |
| 某个包本地承诺什么? |
Module manifest |
目标 <module>/module.yaml |
| 工作类型 |
先从这里开始 |
再检查 |
| 内核、生命周期、route attachment |
稳定根 primer |
目标模块 module.yaml |
| Transport contract、错误模型、响应形态 |
contract primer |
调用点和 docs snippet |
| 可选能力、协议、租户、网关、数据或观测工作 |
对应 x/* 家族 |
发布策略和扩展成熟度 |
| 应用本地启动或 wiring |
reference/standard-service |
服务本地测试和 route map |
| 仓库规则、边界或执行顺序 |
docs、specs 或 tasks |
对应 checker 或 milestone 验收条件 |
| 步骤 |
检查项 |
| 1 |
行为归哪个 稳定根 或 x/* 家族负责? |
| 2 |
哪个 docs 页面解释预期路径? |
| 3 |
哪个 spec 约束 routing、taxonomy 或 dependency? |
| 4 |
哪个 module.yaml 定义本地 scope 和 checks? |
| 5 |
如果是 milestone 工作,哪个 task card 或 milestone 定义 done? |
| 不是 |
应该看 |
| package 级 API reference |
package docs 和模块 primer |
跳过 module.yaml 的理由 |
被触达模块的 module.yaml |
| 发布兼容性承诺 |
发布策略 |
| 可运行服务导览 |
参考应用 |