π« 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.shindex 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.mddiff --cc .github/workflows/scripts/create-release-packages.shindex 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 occurrencetr ',\n' ' ' | awk '{for(i=1;i<=NF;i++){if(!seen[$i]++){printf((out?" ":"") $i)}}}END{printf("\n")}'diff --cc AGENTS.mdindex 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 GuideFollow 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.mdindex 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.shindex 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/rulKILOCODE_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 fileTEMPLATE_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=truefi+ 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 fileif [[ "$found_agent" == false ]]; then@@@ -674,7 -674,7 +683,8 @@@ print_summary()fiecho- 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.ps1index 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-AllExistingAgentsif (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-Summaryif ($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__.pyindex 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-installerCLAUDE_LOCAL_PATH = Path.home() / ".claude" / "local" / "claude"- # ASCII Art BannerBANNER = """βββββββββββββββ ββββββββ βββββββββββββββββββββ ββββββββββββββββββββββββββββββββββββββββββββββββββ ββββ@@@ -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 assistant3. Download the appropriate template from GitHub4. Extract the template to a new project directory or current directory5. 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 IDEsif 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()