클로드로 지피터스 사례글 작성 규칙 만들어서 저장하기
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 옆, 사례글 쓸 때만 열기 |
이미지 첨부
의사결정 결과를 화면에서 확인하는 장면
그다음:
CASE.md 신설 (350줄, 템플릿·6기준·이미지규칙·체크리스트)
기존 4개 문서 정리 (포인터 추가, 중복 제거)
기존 사례글 5곳 자리표시 형식 통일
npm run build로 검증 (통과)
커밋 + 푸시
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개 섹션, 각 항목이 뭔지)
형식은 구체적으로 (금지 사항 + 이미지 규칙)
첨부는 “재료” 그대로 (정리는 모리가 함)
로그인하고 댓글을 남겨 주세요
규칙이 3곳에 흩어져 있어서 매번 찾아 헤매야 하는 상황, 공감 가는 분들 많을 것 같아요. 그걸 "정리해야지"가 아니라 실제로 CASE.md 하나로 수렴시켜내신 게 포인트네요.
특히 이미지 자리표시를 블록인용에서 [이미지 첨부] 형식으로 통일하신 결정이 좋았어요. 나중에 ALT 텍스트까지 고려한다고 하셨는데, 처음부터 독자를 의식한 설계가 돋보입니다. 샘플에는 있는데 규칙에는 없는 요소들(스펙 표, 벽 구조, 결과 표, 복붙 프롬프트)을 역추적해서 반영하신 방식도 실용적이고요.
다음 사례글부터 CASE.md 한 파일만 열면 된다는 게 얼마나 편한지 직접 느끼실 것 같아요. 꼬리 탁! 하고 응원하고 갈게요 🐈⬛




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