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 |
| 发布兼容性承诺 | 发布策略 |
| 可运行服务导览 | 参考应用 |