5-Color Harness

쓰시는 분이 문서 종류를 한 단어만 말하면, 그 문서를 잘 쓰게 만드는 Claude·ChatGPT 프로젝트 지침 한 벌을 즉시 만들어 드립니다. 이메일, 보고서, PPT, 계약서, 이력서 어느 것이든 됩니다.

이 지침을 프로젝트에 한 번 붙여 두면, 그 뒤로 그 프로젝트가 내놓는 모든 문서가 다섯 전문가의 평가를 자동으로 거칩니다. 초안을 쓰는 실무자 한 명과, 논리·전문성·공감·독자 시선으로 채점하는 비평가 네 명입니다.

라이브 데모 · 5color.airoasting.com

즉석 캐스팅 외에, 직장인이 자주 쓰는 25개 영역을 미리 짜 둔 카드 갤러리도 함께 있습니다. 카드 한 장이 곧 그 영역용 프로젝트 지침 한 벌입니다. 아래 카드 갤러리에서 확인하실 수 있습니다.

---

5색 메타포

세 비평가는 사고 모드가 서로 다릅니다. 한 색이 다른 색의 자리를 침범하면 그 발언은 무효입니다. GOLD는 인구통계가 아니라 상황으로 정의합니다. 예를 들어 "월요일 9시 30분, 이사회 직전에 5장짜리 보고서를 처음 펼친 CEO"입니다.

자세한 캐스팅 9원칙과 출력 템플릿은 SKILL.md에 있습니다.

---

60초 시작

코드도 설치도 필요 없습니다. 쓰시는 Claude나 ChatGPT에 지침 한 벌을 붙여 두면 끝입니다.

1. 카드 갤러리 5color.airoasting.com를 엽니다.
2. 만들려는 문서 종류(이메일, 보고서, 계약서, 이력서 등)의 카드를 고릅니다.
3. 카드에 담긴 지침을 복사해, 쓰시는 Claude나 ChatGPT의 “프로젝트” 지침 칸에 붙이고 저장합니다.
4. 그 뒤로 그 프로젝트에 무엇을 맡기든, BLACK이 초안을 만들고 RED·SILVER·BLUE·GOLD 네 전문가가 10점 만점으로 함께 평가합니다.

갤러리에 없는 문서 종류가 필요하면, 아래 개발자용 방식으로 한 단어만 쳐도 그 자리에서 전용 지침을 만들어 냅니다.

Claude Code로 쓰기 (개발자용)

터미널에서 스킬을 한 번 설치합니다.

git clone https://github.com/airoasting/5color.git ~/.claude/skills/5color

세션에서 문서 종류를 한 단어로 칩니다. 예를 들어 "이메일"입니다. 그 영역 전용 지침이 한 벌 나오는데, 분량은 한국어로 3,000자에서 5,500자, 영문으로 1,400에서 2,600단어입니다. 그대로 복사해 Claude나 ChatGPT 프로젝트의 지침 칸에 붙이면 위 4번과 똑같이 작동합니다. claude.ai 웹에서 쓰실 때는 SKILL.md의 본문을 지침 칸에 붙여도 같은 결과가 됩니다.

---

트리거

작업 영역을 한 마디라도 말하면 즉시 캐스팅합니다. 되묻지 않습니다.

• 한국어 단어 하나: “이메일”, “보고서”, “PPT”, “계약서”, “이력서”
• 영문 단어 하나: “email”, “deck”, “memo”, “resume”
• 문장: “외부 비즈니스 이메일 지침”, “make a system prompt for cover letter”

영문 트리거는 references/english-augment.md를 자동으로 함께 읽어, BLACK과 GOLD를 영어 환경 인물로 캐스팅하고 평가도 영문으로 진행합니다.

복합 산출물, 예를 들어 "영업 덱과 발표 스크립트"는 본체 한 영역을 정하고 나머지를 BLACK의 제약으로 흡수합니다. 시리즈물이면 캐스팅에 고정 자산 한 줄이 붙습니다.

라우팅이 갈릴 수 있는 입력은 분기 규칙을 따릅니다. 랜딩 페이지는 마케팅의 웹사이트 제작 행으로, 이미지 프롬프트는 이미지 제작 행으로 흡수합니다. 영업 덱과 피치덱은 외부 커뮤니케이션으로, 영업 제안서와 RFP는 의사결정·전략으로 갈립니다.

