install-loop

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.

Detect context
- If LOOP.md or STATE.md already exists, run doctor only (skip init unless human asks to re-scaffold):
```
npx @cobusgreyling/loop doctor . --json
npx @cobusgreyling/loop status .
```
- Otherwise continue.

Pick pattern (default: daily-triage)

Pain	Pattern
Morning chaos / unclear priorities	`daily-triage`
PRs stalling	`pr-babysitter`
CI red / flakes	`ci-sweeper`
CVE / Dependabot noise	`dependency-sweeper`
Post-merge TODOs	`post-merge-cleanup`
Stale release notes	`changelog-drafter`
Noisy issues	`issue-triage`
One GitHub Action, almost no files	`thin-loop`

Pick tool — claude | grok | codex | opencode (default claude).
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.

Cost check before high-cadence schedules:

npx @cobusgreyling/loop cost -p <pattern> -l L1 -c 1d

Week-one rule
- Report only. No auto-fix, no auto-merge.
- Tell the human the first /loop or scheduler command from init output.
- Suggest badge only when score is strong: npx @cobusgreyling/loop badge .

These remain fully supported (do not rewrite existing docs/scripts unless asked):

npx @cobusgreyling/loop-init .
npx @cobusgreyling/loop-audit . --suggest