Skip to content
Open
Show file tree
Hide file tree
Changes from 6 commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
15a5630
Use VS Code handoffs
localden Oct 21, 2025
c59be99
Testing hand-offs
localden Oct 21, 2025
8e9d25e
Update with prompt
localden Oct 21, 2025
317ae4d
Update prompts
localden Oct 21, 2025
dbd1437
Let's switch to proper prompts
localden Oct 21, 2025
14a574a
Chatmodes are back in vogue
localden Oct 21, 2025
37e87c7
Hand offs with prompts
localden Oct 21, 2025
115b433
Prompt updates
localden Oct 21, 2025
0ac76c8
Merge branch 'main' into localden/vscode
localden Oct 21, 2025
9786e58
Lint fixes
localden Oct 21, 2025
65f8787
Merge branch 'localden/vscode' of https://github.com/github/spec-kit …
localden Oct 21, 2025
d4d3139
Exclude generated releases
localden Oct 21, 2025
e77d99a
Support for version command
localden Oct 21, 2025
2508d92
Fixes #975
localden Oct 21, 2025
a877af5
Fixes #970
localden Oct 21, 2025
72cb885
Update CHANGELOG.md
localden Oct 21, 2025
d550634
Update src/specify_cli/__init__.py
localden Oct 21, 2025
7522eb3
Potential fix for code scanning alert no. 3: Workflow does not contai…
localden Oct 21, 2025
ba861cd
Merge pull request #1003 from github/main
localden Oct 22, 2025
177dcad
Update CONTRIBUTING.md
localden Oct 22, 2025
779e1f8
Update src/specify_cli/__init__.py
localden Oct 22, 2025
5f1fc6b
Create taskstoissues.md
localden Oct 22, 2025
0927443
Merge branch 'localden/vscode' of https://github.com/github/spec-kit …
localden Oct 22, 2025
dafab39
Update taskstoissues.md
localden Oct 22, 2025
d6136cb
Script changes
localden Oct 22, 2025
f7fe48b
Create create-release-packages.ps1
localden Oct 22, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .github/workflows/scripts/create-release-packages.sh
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,7 @@ generate_commands() {
{ echo "description = \"$description\""; echo; echo "prompt = \"\"\""; echo "$body"; echo "\"\"\""; } > "$output_dir/speckit.$name.$ext" ;;
md)
echo "$body" > "$output_dir/speckit.$name.$ext" ;;
prompt.md)
chatmode.md)
echo "$body" > "$output_dir/speckit.$name.$ext" ;;
esac
done
Expand Down Expand Up @@ -146,8 +146,8 @@ build_variant() {
generate_commands gemini toml "{{args}}" "$base_dir/.gemini/commands" "$script"
[[ -f agent_templates/gemini/GEMINI.md ]] && cp agent_templates/gemini/GEMINI.md "$base_dir/GEMINI.md" ;;
copilot)
mkdir -p "$base_dir/.github/prompts"
generate_commands copilot prompt.md "\$ARGUMENTS" "$base_dir/.github/prompts" "$script"
mkdir -p "$base_dir/.github/chatmodes"
generate_commands copilot chatmode.md "\$ARGUMENTS" "$base_dir/.github/chatmodes" "$script"
# Create VS Code workspace settings
mkdir -p "$base_dir/.vscode"
[[ -f templates/vscode-settings.json ]] && cp templates/vscode-settings.json "$base_dir/.vscode/settings.json"
Expand Down
15 changes: 13 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Specify supports multiple AI agents by generating agent-specific command files a
|-------|-----------|---------|----------|-------------|
| **Claude Code** | `.claude/commands/` | Markdown | `claude` | Anthropic's Claude Code CLI |
| **Gemini CLI** | `.gemini/commands/` | TOML | `gemini` | Google's Gemini CLI |
| **GitHub Copilot** | `.github/prompts/` | Markdown | N/A (IDE-based) | GitHub Copilot in VS Code |
| **GitHub Copilot** | `.github/chatmodes/` | Markdown | N/A (IDE-based) | GitHub Copilot in VS Code |
| **Cursor** | `.cursor/commands/` | Markdown | `cursor-agent` | Cursor CLI |
| **Qwen Code** | `.qwen/commands/` | TOML | `qwen` | Alibaba's Qwen Code CLI |
| **opencode** | `.opencode/command/` | Markdown | `opencode` | opencode CLI |
Expand Down Expand Up @@ -307,6 +307,7 @@ Work within integrated development environments:
### Markdown Format
Used by: Claude, Cursor, opencode, Windsurf, Amazon Q Developer

