-
Notifications
You must be signed in to change notification settings - Fork 5.1k
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 our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Fix #1148: Update plan-template path reference to be agent-agnostic #1342
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
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.
Copilot
AI
Dec 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.
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