대충 한 줄로 시켜도, 제대로 된 요청으로 바뀌어 실행됩니다.

👤 당신이 치는 것

/fable-prompt 로그인 버튼 눌러도 아무 반응 없어 고쳐줘

🤖 Claude가 실제로 받는 요청 (대화 맥락에서 자동으로 채워짐)

목표: 로그인 버튼을 누르면 /api/login 이 호출되고, 성공하면 /dashboard 로 이동하게 한다
맥락: src/components/LoginButton.tsx, 콘솔 오류 "TypeError: onSubmit is not a function", 어제 인증 방식을 바꾼 커밋 이후 발생
범위: 이 버튼과 그 핸들러만. 옆의 회원가입 폼이나 다른 오류는 고치지 말고 후속 과제로 보고
완료 기준: 실제 클릭을 재현해 /dashboard 이동 확인, 콘솔 오류 0, 변경 파일 목록 첨부

Anthropic 공식 문서 Prompting Claude Fable 5.1의 처방을 스킬 두 개에 담았습니다. 문구는 원문 그대로 씁니다.

Fable에서만 쓸 수 있나요? 아닙니다. Opus 5, Sonnet 5에서도 결과 품질이 올라갑니다. 네 칸 요청 틀(목표·맥락·범위·완료 기준)은 모델이 무엇이든 되묻기와 빗나간 결과를 줄이고, 범위 제한·부분 편집·진행 보고·끝까지 하기 규칙은 어떤 모델에서도 그대로 작업 품질을 끌어올립니다. Fable 5.1 전용인 것은 그 모델의 버릇을 되돌리는 문구 몇 개(서식 규칙, 자율 진행 블록, effort 권고값)뿐이고, 다른 모델에 있어도 해가 되지 않습니다.

목차

• 무엇을 하나
• 설치: 한마디
• 사용법: 평소처럼
• 초보자 흐름
• 작동 원리: 세 층
• 1층 · 매번 요청에
• 2층 · 상시 규칙
• 3층 · 설정값
• 증상별 처방
• FAQ
• 구성
• 기여와 라이선스

무엇을 하나

Fable 5.1은 긴 작업을 혼자 끝까지 해내는 능력이 커진 대신 버릇이 바뀌었습니다. 작업 중 말수가 줄고, 한 번에 도구 하나씩만 부르고, 작은 수정에도 파일을 통째로 다시 쓰고, low effort에서는 검색 대신 기억으로 답합니다. 공식 가이드는 이 변화에 대한 증상별 처방이고, 이 플러그인은 그 처방을 자동으로 적용합니다.

설치: 한마디

Claude Code에 이렇게만 말하세요.

https://github.com/Junhan2/oh-my-fable 설치해줘

Claude가 설치하고, 질문 한 번(선택지 세 개)을 하고, 답에 맞게 설정까지 끝냅니다. 다음에 Claude Code를 열면 자동으로 적용됩니다. 사용자가 직접 칠 것은 없습니다. 지금 이 세션에서 바로 쓰고 싶으면 /reload-plugins(방금 설치한 플러그인 로드) 다음 /clear(규칙 주입) 를 한 줄씩.

claude plugin marketplace add Junhan2/oh-my-fable
claude plugin install oh-my-fable@oh-my-fable

새 세션을 열거나 /reload-plugins 후 /clear. 그다음 /fable-setup (질문 없이 기본값은 /fable-setup auto).

요구 사항 Claude Code 2.1.258 이상. Windows는 Git for Windows(Git Bash) 필수: 훅이 bash로 실행됩니다. 설치 뒤 훅 오류가 뜨면 이 문제입니다.

사용법: 평소처럼

그냥 평소처럼 요청하면 됩니다. 상시 규칙은 이미 켜져 있습니다. 요청이 짧거나 막연하면 앞에 /fable-prompt를 붙이세요.

/fable-prompt 이거 좀 고쳐줘

목표·맥락·범위·완료 기준·effort를 채운 요청을 보여 주고 바로 실행합니다. 보기만 하려면 뒤에 프롬프트만.

초보자 흐름

규칙 위치 세 가지 (첫 질문)

셋 중 하나만 활성화됩니다. 파일 방식을 고르거나 CLAUDE.md에 구간이 이미 있으면 훅은 스스로 조용해집니다(구판에서 올라온 경우도 이중 주입 없음). 서브에이전트나 에이전트 팀을 많이 쓰면 규칙 파일 방식을 고르세요.

