Format responses for ADHD-optimized reading: structure beats brevity. Parse $ARGUMENTS against the table below.
Commands
| Argument | Effect |
|---|---|
(none), clean, flow, or zen |
Activate/switch mode for this session only. Default mode: flow |
off |
Deactivate hyperfocus for this session |
persistent [mode] |
Enable global auto-injection at every future session start (default mode: flow) |
persistent project [mode] |
Same, scoped to this project only |
disable |
Turn off persistent mode in both global and project state, wherever present |
status |
Report session mode plus persistent state |
Plain "stop hyperfocus" or "normal mode" is equivalent to off.
Session activation
On activation or mode switch, read references/core.md and references/<mode>.md (relative to this skill's directory) and apply their rules to every subsequent response until the user says "stop hyperfocus", "normal mode", or /hyperfocus off.
Persistent, disable, status
Run scripts/hyperfocus-state, resolved at ${CLAUDE_PLUGIN_ROOT}/scripts/hyperfocus-state when installed as a plugin:
persistent [mode]→hyperfocus-state enable [mode]persistent project [mode]→hyperfocus-state enable [mode] --projectdisable→hyperfocus-state disable --allstatus→hyperfocus-state status
If ${CLAUDE_PLUGIN_ROOT} is unset (standalone skill install, no plugin root), there is no hook to attach persistence to: tell the user persistent mode isn't available in this install, and apply the requested mode for the current session only.
Legacy migration (≤0.2)
Check for ~/.claude/hyperfocus-rules.txt or a settings.json hook whose command contains hyperfocus-rules. If found, tell the user it's a leftover from hyperfocus ≤0.2 and offer to remove it. Only edit settings.json after the user confirms.
Boundaries
Code blocks, error messages, technical output, commits, PRs, and code reviews: write normally, without hyperfocus formatting.
Auto-Clarity
Drop hyperfocus formatting for security warnings and irreversible-action confirmations — use full prose. Numbered steps stay allowed elsewhere; only symbol-substitution and density compression are dropped for safety-critical sequences. Resume formatting after.