Licence
MIT
Version
0.1.0
Deps
2
Size
35 kB
Vulns
0
Weekly
0
zj-loop-audit
CLI that scores a project's Loop Readiness (0–100) and suggests next steps.
npx @jununfly/zj-loop-audit . --suggest works immediately (published package).
Install & Run
npm (recommended):
npx @jununfly/zj-loop-audit .
npx @jununfly/zj-loop-audit . --suggestFrom this repo:
cd tools/zj-loop-audit
npm install
npm run build
node dist/cli.js /path/to/your/projectBefore/after demo
See scores climb from empty → L1 starter → L2 verifier:
bash scripts/before-after-demo.shOptions
zj-loop-audit . # human-readable (default)
zj-loop-audit . --json # machine-readable
zj-loop-audit . --md # markdown report
zj-loop-audit . --suggest # copy-from-template commands + activity tips (all tools)
zj-loop-audit . --badge # markdown README badge (Loop Ready level + score)Exit code 2 if score < 40 (useful for CI gates once your project is loop-ready).
Publish to npm
Maintainers:
cd tools/zj-loop-audit
npm run build
npm publish --access publicSignals Checked (v1.4+)
| Signal | Notes |
|---|---|
| State file | STATE.md or pattern-specific |
| Triage skill | loop-triage / ci-triage / pr-review-triage etc. |
| Verifier skill | maker/checker split (skills or Claude/Codex agents) |
| LOOP.md / config | Cadence, limits, handoff |
| AGENTS.md / CLAUDE.md | Project conventions |
| Safety docs | safety.md + LOOP.md mentions of gates |
| .github/ + workflows | Dogfooding / automation |
| MCP / connectors | Mentions or config files |
| Worktree evidence | Isolation patterns in docs |
| patterns/registry.yaml | Machine index for tooling |
| loop-budget.md | Token caps and kill switch |
| loop-run-log.md | Append-only run history |
| LOOP.md budget section | Cadence limits documented in config |
| loop-budget skill | Runtime budget guard |
| loopActivity (v1.4) | Dynamic proof: "Last run" timestamps in state, loop-related git commits, scheduled workflows, run logs |
L3 requires verifier + state + cost observability (budget + run log + LOOP.md budget) and proven loop activity (not just files on disk).
Levels
| Level | Meaning |
|---|---|
| L0 | Draft — document intent |
| L1 | Report-only loops |
| L2 | Assisted auto-fix with verifier |
| L3 | Unattended-capable (with human gates) |
See docs/loop-design-checklist.md and docs/designs/architecture.md.