다음은 트리거하지 않습니다. 이미 만든 산출물을 평가·요약·번역·계수하는 일, 단순 사실 검색, 기계적 변환입니다. 이 스킬은 system instruction을 만드는 도구이지, 산출물 자체를 평가하는 도구가 아닙니다.

---

카테고리·합격선·종결 체

상세한 표는 SKILL.md에 있습니다. 요약은 이렇습니다.

• 카테고리 8개. 의사결정·전략, 분석·보고서, 외부 커뮤니케이션, 마케팅, 내부 커뮤니케이션, 법무 검토·규제 대응, 커리어·상담, 소셜미디어·글쓰기입니다. 표에 없는 과제는 외부 커뮤니케이션을 최종 fallback으로 씁니다. 이 여덟은 스킬이 캐스팅할 때 쓰는 축이라 references/ 파일 구조와 같습니다. 아래 카드 갤러리의 일곱 카테고리는 리더가 어느 방에 들어가는지로 가른 별개의 축입니다.
• 합격선 3군. 9.0은 시·소설·블로그처럼 작가의 톤이 자산인 영역이고, 9.5는 표준이며, 9.7은 계약서·이사회·IR·위기 대응처럼 결함이 곧 손실인 영역입니다.
• 종결 체. 작업 영역마다 다릅니다. 한 산출물 안에 두 체가 섞이면 위반입니다.
• em dash 0개. 산문 본문에 em dash가 한 개라도 있으면 자동 실패입니다. 수 사이의 범위 표기는 예외로, 한국어는 물결표를, 영문은 하이픈이나 "to"를 씁니다.

---

카드 갤러리

스킬이 작업 영역을 즉석에서 캐스팅한다면, 카드 갤러리는 직장인이 자주 쓰는 25개 영역을 미리 짜 둔 라이브러리입니다. 카드 한 장이 곧 그 영역용 프로젝트 지침 한 벌입니다. 카드를 열어 5인 페르소나와 합격선을 확인하고, 지침을 복사해 프로젝트 박스에 붙이면 됩니다. 갤러리는 5color.airoasting.com에서 바로 열 수 있습니다.

카테고리는 부서가 아니라 장면으로 갈랐습니다. 그 문서를 쓰는 사람이 어떤 일을 하고 있는지가 기준입니다.

IR, 주주 서한, M&A, 카피라이팅, 보도자료처럼 회사마다 쓰는 사람이 몇 명뿐인 직군 전용 카드는 두지 않습니다. 진열대에 섞어 두면 나머지 사람이 "나를 위한 사이트가 아니다"라고 느끼기 때문입니다. 기준은 output/5color_worker_eval_20261006.md에 적어 두었습니다.

카드 한 장은 여섯 절로 되어 있습니다. Role(5인 페르소나), Rubric(합격 기준과 점수 눈금, 판정 규칙), Workflow(입력 확인부터 반복 제한까지), Tools(웹 검색·업로드 파일·계산을 어디에 쓰는지), Context(산출물 구성과 좋은 예·나쁜 예, 문체와 분량), Guardrails(공통 금지, 카드별 금지, 적용하지 않는 경우) 순서입니다. 모델이 누가, 무엇을 기준으로, 어떤 순서로 일하는지 먼저 알고, 그다음 도구와 배경 지식과 금지 사항을 읽게 하려는 순서입니다.

카드 일곱 장에는 별 배지가 붙습니다. 리더가 남에게 못 맡기고 직접 붙잡아야 하는 자리, 그리고 틀리면 손해가 큰 자리부터 골랐습니다.

리서치·자료조사, 의사결정 요청 보고서, 사업 기획안, 어려운 메시지, 성과 평가·피드백, 협상 전략 브리프, AI 글 자연스럽게 다듬기 일곱 장입니다. 2026-10-06부터는 리더 한 사람이 아니라 그 문서를 실제로 쓰는 사람을 기준으로 채점합니다. 선정 기준과 점수는 output/5color_pick_eval_20260715.md에 적어 두었습니다. 목록은 손으로 고르지 않습니다. scripts/select_picks.py가 점수표에서 유도합니다.

