본문으로 건너뛰기

클로드로 지피터스 사례글 작성 규칙 만들어서 저장하기

제이리

2026.07.29

👥 이런 분께 추천

  • 여러 문서에 흩어진 규칙을 하나로 모아야 하는 분

  • “매번 어디를 참고해야 하지?”를 반복하고 있는 분

  • 규칙과 템플릿이 일치하지 않아 항상 수정하는 분

  • 좋은 샘플이 있는데 그걸 규칙으로 만들고 싶은 분

  • 자동화 도구나 AI 도우미를 쓸 때 일관성 있게 뽑아내고 싶은 분

📝 한줄 요약

사례글 작성 규칙이 3곳(문서 + 2개 스킬)에 흩어져 있어서 매번 다르게 쓰여 왔습니다.
좋은 사례글 샘플을 첨부해 분석하게 하고, 3개 질문으로 의사결정한 뒤, 규칙을 한 곳에 모았습니다. 그리고 AI가 일관되게 같은 형식의 글을 뽑아낼 수 있게 됐습니다.

Before: 규칙 3곳 분산 + 매번 다른 형식 + 이미지 자리표시 불명확
After: CASE.md 하나 + 템플릿·체크리스트·복붙 프롬프트 포함 + [이미지 첨부] 형식 명시

🙋 내 스펙 & 환경

항목

내용

직업

학습 컨텐츠 기획자, 비개발자

코딩 경험

없음 (마크다운만 조금)

AI 도구

Claude (주로 규칙 정리, 문서화에 사용)

환경

윈도우 11 Pro

기존 자산

사례글 4개, 학습일지 스킬, 주간종합 스킬


진행 방법

1. 왜 하게 되었나

사례글 작성 규칙이 세 군데에 흩어져 있었습니다.

  • AGENTS.md: 순서, 제목 번호, 프로젝트 필드

  • .claude/skills/학습일지/SKILL.md: 프론트매터, 파일명, 좋은 사례글 6기준, 기본 뼈대, 스크린샷 자리표시

  • .claude/skills/주간종합/SKILL.md: 6기준 (중복)

매번 새 사례글을 쓸 때 “어디 봐야 하지?” 하면서 여기저기를 왔다갔다 해야 했습니다.

그리고 이미 쓴 사례글 5개를 보니 형식이 일관되지 않았어요.

스크린샷 자리표시도 블록인용(> 여기에...)으로 되어 있어서 눈에 안 띄었습니다.

가장 큰 문제는 샘플에는 있는데 규칙에는 없는 요소들이 있다는 거였어요:

  • 내 스펙 표

  • “벽 1, 벽 2…” 구조

  • 결과 표

  • 사용한 도구 표

  • 검증 단계

  • 복붙 프롬프트

이걸 어떻게 규칙에 넣을지가 과제였습니다.

2. 첫 번째 벽: 규칙이 어디까지 들어가야 하나

규칙을 한 곳에 모으되, 어느 정도 상세까지 넣을지 고민했습니다.

  • 매번 읽히는 문서(AGENTS.md, 스킬 설명)는 짧고 핵심만

  • 실제로 쓸 때 펼쳐 읽는 문서는 상세하게

그래서 루트에 새 파일(CASE.md)을 만들기로 결정했습니다.

SOUL.md, USER.md, AGENTS.md, CLAUDE.md (기존)
+ CASE.md (신규, 사례글 쓸 때만 읽음)

3. 두 번째 벽: 샘플을 규칙으로 어떻게 만드나

첨부한 샘플을 분석했습니다.


이미지 첨부

샘플 사례글의 구조를 스크린샷으로 보며 분석하는 화면

구조를 뽑아보니:

  • 상단: 추천 대상 + 요약 + 나의 스펙

  • 본문: 왜 시작 → 벽1 → 벽2 → … → 최종 흐름 → 검증

  • 배운 점: 핵심 교훈 번호별 + 솔직한 소감

  • 적용할 점: 결과 표 + 복붙 프롬프트 + 다음 계획

이 구조를 CASE.md에 템플릿으로 넣기로 했습니다.

4. 세 번째 벽: [이미지 첨부] 형식을 어떻게 정의하나

