- Notifications
You must be signed in to change notification settings - Fork4.9k
Fix #1148: Update plan-template path reference to be agent-agnostic#1342
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.
Already on GitHub?Sign in to your account
base:main
Are you sure you want to change the base?
Fix #1148: Update plan-template path reference to be agent-agnostic#1342
Conversation
…gent-agnosticThe hardcoded path '.specify/templates/commands/plan.md' caused confusionas it doesn't exist for different AI agents. Updated the note to referencethe correct agent-specific paths (e.g., .claude/commands/, .cursor/commands/,.codex/prompts/, etc.).Fixesgithub#1148
There was a problem hiding this comment.
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 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.). |
CopilotAIDec 16, 2025
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others.Learn more.
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.
| **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.). |
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