효과적인 브리프 작성하기

프로젝트의 모든 턴은 composer에서 시작됩니다. 프로젝트 화면 하단의 입력란입니다(새 프로젝트라면 홈 화면에 있습니다). 어떤 설정보다 여기에 무엇을 넣는지가 실행을 결정합니다. 이 페이지는 컨트롤과 에이전트에게 잘 브리프하는 방법을 다룹니다.

컴포저 — 입력란, 에이전트 칩, effort, 품질 모드, Send 버튼

컨트롤

  • Input — 브리프 자체입니다. 턴당 메시지 하나; Enter는 전송, Shift+Enter는 줄 바꿈입니다.
  • Agent chip — 이 턴이 돌아가는 CLI와 모델입니다(Claude Code · Default). 클릭하면 실행마다 에이전트나 모델을 전환할 수 있습니다.
  • Effort — 에이전트가 문제에 얼마나 힘을 쓰는지입니다. 반복에는 Fast, 다듬기에는 더 높은 값을 씁니다.
  • Quality mode — Fast, Reviewed, Council 중 하나. 결과가 앞에 놓이기 전에 어떻게 검사되는지를 결정합니다(품질 모드 참조).
  • Attach — 파일이나 동영상 참조를 턴에 넣습니다( 첨부 파일 및 동영상 참조 참조).
  • History — 프로젝트의 이전 상태를 복원합니다( 히스토리 및 복원 참조).
  • Send — 턴을 시작합니다. 에이전트가 작업하는 동안 busy 상태로 바뀝니다.

브리프의 구조

좋은 브리프는 보통 한두 문장 안에 세 가지를 담습니다.

  1. 무엇인가 — "랜딩 페이지", "가격 섹션", "빈 상태"
  2. 누구를, 무엇을 위한 것인가 — "커피 정기구독용", "처음 쓰는 사용자용"
  3. 느낌 — "어둡고, 에디토리얼하고, 자신감 있는 타이포", "조용하고, 고급스러운 느낌"

스펙 시트 수준의 세부(정확한 픽셀, 정확한 hex)는 생략하세요. 그런 결정은 디자인 시스템이 소유하며, 조각조각 덮어쓰는 것보다 일관되게 적용되는 명확한 방향이 더 나은 결과를 냅니다.

후속 지시는 재시작이 아니라 스티어링

첫 턴 이후 컴포저는 대화입니다. 각 후속 지시는 같은 파일을 그 자리에서 수정합니다. "히어로 이미지를 제품 컷으로 바꿔"나 "nav를 더 가볍게 느껴지게 해"처럼요. 다시 생성하는 대신 다듬어 나가는 방식입니다. 완전히 다른 방향이라면 버전으로 브랜치하거나 배리언트를 실행하세요.

Tip: 수정이 특정 요소에 관한 것이라면 설명하지 말고 핀을 꽂으세요. 미리보기에서 ⌥-click하면 댓글이 정확히 그 노드에 붙습니다. 요소 선택, 댓글 및 그리기를 참조하세요.

핀, 댓글, 참조는 함께 실려 갑니다

⌥-click로 놓은 댓글, Designer Talk 메모, 첨부 파일은 다음 브리프에 자동으로 접혀 들어갑니다. 에이전트는 맨 지시가 아니라 컨텍스트 안의 스티어링을 봅니다. 수정이 반영되면 핀을 resolve하거나 지워서 다음 턴이 낡은 메모를 다시 읽지 않게 하세요.

관련 문서