跳转到内容

仓库边界

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

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

docs -> 解释意图和学习路径
specs -> 定义机器可读边界
tasks -> 约束执行范围和验证
code -> 实现已经分类清楚的行为
问题 事实来源 示例文件
面向人的预期路径是什么? Docs website/src/content/docsdocs/reference/canonical-style-guide.md
某类工作由哪个模块负责? Specs specs/task-routing.yamlspecs/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
仓库规则、边界或执行顺序 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 reference package docs 和模块 primer
跳过 module.yaml 的理由 被触达模块的 module.yaml
发布兼容性承诺 发布策略
可运行服务导览 参考应用