用途：这是 vigiles CLI 仓库贡献者专用的开发流程，通过让工具在自身和真实插件上运行来发现真实缺陷，并直接修复而非提交 issue。不适用于单个已知 bug（直接修即可），也不适用于已发布的消费者功能（.claude/ 不对外发布）。
主要能力与流程：循环为「并行专家 fan out → 汇总并逐条验证 → 直接修复 → 回归测试 → 构建 → 定向测试 → 按主题提交 → 全量测试 → push」。fan out 时按互不重叠的功能面分工，例如 compile/eject 往返正确性、audit/lint 误报、init/scaffold 边界情况、配置解析、CLI 错误 UX、跨 harness 与浏览器/磁盘一致性。要求每个代理把缺陷源码追溯到 file:line 并给出修复建议；无追溯的只能算线索。
使用方式：代理会过度上报，需自行在临时 fixture 或 test/dogfood/* 插件上复现，丢弃无法复现项并确认精确位置。每个修复按「复现 → 修复 → 回归测试 → npm run build → 定向 vitest → 提交」执行，一次提交一个主题，使用 Conventional Commit 主题行，正文末尾加 Co-Authored-By 尾注，禁止会话 URL 或原始模型 id。
限制与纪律：修改共享文件（如 src/cli.ts、src/scan-core.ts）需串行或使用独立 git worktree；声明完成前必须跑全量测试；每次改源码后必须重新构建，因为 e2e 跑的是 dist/cli.js；扫描检测器改动须保持 scanFiles 与 scanPlugin 字节一致；提交前跑 Prettier 与 fmt:check；覆盖率门禁为白名单。资料还强调两类反复出现的缺陷：对外部契约的未验证假设（应解析而非校验边界，并加形状单元断言）和不完整修复（应 grep 同类调用点，收敛到单一入口使非法状态不可表示）。