이 단원의 카드 9개
먼저 볼 카드 — 좋은 요청
실습 시작
프로젝트 브리프
이 카드를 다루는 수업 자료를 잘 정리하는 법
프로젝트 폴더를 Claude Code 또는 Codex에서 열고, 필요한 자료를 첨부한 뒤 요청문 옆 복사 버튼을 누릅니다. 대괄호가 있는 요청은 내 내용으로 바꿔 붙여넣으며, 답변을 받은 뒤에는 안내된 파일이나 화면을 직접 확인합니다.
project-brief.md에는 다섯 가지를 정합니다. 이후 brand.md나 workflow.md로 갈라지는 모든 개인화 작업이 여기서 출발합니다.
- 만들 결과물
- 사용할 사람
- 현재 가진 자료
- 완료 기준
- 하지 않을 일
파일은 직접 채우지 않습니다.
- Claude Code에게 한 번에 한 질문씩 묻게 합니다. 순서대로 답만 하면 브리프가 완성됩니다.
- 답이 모호하면 예시 3개를 보여 달라고 요청해 그중에서 고릅니다.
완료 기준은 확인 가능한 문장으로 적습니다.
- 애매한 기준 — “결과물이 좋아 보인다”
- 확인 가능한 기준 — “A4 한 장, 고객 3유형, 금지 표현 5개가 들어간다”
확인할 수 없는 기준은 나중에 결과물을 두고 다시 논쟁하게 됩니다.
아래 요청문을 복사해 붙여넣고 project-brief.md 인터뷰를 시작합니다.
실행 순서
-
만들 결과물을 한 문장으로 정합니다.
이 폴더에서 만들 결과물을 정리하려고 합니다. 제가 첨부한 자료를 읽고, 만들 것·사용할 사람·가진 자료·완료 기준·하지 않을 일을 한 번에 한 질문씩 물어봐 주세요. 답을 요약해 제 확인을 받은 뒤 project-brief.md로 저장하고 파일 위치를 알려 주세요. 기존 파일이 있으면 먼저 읽고 바꿀 부분을 보여 주세요.
확인답을 확인한 뒤 project-brief.md 파일이 생기고, 다섯 항목과 파일 위치를 확인할 수 있습니다.
-
그 결과물을 쓸 사람을 정합니다.
-
지금 가진 자료를 정리합니다.
-
완료 기준을 확인 가능한 문장으로 적습니다.
-
이번 프로젝트에서 하지 않을 일을 적습니다.
직접 해보기
대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.
위 다섯 항목에 이미 답이 있어: [결과물]·[사용할 사람]·[가진 자료]·[완료 기준]·[하지 않을 일]을 한 줄씩 적어줘. 이 내용으로 project-brief.md를 만들어줘.
방금 만든 project-brief.md의 완료 기준 문장이 확인 가능한 형태인지 점검해줘. 뭉뚱그린 표현이 있으면 구체적인 문장으로 고쳐서 다시 제안해줘.
완료 기준이 "결과물이 좋아 보인다"처럼 뭉뚱그린 문장은 아닌지 확인해 보세요. "A4 한 장, 고객 3유형, 금지 표현 5개"처럼 확인 가능한 문장인지가 기준입니다.
헷갈리기 쉬운 것
설치가 막혀 Claude Code를 아직 못 열었다면 Claude Chat에서 같은 질문을 먼저 진행하고 마지막 결과를 복사해 둡니다. Code 설치 후 파일로 옮기면 됩니다.
용어 풀이
전체 용어집 →- 브리프(brief)
- 일을 시작하기 전에 무엇을 만들지 정리한 짧은 문서입니다. 여기서는 project-brief.md 파일을 말합니다.