Skip to content

Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.

Add loop-init validation checklist (#231) (#248)

Anushka Kawalkar7ca91b850cd2
diff --git a/docs/loop-init-validation.md b/docs/loop-init-validation.md
new file mode 100644
index 0000000..a81bab1
--- /dev/null
+++ b/docs/loop-init-validation.md
@@ -0,0 +1,38 @@
+# loop-init Validation Checklist
+
+Tracks whether `npx @cobusgreyling/loop-init` produces a working, sane scaffold
+for each pattern × --tool combination. Fill in a row after actually running
+the command in a fresh git repo — don't guess.
+
+## How to validate a row
+
+\`\`\`
+mkdir <temp-folder> && cd <temp-folder>
+git init
+npx @cobusgreyling/loop-init . --pattern <pattern> --tool <tool>
+\`\`\`
+
+Record the printed Loop Ready score, list files created, and note anything
+unexpected. Command used for validation below (Windows/PowerShell):
+
+\`\`\`
+mkdir C:\Temp\loop-init-test
+cd C:\Temp\loop-init-test
+git init
+npx @cobusgreyling/loop-init . --pattern daily-triage --tool claude
+\`\`\`
+
+## Matrix
+
+| Pattern | --tool | Loop Ready score | Files created | Notes |
+|---|---|---|---|---|
+| daily-triage | claude | 100/100 (L3) | `.claude/skills/loop-triage/`, `.claude/agents/loop-verifier.md`, `STATE.md`, `LOOP.md`, `loop-budget.md`, `loop-run-log.md`, `loop-constraints.md`, `.claude/skills/loop-budget/SKILL.md`, `.claude/skills/loop-constraints/SKILL.md`, `AGENTS.md` (template) | Clean scaffold, no errors. Immediately scored 100/100 with no manual edits. |
+| daily-triage | grok | | | |
+| daily-triage | codex | | | |
+| daily-triage | opencode | | | |
+| ci-sweeper | claude | | | |
+| ci-sweeper | grok | | | |
+| ci-sweeper | codex | | | |
+| ci-sweeper | opencode | | | |
+
+Empty rows are open for other contributors — see #231.
\ No newline at end of file
diff --git a/tools/loop-init/README.md b/tools/loop-init/README.md
index f88bcf9..f458aac 100644
--- a/tools/loop-init/README.md
+++ b/tools/loop-init/README.md
@@ -4,6 +4,8 @@ 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](../../docs/loop-init-validation.md) for a validated pattern × --tool matrix.
+
## Install & Run
```bash