fix(templates): point constitution sync checklist at installed command files by marcelsafin · Pull Request #3418 · github/spec-kit

marcelsafin · 2026-07-08T23:01:21Z

Fixes #660

Root cause

Step 4 of the constitution command's consistency-propagation checklist tells the agent to:

Read each command file in .specify/templates/commands/*.md (including this one) …

specify init never creates .specify/templates/commands/ — command templates are rendered directly into the agent-specific directory (.github/prompts/, .claude/commands/, .codex/commands/, …). See also the assessment on #3086: keeping commands out of .specify/templates/ is intentional, so the fix is to correct the reference, not to start copying files there.

The result today: this checklist step points at a path that does not exist in any initialized project, so the outdated-reference sweep it describes can never actually run.

Change

One line — the step now reads the installed speckit.* command files for the active agent (with .github/prompts/ and .claude/commands/ as examples), instead of the nonexistent template path.

Testing

No tests pin this template's prose. Verified the new strings are untouched by CommandRegistrar.rewrite_project_relative_paths (only bare scripts/, templates/, memory/ prefixes are rewritten).

…d files The consistency-propagation checklist told the agent to read .specify/templates/commands/*.md, but specify init never creates that directory — command templates are rendered straight into the agent-specific directory (.github/prompts/, .claude/commands/, ...). The checklist step could therefore never run against real files. Point it at the installed speckit.* command files for the active agent instead. Fixes github#660 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot

Pull request overview

This PR fixes an incorrect reference in the Constitution command template so the “consistency propagation checklist” points to command files that actually exist in initialized projects (agent-installed commands/skills), rather than a non-existent .specify/templates/commands/ directory.

Changes:

Update the checklist to reference installed command files for the active agent instead of .specify/templates/commands/*.md.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

marcelsafin · 2026-07-08T23:13:48Z

   - Read `.specify/templates/spec-template.md` for scope/requirements alignment—update if constitution adds/removes mandatory sections or constraints.
   - Read `.specify/templates/tasks-template.md` and ensure task categorization reflects new or removed principle-driven task types (e.g., observability, versioning, testing discipline).
-   - Read each command file in `.specify/templates/commands/*.md` (including this one) to verify no outdated references (agent-specific names like CLAUDE only) remain when generic guidance is required.
+   - Read each installed `speckit.*` command file for your agent (including this one) — e.g. in `.github/prompts/`, `.claude/commands/`, or your agent's equivalent commands directory — to verify no outdated references (agent-specific names like CLAUDE only) remain when generic guidance is required.


Done — reworded to cover both naming schemes (speckit.* and speckit-*) and skills directories instead of hard-coding the dotted pattern.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

marcelsafin · 2026-07-08T23:35:50Z

   - Read `.specify/templates/spec-template.md` for scope/requirements alignment—update if constitution adds/removes mandatory sections or constraints.
   - Read `.specify/templates/tasks-template.md` and ensure task categorization reflects new or removed principle-driven task types (e.g., observability, versioning, testing discipline).
-   - Read each command file in `.specify/templates/commands/*.md` (including this one) to verify no outdated references (agent-specific names like CLAUDE only) remain when generic guidance is required.
+   - Read each installed Spec Kit command file for your agent (including this one) — named `speckit.*` or `speckit-*` depending on the agent, e.g. in `.github/prompts/`, `.claude/commands/`, a skills directory, or your agent's equivalent commands directory — to verify no outdated references (agent-specific names like CLAUDE only) remain when generic guidance is required.


Done — examples now point at the actual install directories (.github/agents/ for Copilot, .claude/skills/ for Claude Code), verified against the integration configs in src/specify_cli/integrations/.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

marcelsafin · 2026-07-08T23:59:30Z

   - Read `.specify/templates/spec-template.md` for scope/requirements alignment—update if constitution adds/removes mandatory sections or constraints.
   - Read `.specify/templates/tasks-template.md` and ensure task categorization reflects new or removed principle-driven task types (e.g., observability, versioning, testing discipline).
-   - Read each command file in `.specify/templates/commands/*.md` (including this one) to verify no outdated references (agent-specific names like CLAUDE only) remain when generic guidance is required.
+   - Read each installed Spec Kit command file for your agent (including this one) — named `speckit.*` or `speckit-*` depending on the agent, e.g. in `.github/agents/`, `.claude/skills/`, or your agent's equivalent commands directory — to verify no outdated references (agent-specific names like CLAUDE only) remain when generic guidance is required.


Fixed in 836844a. The line now names both .github/agents/ and .github/skills/ and the speckit-<name>/SKILL.md layout for skills-based integrations.

Copilot skills mode installs speckit-<name>/SKILL.md under .github/skills/, not .github/agents/. Mention both directories and the SKILL.md layout. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

marcelsafin · 2026-07-09T00:00:29Z

   - Read `.specify/templates/spec-template.md` for scope/requirements alignment—update if constitution adds/removes mandatory sections or constraints.
   - Read `.specify/templates/tasks-template.md` and ensure task categorization reflects new or removed principle-driven task types (e.g., observability, versioning, testing discipline).
-   - Read each command file in `.specify/templates/commands/*.md` (including this one) to verify no outdated references (agent-specific names like CLAUDE only) remain when generic guidance is required.
+   - Read each installed Spec Kit command file for your agent (including this one) — named `speckit.*`, or `speckit-<name>/SKILL.md` for skills-based layouts, e.g. in `.github/agents/`, `.github/skills/`, `.claude/skills/`, or your agent's equivalent commands directory — to verify no outdated references (agent-specific names like CLAUDE only) remain when generic guidance is required.


Fixed. The line now names all three variants: speckit.*, speckit-* (hyphenated flat files like Cline's), and speckit-<name>/SKILL.md for skills layouts.

The previous commit dropped the speckit-* flat-file variant used by Cline and others while adding the SKILL.md layout. Name all three: speckit.*, speckit-*, and speckit-<name>/SKILL.md. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

marcelsafin requested a review from mnriem as a code owner July 8, 2026 23:01

Copilot AI review requested due to automatic review settings July 8, 2026 23:01

Copilot started reviewing on behalf of marcelsafin July 8, 2026 23:01 View session

Copilot AI reviewed Jul 8, 2026

View reviewed changes

fix(templates): cover hyphenated and skills-mode command filenames

d9a884b

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings July 8, 2026 23:13

Copilot started reviewing on behalf of marcelsafin July 8, 2026 23:14 View session

Copilot AI reviewed Jul 8, 2026

View reviewed changes

fix(templates): use actual integration output directories in examples

7a9bfc3

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings July 8, 2026 23:35

Copilot started reviewing on behalf of marcelsafin July 8, 2026 23:36 View session

Copilot AI reviewed Jul 8, 2026

View reviewed changes

docs(templates): cover skills-based command layouts in sync checklist

836844a

Copilot skills mode installs speckit-<name>/SKILL.md under .github/skills/, not .github/agents/. Mention both directories and the SKILL.md layout. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings July 8, 2026 23:57

Copilot started reviewing on behalf of marcelsafin July 8, 2026 23:57 View session

Copilot AI reviewed Jul 8, 2026

View reviewed changes

Copilot AI review requested due to automatic review settings July 9, 2026 00:00

Copilot started reviewing on behalf of marcelsafin July 9, 2026 00:00 View session

Copilot AI reviewed Jul 9, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

fix(templates): point constitution sync checklist at installed command files#3418

fix(templates): point constitution sync checklist at installed command files#3418
marcelsafin wants to merge 5 commits into
github:mainfrom
marcelsafin:fix/660-constitution-commands-path

marcelsafin commented Jul 8, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

marcelsafin Jul 8, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

marcelsafin Jul 8, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

marcelsafin Jul 8, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

marcelsafin Jul 9, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

marcelsafin commented Jul 8, 2026

Root cause

Change

Testing

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

marcelsafin Jul 8, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

marcelsafin Jul 8, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

marcelsafin Jul 8, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

marcelsafin Jul 9, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants