| name | project-structure-validator |
| description | 压力测试STRUCT文件，验证模块化分解的可行性。当项目结构确定后使用，确保模块边界清晰。 |
| stage | IMPLEMENTATION_PLANNING |
| level_supported | L1, L2, L3 |
project-structure-validator: 项目结构验证
描述
压力测试project_structure.md中定义的模块化分解方案，验证其在真实场景下的可行性和独立性。
适用场景
- WORKFLOW_STEP_5 Task S5-1: STRUCT验证时，评估分解方案的合理性
- WORKFLOW_STEP_5 Task S5-3: Self-Reflection中定期审视模块边界
- 复杂项目: 模块众多且依赖复杂时
输入
- spec/implementation/project_structure.md（模块定义）
- design/architecture.md（组件依赖）
- goal_breakdown.md（GOAL与模块的映射）
- 当前级别（L1/L2/L3）
输出
- 项目结构验证报告（markdown）
- 模块分解评分（模块数/独立性/清晰度）
- 风险识别：
- 模块间循环依赖
- 模块职责重叠
- 模块边界模糊
- 模块规模不平衡
- 改进建议
执行策略
- 从project_structure.md读取模块定义
- 验证模块的独立性指标：
- 模块数量适当（L1: 3-5, L2: 5-8, L3: 8-12）
- 无循环依赖（依赖图为DAG）
- 职责清晰（无大量协作职责）
- 规模平衡（内部代码行数相近）
- 对照goal_breakdown.md，检查GOAL分配到模块的合理性
- 识别高风险模块（核心/复杂/关键路径）
- 生成验证报告和改进建议
价值
- Architecture: 评估模块设计的质量，及早识别问题
- Tech Lead: 指导模块划分，减少后期大规模重构
- Dev: 清晰的模块边界，便于团队分工
验收标准
- 模块数量适当（不过多不过少）
- 无循环依赖
- 模块职责单一清晰
- 模块规模平衡
- 所有GOAL能清晰分配到模块