5-Color Harness
쓰시는 분이 문서 종류를 한 단어만 말하면, 그 문서를 잘 쓰게 만드는 Claude·ChatGPT 프로젝트 지침 한 벌을 즉시 만들어 드립니다. 이메일, 보고서, PPT, 계약서, 이력서 어느 것이든 됩니다.
이 지침을 프로젝트에 한 번 붙여 두면, 그 뒤로 그 프로젝트가 내놓는 모든 문서가 다섯 전문가의 평가를 자동으로 거칩니다. 초안을 쓰는 실무자 한 명과, 논리·전문성·공감·독자 시선으로 채점하는 비평가 네 명입니다.
라이브 데모 · 5color.airoasting.com
즉석 캐스팅 외에, 직장인이 자주 쓰는 25개 영역을 미리 짜 둔 카드 갤러리도 함께 있습니다. 카드 한 장이 곧 그 영역용 프로젝트 지침 한 벌입니다. 아래 카드 갤러리에서 확인하실 수 있습니다.
5색 메타포
| 색 | 역할 | 정체 |
|---|
| BLACK | 수행자 | 그 작업 영역 베테랑 15년차 이상 |
| RED | 이성 비평가 | 논리, 근거, 결론의 타당성 |
| SILVER | 분야 전문가 비평가 | 베테랑이 첫눈에 짚는 디테일 |
| BLUE | 공감 비평가 | 수신자의 감정, 톤, 진정성 |
| GOLD | 독자 | 시간·장소·행위·심리로 정의된 한 사람 |
세 비평가는 사고 모드가 서로 다릅니다. 한 색이 다른 색의 자리를 침범하면 그 발언은 무효입니다. GOLD는 인구통계가 아니라 상황으로 정의합니다. 예를 들어 "월요일 9시 30분, 이사회 직전에 5장짜리 보고서를 처음 펼친 CEO"입니다.
자세한 캐스팅 9원칙과 출력 템플릿은 SKILL.md에 있습니다.
60초 시작
코드도 설치도 필요 없습니다. 쓰시는 Claude나 ChatGPT에 지침 한 벌을 붙여 두면 끝입니다.
- 카드 갤러리 5color.airoasting.com를 엽니다.
- 만들려는 문서 종류(이메일, 보고서, 계약서, 이력서 등)의 카드를 고릅니다.
- 카드에 담긴 지침을 복사해, 쓰시는 Claude나 ChatGPT의 "프로젝트" 지침 칸에 붙이고 저장합니다.
- 그 뒤로 그 프로젝트에 무엇을 맡기든, 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에서 바로 열 수 있습니다.
카테고리는 부서가 아니라 장면으로 갈랐습니다. 그 문서를 쓰는 사람이 어떤 일을 하고 있는지가 기준입니다.
| 카테고리 | 카드 수 | 장면 |
|---|
| 보고·기획 | 8 | 상사에게 보고하고, 결정과 결재를 받아 냅니다 |
| 메일·사내 소통 | 5 | 메일을 보내고, 회의를 정리하고, 어려운 말을 전합니다 |
| 팀 운영 | 4 | 팀원과 면담하고, 평가하고, 방향을 말합니다 |
| 제안·협상 | 3 | 밖에 제안하고, 협상하고, 계약서를 봅니다 |
| 글쓰기·브랜딩 | 5 | AI 글을 다듬고, 개인의 이름으로 글을 냅니다 |
| 합계 | 25 | |
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에 있습니다.
업데이트 내역
| 버전 | 날짜 | 내용 |
|---|
| v1.0 | 2026‑05‑02 | 첫 배포. 멀티 페르소나 생성기와 카드 갤러리, 소셜 카드용 OG·Twitter 메타 태그를 올렸습니다. |
| v1.1 | 2026‑05‑03 | 5-Color Harness로 리브랜딩했습니다. 다섯 페르소나 정체성을 전면 개정하고, Pick 배지와 히어로 카피를 정비했습니다. |
| v1.2 | 2026‑05‑18 | 카드 65장의 9섹션을 전수 재작성해 구성 품질을 9.5점 이상으로 끌어올렸습니다. 9.7군을 분리하고, 카드 신규 추가와 모바일 UX 개편, 문법 교정을 함께 진행했습니다. |
| v1.3 | 2026‑06‑28 | 히어로 영상 시퀀스와 스크롤 안무를 추가하고, 썸네일·파비콘을 갱신했습니다. 스킬 본문의 라우팅과 합격선을 10점 수준으로 보정했습니다. |
| v1.4 | 2026‑07‑04 | 스킬을 저장소 루트로 평탄화하고 웹 파일을 docs/로 분리했습니다. README를 비즈니스 리더 관점으로 재작성하고, 랜딩 페이지에 '스킬 활용법' 섹션을 추가했습니다. |
| v1.6 | 2026‑07‑30 | 첫 화면을 사진 시퀀스로 바꿨습니다. 240프레임을 원본 1280x720으로 다시 뽑아 화면을 꽉 채우고, 히어로 문구는 사진 아래로 내리고 상단 헤더는 인트로가 끝날 때 나타나게 했습니다. 이동 속도를 하나로 통일했습니다. 프레임 보간의 지수 감쇠와 키별로 달랐던 지속시간, 버튼 자동 재생의 구간별 곡선을 모두 등속으로 바꾸고 두 구현을 한 컨트롤러로 합쳤습니다. 휠·아래 화살표·스페이스·하단 버튼이 한 번 조작으로 끝까지 재생하고, 같은 방향으로 계속 굴리면 재생을 끊고 그 방향 끝까지 갑니다. 프레임은 첫 장을 먼저 받고 나머지를 재생 순서대로 나눠 받습니다. |
| v1.7 | 2026‑08‑02 | 첫 화면을 사진 시퀀스에서 표제·프롬프트 두 화면으로 재구성했습니다. 240장 시퀀스와 2500px 활주로를 걷어내고 정지 사진 한 장으로 줄였습니다(에셋 33MB 정리). 사진 위에 로고와 표제, 한 줄 설명을 얹어 첫 화면만 보고도 무슨 사이트인지 알 수 있게 하고, 다섯 라벨을 직함에서 동사로 바꿨습니다. 세 화면이 같은 방식으로 이어집니다. 각 화면은 위로 스크롤되다가 윗변이 화면 맨 위에 닿으면 sticky가 거기서 잡아 세우고, 멈춰 있는 동안 다음 화면이 그 위를 덮으며 올라옵니다. 사진 화면은 멈추기 전까지 잘려 있던 아래쪽을 드러냅니다. 상단 헤더는 고정하지 않았습니다. 인트로 두 화면이 끝나는 자리에 놓여 내용과 함께 위로 올라갑니다(모바일은 햄버거 메뉴와 고정 검색바가 걸려 있어 기존대로 상단 고정이고, 사진도 연출 없이 표제 아래에 붙습니다). 두 번째 화면은 다크 배경에 5인 지정 프롬프트를 터미널 타이핑으로 보여줍니다. 중복이던 크림색 히어로는 표제 줄로 줄였습니다. 모바일에서 상단 헤더가 나타나지 않던 문제와 복사 토스트가 뜨지 않던 문제를 함께 고쳤습니다. |
| v1.8 | 2026‑09‑27 | 카드 35장의 프롬프트를 Role → Rubric → Workflow → Tools → Context → Guardrails 여섯 절로 다시 짰습니다. 비유와 AI 말투를 걷어내고, 업무 지시서처럼 한 문장에 한 가지 내용만 쓰도록 모두 다시 썼습니다. 겹치던 절과 규칙은 한 곳으로 모았습니다. 점수 눈금은 점수별 표로 바꿨고, 카드마다 쓸 도구를 적는 Tools 절을 새로 넣었습니다. 페르소나 줄을 - BLACK 수행자:, - GOLD 독자: 꼴로 맞춰 상세 화면의 편집·끄기가 다섯 명 모두에게 작동합니다. 스킬 본문(SKILL.md)의 출력 템플릿, 풀 예시 5종(references/examples.md), 평가 체크리스트도 같은 구조로 맞췄습니다. |
| v1.9 | 2026‑10‑06 | 카드 35장을 사원·팀장·임원·CEO 네 직급의 작성 빈도로 다시 평가했습니다. 이사회 보고서, 6-pager, 경영 이슈 진단, 분기 실적 리뷰(MD&A), 사과문 다섯 장을 사내 문서로 재설계했습니다. 각각 의사결정 요청 보고서, 1페이지 보고서, 문제 해결 보고서, 월간·분기 실적 보고, 경위서입니다. 산업·시장 분석은 리서치에, 제휴 제안은 영업 제안서에, 출시 메시지는 카피라이팅에 모드로 합쳤습니다. 외부 이메일 카드는 사내 메일과 사과 메일까지 다루는 메일 쓰기로 넓혔습니다. IR, 주주 서한, 재무 모델링, M&A, 투자 검토, 비전·미션, 위기 대응, 신문 칼럼, 카피라이팅·출시 메시지, 보도자료 열 장은 직군 전용이라 지웠습니다. 합친 카드의 옛 링크는 합친 곳으로 넘어갑니다. 주간 업무보고, 회의록, 사내 공지 세 장을 새로 만들었습니다. 사업계획, 협상, 계약서 검토, 기획안, 전사 메시지, 어려운 메시지, 성과 평가(자기평가 모드), SNS(링크드인 모드)를 한국 사무직 장면에 맞게 고쳤습니다. 카테고리를 부서 기준에서 장면 기준으로 다시 나눴습니다. 고친 21장은 4인 비평 에이전트로 두 차례 검증했고, 점수 눈금과 판정 규칙이 어긋나던 곳(9점 행)과 GOLD 점수 기록을 갤러리 전체에서 바로잡았습니다. |
라이선스
Apache License 2.0입니다. Copyright 2026 AI ROASTING. 전문은 LICENSE에 있습니다.
