Act on improvement ideas.

The codebase needs attention and you don't know where to start. Run one scan with improvement suggestions, keep the ideas worth building, and leave with a plan draft that already names them.

Describe
Run isolated
Review in GitHub

Feature overview

You start with
A repository that needs attention
You use
Improve · Repository todos · Planning
Takes
One analysis run, then your triage

Aim the scan

Open the repository workspace and choose Improve. Tick the themes that matter and add one line of instructions for what the generic categories miss.

On the courier app: Performance and UX & UI, with the instruction to focus on couriers working with poor signal.

Improve Courier app: Performance and UX & UI Improvements selected, with custom instructions to focus on couriers working with poor signal

Pick the model and the depth

Choose the agent and model, then Focused, Expanded or Full Scan, and press Generate.

The Improve panel's model picker and scan depth: Focused, Expanded or Full Scan

Keep the specific ones

The suggestions arrive grouped under your themes. Tick the ones a teammate could implement from the description alone.

Two of the courier suggestions got the tick.

Improvement suggestions for the courier app, two selected to turn into a plan or save as to-dos

Plan now or park for later

Create Plan starts planning with the selected suggestions. Save as to-dos parks them in the repository todo backlog.

Two suggestions selected: create a plan from them or save them as to-dos

Refine the draft and approve

The new plan's request lists the selected suggestions. Edit it, generate the plan and read the tasks. Approving files one GitHub issue per task, and each issue arrives as a pull request.

A new plan on northwind/courier-app, its request pre-filled with the two selected suggestions, numbered
The plan request pre-filled with the two picked suggestions.

A suggestion earns its place by becoming a task.

A selected suggestion goes straight into a plan, or waits in the backlog until related todos are ready to build together.

What you get

A short list of specific improvements, saved as todos or opened as a plan draft.

Improvement suggestions → All playbooks