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.
TypeScript agentic-aiai-agentsai-codinganthropicautomationclaudeclaude-codecodexcoding-agentsdevops-automationdevtoolsgithub-actionsgrokllmloop-engineeringmcpprompt-engineering
Resolve STATE.md conflict and add changelog-drafter to loop-init
Cobus Greyling7a05375702f9
diff --git a/STATE.md b/STATE.mdindex 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.jsindex 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-sweeperdependency-sweeperpost-merge-cleanup+ changelog-drafter (new low-risk release notes pattern)Options:-p, --pattern Pattern to scaffolddiff --git a/tools/loop-init/src/cli.ts b/tools/loop-init/src/cli.tsindex 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-sweeperdependency-sweeperpost-merge-cleanup+ changelog-drafter (new low-risk release notes pattern)Options:-p, --pattern Pattern to scaffold