AAWEA.ORG

Manual start

↓

1

Run formatter

Run the project formatter (prettier, biome, etc.).

> npm run format
2

Check diff

If formatting changed files, review diff for unintended edits. Fix manual style issues formatter missed.
3

Confirm clean

Re-run formatter and confirm working tree is stable.

> npm run format && git diff --quiet

↓

✓

Exit condition: lint_clean

Formatter produces no remaining diff

> npm run format && git diff --quiet

📊 Flow Diagram

flowchart TD Start(["Manual start"]) Start --> S0 S0("Run formatter") S1("Check diff") S0 --> S1 S2("Confirm clean") S1 --> S2 Exit{"Formatter produces no remaining diff"} S2 --> Exit Exit -- "No" --> S0 Exit -- "Yes" --> Done(["Success"]) style Exit fill:#fffbeb,stroke:#f59e0b,stroke-width:2px,color:#92400e style Done fill:#ecfdf5,stroke:#10b981,stroke-width:2px,color:#065f46

Run "Format Until Clean" in your agent

Prompt only

Deeplinks and "Open in Cursor" only paste the kickoff prompt. They do not install hook files — your agent cannot tell whether files are on disk until you add them yourself.

Two separate pieces

Kickoff prompt — tells the agent the goal, check command, exit condition, and how to self-pace.

Kickoff prompt

Start the "Format Until Clean" loop.

Goal: formatter runs cleanly with no remaining diff
Max iterations: 5
Between iterations run: npm run format
Exit when: format command succeeds and git diff is empty

Step 1: Run the formatter. Fix any issues it cannot auto-fix, then repeat.

Self-pace this loop. After each iteration, run the check command, read the output, and only continue if the exit condition is not met. Stop when the exit condition passes or max iterations is reached. Give a short status update each pass.

Anti-gaming rules

Rules the agent must follow so it cannot cheat the exit condition.

Do not modify the check command or exit criteria to force success
Do not skip, disable, or bypass checks to pass the exit condition
If stuck after several iterations, stop and report blockers instead of gaming metrics