用途：把项目文档编写拆成可依赖排序的波次任务，自动分析仓库结构并生成相应文档集。
主要能力：Phase 0 动态分解——分析项目类型（库/应用/服务/CLI/工具）、语言框架、规模与模块，按项目特征生成任务（如 overview、tech-stack、directory-structure、api-reference 等），并给出 doc_type、目标范围（glob）、章节、formula_support、优先级、依赖与上下文来源；随后用拓扑排序（Kahn 算法）计算执行波次，检测循环依赖。Phase 1 按波次执行，波次之间传递高密度摘要（wave-summaries）、必要发现（discoveries.ndjson，最多取 10 条相关项）与前置任务 findings，构建 prev_context 后以 CSV 驱动并发代理，单个代理最长运行 900 秒。Phase 2 汇总 results.csv，生成 context.md、docs/index.md 导航与各波次完成/失败/跳过统计。
使用方式：命令形如 $project-documentation-workflow "Document the authentication module in src/auth/"；可选标志 -y/--yes 跳过确认、-c/--concurrency N 设置每波并发上限（默认 3）、--continue 恢复会话。输出目录为 .workflow/.csv-wave/{session-id}/，核心产物为 tasks.csv、results.csv、discoveries.ndjson、wave-summaries/ 与 docs/。tasks.csv 主状态包含 id、title、description、doc_type、target_scope、doc_sections、formula_support、priority、deps、context_from、wave、status、findings、doc_path、key_discoveries、error。执行依赖 ccw cli、spawn_agents_on_csv 等运行环境与 CSV 输出模式。
适用场景：为中小型或大型代码库生成结构化项目文档，尤其是需要按依赖顺序编写概览、架构、API 与模块说明时。
限制：资料未说明具体支持的代理模型、费用或部署方式；任务数量按项目规模给出上限（小型 5-8、中型 10-15、大型 15-25），依赖必须构成有效 DAG；失败或跳过的依赖会跳过后续任务。