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.

Resolve STATE.md conflict and add changelog-drafter to loop-init

Cobus Greyling7a05375702f9
diff --git a/STATE.md b/STATE.md
index e544cba..8726595 100644
--- a/STATE.md
+++ b/STATE.md
@@ -10,9 +10,9 @@ Last run: 2026-06-09T10:49:32Z (automated daily-triage workflow)
## Watch List
-- Expand contributor failure stories (dependency sweeper, multi-loop).
+- Expand contributor failure stories (dependency sweeper, multi-loop) beyond the six in `stories/`.
- Complete Claude Code / Codex starters for all L2 patterns.
-- Run `loop-init` on a fresh project and verify scaffold output.
+- Validate `loop-init` scaffolds on fresh projects across all patterns (including changelog-drafter).
## Recent Noise (ignored this run)
diff --git a/tools/loop-init/dist/cli.js b/tools/loop-init/dist/cli.js
index a157526..f6db7ef 100644
--- a/tools/loop-init/dist/cli.js
+++ b/tools/loop-init/dist/cli.js
@@ -10,6 +10,7 @@ const PATTERN_STARTERS = {
'ci-sweeper': 'ci-sweeper',
'dependency-sweeper': 'dependency-sweeper',
'post-merge-cleanup': 'post-merge-cleanup',
+ 'changelog-drafter': 'changelog-drafter',
};
const TOOL_SUFFIX = {
grok: '',
@@ -22,6 +23,7 @@ const STATE_FILES = {
'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',
};
function parseArgs(argv) {
let pattern = 'daily-triage';
@@ -103,6 +105,11 @@ function firstLoopCommand(pattern, tool) {
claude: '/loop 1d $post-merge-scan — update post-merge-state.md. Small fixes only.',
codex: 'Automation daily: post-merge-scan → post-merge-state.md.',
},
+ 'changelog-drafter': {
+ grok: '/loop 1d Run changelog-scan on merges since last tag. Produce categorized draft in RELEASE_NOTES_DRAFT.md using draft-release-notes. Update changelog-drafter-state.md. Human review only.',
+ claude: '/loop 1d $changelog-scan + draft-release-notes — write RELEASE_NOTES_DRAFT.md and update state. Human approves before publish.',
+ codex: 'Automation daily: changelog-scan + draft-release-notes → RELEASE_NOTES_DRAFT.md. Human review.',
+ },
};
return cmds[pattern][tool];
}
@@ -120,6 +127,7 @@ Patterns:
ci-sweeper
dependency-sweeper
post-merge-cleanup
+ changelog-drafter (new low-risk release notes pattern)
Options:
-p, --pattern Pattern to scaffold
diff --git a/tools/loop-init/src/cli.ts b/tools/loop-init/src/cli.ts
index c94f562..ff0b2d6 100644
--- a/tools/loop-init/src/cli.ts
+++ b/tools/loop-init/src/cli.ts
@@ -11,7 +11,8 @@ type Pattern =
| 'pr-babysitter'
| 'ci-sweeper'
| 'dependency-sweeper'
- | 'post-merge-cleanup';
+ | 'post-merge-cleanup'
+ | 'changelog-drafter';
type Tool = 'grok' | 'claude' | 'codex';
@@ -21,6 +22,7 @@ const PATTERN_STARTERS: Record<Pattern, string> = {
'ci-sweeper': 'ci-sweeper',
'dependency-sweeper': 'dependency-sweeper',
'post-merge-cleanup': 'post-merge-cleanup',
+ 'changelog-drafter': 'changelog-drafter',
};
const TOOL_SUFFIX: Record<Tool, string> = {
@@ -35,6 +37,7 @@ const STATE_FILES: Record<Pattern, string> = {
'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',
};
function parseArgs(argv: string[]) {
@@ -115,6 +118,11 @@ function firstLoopCommand(pattern: Pattern, tool: Tool): string {
claude: '/loop 1d $post-merge-scan — update post-merge-state.md. Small fixes only.',
codex: 'Automation daily: post-merge-scan → post-merge-state.md.',
},
+ 'changelog-drafter': {
+ grok: '/loop 1d Run changelog-scan on merges since last tag. Produce categorized draft in RELEASE_NOTES_DRAFT.md using draft-release-notes. Update changelog-drafter-state.md. Human review only.',
+ claude: '/loop 1d $changelog-scan + draft-release-notes — write RELEASE_NOTES_DRAFT.md and update state. Human approves before publish.',
+ codex: 'Automation daily: changelog-scan + draft-release-notes → RELEASE_NOTES_DRAFT.md. Human review.',
+ },
};
return cmds[pattern][tool];
}
@@ -134,6 +142,7 @@ Patterns:
ci-sweeper
dependency-sweeper
post-merge-cleanup
+ changelog-drafter (new low-risk release notes pattern)
Options:
-p, --pattern Pattern to scaffold