oh-my-customcode - npm Package Compare versions

Comparing version

1.1.3

1.1.4

+67

templates/guides/claude-code/16-fable5-prompting.md

		# Claude Fable 5 프롬프팅 가이드

		> 출처: https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5
		> 범위 제한: 이 문서는 위 출처 URL에 대한 이슈 #1435 본문 요약만을 소스로 합니다. 공식 문서 원문을 직접 확인하지 못했으므로, 코드 스니펫이나 세부 예시 문구를 추측으로 채우지 않습니다. 구체적인 프롬프트 원문이 필요하면 출처 URL을 직접 확인하세요.

		## 개요

		Claude Fable 5(`claude-fable-5`)는 Mythos-class 모델로, GA 시점 기준 Opus 4.8보다 상위 티어의 최고 GA 역량을 가집니다(R006 Model Aliases 참조). Fable 5는 기존 모델 대비 다른 행동 프로파일을 가지므로, 기존 Opus/Sonnet용으로 튜닝된 하네스(rules, skills, system prompt)를 그대로 재사용하면 오히려 품질이 저하될 수 있습니다. 이 문서는 Fable 5 전용 프롬프팅·스캐폴딩 조정 패턴을 정리합니다.

		## Opus 4.8 대비 행동 차이

		\| 항목 \| 차이 \|
		\|------\|------\|
		\| Long-horizon autonomy \| 장시간 자율 작업 수행 능력 향상 — 중간 개입 없이 더 긴 turn을 유지 \|
		\| 병렬 서브에이전트 dispatch \| 병렬 서브에이전트 위임의 신뢰성 향상 \|
		\| Instruction following \| 지시 준수력이 더 강함 — 규범적(prescriptive) 지시에 더 문자적으로 반응 \|

		Instruction following이 강해졌다는 것은 장점이자 위험 요인입니다. 장문·과잉 규범적 지시를 그대로 유지하면, Fable 5는 이를 문자 그대로 따르려 하면서 불필요한 형식적 준수에 리소스를 쓰거나, 자연스러운 판단력을 발휘하지 못할 수 있습니다(아래 "핵심 경고" 참조).

		## 프롬프팅/하네스 튜닝 패턴

		\| 패턴 \| 설명 \| oh-my-customcode 매핑 \|
		\|------\|------\|------------------------\|
		\| (a) Longer turns 허용 \| Long-horizon autonomy를 살리기 위해 turn을 짧게 강제로 끊지 않음 \| R009 대규모 작업 분해와 균형 — 도메인 분해는 유지하되 개별 에이전트 turn 길이는 과도하게 제한하지 않음 \|
		\| (b) Effort 전략 \| 작업 복잡도에 맞는 effort 레벨 설정 \| R006 `effort` frontmatter 필드 — 신규 콘텐츠 (effort 전략 구체화는 이 가이드가 보완) \|
		\| (c) 간결 지시 우선 \| 장문·규범적 지시보다 간결하고 명확한 지시가 더 나은 결과를 냄 \| R023 shift-left 정신과 정합 — 신규 콘텐츠, "핵심 경고" 섹션 참조 \|
		\| (d) 진행 주장 ground-truth 강제 \| "완료했다"는 주장을 실제 산출물로 검증하도록 지시 \| R020 완료 검증(Completion Verification)이 이미 선점 — 개념 중복 아닌 보완 \|
		\| (e) Boundary 명시 \| 허용/금지 행동 경계를 명시적으로 진술 \| R010 Pre-Delegation Privileged-Scope Boundary가 이미 선점 — 보완 \|
		\| (f) 병렬 서브에이전트 \| 독립 작업의 병렬 위임 활용 \| R009 병렬 실행이 이미 선점 — Fable 5는 병렬 dispatch 신뢰성이 향상되어 R009 효과가 더 커짐 \|
		\| (g) 파일 기반 메모리 \| 세션 간 지속성을 위한 파일 기반 메모리 활용 \| R011 네이티브 auto memory가 이미 선점 — 보완 \|
		\| (h) Early-stopping/context-budget 방지 문구 \| 조기 종료나 컨텍스트 예산 소진으로 인한 작업 중단을 막는 명시적 문구 \| 신규 콘텐츠 — R013 ecomode의 context budget 관리와 함께 검토 가치 있음 \|
		\| (i) Intent 컨텍스트 제공 \| 작업의 배경 의도(왜 이 작업이 필요한지)를 함께 제공 \| 신규 콘텐츠 — R015 Intent Transparency와는 반대 방향(에이전트→사용자가 아니라 사용자/오케스트레이터→에이전트로 의도 전달) \|
		\| (j) 가독성 addendum \| 응답 가독성을 높이는 보충 지시 \| 신규 콘텐츠 \|
		\| (k) Send-to-user 도구 \| 사용자에게 직접 메시지를 보내는 전용 도구 활용 \| 신규 콘텐츠 — oh-my-customcode에는 현재 대응 도구 없음(향후 검토 후보) \|

		## 핵심 경고: 과잉 처방(over-prescription)이 오히려 품질을 저하시킨다

		Fable 5는 instruction following이 강하기 때문에, 기존 스킬/룰이 지나치게 규범적(too prescriptive)이면 — 즉 세부 절차를 과도하게 명시하면 — 오히려 Fable 5의 자연스러운 판단력과 long-horizon autonomy 이점을 깎아먹고 품질이 저하될 수 있습니다.

		본 프로젝트 함의: oh-my-customcode는 `.claude/rules/` 하위에 R000~R023의 장문·규범적 규칙 세트를 보유하고 있습니다. Fable 5를 오케스트레이터 또는 서브에이전트 모델로 채택할 경우:

		- 규칙 자체를 축소할 필요는 없지만(다른 모델과의 호환성 유지 필요), Fable 5 대상 에이전트에 전달하는 위임 프롬프트는 규칙 원문을 그대로 재인용하기보다 핵심 제약만 간결하게 요약하는 방식을 우선 검토합니다.
		- 신규 Fable 5 전용 에이전트/스킬을 설계할 때는 절차를 과도하게 세분화하지 않고, 목표와 경계(boundary)만 명시한 뒤 판단은 모델에 위임하는 방향을 우선 고려합니다.
		- 이 경고는 R023(검증 비용 ladder)의 shift-left 원칙과는 다른 축입니다 — R023은 "어떤 비용으로 검증할지", 이 경고는 "얼마나 규범적으로 지시할지"를 다룹니다.

		## GA 사양

		\| 항목 \| 값 \|
		\|------\|-----\|
		\| Model ID \| `claude-fable-5` \|
		\| GA 일자 \| 2026-06-09 \|
		\| 기본 컨텍스트 \| 1M 토큰 (기본 포함 — `[1m]` suffix 불필요, R006 Model Aliases 각주 참조) \|
		\| 가격 \| $10 / $50 per Mtok \|
		\| 안전 체계 \| 안전 분류기 + `stop_reason: "refusal"` fallback \|

		### Mythos 5 (`claude-mythos-5`)

		Mythos 5는 Project Glasswing 한정 공급 모델로, GA가 아닙니다. Fable 5(GA)와 혼동하지 않도록 주의합니다.

		## 상호 참조

		- R006 (MUST-agent-design.md) — Model Aliases 표에 `fable` alias 정의, effort/model 기본값 정책
		- R023 (SHOULD-verification-ladder.md) — 검증 비용 ladder shift-left 원칙. 이 문서의 "과잉 처방 경고"는 검증 비용이 아닌 지시 간결성 축이므로 R023과 직교하되 상호 참조 가치가 있음
		- R009 (MUST-parallel-execution.md) — long-lived subagent 재사용 및 병렬 서브에이전트 dispatch 신뢰성 향상과 연관
		- R020 (MUST-completion-verification.md) — 진행 주장 ground-truth 강제 패턴(d)의 기존 선점 규칙
		- R010 (MUST-orchestrator-coordination.md) — boundary 명시 패턴(e)의 기존 선점 규칙(Pre-Delegation Privileged-Scope Boundary)
		- R011 (SHOULD-memory-integration.md) — 파일 기반 메모리 패턴(g)의 기존 선점 규칙(네이티브 auto memory)

