enqack-loop

enqack-loop

A custom Claude Code plugin implementing the Enqack Loop — a self-referential iterative agent loop based on Geoffrey Huntley's "Ralph Wiggum technique."

The Enqack loop is a Bash loop: a while true that repeatedly feeds an AI agent a prompt file, allowing it to iteratively improve until done.

This plugin does it inside your current Claude Code session via a Stop hook — no external shell loop required.

---

How It Works

You run ONCE:
  /enqack-loop "Build a REST API" --completion-promise "DONE" --max-iterations 20

Claude Code automatically:
  1. Works on the task
  2. Tries to exit
  3. Stop hook (hooks/stop-hook.sh) intercepts → {"decision":"block","reason":<prompt>}
  4. Same prompt fed back to Claude
  5. Claude sees its previous file changes + git history
  6. Repeat until <promise>DONE</promise> output OR max iterations reached

State lives in .claude/enqack-loop.local.md (auto-added to .gitignore, never committed). Each iteration is appended to knowledge-vault/Logs/enqack-loop.log (NDJSON).

---

Customizations vs. Official Plugin

Feature	Official	This Plugin
--dry-run flag	❌	✅ Preview state file without activating
Iteration logging	❌	✅ NDJSON → knowledge-vault/Logs/enqack-loop.log
Elapsed time tracking	❌	✅ elapsed_seconds in each log entry
Auto-.gitignore	❌	✅ State file auto-excluded
Project root in system msg	❌	✅ Situational awareness across iterations
started_at in state	❌	✅ Timestamped start for observability

---

Installation

Install via the Claude Code plugin marketplace, or manually via the CLI:

claude plugin install enqack-loop

Hooks register automatically — no manual .claude/settings.json configuration needed. Restart Claude Code after installation for hooks to take effect.

---

Commands

/enqack-loop

Start an Enqack loop in the current session.

/enqack-loop "PROMPT" [--max-iterations N] [--completion-promise "TEXT"] [--dry-run]

Option	Default	Description
--max-iterations N	0 (unlimited)	Stop after N iterations
--completion-promise TEXT	none	Exact phrase Claude must output to stop
--dry-run	false	Preview state file without activating

Examples:

# Run up to 20 iterations, stop when Claude outputs <promise>DONE</promise>
/enqack-loop "Build a REST API for todos. CRUD, validation, tests." \
  --completion-promise "DONE" \
  --max-iterations 20

# Infinite loop, no completion signal (use /cancel-enqack to stop)
/enqack-loop "Continuously improve the code quality"

# Preview only
/enqack-loop "Fix all lint errors" --max-iterations 10 --dry-run

/cancel-enqack

Cancel an active Enqack loop (removes the state file).

/cancel-enqack

---

Agentic Development Lifecycle Commands

This plugin bundles a full agentic development lifecycle as slash commands. Each command is a structured protocol document that Claude follows.

Lifecycle Flow

/enqack-start
  └─ /enqack-establish-intent   (if project_intent.md missing)
  └─ /enqack-prep-context       (if context_manifest.md missing)
  └─ /enqack-plan-cycle
       ├─ /enqack-prep-context
       ├─ /enqack-verify-agenda
       ├─ /enqack-plan-execution  → approval gate →
       ├─ /enqack-execute-plan
       ├─ /enqack-post-verify
       └─ /enqack-post-execution-review

/enqack-finish
  ├─ /enqack-post-verify
  ├─ /enqack-post-execution-review
  ├─ /enqack-commit-message
  └─ /enqack-markdown-checklist

Command Reference

Command	Description
/enqack-start	Entry point — ensures intent + context, hands off to plan-cycle
/enqack-finish	Closing sequence — verify, review, commit message, format
/enqack-plan-cycle	Full lifecycle orchestrator
/enqack-establish-intent	Write knowledge-vault/Intent/project_intent.md
/enqack-prep-context	Load context + produce context_manifest.md
/enqack-verify-agenda	Classify all AGENDA.md items before planning
/enqack-plan-execution	Produce implementation_plan.md + .json
/enqack-execute-plan	Execute approved plan + run verify_all.sh
/enqack-post-verify	Reconcile AGENDA.md → post_verify_report.md
/enqack-post-execution-review	Extract lessons + seal run via close_run.py
/enqack-commit-message	Propose Conventional Commit messages
/enqack-markdown-checklist	Format + lint all Markdown files
/enqack-toggle-maintenance-mode	Toggle agent maintenance mode

---

CVR Python Runtime

The plugin ships a Python runtime in scripts/cvr/ that powers the agentic development commands.

Scripts