Debug a project

Use this guide when a preview, test, deployment, or runtime path fails.

Give Agent the failure

Include the error, failing command, URL, or deployment state.

The preview route /settings returns a server error.
Find the cause, fix it, and run the relevant check.

For unclear failures, ask Agent to explain the cause before changing files.

Inspect the logs and related code first.
Tell me the likely cause before editing.

Name the behavior that must stay unchanged.

Fix the failing settings route.
Do not change the account routes.
Keep the existing form components.

Ask Agent to rerun the failing path and any related checks.

After the fix, rerun the failing test or preview path.
Report the command output and any remaining risk.

Goal	Page
Change project behavior	Change a project
Review the branch	Review a branch

Page	Use it to
Project instructions	Give Agent local debug commands and constraints.
Child forks	Understand isolated research, debug, and review runs.