Work on an existing repo

Start in the checkout

cd my-existing-app
predev

The current directory is the workspace. The CLI associates it with a pre.dev project and resumes that association on later launches. --new creates a fresh association.

Map the architecture

Accept the existing-codebase analysis prompt when offered, or run /reverse. Inspect the result with /arch. Rerun analysis after major structural changes when the stored architecture needs refreshing.

Describe a change

Fix invoice date formatting for non-US locales. Preserve the
existing timezone handling and add a regression test.

Ask for a plan in your message, or use /plan, if you want to develop the approach first. For separate workstreams, use /sprint or /fork with a clear task description.

Inspect the result

git status
git diff

Read the reported tests, review changes in the active checkout or session worktree, and resolve any conflicts before committing or merging. Request the commit, PR, or review behavior you want explicitly in the task.