jeffy

Jeffy

Bootstrap per-project Jeffy state files, write the loop state file, and begin iteration 1. The loop engine is Jeffy's own Stop hook, shipped with this skill at hooks/stop-hook.sh: at every turn end it reads .claude/jeffy-loop.local.md at the project root, and while that file names this session and budget remains it re-feeds the iteration prompt; it deletes the file and lets the session end when the budget is spent, the completion promise fires, or one of its own gates ends the run - a stall, an oscillation, a time ceiling, or an audit or refill inside the closing window. The hook anchors itself to CLAUDE_PROJECT_DIR, which hooks receive fixed at the directory Claude Code was started in, so shell cwd drift mid-iteration cannot kill the loop. The hook is registered machine-wide in ~/.claude/settings.json by the installer but exits immediately in any session whose project has no state file. This skill only sets up and launches; the hook implements the loop mechanics.

Project root means the directory Claude Code was started in - the session's primary working directory shown in the environment, which is stable regardless of shell drift. Resolve it to an absolute path with forward slashes and use it everywhere below; never trust the shell's current cwd, which persists across Bash calls and may have drifted into a subdirectory.

Arguments

Parse $ARGUMENTS: if the first token is an integer, it is the iteration budget N, default 10, or 5 on a --highs launch. Next parse the mode flag and the ceiling flags wherever they appear in the remainder. --highs takes no value and selects High-hunt mode for this run: the loop audits the whole surface, fixes only Highs, audits again once no High is open, and closes the first time an audit finds none - no sweep obligation, no Medium or Low queue, no evaluator gate, no closing extension and no convergence claim; a hunt is not a convergence and its receipt is the pull request its Highs produce. The ceiling flags each take one value: --max-time <duration> sets max_wall_clock_seconds, --max-iter-time <duration> sets max_iteration_seconds, --max-context <N> sets max_context_growth, --evaluator-probe <k> sets evaluator_probe, a whole number of swept rows the gate probes, default 0 meaning off, and --max-surface <lines> sets the surface ceiling pre-flight check 11 refuses above, a whole number of tracked source lines, default 150000 on an Improvement launch and 600000 on a --highs launch, 0 meaning off; a duration is a bare number of seconds or a number suffixed s, m, or h (45m, 2h, 900s, 900), and 0 means off, the default for --max-time, --max-iter-time and --max-context; --max-surface alone is on by default. --refeed takes one value, full or pointer, and chooses what the Stop hook re-feeds at every turn end: full, the default, is the whole iteration prompt, the behaviour every receipt was earned under; pointer is the run state and one sentence pointing at the prompt file this session read at launch, an experimental setting for the pre-registered A/B on context occupancy, never a default until that experiment loses no convergence and no gate. A flag missing its value, an unparseable duration, a --max-surface value that is not a plain whole number (300k and 300,000 are refusals, 300000 is a value), a --refeed value other than full or pointer, an --evaluator-probe value that is not a plain whole number, or an unrecognized -- token is a refusal naming the token, never silently folded into the focus - a documented ceiling that becomes free text is a ceiling that is silently off. Whatever text remains after the budget and the flags is the focus directive for this run. If the token after the optional budget is exactly enhance, refuse the launch and stop: Enhance mode was removed in v1.11.0 - the defect loop is the product - and the last release that carries it is v1.10.0. On a fresh project, iteration 1 is always consumed by the audit that generates the backlog, so N=2 executes exactly one task; if the user picks N below 5, proceed but note that larger budgets make materially more progress.