oh-my-customcode 1.1.2 → 1.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli/index.js +1 -1
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/templates/.claude/rules/MUST-agent-design.md +12 -0
- package/templates/.claude/rules/MUST-agent-teams.md +4 -0
- package/templates/.claude/rules/MUST-completion-verification.md +2 -0
- package/templates/.claude/rules/MUST-enforcement-policy.md +2 -0
- package/templates/.claude/rules/MUST-orchestrator-coordination.md +4 -0
- package/templates/.claude/rules/MUST-parallel-execution.md +2 -0
- package/templates/.claude/rules/SHOULD-hud-statusline.md +2 -0
- package/templates/.claude/rules/SHOULD-verification-ladder.md +18 -0
- package/templates/guides/claude-code/16-fable5-prompting.md +67 -0
- package/templates/guides/claude-code/index.yaml +5 -0
- package/templates/manifest.json +1 -1
package/dist/cli/index.js
CHANGED
package/dist/index.js
CHANGED
package/package.json
CHANGED
|
@@ -35,6 +35,12 @@ Extended context suffix: `[1m]` (e.g., `claude-opus-4-6[1m]`) — enables 1M tok
|
|
|
35
35
|
|
|
36
36
|
> **v2.1.197+**: Claude Sonnet 5가 Claude Code의 **기본 모델**로 도입되었습니다 — 네이티브 1M-token 컨텍스트, 프로모션 가격 $2/$10 per Mtok(2026-08-31까지). `model: sonnet5` / `claude-sonnet-5`로 사용. oh-my-customcode의 base `sonnet` alias는 안정성을 위해 `claude-sonnet-4-6`에 고정 유지(기존 `sonnet` 지정 에이전트 불변); Sonnet 5는 `sonnet5`로 명시 opt-in. Sonnet 5가 CC 신규 기본값이므로 명시 모델 없는 세션은 이제 Sonnet 5에서 동작합니다.
|
|
37
37
|
|
|
38
|
+
> **Fable 5 Effort 전략**: Fable 5는 **high effort가 기본값**이며, `xhigh`는 capability-sensitive 작업(최고난도 아키텍처/추론)에 한정해야 합니다. Fable 5의 `low`/`medium` effort조차 이전 세대 모델의 `xhigh`를 상회하는 품질을 보이므로, Fable 5를 사용하는 실행 에이전트는 `effort` 필드를 신중히 명시하고 불필요한 `xhigh` 남용을 지양합니다(R005 비용/지연 인식과 정합).
|
|
39
|
+
|
|
40
|
+
> **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, 공급 제한).
|
|
41
|
+
|
|
42
|
+
> **프롬프팅 패턴 상호참조**: Fable 5/Mythos 5 대상 프롬프팅 패턴(effort 조합, adaptive-thinking 활용, refusal fallback 대응)의 상세 가이드는 `guides/claude-code/16-fable5-prompting.md`를 참조하세요.
|
|
43
|
+
|
|
38
44
|
### Fallback Models (CC v2.1.166+)
|
|
39
45
|
|
|
40
46
|
> **v2.1.166+**: The `fallbackModel` setting configures up to three fallback models tried in order when the primary model is overloaded or unavailable. `--fallback-model` now also applies to interactive sessions. CC additionally retries a turn once on the fallback model when the API rejects an unexpected non-retryable error (auth, rate-limit, request-size, and transport errors still surface immediately).
|
|
@@ -53,6 +59,8 @@ This is a settings-level resilience mechanism, distinct from the per-agent `mode
|
|
|
53
59
|
|
|
54
60
|
> **v2.1.196+**: 조직 기본 모델(org default models)이 추가되어 관리자가 org 콘솔에서 조직 전체 기본 모델을 설정하며, 사용자가 직접 선택하지 않으면 `/model`에 "Org default"(또는 "Role default")로 표시됩니다. v2.1.175 `enforceAvailableModels`/v2.1.187 org model restriction의 연장선 — 조직 관리 설정이 기본 모델 해석까지 관여합니다. 또한 백그라운드 세션 turn 이후 중복 recap 라인 문제를 수정 — schema-rejected된 StructuredOutput 시도가 재시도와 나란히 렌더되지 않습니다(schema-constrained subagent spawn / Workflow `agent({schema})`에 관련).
|
|
55
61
|
|
|
62
|
+
> **v2.1.198+**: 내장 Explore 에이전트가 이제 main session의 모델을 상속합니다(opus로 cap; 이전에는 haiku 고정) — Explore 기반 검색 subagent의 추론 품질이 향상됩니다. 또한 subagent와 context compaction이 session의 extended thinking 설정을 상속하여, 위임된 작업의 출력 품질이 세션 설정과 정합됩니다. R009/R018 병렬 subagent 위임 품질에 관련.
|
|
63
|
+
|
|
56
64
|
### Safe Mode & Bundled Skill Control (CC v2.1.169+)
|
|
57
65
|
|
|
58
66
|
> **v2.1.169+**: `--safe-mode` (and `CLAUDE_CODE_SAFE_MODE`) starts Claude Code with ALL customizations disabled (CLAUDE.md, plugins, skills, hooks, MCP servers) — use it to isolate whether a project customization (agent/skill/hook) causes a regression. The `disableBundledSkills` setting (and `CLAUDE_CODE_DISABLE_BUNDLED_SKILLS` env) hides bundled skills, workflows, and built-in slash commands from the model — useful when bundled skills conflict with or duplicate project skills (R006 skill-surface management). Note: `disableBundledSkills` hides skills from the model but is a CC platform setting, distinct from the advisory `skills:` frontmatter field (which is documentation metadata, not a runtime allowlist).
|
|
@@ -202,6 +210,8 @@ Agent frontmatter `hooks:` now fire when the agent runs as a main-thread agent v
|
|
|
202
210
|
|
|
203
211
|
> **v2.1.195+**: 하이픈이 포함된 hook matcher 식별자(예: `code-reviewer`, `mcp__brave-search`)가 이제 substring이 아니라 exact-match됩니다(이전에는 부분 문자열로 우연히 매칭). 하이픈 포함 MCP 서버의 모든 tool을 매칭하려면 `mcp__brave-search__.*` 형식을 사용하세요. 참고: oh-my-customcode의 `hooks.json`은 `*` / `mcp_tool_name matches "..."` / `tool == "..."` 형식을 사용하므로 이 변경의 영향을 받지 않습니다 — 다만 하이픈 포함 tool-name matcher를 새로 추가할 때 exact-match 시맨틱을 고려해야 합니다.
|
|
204
212
|
|
|
213
|
+
> **v2.1.199+**: SessionStart/Setup/SubagentStart hook이 exit code 2로 종료할 때 stderr를 조용히 숨기던 문제가 수정되어 이제 오류가 표시됩니다. `.claude/hooks.json`의 hard-block/advisory hook 디버깅 가시성이 향상됩니다(R021 Enforcement Tiers 관측성과 정합).
|
|
214
|
+
|
|
205
215
|
## Permission Mode Guidance
|
|
206
216
|
|
|
207
217
|
CC defaults `mode` to `acceptEdits` if not specified — always pass `mode: "bypassPermissions"` explicitly in Agent tool calls (see R010). See guidance details via Read tool.
|
|
@@ -400,6 +410,8 @@ Key optional fields: `scope`, `context`, `version`, `effort`, `model`, `agent`,
|
|
|
400
410
|
|
|
401
411
|
> **v2.1.178+**: When names collide across nested `.claude/` directories, the agent, workflow, and output-style CLOSEST to the working directory now wins; project-scope workflow saves target the closest existing `.claude/workflows/`. Relevant to multi-`.claude/` layouts — project-root `.claude/` definitions are overridden by a nested `.claude/` when working inside that subtree.
|
|
402
412
|
|
|
413
|
+
> **v2.1.199+**: 스택된 slash-skill 호출(`/skill-a /skill-b do XYZ`)이 이제 leading skill을 최대 5개까지 모두 로드합니다(이전에는 첫 번째만 로드). oh-my-customcode의 라우팅 스킬 체이닝(예: `/omcustom:fsd`가 여러 스킬을 연쇄 호출하는 패턴)에서 다중 스킬 스택 호출 시 컨텍스트 손실이 줄어듭니다. 또한 subagent 조회 중 `/model`·`/fast`를 입력하면 lead의 model picker가 열리며 notice가 표시됩니다.
|
|
414
|
+
|
|
403
415
|
<!-- DETAIL: Skill Optional Fields (full yaml block)
|
|
404
416
|
```yaml
|
|
405
417
|
scope: core # core | harness | package (default: core)
|
|
@@ -374,6 +374,10 @@ Cross-reference: R020 ("actual outcome ≠ attempt" — verifying that a command
|
|
|
374
374
|
|
|
375
375
|
> **CC v2.1.169+**: `claude agents --json` now includes blocked and just-dispatched background sessions (previously omitted), adds `--all` to include completed sessions, and adds `id` and `state` fields. This strengthens the deterministic ground-truth for member completion verification — `state` distinguishes blocked/running/completed directly, and `--all` confirms a member actually completed (rather than just disappearing from the active list). Use `--all` + `state` as the ground-truth signal instead of inferring completion from a member's absence.
|
|
376
376
|
|
|
377
|
+
> **v2.1.198+**: Agent Teams에서 teammate가 API 오류로 죽으면 이제 lead에 "failed"를 보고하고, stuck teammate에게 메시지를 보내면 즉시 wake시켜 retry하게 합니다. 이는 v2.1.169 `state` 필드 기반 deterministic ground-truth를 보강하지만, SendMessage report 자체는 여전히 low-reliability 신호로 취급한다(위 표의 원칙 불변).
|
|
378
|
+
|
|
379
|
+
> **v2.1.199+**: subagent가 rate limit/server error로 잘리면 partial work를 parent에 반환하며, subagent가 API 오류(usage limit reached 등)를 성공 결과로 오보하던 문제가 수정되어 이제 오류를 parent agent에 정확히 보고합니다. 플랫폼이 false-success 자가보고를 줄였으나, deterministic ground-truth(`git status`/`grep`/validation scripts) 검증 원칙은 여전히 유효하다.
|
|
380
|
+
|
|
377
381
|
**Stall handling**: When a member shows no task progress within ~2 minutes despite spawn + owner assignment + SendMessage coordination, reassign the work to a standalone Agent (R009) rather than continuing to nudge the stalled member. Stalled Teams members waste tokens on idle polling and delay the overall workflow.
|
|
378
382
|
|
|
379
383
|
Observed instance: v0.159.0 release (session 105) — members assigned to disjoint-file cleanup tasks went idle without executing; deterministic git-diff check exposed the gap; work was reassigned to standalone parallel Agents. References: #1261, #1262.
|
|
@@ -71,6 +71,8 @@ Subagents often report failures as "pre-existing", "baseline", or "unchanged". T
|
|
|
71
71
|
Never accept "pre-existing" without direct base-branch evidence. A false "pre-existing" claim can mask a regression introduced by the current change.
|
|
72
72
|
-->
|
|
73
73
|
|
|
74
|
+
> **v2.1.199+**: subagent가 API 오류(usage limit reached 등)를 성공 결과로 오보하던 문제가 수정되어 이제 오류가 parent agent에 정확히 보고됩니다. 플랫폼 수정으로 false-success 자가보고 빈도는 줄지만, "actual outcome ≠ attempt" ground-truth 검증 원칙(R020 Core Rule)은 여전히 유지된다 — subagent 보고를 그대로 신뢰하지 말고 `git status`/`grep`/validation script로 재확인한다.
|
|
75
|
+
|
|
74
76
|
## Common False Completion Patterns — 8 anti-patterns including "Command executed" without exit code check, "Waiting for manual publish" when CI auto-publishes, "UI changes done" without browser render. See full table via Read tool.
|
|
75
77
|
|
|
76
78
|
### Test-Skip Is Not Completion (#1217 item #5)
|
|
@@ -19,6 +19,8 @@ oh-my-customcode uses an **advisory-first enforcement model**. Most rules are en
|
|
|
19
19
|
|
|
20
20
|
> **v2.1.163+**: Stop and SubagentStop hooks can return `hookSpecificOutput.additionalContext` (JSON) to feed structured feedback back into Claude's context without triggering a hook error label. This enables advisory-style enforcement via Stop/SubagentStop hooks (e.g., `session-reflection.sh`, omcustom-loop SubagentStop) to pass richer context — replacing plain stderr text — without disrupting the turn continuation behavior that advisory-first enforcement relies on.
|
|
21
21
|
|
|
22
|
+
> **v2.1.199+**: SessionStart/Setup/SubagentStart hook이 exit code 2로 종료할 때 stderr를 조용히 숨기던 문제가 수정되어 이제 오류가 표시됩니다. Hard Block/Advisory 계층(위 Enforcement Tiers 표)의 훅 실패 관측성을 강화합니다 — cf. v2.1.163 `additionalContext` 구조화 피드백.
|
|
23
|
+
|
|
22
24
|
## Why Advisory-First
|
|
23
25
|
|
|
24
26
|
1. **Agent flexibility**: Hard blocks can trap agents in unrecoverable states
|
|
@@ -337,6 +337,10 @@ Before spawning any agent:
|
|
|
337
337
|
|
|
338
338
|
> **v2.1.196+**: 백그라운드 작업을 wake할 때 transcript probe가 실제 transcript를 오독하여 대화를 영구 삭제하고 원 프롬프트를 재실행하던 문제를 수정 — 이제 파일을 삭제하지 않고 따로 보관합니다(transcript 의존 스킬 `homework`/`episodic-memory`에 관련). `claude agents --dangerously-skip-permissions`가 조용히 auto mode로 폴백하던 문제를 수정하여 bypass 고지를 표시하고 spawned agent에도 bypass 모드를 적용합니다(R010 Universal bypassPermissions와 정합). 또한 `claude agents` 사이드 패널 문제들(에이전트 열 때 키보드 포커스 고착, 열 때마다 백그라운드 작업의 subagent type 유실, 활성 실행 중 잘못된 상태 표시)을 수정. `mode: "bypassPermissions"`는 여전히 필수입니다.
|
|
339
339
|
|
|
340
|
+
> **v2.1.198+**: `claude agents`에서 launch된 background agent가 worktree에서 code 작업을 완료하면 이제 멈춰서 묻지 않고 commit·push·draft PR open을 자동 수행합니다. 또한 응답 중 일시적 network 오류(ECONNRESET 등)로 turn이 abort되던 문제가 backoff retry로 수정되었고, web/desktop/VS Code task panel에서 background task가 완료 후에도 "Running"으로 멈춰있던 문제가 수정되었습니다. background agent의 자동 commit/PR 자동화가 강화되었으므로, `mode: "bypassPermissions"`는 여전히 필수입니다.
|
|
341
|
+
|
|
342
|
+
> **v2.1.199+**: subagent가 rate limit이나 server error로 잘리면 이제 조용히 실패하는 대신 partial work를 parent에 반환합니다. background-agent daemon(Linux)이 unclean shutdown 후 corrupted worker record로 ~50초마다 자신과 모든 agent를 죽이던 문제, macOS SSH cold-start "Could not switch to audit session" 문제, `claude stop`이 background-agent respawn과 race하면 조용히 무효화되던 문제(이제 respawn이 stop을 존중), background job progress indicator가 긴 명령 중 멈춰있던 문제가 수정되었습니다. background-agent lifecycle 견고성이 추가로 강화되었으며, `mode: "bypassPermissions"`는 여전히 필수입니다.
|
|
343
|
+
|
|
340
344
|
## Agent Capability Pre-Check
|
|
341
345
|
|
|
342
346
|
Before delegating a task to a subagent, MUST verify the target agent's tool capabilities against the task requirements. Failure to pre-check causes round-trip waste (delegation → failure → re-delegation).
|
|
@@ -90,6 +90,8 @@ Reference: #1320 (fix), #1321 (session 113 retrospective 찐빠 #1), `feedback_l
|
|
|
90
90
|
| Instance independence | Isolated context, no shared state |
|
|
91
91
|
| Large tasks (>3 min) | MUST split into parallel sub-tasks |
|
|
92
92
|
|
|
93
|
+
> **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`.
|
|
94
|
+
|
|
93
95
|
## Adaptive Parallel Splitting
|
|
94
96
|
|
|
95
97
|
Runtime detection and splitting of stalled parallel agents. Complements pre-execution parallelization.
|
|
@@ -31,6 +31,8 @@ Format: `─── [Spawn] {subagent_type}:{model} | {description} ───`
|
|
|
31
31
|
|
|
32
32
|
> **v2.1.196+**: 여러 병렬 요청이 사용량 한도에 도달하는 순간 rate-limit 경고가 깜빡이며 꺼지고 rate-limit telemetry가 과다 집계되던 문제를 수정. R012 관측성의 rate-limit 계측 정확도 개선입니다.
|
|
33
33
|
|
|
34
|
+
> **v2.1.198+**: `claude agents`에 background agent notifications가 추가되어, 입력이 필요하거나 완료된 세션이 `Notification` hook을 발화합니다(`agent_needs_input` / `agent_completed`). R012 관측성을 백그라운드 subagent 상태 알림까지 확장 — HUD 이벤트 채널과 결합해 백그라운드 위임 작업의 대기/완료 상태를 놓치지 않게 합니다.
|
|
35
|
+
|
|
34
36
|
<!-- DETAIL: HUD Events full spec
|
|
35
37
|
### When to Display: Multi-step tasks, parallel execution, long-running operations. Skip for single brief operations.
|
|
36
38
|
### Parallel Display:
|
|
@@ -58,6 +58,10 @@ R021 (MUST-enforcement-policy)과 R023은 **직교**한다. 두 규칙은 서로
|
|
|
58
58
|
|
|
59
59
|
R021은 위반 시 어떻게 멈출지를, R023은 어떤 순서로 검증할지를 정의한다.
|
|
60
60
|
|
|
61
|
+
## Fable 5 Over-Prescription Advisory (Origin: #1435)
|
|
62
|
+
|
|
63
|
+
Fable 5 실행 에이전트/스킬은 지시(instruction) 장문화가 오히려 품질을 저하시킬 수 있다(too prescriptive). 신규 규칙/스킬 추가 시 간결성을 우선하고, Fable 5 실행 대상 문서의 과잉처방을 경계한다. 상세는 `guides/claude-code/16-fable5-prompting.md` 참조.
|
|
64
|
+
|
|
61
65
|
## Self-Check
|
|
62
66
|
|
|
63
67
|
새 검증 도구 추가 시:
|
|
@@ -88,6 +92,16 @@ staleness/audit 검증은 model ID·placeholder·TBD뿐 아니라 **폐기된
|
|
|
88
92
|
|--------------|----------|
|
|
89
93
|
| staleness 스캔을 model ID/placeholder/TBD로만 한정 | 폐기된 플랫폼 기능/절차 참조(deprecated CC feature/procedure)도 grep 스캔 |
|
|
90
94
|
|
|
95
|
+
## Detection Guard Delegation Standard (Origin: #1438 #3)
|
|
96
|
+
|
|
97
|
+
Tier-1 shift-left 검출 가드(예: deprecated-pattern grep 가드)의 설계·수정을 서브에이전트에 위임할 때, 위임 프롬프트는 **positive-match(genuine defect mandate — `MUST`/`MANDATORY` 인접 문맥)와 negative-context(deprecation note — "no longer"/"deprecated"/"불필요"/"폐기됨" 설명 문구)를 구분**하도록 명시해야 한다. 이를 누락하면 올바르게 수정된 파일의 폐기-설명 문구까지 과잉매칭하여 자기모순 BLOCK을 유발한다.
|
|
98
|
+
|
|
99
|
+
| Anti-pattern | Required |
|
|
100
|
+
|--------------|----------|
|
|
101
|
+
| bare 패턴(`/tmp/*.sh` 등)만 grep하도록 위임 → 올바르게 수정된 파일의 "폐기됨/불필요" 설명 문구까지 오탐 | 위임 프롬프트에 positive-match(MUST/MANDATORY 인접) vs negative-context(deprecated/no longer/불필요 설명) 구분 기준을 명시 |
|
|
102
|
+
|
|
103
|
+
Origin: #1438 (Session 125 회고 찐빠 #3) — deep-verify 가드 반전 위임 시 bare `/tmp/*.sh` 패턴이 올바르게 수정된 9개 파일의 "폐기됨/불필요" 설명 문구까지 오탐; mgr-sauron이 sha256 재계산으로 적발, 3-패턴(mandate/false-claim) 협소화로 정정.
|
|
104
|
+
|
|
91
105
|
## Integration
|
|
92
106
|
|
|
93
107
|
| 규칙 | 상호작용 |
|
|
@@ -118,12 +132,16 @@ Before invoking a Workflow script, deterministically verify:
|
|
|
118
132
|
| No unresolved placeholders (`{phase1_summary}`, `TODO`, `<...>`, `{{ }}`) remain in any agent prompt string | An unfilled placeholder reaches the agent verbatim → garbled task |
|
|
119
133
|
| Template-literal / string concatenation produces the intended prompt (assemble-before-call, see above) | Post-call concatenation (`agent(prompt) + FACTS`) silently drops content |
|
|
120
134
|
| Script parses — balanced braces/quotes, valid JS | A syntax error aborts the entire run after partial work |
|
|
135
|
+
| 프롬프트 문자열 내 셸 변수 `${...}`(`$?`, `${PIPESTATUS[0]}`, `$(...)` 등)가 `\${...}`로 이스케이프되어 있는지 사전 grep 확인 | JS 템플릿 리터럴 안의 이스케이프 안 된 셸 `${...}`를 JS가 JS 표현식으로 평가 → 런타임 `ReferenceError`(예: `PIPESTATUS is not defined`). `node --check`는 문법만 검사하여 이 런타임 오류를 못 잡으므로 별도 결정론 grep 검사가 필요함 |
|
|
121
136
|
|
|
122
137
|
#### Common Violation (#1271)
|
|
123
138
|
Session 106 follow-up to #1266 ③: a Workflow authoring error recurred — the guardrail fact-sheet was concatenated onto the agent's RETURN VALUE instead of the prompt string, and a placeholder/assembly slip went uncaught because no pre-run sanity check existed. This check is the deterministic Tier-1 guard that catches such slips before the expensive run.
|
|
124
139
|
|
|
125
140
|
Origin: #1271 (Workflow authoring error recurrence, session 106).
|
|
126
141
|
|
|
142
|
+
#### Common Violation (#1438)
|
|
143
|
+
Origin: #1438 (Session 125 회고 찐빠 #2) — fix Workflow의 verify 프롬프트에 `${PIPESTATUS[0]}`를 이스케이프 없이 사용 → `PIPESTATUS is not defined` ReferenceError로 verify 단계 실패. `node --check`는 통과했으나 런타임에서 실패.
|
|
144
|
+
|
|
127
145
|
### Verifier Ground-Truth for Cross-Cutting Facts
|
|
128
146
|
|
|
129
147
|
Cross-cutting facts not verifiable from the primary source (external URLs, in-cluster DNS/hostnames, infra topology) MUST be supplied to the verifier as explicit ground-truth. Otherwise an adversarial verifier cannot distinguish a hallucinated value from a correct one — a verification blind spot.
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# Claude Fable 5 프롬프팅 가이드
|
|
2
|
+
|
|
3
|
+
> 출처: https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/prompting-claude-fable-5
|
|
4
|
+
> 범위 제한: 이 문서는 위 출처 URL에 대한 이슈 #1435 본문 요약만을 소스로 합니다. 공식 문서 원문을 직접 확인하지 못했으므로, 코드 스니펫이나 세부 예시 문구를 추측으로 채우지 않습니다. 구체적인 프롬프트 원문이 필요하면 출처 URL을 직접 확인하세요.
|
|
5
|
+
|
|
6
|
+
## 개요
|
|
7
|
+
|
|
8
|
+
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 전용 프롬프팅·스캐폴딩 조정 패턴을 정리합니다.
|
|
9
|
+
|
|
10
|
+
## Opus 4.8 대비 행동 차이
|
|
11
|
+
|
|
12
|
+
| 항목 | 차이 |
|
|
13
|
+
|------|------|
|
|
14
|
+
| Long-horizon autonomy | 장시간 자율 작업 수행 능력 향상 — 중간 개입 없이 더 긴 turn을 유지 |
|
|
15
|
+
| 병렬 서브에이전트 dispatch | 병렬 서브에이전트 위임의 신뢰성 향상 |
|
|
16
|
+
| Instruction following | 지시 준수력이 더 강함 — 규범적(prescriptive) 지시에 더 문자적으로 반응 |
|
|
17
|
+
|
|
18
|
+
Instruction following이 강해졌다는 것은 장점이자 위험 요인입니다. 장문·과잉 규범적 지시를 그대로 유지하면, Fable 5는 이를 문자 그대로 따르려 하면서 불필요한 형식적 준수에 리소스를 쓰거나, 자연스러운 판단력을 발휘하지 못할 수 있습니다(아래 "핵심 경고" 참조).
|
|
19
|
+
|
|
20
|
+
## 프롬프팅/하네스 튜닝 패턴
|
|
21
|
+
|
|
22
|
+
| 패턴 | 설명 | oh-my-customcode 매핑 |
|
|
23
|
+
|------|------|------------------------|
|
|
24
|
+
| (a) Longer turns 허용 | Long-horizon autonomy를 살리기 위해 turn을 짧게 강제로 끊지 않음 | R009 대규모 작업 분해와 균형 — 도메인 분해는 유지하되 개별 에이전트 turn 길이는 과도하게 제한하지 않음 |
|
|
25
|
+
| (b) Effort 전략 | 작업 복잡도에 맞는 effort 레벨 설정 | R006 `effort` frontmatter 필드 — 신규 콘텐츠 (effort 전략 구체화는 이 가이드가 보완) |
|
|
26
|
+
| (c) 간결 지시 우선 | 장문·규범적 지시보다 간결하고 명확한 지시가 더 나은 결과를 냄 | R023 shift-left 정신과 정합 — 신규 콘텐츠, "핵심 경고" 섹션 참조 |
|
|
27
|
+
| (d) 진행 주장 ground-truth 강제 | "완료했다"는 주장을 실제 산출물로 검증하도록 지시 | R020 완료 검증(Completion Verification)이 이미 선점 — 개념 중복 아닌 보완 |
|
|
28
|
+
| (e) Boundary 명시 | 허용/금지 행동 경계를 명시적으로 진술 | R010 Pre-Delegation Privileged-Scope Boundary가 이미 선점 — 보완 |
|
|
29
|
+
| (f) 병렬 서브에이전트 | 독립 작업의 병렬 위임 활용 | R009 병렬 실행이 이미 선점 — Fable 5는 병렬 dispatch 신뢰성이 향상되어 R009 효과가 더 커짐 |
|
|
30
|
+
| (g) 파일 기반 메모리 | 세션 간 지속성을 위한 파일 기반 메모리 활용 | R011 네이티브 auto memory가 이미 선점 — 보완 |
|
|
31
|
+
| (h) Early-stopping/context-budget 방지 문구 | 조기 종료나 컨텍스트 예산 소진으로 인한 작업 중단을 막는 명시적 문구 | 신규 콘텐츠 — R013 ecomode의 context budget 관리와 함께 검토 가치 있음 |
|
|
32
|
+
| (i) Intent 컨텍스트 제공 | 작업의 배경 의도(왜 이 작업이 필요한지)를 함께 제공 | 신규 콘텐츠 — R015 Intent Transparency와는 반대 방향(에이전트→사용자가 아니라 사용자/오케스트레이터→에이전트로 의도 전달) |
|
|
33
|
+
| (j) 가독성 addendum | 응답 가독성을 높이는 보충 지시 | 신규 콘텐츠 |
|
|
34
|
+
| (k) Send-to-user 도구 | 사용자에게 직접 메시지를 보내는 전용 도구 활용 | 신규 콘텐츠 — oh-my-customcode에는 현재 대응 도구 없음(향후 검토 후보) |
|
|
35
|
+
|
|
36
|
+
## 핵심 경고: 과잉 처방(over-prescription)이 오히려 품질을 저하시킨다
|
|
37
|
+
|
|
38
|
+
Fable 5는 instruction following이 강하기 때문에, 기존 스킬/룰이 지나치게 규범적(too prescriptive)이면 — 즉 세부 절차를 과도하게 명시하면 — 오히려 Fable 5의 자연스러운 판단력과 long-horizon autonomy 이점을 깎아먹고 품질이 저하될 수 있습니다.
|
|
39
|
+
|
|
40
|
+
**본 프로젝트 함의**: oh-my-customcode는 `.claude/rules/` 하위에 R000~R023의 장문·규범적 규칙 세트를 보유하고 있습니다. Fable 5를 오케스트레이터 또는 서브에이전트 모델로 채택할 경우:
|
|
41
|
+
|
|
42
|
+
- 규칙 자체를 축소할 필요는 없지만(다른 모델과의 호환성 유지 필요), Fable 5 대상 에이전트에 전달하는 위임 프롬프트는 규칙 원문을 그대로 재인용하기보다 핵심 제약만 간결하게 요약하는 방식을 우선 검토합니다.
|
|
43
|
+
- 신규 Fable 5 전용 에이전트/스킬을 설계할 때는 절차를 과도하게 세분화하지 않고, 목표와 경계(boundary)만 명시한 뒤 판단은 모델에 위임하는 방향을 우선 고려합니다.
|
|
44
|
+
- 이 경고는 R023(검증 비용 ladder)의 shift-left 원칙과는 다른 축입니다 — R023은 "어떤 비용으로 검증할지", 이 경고는 "얼마나 규범적으로 지시할지"를 다룹니다.
|
|
45
|
+
|
|
46
|
+
## GA 사양
|
|
47
|
+
|
|
48
|
+
| 항목 | 값 |
|
|
49
|
+
|------|-----|
|
|
50
|
+
| Model ID | `claude-fable-5` |
|
|
51
|
+
| GA 일자 | 2026-06-09 |
|
|
52
|
+
| 기본 컨텍스트 | 1M 토큰 (기본 포함 — `[1m]` suffix 불필요, R006 Model Aliases 각주 참조) |
|
|
53
|
+
| 가격 | $10 / $50 per Mtok |
|
|
54
|
+
| 안전 체계 | 안전 분류기 + `stop_reason: "refusal"` fallback |
|
|
55
|
+
|
|
56
|
+
### Mythos 5 (`claude-mythos-5`)
|
|
57
|
+
|
|
58
|
+
Mythos 5는 Project Glasswing 한정 공급 모델로, **GA가 아닙니다**. Fable 5(GA)와 혼동하지 않도록 주의합니다.
|
|
59
|
+
|
|
60
|
+
## 상호 참조
|
|
61
|
+
|
|
62
|
+
- **R006** (MUST-agent-design.md) — Model Aliases 표에 `fable` alias 정의, effort/model 기본값 정책
|
|
63
|
+
- **R023** (SHOULD-verification-ladder.md) — 검증 비용 ladder shift-left 원칙. 이 문서의 "과잉 처방 경고"는 검증 비용이 아닌 지시 간결성 축이므로 R023과 직교하되 상호 참조 가치가 있음
|
|
64
|
+
- **R009** (MUST-parallel-execution.md) — long-lived subagent 재사용 및 병렬 서브에이전트 dispatch 신뢰성 향상과 연관
|
|
65
|
+
- **R020** (MUST-completion-verification.md) — 진행 주장 ground-truth 강제 패턴(d)의 기존 선점 규칙
|
|
66
|
+
- **R010** (MUST-orchestrator-coordination.md) — boundary 명시 패턴(e)의 기존 선점 규칙(Pre-Delegation Privileged-Scope Boundary)
|
|
67
|
+
- **R011** (SHOULD-memory-integration.md) — 파일 기반 메모리 패턴(g)의 기존 선점 규칙(네이티브 auto memory)
|
|
@@ -74,3 +74,8 @@ documents:
|
|
|
74
74
|
title: Claude Code Version Compatibility
|
|
75
75
|
description: Claude Code 릴리즈 버전별 호환성 및 기능 변경 추적
|
|
76
76
|
path: ./15-version-compatibility.md
|
|
77
|
+
|
|
78
|
+
- name: fable5-prompting
|
|
79
|
+
title: Claude Fable 5 프롬프팅 가이드
|
|
80
|
+
description: Fable 5 전용 프롬프팅·하네스 튜닝 패턴 — Opus 4.8 대비 행동 차이와 R006/R009/R020/R023 매핑
|
|
81
|
+
path: ./16-fable5-prompting.md
|
package/templates/manifest.json
CHANGED