Skip to content

fix(templates): correct phase numbering in plan.md#3416

Open
marcelsafin wants to merge 1 commit into
github:mainfrom
marcelsafin:fix/1036-plan-phase-numbering
Open

fix(templates): correct phase numbering in plan.md#3416
marcelsafin wants to merge 1 commit into
github:mainfrom
marcelsafin:fix/1036-plan-phase-numbering

Conversation

@marcelsafin

Copy link
Copy Markdown
Contributor

Fixes #1036

Root cause

templates/commands/plan.md drifted out of sync with its own Phases section:

  • The outline listed two bullets labeled Phase 1. The second one ("Update agent context by running the agent script") is a leftover from before the agent-context extension existed: core no longer ships an agent script, and the update now runs via the extension's after_plan hook (extensions/agent-context/extension.yml).
  • The completion report said the command ends after "Phase 2 planning", but the Phases section only defines Phase 0 and Phase 1. Phase 2 (tasks.md) belongs to speckit.tasks, exactly as templates/plan-template.md already states ("NOT created by plan").

Change

  • Drop the stale duplicate "Phase 1: Update agent context" bullet.
  • "Command ends after Phase 2 planning" → "Command ends after Phase 1 design".

Two-line diff, no behavior change beyond removing contradictory instructions to the agent.

Testing

No tests pin this template's prose. Full suite untouched by the change.

The plan command's outline listed two bullets labeled Phase 1 and the
completion report said the command ends after "Phase 2 planning",
but the Phases section only defines Phase 0 and Phase 1. Phase 2
(tasks.md) belongs to the tasks command, as plan-template.md states.

The duplicated "Phase 1: Update agent context" bullet is a leftover
from before the agent-context extension: core no longer ships an agent
script, and the update runs via the extension's after_plan hook.

Fixes github#1036

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@marcelsafin marcelsafin requested a review from mnriem as a code owner July 8, 2026 23:00
Copilot AI review requested due to automatic review settings July 8, 2026 23:00

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR fixes contradictory phase numbering and outdated instructions in the speckit.plan command template so the Outline/Completion Report align with the defined phases and current agent-context extension workflow.

Changes:

  • Removes a stale duplicate “Phase 1” bullet about updating agent context via an agent script.
  • Updates the Completion Report to state the command ends after “Phase 1 design” (consistent with the Phases section).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Incorrect phase numbering in plan.md

2 participants