Upgrade one dependency deliberately
Inspect {{DEPENDENCY}} in {{PROJECT_NAME}}, read official release and migration notes for {{TARGET_VERSION}}, and propose the smallest compatible upgrade. Preserve the lockfile workflow.
Define the problem
Inspect {{DEPENDENCY}} in {{PROJECT_NAME}}, read official release and migration notes for {{TARGET_VERSION}}, and propose the smallest compatible upgrade. Preserve the lockfile workflow.
Inspect prerequisites
Read project instructions and relevant configuration. Record the current state, use sample data, and confirm a recovery point.
Make a bounded plan
Identify the smallest change, its affected files, and a testable expected result. Keep publication separate.
Implement in small steps
Use the linked prompt with real project details. Review each stage before extending it. Preserve unrelated work.
Verify and debug
Run relevant checks and affected user flows; document breaking changes and rollback.
Review and hand off
Inspect the diff and document changes, passed/failed/unrun checks, remaining limits, and recovery. Ask the owner to approve any live deployment.
Prompt library
GOAL:
Inspect {{DEPENDENCY}} in {{PROJECT_NAME}}, read official release and migration notes for {{TARGET_VERSION}}, and propose the smallest compatible upgrade. Preserve the lockfile workflow.
CONTEXT / INPUT:
Project: {{PROJECT_NAME}}. Read relevant files and project instructions first. Ask only about material missing information.
SCOPE:
{{SCOPE}}
DO NOT:
Do not overwrite unrelated work, expose secrets, delete data, publish, or deploy. Respect {{CONSTRAINT}}.
EXPECTED OUTPUT:
A reviewable result with changed files or findings, and a concise explanation.
ACCEPTANCE CRITERIA:
{{SUCCESS_CRITERIA}}
VERIFY:
Run relevant checks and affected user flows; document breaking changes and rollback.
REPORT:
Report changes, reasons, passed/failed/unrun checks, remaining limitations, and recovery steps. Never claim a check passed without evidence.Common mistakes
Missing inputs, incorrect working folders, and unverified commands are common failure points. Stop at the failing step and gather evidence before trying again.