用途：为 Maestro 工作流任务提供贯穿全程的知识伴随记录，覆盖任务前、中、后三个阶段，并将可复用经验沉淀为规范与知识。
四种模式：before 任务前加载 spec 与 knowhow 索引及代码库索引，创建伴随文档；note 任务中向当前伴随文档追加结构化条目；after 任务后复盘伴随文档，将条目提升为 spec/knowhow 并建议下一步；route 根据意图推荐下一步技能或命令。无参数时自动检测：有未提交变更则倾向 after，否则倾向 before，但不会因工作区脏而自动进入 after。
主要能力：支持 --task、--type、--category 参数；任务类型包括 implement、debug、analyze、design、plan、review、test、refactor、learn、general，决定记录模板；note 条目会自动分类为 decision、spec-candidate、pitfall、insight、hypothesis、evidence、risk、todo、question、blocker、note，并交叉写入对应上下文表格。
使用方式示例：$maestro-companion；$maestro-companion "before --task 'implement auth module' --type implement"；$maestro-companion "note 'decided to use bcrypt over argon2'"；$maestro-companion "after"；$maestro-companion "route what should I do next"。
写入边界：文件写入仅限 .workflow/.scratchpad/，提升操作交由 spec-add / manage-knowhow-capture 技能，绝不修改源码或 .workflow/state.json。限制：依赖 Maestro 工作流目录结构；spec 或代码库索引缺失时仅给出提示建议，不自行创建。