• 사용 방식은 기본이 자동 감지입니다. 터미널이나 IDE에서 열면 대화형, 헤드리스(claude -p)·Agent SDK·에이전트 하네스에서 열면 무인으로 세션마다 알아서 정합니다(Claude Code가 넣어 주는 CLAUDE_CODE_ENTRYPOINT 값 기준). 대화형과 무인을 섞어 써도 따로 바꿀 것이 없습니다. 항상 한쪽으로 고정하려면 질문에서 "대화형" 또는 "무인"을 고르세요. 무인은 "사용자가 지켜보고 있지 않다" 문단을 추가하며, 글로벌 설정에서만 켜지고 저장소 안의 설정 파일로는 켤 수 없습니다(클론한 저장소가 에이전트를 무인으로 바꾸는 것을 막기 위해). 자동 감지는 훅 방식에서만 되고, 규칙 파일이나 CLAUDE.md 구간은 고정 텍스트라 한쪽을 골라야 합니다.
• effort는 medium 추천(Fable 5 수준 품질을 더 싸게, 어려운 작업만 그 세션에서 /effort high). Anthropic 가이드의 기본값은 high이니 품질을 우선하면 그것을 고르세요. settings.json의 effortLevel에 쓰며 승인 프롬프트가 뜰 수 있습니다.

1. claude plugin marketplace add Junhan2/oh-my-fable
2. claude plugin install oh-my-fable@oh-my-fable
3. ~/.claude/plugins/installed_plugins.json 에서 oh-my-fable@oh-my-fable 의 installPath 를 읽는다
4. <installPath>/skills/fable-setup/SKILL.md 를 읽고 그 절차를 이 세션에서 바로 따른다(${CLAUDE_PLUGIN_ROOT} 는 <installPath>). 질문은 그 파일에 적힌 대로 한 번에 묶어서
5. 끝나면 사용자에게 이렇게만 안내한다: "설치와 설정이 끝났습니다. 다음 세션부터 자동 적용됩니다. 지금 바로 쓰려면 /reload-plugins 를 입력하고 Enter, 그다음 /clear 를 입력하고 Enter 하세요(한 줄에 하나씩). 막연한 요청은 /fable-prompt <요청> 으로 보내세요."
6. 그 밖의 설명은 하지 않는다. 둘 다 필요한 이유: /reload-plugins 는 방금 설치한 플러그인(훅·스킬)을 이 세션에 로드하고, 규칙 주입은 세션 시작·/clear·압축 때만 일어난다

작동 원리: 세 층

가이드의 처방은 적용 방법이 다른 세 층으로 나뉩니다.

1층 · 매번 요청에

좋은 요청은 네 칸입니다.

요청에 따라 덧붙이는 것:

• 문제를 설명만 할 때 · "진단만 하고 고치지 마". 가이드의 명시적 예외.
• 최신 정보가 필요할 때 · effort를 high 이상으로 두거나 "사용자가 쓴 이름 그대로 한 번은 검색해" (블록 H).
• effort · 추천 medium(가이드 기본은 high). 어려운 작업만 /effort high. low는 검색을 건너뛸 수 있음. xhigh/max로 긴 문서를 시키면 초안을 두 번 써서 느려지니 장문 안내문(블록 G)을 붙이고 max_tokens를 넉넉히.
• 글이 빽빽할 때 · Please remove all mannered prose.
• 자료 요약 · 올바른 답 예시 1건(블록 J)을 같이 줌.

2층 · 상시 규칙

플러그인의 SessionStart 훅이 세션마다 아래 블록을 영어 원문 그대로 불러옵니다(파일 hooks/always-on.md). CLAUDE.md는 수정하지 않으며, 사용자 언어와 무관하게 영어입니다. 기본은 대화형 모드라 블록 A의 첫 문단("사용자가 지켜보고 있지 않다")은 빠져 있고, /fable-setup unattended 로 켤 수 있습니다.

3층 · 설정값

• 모드 · ~/.claude/oh-my-fable.json 의 {"enabled": true, "mode": "interactive" | "unattended"}. 프로젝트의 .claude/oh-my-fable.json 이 있으면 그것이 우선. /fable-setup 이 대신 써 줍니다.
• effort · 설정 파일 effortLevel(전역) 또는 modelSettings.<model>.effortLevel(모델별). 환경 변수 CLAUDE_CODE_EFFORT_LEVEL이 있으면 그것이 이기니 모델별 값을 쓰려면 환경 변수를 비울 것. 추천 medium, 가이드 기본 high. 모델마다 단계의 실제 사고량이 달라 Fable 5 값을 그대로 옮기지 말 것.
• API 직접 연동 · thinking.display: "updates"를 켜야 진행 메모가 화면에 옴. 대화 이력은 덧붙이기만(thinking 블록 포함), 턴마다 넣는 알림은 turn-scoped system message로. 압축은 서버 압축 또는 블록 K.
• 서브에이전트 · 시작 도구는 즉시 반환, 결과는 나중 메시지로.
• 비전 · 차트·표는 crop-and-zoom 도구를 붙이면 대부분의 이득.
• 거절(stop_reason: "refusal") 처리 · "컴파일 되나요?" 대신 "버그 있나요?"로 묻기.

