space-concept-board

# Space Concept Board Pipeline

An agent team collaborates to generate style analysis, moodboard, color palette, furniture/accessory list, budget sheet, and shopping guide all at once.

## Execution Mode

**Agent Team** — 5 agents communicate directly via SendMessage and cross-verify each other's work.

## Agent Composition

| Agent | File | Role | Type |
|-------|------|------|------|
| style-analyst | `.claude/agents/style-analyst.md` | Space assessment, style diagnosis, reference collection | general-purpose |
| moodboard-designer | `.claude/agents/moodboard-designer.md` | Color palette, texture, material composition | general-purpose |
| item-curator | `.claude/agents/item-curator.md` | Furniture/accessory selection, layout proposals, vendor research | general-purpose |
| budget-manager | `.claude/agents/budget-manager.md` | Price research, budget sheet, shopping guide | general-purpose |
| concept-reviewer | `.claude/agents/concept-reviewer.md` | Cross-verification, consistency checks | general-purpose |

## Workflow

### Phase 1: Preparation (Orchestrator performs directly)

1. Extract from user input:
    - **Space information**: Type (living room/bedroom/study/studio), area, structure
    - **Style preference** (optional): Preferred styles, reference images
    - **Budget** (optional): Total budget range
    - **Constraints** (optional): Rental/owned, renovation scope, pets/children
    - **Existing files** (optional): User-provided moodboard, furniture list, etc.
2. Create a `_workspace/` directory at the project root
3. Organize inputs and save to `_workspace/00_input.md`
4. If existing files are provided, copy them to `_workspace/` and skip the corresponding phase
5. Determine the **execution mode** based on the scope of the request (see "Modes by Request Scale" below)

### Phase 2: Team Assembly and Execution

| Order | Task | Owner | Dependencies | Deliverable |
|-------|------|-------|-------------|-------------|
| 1 | Style analysis | analyst | None | `_workspace/01_style_analysis.md` |
| 2 | Moodboard design | designer | Task 1 | `_workspace/02_moodboard.md` |
| 3 | Item curation | curator | Tasks 1, 2 | `_workspace/03_item_list.md` |
| 4 | Budget/shopping guide | budget | Tasks 1, 2, 3 | `_workspace/04_budget_shopping.md` |
| 5 | Concept review | reviewer | Tasks 1-4 | `_workspace/05_review_report.md` |

**Inter-team communication flow:**
- analyst complete -> Deliver recommended styles and references to designer, spatial conditions and constraints to curator, budget range and rental status to budget
- designer complete -> Deliver color palette and material board to curator, recommended materials and brands to budget
- curator complete -> Deliver full item list and price ranges to budget
- reviewer cross-verifies all deliverables. If critical issues are found, request revision from the relevant agent -> rework -> re-verify (up to 2 rounds)

### Phase 3: Integration and Final Deliverables

1. Verify all files in `_workspace/`
2. Confirm all critical issues from the review report have been addressed
3. Report the final summary to the user:
    - Style analysis — `01_style_analysis.md`
    - Moodboard + color palette — `02_moodboard.md`
    - Furniture/accessory list — `03_item_list.md`
    - Budget sheet + shopping guide — `04_budget_shopping.md`
    - Review report — `05_review_report.md`

## Modes by Request Scale

| User Request Pattern | Execution Mode | Agents Deployed |
|---------------------|----------------|-----------------|
| "Design the full interior concept" | **Full Pipeline** | All 5 agents |
| "Just create a moodboard" | **Moodboard Mode** | analyst + designer + reviewer |
| "Recommend furniture" (style provided) | **Item Mode** | curator + budget + reviewer |
| "Plan my interior budget" (list provided) | **Budget Mode** | budget + reviewer |
| "Review this concept board" | **Review Mode** | reviewer only |

**Existing file usage**: When the user provides a moodboard, item list, etc., copy the file to the appropriate numbered position in `_workspace/` and skip that stage's agent.

## Data Transfer Protocol

| Strategy | Method | Purpose |
|----------|--------|---------|
| File-based | `_workspace/` directory | Store and share major deliverables |
| Message-based | SendMessage | Real-time key information transfer, revision requests |
| Task-based | TaskCreate/TaskUpdate | Progress tracking, dependency management |

File naming convention: `{sequence}_{agent}_{deliverable}.{extension}`

## Error Handling

| Error Type | Strategy |
|-----------|----------|
| Insufficient space information | Apply standard apartment (84 sq m) defaults, note "estimated" in the report |
| Web search failure | Work from general interior knowledge, note "data limitations" |
| Budget not specified | Suggest average budgets by space type, then proceed |
| Agent failure | Retry once -> If still failing, proceed without that deliverable, note the gap in the review report |
| Critical issue found in review | Request revision from the relevant agent -> rework -> re-verify (up to 2 rounds) |

## Test Scenarios

### Normal Flow
**Prompt**: "I want to decorate my 900 sq ft apartment living room in Scandinavian style. My budget is $5,000."
**Expected Results**:
- Style analysis: Scandinavian core elements + living room conditions applied
- Moodboard: White/light gray centered color palette + natural wood and linen materials
- Items: 15-20 products including sofa, table, lighting, rug + size verification
- Budget: Allocation within $5,000 + 3-phase purchase priorities
- Review: All items in consistency matrix verified

### Existing File Flow
**Prompt**: "Recommend furniture that matches this moodboard" + moodboard file attached
**Expected Results**:
- Existing moodboard copied to `_workspace/02_moodboard.md`
- Item mode: curator + budget + reviewer deployed
- analyst, designer are skipped

### Error Flow
**Prompt**: "I want to make my room look nice but I don't know where to start"
**Expected Results**:
- Insufficient space information -> analyst asks about space type/area or applies defaults
- No style preference -> analyst proposes 3 contrasting styles
- No budget specified -> budget presents average budgets by space type

## Agent Extension Skills

| Agent | Extension Skill | Purpose |
|-------|----------------|---------|
| moodboard-designer, style-analyst | `color-harmony-engine` | Color theory, palette formulas, style-specific palette database |
| item-curator, style-analyst | `spatial-layout-guide` | Furniture placement rules, dimension standards, traffic flow design |