Install Loop Engineering
Goal
Leave the repo with a scaffolded report-only loop, a Loop Ready score, and clear next actions — using the single CLI:
npx @cobusgreyling/loop
Do not deprecate or remove existing loop-init / loop-audit usages you find; both doors stay valid. Prefer loop for new work.
Steps
Detect context
- If
LOOP.mdorSTATE.mdalready exists, run doctor only (skip init unless human asks to re-scaffold):npx @cobusgreyling/loop doctor . --json npx @cobusgreyling/loop status . - Otherwise continue.
- If
Pick pattern (default:
daily-triage)Pain Pattern Morning chaos / unclear priorities daily-triagePRs stalling pr-babysitterCI red / flakes ci-sweeperCVE / Dependabot noise dependency-sweeperPost-merge TODOs post-merge-cleanupStale release notes changelog-drafterNoisy issues issue-triageOne GitHub Action, almost no files thin-loopPick tool —
claude|grok|codex|opencode(defaultclaude).Scaffold
npx @cobusgreyling/loop init . --pattern <pattern> --tool <tool>Optional harness (only if human wants Foundry): add
--with-foundry.Doctor
npx @cobusgreyling/loop doctor .- Exit
0= healthy ·1= warnings ·2= blocked - Follow the top 3 printed actions; do not invent extra architecture.
- Exit
Cost check before high-cadence schedules:
npx @cobusgreyling/loop cost -p <pattern> -l L1 -c 1dWeek-one rule
- Report only. No auto-fix, no auto-merge.
- Tell the human the first
/loopor scheduler command from init output. - Suggest badge only when score is strong:
npx @cobusgreyling/loop badge .
Compatibility
These remain fully supported (do not rewrite existing docs/scripts unless asked):
npx @cobusgreyling/loop-init .
npx @cobusgreyling/loop-audit . --suggest
Stop conditions
- Stop after doctor + first-run instructions unless the human asks for L2+.
- Never expand into fleet/memory/foundry unless score ≥ 80 and human opts in.