기준 문서 만들기
매번 다시 설명하는 대신, 반복해서 쓸 기준을 파일로 고정해 Claude가 읽게 합니다.
이 단원을 다루는 수업 자료를 잘 정리하는 법
이미 아는 내용이면 건너뛰기
아래 세 가지에 막힘없이 답할 수 있으면 이 단원은 건너뛰고 다음으로 가도 됩니다.
- brand.md·design.md·voice.md처럼 기준을 적은 파일을 만들어 요청에 붙여 써 봤나요?
- CLAUDE.md에 반복 규칙을 옮겨 매 요청에서 다시 적지 않고 있나요?
- 지난주에 정한 값이 이번 주 대화에서 흐려지지 않도록 결정을 기록하고 있나요?
학습 카드 10장
이 단원의 학습 카드
모든 학습 카드 내용을 아래에서 차례로 볼 수 있습니다.
프로젝트 브리프 project-brief.md에 결과물·사용자·현재 자료·완료 기준·제외 범위를 정리할 수 있습니다
-
프로젝트 폴더를 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 파일이 생기고, 다섯 항목과 파일 위치를 확인할 수 있습니다.
-
그 결과물을 쓸 사람을 정합니다.
-
지금 가진 자료를 정리합니다.
-
완료 기준을 확인 가능한 문장으로 적습니다.
-
이번 프로젝트에서 하지 않을 일을 적습니다.
완료 기준이 "결과물이 좋아 보인다"처럼 뭉뚱그린 문장은 아닌지 확인해 보세요. "A4 한 장, 고객 3유형, 금지 표현 5개"처럼 확인 가능한 문장인지가 기준입니다.
프로젝트 결과물, 사용할 사람, 가진 자료, 완료 기준, 하지 않을 일을 project-brief.md에 적었습니다.
설치가 막혀 Claude Code를 아직 못 열었다면 Claude Chat에서 같은 질문을 먼저 진행하고 마지막 결과를 복사해 둡니다. Code 설치 후 파일로 옮기면 됩니다.
용어 풀이
전체 용어집 →- 브리프(brief)
- 일을 시작하기 전에 무엇을 만들지 정리한 짧은 문서입니다. 여기서는 project-brief.md 파일을 말합니다.
브랜드 기준 문서 brand.md에 대상 고객·인상·금지 표현을 정리해 브랜드·비주얼 요청의 기준으로 쓸 수 있습니다
- 순서: project-brief.md 다음 단계
- brand.md의 다섯 질문
- 대상 고객
- 지금 겪는 문제
- 남기고 싶은 인상
- 자주 쓸 말과 쓰지 않을 말
- 참고할 브랜드
- 파일은 직접 채우지 않습니다
- project-brief.md를 먼저 읽게 하고, 다섯 항목을 한 번에 한 질문씩 물어보게 합니다.
- 답이 끝나면 사실, 결정, 아직 모르는 것을 구분해서 정리해 달라고 요청합니다.
- 색과 폰트처럼 아직 정하지 않은 항목은 추측으로 채우지 않습니다
- “미정”으로 남겨 두고, 다음 시각 탐색 단계에서 다시 결정합니다.
- 모르는 것을 안다고 적어 두면 이후 모든 요청이 그 위에서 어긋납니다.
-
누구를 위한 브랜드인지 정합니다.
project-brief.md와 첨부한 브랜드 자료를 읽고 brand.md를 만들어 주세요. 대상 고객·고객의 문제·남길 인상·쓸 말과 피할 말·참고할 브랜드 중 빠진 내용만 한 번에 하나씩 질문해 주세요. 제 답을 확인받은 뒤 사실·결정·미정을 구분해 저장하고, 추측으로 채운 항목이 없는지 확인해 주세요.
확인brand.md에서 대상 고객, 인상, 표현 기준을 확인하고 아직 정하지 않은 항목을 미정으로 구분할 수 있습니다.
-
그 사람이 지금 겪는 문제를 적습니다.
-
우리를 본 뒤 어떤 인상을 받아야 하는지 정합니다.
-
자주 쓸 말과 쓰지 않을 말을 나눕니다.
-
참고할 브랜드와 따라 하지 않을 요소를 구분합니다.
brand.md에 적힌 문장이 사실인지 결정인지 구분해서 읽어 보세요. 색과 폰트처럼 아직 안 정한 항목이 추측으로 채워져 있지 않은지 확인합니다.
대상 고객, 남기고 싶은 인상, 금지 표현을 적고, 정하지 못한 항목은 미정으로 남겼습니다.
색과 폰트를 아직 정하지 않았다면 추측해서 확정하지 말고, "미정"으로 남겨 다음 시각 탐색에서 결정합니다.
용어 풀이
전체 용어집 →- brand.md
- 브랜드 기준을 적어 두는 텍스트 파일 이름입니다. md는 마크다운이라는 간단한 문서 형식의 확장자입니다.
- project-brief.md
- 프로젝트의 목적과 배경을 정리해 두는 텍스트 파일입니다. brand.md를 만들기 전 먼저 준비하는 문서입니다.
비주얼 기준 문서 design.md와 image.md에 색·폰트·고정 요소를 관찰 가능한 값으로 정리해 비주얼 요청의 기준으로 쓸 수 있습니다
- 두 파일의 역할
- design.md — 색·폰트·여백 같은 화면 규칙
- image.md — 이미지에서 고정할 요소와 바꿔도 되는 요소
- 파일은 직접 채우지 않습니다
- 기존 결과물과 참고 이미지를 먼저 보여주고, 한 번에 한 질문씩 인터뷰를 받습니다.
- “감성적”, “세련된” 같은 형용사는 그대로 두지 않고 HEX 값, 폰트 이름, px처럼 관찰 가능한 값으로 바꿉니다. 형용사는 사람마다 다르게 읽지만 값은 누가 읽어도 같습니다.
- image.md의 두 갈래
- 매번 유지할 요소 — 피사체, 구도, 광원, 팔레트
- 바꿔도 되는 요소 — 장면, 소품
- 이 구분이 있어야 이미지를 여러 장 만들어도 같은 브랜드로 보입니다
다른 AI 도구에서도 같은 디자인 기준 사용하기
DESIGN.md: 색·글꼴·여백 같은 디자인 규칙과 그 규칙을 쓰는 이유를 적는 문서 파일- Google: 2026년 4월 21일 Stitch의 DESIGN.md 작성 규격 초안 공개
- 공식 규격 구성: 정확한 값을 적는 부분 + 적용 방법을 설명하는 본문
- 이 카드의
design.md는 같은 목적의 학습용 문서이며, Google 규격을 그대로 따르는지는 별도로 확인해야 합니다 - 이미 쓰는 파일이 있다면 그 이름을 유지하고, 대소문자만 다른 파일을 추가로 만들지 않습니다
기존 자료에서 기준 정리하기
- 브랜드 안내서나 기존 화면을 AI에 보여 주고 아래 요청문을 붙여넣습니다
- 웹사이트를 읽을 수 없는 도구: 화면 이미지나 파일을 첨부합니다
- 사진만 보고 글꼴·색을 확정하지 않도록, 확인된 값과 미정인 항목을 나눕니다
제가 제공한 브랜드 안내서, 기존 화면과 현재 폴더의 디자인 문서를 읽어 주세요. 이미 design.md 또는 DESIGN.md가 있다면 그 파일부터 확인해 주세요.
배경·본문·강조 색, 제목·본문 글꼴, 여백과 화면 폭을 정리하고 각 항목에 확인한 파일 또는 페이지를 적어 주세요. 각 색과 글꼴을 어디에 쓰는지도 설명해 주세요. 자료만으로 알 수 없는 값은 미정으로 남기고, 기존 기준과 충돌하는 항목은 제게 한 가지씩 질문해 주세요.
확인한 뒤 기존 디자인 문서에 추가할 내용을 보여 주세요. 파일이 없다면 design.md 초안을 작성해 주세요. 저장할 수 없는 도구라면 제가 내려받거나 복사해 저장할 수 있도록 문서 전문을 보여 주세요.
운영 중인 웹사이트에서 초안 받기
- 웹사이트가 이미 있다면 사이트 주소를 넣어 색·글꼴·간격을 읽어 오는 서비스로 DESIGN.md 초안을 먼저 받을 수 있습니다
- designmd.me: 주소를 넣으면 DESIGN.md와 HTML 미리보기를 만듭니다
- 가격: 무료 크레딧은 한 번 생성할 만큼, 그 뒤로는 유료
- DESIGNMD by Hyperbrowser: Google 규격에 맞춘 파일을 뽑아 줍니다
- 조건: Hyperbrowser API 키 필요
- 같은 종류의 서비스: 참고 사이트의 디자인 시스템 분류
- 받은 초안은 화면에서 읽어 낸 값이라 브랜드가 정한 값과 다를 수 있습니다
- 초안과 브랜드 안내서를 함께 첨부하고 아래 요청문으로 값을 대조한 뒤 기준 문서로 씁니다
첨부한 DESIGN.md는 우리 웹사이트 주소를 넣어 자동으로 뽑은 초안입니다. 함께 첨부한 브랜드 안내서와 비교해 색·글꼴·여백 값을 일치하는 항목, 다른 항목, 안내서에 없는 항목으로 나눠 표로 보여 주세요. 다른 항목은 어느 쪽 값을 따를지 제게 한 가지씩 질문하고, 답을 반영한 design.md 초안을 보여 주세요.
새 대화에서 읽었는지 확인하기
- 새 대화나 다른 AI 도구: 파일을 첨부하거나 파일이 있는 폴더를 연결합니다
- 아래 요청문으로 읽은 내용을 확인합니다
- 저장해 둔 것만으로 모든 도구가 자동으로 읽거나 이후 대화까지 기억한다고 가정하지 않습니다
첨부한 design.md 또는 현재 작업 폴더의 디자인 문서를 먼저 읽어 주세요. 실제로 읽은 파일 이름과 배경색, 본문 글꼴, 여백 기준을 요약하고 아직 미정인 항목도 알려 주세요. 파일이 보이지 않으면 추측하지 말고 필요한 파일을 요청해 주세요. 아직 화면이나 이미지는 만들지 마세요.
- AI가 답한 값과 문서의 값이 일치하는지 대조합니다
- 이후 결과물을 만들 때도 같은 문서를 함께 전달합니다
- 완성한 화면에서 색·글꼴·여백이 기준과 맞는지 확인합니다
공식 설명
-
기존 결과물과 참고 이미지를 먼저 모읍니다.
brand.md와 첨부한 결과물·참고 이미지를 바탕으로 design.md를 만들어 주세요. 색·폰트·여백·화면 폭·모바일 배치·피할 요소를 정리하되, 이미지에서 정확히 확인할 수 없는 값은 추측해 확정하지 말고 제게 물어봐 주세요. 답을 확인받아 저장하고, 이미지에서 고정할 요소와 바꿔도 되는 요소는 image.md로 나눠 주세요.
확인design.md에 확인한 디자인 값과 미정 항목이 나뉘고, image.md에 이미지의 고정 요소와 변경 가능한 요소가 정리됩니다.
-
배경·본문·포인트 색을 실제 값으로 정합니다.
-
제목·본문 폰트와 대체 폰트를 정합니다.
-
여백·정보 밀도와 최대 콘텐츠 폭을 정합니다.
-
반드시 피할 요소를 적습니다.
-
이미지에서 고정할 요소와 바꿔도 되는 요소를 나눠 image.md로 옮깁니다.
design.md에 형용사만 남은 항목이 있는지 찾아보세요. 값으로 바꿀 수 없는 문장은 기준으로 작동하지 않습니다.
색 세 개와 폰트 두 개를 실제 값으로 적고, 이미지의 고정 요소와 바꿔도 되는 요소를 나눴습니다.
색과 폰트를 그날 기분으로 바꾸면 기준 파일이 무력해집니다. 바꾸고 싶으면 결과물이 아니라 design.md를 먼저 고치고, 이후 작업은 새 기준을 따릅니다.
용어 풀이
전체 용어집 →2026-09-25 기준 · 출처 · Google Labs — DESIGN.md 공개 안내, Google DESIGN.md 규격과 예제, designmd.me — 사이트 주소로 DESIGN.md 생성과 크레딧 요금, DESIGNMD by Hyperbrowser — 사이트 주소로 DESIGN.md 추출
클로드 디자인으로 시안 만들기 claude.ai/design에 design.md나 디자인 시스템을 연결해 카드뉴스·슬라이드 같은 시안을 만들고 채팅으로 고칠 수 있습니다
- 클로드 디자인: claude.ai/design에서 열리는 디자인 도구
- 프롬프트를 넣으면 카드뉴스, 슬라이드, 웹 화면 시안을 만들어 줍니다
- Claude Code와의 역할 차이
- Claude Code — 폴더에서 파일을 직접 만들고 고칩니다.
- 클로드 디자인 — 결과 화면을 눈으로 보면서 고칩니다.
- 시안을 만들기 전에 기준을 먼저 넣습니다
- design.md를 첨부하면, 클로드 디자인이 그 색·폰트·여백에 맞춰 화면을 만듭니다.
- 피그마 디자인 시스템이 있으면 .fig 파일로 등록해 둘 수도 있습니다.
- 기준 없이 “만들어 줘”라고만 하면 어디서 본 듯한 평균적인 화면이 나옵니다. design.md로 잡아 둔 기준이 여기서 그대로 쓰입니다.
- 시안은 3가지 방향으로 받아 나란히 놓고 고른 다음, 채팅으로 색·문구·배치를 고칩니다
- 조건: Pro 이상 구독. 무료 계정에서는 화면이 나타나지 않습니다
- 첫 시안: 순서 아래 요청을 claude.ai/design 입력창에 붙여넣습니다
-
Claude Code 또는 Codex에서 시안 제작에 쓸 요청문을 준비합니다.
첨부한 design.md를 읽고 클로드 디자인에 붙여넣을 [만들 결과물] 요청문을 작성해 주세요. 색·폰트·배치 기준과 확인할 항목을 포함하고, 정하지 않은 값은 제게 물어봐 주세요. 지금은 요청문만 작성하며 로그인·구독·유료 생성은 실행하지 마세요.
확인design.md 기준과 만들 결과물이 담긴 요청문이 나오며, 로그인이나 유료 생성은 실행하지 않습니다.
-
브라우저에서 claude.ai/design에 들어가 로그인합니다. 클로드 디자인은 Pro 이상 구독에서 열립니다.
확인"What should we create?"라는 입력 화면이 나옵니다.
-
만들 것의 기준을 먼저 넣습니다. design.md 파일을 첨부하거나, 피그마 디자인 시스템이 있으면 Create Design System에서 .fig 파일을 올립니다.
확인입력창 아래에 첨부한 design.md나 등록한 디자인 시스템 이름이 보입니다.
-
만들 것을 문장으로 설명하거나, 아래 붙여넣기 요청을 입력창에 넣습니다. 템플릿(Card News·Slides)을 골라서 시작해도 됩니다.
첨부한 design.md를 먼저 읽어. 이 기준에 맞춰 [카드뉴스 표지 / 소개 슬라이드 5장 / 랜딩 첫 화면] 시안을 만들어 줘. 서로 다른 3가지 방향으로 만들어 줘. - 1안: 기준에 충실한 안 - 2안: 여백을 더 크게 둔 안 - 3안: 자유롭게 그라디언트 배경, 이모지, AI가 직접 그린 일러스트는 쓰지 마.
확인설명한 화면이 서로 다른 3가지 방향으로 만들어집니다.
-
마음에 드는 안을 고르고, 채팅으로 색·문구·배치를 고칩니다. 화면이 바로 바뀌는 것을 보면서 반복합니다.
확인요청한 부분만 바뀐 새 시안이 나옵니다.
-
마지막으로 design.md 값과 대조합니다. 색·폰트가 기준과 다르면 고쳐 달라고 요청합니다.
지금 시안에서 쓴 색과 폰트를 design.md의 값과 비교해서, 어긋난 부분만 표로 정리해 줘. 어긋난 곳은 design.md 값으로 고쳐 줘.
확인기준과 어긋난 색·폰트가 표로 나오고, 기준 값으로 맞춰집니다.
design.md를 첨부한 요청과, 첨부하지 않고 "예쁘게 만들어 줘"라고만 한 요청을 각각 한 번씩 보내 결과를 비교해 보세요. 기준을 넣었을 때 결과가 어떻게 달라지는지 눈으로 확인합니다.
design.md를 연결해 시안 세 가지를 받고, 하나를 고른 뒤 수정 지시로 화면 한 곳을 바꿨습니다.
맥락 없이 "만들어 줘"라고만 하면 어디서 본 듯한 평균적인 화면이 나오므로, design.md를 먼저 첨부하고 피할 요소까지 함께 적습니다. 그리고 클로드 디자인은 Pro 이상 구독에서만 열리므로, 무료 계정에서는 화면이 나타나지 않습니다.
용어 풀이
전체 용어집 →- 클로드 디자인
- claude.ai/design 주소에서 열리는 Anthropic의 디자인 도구입니다. 프롬프트를 넣으면 슬라이드·웹 화면·카드뉴스 시안을 만들어 줍니다. Pro 이상 구독에서 열립니다.
- 디자인 시스템
- 색·폰트·버튼 같은 화면 규칙을 한데 묶어 둔 것입니다. 먼저 등록해 두면 클로드 디자인이 그 규칙에 맞춰 화면을 만듭니다.
- .fig 파일
- 피그마(Figma)에서 만든 디자인 파일 형식입니다. 피그마에서 File → Save Local Copy로 내려받습니다.
- 시안
- 최종본을 만들기 전에 방향을 보기 위해 빠르게 만든 초안 화면입니다.
2026-07-21 기준 · 출처 · Claude Design — Anthropic Labs (공식 발표)
보이스 기준 문서 voice.md와 swipe.md에 어미·어휘·승인 문장을 정리해 카피·콘텐츠 요청의 기준으로 쓸 수 있습니다
-
voice.md와 swipe.md의 역할:
-
voice.md — 어미·어휘·금지 표현 같은 규칙
-
swipe.md — 승인된 실제 문장을 출처와 함께 쌓는 기록
-
파일은 직접 채우지 않습니다:
-
최근 실제로 발행한 글과 마음에 드는 문장을 먼저 보여주고, 한 번에 한 질문씩 인터뷰를 받습니다.
-
규칙은 실제 문장과 짝을 이룰 때 작동하므로, 승인 예시와 거절 예시를 함께 넣습니다.
-
swipe.md는 발행할 때마다 좋은 문장을 한 줄씩 쌓는 파일입니다:
-
출처를 모르는 외부 문장은 인용하지 않습니다.
-
확인되지 않은 수치와 성과는 쓰지 않습니다.
-
실습: 아래 요청문을 복사해 붙여넣고 voice.md 인터뷰를 시작합니다
-
최근 실제로 발행한 글과 마음에 드는 문장을 모읍니다.
brand.md와 첨부한 실제 발행 글을 읽고 voice.md와 swipe.md를 만들어 주세요. 고객·채널·어미·자주 쓰는 말·피할 표현 중 빠진 내용만 한 번에 하나씩 질문해 주세요. voice.md에는 확인한 규칙과 예시를, swipe.md에는 제가 고른 문장과 출처·고른 이유를 담아 주세요. 확인되지 않은 수치나 출처를 만들지 말고, 저장한 파일 위치를 알려 주세요.
확인voice.md에서 문체 규칙을, swipe.md에서 고른 문장과 출처를 확인할 수 있습니다.
-
채널별 어미와 문장 길이를 정합니다.
-
자주 쓰는 어휘와 쓰지 않는 표현을 나눕니다.
-
좋은 문장을 출처·이유와 함께 swipe.md에 기록합니다.
-
확인되지 않은 수치·성과를 쓰지 않는 규칙을 넣습니다.
voice.md의 승인 예시가 실제로 발행한 문장인지 확인해 보세요. 지어낸 예시는 기준이 되지 못합니다.
채널별 어미가 정해져 있고, 금지 표현에 이유가 붙어 있고, swipe.md에 출처 있는 문장이 한 개 이상 기록돼 있으면 통과입니다.
확인되지 않은 수치·성과·고객 반응을 카피에 쓰지 않습니다. 출처가 없는 주장은 초안에서 지우거나, 출처를 붙일 때까지 미정으로 둡니다. 규칙을 길게 적을수록 잘 지켜질 것 같지만 반대라서, voice.md는 20줄 안쪽으로 두고 "차분하게" 같은 추상어에는 승인 문장 3개를 붙여 기준점을 만듭니다. 인스타와 랜딩은 결이 다르므로 한 톤으로 뭉뚱그리지 않고 voice.md 안에서 채널별로 나눕니다.
용어 풀이
전체 용어집 →- 어미
- 문장을 끝맺는 말입니다. '~합니다'와 '~해요'처럼 같은 내용도 어미에 따라 거리감이 달라집니다.
업무 흐름 문서 workflow.md에 입력·판단·실행·출력·예외를 정리해 반복 업무의 기준으로 쓸 수 있습니다
-
workflow.md는 project-brief.md 다음에 만듭니다
-
실제 업무 흐름을 정리하는 다섯 항목:
-
입력 — 일이 시작될 때 들어오는 자료
-
판단 — 사람이 결정해야 하는 기준
-
실행 — 반복해서 하는 단계
-
출력 — 마지막에 나와야 하는 결과
-
예외 — 자동으로 처리하면 안 되는 경우
-
project-brief.md를 먼저 읽게 하고, 실제로 하는 일을 인터뷰하게 합니다
-
다섯 항목을 한 번에 한 질문씩 구분해서 묻게 합니다
-
결제, 발송, 삭제, 공개처럼 되돌리기 어려운 단계는 자동 실행 대상으로 두지 않습니다. 먼저 사람이 확인하는 승인 지점으로 표시해 둡니다.
-
마지막에는 현재 흐름과 개선 후보를 분리해서 정리합니다. 지금 하는 일과 나중에 자동화할 일이 섞이지 않습니다.
-
실습: 아래 요청문을 복사해 붙여넣고 workflow.md 인터뷰를 시작합니다
-
일이 시작될 때 들어오는 입력 자료를 정리합니다.
project-brief.md를 읽고 제가 반복하는 업무를 workflow.md로 정리해 주세요. 시작할 때 받는 자료·사람의 판단·반복 단계·최종 결과·예외 중 빠진 내용만 한 번에 하나씩 물어봐 주세요. 제 답을 확인받은 뒤 현재 방식과 개선 후보를 나눠 저장하고, 결제·외부 발송·삭제처럼 제 승인이 필요한 단계도 표시해 주세요. 실제 업무는 아직 실행하지 마세요.
확인workflow.md에 현재 업무 순서, 개선 후보, 직접 승인할 단계가 나뉘며 실제 업무는 실행하지 않습니다.
-
사람이 결정해야 하는 판단 기준을 적습니다.
-
반복해서 하는 실행 단계를 나열합니다.
-
마지막에 나와야 하는 출력을 정합니다.
-
자동으로 처리하면 안 되는 예외를 표시합니다.
입력과 출력이 각각 한 문장으로 적혀 있는지, 사람이 판단해야 하는 지점이 표시되어 있는지 확인해 보세요.
입력과 출력이 적혀 있고, 사람이 판단해야 하는 지점과 자동 실행하면 안 되는 예외가 있으면 통과입니다.
결제, 발송, 삭제, 공개처럼 되돌리기 어려운 단계는 자동 실행 대상으로 두지 않습니다. 먼저 사람이 확인하는 승인 지점으로 표시합니다.
용어 풀이
전체 용어집 →- 승인 지점
- 자동으로 진행하지 않고, 사람이 한 번 확인한 뒤에만 다음 단계로 넘어가게 표시해 둔 곳입니다.
규칙 파일 — CLAUDE.md 반복해서 말하던 규칙을 CLAUDE.md 파일로 고정해 매번 다시 쓰지 않을 수 있습니다
-
매번 “이모지 빼고, 존댓말로” 같은 규칙을 다시 적으면 요청이 길어지고, 빠뜨린 요청만 규칙에서 벗어난 결과가 나옵니다
-
CLAUDE.md: 세션이 시작될 때 자동으로 읽히는 규칙 파일
-
폴더 구조, 금지 사항, 톤, 자주 쓰는 명령어처럼 매번 설명하던 내용을 적어 둡니다. 이후 요청에서는 생략할 수 있습니다.
-
빈 프로젝트라면 /init을 실행해 코드와 문서를 분석한 초안을 먼저 받습니다.
-
파일은 두 층입니다
- 프로젝트 루트의 CLAUDE.md — 그 프로젝트에서 함께 일하는 사람과 공유하는 규칙
- 사용자 홈 폴더의 ~/.claude/CLAUDE.md — 어떤 프로젝트를 열어도 항상 적용되는 개인 규칙
-
같은 내용이 두 파일에 있으면 프로젝트 파일이 우선 적용됩니다
-
규칙은 쌓기보다 관리합니다
- 온갖 규칙을 한 파일에 계속 이어 붙이면 필요한 기준을 찾기 어려워집니다.
- 안 쓰는 규칙은 지우고, 자주 어기는 규칙은 눈에 잘 띄는 위치로 옮깁니다.
-
/context: 현재 세션이 불러온 CLAUDE.md 파일 확인 -
/memory: 메모리 파일 위치를 열어 관리 -
CLAUDE.md의 문장은 판단에 참고할 규칙입니다
-
특정 단어가 있는 파일 저장을 반드시 막으려면 Hooks — 자동 검수에서 PreToolUse Hook으로 같은 조건을 검사합니다
-
붙여넣기 예제: 순서의 각 단계 아래. 위에서부터 하나씩 실행합니다
-
현재 도구가 읽는 프로젝트 규칙 파일을 확인하고 초안을 만듭니다.
이 프로젝트의 폴더 구조와 기존 규칙을 읽고, 현재 쓰는 Claude Code 또는 Codex가 읽는 규칙 파일의 위치를 확인해 주세요. 파일이 없으면 프로젝트 설명·자주 쓰는 명령·문체·금지 사항을 담은 초안을 만들고, 있으면 덮어쓰지 말고 필요한 추가 내용을 제안해 주세요. 확인하지 못한 명령은 만들지 말고, 파일 위치와 제가 검토할 부분을 알려 주세요.
확인현재 도구에 맞는 규칙 파일의 위치와 초안 또는 추가 제안을 확인할 수 있습니다.
-
반복해서 말해 온 규칙을 옮겨 적습니다.
방금 확인한 프로젝트 규칙 파일에 제가 정한 규칙인 ‘이모지는 쓰지 않습니다’를 추가해 주세요. 같은 규칙이 있으면 중복해서 넣지 말고, 기존 규칙과 충돌하면 고치기 전에 알려 주세요. 변경한 부분을 보여 주세요.
확인프로젝트 규칙 파일에 이모지 금지 규칙이 중복 없이 들어가고 변경 내용을 확인할 수 있습니다.
-
작업 중 새로 정한 규칙도 같은 파일에 추가하도록 요청합니다.
-
규칙 파일을 실제로 읽었는지 확인합니다.
지금 작업에 적용한 프로젝트 규칙 파일의 경로와 핵심 규칙을 알려 주세요. 실제로 읽은 파일만 답하고, 읽지 않았다면 먼저 읽어 주세요.
확인읽은 규칙 파일의 경로와 적용할 규칙이 함께 나옵니다.
다음 요청에서 그 규칙을 다시 말하지 않아도 지켜지는지 확인해 보세요.
CLAUDE.md에 규칙을 적어 두고, 이후 요청에서 그 규칙을 다시 말하지 않아도 지켜지면 통과입니다.
프로젝트 루트의 CLAUDE.md와 사용자 홈 폴더(~/.claude/CLAUDE.md)는 적용 범위가 다릅니다. 이 둘을 혼동하면 규칙을 적어도 왜 안 지켜지는지 알기 어렵습니다. CLAUDE.md는 Claude가 읽고 따르는 지시문이며, 조건을 어겼을 때 파일 저장을 기계적으로 막는 장치는 아닙니다. 반드시 막아야 하는 조건은 PreToolUse Hook 같은 검사로 옮기고, 실패 입력과 정상 입력을 각각 실행해 확인합니다.
용어 풀이
전체 용어집 →2026-08-19 기준 · 출처 · Claude Code — Memory
결정 원장 — decisions.md 확정한 값과 방향을 한 파일에 날짜순으로 쌓아, 대화가 바뀌어도 무엇이 최신 결정인지 대조할 수 있습니다
- 여러 날에 걸친 프로젝트에서는 지난번에 정한 값이 어디에도 안 남는 일이 생깁니다
- 대화는 끝나면 사라집니다
- 기획서에는 정하기 전의 값이 그대로 적혀 있습니다
무엇을 적나요
- 한 항목에 네 칸
| 칸 | 적을 것 |
|---|---|
| 날짜 | 정한 날 |
| 결정 | 무엇으로 정했는지 |
| 버린 안 | 같이 검토했다가 안 쓰기로 한 것 |
| 적용 범위 | 어느 폴더·어느 화면에 걸리는지 |
- 버린 안을 적어 두면 몇 주 뒤 같은 안이 다시 올라와도, 안 쓰기로 한 이유가 남아 있어 다시 검토하지 않습니다
새 항목은 맨 위에
- 파일 끝에 붙이면 최신을 보려고 매번 끝까지 내려가야 합니다
- 맨 위에 넣으면 파일을 여는 순간 최신이 보입니다
기획서와 다를 때
- 기획서·제안서·초안은 그 시점의 스냅샷입니다
- 값이 바뀌어도 문서는 자동으로 고쳐지지 않으므로, 원장과 다르면 원장을 따릅니다
- 밀려난 문서는 지우지 않고 머리에 한 줄 붙입니다
> 폐기 2026-08-13: 색 기준은 decisions.md 최신 항목을 따릅니다.
- 지우지 않는 이유: 그때 그렇게 정한 까닭이 남아 있으면 다음 결정이 쉬워집니다
요청할 때 같이 붙입니다
- 색 고르기, 문구 쓰기, 화면 구조 만들기 전에 원장을 같이 읽게 합니다
CLAUDE.md에 “시각·문구 작업 전decisions.md최신 항목을 먼저 읽는다”를 한 줄 넣으면 매번 말하지 않아도 됩니다
확정은 내가 합니다
- AI가 대화 중에 스스로 확정이라고 적지 않게 합니다
- 원장에 들어가는 것은 내가 정한 것뿐입니다
- 후보 뽑기와 후보를 확정으로 올리기는 다른 단계입니다
-
프로젝트 폴더에 `decisions.md`를 하나 만듭니다. 맨 위가 최신이 되도록 새 항목을 위에 넣습니다.
이 폴더의 결정 기록을 확인해 주세요. 기존 기록이 있으면 그 위치와 형식을 유지하고, 없으면 decisions.md를 만들어 주세요. 문서에서 확정된 것으로 보이는 내용을 날짜·결정·버린 안·적용 범위로 정리하되, 제가 확인하기 전에는 후보로 표시해 주세요. 기존 기록을 지우거나 후보를 확정으로 바꾸지 말고 파일 위치와 확인할 후보를 알려 주세요.
확인결정 기록의 위치와 후보 목록이 나오며, 기존 기록과 아직 확인하지 않은 후보가 구분됩니다.
-
값이나 방향을 확정할 때마다 그 자리에서 한 줄 넣습니다. 날짜, 무엇을 정했는지, 무엇을 버렸는지, 어디까지 적용되는지를 적습니다.
-
색·문구·구조를 만들기 전에 이 파일의 맨 위부터 읽습니다. 요청에 이 파일을 같이 붙입니다.
-
기획서나 초안이 원장과 다르면 원장을 따릅니다. 밀려난 문서는 지우지 말고 머리에 폐기 표시를 붙입니다.
최근에 정한 것 하나를 골라 원장에 첫 줄로 넣어 보세요. 무엇을 버렸는지까지 적으면 나중에 같은 안이 다시 올라올 때 바로 걸러집니다.
지난주에 정한 값이 무엇이었는지 파일 한 곳을 열어 확인할 수 있으면 통과입니다.
나중에 몰아서 적으면 무엇을 버렸는지 기억이 안 나서 결정만 남고 이유가 사라집니다. 정한 즉시 넣습니다. 새 항목을 파일 끝에 붙이면 최신을 찾으려고 매번 끝까지 내려가야 하고, 같은 날 항목이 위아래로 흩어집니다. 그리고 AI가 스스로 확정이라고 적지 않게 합니다. 결정하는 사람은 나입니다.
용어 풀이
전체 용어집 →조사 기준 문서 research-brief.md에 조사 범위·출처 기준·최신성 기준을 정리해 자료 조사 요청의 기준으로 쓸 수 있습니다
-
research-brief.md는 project-brief.md 다음에 만듭니다
-
조사 기준 다섯 항목: 질문, 출처, 최신성, 범위, 형식
-
project-brief.md를 먼저 읽게 하고, 알아내야 하는 것을 인터뷰하게 합니다
-
한 번에 한 질문씩 구분해서 물을 항목:
-
이 조사로 답하려는 질문
-
인정할 출처와 인정하지 않을 출처
-
언제 이후 자료만 쓸지
-
조사에서 뺄 범위
-
결과를 어떻게 정리해 받을지
-
출처 기준은 조사 주제마다 다릅니다:
-
공식 발표와 원문만 쓸지, 업계 기사까지 인정할지, 커뮤니티 글은 참고로만 둘지 미리 정해 두면 결과를 받아 놓고 다시 걸러 내지 않아도 됩니다.
-
기준 날짜도 함께 정합니다. 날짜를 정하지 않으면 몇 해 전 자료가 지금 상황처럼 섞여 들어옵니다.
-
가장 자주 어긋나는 곳: 수치와 인용. 출처가 없어도 문장은 그럴듯하게 채워집니다
-
수치와 인용에는 링크를 함께 달게 하고, 몇 개는 직접 열어 확인합니다
-
찾지 못한 항목은 사실로 적지 않고 확인하지 못한 것으로 따로 빼 둡니다
-
실습: 아래 요청문을 복사해 붙여넣고 research-brief.md 인터뷰를 시작합니다
AI 뉴스를 수업이나 뉴스레터로 정리할 때
- 소셜 게시물에서 소재를 찾았다면 공식 발표로 이동해 기능·이용 조건·발표일을 확인합니다
- 발표 당시 날짜와 내가 확인한 날짜를 함께 적습니다
- 업체가 제시한 최대 효과를 내 작업의 실측 결과로 쓰지 않습니다
이 뉴스 링크를 검토해 주세요: [링크]
공식 원출처, 발표일, 확인일, 확인한 사실, 이용 조건, 아직 모르는 점을 나눠 적어 주세요.
내 작업은 [업무 한 개]입니다. 시험할 행동 하나와 결과를 확인할 방법을 제안해 주세요.
기존 수업과 겹치면 보강 위치를 알려 주세요. 원출처를 못 찾은 수치는 발행 초안에서 제외해 주세요.
문서 작성까지만 진행하고 설치·결제·반복 수집·실제 발송은 하지 마세요.
- 뉴스레터 초안에 담을 것: 짧은 설명, 공식 출처, 내 작업에서 해볼 일, 연결할 학습 자료
- 강사가 사실과 링크를 확인한 뒤 발송 대상으로 넘깁니다
GPT-6 Astra로 공개 페이지 조사하기
-
2026년 9월 6일 확인한 OpenAI 발표: Astra의 브라우저·프로그램 조작 기능과 순차 제공 안내
-
모델 이름만 선택했다고 화면 조작 도구까지 연결되지는 않습니다
-
사용하는 앱에서 모델 접근 권한과 브라우저 도구의 연결 상태를 확인합니다
-
실습 내용: 공개 상품 페이지를 읽고 비교표 만들기
-
완료 기준: 표를 완성한 뒤 출처를 다시 열어 숫자와 문구를 대조
-
제외: 실제 상품 구매, 페이지 수정
1. 대상과 읽을 범위를 정합니다
- 준비: 로그인 없이 볼 수 있는 상품 페이지 세 개, 조사 기준 문서
- 기록할 값: 상품명, 표시 가격, 가격의 단위, 출처 주소. 배송비처럼 별도로 표시된 금액은 나눠 적습니다
- 화면 조작을 쓸 수 없으면 직접 읽은 문구와 화면 이미지를 전달해 자료 정리만 연습합니다
2. 읽기와 표 작성을 요청합니다
- 아래 주소 세 곳을 실제 페이지 주소로 바꿉니다
- 조사 기준 문서가 있으면 함께 첨부합니다
다음 공개 상품 페이지 세 곳을 조사해 주세요.
[주소 1]
[주소 2]
[주소 3]
첨부한 조사 기준 문서를 먼저 읽고 조사 범위를 요약해 주세요.
연결된 브라우저를 사용할 수 있는지 확인한 뒤 시작해 주세요.
읽기와 링크 이동만 허용합니다. 로그인, 수정, 제출, 구매, 메시지 발송은 하지 마세요.
상품명, 표시 가격, 통화와 판매 단위, 별도 비용, 근거 문구, 출처 주소를 표로 정리해 주세요.
실제로 연 페이지와 확인 날짜를 남기고, 열지 못한 페이지나 보이지 않는 값은 미확인으로 표시해 주세요.
가격을 추측하거나 서로 다른 용량의 상품을 같은 조건처럼 비교하지 마세요.
3. 출처를 다시 열어 결과를 확인합니다
-
표의 세 출처를 직접 열어 상품명·가격·단위를 대조합니다
-
틀린 값이 있으면 해당 행과 원문을 함께 전달해 수정합니다
-
확인하지 못한 항목은 빈칸 대신 이유를 남깁니다
-
비교표를 디자인할 때는 비주얼 기준 문서 카드에서 만든 파일을 첨부합니다
-
아래 요청은 원문 확인이 끝난 뒤 사용합니다
확인한 비교표와 첨부한 디자인 문서를 읽어 주세요.
배경색, 본문 글꼴, 여백 기준과 아직 미정인 값을 먼저 요약해 주세요.
확인한 상품 정보와 출처를 유지한 비교 문서 초안을 만들어 주세요.
새로운 가격이나 근거 없는 순위를 추가하지 마세요.
- 적용 예: 기획자는 경쟁사 상품 비교, 마케터는 공개 행사 안내의 조건 정리, 디자이너는 참고 화면의 문구와 링크 확인
- 결과에 남길 것: 사용한 도구, 확인한 페이지, 미확인 항목, 직접 대조한 결과
- 화면 조작 없이 첨부 자료만 읽었다면 그 방법을 그대로 적습니다
뉴스와 함께 읽습니다
- 한국어 Astra 활용 사례: 소재를 찾는 참고 자료
- 계정별 이용 조건: 공식 발표에서 확인
- 이 실습은 학습용 절차이며, 특정 계정에서 실행한 성능이나 시간 절감 결과를 뜻하지 않습니다
-
알아내야 하는 것을 질문 형태로 적습니다.
project-brief.md를 읽고 research-brief.md를 만들어 주세요. 조사로 답할 질문·인정할 출처·자료의 기준 날짜·제외할 범위·결과 형식을 한 번에 하나씩 물어봐 주세요. 제 답을 확인받아 저장하고, 조사 결과에서 확인한 사실과 미확인 내용을 구분하도록 적어 주세요. 실제 조사는 아직 시작하지 마세요.
확인research-brief.md에 조사 질문, 출처 기준, 날짜, 제외 범위, 결과 형식이 담기며 아직 조사는 실행하지 않습니다.
-
어떤 자료를 출처로 인정할지 정합니다.
-
언제 이후 자료만 쓸지 기준 날짜를 정합니다.
-
조사에서 뺄 범위를 표시합니다.
-
확인한 사실과 아직 확인하지 못한 것을 나눠 적는 형식을 정합니다.
정리된 결과에서 수치나 인용을 하나 골라 링크를 직접 열어 보세요. 원문에 그 문장이 실제로 있는지 확인합니다.
답하려는 질문과 인정할 출처가 적혀 있고, 기준 날짜가 있고, 확인한 사실과 확인하지 못한 것이 나뉘어 있으면 통과입니다.
출처가 없는 수치와 인용은 그럴듯한 문장으로 채워지기 쉬우므로, 링크를 달게 하고 직접 열어 확인합니다. 기준 날짜를 정하지 않으면 몇 해 전 자료가 현재 상황처럼 섞여 들어옵니다.
용어 풀이
전체 용어집 →- 출처(source)
- 그 정보가 어디서 나왔는지 알려주는 근거입니다. 기사 링크, 공식 발표 페이지 같은 것입니다.
2026-09-06 기준 · 출처 · OpenAI — GPT-6 Astra
공개 자료로 브랜드 조사해 기준값 파일 만들기 공식 홈페이지·판매 페이지·리뷰에서 확인한 값만 출처와 함께 sources.md에 적고, 그 값으로 색·글꼴·사실·쓰지 않을 주장을 담은 brand.json을 만들 수 있습니다.
- 브랜드 기준값 파일(brand.json): 콘텐츠 생성기가 읽는 브랜드의 값 목록
- 들어가는 값: 색 코드, 글꼴 이름, 제품 사실, 쓸 수 있는 주장과 쓰지 않을 주장
- 출처 대장(sources.md): 그 값을 어디서 언제 확인했는지
| 정확도 | 뜻 | 예 |
|---|---|---|
| official | 브랜드가 공개하거나 보내 준 값 | 브랜드 가이드의 색 코드 |
| measured | 사진이나 화면에서 직접 잰 값 | 패키지 사진에서 뽑은 대표 색 |
| approx | 근삿값 | 조명이 들어간 사진의 배경 색 |
- 조사 기준: 직접 연 페이지
- 검색 결과 요약에서 가져온 값은 직접 확인한 값과 구분해 적습니다
- 의료·효능처럼 근거 없이 쓰면 문제가 되는 주장은 쓰지 않을 주장으로 따로 적습니다
- 이후 채널별 문구 검사가 그 목록을 그대로 씁니다
-
조사할 페이지를 정하고, 열지 못한 페이지가 무엇인지 먼저 확인합니다.
[브랜드 이름]의 공식 홈페이지 [주소], 판매 페이지 [주소], 인스타그램 [@계정]을 열어 브랜드 조사를 시작해 줘. 먼저 실제로 연 페이지와 열지 못한 페이지를 표로 보여 줘. 로그인 때문에 열리지 않는 곳은 우회하지 말고, 내가 어떤 화면을 캡처해 폴더에 넣으면 되는지 알려 줘.
확인연 페이지와 못 연 페이지가 나뉜 표가 나오고, 못 연 페이지마다 필요한 캡처 화면이 적혀 있습니다.
-
확인한 사실을 출처 대장에 적게 합니다.
확인한 사실(제품 구성, 가격, 리뷰 수와 평점, 인증, 개발 이력)을 sources.md에 표로 적어 줘. 값마다 출처 주소, 확인한 날짜, 다시 확인할 주기를 붙여 줘. 두 출처의 값이 다르면 둘 다 적고 어느 쪽을 쓸지 나에게 물어봐 줘.
확인sources.md에 값·출처·확인 날짜·재확인 주기 네 칸짜리 표가 생기고, 값이 갈린 항목은 따로 질문으로 나옵니다.
-
출처 대장에 있는 값만으로 기준값 파일을 만듭니다.
sources.md에 있는 값만으로 brand.json을 만들어 줘. 색은 값, 쓰는 자리, 정확도(official 공식 값, measured 사진에서 잰 값, approx 근삿값), 출처를 함께 적어 줘. 쓸 수 있는 주장, 쓰지 않을 주장, 쓰지 않을 낱말을 나눠 적고, 근거가 없어 비워 둔 칸은 목록으로 알려 줘.
확인brand.json에 색·글꼴·사실·주장 칸이 생기고, 비워 둔 칸 목록이 따로 나옵니다.
-
기준값과 출처 대장을 한 줄씩 대조하게 합니다.
brand.json의 값 하나하나가 sources.md의 어느 줄에서 왔는지 대조표를 만들어 줘. 출처가 없는 값은 지우거나 미정으로 바꾸고, 바꾼 줄을 알려 줘.
확인brand.json의 모든 값 옆에 sources.md의 줄이 붙은 대조표가 나오고, 출처 없는 값이 남아 있지 않습니다.
내가 자주 쓰는 브랜드 하나의 공식 홈페이지만으로 brand.json을 만들고, 정확도가 measured나 approx인 색이 몇 개인지 세어 보세요.
brand.json의 모든 값에 sources.md의 출처 줄이 있고, 대조표에 출처 없는 값이 0개입니다.
검색 요약에 나온 리뷰 수나 평점은 실제 페이지와 다를 수 있으므로, 직접 연 페이지의 값과 나란히 적고 직접 연 쪽을 씁니다. 가격과 리뷰 수는 자주 바뀌어서 재확인 주기를 짧게 둡니다. 사진에서 뽑은 색은 조명에 따라 달라지므로 measured로 표시하고, 브랜드에서 받은 값이 생기면 official로 바꿉니다.
2026-10-07 기준 · 출처 · Design Tokens Format Module (W3C Design Tokens Community Group)
