Implement Plan

Execute an implementation plan file.

Task Tracking

At the start, use

TaskCreate

to create a task for each step:

1. Resolve and read the plan file
2. Read relevant files and load task-specific skills
3. Run

   /implement

   skill
4. Update plan status

Step 1: Resolve and Read the Plan File

Determine which plan file to implement using these rules in order:

1. Explicit path — If an absolute or relative path was passed, use it
2. Explicit slug — If a slug was passed (e.g.,

   add-image-cache

   ), resolve to

   .turbo/plans/<slug>.md

   if that file exists; otherwise fall through to rule 5 before erroring
3. Single file — Glob

   .turbo/plans/*.md

   . If exactly one plan exists, use it
4. Most recent — If multiple plans exist, use the most recently modified
5. Unexpanded shell — If a slug or path was passed but resolved to no plan, derive

   <slug>

   from the basename (stripping

   .md

   ) and check

   .turbo/shells/<slug>.md

   . If it exists, halt with: "

   <slug>

   is a shell that needs expansion first. Run

   /pick-next-shell

   to expand and implement it."
6. Legacy fallback — If

   .turbo/plans/

   does not exist but

   .turbo/plan.md

   exists, use it
7. Nothing found — If no plan matched any rule above, tell the user to run

   /turboplan

   (for a new task) or

   /pick-next-shell

   (for existing shells) and stop

If multiple plans exist and the most-recent choice is non-obvious (e.g., several plans were modified within the same minute), use

AskUserQuestion

to let the user pick from the candidates.

State the resolved plan path before continuing, then read the file.

Parse the plan's sections:

• Context — the why
• Pattern Survey — existing patterns and utilities to reuse
• Implementation Steps — the ordered work
• Verification — how to confirm the change works after implementation
• Context Files — files to read in full before editing

Step 2: Read Relevant Files and Load Task-Specific Skills

Read Relevant Files

Read in full:

• Every file listed in the plan's Context Files section
• Files the user referenced in their original request (if any)
• Every file path the plan references in the Context, Pattern Survey, and Implementation Steps sections
• One or two similar files in the project to mirror their style when creating new files or extending existing patterns

Identify and Load Task-Specific Skills

Scan the plan's Implementation Steps for work types that match available skills. For each unambiguous match, run the skill via the Skill tool before editing.

To identify matches:

1. Scan the available skill list
2. For each skill, compare its trigger description against the plan's Implementation Steps
3. Load skills whose triggers clearly match the work. For example, if the plan includes "add a Drizzle migration" and a skill exists whose triggers reference Drizzle migrations, load it. If the plan mentions "run the test suite" but no testing-specific skill trigger matches, do not load a generic testing skill.

If unsure, do not load. Do not load

/code-style

here —

/implement

will load it in Step 3.

Step 3: Run

/implement

Skill

Before invoking

/implement

, use

TaskCreate

to add one sub-task per plan Implementation Step. Mark each sub-task

in_progress

before starting that step and

completed

after.

In the turn that invokes

/implement

, write out the Implementation Steps in order and restate the plan's Verification section (the specific commands, smoke checks, or MCP tool invocations it lists).

/implement

's middle step should work through each Implementation Step using the plan's

file_path:line_number

references and reusing the patterns surveyed in Step 2, then run the Verification section before running

/finalize

. If any Verification check fails, halt and investigate before proceeding to commit. If a step cannot be completed (blocked by a dependency, unclear requirement, or environmental issue), halt and report; do not silently skip steps.

Then run the

/implement

skill.

/implement

loads

/code-style

, executes the Implementation Steps and Verification as written in the context, and runs

/finalize

.

Step 4: Update Plan Status

After

/implement

completes, set the plan's frontmatter

status:

to

done

. This closes the loop for

/pick-next-shell

's dependency resolution, which treats a

.turbo/plans/<dep-slug>.md

with

status: done

as a satisfied dependency. If the plan is the legacy

.turbo/plan.md

without frontmatter, skip this step — it's not tracked by

/pick-next-shell

.

Rules

• The plan file is read-only during execution. If revisions are needed, run

  /refine-plan

  or

  /draft-plan

  separately.
• Never skip Step 2. Pre-implementation prep catches style-mirroring gaps and skill loading that the plan content cannot enforce on its own.
• Never skip Step 3's Verification instruction. Verification gates the commit; committing broken code is worse than halting to investigate.
• Do not edit the plan as part of execution.