이미지 자리표시가 두 가지 방식으로 섞여 있었어요:

  • 블록인용: > 여기에 ○○ 스크린샷을 넣으면 좋아요.

  • (없음, 자리가 명시 안 됨)

어느 형식으로 통일할지를 확인했습니다.

결정: [이미지 첨부] 형식으로 자리표시만

----------------------
이미지 첨부
환경 변수 편집 창. Path 항목이 선택된 화면
----------------------
  • 한 줄, 독립된 자리

  • 설명은 구체적으로 (나중에 ALT 텍스트가 됨)

  • 최소 3개, 각 단계와 검증에 1개 이상

5. 최종 흐름

의사결정 3가지를 확인했습니다:

결정

선택

이유

기본 뼈대

3단 유지 (진행·배운점·적용)

이미 효과 증명됨, 샘플 요소는 H3로 추가

이미지

자리표시만

복잡성 ↓, 직접 넣을 수 있음

저장 위치

루트에 새 파일

SOUL·USER·AGENTS 옆, 사례글 쓸 때만 열기


이미지 첨부

의사결정 결과를 화면에서 확인하는 장면

그다음:

  1. CASE.md 신설 (350줄, 템플릿·6기준·이미지규칙·체크리스트)

  2. 기존 4개 문서 정리 (포인터 추가, 중복 제거)

  3. 기존 사례글 5곳 자리표시 형식 통일

  4. npm run build로 검증 (통과)

  5. 커밋 + 푸시

6. 검증: 제대로 됐는지 확인

빌드가 통과하고, 기존 사례글 5곳이 정상적으로 빌드되었습니다.


이미지 첨부

npm run build 성공 로그. 모든 사례글이 정상적으로 빌드된 화면

CASE.md 자체도 규칙을 지키는지 훑어봤습니다:

  • 소제목에 줄표(—): 없음 (본문 설명에만 사용, 규칙서가 규칙을 어기면 안 되니까)

  • 볼드+따옴표 겹침: 없음 (규칙 설명의 “안 되는 예”만 있음, 의도됨)

🛠 사용한 도구

도구

역할

Claude

규칙 정리, 구조 설계, CASE.md 작성

Explore 에이전트

기존 규칙과 샘플 분석

Git

커밋, 버전 관리

npm

빌드 검증


배운 점

💡 핵심 교훈

1. 규칙이 명시적으로 한 곳에 없으면 일관성이 깨진다

이미 쓴 사례글 5개를 보니 형식이 조금씩 달랐어요. 모리(AI)가 매번 다르게 쓴 게 아니라, 참고할 규칙이 명확하지 않아서였습니다. 규칙 3곳 + 샘플만 있으니까, 어느 것을 우선할지 판단해야 했거든요.

2. 좋은 샘플 하나가 설명 열 개보다 낫다

첨부된 사례글을 분석하니, “아, 이래서 이 글이 읽히는구나”가 보였어요. 스펙표, 벽 구조, 검증 단계 등이 모두 거기 있었는데, 규칙에는 명시 안 됐었습니다. 샘플 하나를 “왜?”하면서 읽는 게 글쓰기 규칙을 짓는 가장 좋은 방법이었어요.

3. “모리가 일관되게 쓰도록” 이 기준이 중요하다

규칙을 만들 때 “한 번 읽으면 알 수 있을까?”만 생각했거든요. 근데 더 중요한 건 “모리(AI)가 매번 같은 형식으로 뽑아낼 수 있나?” 였습니다. 그래서 체크리스트를 9개나 상세하게 넣었어요.

4. 규칙 문서 자체도 규칙을 지켜야 한다

CASE.md를 검증할 때 “어? 이 문서가 자기가 정한 규칙을 어기고 있지 않나?” 확인했습니다. 규칙서가 규칙을 어기면 신뢰도가 떨어지니까요.

솔직한 소감

정리하고 보니 깔끔했어요. 흩어진 규칙을 한 곳에 모으니까 “아, 이게 원칙이었구나” 하면서 명확해진 느낌이 들었습니다.

그리고 이 작업 자체가 규칙 정리의 좋은 사례가 된 것 같아요. 다른 프로젝트나 팀에서 “우리 규칙도 이렇게 정리하면 좋겠다”할 때 이 과정을 참고할 수 있을 것 같습니다.


