Fix: Release script missing agent template files in package creation

[guercheLE]

Problem

The release script .github/workflows/scripts/create-release-packages.sh is not properly including agent template files when creating packages for different AI agents.

Current Issues

1. Claude agent: Missing agent_templates/claude/CLAUDE.md file in package
2. Copilot agent: Incorrect directory structure and missing agent_templates/copilot/copilot-instructions.md file

Expected Behavior

The release script should:

• Copy agent_templates/claude/CLAUDE.md to CLAUDE.md in the package root for Claude packages
• Copy agent_templates/copilot/copilot-instructions.md to .github/copilot-instructions.md for Copilot packages
• Ensure all agent context files are properly included in their respective packages

Impact

Without these fixes:

• Claude packages won't include the necessary context file
• Copilot packages will have incorrect structure and missing instructions
• Users won't have proper agent-specific context when using the packages

Proposed Solution

Update the release script to properly handle agent template files:

case $agent in
  claude)
    mkdir -p "$base_dir/.claude/commands"
    generate_commands claude md "\$ARGUMENTS" "$base_dir/.claude/commands" "$script"
    [[ -f agent_templates/claude/CLAUDE.md ]] && cp agent_templates/claude/CLAUDE.md "$base_dir/CLAUDE.md" ;;
  copilot)
    [[ -f agent_templates/copilot/copilot-instructions.md ]] && cp agent_templates/copilot/copilot-instructions.md "$base_dir/.github/copilot-instructions.md" ;;

This ensures that agent-specific context files are properly included in the release packages.

[guercheLE]

Pull Request Created

A pull request has been created to address this issue:

PR #1: Fix: Release script missing agent template files in package creation

The PR includes the exact fix described in this issue, updating the release script to properly include agent template files when creating packages for different AI agents.

[guercheLE]

Implementation Details

Bug Discovery: I discovered this bug while working with the spec-kit toolkit and identified the missing agent template files in package creation.

Implementation: The fix was implemented using VS Code + GitHub Copilot + Claude Sonnet 4 model to ensure proper handling of agent template files in the release script.

[guercheLE]

Correction: Pull Request Reference

Previous comment had incorrect PR reference.

The correct pull request for this issue is:

PR #431: #431 - Fix release script agent templates

This PR fixes the release script to properly include agent template files in package creation as described in this issue.

[localden]

This seems AI-generated with no direct outline of the problem or verification of how this was tested and validated. Please re-open the issue if you've verified that this behavior exists in Specify - mention your OS, how you're running Specify (arguments, slash-commands in IDE/CLI) and what is the output tree.

[guercheLE]

I won't spent my time on this, since my feeling is that there is no interest on it, but I dare to say I might have created this because of some fallback creating CLAUDE.md files for GEMINI and QWEN AI agents.

[francovp]

#Hey @localden, I also had this problem in latest commit e6d6f3c, I'm using MacOS 15.7.1 directly in terminal (not using devcontainers)

I tried to run ./.github/workflows/scripts/create-release-packages.sh v1.0.0 but doesn't package templates

This is the output log

./.github/workflows/scripts/create-release-packages.sh v1.0.0    
Building release packages for v1.0.0
Agents: claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp q
Scripts: sh ps
Building claude (sh) package...
Copied memory -> .specify
Copied scripts/bash -> .specify/scripts
cp: illegal option -- -
usage: cp [-R [-H | -L | -P]] [-fi | -n] [-aclpSsvXx] source_file target_file
       cp [-R [-H | -L | -P]] [-fi | -n] [-aclpSsvXx] source_file ... target_directory
cp: illegal option -- -
usage: cp [-R [-H | -L | -P]] [-fi | -n] [-aclpSsvXx] source_file target_file
       cp [-R [-H | -L | -P]] [-fi | -n] [-aclpSsvXx] source_file ... target_directory
cp: illegal option -- -
usage: cp [-R [-H | -L | -P]] [-fi | -n] [-aclpSsvXx] source_file target_file
       cp [-R [-H | -L | -P]] [-fi | -n] [-aclpSsvXx] source_file ... target_directory
cp: illegal option -- -
usage: cp [-R [-H | -L | -P]] [-fi | -n] [-aclpSsvXx] source_file target_file
       cp [-R [-H | -L | -P]] [-fi | -n] [-aclpSsvXx] source_file ... target_directory
cp: illegal option -- -
usage: cp [-R [-H | -L | -P]] [-fi | -n] [-aclpSsvXx] source_file target_file
       cp [-R [-H | -L | -P]] [-fi | -n] [-aclpSsvXx] source_file ... target_directory
Copied templates -> .specify/templates
Warning: no script command found for sh in templates/commands/constitution.md
  adding: .claude/ (stored 0%)
  adding: .claude/commands/ (stored 0%)
  adding: .claude/commands/speckit.checklist.md (deflated 63%)
  adding: .claude/commands/speckit.plan.md (deflated 60%)
  adding: .claude/commands/speckit.analyze.md (deflated 54%)
  adding: .claude/commands/speckit.constitution.md (deflated 52%)
  adding: .claude/commands/speckit.clarify.md (deflated 57%)
  adding: .claude/commands/speckit.implement.md (deflated 60%)
  adding: .claude/commands/speckit.specify.md (deflated 61%)
  adding: .claude/commands/speckit.tasks.md (deflated 60%)
  adding: .specify/ (stored 0%)
  adding: .specify/memory/ (stored 0%)
  adding: .specify/memory/constitution.md (deflated 53%)
  adding: .specify/scripts/ (stored 0%)
  adding: .specify/scripts/bash/ (stored 0%)
  adding: .specify/scripts/bash/common.sh (deflated 64%)
  adding: .specify/scripts/bash/setup-plan.sh (deflated 54%)
  adding: .specify/scripts/bash/check-prerequisites.sh (deflated 65%)
  adding: .specify/scripts/bash/update-agent-context.sh (deflated 76%)
  adding: .specify/scripts/bash/create-new-feature.sh (deflated 65%)
  adding: .specify/templates/ (stored 0%)
Created .genreleases/spec-kit-template-claude-sh-v1.0.0.zip
(...)

[francovp]

Updated the log since I don't paste the correct one. As you can see there's a lot of this errors

cp: illegal option -- -
usage: cp [-R [-H | -L | -P]] [-fi | -n] [-aclpSsvXx] source_file target_file
       cp [-R [-H | -L | -P]] [-fi | -n] [-aclpSsvXx] source_file ... target_directory

before the Copied templates -> .specify/templates part

[francovp]

Sorry, I think I found that my Issue is specific for MacOS :( since the cp --parents command is a GNU-specific option not available on macOS's BSD cp. So at this point maybe I should use the devcontainer approach.

Thanks anyways