| name | space-concept-board |
| description | 공간 인테리어 컨셉보드를 에이전트 팀이 협업하여 한 번에 생성하는 풀 파이프라인. '인테리어 컨셉 잡아줘', '거실 꾸미고 싶어', '방 분위기 바꾸고 싶어', '인테리어 무드보드', '가구 추천해줘', '공간 스타일링', '컬러팔레트 짜줘', '인테리어 예산', '셀프 인테리어', '홈스타일링', '원룸 인테리어', '사무실 인테리어' 등 공간 꾸미기 전반에 이 스킬을 사용한다. 기존 무드보드가 있는 경우에도 아이템 큐레이션이나 예산 관리를 지원한다. 단, 실제 시공 시행(타일 시공, 전기 배선), 3D 렌더링, AR 가구 배치 앱 연동은 이 스킬의 범위가 아니다. |
Space Concept Board — 공간 인테리어 컨셉보드 파이프라인
공간의 스타일분석→무드보드→컬러팔레트→가구·소품리스트→예산표→쇼핑가이드를 에이전트 팀이 협업하여 한 번에 생성한다.
실행 모드
에이전트 팀 — 5명이 SendMessage로 직접 통신하며 교차 검증한다.
에이전트 구성
| 에이전트 | 파일 | 역할 | 타입 |
|---|
| style-analyst | .claude/agents/style-analyst.md | 공간 파악, 스타일 진단, 레퍼런스 수집 | general-purpose |
| moodboard-designer | .claude/agents/moodboard-designer.md | 컬러팔레트, 텍스처, 소재 구성 | general-purpose |
| item-curator | .claude/agents/item-curator.md | 가구·소품 선정, 배치 제안, 구매처 조사 | general-purpose |
| budget-manager | .claude/agents/budget-manager.md | 가격 조사, 예산표, 쇼핑가이드 | general-purpose |
| concept-reviewer | .claude/agents/concept-reviewer.md | 교차 검증, 정합성 확인 | general-purpose |
워크플로우
Phase 1: 준비 (오케스트레이터 직접 수행)
- 사용자 입력에서 추출한다:
- 공간 정보: 유형(거실/침실/서재/원룸), 면적, 구조
- 스타일 선호 (선택): 좋아하는 스타일, 레퍼런스 이미지
- 예산 (선택): 총 예산 범위
- 제약 조건 (선택): 임대/자가, 시공 가능 범위, 반려동물/아이
- 기존 파일 (선택): 사용자가 제공한 무드보드, 가구 리스트 등
_workspace/ 디렉토리를 프로젝트 루트에 생성한다- 입력을 정리하여
_workspace/00_input.md에 저장한다
- 기존 파일이 있으면
_workspace/에 복사하고 해당 Phase를 건너뛴다
- 요청 범위에 따라 실행 모드를 결정한다 (아래 "작업 규모별 모드" 참조)
Phase 2: 팀 구성 및 실행
| 순서 | 작업 | 담당 | 의존 | 산출물 |
|---|
| 1 | 스타일 분석 | analyst | 없음 | _workspace/01_style_analysis.md |
| 2 | 무드보드 설계 | designer | 작업 1 | _workspace/02_moodboard.md |
| 3 | 아이템 큐레이션 | curator | 작업 1, 2 | _workspace/03_item_list.md |
| 4 | 예산표·쇼핑가이드 | budget | 작업 1, 2, 3 | _workspace/04_budget_shopping.md |
| 5 | 컨셉 리뷰 | reviewer | 작업 1~4 | _workspace/05_review_report.md |
팀원 간 소통 흐름:
- analyst 완료 → designer에게 추천 스타일·레퍼런스 전달, curator에게 공간 조건·제약 전달, budget에게 예산 범위·임대 여부 전달
- designer 완료 → curator에게 컬러팔레트·소재 보드 전달, budget에게 추천 소재·브랜드 전달
- curator 완료 → budget에게 전체 아이템 리스트·가격대 전달
- reviewer는 모든 산출물을 교차 검증. 🔴 필수 수정 발견 시 해당 에이전트에게 수정 요청 → 재작업 → 재검증 (최대 2회)
Phase 3: 통합 및 최종 산출물
_workspace/ 내 모든 파일을 확인한다- 리뷰 보고서의 🔴 필수 수정이 모두 반영되었는지 확인한다
- 최종 요약을 사용자에게 보고한다:
- 스타일 분석 —
01_style_analysis.md
- 무드보드 + 컬러팔레트 —
02_moodboard.md
- 가구·소품 리스트 —
03_item_list.md
- 예산표 + 쇼핑가이드 —
04_budget_shopping.md
- 리뷰 보고서 —
05_review_report.md
작업 규모별 모드
| 사용자 요청 패턴 | 실행 모드 | 투입 에이전트 |
|---|
| "인테리어 컨셉 전체 잡아줘" | 풀 파이프라인 | 5명 전원 |
| "무드보드만 만들어줘" | 무드보드 모드 | analyst + designer + reviewer |
| "가구 추천해줘" (스타일 제시됨) | 아이템 모드 | curator + budget + reviewer |
| "인테리어 예산 짜줘" (리스트 있음) | 예산 모드 | budget + reviewer |
| "이 컨셉보드 검토해줘" | 리뷰 모드 | reviewer 단독 |
기존 파일 활용: 사용자가 무드보드, 아이템 리스트 등을 제공하면, 해당 파일을 _workspace/의 적절한 번호 위치에 복사하고 해당 단계의 에이전트는 건너뛴다.
데이터 전달 프로토콜
| 전략 | 방식 | 용도 |
|---|
| 파일 기반 | _workspace/ 디렉토리 | 주요 산출물 저장 및 공유 |
| 메시지 기반 | SendMessage | 실시간 핵심 정보 전달, 수정 요청 |
| 태스크 기반 | TaskCreate/TaskUpdate | 진행 상황 추적, 의존 관계 관리 |
파일명 컨벤션: {순번}_{에이전트}_{산출물}.{확장자}
에러 핸들링
| 에러 유형 | 전략 |
|---|
| 공간 정보 부족 | 한국 아파트(84㎡) 기본값 적용, 보고서에 "추정치" 명시 |
| 웹 검색 실패 | 일반 인테리어 지식 기반 작업, "데이터 제한" 명시 |
| 예산 미제시 | 공간 유형별 평균 예산 제안 후 진행 |
| 에이전트 실패 | 1회 재시도 → 실패 시 해당 산출물 없이 진행, 리뷰 보고서에 누락 명시 |
| 리뷰에서 🔴 발견 | 해당 에이전트에 수정 요청 → 재작업 → 재검증 (최대 2회) |
테스트 시나리오
정상 흐름
프롬프트: "25평 아파트 거실을 스칸디나비안 스타일로 꾸미고 싶어. 예산은 500만원이야."
기대 결과:
- 스타일 분석: 스칸디나비안 핵심 요소 + 25평 거실 조건 반영
- 무드보드: 화이트/라이트그레이 중심 컬러팔레트 + 원목·리넨 소재
- 아이템: 소파·테이블·조명·러그 등 15~20개 품목 + 사이즈 확인
- 예산표: 500만원 내 배분 + 3단계 구매 우선순위
- 리뷰: 정합성 매트릭스 전항목 확인
기존 파일 활용 흐름
프롬프트: "이 무드보드에 맞는 가구 추천해줘" + 무드보드 파일 첨부
기대 결과:
- 기존 무드보드를
_workspace/02_moodboard.md로 복사
- 아이템 모드: curator + budget + reviewer 투입
- analyst, designer는 건너뜀
에러 흐름
프롬프트: "방 예쁘게 꾸미고 싶은데 뭐부터 해야 할지 모르겠어"
기대 결과:
- 공간 정보 부족 → analyst가 공간 유형·면적 질문 또는 기본값 적용
- 스타일 미정 → analyst가 대비되는 3가지 스타일 제안
- 예산 미정 → budget이 공간 유형별 평균 예산 제시
에이전트별 확장 스킬
| 에이전트 | 확장 스킬 | 용도 |
|---|
| moodboard-designer, style-analyst | color-harmony-engine | 색채 이론, 배색 공식, 스타일별 팔레트 DB |
| item-curator, style-analyst | spatial-layout-guide | 가구 배치 규칙, 치수 기준, 동선 설계 |
