brainstorming

name	brainstorming
description	구현 착수 전 아이디어를 설계 문서로 전환하는 스킬. 기능 추가·컴포넌트 생성·동작 변경 등 창의적 작업 시 반드시 사용. 의도·요구사항·설계를 탐색한 후 구현으로 전환.

Brainstorming — 아이디어 → 설계

역할

구현 착수 전 아이디어를 설계 문서로 전환하는 게이트키퍼. 사용자 승인 전에는 구현 스킬 호출·코드 작성·프로젝트 스캐폴딩을 일절 허용하지 않는다(HARD-GATE).

컨텍스트

기능 추가·컴포넌트 생성·동작 변경 등 모든 창의적 작업의 진입점. --design-intent 모드는 UI 구현 전 별도 인터뷰로 DESIGN_INTENT.md를 생성해 frontend-design 스킬의 필수 입력으로 넘긴다.

설계를 제시하고 사용자 승인을 받기 전까지 구현 스킬 호출, 코드 작성, 프로젝트 스캐폴딩, 기타 구현 행동을 일절 금지. 단순해 보이는 프로젝트도 예외 없음.

--design-intent 모드 (alias: design-consult)

트리거: UI 화면·컴포넌트 구현 전, 또는 --design-intent / design-consult 명시 호출 시.

이 모드는 구현 전 디자인 의도 인터뷰를 진행하고 잠금된 DESIGN_INTENT.md를 생성한다. 이후 frontend-design 스킬은 이 파일을 필수 입력으로 수령한다.

참고: autoplan Design wave(사후 루브릭 점수)·frontend-design(구현)과 중복되지 않음 — 이 단계는 구현 전 의도 포착 전용.

디자인 의도 인터뷰 (5문항, 한 번에 하나씩)

1. 비주얼 방향 / 톤 — 무드, 레퍼런스, 브랜드 느낌
2. 레이아웃 의도 — 구조, 계층, 그리드
3. 주요 인터랙션 모델 — 사용자가 어떻게 탐색하고 행동하는가
4. 핵심 UI 상태 — empty / loading / error / success / edge 케이스
5. 제약 / 브랜드 토큰 — 디자인 시스템, a11y, 반응형 타겟

출력: DESIGN_INTENT.md (잠금)

인터뷰 완료 후 docs/design/YYYY-MM-DD-{screen}-design-intent.md에 저장. 파일에는 ## Design Decisions 섹션을 필수 포함 — 각 결정 + 근거 기록. 저장 후 이 파일은 잠금(locked) 상태로 간주: 후속 구현 단계에서 수정 금지, 변경이 필요하면 사용자 승인 + 재인터뷰.

frontend-design 호출 시 이 파일 경로를 DESIGN_INTENT 입력으로 전달.

---

사용 시점

창의적 작업 = 기능 추가 / 컴포넌트 생성 / 동작 변경 / 신규 기능 전부. 구현 착수 전 항상 이 스킬 실행.

"단순해서 설계가 필요 없다"는 안티패턴이다. 단순 프로젝트는 검토 안 된 가정이 가장 많이 낭비를 만든다.

절차 체크리스트 (순서대로 완료)

• 1. 프로젝트 컨텍스트 탐색 — 관련 파일, 문서, 최근 커밋 확인
• 2. 비주얼 질문 예상 시 — Visual Companion 제안 (별도 메시지, 질문과 혼합 금지)
• 3. 명확화 질문 — 한 번에 하나씩, 목적·제약·성공 기준 파악
• 4. 2~3가지 접근법 제안 — 트레이드오프 + 권고안 포함
• 5. 설계 제시 — 복잡도에 맞는 섹션 분할, 각 섹션 후 사용자 승인 대기
• 6. 설계 문서 저장 — docs/planning/YYYY-MM-DD-{topic}-design.md 저장 + 커밋
• 7. Spec 자가 검토 — 플레이스홀더·모순·모호성·범위 검토 후 인라인 수정
• 8. 사용자 Spec 검토 요청 — 저장된 파일 직접 검토 요청
• 9. 구현으로 전환 — /writing-plans 스킬 호출로 구현 계획 생성

Spec 자가 검토 체크리스트 (Step 7)

항목	확인
플레이스홀더(TBD, TODO, ???)	없거나 명시적 미결로 표기
내부 모순	섹션 간 상충 없음
모호한 요구사항	"빠른", "좋은" 등 측정 불가 표현 없음
범위 과대	현재 요청 범위 내 제한

명확화 질문 예시

각 질문은 한 번에 하나만:

• "이 기능이 해결하려는 핵심 문제가 무엇인가요?"
• "성공 기준은 어떻게 측정하나요?"
• "기존 시스템과의 통합 제약이 있나요?"
• "MVP 범위는 어디까지인가요?"

Forge 통합 지점

단계	연계 스킬/커맨드
설계 완료	/writing-plans — 구현 계획 생성
계획 완료	/forge-implement — Spec 기반 구현
구현 완료	/qa → /forge-pr

관련

• 구현 계획: /writing-plans
• Spec 작성: /spec-write
• 시각적 설계: claude.ai/design → Figma MCP 연동