spec-map 的用途是分析代码库，生成技术栈、架构、功能与横切关注点四类文档。工作流分三阶段：先根据参数确定焦点区域并生成含 4 个 mapper 任务的 tasks.csv；然后单波并行执行四个 mapper（技术栈、架构、功能、横切关注点），共享 discoveries.ndjson 避免重复探索；最后由编排器把各 agent findings 写入 .workflow/codebase/ 下 tech-stack.md、architecture.md、features.md、concerns.md，并生成 context.md 摘要与完成报告。
用法示例：$spec-map ""、$spec-map "auth"、$spec-map -c 4 "api layer"、$spec-map --continue "20260318-map-auth"。标志：-y/--yes 跳过确认；-c/--concurrency N 设置最大并发（默认 4）；--continue 恢复会话。会话 ID 形如 {YYYYMMDD}-map-{focusArea}。
限制：所有文件写入必须限定在 .workflow/codebase/ 与 .workflow/.csv-wave/{sessionId}/，不修改源码；worker 只读，不写 output 文件；mapper 超时或失败时标记失败并保留部分结果，全部失败则进入降级状态输出仅含表头的空文件并报 E004；spawn_agents_on_csv 连续失败两次则以 E003 中止。若 .workflow/codebase/ 已存在，提示 refresh/skip/merge，-y 时自动 refresh。