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
Loop Constraints — loop-engineering reference
The
loop-constraintsskill reads this file at the start of every run. Constraints here are binding — the agent MUST follow them.
Push & Merge
- Don't push before telling me
- Never auto-merge to main without human approval
- Always create a draft PR first; let me review before marking ready
Paths
- Never edit
.env,.env.*,auth/,payments/,secrets/,credentials/ - Never edit
tools/loop-audit/src/,docs/primitives*.md, or showcase assets without human review - Never edit infrastructure configs without human approval
Code
- Always run tests before proposing a fix (
npm run test:toolsfor tool changes) - Never disable tests to make CI green
- Never refactor unrelated code — one fix per run
- Max 3 fix attempts per item; escalate after
- Enforce the attempt limit mechanically: log each try to
loop-ledger.jsonand runloop-context --checkbefore retrying (see theloop-guardskill)
Communication
- Always tell me what you're about to do before doing it
- Never close an issue or PR without my approval
Budget
- If token spend hits 80% of daily cap, switch to report-only
- If loop-pause-all is active, exit immediately