用途：在 ~/Code/badlogic/pi-mono 中工作时，规范向上游提交 issue、PR 与讨论的流程，避免把半成品报告发给维护者。
主要能力：判断失败属于 pi 核心、provider 适配器、扩展还是本地补丁；指导收集证据包（一句话问题、复现步骤、provider/model、扩展状态、干净构建 vs 打补丁构建、期望与实际结果、最小日志、假设的边界、包归属）；提供包分诊启发式（packages/ai 负责 provider 适配与流式归一化，packages/agent 负责 agent 循环与工具执行，packages/coding-agent 负责交互模式与会话持久化，本地扩展/joelclaw 运行时归本地）。
必要用法：先读本地克隆中的 CONTRIBUTING.md 与 AGENTS.md；首次贡献者先开 issue 等维护者 lgtm 再开 PR；用干净 worktree 复现（git fetch origin、git worktree add /tmp/pi-mono-main origin/main、npm install）；代码改动后运行 npm run check，不要跑仓库整体 npm test，只跑相关包的定向测试；读 issue 用 gh issue view <number> --json title,body,comments,labels,state；评论前先写临时文件预览。
限制：若失败只出现在本地构建、全局补丁安装、启用扩展或带本地插桩的分支，需明确说明并继续本地调试；无法回答“哪个 provider/model 触发”就不应开 issue；维护者已给 workaround 后重复提交 AI 生成内容可能被封禁；PR 需先获 issue 批准。