01 / Constitution
출발 전에, 합의서를 쓰세요.
AI에게 작업을 맡기기 전, 짧은 문서 한 장을 미리 써두는 것만으로도 결과 품질이 확연히 달라져요. 이 문서를 우리는 “헌법”이라고 불러요.
✍︎
비유로 이해하기
“집을 짓기 전 건축주와 건축가가 도면을 합의하는 것과 같아요. 도면 없이 짓기 시작하면 중간에 무엇이 우선인지, 어디까지 양보할 수 있는지 매번 다시 협상해야 하잖아요.”
헌법에 들어가는 건 딱 세 가지예요. 거창하지 않습니다.
1
목표
이번 작업에서 결국 얻고 싶은 것
2
제약
절대 깨면 안 되는 규칙들
3
우선순위
충돌 시 무엇을 먼저 챙길지
핵심
“헌법이 있으면 중간에 흔들리지 않아요. AI가 길을 잃을 때 다시 붙잡아주는 닻이고, 우리가 의사결정에 지칠 때 돌아갈 기준이 되어드려요.”
02 / Planning Depth
모든 작업에
같은 무게의 계획은 독이에요.
단순한 일에 거창한 계획을 붙이면 흐름이 끊기고, 복잡한 일에 계획을 안 세우면 부채가 쌓여요. 작업의 크기에 맞춰 계획의 깊이를 조절하시는 게 핵심이에요.
No plan
1-2 문장
오타 수정·간단 리팩터. 한두 문장으로 설명되고 영향 파일이 명확하면, 바로 실행하셔도 돼요.
Local plan
파일 2-4개
기능 한 개 추가·중간 규모 리팩터. 단일 모듈 안에서 끝나는 작업은 로컬 plan 모드(Shift+Tab × 2)로 충분해요.
Two-pass
파일 5개+
아키텍처 변경·마이그레이션·breaking change. 로컬 plan으로 시작해서 Ultraplan으로 한 번 더 검토하시는 걸 권장해요.
경계가 애매할 땐 한 단계 위로 올리시는 게 안전해요. 과한 계획으로 잃는 건 시간이지만, 부족한 계획으로 잃는 건 코드 자체일 수 있거든요.
03 / GMP Standard
좋은 프롬프트는
4층으로 쌓여 있어요.
GMP는 General Meta-Prompt Protocol의 약자예요. 어렵게 들리지만 결국 “좋은 프롬프트는 이 네 가지를 갖춘다”는 체크리스트예요.
4
자가검증
출력 직전, 정확성·완전성·일관성을 셀프 체크
3
우선순위 라벨
[MUST] · [SHOULD] · [NICE] 로 양보 순서 명시
2
이중 앵커링
핵심 제약을 맨 위·맨 아래 두 번 — 길어져도 안 잊혀요
1
XML 계층
<CRITICAL_CONSTRAINTS>, <INSTRUCTIONS> 등 섹션 분리
왜 이렇게까지 하나요?
평범한 프롬프트
“이 코드 좀 리팩터해줘”
맥락이 없어서 어디부터 손댈지, 무엇을 우선해야 할지 매번 다른 답이 나와요. 길게 대화할수록 초반 의도가 잊혀요.
GMP 적용
구조화된 프롬프트
제약·지시·출력형식이 분리되어 있고, 핵심 규칙은 두 번 강조되어 있어 길어져도 흔들리지 않아요. 결과가 일관됩니다.
주의
“단순한 작업에 GMP 전체를 다 쓰진 마세요. 작업의 복잡도가 프롬프트의 복잡도를 결정해요. — 프롬프트도 적정 깊이가 있어요.”
04 / Sub-agents
한 명의 천재보다
전문가 팀이 강해요.
큰 작업을 한 번에 다 시키는 대신, 역할을 나눠서 각각에게 “필요한 정보만” 전달하는 방식이에요. 사람이 일하는 방식과 똑같죠.
오케스트레이터
전체 흐름 조율 · 결과 통합 · 품질 검증
↓↓↓
Sub-agent A
데이터 수집
전용 컨텍스트
각 서브에이전트는 이전 단계의 잡음 없이 깨끗한 컨텍스트로 시작해요 (Fresh Eyes).
팀제로 얻는 4가지
집중
한 가지에만 몰입
각 에이전트가 자신의 작업에 필요한 맥락만 가지고 있어서 깊이 있게 처리할 수 있어요.
속도
병렬 실행
서로 의존성이 없는 작업은 동시에 진행되어, 전체 시간이 줄어들어요.
재개
핸드오프 가능
PROGRESS.md에 단계별 상태를 남겨두면, 세션이 끊어져도 그 자리에서 이어가실 수 있어요.
품질
이중 점검
오케스트레이터가 마지막에 결과를 통합·검증하는 단계가 있어서, 한 명이 다 한 결과보다 안정적이에요.
05 / Self-verification
출력 직전,
한 번 더 봐달라고 하세요.
AI가 그럴듯한데 틀린 답을 내놓는 가장 흔한 이유는, 자신의 답을 한 번도 다시 안 봤기 때문이에요. 4단계만 추가해도 오답률이 절반 이하로 떨어져요.
1
핵심 주장 3개를 골라요
초안에서 “정말 맞아야 하는 사실”만 추려주세요. 모든 문장을 검증할 필요는 없어요.
2
독립적인 검증 질문을 만들어요
초안과 분리해서, 각 주장을 “이게 정말 맞나?”라고 묻는 별도 질문으로 만들어주세요. 분리가 핵심이에요.
3
검증 결과와 비교해요
검증 답변이 초안과 어긋나면, 초안을 수정하세요. 보통 이 단계에서 “아, 틀렸네”가 한두 개씩 나와요.
4
제약 체크리스트
마지막으로 헌법의 CRITICAL_CONSTRAINTS를 항목별로 다시 한 번 확인해주세요.
효과
“이 4단계 하나만 추가하셔도, ‘그럴듯하지만 틀린’ 결과가 절반 이하로 줄어들어요. 사람이 검토하는 시간도 함께 줄어들고요.”
06 / Full Workflow
세션부터 배포까지,
한 흐름으로.
Actigence 라이브러리 자체가 이 4단계 흐름으로 정렬되어 있어요. 외울 필요 없이, 라이브러리에서 순서대로 골라 쓰시면 됩니다.
01 / Setup
준비
헌법 작성, 원칙 합의, 세션 이어받기/신규 시작.
02 / Dev
개발
기능 추가·품질 개선·디버깅. Plan-and-Solve 기반.
03 / Verify
검증
자가검증·리뷰·테스트 전략으로 품질 확인.
04 / Ship
배포
패키징·배포·풀스택 마무리 점검.
각 단계마다 라이브러리에 전용 프롬프트가 있고, 단계 간 핸드오프 형식도 표준화되어 있어요. 한 번 익히시면 다음 프로젝트부터는 그냥 흐름에 올라타시면 됩니다.
정리
“헌법으로 시작하고 → 깊이에 맞게 계획하고 → 4층으로 프롬프트를 쌓고 → 팀제로 분담하고 → 출력 직전 검증하고 → 흐름대로 배포한다. 이게 전부예요.”
07 / Frameworks
한 카드 뒤에는
여러 표준이 함께 일해요.
프롬프트 카드마다 “적용 표준” 칩이 붙어있는데, 거기에 표시된 단어 하나하나가 어떤 의미인지 정리한 사전이에요. 굳이 다 외우지 않으셔도, 카드를 쓰실 때 옆에서 참고하시면 됩니다.
메타 표준 — 프롬프트 자체의 뼈대
카드를 어떻게 쓰는지 결정하는 표준들. 모든 카드 메타 보강 섹션에 명시되어 있어요.
GMP v2.5
메타프롬프트 표준
XML 계층 구조 + 이중 앵커링(CRITICAL_CONSTRAINTS / FINAL_REMINDER) + factored-CoVe 자가검증을 갖춘 General Meta-Prompt Protocol. 모든 카드의 보강 메타가 이 표준에 정렬되어 있어요.
data/skills/gmp.md · gmp_version: "2.5"
Anthropic XML tags (P-D)
XML 태그 섹션 구조
CRITICAL_CONSTRAINTS / INSTRUCTIONS / SELF_VERIFICATION / FINAL_REMINDER 같은 XML 태그로 섹션을 명시해요. 정적 데이터는 지시 앞에, 구체적 쿼리는 마지막에 두는 게 권고예요.
출처: docs.anthropic.com/.../use-xml-tags
우선순위 라벨 (P-C)
[MUST] / [SHOULD] / [NICE]
카드당 [MUST] ≤60% / [SHOULD] 25–35% / [NICE] 5–15%로 강제 비율을 유지해요. 충돌 시 [MUST] 우선. 각 항목 옆에 1줄 이유를 같이 써두면 가장 좋아요.
priority_targets 메타 필드
Plan Contract
6섹션 변경 계약
Scope · Change Map · Phases · AC · Risks · Rollback. 변경 작업의 범위·위험·검증 기준을 사전에 합의하는 계약서예요. 프로젝트 정본은 CLAUDE.md에 보관해요.
CLAUDE.md Plan Contract 블록
자가검증 기법 — 출력 직전 한 번 더
AI가 “그럴듯하지만 틀린” 답을 내놓지 않도록 막는 학술 기반 기법들이에요.
CoVe — Chain-of-Verification (P-A)
factored-CoVe-plus-refine
초안 → 독립 검증 질문 5개 생성 → 초안과 분리해서 답변 → 불일치 시 수정 → 출력 게이트의 4단계 흐름이에요. 본 라이브러리는 사양·타입·보안·도메인 표준·재현성 5축을 검증해요.
Dhuliawala 2023 · arXiv:2309.11495
Self-Refine
비판 → 수정 반복
초안 → 자가 비판 → 수정의 반복 루프로 품질을 점진적으로 끌어올려요. CoVe와 결합되어 P-A 자가검증의 step4(refine)에 포함되어 있어요.
Madaan 2023 · arXiv:2303.17651
Constitutional AI
헌법 기반 자가비판
명시적 원칙(헌법) 목록에 대해 모델이 자기 출력을 비판·수정해요. 본 라이브러리는 design/principles · forbidden · required · tone 4종을 “헌법”으로 사용해요.
Bai 2022 · arXiv:2212.08073
결정성·재현성 (P-E)
JSON 스키마 + lint/test
카드 출력은 정의된 JSON(또는 Zod) 스키마 형태로 강제해요. pnpm lint / typecheck / test / build 명령을 카드 종료 직전 실행하고 결과를 verification 필드에 기재해요.
DETERMINISTIC_VERIFICATION 블록
워크플로우·실행 환경 — 어떻게 굴릴 것인가
카드를 어떤 컨텍스트에서, 어떤 도구로 돌릴지를 결정하는 표준들이에요.
Two-pass
초안 → 디자인 리뷰 2단계
Pass 1에서 동작·기능에 집중한 초안을, Pass 2에서 design/forbidden · tone · required 기준으로 슬롭·일관성 점검해요. 머지 전 P0=0 게이트가 필수예요.
Pass 3까지 확장된 Remediate 루프 포함
Ultraplan
대형 변경 별 컨텍스트 플랜
5+파일·아키텍처 변경·돌이킬 수 없는 작업·광범위 탐색이 필요할 때 별 컨텍스트로 분리하는 플랜 모드예요. 로컬 plan에서 “No, refine with Ultraplan”으로 승격해요.
Direct Ultraplan 직접 호출도 가능
gstack
design-review · qa · ship
design-reviewer 서브에이전트, qa 자동 테스트-수정 루프, ship 배포 워크플로우 등 Cowork 환경의 종합 워크플로우 스킬 묶음이에요. 본 라이브러리의 Pass 2 디자인 리뷰가 이걸 호출해요.
/qa · /review · /design-review · /ship
Orchestrator-Worker (P-B)
Anthropic 멀티에이전트
Lead 에이전트가 작업을 분해해 워커 서브에이전트들에게 fresh-window로 위임하고, 결과를 다시 통합해요. 토큰 예산 초과 시 compaction + Ralph-style 재시작이 들어있어요.
Anthropic Multi-agent · 2025-06
Teleport-first
격리 워크트리 실행
Claude Code의 git worktree 격리 모드로 작업하여 main 브랜치 직접 수정을 방지해요. 새 기능은 별도 <section data-feature> 블록으로 추가해서 기존 마크업 침범을 최소화해요.
CLAUDE.md Execution Defaults
session-handoff
세션 교체 복원
PROGRESS.md “Ultraplan 세션 로그” + “Anti-Slop 감사 로그”에 컨텍스트를 누적 기록해서 세션이 끊겨도 재탐색 없이 이어받을 수 있어요. 60 / 70 / 90% 컨텍스트 트리거가 정해져 있어요.
data/skills/session-handoff.md
Playwright MCP
브레이크포인트 시각 회귀
393 / 1024 / 1440 / 1920 4 브레이크포인트 자동 스크린샷을 .playwright-mcp/에 저장하고, before/after diff로 시각 회귀를 잡아요. 디자인 리뷰의 1차 증거예요.
Pass 2 디자인 리뷰 도구
디자인·코드 가드 — 슬롭 차단
AI 슬롭(보라 그라디언트, Inter 단독, “혁신적인” 류 카피)을 차단하는 가드들이에요.
Anti-Slop 디자인 헌법 (P-F)
design/* 5종 가드
design/forbidden(부록 M 금지어) · required(부록 N 필수) · principles · tone · tokens.css 5종으로 시각·카피·구조 슬롭을 차단해요. shadcn/ui semantic 토큰 + OKLCH + Pretendard가 기본이에요.
Anthropic frontend-design Skill
Impeccable
슬롭 탐지 Stop-hook
.impeccable.md 설정으로 lexical(금지어) · structural(필수 패턴) · tone 3종 검출기를 PostToolUse hook으로 강제 실행해요. max_forbidden_hits=0이라 위반 1건이라도 있으면 머지 차단이에요.
.impeccable.md · /impeccable
shadcn/ui semantic tokens
OKLCH 색공간 토큰
background / foreground / card / primary / secondary / muted / accent / destructive / border / input / ring 등 shadcn semantic 토큰을 OKLCH(L C H)로 :root와 .dark 양쪽에 정의하고 @theme inline으로 Tailwind에 매핑해요.
design/tokens.css
Pretendard 한글 타이포
keep-all + 1.6 행간
본문 letter-spacing −0.01em / 헤드라인 −0.025em / word-break:keep-all / line-height ≥1.6. 영문 fallback으로 Inter 단독 사용은 금지예요.
design/principles.md “2. 한국어 타이포 우선”
skill-creator
SKILL.md 표준
name + description frontmatter, when-to-use 트리거, 분리된 reference 파일 등 Anthropic skill-creator 규격을 따라요. data/skills/ 10개 스킬이 모두 이 표준이에요.
Anthropic skill-creator
사용법
“프롬프트 카드를 누르시면 ‘적용 표준’ 칩이 위쪽에 보여요. 거기서 모르는 단어가 있으면 클릭하시면 이 카탈로그의 해당 항목으로 바로 이동합니다. 외우실 필요 없이, 마주칠 때마다 한 줄씩 보시면 돼요.”