loop-init

loop-init

Scaffold loop engineering starters into your project by pattern and tool.

npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok works immediately.

See docs/loop-init-validation.md for a validated pattern × --tool matrix.

Install & Run

npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok
npx @cobusgreyling/loop-init . --pattern daily-triage --tool opencode
npx @cobusgreyling/loop-init . -p pr-babysitter -t claude
npx @cobusgreyling/loop-init . -p dependency-sweeper --dry-run

See docs/RELEASE.md for npm publish tags. The published package bundles starters/ and templates/ from this monorepo.

After scaffolding, always run npx @cobusgreyling/loop-audit . --suggest and actually execute the first report-only loop to generate activity signals.

Patterns

Pattern	Default state file
daily-triage	STATE.md
pr-babysitter	pr-babysitter-state.md
ci-sweeper	ci-sweeper-state.md
dependency-sweeper	dependency-sweeper-state.md
post-merge-cleanup	post-merge-state.md
changelog-drafter	changelog-drafter-state.md
issue-triage	issue-triage-state.md

L2 patterns (ci-sweeper, dependency-sweeper) also copy minimal-fix and loop-verifier templates when missing from the starter.

Fix-capable patterns (pr-babysitter, ci-sweeper, dependency-sweeper, post-merge-cleanup) also get a circuit breaker:

• loop-guard skill — logs each attempt to loop-ledger.json and runs loop-context --check before retrying
• loop-ledger.json — seeded with the pattern's goal, its pattern/level, and an empty attempts array

The ledger's pattern/level let loop-guard size the breaker's --token-budget from loop-cost's realistic per-run estimate instead of a hand-typed number. The breaker escalates (same error N× in a row, too many consecutive failures, token budget, or iteration cap) instead of looping in vain. Report-only patterns skip it.

Patterns that act on human-authored, often underspecified input (issue-triage) also get an intake skill:

• loop-intake skill — when a work item is too vague to verify "done", it asks one question at a time, pushes for exact values, and writes an open question + needs-human escalation instead of guessing. Clarifying up front keeps the loop from burning fix attempts on a goal that was never well defined.

Every scaffold also creates:

• loop-budget.md — pattern-specific daily caps and kill switch
• loop-run-log.md — append-only run history
• loop-budget skill — runtime budget guard at start/end of each run

Tools

• grok (default)
• claude
• codex
• opencode — daily-triage ships minimal-loop-opencode (skills/, AGENTS.md, opencode.json)

Falls back to Grok starter paths when a per-tool variant is not yet available.

From this repo

cd tools/loop-init && npm ci && npm test
node dist/cli.js /path/to/project --pattern daily-triage --tool grok

Pair with loop-audit and loop-cost after scaffolding:

npx @cobusgreyling/loop-cost --pattern daily-triage --level L1
npx @cobusgreyling/loop-audit . --suggest