Skip to content

fix(templates): remove self-referencing path in plan-template.md note#3417

Open
marcelsafin wants to merge 1 commit into
github:mainfrom
marcelsafin:fix/1148-plan-template-note
Open

fix(templates): remove self-referencing path in plan-template.md note#3417
marcelsafin wants to merge 1 commit into
github:mainfrom
marcelsafin:fix/1148-plan-template-note

Conversation

@marcelsafin

Copy link
Copy Markdown
Contributor

Fixes #1148

Root cause

The note at the top of templates/plan-template.md says:

See .specify/templates/plan-template.md for the execution workflow.

That path is the file itself — a self-reference. The execution workflow actually lives in the plan command's definition, which the same sentence already names via the __SPECKIT_COMMAND_PLAN__ placeholder (rendered per-agent, e.g. /speckit.plan).

An earlier attempt (#1342) went stale and was auto-closed; this picks the issue back up with the same intent — make the note point at the right thing without hardcoding any agent-specific path.

Change

One line: the note now reads "This template is filled in by the __SPECKIT_COMMAND_PLAN__ command; its definition describes the execution workflow."

Testing

No tests pin this template's prose; the placeholder continues to render through the existing resolve_command_refs pipeline (shared_infra.py).

The note told readers to "See .specify/templates/plan-template.md for
the execution workflow" — that path is the file itself. The execution
workflow lives in the plan command's definition, which the note already
names via the __SPECKIT_COMMAND_PLAN__ placeholder. Point there instead
of at a self-reference.

Fixes github#1148

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 a confusing self-referential note in templates/plan-template.md by removing a pointer to the template’s own path and instead directing readers to the __SPECKIT_COMMAND_PLAN__ command definition for the execution workflow, aligning with the agent-agnostic templating approach used throughout Spec Kit.

Changes:

  • Updated the “Note” in the plan template to remove the hardcoded/self-referencing .specify/templates/plan-template.md path.
  • Reworded the note to reference the __SPECKIT_COMMAND_PLAN__ command definition as the source of execution workflow guidance.

💡 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.

Wrong directory path in the "Note" section of plan-template.md

2 participants