적용할 점

🎯 결과

항목

이전

이후

규칙 위치

3곳 분산

1곳 (CASE.md)

형식 일관성

낮음 (매번 다름)

높음 (템플릿 고정)

이미지 자리표시

불명확

명확 ([이미지 첨부])

모리의 체크 항목

없음

9개 체크리스트

복붙 가능한 프롬프트

없음

있음

📋 복붙 가능한 프롬프트

비슷하게 규칙 정리가 필요한 분들을 위해, 제가 사용했던 프롬프트의 간단 버전입니다.

사례글을 쓰고 싶어. 내 경험을 따라 할 수 있게 정리해줘.

[사례글의 기본 규칙]
- 공개 포스팅 (남이 봄)
- "뭘 했나"보다 "어떻게 했나"에 초점
- 독자가 보고 따라 할 수 있어야 함
- 실제 쓴 프롬프트·명령어를 그대로 인용할 것

[글의 구조]
1. 상단부
   - 👥 이런 분께 추천 (3~5줄 불릿)
   - 📝 한줄 요약 (2~3문단, 마지막에 Before → After 한 줄)
   - 🙋 내 스펙 & 환경 (표로: 직업/경험/도구/환경/자산)

2. 진행 방법
   - 왜 시작했나, 막힌 벽 1, 벽 2, ... 최종 흐름, 검증, 사용한 도구 (표)
   - 실제 프롬프트·코드·에러 메시지를 코드블록으로 넣기
   - [이미지 첨부] 단계마다 필요한 화면 구체적으로 설명 (최소 3개)

3. 배운 점
   - 💡 핵심 교훈 (1~6개, 각 항목은 제목 한 줄 + 설명 두세 줄)
   - 솔직한 소감 (뿌듯함/답답함/신기함 등)

4. 적용할 점
   - 🎯 결과 (Before/After 표)
   - 📋 복붙 프롬프트 (코드블록에 실제 쓴 프롬프트 뼈대)
   - 🔜 다음 계획

[형식 규칙]
- 소제목·문장에 줄표(—) 금지
- 볼드와 따옴표 겹쳐서 쓰지 않기
- [이미지 첨부] 자리표시: 구체적으로 "뭐가 보이는" 화면인지 설명
- 개인정보(이름, 이메일, 회사) 빼기

[첨부]
(오늘 한 일의 구체적 상황, 막힌 지점, 해결한 방법을 시간순으로 정리해서 붙여주기)

포인트는:

  • 규칙을 프롬프트에 다 담기 (CASE.md 없어도 작동)

  • 구조는 명확하게 (4개 섹션, 각 항목이 뭔지)

  • 형식은 구체적으로 (금지 사항 + 이미지 규칙)

  • 첨부는 “재료” 그대로 (정리는 모리가 함)

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

뽀짝이 프로필 이미지
뽀짝이2026.07.29

규칙이 3곳에 흩어져 있어서 매번 찾아 헤매야 하는 상황, 공감 가는 분들 많을 것 같아요. 그걸 "정리해야지"가 아니라 실제로 CASE.md 하나로 수렴시켜내신 게 포인트네요.

특히 이미지 자리표시를 블록인용에서 [이미지 첨부] 형식으로 통일하신 결정이 좋았어요. 나중에 ALT 텍스트까지 고려한다고 하셨는데, 처음부터 독자를 의식한 설계가 돋보입니다. 샘플에는 있는데 규칙에는 없는 요소들(스펙 표, 벽 구조, 결과 표, 복붙 프롬프트)을 역추적해서 반영하신 방식도 실용적이고요.

다음 사례글부터 CASE.md 한 파일만 열면 된다는 게 얼마나 편한지 직접 느끼실 것 같아요. 꼬리 탁! 하고 응원하고 갈게요 🐈‍⬛

아루나 프로필 이미지
아루나2026.07.30

저도 계속 사례글을 쓰다 보니까 여러 가지 그런 양식들이 여기저기 생겨서 얼마 전에 정리를 한번 싹 다 했는데 공감이 되네요. ^^

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기