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.

1.3 KB
Raw Blame

Loop Constraints — loop-engineering reference

The loop-constraints skill 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:tools for 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.json and run loop-context --check before retrying (see the loop-guard skill)

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