**Standard format:**
```markdown
---
description: "Command description"
Expand All @@ -315,6 +316,16 @@ description: "Command description"
Command content with {SCRIPT} and $ARGUMENTS placeholders.
```

**GitHub Copilot Chat Mode format:**
```markdown
---
description: "Command description"
mode: speckit.command-name
---

Command content with {SCRIPT} and $ARGUMENTS placeholders.
```

### TOML Format
Used by: Gemini, Qwen

Expand All @@ -330,7 +341,7 @@ Command content with {SCRIPT} and {{args}} placeholders.

- **CLI agents**: Usually `.<agent-name>/commands/`
- **IDE agents**: Follow IDE-specific patterns:
- Copilot: `.github/prompts/`
- Copilot: `.github/chatmodes/`
- Cursor: `.cursor/commands/`
- Windsurf: `.windsurf/workflows/`

Expand Down
2 changes: 1 addition & 1 deletion scripts/bash/update-agent-context.sh
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ AGENT_TYPE="${1:-}"
# Agent-specific file paths
CLAUDE_FILE="$REPO_ROOT/CLAUDE.md"
GEMINI_FILE="$REPO_ROOT/GEMINI.md"
COPILOT_FILE="$REPO_ROOT/.github/copilot-instructions.md"
COPILOT_FILE="$REPO_ROOT/.github/chatmodes/copilot-instructions.md"
CURSOR_FILE="$REPO_ROOT/.cursor/rules/specify-rules.mdc"
QWEN_FILE="$REPO_ROOT/QWEN.md"
AGENTS_FILE="$REPO_ROOT/AGENTS.md"
Expand Down
2 changes: 1 addition & 1 deletion scripts/powershell/update-agent-context.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ $NEW_PLAN = $IMPL_PLAN
# Agent file paths
$CLAUDE_FILE = Join-Path $REPO_ROOT 'CLAUDE.md'
$GEMINI_FILE = Join-Path $REPO_ROOT 'GEMINI.md'
$COPILOT_FILE = Join-Path $REPO_ROOT '.github/copilot-instructions.md'
$COPILOT_FILE = Join-Path $REPO_ROOT '.github/chatmodes/copilot-instructions.md'
$CURSOR_FILE = Join-Path $REPO_ROOT '.cursor/rules/specify-rules.mdc'
$QWEN_FILE = Join-Path $REPO_ROOT 'QWEN.md'
$AGENTS_FILE = Join-Path $REPO_ROOT 'AGENTS.md'
Expand Down
4 changes: 4 additions & 0 deletions templates/commands/constitution.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
---
description: Create or update the project constitution from interactive or provided principle inputs, ensuring all dependent templates stay in sync.
handoffs:
- label: Build Specification
agent: speckit.specify
prompt: Implement the feature specification based on the updated constitution. I want to build...
---

## User Input
Expand Down
7 changes: 7 additions & 0 deletions templates/commands/plan.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
---
description: Execute the implementation planning workflow using the plan template to generate design artifacts.
handoffs:
- label: Create Tasks
agent: speckit.tasks
prompt: Break the plan into tasks
- label: Create Checklist
agent: speckit.checklist
prompt: Create a checklist for the following domain...
scripts:
sh: scripts/bash/setup-plan.sh --json
ps: scripts/powershell/setup-plan.ps1 -Json
Expand Down
7 changes: 7 additions & 0 deletions templates/commands/specify.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
---
description: Create or update the feature specification from a natural language feature description.
handoffs:
- label: Build Technical Plan
agent: speckit.plan
prompt: Create a plan for the spec
- label: Clarify Spec Requirements
agent: speckit.clarify
prompt: Clarify specification requirements
scripts:
sh: scripts/bash/create-new-feature.sh --json "{ARGS}"
ps: scripts/powershell/create-new-feature.ps1 -Json "{ARGS}"
Expand Down
9 changes: 9 additions & 0 deletions templates/commands/tasks.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,14 @@
---
description: Generate an actionable, dependency-ordered tasks.md for the feature based on available design artifacts.
handoffs:
- label: Analyze For Consistency
agent: speckit.analyze
prompt: Run a project analysis for consistency
send: true
- label: Implement Project
agent: speckit.implement
prompt: Start the implementation in phases
send: true
scripts:
sh: scripts/bash/check-prerequisites.sh --json
ps: scripts/powershell/check-prerequisites.ps1 -Json
Expand Down