From d3c5a0d9f088bc8418f3873277f2aebdcfaede20 Mon Sep 17 00:00:00 2001
From: Anushka Kawalkar <anushkakawalkar18@gmail.com>
Date: Fri, 10 Jul 2026 20:28:21 +0530
Subject: [PATCH] Add loop-init validation checklist (#231)

---
 docs/loop-init-validation.md | 38 ++++++++++++++++++++++++++++++++++++
 tools/loop-init/README.md    |  2 ++
 2 files changed, 40 insertions(+)
 create mode 100644 docs/loop-init-validation.md

diff --git a/docs/loop-init-validation.md b/docs/loop-init-validation.md
new file mode 100644
index 00000000..a81bab19
--- /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 edc94713..d363e80c 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