diff --git a/.github/workflows/scripts/create-github-release.sh b/.github/workflows/scripts/create-github-release.sh index 25d354ef2..526748afd 100644 --- a/.github/workflows/scripts/create-github-release.sh +++ b/.github/workflows/scripts/create-github-release.sh @@ -42,6 +42,8 @@ gh release create "$VERSION" \ .genreleases/spec-kit-template-codebuddy-ps-"$VERSION".zip \ .genreleases/spec-kit-template-amp-sh-"$VERSION".zip \ .genreleases/spec-kit-template-amp-ps-"$VERSION".zip \ + .genreleases/spec-kit-template-warp-sh-"$VERSION".zip \ + .genreleases/spec-kit-template-warp-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" \ diff --git a/.github/workflows/scripts/create-release-packages.sh b/.github/workflows/scripts/create-release-packages.sh old mode 100644 new mode 100755 index f9d3b1ae1..edf7bc0bd --- a/.github/workflows/scripts/create-release-packages.sh +++ b/.github/workflows/scripts/create-release-packages.sh @@ -183,6 +183,12 @@ build_variant() { amp) mkdir -p "$base_dir/.agents/commands" generate_commands amp md "\$ARGUMENTS" "$base_dir/.agents/commands" "$script" ;; + warp) + # Warp uses WARP.md for project rules, not custom slash commands + if [[ -f agent_templates/warp/WARP.md ]]; then + cat agent_templates/warp/WARP.md | rewrite_paths > "$base_dir/WARP.md" + fi + ;; q) mkdir -p "$base_dir/.amazonq/prompts" generate_commands q md "\$ARGUMENTS" "$base_dir/.amazonq/prompts" "$script" ;; @@ -192,7 +198,7 @@ build_variant() { } # Determine agent list -ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp q) +ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp warp q) ALL_SCRIPTS=(sh ps) norm_list() { diff --git a/README.md b/README.md index 1c7dda215..9d7615119 100644 --- a/README.md +++ b/README.md @@ -148,8 +148,9 @@ Want to see Spec Kit in action? Watch our [video overview](https://www.youtube.c | [CodeBuddy CLI](https://www.codebuddy.ai/cli) | ✅ | | | [Roo Code](https://roocode.com/) | ✅ | | | [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. | -| [Amp](https://ampcode.com/) | ✅ | | +|| [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. | +|| [Amp](https://ampcode.com/) | ✅ | | +|| [Warp](https://www.warp.dev/) | ✅ | | ## 🔧 Specify CLI Reference @@ -167,7 +168,7 @@ The `specify` command supports the following options: | Argument/Option | Type | Description | |------------------------|----------|------------------------------------------------------------------------------| | `` | 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-agent`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, `roo`, `codebuddy`, `amp`, or `q` | +|| `--ai` | Option | AI assistant to use: `claude`, `gemini`, `copilot`, `cursor-agent`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, `roo`, `codebuddy`, `amp`, `warp`, 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 | @@ -195,6 +196,9 @@ specify init my-project --ai windsurf # Initialize with Amp support specify init my-project --ai amp +# Initialize with Warp support +specify init my-project --ai warp + # Initialize with PowerShell scripts (Windows/cross-platform) specify init my-project --ai copilot --script ps diff --git a/agent_templates/warp/WARP.md b/agent_templates/warp/WARP.md new file mode 100644 index 000000000..ccacc4ad6 --- /dev/null +++ b/agent_templates/warp/WARP.md @@ -0,0 +1,106 @@ +# Warp Project Rules - Spec-Driven Development + +This project uses **Spec-Driven Development (SDD)** methodology with the [GitHub Spec Kit](https://github.com/github/spec-kit). + +## Project Context + +This is a spec-kit project that follows a structured development workflow: +1. Define specifications before implementation +2. Create technical implementation plans +3. Break down into actionable tasks +4. Execute implementation according to the plan + +## Available Spec-Kit Workflows + +When working on this project, you can guide the user through these structured workflows: + +### `/speckit.constitution` - Create Project Principles +Create or update project governing principles and development guidelines that will guide all subsequent development. + +**Usage:** User should describe principles focused on code quality, testing standards, user experience consistency, and performance requirements. + +**Script:** `scripts/bash/setup-plan.sh constitution` + +--- + +### `/speckit.specify` - Define Requirements +Define what needs to be built with focus on the **what** and **why**, not the tech stack. + +**Usage:** User should describe the feature or application they want to build, focusing on user needs and functionality. + +**Script:** `scripts/bash/setup-plan.sh specify` + +--- + +### `/speckit.plan` - Create Technical Plan +Create technical implementation plans with the chosen tech stack and architecture. + +**Usage:** User should specify their technology choices, frameworks, databases, and architectural decisions. + +**Script:** `scripts/bash/setup-plan.sh plan` + +--- + +### `/speckit.tasks` - Generate Task List +Generate actionable task lists for implementation based on the plan. + +**Usage:** Run this after creating a plan to break it down into specific implementation tasks. + +**Script:** `scripts/bash/create-new-feature.sh tasks` + +--- + +### `/speckit.implement` - Execute Implementation +Execute all tasks to build the feature according to the plan. + +**Usage:** Run this to implement all the tasks that were generated. + +**Script:** `scripts/bash/create-new-feature.sh implement` + +--- + +## Optional Quality Commands + +### `/speckit.clarify` - Clarify Underspecified Areas +Clarify underspecified areas in the specification. Recommended before creating a technical plan. + +**Script:** `scripts/bash/setup-plan.sh clarify` + +--- + +### `/speckit.analyze` - Consistency Analysis +Cross-artifact consistency & coverage analysis. Run after creating tasks, before implementation. + +**Script:** `scripts/bash/create-new-feature.sh analyze` + +--- + +### `/speckit.checklist` - Quality Checklists +Generate custom quality checklists that validate requirements completeness, clarity, and consistency. + +**Script:** `scripts/bash/create-new-feature.sh checklist` + +--- + +## How to Use These Workflows + +1. **Start a new feature**: Begin with `/speckit.constitution` to establish project principles +2. **Define the feature**: Use `/speckit.specify` to describe what you want to build +3. **Plan the implementation**: Use `/speckit.plan` to define your technical approach +4. **Break it down**: Use `/speckit.tasks` to create actionable tasks +5. **Build it**: Use `/speckit.implement` to execute the plan + +## Project Structure + +- `.specify/` - Spec-kit configuration and templates + - `memory/` - Project memory and principles + - `scripts/` - Automation scripts for workflows + - `templates/` - Document templates + +## Environment Variables + +- `SPECIFY_FEATURE` - Override feature detection for non-Git repositories + +## Support + +For more information, see the [Spec Kit documentation](https://github.com/github/spec-kit). diff --git a/scripts/bash/update-agent-context.sh b/scripts/bash/update-agent-context.sh index 2a44c68a1..05a54bc06 100644 --- a/scripts/bash/update-agent-context.sh +++ b/scripts/bash/update-agent-context.sh @@ -71,6 +71,7 @@ AUGGIE_FILE="$REPO_ROOT/.augment/rules/specify-rules.md" ROO_FILE="$REPO_ROOT/.roo/rules/specify-rules.md" CODEBUDDY_FILE="$REPO_ROOT/CODEBUDDY.md" AMP_FILE="$REPO_ROOT/AGENTS.md" +WARP_FILE="$REPO_ROOT/.warp/rules/specify-rules.md" Q_FILE="$REPO_ROOT/AGENTS.md" # Template file @@ -618,12 +619,15 @@ update_specific_agent() { amp) update_agent_file "$AMP_FILE" "Amp" ;; + warp) + update_agent_file "$WARP_FILE" "Warp" + ;; q) update_agent_file "$Q_FILE" "Amazon Q Developer CLI" ;; *) log_error "Unknown agent type '$agent_type'" - log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|amp|q" + log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|amp|warp|q" exit 1 ;; esac @@ -688,6 +692,11 @@ update_all_existing_agents() { found_agent=true fi + if [[ -f "$WARP_FILE" ]]; then + update_agent_file "$WARP_FILE" "Warp" + found_agent=true + fi + if [[ -f "$Q_FILE" ]]; then update_agent_file "$Q_FILE" "Amazon Q Developer CLI" found_agent=true @@ -717,7 +726,7 @@ print_summary() { echo - log_info "Usage: $0 [claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|codebuddy|q]" + log_info "Usage: $0 [claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|codebuddy|warp|q]" } #============================================================================== diff --git a/scripts/powershell/update-agent-context.ps1 b/scripts/powershell/update-agent-context.ps1 index 695e28b8d..0ef8bb5e1 100644 --- a/scripts/powershell/update-agent-context.ps1 +++ b/scripts/powershell/update-agent-context.ps1 @@ -25,7 +25,7 @@ Relies on common helper functions in common.ps1 #> param( [Parameter(Position=0)] - [ValidateSet('claude','gemini','copilot','cursor-agent','qwen','opencode','codex','windsurf','kilocode','auggie','roo','codebuddy','amp','q')] + [ValidateSet('claude','gemini','copilot','cursor-agent','qwen','opencode','codex','windsurf','kilocode','auggie','roo','codebuddy','amp','warp','q')] [string]$AgentType ) @@ -56,6 +56,7 @@ $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.md' $AMP_FILE = Join-Path $REPO_ROOT 'AGENTS.md' +$WARP_FILE = Join-Path $REPO_ROOT '.warp/rules/specify-rules.md' $Q_FILE = Join-Path $REPO_ROOT 'AGENTS.md' $TEMPLATE_FILE = Join-Path $REPO_ROOT '.specify/templates/agent-file-template.md' @@ -381,8 +382,9 @@ function Update-SpecificAgent { 'roo' { Update-AgentFile -TargetFile $ROO_FILE -AgentName 'Roo Code' } 'codebuddy' { Update-AgentFile -TargetFile $CODEBUDDY_FILE -AgentName 'CodeBuddy CLI' } 'amp' { Update-AgentFile -TargetFile $AMP_FILE -AgentName 'Amp' } + 'warp' { Update-AgentFile -TargetFile $WARP_FILE -AgentName 'Warp' } '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-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|q'; return $false } + default { Write-Err "Unknown agent type '$Type'"; Write-Err 'Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|warp|q'; return $false } } } @@ -400,6 +402,7 @@ function Update-AllExistingAgents { 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 CLI')) { $ok = $false }; $found = $true } + if (Test-Path $WARP_FILE) { if (-not (Update-AgentFile -TargetFile $WARP_FILE -AgentName 'Warp')) { $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...' @@ -415,7 +418,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-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|q]' + Write-Info 'Usage: ./update-agent-context.ps1 [-AgentType claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|warp|q]' } function Main { diff --git a/src/specify_cli/__init__.py b/src/specify_cli/__init__.py index a33a1c61a..b99cc4af8 100644 --- a/src/specify_cli/__init__.py +++ b/src/specify_cli/__init__.py @@ -150,6 +150,12 @@ def _github_auth_headers(cli_token: str | None = None) -> dict: "install_url": "https://ampcode.com/manual#install", "requires_cli": True, }, + "warp": { + "name": "Warp", + "folder": ".warp/", + "install_url": None, # IDE-based + "requires_cli": False, + }, } SCRIPT_TYPE_CHOICES = {"sh": "POSIX Shell (bash/zsh)", "ps": "PowerShell"} @@ -865,7 +871,7 @@ def ensure_executable_scripts(project_path: Path, tracker: StepTracker | None = @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-agent, qwen, opencode, codex, windsurf, kilocode, auggie, codebuddy, amp, or q"), + ai_assistant: str = typer.Option(None, "--ai", help="AI assistant to use: claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, codebuddy, amp, warp, 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"),