LLM 지식팩 · 하위 모델용
Opus·Sonnet보다 작은 모델(Haiku·로컬 LLM)이 같은 품질의 결과를 내도록 만든 규칙 팩이다. 사람용 문서를 그대로 먹이는 대신, 마크업을 걷어내고 · 추론을 규칙으로 치환하고 · 작업 단위로 쪼갰다.
<div class=...>index.md (약 1.2k 토큰)
사용자 요청 ↔ 파일 1개
1.1k~3.1k 토큰
명령은 그대로 복사
못 했으면 "미검증" 보고
# 1) 팩 전체를 받는다 (12개 파일, 76KB)
mkdir -p llm-pack && cd llm-pack
for f in index 10-editor-core 11-editor-errors 12-verify 13-schema \
20-motion-install 21-motion-usage 22-motion-errors \
30-agents 31-skills 40-deploy 41-claude-md; do
curl -fsSL "https://design-portfolio-7yo.pages.dev/llm/$f.md" -o "$f.md"
done
# 2) 라우터를 시스템 프롬프트에 넣는다
cat index.md # ← 이 내용을 시스템 프롬프트로
# 3) 작업이 정해지면 해당 파일만 대화에 추가한다
cat 21-motion-usage.md
# 프로젝트 안에 팩을 둔다
mkdir -p docs/llm && # 위 curl 루프로 docs/llm 에 받기
# CLAUDE.md 에 아래 블록을 추가
# ## 지식팩
# 작업 전 docs/llm/index.md 를 읽고, 라우팅 표에 따라 해당 파일만 추가로 읽는다.
# 팩에 없는 내용은 추측하지 않고 "지식팩에 없음"이라고 답한다.
너는 아래 지식팩의 규칙을 따른다.
1. 먼저 index.md 의 라우팅 표에서 현재 요청에 해당하는 파일을 고른다.
2. 그 파일만 읽는다. 전부 읽지 않는다.
3. 팩에 없는 내용은 추측하지 않는다. "이 지식팩에 없음"이라고 답한다.
4. 명령어는 그대로 복사해 실행한다. 임의로 바꾸지 않는다.
5. ❌(금지)로 표시된 것은 예외 없이 하지 않는다.
6. "완료"라고 말하기 전에 파일 끝의 확인 절차를 실행한다.
실행하지 못했으면 "미검증"이라고 명시한다.
| 문제 | 사람용 문서에서는 | 지식팩에서는 |
|---|---|---|
| 판단을 요구하는 표현 | "대개 이렇게 한다", "상황에 따라 다르다" | 조건문으로 치환 — "X면 Y한다". 예외를 만들지 않는다고 명시 |
| 암묵적 금지 | 문맥상 하면 안 되는 것을 설명으로 전달 | ❌ 기호로 명시 — "❌ 금지: 아트보드 폭을 100%로 두는 것" |
| 플레이스홀더 | "적절한 값으로 바꿔 쓰세요" | 실제 값을 박아둔다 — 바꿔야 하는 곳만 <...>로 표시 |
| 에러 대응 | 원인을 설명하고 판단을 맡김 | 에러 문자열 → 실행할 명령 표. 없으면 "팩에 없음"이라고 답하게 지시 |
| 완료 판정 | 독자가 알아서 확인 | 파일 끝에 확인 명령을 두고, 미실행 시 "미검증" 보고를 강제 |
| 컨텍스트 과부하 | 한 페이지에 전부 | 작업 단위로 분할 + 라우터. 필요한 것만 로드 |