증상별 처방

블록 원문 전체: skills/fable-prompt/references/prompt-blocks.md

FAQ

CLAUDE.md에 이미 비슷한 규칙이 있으면?
/fable-setup이 표로 짚어 줍니다. 같은 뜻이면 "이미 있음", 반대 뜻(서식 금지, 마지막에 한꺼번에 보고)이면 바꿔 넣을 문장을 제안합니다. 실제 수정은 사용자가 합니다. Claude Code가 AI의 CLAUDE.md 자기 수정을 막기 때문입니다.

규칙을 CLAUDE.md 말고 다른 곳에 두고 싶어요.
/fable-setup의 첫 질문에서 고릅니다. 훅(파일 없음), 별도 규칙 파일(~/.claude/rules/oh-my-fable.md, 자동 로드), CLAUDE.md 구간. 비교표는 초보자 흐름에 있습니다.

Fable 5.1이 아닌 모델에서도 되나요?
됩니다. 네 칸 요청 틀과 작업 규율(범위 제한, 부분 편집, 진행 보고, 도구 일괄 호출)은 모델과 무관하게 이득입니다. 서식 규칙, 자율 진행 블록, effort 권고값은 Fable 5.1 기준으로 측정된 것이라 다른 모델에서는 효과가 작을 수 있지만 해는 없습니다.

왜 지금 바로 쓰려면 /reload-plugins 다음 /clear 인가요?
공식 문서 기준 두 명령은 하는 일이 다릅니다. /reload-plugins는 "플러그인, 스킬, 에이전트, 훅, MCP 서버를 재시작 없이 다시 로드"합니다(Plugins). 규칙을 넣는 SessionStart 훅은 "새 세션(startup), 재개(resume), /clear, 압축(compact), 분기(fork)" 때만 실행됩니다(Hooks). 즉 reload는 훅을 등록만 하고 실행하지 않으므로, 설치한 세션에서는 /clear로 한 번 실행시켜야 합니다. 새 세션을 열면 둘 다 필요 없습니다.

되돌리려면?
/fable-setup remove 가 설정 파일, 규칙 파일, CLAUDE.md 구간을 지웁니다. 그다음 claude plugin uninstall oh-my-fable@oh-my-fable. 잠시 끄기만 하려면 ~/.claude/oh-my-fable.json 에 {"enabled": false}.

API나 Agent SDK로 직접 붙이는 경우는?
/fable-setup은 질문 도구가 필요해 SDK에서는 auto 인자만 됩니다. 가장 간단한 방법은 hooks/always-on.md 내용을 시스템 프롬프트에 그대로 붙이는 것입니다. 3층의 API 항목(thinking.display 등)은 그쪽 설정입니다.

구성

oh-my-fable/
├── .claude-plugin/
│   ├── plugin.json            플러그인 매니페스트
│   └── marketplace.json       이 저장소를 마켓플레이스로 등록
├── hooks/
│   ├── hooks.json             SessionStart 훅 등록
│   ├── session-start.sh       상시 규칙을 세션 시작 때 주입 (모드 설정 반영)
│   ├── always-on.md           주입되는 블록 원문 (영어)
│   └── autonomy-unattended.md 무인 모드에서만 추가되는 문단
├── skills/
│   ├── fable-setup/SKILL.md   충돌 점검·모드 전환·설정 점검 (2층·3층)
│   └── fable-prompt/
│       ├── SKILL.md           매번 요청 개선 (1층)
│       └── references/        블록 원문(A~K)과 전후 예시
├── README.md · README.en.md · README.zh.md
└── LICENSE

기여와 라이선스

이슈와 PR을 환영합니다. 가이드가 갱신되면 hooks/always-on.md(주입 원문)와 skills/fable-prompt/references/prompt-blocks.md(전체 블록 목록) 두 곳을 같이 고칩니다.

MIT © Junhan2. 가이드 원문의 저작권은 Anthropic에 있습니다.