Skip to content

πŸ’« Toolkit to help you get started with SDD or any other process!

Merge branch 'main' into codebuddy

Den Delimarsky6c947cc8d897
diff --cc .github/workflows/scripts/create-github-release.sh
index 63343d03d,26b08880a..3c12dff70
--- a/.github/workflows/scripts/create-github-release.sh
+++ b/.github/workflows/scripts/create-github-release.sh
@@@ -38,7 -38,7 +38,9 @@@ gh release create "$VERSION"
.genreleases/spec-kit-template-auggie-ps-"$VERSION".zip \
.genreleases/spec-kit-template-roo-sh-"$VERSION".zip \
.genreleases/spec-kit-template-roo-ps-"$VERSION".zip \
+ .genreleases/spec-kit-template-codebuddy-sh-"$VERSION".zip \
+ .genreleases/spec-kit-template-codebuddy-ps-"$VERSION".zip \
+ .genreleases/spec-kit-template-q-sh-"$VERSION".zip \
+ .genreleases/spec-kit-template-q-ps-"$VERSION".zip \
--title "Spec Kit Templates - $VERSION_NO_V" \
--notes-file release_notes.md
diff --cc .github/workflows/scripts/create-release-packages.sh
index 0d5516029,19e49d394..3bbfa5737
--- a/.github/workflows/scripts/create-release-packages.sh
+++ b/.github/workflows/scripts/create-release-packages.sh
@@@ -172,19 -176,19 +176,22 @@@ build_variant()
roo)
mkdir -p "$base_dir/.roo/commands"
generate_commands roo md "\$ARGUMENTS" "$base_dir/.roo/commands" "$script" ;;
+ codebuddy)
+ mkdir -p "$base_dir/.codebuddy/commands"
+ generate_commands codebuddy md "\$ARGUMENTS" "$base_dir/.codebuddy/commands" "$script" ;;
++
+ q)
+ mkdir -p "$base_dir/.amazonq/prompts"
+ generate_commands q md "\$ARGUMENTS" "$base_dir/.amazonq/prompts" "$script" ;;
esac
( cd "$base_dir" && zip -r "../spec-kit-template-${agent}-${script}-${NEW_VERSION}.zip" . )
echo "Created $GENRELEASES_DIR/spec-kit-template-${agent}-${script}-${NEW_VERSION}.zip"
}
# Determine agent list
- ALL_AGENTS=(claude gemini copilot cursor qwen opencode windsurf codex kilocode auggie roo codebuddy)
-ALL_AGENTS=(claude gemini copilot cursor qwen opencode windsurf codex kilocode auggie roo q)
++ALL_AGENTS=(claude gemini copilot cursor qwen opencode windsurf codex kilocode auggie roo codebuddy q)
ALL_SCRIPTS=(sh ps)
--
norm_list() {
# convert comma+space separated -> space separated unique while preserving order of first occurrence
tr ',\n' ' ' | awk '{for(i=1;i<=NF;i++){if(!seen[$i]++){printf((out?" ":"") $i)}}}END{printf("\n")}'
diff --cc AGENTS.md
index c0e6ceecd,6cae67031..2f0ced2b3
--- a/AGENTS.md
+++ b/AGENTS.md
@@@ -38,8 -38,9 +38,9 @@@ Specify supports multiple AI agents by
| **Qwen Code** | `.qwen/commands/` | TOML | `qwen` | Alibaba's Qwen Code CLI |
| **opencode** | `.opencode/command/` | Markdown | `opencode` | opencode CLI |
| **Windsurf** | `.windsurf/workflows/` | Markdown | N/A (IDE-based) | Windsurf IDE workflows |
+| **CodeBuddy** | `.codebuddy/commands/` | Markdown | `codebuddy` | CodeBuddy |
+ | **Amazon Q Developer CLI** | `.amazonq/prompts/` | Markdown | `q` | Amazon Q Developer CLI |
-
### Step-by-Step Integration Guide
Follow these steps to add a new agent (using Windsurf as an example):
@@@ -57,7 -58,7 +58,8 @@@ AI_CHOICES =
"qwen": "Qwen Code",
"opencode": "opencode",
"windsurf": "Windsurf",
- "codebuddy": "CodeBuddy" # Add new agent here
- "q": "Amazon Q Developer CLI" # Add new agent here
++ "codebuddy": "CodeBuddy"
++ "q": "Amazon Q Developer CLI"
}
```
@@@ -71,11 -72,11 +73,16 @@@ agent_folder_map =
"qwen": ".qwen/",
"opencode": ".opencode/",
"codex": ".codex/",
+ "windsurf": ".windsurf/",
+ "kilocode": ".kilocode/",
+ "auggie": ".auggie/",
+ "copilot": ".github/",
- "codebuddy": ".codebuddy/" # Add new agent folder here
+ "windsurf": ".windsurf/",
+ "kilocode": ".kilocode/",
+ "auggie": ".auggie/",
+ "copilot": ".github/",
- "q": ".amazonq/" # Add new agent folder here
++ "q": ".amazonq/",
++ "codebuddy": ".codebuddy/"
}
```
diff --cc README.md
index faed3cc38,4f9da1c57..106e023b4
--- a/README.md
+++ b/README.md
@@@ -132,9 -137,9 +137,10 @@@ Want to see Spec Kit in action? Watch o
| [Windsurf](https://windsurf.com/) | βœ… | |
| [Kilo Code](https://github.com/Kilo-Org/kilocode) | βœ… | |
| [Auggie CLI](https://docs.augmentcode.com/cli/overview) | βœ… | |
+| [CodeBuddy](https://www.codebuddy.ai/) | βœ… | |
| [Roo Code](https://roocode.com/) | βœ… | |
- | [Codex CLI](https://github.com/openai/codex) | ⚠️ | Codex [does not support](https://github.com/openai/codex/issues/2890) custom arguments for slash commands. |
+ | [Codex CLI](https://github.com/openai/codex) | βœ… | |
+ | [Amazon Q Developer CLI](https://aws.amazon.com/developer/learning/q-developer-cli/) | ⚠️ | Amazon Q Developer CLI [does not support](https://github.com/aws/amazon-q-developer-cli/issues/3064) custom arguments for slash commands. |
## πŸ”§ Specify CLI Reference
@@@ -152,7 -157,7 +158,7 @@@ The `specify` command supports the foll
| Argument/Option | Type | Description |
|------------------------|----------|------------------------------------------------------------------------------|
| `<project-name>` | Argument | Name for your new project directory (optional if using `--here`, or use `.` for current directory) |
- | `--ai` | Option | AI assistant to use: `claude`, `gemini`, `copilot`, `cursor`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, `roo`, or `codebuddy` |
-| `--ai` | Option | AI assistant to use: `claude`, `gemini`, `copilot`, `cursor`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, `roo`, or `q` |
++| `--ai` | Option | AI assistant to use: `claude`, `gemini`, `copilot`, `cursor`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, `roo`, `codebuddy`, or `q` |
| `--script` | Option | Script variant to use: `sh` (bash/zsh) or `ps` (PowerShell) |
| `--ignore-agent-tools` | Flag | Skip checks for AI agent tools like Claude Code |
| `--no-git` | Flag | Skip git repository initialization |
diff --cc scripts/bash/update-agent-context.sh
index 0b07f85c2,036d6b21f..1ad882930
--- a/scripts/bash/update-agent-context.sh
+++ b/scripts/bash/update-agent-context.sh
@@@ -69,7 -69,7 +69,8 @@@ WINDSURF_FILE="$REPO_ROOT/.windsurf/rul
KILOCODE_FILE="$REPO_ROOT/.kilocode/rules/specify-rules.md"
AUGGIE_FILE="$REPO_ROOT/.augment/rules/specify-rules.md"
ROO_FILE="$REPO_ROOT/.roo/rules/specify-rules.md"
+CODEBUDDY_FILE="$REPO_ROOT/.codebuddy/rules/specify-rules.md"
+ Q_FILE="$REPO_ROOT/AGENTS.md"
# Template file
TEMPLATE_FILE="$REPO_ROOT/.specify/templates/agent-file-template.md"
@@@ -581,12 -581,12 +582,15 @@@ update_specific_agent()
roo)
update_agent_file "$ROO_FILE" "Roo Code"
;;
+ codebuddy)
+ update_agent_file "$CODEBUDDY_FILE" "CodeBuddy"
+ ;;
+ q)
+ update_agent_file "$Q_FILE" "Amazon Q Developer CLI"
+ ;;
*)
log_error "Unknown agent type '$agent_type'"
- log_error "Expected: claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy"
+ log_error "Expected: claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf|kilocode|auggie|roo|q"
exit 1
;;
esac
@@@ -646,10 -646,10 +650,15 @@@ update_all_existing_agents()
found_agent=true
fi
+ if [[ -f "$CODEBUDDY_FILE" ]]; then
+ update_agent_file "$CODEBUDDY_FILE" "CodeBuddy"
+ found_agent=true
+ fi
++
+ if [[ -f "$Q_FILE" ]]; then
+ update_agent_file "$Q_FILE" "Amazon Q Developer CLI"
+ found_agent=true
+ fi
# If no agent files exist, create a default Claude file
if [[ "$found_agent" == false ]]; then
@@@ -674,7 -674,7 +683,8 @@@ print_summary()
fi
echo
- log_info "Usage: $0 [claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy]"
- log_info "Usage: $0 [claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf|kilocode|auggie|q]"
++
++ log_info "Usage: $0 [claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf|kilocode|auggie|codebuddy|q]"
}
#==============================================================================
diff --cc scripts/powershell/update-agent-context.ps1
index 7977927a7,1743eee64..806ee0900
--- a/scripts/powershell/update-agent-context.ps1
+++ b/scripts/powershell/update-agent-context.ps1
@@@ -25,7 -25,7 +25,7 @@@ Relies on common helper functions in co
#>
param(
[Parameter(Position=0)]
- [ValidateSet('claude','gemini','copilot','cursor','qwen','opencode','codex','windsurf','kilocode','auggie','roo','codebuddy')]
- [ValidateSet('claude','gemini','copilot','cursor','qwen','opencode','codex','windsurf','kilocode','auggie','roo','q')]
++ [ValidateSet('claude','gemini','copilot','cursor','qwen','opencode','codex','windsurf','kilocode','auggie','roo','codebuddy','q')]
[string]$AgentType
)
@@@ -54,7 -54,7 +54,8 @@@ $WINDSURF_FILE = Join-Path $REPO_ROOT '
$KILOCODE_FILE = Join-Path $REPO_ROOT '.kilocode/rules/specify-rules.md'
$AUGGIE_FILE = Join-Path $REPO_ROOT '.augment/rules/specify-rules.md'
$ROO_FILE = Join-Path $REPO_ROOT '.roo/rules/specify-rules.md'
+$CODEBUDDY_FILE = Join-Path $REPO_ROOT '.codebuddy/rules/specify-rules.md'
+ $Q_FILE = Join-Path $REPO_ROOT 'AGENTS.md'
$TEMPLATE_FILE = Join-Path $REPO_ROOT '.specify/templates/agent-file-template.md'
@@@ -377,8 -377,8 +378,10 @@@ function Update-SpecificAgent
'kilocode' { Update-AgentFile -TargetFile $KILOCODE_FILE -AgentName 'Kilo Code' }
'auggie' { Update-AgentFile -TargetFile $AUGGIE_FILE -AgentName 'Auggie CLI' }
'roo' { Update-AgentFile -TargetFile $ROO_FILE -AgentName 'Roo Code' }
+ 'codebuddy' { Update-AgentFile -TargetFile $CODEBUDDY_FILE -AgentName 'CodeBuddy' }
- default { Write-Err "Unknown agent type '$Type'"; Write-Err 'Expected: claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy'; return $false }
+ 'q' { Update-AgentFile -TargetFile $Q_FILE -AgentName 'Amazon Q Developer CLI' }
- default { Write-Err "Unknown agent type '$Type'"; Write-Err 'Expected: claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf|kilocode|auggie|roo|q'; return $false }
++ default { Write-Err "Unknown agent type '$Type'"; Write-Err 'Expected: claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|q'; return $false }
++
}
}
@@@ -395,7 -395,7 +398,8 @@@ function Update-AllExistingAgents
if (Test-Path $KILOCODE_FILE) { if (-not (Update-AgentFile -TargetFile $KILOCODE_FILE -AgentName 'Kilo Code')) { $ok = $false }; $found = $true }
if (Test-Path $AUGGIE_FILE) { if (-not (Update-AgentFile -TargetFile $AUGGIE_FILE -AgentName 'Auggie CLI')) { $ok = $false }; $found = $true }
if (Test-Path $ROO_FILE) { if (-not (Update-AgentFile -TargetFile $ROO_FILE -AgentName 'Roo Code')) { $ok = $false }; $found = $true }
+ if (Test-Path $CODEBUDDY_FILE) { if (-not (Update-AgentFile -TargetFile $CODEBUDDY_FILE -AgentName 'CodeBuddy')) { $ok = $false }; $found = $true }
+ if (Test-Path $Q_FILE) { if (-not (Update-AgentFile -TargetFile $Q_FILE -AgentName 'Amazon Q Developer CLI')) { $ok = $false }; $found = $true }
if (-not $found) {
Write-Info 'No existing agent files found, creating default Claude file...'
if (-not (Update-AgentFile -TargetFile $CLAUDE_FILE -AgentName 'Claude Code')) { $ok = $false }
@@@ -410,7 -410,7 +414,7 @@@ function Print-Summary
if ($NEW_FRAMEWORK) { Write-Host " - Added framework: $NEW_FRAMEWORK" }
if ($NEW_DB -and $NEW_DB -ne 'N/A') { Write-Host " - Added database: $NEW_DB" }
Write-Host ''
- Write-Info 'Usage: ./update-agent-context.ps1 [-AgentType claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy]'
- Write-Info 'Usage: ./update-agent-context.ps1 [-AgentType claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf|kilocode|auggie|roo|q]'
++ Write-Info 'Usage: ./update-agent-context.ps1 [-AgentType claude|gemini|copilot|cursor|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|q]'
}
function Main {
diff --cc src/specify_cli/__init__.py
index 05e4c419d,a0652539b..49b2f37a9
--- a/src/specify_cli/__init__.py
+++ b/src/specify_cli/__init__.py
@@@ -76,16 -75,14 +75,15 @@@ AI_CHOICES =
"windsurf": "Windsurf",
"kilocode": "Kilo Code",
"auggie": "Auggie CLI",
+ "codebuddy": "CodeBuddy",
"roo": "Roo Code",
+ "q": "Amazon Q Developer CLI",
}
- # Add script type choices
+
SCRIPT_TYPE_CHOICES = {"sh": "POSIX Shell (bash/zsh)", "ps": "PowerShell"}
- # Claude CLI local installation path after migrate-installer
CLAUDE_LOCAL_PATH = Path.home() / ".claude" / "local" / "claude"
- # ASCII Art Banner
BANNER = """
β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•— β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ•—β–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ–ˆβ•—β–ˆβ–ˆβ•— β–ˆβ–ˆβ•—
β–ˆβ–ˆβ•”β•β•β•β•β•β–ˆβ–ˆβ•”β•β•β–ˆβ–ˆβ•—β–ˆβ–ˆβ•”β•β•β•β•β•β–ˆβ–ˆβ•”β•β•β•β•β•β–ˆβ–ˆβ•‘β–ˆβ–ˆβ•”β•β•β•β•β•β•šβ–ˆβ–ˆβ•— β–ˆβ–ˆβ•”β•
@@@ -751,7 -722,7 +723,7 @@@ def ensure_executable_scripts(project_p
@app.command()
def init(
project_name: str = typer.Argument(None, help="Name for your new project directory (optional if using --here, or use '.' for current directory)"),
- ai_assistant: str = typer.Option(None, "--ai", help="AI assistant to use: claude, gemini, copilot, cursor, qwen, opencode, codex, windsurf, kilocode, auggie, roo, or codebuddy"),
- ai_assistant: str = typer.Option(None, "--ai", help="AI assistant to use: claude, gemini, copilot, cursor, qwen, opencode, codex, windsurf, kilocode, auggie or q"),
++ ai_assistant: str = typer.Option(None, "--ai", help="AI assistant to use: claude, gemini, copilot, cursor, qwen, opencode, codex, windsurf, kilocode, auggie, codebuddy, or q"),
script_type: str = typer.Option(None, "--script", help="Script type to use: sh or ps"),
ignore_agent_tools: bool = typer.Option(False, "--ignore-agent-tools", help="Skip checks for AI agent tools like Claude Code"),
no_git: bool = typer.Option(False, "--no-git", help="Skip git repository initialization"),
@@@ -766,7 -737,7 +738,7 @@@
This command will:
1. Check that required tools are installed (git is optional)
- 2. Let you choose your AI assistant (Claude Code, Gemini CLI, GitHub Copilot, Cursor, Qwen Code, opencode, Codex CLI, Windsurf, Kilo Code, Auggie CLI, Roo Code, or CodeBuddy)
- 2. Let you choose your AI assistant (Claude Code, Gemini CLI, GitHub Copilot, Cursor, Qwen Code, opencode, Codex CLI, Windsurf, Kilo Code, Auggie CLI, or Amazon Q Developer CLI)
++ 2. Let you choose your AI assistant
3. Download the appropriate template from GitHub
4. Extract the template to a new project directory or current directory
5. Initialize a fresh git repository (if not --no-git and no existing repo)
@@@ -910,10 -864,10 +866,14 @@@
if not check_tool("auggie", "https://docs.augmentcode.com/cli/setup-auggie/install-auggie-cli"):
install_url = "https://docs.augmentcode.com/cli/setup-auggie/install-auggie-cli"
agent_tool_missing = True
+ elif selected_ai == "codebuddy":
+ if not check_tool("codebuddy", "https://www.codebuddy.ai"):
+ install_url = "https://www.codebuddy.ai"
+ agent_tool_missing = True
+ elif selected_ai == "q":
+ if not check_tool("q", "https://github.com/aws/amazon-q-developer-cli"):
+ install_url = "https://aws.amazon.com/developer/learning/q-developer-cli/"
+ agent_tool_missing = True
# GitHub Copilot and Cursor checks are not needed as they're typically available in supported IDEs
if agent_tool_missing:
@@@ -1037,11 -991,11 +997,12 @@@
"windsurf": ".windsurf/",
"kilocode": ".kilocode/",
"auggie": ".augment/",
+ "codebuddy": ".codebuddy/",
"copilot": ".github/",
- "roo": ".roo/"
+ "roo": ".roo/",
+ "q": ".amazonq/"
}
-
+
if selected_ai in agent_folder_map:
agent_folder = agent_folder_map[selected_ai]
security_notice = Panel(
@@@ -1128,9 -1072,8 +1079,10 @@@ def check()
tracker.add("opencode", "opencode")
tracker.add("codex", "Codex CLI")
tracker.add("auggie", "Auggie CLI")
+ tracker.add("roo", "Roo Code")
+ tracker.add("codebuddy", "CodeBuddy")
-
+ tracker.add("q", "Amazon Q Developer CLI")
+
git_ok = check_tool_for_tracker("git", tracker)
claude_ok = check_tool_for_tracker("claude", tracker)
gemini_ok = check_tool_for_tracker("gemini", tracker)
@@@ -1143,8 -1086,7 +1095,9 @@@
opencode_ok = check_tool_for_tracker("opencode", tracker)
codex_ok = check_tool_for_tracker("codex", tracker)
auggie_ok = check_tool_for_tracker("auggie", tracker)
+ roo_ok = check_tool_for_tracker("roo", tracker)
+ codebuddy_ok = check_tool_for_tracker("codebuddy", tracker)
+ q_ok = check_tool_for_tracker("q", tracker)
console.print(tracker.render())
@@@ -1152,9 -1094,8 +1105,9 @@@
if not git_ok:
console.print("[dim]Tip: Install git for repository management[/dim]")
- if not (claude_ok or gemini_ok or cursor_ok or qwen_ok or windsurf_ok or kilocode_ok or opencode_ok or codex_ok or auggie_ok or roo_ok or codebuddy_ok):
- console.print("[dim]Tip: Install an AI assistant for the best experience[/dim]")
- if not (claude_ok or gemini_ok or cursor_ok or qwen_ok or windsurf_ok or kilocode_ok or opencode_ok or codex_ok or auggie_ok or q_ok):
+
++ if not (claude_ok or gemini_ok or cursor_ok or qwen_ok or windsurf_ok or kilocode_ok or opencode_ok or codex_ok or auggie_ok or codebuddy_ok or q_ok):
+ console.print("[dim]Tip: Install an AI assistant for the best experience[/dim]")
def main():
app()