AAWEA.ORG

Manual start

↓

1

Pick one package

Run npm outdated. Pick the highest-impact outdated package (one only). Note its current and target version.

> npm outdated
2

Upgrade and fix

Upgrade that single package. Fix type errors, API changes, and test failures caused by the bump.

> npm test && npm run build
3

Commit bump

Commit with message like chore(deps): bump <package> to <version>.

↓

✓

Exit condition: manual

No outdated production dependencies remain (or user stops)

📊 Flow Diagram

flowchart TD Start(["Manual start"]) Start --> S0 S0("Pick one package") S1("Upgrade and fix") S0 --> S1 S2("Commit bump") S1 --> S2 Exit{"No outdated production dependencies remain (or user stops)"} 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 "Dependency Upgrade One-by-One" 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 "Dependency Upgrade One-by-One" loop.

Goal: critical outdated deps are upgraded with green tests
Max iterations: 15
Between iterations run: npm outdated && npm test && npm run build
Exit when: npm outdated shows no critical packages left or user stops

Step 1: Pick one outdated package, upgrade it, fix breakages, commit, and stop. One package per iteration.

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