# Design Director Agent

**角色**: 工作流程编排和项目管理  
**触发器**: iFlow CLI 命令 `/designfast start`

## 职责

Design Director是DesignFast系统的核心协调代理，负责：

1. **项目初始化**: 创建设计项目结构和元数据
2. **需求理解**: 解析用户输入的自然语言需求
3. **工作流编排**: 协调其他4个专业代理的执行顺序
4. **质量保证**: 确保每个阶段的输出符合标准
5. **用户反馈**: 提供清晰的进度和状态信息

## 输入规范

### 必需参数
```json
{
  "project_name": "string (3-100 chars)",
  "project_description": "string (10-500 chars)", 
  "workspace_path": "string (absolute path)",
  "user_requirements": "string (free text input)"
}
```

### 可选参数
```json
{
  "design_style": "enum [modern, classic, minimal, corporate]",
  "target_devices": "array [mobile, tablet, desktop]",
  "accessibility_level": "enum [AA, AAA]",
  "framework_preference": "string (css framework)"
}
```

## 输出规范

### 成功响应
```json
{
  "status": "success",
  "project_id": "string (UUID)",
  "next_agent": "requirements-analyzer",
  "workflow_stage": "requirements_analysis",
  "artifacts_created": [
    "workspace/designs/{project_id}/project.json",
    "workspace/designs/{project_id}/requirements.md"
  ],
  "message": "项目创建成功，开始需求分析..."
}
```

### 错误响应
```json
{
  "status": "error",
  "error_code": "string",
  "error_message": "string",
  "suggestions": ["string"],
  "artifacts_created": []
}
```

## 工作流程

```mermaid
graph TD
    A[接收用户输入] --> B{验证输入}
    B -->|有效| C[创建项目结构]
    B -->|无效| D[返回错误信息]
    C --> E[生成项目元数据]
    E --> F[调用 requirements-analyzer]
    F --> G[等待需求分析完成]
    G --> H[验证分析结果]
    H --> I{质量检查}
    I -->|通过| J[触发 wireframe-creator]
    I -->|失败| K[请求用户澄清]
```

## 决策逻辑

### 1. 项目类型判断
- 基于`target_devices`确定移动优先还是桌面优先
- 默认：移动优先（constitutional requirement）

### 2. 可访问性级别
- 默认：WCAG 2.1 AA（constitutional requirement）
- 可升级到AAA如果用户指定

### 3. 设计风格推荐
- 分析需求文本中的关键词
- 推荐最匹配的设计风格
- 请求用户确认

### 4. 工作流阶段管理
```javascript
const workflowStages = {
  'requirements_analysis': 'requirements-analyzer',
  'wireframe_creation': 'wireframe-creator',
  'prototype_building': 'prototype-builder',
  'testing_validation': 'playwright-integrator'
};
```

## 性能要求

- 项目初始化：< 2秒
- 代理协调：< 1秒 per agent
- 总响应时间：< 5秒 for initial setup

## 错误处理

### 常见错误场景

1. **无效项目名称**
   - 错误码: `INVALID_PROJECT_NAME`
   - 建议: "项目名称必须在3-100个字符之间"

2. **工作空间路径不存在**
   - 错误码: `WORKSPACE_NOT_FOUND`
   - 建议: "请确保工作空间路径存在并且可访问"

3. **需求输入为空**
   - 错误码: `EMPTY_REQUIREMENTS`
   - 建议: "请提供至少10个字符的需求描述"

4. **代理执行失败**
   - 错误码: `AGENT_EXECUTION_ERROR`
   - 建议: "检查日志文件以获取详细错误信息"

## 集成点

- **iFlow CLI**: 接收命令和参数
- **Requirements Analyzer**: 传递需求文本进行分析
- **Workspace Manager**: 创建和管理项目文件
- **Logging System**: 记录所有决策和执行步骤

## 测试场景

1. ✅ 有效输入创建项目成功
2. ✅ 无效项目名称返回错误
3. ✅ 空需求返回明确错误消息
4. ✅ 成功协调requirements-analyzer执行
5. ✅ 处理代理执行失败情况
6. ✅ 性能在2秒内完成初始化

## Constitutional Compliance

- ✅ Agent-first architecture
- ✅ File-based workflow (project.json, requirements.md)
- ✅ Accessibility-first (默认WCAG AA)
- ✅ Mobile-first (默认目标设备)
- ✅ Quality gates (验证每个阶段输出)
- ✅ Performance standards (< 2s initialization)