+1

-1

package.json

		@@ -6,3 +6,3 @@ {
		],
		"version": "1.1.3",
		"version": "1.1.4",
		"description": "Batteries-included agent harness for Claude Code",
		@@ -9,0 +9,0 @@ "type": "module",

+6

-0

templates/.claude/rules/MUST-agent-design.md

		@@ -38,2 +38,8 @@ # [MUST] Agent Design Rules

		> Fable 5 Effort 전략: Fable 5는 high effort가 기본값이며, `xhigh`는 capability-sensitive 작업(최고난도 아키텍처/추론)에 한정해야 합니다. Fable 5의 `low`/`medium` effort조차 이전 세대 모델의 `xhigh`를 상회하는 품질을 보이므로, Fable 5를 사용하는 실행 에이전트는 `effort` 필드를 신중히 명시하고 불필요한 `xhigh` 남용을 지양합니다(R005 비용/지연 인식과 정합).

		> Mythos 5 (`claude-mythos-5`): Project Glasswing 한정 공급 모델로, GA가 아닙니다 — Fable 5(GA, 위 Model Aliases 표의 `fable`)와 구분해야 합니다. 특성: adaptive-thinking 전용 아키텍처 + 안전 분류기가 개입 시 `stop_reason: "refusal"`로 fallback하는 체계를 가집니다. oh-my-customcode 에이전트 frontmatter에는 아직 alias를 등록하지 않습니다(비-GA, 공급 제한).

		> 프롬프팅 패턴 상호참조: Fable 5/Mythos 5 대상 프롬프팅 패턴(effort 조합, adaptive-thinking 활용, refusal fallback 대응)의 상세 가이드는 `guides/claude-code/16-fable5-prompting.md`를 참조하세요.

		### Fallback Models (CC v2.1.166+)
		@@ -40,0 +46,0 @@