카드 25장 전원이 기계 검사 9종을 통과합니다. 코드펜스와 산문 em dash, 브래킷 잔존, 분량, 끝줄 안내, 비평가 톤 중복, 자평 문구, 내부 어휘 유출, 다른 산출물로 넘김을 봅니다. scripts/validate_output.py로 직접 돌려 보실 수 있습니다. 카드 채점과 개선 리포트는 output/ 폴더에 있습니다.

---

폴더 구조

저장소 루트가 곧 스킬입니다. SKILL.md와 references/·evals/가 스킬 본체이고, 카드 갤러리는 docs/에, 이 README는 루트에 있습니다.

5color/  (저장소 루트 = 스킬)
├── SKILL.md                  스킬 본문
├── README.md                 이 파일
├── LICENSE                   Apache License 2.0
├── references/               카테고리별 매핑·문체·금지 뱅크
│   ├── decision-strategy.md  의사결정·전략
│   ├── analysis-report.md    분석·보고서
│   ├── external-comm.md      외부 커뮤니케이션
│   ├── marketing.md          마케팅
│   ├── internal-comm.md      내부 커뮤니케이션
│   ├── legal-regulatory.md   법무 검토·규제 대응
│   ├── career-counseling.md  커리어·상담
│   ├── social-writing.md     소셜미디어·글쓰기
│   ├── english-augment.md    영문 트리거 시 자동 추가
│   └── examples.md           풀 출력 예시 5종
├── evals/                    트리거 정확도·출력 품질 평가 셋 (6케이스 × 3회)
├── scripts/                  기계 검사와 카드 도구
│   ├── validate_output.py    출력 직전 기계 검사 9종
│   ├── select_picks.py       점수표에서 별 배지 카드를 유도
│   └── score_cards.py        카드 전체 채점
├── docs/                     카드 갤러리 (라이브: 5color.airoasting.com)
│   ├── index.html            갤러리 페이지
│   └── assets/               이미지·폰트·로고
└── output/                   카드 채점·개선 리포트

작업 영역을 추가하려면 해당 카테고리의 references/ 파일만 손보면 됩니다. 처음 쓰실 때는 references/examples.md의 풀 예시 5종으로 톤과 구조를 익히실 수 있습니다.

갤러리를 로컬에서 띄우기

docs/는 빌드가 없는 정적 페이지입니다. 정적 서버 하나만 있으면 그대로 열립니다.

npx serve docs -l 5176

첫 화면의 사진은 docs/assets/images/5color-seq/f_001.png 한 장입니다. 이 파일에는 색공간 청크(cICP/cHRM/gAMA)가 없어야 합니다. 브라우저가 이미지에만 색 변환을 적용하는 탓에, 청크가 남아 있으면 사진과 그 위쪽 여백이 화면에서 다른 색으로 보입니다. 사진을 갈아끼울 때는 청크를 지우고 넣습니다.

예전에는 이 자리에 240장짜리 사진 시퀀스를 스크롤로 재생했습니다. 2500px의 스크롤을 쓰고 남기는 정보가 정지 사진 한 장과 같아서 걷어냈고, 그 자리는 프롬프트 실물을 보여주는 두 번째 화면이 이어받았습니다.

---

트러블슈팅

• 5색 평가가 자동으로 돌지 않습니다. 마크다운에 ## Workflow 절이 빠짐없이 들어갔는지 확인합니다.
• 결함이 곧 손실인 영역인데 금지가 헐겁습니다. "이 영역은 합격선 9.7이니 직접 인용 금지를 네다섯 개로"라고 한 줄 던지면 다시 생성합니다.
• 영문 트리거인데 한국어가 나옵니다. "in English"를 명시하거나, references/english-augment.md가 있는지 확인합니다.
• 페르소나가 서로의 자리를 침범합니다. "RED는 이성, BLUE는 공감만"이라고 한 줄 던지면 다시 캐스팅합니다.
• em dash가 보입니다. "본문 em dash 0개로 다시"라고 한 줄 던집니다.

평가 셋과 60초 점검법은 evals/EVALS_GUIDE.md에 있습니다.

---

업데이트 내역

---

라이선스

Apache License 2.0입니다. Copyright 2026 AI ROASTING. 전문은 LICENSE에 있습니다.