Fix #1148: Update plan-template path reference to be agent-agnostic#1342
Fix #1148: Update plan-template path reference to be agent-agnostic#1342venkatp-infomagnus wants to merge 1 commit into
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.
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.
| **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 pull request has been automatically marked as stale because it has not had any activity for 150 days. It will be closed in 30 days if no further activity occurs. |
|
This pull request has been automatically closed due to inactivity (180 days total). If you believe this PR is still relevant, please reopen it or create a new PR. |
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