tale-mode plugin
Discipline mode (staged planning, receipts, verify-against-source, adversarial review) + plan/kickoff commands + a plan-reviewer agent + an always-on SessionStart discipline injector + a Stop-hook autonomous loop (Layer 1, a deterministic gate) that can arm itself from a committed, content-hash-trusted .claude/tale-mode.json during a kickoff phase + a fail-closed plan-mode auto-approve for provably read-only shell (no more permission-dialog walls during investigation).
How to install the tale-mode plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add alicicek/tale-mode
/plugin install tale-mode@tale-modeWhat's inside tale-mode
13 parts read from the plugin's own files.
Commands 2
Run as /tale-mode:name- /tale-mode:kickoff-phase<plan-file-path> <phase/chunk id>
Start a scoped chunk of a larger plan in a fresh session — interview the user first, then implement only that chunk.
- /tale-mode:plan-phase<the task or feature to plan>
Plan a task to a high bar — verify against the code, receipts on every decision, adversarial review, runnable verification gates.
Agents 1
Call as @agent-tale-mode:name- @agent-tale-mode:plan-revieweropus
>-
Skills 6
Claude loads it when the task matches- end-phase
Explicitly end a tale-mode build phase by clearing the phase marker(s) under <project>/.claude/, which stops the Stop-hook's committed-gate enforcement for this repo. Invoke ONLY when the user explicitly asks to end the phase, stop or disarm the tale-mode phase loop, or clean up phase markers — never proactively, and never as a way to escape a failing gate.
- kickoff-phase
Build ONE scoped phase of an existing multi-phase plan in a fresh session — re-verify the plan against the live code, interview the user sharply on real forks, then implement only that phase behind plan-mode approval with runnable verification and a fresh-eyes review. Invoke explicitly when starting a phase (the cross-platform form of /tale-mode:kickoff-phase; on Codex, name the plan-file + phase in your prompt). On Claude Code, use the /tale-mode:kickoff-phase command instead of this skill.
- plan-phase
Plan a large, multi-phase feature to a high bar — verify against the code, receipts on every decision, an adversarial fresh-eyes review, and runnable verification gates, decomposed into independently-shippable phases. Invoke explicitly when starting a big multi-session build (the cross-platform form of the /tale-mode:plan-phase command; on Codex, name the task in your prompt). On Claude Code, use the /tale-mode:plan-phase command instead of this skill.
- seed-gates
Scan a repo's package.json scripts, CI workflows, and equivalent manifests, then SUGGEST a committed .claude/tale-mode.json gate list for tale-mode's Stop-hook loop — suggestions only; this skill never writes the config unasked, never trusts it, and never arms anything. Invoke ONLY when the user explicitly asks to seed, suggest, or set up tale-mode gates for a repo.
- tale-mode
Make Claude work rigorously on complex or high-stakes tasks instead of one-shotting them. Triggers: "tale mode", "tale on" — or self-activates on hard multi-step work. Enforces staged planning, decisions-with-receipts, verifying claims against the real source (not memory), parallel delegation, an independent adversarial review for high-stakes output, and durable progress notes. Right-sizes itself so trivial work stays fast.
- trust
Reference for tale-mode's two user-only opt-in files — the committed-gate trust store (~/.claude/tale-mode-trust) and the Codex cwd-root opt-in (~/.tale-mode-allow-cwd-root) — and their security model. Invoke ONLY when the user explicitly asks how to trust a repo's committed tale-mode gates, about the "content-hash is NOT trusted" notice, or how to enable the autonomous loop on Codex. Do NOT load this proactively, and NEVER write either file yourself — both grants are manual, user-only actions.
Hooks 4
Runs on these events- PreToolUsecommand
Bash
- SessionStartcommand
No description in the file.
- Stopcommand
No description in the file.
- UserPromptSubmitcommand
No description in the file.
Using tale-mode in Claude Code
Type a command in a Claude Code session:
/tale-mode:kickoff-phase <plan-file-path> <phase/chunk id>
/tale-mode:plan-phase <the task or feature to plan>Ask for an agent by name:
@agent-tale-mode:plan-reviewerSkills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update tale-mode@tale-mode
- Refresh the marketplace
- /plugin marketplace update tale-mode
- Turn it off for now
- /plugin disable tale-mode@tale-mode
- Remove it
- /plugin uninstall tale-mode@tale-mode
Skills in tale-mode
- end-phasealicicek/tale-mode
Explicitly end a tale-mode build phase by clearing the phase marker(s) under <project>/.claude/, which stops the Stop-hook's committed-gate enforcement for this repo. Invoke ONLY when the user explicitly asks to end the phase, stop or disarm the tale-mode phase loop, or clean up phase markers — never proactively, and never as a way to escape a failing gate.
37stars - kickoff-phasealicicek/tale-mode
Build ONE scoped phase of an existing multi-phase plan in a fresh session — re-verify the plan against the live code, interview the user sharply on real forks, then implement only that phase behind plan-mode approval with runnable verification and a fresh-eyes review. Invoke explicitly when starting a phase (the cross-platform form of /tale-mode:kickoff-phase; on Codex, name the plan-file + phase in your prompt). On Claude Code, use the /tale-mode:kickoff-phase command instead of this skill.
37stars - plan-phasealicicek/tale-mode
Plan a large, multi-phase feature to a high bar — verify against the code, receipts on every decision, an adversarial fresh-eyes review, and runnable verification gates, decomposed into independently-shippable phases. Invoke explicitly when starting a big multi-session build (the cross-platform form of the /tale-mode:plan-phase command; on Codex, name the task in your prompt). On Claude Code, use the /tale-mode:plan-phase command instead of this skill.
37stars - seed-gatesalicicek/tale-mode
Scan a repo's package.json scripts, CI workflows, and equivalent manifests, then SUGGEST a committed .claude/tale-mode.json gate list for tale-mode's Stop-hook loop — suggestions only; this skill never writes the config unasked, never trusts it, and never arms anything. Invoke ONLY when the user explicitly asks to seed, suggest, or set up tale-mode gates for a repo.
37stars - tale-modealicicek/tale-mode
Make Claude work rigorously on complex or high-stakes tasks instead of one-shotting them. Triggers: "tale mode", "tale on" — or self-activates on hard multi-step work. Enforces staged planning, decisions-with-receipts, verifying claims against the real source (not memory), parallel delegation, an independent adversarial review for high-stakes output, and durable progress notes. Right-sizes itself so trivial work stays fast.
37stars - trustalicicek/tale-mode
Reference for tale-mode's two user-only opt-in files — the committed-gate trust store (~/.claude/tale-mode-trust) and the Codex cwd-root opt-in (~/.tale-mode-allow-cwd-root) — and their security model. Invoke ONLY when the user explicitly asks how to trust a repo's committed tale-mode gates, about the "content-hash is NOT trusted" notice, or how to enable the autonomous loop on Codex. Do NOT load this proactively, and NEVER write either file yourself — both grants are manual, user-only actions.
37stars
tale-mode plugin questions
How do I install the tale-mode plugin?
In Claude Code run /plugin marketplace add alicicek/tale-mode, then /plugin install tale-mode@tale-mode.
What does the tale-mode plugin include?
tale-mode bundles 2 commands, 1 agent, 6 skills, hooks.
What commands does the tale-mode plugin add?
It adds /tale-mode:kickoff-phase, /tale-mode:plan-phase. Run them in Claude Code with the plugin prefix, for example /tale-mode:kickoff-phase.
Which agents come with tale-mode?
plan-reviewer. Call one with @agent-tale-mode:plan-reviewer.
How do I update or remove the tale-mode plugin?
Update it with claude plugin update tale-mode@tale-mode in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall tale-mode@tale-mode.
What license is the tale-mode plugin under?
MIT, as stated in the plugin's manifest.