studio.soluta

먼저 볼 카드 — 좋은 요청

실습 시작

프로젝트 브리프

이 카드를 다루는 수업 자료를 잘 정리하는 법

주황색 퍼핏이 다섯 칸짜리 문서 앞에서 세 번째 칸을 펜으로 채우고 남은 두 칸을 가리키는 그림
다섯 항목을 한꺼번에 쓰지 않고 질문에 답하며 한 칸씩 채웁니다

프로젝트 폴더를 Claude Code 또는 Codex에서 열고, 필요한 자료를 첨부한 뒤 요청문 옆 복사 버튼을 누릅니다. 대괄호가 있는 요청은 내 내용으로 바꿔 붙여넣으며, 답변을 받은 뒤에는 안내된 파일이나 화면을 직접 확인합니다.

project-brief.md에는 다섯 가지를 정합니다. 이후 brand.md나 workflow.md로 갈라지는 모든 개인화 작업이 여기서 출발합니다.

  • 만들 결과물
  • 사용할 사람
  • 현재 가진 자료
  • 완료 기준
  • 하지 않을 일

파일은 직접 채우지 않습니다.

  • Claude Code에게 한 번에 한 질문씩 묻게 합니다. 순서대로 답만 하면 브리프가 완성됩니다.
  • 답이 모호하면 예시 3개를 보여 달라고 요청해 그중에서 고릅니다.

완료 기준은 확인 가능한 문장으로 적습니다.

  • 애매한 기준 — “결과물이 좋아 보인다”
  • 확인 가능한 기준 — “A4 한 장, 고객 3유형, 금지 표현 5개가 들어간다”

확인할 수 없는 기준은 나중에 결과물을 두고 다시 논쟁하게 됩니다.

아래 요청문을 복사해 붙여넣고 project-brief.md 인터뷰를 시작합니다.

실행 순서

  1. 만들 결과물을 한 문장으로 정합니다.

    이 폴더에서 만들 결과물을 정리하려고 합니다. 제가 첨부한 자료를 읽고, 만들 것·사용할 사람·가진 자료·완료 기준·하지 않을 일을 한 번에 한 질문씩 물어봐 주세요. 답을 요약해 제 확인을 받은 뒤 project-brief.md로 저장하고 파일 위치를 알려 주세요. 기존 파일이 있으면 먼저 읽고 바꿀 부분을 보여 주세요.

    확인답을 확인한 뒤 project-brief.md 파일이 생기고, 다섯 항목과 파일 위치를 확인할 수 있습니다.

  2. 그 결과물을 쓸 사람을 정합니다.

  3. 지금 가진 자료를 정리합니다.

  4. 완료 기준을 확인 가능한 문장으로 적습니다.

  5. 이번 프로젝트에서 하지 않을 일을 적습니다.

직접 해보기

대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.

내 상황에 맞춰
위 다섯 항목에 이미 답이 있어: [결과물]·[사용할 사람]·[가진 자료]·[완료 기준]·[하지 않을 일]을 한 줄씩 적어줘. 이 내용으로 project-brief.md를 만들어줘.
한 단계 더
방금 만든 project-brief.md의 완료 기준 문장이 확인 가능한 형태인지 점검해줘. 뭉뚱그린 표현이 있으면 구체적인 문장으로 고쳐서 다시 제안해줘.

완료 기준이 "결과물이 좋아 보인다"처럼 뭉뚱그린 문장은 아닌지 확인해 보세요. "A4 한 장, 고객 3유형, 금지 표현 5개"처럼 확인 가능한 문장인지가 기준입니다.

헷갈리기 쉬운 것

설치가 막혀 Claude Code를 아직 못 열었다면 Claude Chat에서 같은 질문을 먼저 진행하고 마지막 결과를 복사해 둡니다. Code 설치 후 파일로 옮기면 됩니다.

용어 풀이

전체 용어집 →
브리프(brief)
일을 시작하기 전에 무엇을 만들지 정리한 짧은 문서입니다. 여기서는 project-brief.md 파일을 말합니다.