Workflow Execute

Run the execute phase of the repository workflow.

This phase acts like a senior engineer. It reads the current plan, implements the top ready task, and adds or updates tests before handing off to review.

Use the dedicated executor subagent when the implementation scope is large enough to justify the extra handoff and context cost. For small, tightly coupled changes, this phase may stay in the main thread.

Design and implementation should improve clarity and maintainability pragmatically within the current plan scope.

Steps

1. Select the active plan

   • If the user named a plan, use it.
   • Otherwise inspect the repository's planning artifacts and infer the active plan from context.
   • If no suitable plan exists, stop and run workflow-plan.

2. Read execution context

   • Read the current planning artifacts for the selected plan.
   • Identify the highest-priority ready task and its acceptance criteria.
   • If the task is under-specified, stop and send the work back to workflow-plan.

3. Implement

   • Make the smallest safe code change that satisfies the task.