+2

-0

templates/.claude/rules/MUST-parallel-execution.md

		@@ -93,2 +93,4 @@ # [MUST] Parallel Execution Rules

		> Fable 5 long-lived subagent reuse (Origin: #1435): Fable 5는 long-lived subagent 재사용(단일 subagent가 여러 단계를 이어서 수행)에 강함 — 현행 R009 병렬 실행 원칙과 상충하지 않으며, Fable 5 실행 시 short-lived 병렬 다수 대신 long-lived 재사용도 유효한 선택지. 상세는 `guides/claude-code/16-fable5-prompting.md`.

		## Adaptive Parallel Splitting
		@@ -95,0 +97,0 @@

+4

-0

templates/.claude/rules/SHOULD-verification-ladder.md

		@@ -61,2 +61,6 @@ # [SHOULD] Verification Ladder Rules

		## Fable 5 Over-Prescription Advisory (Origin: #1435)

		Fable 5 실행 에이전트/스킬은 지시(instruction) 장문화가 오히려 품질을 저하시킬 수 있다(too prescriptive). 신규 규칙/스킬 추가 시 간결성을 우선하고, Fable 5 실행 대상 문서의 과잉처방을 경계한다. 상세는 `guides/claude-code/16-fable5-prompting.md` 참조.

		## Self-Check
		@@ -63,0 +67,0 @@

+5

-0

templates/guides/claude-code/index.yaml

		@@ -77,1 +77,6 @@ # Claude Code Guide Index
		path: ./15-version-compatibility.md

		- name: fable5-prompting
		title: Claude Fable 5 프롬프팅 가이드
		description: Fable 5 전용 프롬프팅·하네스 튜닝 패턴 — Opus 4.8 대비 행동 차이와 R006/R009/R020/R023 매핑
		path: ./16-fable5-prompting.md

+1

-1

templates/manifest.json

		{
		"version": "1.1.3",
		"version": "1.1.4",
		"lastUpdated": "2026-07-01T00:00:00.000Z",
		@@ -4,0 +4,0 @@ "omcustomMinClaudeCode": "2.1.121",

dist/cli/index.js

Sorry, the diff of this file is too big to display

dist/index.js

Sorry, the diff of this file is too big to display

		# Claude Fable 5 프롬프팅 가이드

		> 출처: https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5
		> 범위 제한: 이 문서는 위 출처 URL에 대한 이슈 #1435 본문 요약만을 소스로 합니다. 공식 문서 원문을 직접 확인하지 못했으므로, 코드 스니펫이나 세부 예시 문구를 추측으로 채우지 않습니다. 구체적인 프롬프트 원문이 필요하면 출처 URL을 직접 확인하세요.

		## 개요

		Claude Fable 5(`claude-fable-5`)는 Mythos-class 모델로, GA 시점 기준 Opus 4.8보다 상위 티어의 최고 GA 역량을 가집니다(R006 Model Aliases 참조). Fable 5는 기존 모델 대비 다른 행동 프로파일을 가지므로, 기존 Opus/Sonnet용으로 튜닝된 하네스(rules, skills, system prompt)를 그대로 재사용하면 오히려 품질이 저하될 수 있습니다. 이 문서는 Fable 5 전용 프롬프팅·스캐폴딩 조정 패턴을 정리합니다.

		## Opus 4.8 대비 행동 차이

		\| 항목 \| 차이 \|
		\|------\|------\|
		\| Long-horizon autonomy \| 장시간 자율 작업 수행 능력 향상 — 중간 개입 없이 더 긴 turn을 유지 \|
		\| 병렬 서브에이전트 dispatch \| 병렬 서브에이전트 위임의 신뢰성 향상 \|
		\| Instruction following \| 지시 준수력이 더 강함 — 규범적(prescriptive) 지시에 더 문자적으로 반응 \|

		Instruction following이 강해졌다는 것은 장점이자 위험 요인입니다. 장문·과잉 규범적 지시를 그대로 유지하면, Fable 5는 이를 문자 그대로 따르려 하면서 불필요한 형식적 준수에 리소스를 쓰거나, 자연스러운 판단력을 발휘하지 못할 수 있습니다(아래 "핵심 경고" 참조).

		## 프롬프팅/하네스 튜닝 패턴

		\| 패턴 \| 설명 \| oh-my-customcode 매핑 \|
		\|------\|------\|------------------------\|
		\| (a) Longer turns 허용 \| Long-horizon autonomy를 살리기 위해 turn을 짧게 강제로 끊지 않음 \| R009 대규모 작업 분해와 균형 — 도메인 분해는 유지하되 개별 에이전트 turn 길이는 과도하게 제한하지 않음 \|
		\| (b) Effort 전략 \| 작업 복잡도에 맞는 effort 레벨 설정 \| R006 `effort` frontmatter 필드 — 신규 콘텐츠 (effort 전략 구체화는 이 가이드가 보완) \|
		\| (c) 간결 지시 우선 \| 장문·규범적 지시보다 간결하고 명확한 지시가 더 나은 결과를 냄 \| R023 shift-left 정신과 정합 — 신규 콘텐츠, "핵심 경고" 섹션 참조 \|
		\| (d) 진행 주장 ground-truth 강제 \| "완료했다"는 주장을 실제 산출물로 검증하도록 지시 \| R020 완료 검증(Completion Verification)이 이미 선점 — 개념 중복 아닌 보완 \|
		\| (e) Boundary 명시 \| 허용/금지 행동 경계를 명시적으로 진술 \| R010 Pre-Delegation Privileged-Scope Boundary가 이미 선점 — 보완 \|
		\| (f) 병렬 서브에이전트 \| 독립 작업의 병렬 위임 활용 \| R009 병렬 실행이 이미 선점 — Fable 5는 병렬 dispatch 신뢰성이 향상되어 R009 효과가 더 커짐 \|
		\| (g) 파일 기반 메모리 \| 세션 간 지속성을 위한 파일 기반 메모리 활용 \| R011 네이티브 auto memory가 이미 선점 — 보완 \|
		\| (h) Early-stopping/context-budget 방지 문구 \| 조기 종료나 컨텍스트 예산 소진으로 인한 작업 중단을 막는 명시적 문구 \| 신규 콘텐츠 — R013 ecomode의 context budget 관리와 함께 검토 가치 있음 \|
		\| (i) Intent 컨텍스트 제공 \| 작업의 배경 의도(왜 이 작업이 필요한지)를 함께 제공 \| 신규 콘텐츠 — R015 Intent Transparency와는 반대 방향(에이전트→사용자가 아니라 사용자/오케스트레이터→에이전트로 의도 전달) \|
		\| (j) 가독성 addendum \| 응답 가독성을 높이는 보충 지시 \| 신규 콘텐츠 \|
		\| (k) Send-to-user 도구 \| 사용자에게 직접 메시지를 보내는 전용 도구 활용 \| 신규 콘텐츠 — oh-my-customcode에는 현재 대응 도구 없음(향후 검토 후보) \|

		## 핵심 경고: 과잉 처방(over-prescription)이 오히려 품질을 저하시킨다

		Fable 5는 instruction following이 강하기 때문에, 기존 스킬/룰이 지나치게 규범적(too prescriptive)이면 — 즉 세부 절차를 과도하게 명시하면 — 오히려 Fable 5의 자연스러운 판단력과 long-horizon autonomy 이점을 깎아먹고 품질이 저하될 수 있습니다.

		본 프로젝트 함의: oh-my-customcode는 `.claude/rules/` 하위에 R000~R023의 장문·규범적 규칙 세트를 보유하고 있습니다. Fable 5를 오케스트레이터 또는 서브에이전트 모델로 채택할 경우:

		- 규칙 자체를 축소할 필요는 없지만(다른 모델과의 호환성 유지 필요), Fable 5 대상 에이전트에 전달하는 위임 프롬프트는 규칙 원문을 그대로 재인용하기보다 핵심 제약만 간결하게 요약하는 방식을 우선 검토합니다.
		- 신규 Fable 5 전용 에이전트/스킬을 설계할 때는 절차를 과도하게 세분화하지 않고, 목표와 경계(boundary)만 명시한 뒤 판단은 모델에 위임하는 방향을 우선 고려합니다.
		- 이 경고는 R023(검증 비용 ladder)의 shift-left 원칙과는 다른 축입니다 — R023은 "어떤 비용으로 검증할지", 이 경고는 "얼마나 규범적으로 지시할지"를 다룹니다.

		## GA 사양

		\| 항목 \| 값 \|
		\|------\|-----\|
		\| Model ID \| `claude-fable-5` \|
		\| GA 일자 \| 2026-06-09 \|
		\| 기본 컨텍스트 \| 1M 토큰 (기본 포함 — `[1m]` suffix 불필요, R006 Model Aliases 각주 참조) \|
		\| 가격 \| $10 / $50 per Mtok \|
		\| 안전 체계 \| 안전 분류기 + `stop_reason: "refusal"` fallback \|

		### Mythos 5 (`claude-mythos-5`)

		Mythos 5는 Project Glasswing 한정 공급 모델로, GA가 아닙니다. Fable 5(GA)와 혼동하지 않도록 주의합니다.

		## 상호 참조

		- R006 (MUST-agent-design.md) — Model Aliases 표에 `fable` alias 정의, effort/model 기본값 정책
		- R023 (SHOULD-verification-ladder.md) — 검증 비용 ladder shift-left 원칙. 이 문서의 "과잉 처방 경고"는 검증 비용이 아닌 지시 간결성 축이므로 R023과 직교하되 상호 참조 가치가 있음
		- R009 (MUST-parallel-execution.md) — long-lived subagent 재사용 및 병렬 서브에이전트 dispatch 신뢰성 향상과 연관
		- R020 (MUST-completion-verification.md) — 진행 주장 ground-truth 강제 패턴(d)의 기존 선점 규칙
		- R010 (MUST-orchestrator-coordination.md) — boundary 명시 패턴(e)의 기존 선점 규칙(Pre-Delegation Privileged-Scope Boundary)
		- R011 (SHOULD-memory-integration.md) — 파일 기반 메모리 패턴(g)의 기존 선점 규칙(네이티브 auto memory)

oh-my-customcode - npm Package Compare versions

Improved metrics