fable-setup · diff

git:20260903.1d30645 to git:20260903.cd39192

16 added, 13 removed. Audit A to A.

---
name: fable-setup
description: Optional one-time setup for Claude Fable 5.1 in Claude Code. The plugin already injects the always-on prompting rules at every session start through a hook, so nothing needs to be edited for the defaults. Use /fable-setup to choose where the rules live (hook, a separate rules file, or a CLAUDE.md section), switch interactive/unattended mode, pick the effort default, and audit CLAUDE.md for conflicting rules. Triggers: "/fable-setup", "fable 세팅", "환경 점검", "무인 모드로", "apply the Fable guide", "set up for Fable 5.1", "unattended mode", "rules file".
---
# fable-setup · choose delivery, mode, effort; audit conflicts
Blocks: `${CLAUDE_PLUGIN_ROOT}/hooks/always-on.md` (+ `autonomy-unattended.md` for unattended mode).
Guide reference: `${CLAUDE_PLUGIN_ROOT}/skills/fable-prompt/references/prompt-blocks.md`.
Three layers: per request → `/fable-prompt`; always-on rules → delivered by this skill's choice (hook by
default); settings → mode, effort, and an admin checklist.
## Arguments (skip the matching question)
- `auto` (no questions, keep defaults) · `hook` | `rules-file` | `claude-md` (delivery) ·
+ `auto` (no questions, keep defaults) · `hook` (= rules file + hook) | `hook-only` | `claude-md` (delivery) ·
`auto` | `interactive` | `unattended` (mode) · `medium` | `high` (effort) · `remove` (undo everything, see Step 6).
## Step 1 · Detect (one batch of reads, silent)
`./CLAUDE.md`, `./.claude/CLAUDE.md`, `~/.claude/CLAUDE.md`, `~/.claude/settings.json`, `./.claude/settings.json`,
`~/.claude/oh-my-fable.json`, `./.claude/oh-my-fable.json`, `~/.claude/rules/`, `./.claude/rules/`,
`claude --version`, and the environment variable `CLAUDE_CODE_EFFORT_LEVEL`.
## Step 2 · Questions: one AskUserQuestion call with up to three questions
Bundle questions 1 to 3 into a single AskUserQuestion call (it supports several questions at once), each with
one-line options and the recommended one marked. No preamble, no explanation paragraphs. The goal is zero manual
steps for the user, so prefer asking over leaving something for them to do by hand.
1. **Where should the rules live?**
- - `Hook (recommended)` · nothing to edit, active on install
- - `Separate rules file` · `~/.claude/rules/oh-my-fable.md`, auto-loaded, editable, also reaches subagents and teams
- - `CLAUDE.md section` · inside your CLAUDE.md, needs edit approval (not in auto mode)
+ - `Rules file + hook (recommended)` · base rules in `~/.claude/rules/oh-my-fable.md` (auto-loaded, reaches subagents and teams); the hook adds the unattended paragraph per session
+ - `Hook only` · nothing written, main session only (subagents and teams do not get the rules)
+ - `CLAUDE.md section` · inside your CLAUDE.md, static, needs edit approval (not in auto mode)
2. **How do you mostly work?**
- `Auto (recommended)` · detects per session: unattended for headless/SDK/agent runs, interactive in the terminal or IDE
- `Interactive` · always as if you watch and steer
- `Unattended` · always adds "the user is not watching", even in the terminal
3. **Effort default?**
- `medium (recommended)` · Fable 5 quality at lower cost; raise per task with `/effort high`
- `high` · Anthropic's guide default
- `keep current` · shown with the current value from Step 1
Ask afterwards, only when relevant, one more call:
4. **Scope?** (only when the current directory is a git repo with its own CLAUDE.md)
- `All projects (recommended)` · global files under `~/.claude`
- `This project only` · files under `./.claude`
5. **Fix the conflicting rules for you?** (only when Step 4 finds conflicts; ask after showing the table)
- `Yes, apply the suggested edits` · edits CLAUDE.md, needs approval outside auto mode
- `No, just show me` · you edit by hand
Ask in the user's language.
## Step 3 · Apply
**Config** (always, global `~/.claude/oh-my-fable.json` or project `./.claude/oh-my-fable.json`):
```json
{"enabled": true, "mode": "auto", "delivery": "hook"}
```
If the write is refused, print the JSON and path; defaults apply without a file.
**Rules text** = `always-on.md`, with `autonomy-unattended.md` inserted after the heading when unattended. English
- regardless of the user's language. Note: only the hook delivery can detect the mode per session (`auto`); a rules
- file or CLAUDE.md section is static, so for those ask the user to pick interactive or unattended explicitly.
+ regardless of the user's language. The rules file carries the base rules only; the unattended paragraph is always
+ added by the hook per session, so `auto` mode works with the default delivery. Only the CLAUDE.md section is static.
- - `hook`: nothing else to write.
- - `rules-file`: write the rules text to `~/.claude/rules/oh-my-fable.md` (project: `./.claude/rules/oh-my-fable.md`).
- Claude Code loads `rules/*.md` automatically, so CLAUDE.md is not edited. Set `"delivery": "rules-file"` so the
- hook stays silent. If the write is refused, write it to `~/.claude/oh-my-fable/rules.md` instead and show the
- one line the user can add to CLAUDE.md: `@~/.claude/oh-my-fable/rules.md`.
+ - `hook` (rules file + hook, default): copy `${CLAUDE_PLUGIN_ROOT}/hooks/rules-file.md` verbatim to
+ `~/.claude/rules/oh-my-fable.md` (project scope: `./.claude/rules/oh-my-fable.md`). It starts with the marker
+ `<!-- oh-my-fable:rules v1` which tells the hook to add only the unattended paragraph per session. Claude Code
+ loads `rules/*.md` for the main session and for subagents and teams, so CLAUDE.md is not edited. Keep
+ `"delivery": "hook"` in the config. If the write is refused (auto permission mode may block instruction files),
+ say so in one line: the hook then carries everything for the main session, and the user can create the file by
+ hand from the shown path. Re-run `/fable-setup` after a plugin update to refresh the copy.
+ - `hook-only`: write nothing; set `"delivery": "hook"` and make sure no rules file exists. Main session only.
- `claude-md`: insert or replace between `<!-- oh-my-fable:start v1 -->` and `<!-- oh-my-fable:end -->` in the
chosen CLAUDE.md with the Edit tool; touch nothing else. Set `"delivery": "claude-md"`. If refused, do not retry
with another tool: say it needs a session outside auto mode, keep `hook`, and show the section for manual paste.
**Effort**: `high` or `medium` → set `effortLevel` in `~/.claude/settings.json` (merge, keep other keys; valid
values are low, medium, high, xhigh). An approval prompt may appear; that is expected. If a
`modelSettings.<model>.effortLevel` or the env var `CLAUDE_CODE_EFFORT_LEVEL` overrides it, say which one wins
in one line. If the write is refused, show the one-line change instead.
**Copies are snapshots.** A rules file or CLAUDE.md section is the text at install time. After a plugin update,
run `/fable-setup` again to refresh it; the hook delivery always uses the current text.
## Step 4 · Audit (one table, then question 5)
Rule found → verdict → one-line suggestion. Edit CLAUDE.md only if the user chose "Yes" in question 5; if
the edit is refused, show the exact replacement text once and move on.
Conflicts to flag: narration suppression ("hold findings for the final response", "no closing recap"),
anti-formatting rules ("no bullets", "no headers"), "ask before every step". Same-meaning rules → "already covered".
## Step 5 · Verify and close
Hook: run `bash "${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh"` with `CLAUDE_PROJECT_DIR` set and confirm the
- last line starts with `(oh-my-fable: mode`. Rules file / CLAUDE.md: confirm the file exists (markers exactly once)
- and the hook prints nothing. Then close with exactly this, translated:
+ last line starts with `(oh-my-fable: mode`. Rules file + hook: confirm the file exists with the marker and the hook prints only the mode line (or the
+ unattended paragraph). CLAUDE.md: confirm the markers appear exactly once and the hook prints nothing. Then close with exactly this, translated:
> Done. Rules: <delivery>, mode: <mode>, effort: <effort>. They apply automatically from the next Claude Code
> session. To use them in this session right now: if the plugin was installed in this session, type
> `/reload-plugins` first, then `/clear` (one per line; the rules are injected on session start, /clear, and
> compaction). Ask as usual; for short or vague requests use `/fable-prompt <request>`. Add "just the prompt"
> to preview only.
One status line: DONE, DONE_WITH_CONCERNS, or NEEDS_CONTEXT.
## Step 6 · `/fable-setup remove`
Undo everything this skill may have written, then tell the user to run `claude plugin uninstall oh-my-fable@oh-my-fable`:
- delete `~/.claude/oh-my-fable.json` and `./.claude/oh-my-fable.json`
- delete `~/.claude/rules/oh-my-fable.md` and `./.claude/rules/oh-my-fable.md`
- remove the `<!-- oh-my-fable:start` … `<!-- oh-my-fable:end -->` section (and its heading line) from any CLAUDE.md
- `effortLevel` in settings.json is left as is; say so in one line