Fix #1148: Update plan-template path reference to be agent-agnostic#1342
Open
venkatp-infomagnus wants to merge 1 commit intogithub:mainfrom
Open
Fix #1148: Update plan-template path reference to be agent-agnostic#1342venkatp-infomagnus wants to merge 1 commit intogithub:mainfrom
venkatp-infomagnus wants to merge 1 commit intogithub:mainfrom
Conversation
…gent-agnostic The hardcoded path '.specify/templates/commands/plan.md' caused confusion as it doesn't exist for different AI agents. Updated the note to reference the correct agent-specific paths (e.g., .claude/commands/, .cursor/commands/, .codex/prompts/, etc.). Fixes github#1148
Contributor
There was a problem hiding this comment.
Pull request overview
This PR addresses issue #1148 by replacing a hardcoded path reference in the plan template with agent-agnostic guidance. The template previously referenced .specify/templates/commands/plan.md which doesn't exist, causing confusion for users. The change provides examples of agent-specific paths to help users locate their configuration based on which AI agent they're using.
Key Changes
- Updated documentation in
plan-template.mdto replace hardcoded path with agent-agnostic examples - Provides multiple agent-specific path examples (Claude, Cursor, Codex, etc.)
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| **Input**: Feature specification from `/specs/[###-feature-name]/spec.md` | ||
|
|
||
| **Note**: This template is filled in by the `/speckit.plan` command. See `.specify/templates/commands/plan.md` for the execution workflow. | ||
| **Note**: This template is filled in by the `/speckit.plan` command. The execution workflow is defined in your AI agent's command configuration (e.g., `.claude/commands/speckit.plan.md`, `.cursor/commands/speckit.plan.md`, `.codex/prompts/speckit.plan.md`, etc.). |
There was a problem hiding this comment.
The path example for Codex is incorrect. According to AGENTS.md line 40, Codex uses .codex/commands/ directory, not .codex/prompts/. The correct path should be .codex/commands/speckit.plan.md.
Suggested change
| **Note**: This template is filled in by the `/speckit.plan` command. The execution workflow is defined in your AI agent's command configuration (e.g., `.claude/commands/speckit.plan.md`, `.cursor/commands/speckit.plan.md`, `.codex/prompts/speckit.plan.md`, etc.). | |
| **Note**: This template is filled in by the `/speckit.plan` command. The execution workflow is defined in your AI agent's command configuration (e.g., `.claude/commands/speckit.plan.md`, `.cursor/commands/speckit.plan.md`, `.codex/commands/speckit.plan.md`, etc.). |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
This PR fixes issue #1148 by updating the hardcoded path reference in
plan-template.mdto be agent-agnostic.Problem
The template contained a hardcoded reference to
.specify/templates/commands/plan.mdwhich doesn't exist. The actual location varies depending on which AI agent is being used:.claude/commands/speckit.plan.md.cursor/commands/speckit.plan.md.codex/prompts/speckit.plan.md.qwen/commands/speckit.plan.toml.github/agents/speckit.plan.agent.mdThis caused confusion for users as the referenced path didn't match their setup.
Solution
Updated the note to provide examples of agent-specific paths, making it clear that the location depends on the AI agent being used.
Changes
templates/plan-template.mdline 6Impact
Testing
This is a documentation-only change that doesn't affect any code logic.
Fixes #1148