fix: correct PresetError docstring from template to preset

fix: address Copilot PR review comments (round 3)
- Fix PS Resolve-Template fallback to skip dot-prefixed dirs (.cache) - Rename _catalog to _catalog_name for consistency with extension system - Enforce install_allowed policy in CLI preset add and download_pack() - Fix shell injection: pass registry path via env var instead of string interpolation
2026-03-17 19:03:08 +00:00 · 2026-03-10 17:20:54 -05:00 · 2026-03-10 17:06:34 -05:00 · 2026-03-10 16:39:07 -05:00 · 2026-03-10 16:35:17 -05:00 · 2026-03-10 15:16:43 -05:00
35 changed files with 713 additions and 4267 deletions
--- a/.devcontainer/post-create.sh
+++ b/.devcontainer/post-create.sh
@@ -8,15 +8,15 @@ run_command() {
    local command_to_run="$*"
    local output
    local exit_code
-
+    
    # Capture all output (stdout and stderr)
    output=$(eval "$command_to_run" 2>&1) || exit_code=$?
    exit_code=${exit_code:-0}
-
+    
    if [ $exit_code -ne 0 ]; then
        echo -e "\033[0;31m[ERROR] Command failed (Exit Code $exit_code): $command_to_run\033[0m" >&2
        echo -e "\033[0;31m$output\033[0m" >&2
-
+        
        exit $exit_code
    fi
 }
@@ -53,7 +53,7 @@ echo "✅ Done"

 echo -e "\n🤖 Installing Kiro CLI..."
 # https://kiro.dev/docs/cli/
-KIRO_INSTALLER_URL="https://kiro.dev/install.sh"
+KIRO_INSTALLER_URL="https://cli.kiro.dev/install"
 KIRO_INSTALLER_SHA256="7487a65cf310b7fb59b357c4b5e6e3f3259d383f4394ecedb39acf70f307cffb"
 KIRO_INSTALLER_PATH="$(mktemp)"

@@ -80,11 +80,6 @@ fi
 run_command "$kiro_binary --help > /dev/null"
 echo "✅ Done"

-echo -e "\n🤖 Installing Kimi CLI..."
-# https://code.kimi.com
-run_command "pipx install kimi-cli"
-echo "✅ Done"
-
 echo -e "\n🤖 Installing CodeBuddy CLI..."
 run_command "npm install -g @tencent-ai/codebuddy-code@latest"
 echo "✅ Done"
--- a/.github/workflows/scripts/create-github-release.sh
+++ b/.github/workflows/scripts/create-github-release.sh
@@ -56,10 +56,6 @@ gh release create "$VERSION" \
  .genreleases/spec-kit-template-bob-ps-"$VERSION".zip \
  .genreleases/spec-kit-template-vibe-sh-"$VERSION".zip \
  .genreleases/spec-kit-template-vibe-ps-"$VERSION".zip \
-  .genreleases/spec-kit-template-kimi-sh-"$VERSION".zip \
-  .genreleases/spec-kit-template-kimi-ps-"$VERSION".zip \
-  .genreleases/spec-kit-template-trae-sh-"$VERSION".zip \
-  .genreleases/spec-kit-template-trae-ps-"$VERSION".zip \
  .genreleases/spec-kit-template-generic-sh-"$VERSION".zip \
  .genreleases/spec-kit-template-generic-ps-"$VERSION".zip \
  --title "Spec Kit Templates - $VERSION_NO_V" \
--- a/.github/workflows/scripts/create-release-packages.ps1
+++ b/.github/workflows/scripts/create-release-packages.ps1
@@ -8,13 +8,13 @@
 .DESCRIPTION
    create-release-packages.ps1 (workflow-local)
    Build Spec Kit template release archives for each supported AI assistant and script type.
-
+    
 .PARAMETER Version
    Version string with leading 'v' (e.g., v0.2.0)

 .PARAMETER Agents
    Comma or space separated subset of agents to build (default: all)
-    Valid agents: claude, gemini, copilot, cursor-agent, qwen, opencode, windsurf, codex, kilocode, auggie, roo, codebuddy, amp, kiro-cli, bob, qodercli, shai, tabnine, agy, vibe, kimi, trae, generic
+    Valid agents: claude, gemini, copilot, cursor-agent, qwen, opencode, windsurf, codex, kilocode, auggie, roo, codebuddy, amp, kiro-cli, bob, qodercli, shai, tabnine, agy, vibe, generic

 .PARAMETER Scripts
    Comma or space separated subset of script types to build (default: both)
@@ -33,10 +33,10 @@
 param(
    [Parameter(Mandatory=$true, Position=0)]
    [string]$Version,
-
+    
    [Parameter(Mandatory=$false)]
    [string]$Agents = "",
-
+    
    [Parameter(Mandatory=$false)]
    [string]$Scripts = ""
 )
@@ -60,7 +60,7 @@ New-Item -ItemType Directory -Path $GenReleasesDir -Force | Out-Null

 function Rewrite-Paths {
    param([string]$Content)
-
+    
    $Content = $Content -replace '(/?)\bmemory/', '.specify/memory/'
    $Content = $Content -replace '(/?)\bscripts/', '.specify/scripts/'
    $Content = $Content -replace '(/?)\btemplates/', '.specify/templates/'
@@ -75,55 +75,55 @@ function Generate-Commands {
        [string]$OutputDir,
        [string]$ScriptVariant
    )
-
+    
    New-Item -ItemType Directory -Path $OutputDir -Force | Out-Null
-
+    
    $templates = Get-ChildItem -Path "templates/commands/*.md" -File -ErrorAction SilentlyContinue
-
+    
    foreach ($template in $templates) {
        $name = [System.IO.Path]::GetFileNameWithoutExtension($template.Name)
-
+        
        # Read file content and normalize line endings
        $fileContent = (Get-Content -Path $template.FullName -Raw) -replace "`r`n", "`n"
-
+        
        # Extract description from YAML frontmatter
        $description = ""
        if ($fileContent -match '(?m)^description:\s*(.+)$') {
            $description = $matches[1]
        }
-
+        
        # Extract script command from YAML frontmatter
        $scriptCommand = ""
        if ($fileContent -match "(?m)^\s*${ScriptVariant}:\s*(.+)$") {
            $scriptCommand = $matches[1]
        }
-
+        
        if ([string]::IsNullOrEmpty($scriptCommand)) {
            Write-Warning "No script command found for $ScriptVariant in $($template.Name)"
            $scriptCommand = "(Missing script command for $ScriptVariant)"
        }
-
+        
        # Extract agent_script command from YAML frontmatter if present
        $agentScriptCommand = ""
        if ($fileContent -match "(?ms)agent_scripts:.*?^\s*${ScriptVariant}:\s*(.+?)$") {
            $agentScriptCommand = $matches[1].Trim()
        }
-
+        
        # Replace {SCRIPT} placeholder with the script command
        $body = $fileContent -replace '\{SCRIPT\}', $scriptCommand
-
+        
        # Replace {AGENT_SCRIPT} placeholder with the agent script command if found
        if (-not [string]::IsNullOrEmpty($agentScriptCommand)) {
            $body = $body -replace '\{AGENT_SCRIPT\}', $agentScriptCommand
        }
-
+        
        # Remove the scripts: and agent_scripts: sections from frontmatter
        $lines = $body -split "`n"
        $outputLines = @()
        $inFrontmatter = $false
        $skipScripts = $false
        $dashCount = 0
-
+        
        foreach ($line in $lines) {
            if ($line -match '^---$') {
                $outputLines += $line
@@ -135,7 +135,7 @@ function Generate-Commands {
                }
                continue
            }
-
+            
            if ($inFrontmatter) {
                if ($line -match '^(scripts|agent_scripts):$') {
                    $skipScripts = $true
@@ -148,20 +148,20 @@ function Generate-Commands {
                    continue
                }
            }
-
+            
            $outputLines += $line
        }
-
+        
        $body = $outputLines -join "`n"
-
+        
        # Apply other substitutions
        $body = $body -replace '\{ARGS\}', $ArgFormat
        $body = $body -replace '__AGENT__', $Agent
        $body = Rewrite-Paths -Content $body
-
+        
        # Generate output file based on extension
        $outputFile = Join-Path $OutputDir "speckit.$name.$Extension"
-
+        
        switch ($Extension) {
            'toml' {
                $body = $body -replace '\\', '\\'
@@ -183,15 +183,15 @@ function Generate-CopilotPrompts {
        [string]$AgentsDir,
        [string]$PromptsDir
    )
-
+    
    New-Item -ItemType Directory -Path $PromptsDir -Force | Out-Null
-
+    
    $agentFiles = Get-ChildItem -Path "$AgentsDir/speckit.*.agent.md" -File -ErrorAction SilentlyContinue
-
+    
    foreach ($agentFile in $agentFiles) {
        $basename = $agentFile.Name -replace '\.agent\.md$', ''
        $promptFile = Join-Path $PromptsDir "$basename.prompt.md"
-
+        
        $content = @"
 ---
 agent: $basename
@@ -201,118 +201,31 @@ agent: $basename
    }
 }

-# Create Kimi Code skills in .kimi/skills/<name>/SKILL.md format.
-# Kimi CLI discovers skills as directories containing a SKILL.md file,
-# invoked with /skill:<name> (e.g. /skill:speckit.specify).
-function New-KimiSkills {
-    param(
-        [string]$SkillsDir,
-        [string]$ScriptVariant
-    )
-
-    $templates = Get-ChildItem -Path "templates/commands/*.md" -File -ErrorAction SilentlyContinue
-
-    foreach ($template in $templates) {
-        $name = [System.IO.Path]::GetFileNameWithoutExtension($template.Name)
-        $skillName = "speckit.$name"
-        $skillDir = Join-Path $SkillsDir $skillName
-        New-Item -ItemType Directory -Force -Path $skillDir | Out-Null
-
-        $fileContent = (Get-Content -Path $template.FullName -Raw) -replace "`r`n", "`n"
-
-        # Extract description
-        $description = "Spec Kit: $name workflow"
-        if ($fileContent -match '(?m)^description:\s*(.+)$') {
-            $description = $matches[1]
-        }
-
-        # Extract script command
-        $scriptCommand = "(Missing script command for $ScriptVariant)"
-        if ($fileContent -match "(?m)^\s*${ScriptVariant}:\s*(.+)$") {
-            $scriptCommand = $matches[1]
-        }
-
-        # Extract agent_script command from frontmatter if present
-        $agentScriptCommand = ""
-        if ($fileContent -match "(?ms)agent_scripts:.*?^\s*${ScriptVariant}:\s*(.+?)$") {
-            $agentScriptCommand = $matches[1].Trim()
-        }
-
-        # Replace {SCRIPT}, strip scripts sections, rewrite paths
-        $body = $fileContent -replace '\{SCRIPT\}', $scriptCommand
-        if (-not [string]::IsNullOrEmpty($agentScriptCommand)) {
-            $body = $body -replace '\{AGENT_SCRIPT\}', $agentScriptCommand
-        }
-
-        $lines = $body -split "`n"
-        $outputLines = @()
-        $inFrontmatter = $false
-        $skipScripts = $false
-        $dashCount = 0
-
-        foreach ($line in $lines) {
-            if ($line -match '^---$') {
-                $outputLines += $line
-                $dashCount++
-                $inFrontmatter = ($dashCount -eq 1)
-                continue
-            }
-            if ($inFrontmatter) {
-                if ($line -match '^(scripts|agent_scripts):$') { $skipScripts = $true; continue }
-                if ($line -match '^[a-zA-Z].*:' -and $skipScripts) { $skipScripts = $false }
-                if ($skipScripts -and $line -match '^\s+') { continue }
-            }
-            $outputLines += $line
-        }
-
-        $body = $outputLines -join "`n"
-        $body = $body -replace '\{ARGS\}', '$ARGUMENTS'
-        $body = $body -replace '__AGENT__', 'kimi'
-        $body = Rewrite-Paths -Content $body
-
-        # Strip existing frontmatter, keep only body
-        $templateBody = ""
-        $fmCount = 0
-        $inBody = $false
-        foreach ($line in ($body -split "`n")) {
-            if ($line -match '^---$') {
-                $fmCount++
-                if ($fmCount -eq 2) { $inBody = $true }
-                continue
-            }
-            if ($inBody) { $templateBody += "$line`n" }
-        }
-
-        $skillContent = "---`nname: `"$skillName`"`ndescription: `"$description`"`n---`n`n$templateBody"
-        Set-Content -Path (Join-Path $skillDir "SKILL.md") -Value $skillContent -NoNewline
-    }
-}
-
 function Build-Variant {
    param(
        [string]$Agent,
        [string]$Script
    )
-
+    
    $baseDir = Join-Path $GenReleasesDir "sdd-${Agent}-package-${Script}"
    Write-Host "Building $Agent ($Script) package..."
    New-Item -ItemType Directory -Path $baseDir -Force | Out-Null
-
+    
    # Copy base structure but filter scripts by variant
    $specDir = Join-Path $baseDir ".specify"
    New-Item -ItemType Directory -Path $specDir -Force | Out-Null
-
+    
    # Copy memory directory
    if (Test-Path "memory") {
        Copy-Item -Path "memory" -Destination $specDir -Recurse -Force
        Write-Host "Copied memory -> .specify"
    }
-
+    
    # Only copy the relevant script variant directory
    if (Test-Path "scripts") {
        $scriptsDestDir = Join-Path $specDir "scripts"
        New-Item -ItemType Directory -Path $scriptsDestDir -Force | Out-Null
-
+        
        switch ($Script) {
            'sh' {
                if (Test-Path "scripts/bash") {
@@ -327,17 +240,18 @@ function Build-Variant {
                }
            }
        }
-
+        
+        # Copy any script files that aren't in variant-specific directories
        Get-ChildItem -Path "scripts" -File -ErrorAction SilentlyContinue | ForEach-Object {
            Copy-Item -Path $_.FullName -Destination $scriptsDestDir -Force
        }
    }
-
+    
    # Copy templates (excluding commands directory and vscode-settings.json)
    if (Test-Path "templates") {
        $templatesDestDir = Join-Path $specDir "templates"
        New-Item -ItemType Directory -Path $templatesDestDir -Force | Out-Null
-
+        
        Get-ChildItem -Path "templates" -Recurse -File | Where-Object {
            $_.FullName -notmatch 'templates[/\\]commands[/\\]' -and $_.Name -ne 'vscode-settings.json'
        } | ForEach-Object {
@@ -349,7 +263,7 @@ function Build-Variant {
        }
        Write-Host "Copied templates -> .specify/templates"
    }
-
+    
    # Generate agent-specific command files
    switch ($Agent) {
        'claude' {
@@ -366,10 +280,12 @@ function Build-Variant {
        'copilot' {
            $agentsDir = Join-Path $baseDir ".github/agents"
            Generate-Commands -Agent 'copilot' -Extension 'agent.md' -ArgFormat '$ARGUMENTS' -OutputDir $agentsDir -ScriptVariant $Script
-
+            
+            # Generate companion prompt files
            $promptsDir = Join-Path $baseDir ".github/prompts"
            Generate-CopilotPrompts -AgentsDir $agentsDir -PromptsDir $promptsDir
-
+            
+            # Create VS Code workspace settings
            $vscodeDir = Join-Path $baseDir ".vscode"
            New-Item -ItemType Directory -Path $vscodeDir -Force | Out-Null
            if (Test-Path "templates/vscode-settings.json") {
@@ -382,7 +298,7 @@ function Build-Variant {
        }
        'qwen' {
            $cmdDir = Join-Path $baseDir ".qwen/commands"
-            Generate-Commands -Agent 'qwen' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
+            Generate-Commands -Agent 'qwen' -Extension 'toml' -ArgFormat '{{args}}' -OutputDir $cmdDir -ScriptVariant $Script
            if (Test-Path "agent_templates/qwen/QWEN.md") {
                Copy-Item -Path "agent_templates/qwen/QWEN.md" -Destination (Join-Path $baseDir "QWEN.md")
            }
@@ -442,32 +358,22 @@ function Build-Variant {
            if (Test-Path $tabnineTemplate) { Copy-Item $tabnineTemplate (Join-Path $baseDir 'TABNINE.md') }
        }
        'agy' {
-            $cmdDir = Join-Path $baseDir ".agent/commands"
+            $cmdDir = Join-Path $baseDir ".agent/workflows"
            Generate-Commands -Agent 'agy' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
        }
-        'vibe' {
-            $cmdDir = Join-Path $baseDir ".vibe/prompts"
-            Generate-Commands -Agent 'vibe' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
-        }
-        'kimi' {
-            $skillsDir = Join-Path $baseDir ".kimi/skills"
-            New-Item -ItemType Directory -Force -Path $skillsDir | Out-Null
-            New-KimiSkills -SkillsDir $skillsDir -ScriptVariant $Script
-        }
-        'trae' {
-            $rulesDir = Join-Path $baseDir ".trae/rules"
-            New-Item -ItemType Directory -Force -Path $rulesDir | Out-Null
-            Generate-Commands -Agent 'trae' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $rulesDir -ScriptVariant $Script
-        }
        'generic' {
            $cmdDir = Join-Path $baseDir ".speckit/commands"
            Generate-Commands -Agent 'generic' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
        }
+        'vibe' {
+            $cmdDir = Join-Path $baseDir ".vibe/prompts"
+            Generate-Commands -Agent 'vibe' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
+        }
        default {
            throw "Unsupported agent '$Agent'."
        }
    }
-
+    
    # Create zip archive
    $zipFile = Join-Path $GenReleasesDir "spec-kit-template-${Agent}-${Script}-${Version}.zip"
    Compress-Archive -Path "$baseDir/*" -DestinationPath $zipFile -Force
@@ -475,16 +381,17 @@ function Build-Variant {
 }

 # Define all agents and scripts
-$AllAgents = @('claude', 'gemini', 'copilot', 'cursor-agent', 'qwen', 'opencode', 'windsurf', 'codex', 'kilocode', 'auggie', 'roo', 'codebuddy', 'amp', 'kiro-cli', 'bob', 'qodercli', 'shai', 'tabnine', 'agy', 'vibe', 'kimi', 'trae', 'generic')
+$AllAgents = @('claude', 'gemini', 'copilot', 'cursor-agent', 'qwen', 'opencode', 'windsurf', 'codex', 'kilocode', 'auggie', 'roo', 'codebuddy', 'amp', 'kiro-cli', 'bob', 'qodercli', 'shai', 'tabnine', 'agy', 'vibe', 'generic')
 $AllScripts = @('sh', 'ps')

 function Normalize-List {
    param([string]$Input)
-
+    
    if ([string]::IsNullOrEmpty($Input)) {
        return @()
    }
-
+    
+    # Split by comma or space and remove duplicates while preserving order
    $items = $Input -split '[,\s]+' | Where-Object { $_ } | Select-Object -Unique
    return $items
 }
@@ -495,7 +402,7 @@ function Validate-Subset {
        [string[]]$Allowed,
        [string[]]$Items
    )
-
+    
    $ok = $true
    foreach ($item in $Items) {
        if ($item -notin $Allowed) {
--- a/.github/workflows/scripts/create-release-packages.sh
+++ b/.github/workflows/scripts/create-release-packages.sh
@@ -6,7 +6,7 @@ set -euo pipefail
 # Usage: .github/workflows/scripts/create-release-packages.sh <version>
 #   Version argument should include leading 'v'.
 #   Optionally set AGENTS and/or SCRIPTS env vars to limit what gets built.
-#     AGENTS  : space or comma separated subset of: claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai tabnine kiro-cli agy bob vibe qodercli kimi trae generic (default: all)
+#     AGENTS  : space or comma separated subset of: claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai tabnine kiro-cli agy bob vibe qodercli generic (default: all)
 #     SCRIPTS : space or comma separated subset of: sh ps (default: both)
 #   Examples:
 #     AGENTS=claude SCRIPTS=sh $0 v0.2.0
@@ -45,19 +45,19 @@ generate_commands() {
    [[ -f "$template" ]] || continue
    local name description script_command agent_script_command body
    name=$(basename "$template" .md)
-
+    
    # Normalize line endings
    file_content=$(tr -d '\r' < "$template")
-
+    
    # Extract description and script command from YAML frontmatter
    description=$(printf '%s\n' "$file_content" | awk '/^description:/ {sub(/^description:[[:space:]]*/, ""); print; exit}')
    script_command=$(printf '%s\n' "$file_content" | awk -v sv="$script_variant" '/^[[:space:]]*'"$script_variant"':[[:space:]]*/ {sub(/^[[:space:]]*'"$script_variant"':[[:space:]]*/, ""); print; exit}')
-
+    
    if [[ -z $script_command ]]; then
      echo "Warning: no script command found for $script_variant in $template" >&2
      script_command="(Missing script command for $script_variant)"
    fi
-
+    
    # Extract agent_script command from YAML frontmatter if present
    agent_script_command=$(printf '%s\n' "$file_content" | awk '
      /^agent_scripts:$/ { in_agent_scripts=1; next }
@@ -68,15 +68,15 @@ generate_commands() {
      }
      in_agent_scripts && /^[a-zA-Z]/ { in_agent_scripts=0 }
    ')
-
+    
    # Replace {SCRIPT} placeholder with the script command
    body=$(printf '%s\n' "$file_content" | sed "s|{SCRIPT}|${script_command}|g")
-
+    
    # Replace {AGENT_SCRIPT} placeholder with the agent script command if found
    if [[ -n $agent_script_command ]]; then
      body=$(printf '%s\n' "$body" | sed "s|{AGENT_SCRIPT}|${agent_script_command}|g")
    fi
-
+    
    # Remove the scripts: and agent_scripts: sections from frontmatter while preserving YAML structure
    body=$(printf '%s\n' "$body" | awk '
      /^---$/ { print; if (++dash_count == 1) in_frontmatter=1; else in_frontmatter=0; next }
@@ -86,10 +86,10 @@ generate_commands() {
      in_frontmatter && skip_scripts && /^[[:space:]]/ { next }
      { print }
    ')
-
+    
    # Apply other substitutions
    body=$(printf '%s\n' "$body" | sed "s/{ARGS}/$arg_format/g" | sed "s/__AGENT__/$agent/g" | rewrite_paths)
-
+    
    case $ext in
      toml)
        body=$(printf '%s\n' "$body" | sed 's/\\/\\\\/g')
@@ -105,14 +105,15 @@ generate_commands() {
 generate_copilot_prompts() {
  local agents_dir=$1 prompts_dir=$2
  mkdir -p "$prompts_dir"
-
+  
  # Generate a .prompt.md file for each .agent.md file
  for agent_file in "$agents_dir"/speckit.*.agent.md; do
    [[ -f "$agent_file" ]] || continue
-
+    
    local basename=$(basename "$agent_file" .agent.md)
    local prompt_file="$prompts_dir/${basename}.prompt.md"
-
+    
+    # Create prompt file with agent frontmatter
    cat > "$prompt_file" <<EOF
 ---
 agent: ${basename}
@@ -121,104 +122,41 @@ EOF
  done
 }

-# Create Kimi Code skills in .kimi/skills/<name>/SKILL.md format.
-# Kimi CLI discovers skills as directories containing a SKILL.md file,
-# invoked with /skill:<name> (e.g. /skill:speckit.specify).
-create_kimi_skills() {
-  local skills_dir="$1"
-  local script_variant="$2"
-
-  for template in templates/commands/*.md; do
-    [[ -f "$template" ]] || continue
-    local name
-    name=$(basename "$template" .md)
-    local skill_name="speckit.${name}"
-    local skill_dir="${skills_dir}/${skill_name}"
-    mkdir -p "$skill_dir"
-
-    local file_content
-    file_content=$(tr -d '\r' < "$template")
-
-    # Extract description from frontmatter
-    local description
-    description=$(printf '%s\n' "$file_content" | awk '/^description:/ {sub(/^description:[[:space:]]*/, ""); print; exit}')
-    [[ -z "$description" ]] && description="Spec Kit: ${name} workflow"
-
-    # Extract script command
-    local script_command
-    script_command=$(printf '%s\n' "$file_content" | awk -v sv="$script_variant" '/^[[:space:]]*'"$script_variant"':[[:space:]]*/ {sub(/^[[:space:]]*'"$script_variant"':[[:space:]]*/, ""); print; exit}')
-    [[ -z "$script_command" ]] && script_command="(Missing script command for $script_variant)"
-
-    # Extract agent_script command from frontmatter if present
-    local agent_script_command
-    agent_script_command=$(printf '%s\n' "$file_content" | awk '
-      /^agent_scripts:$/ { in_agent_scripts=1; next }
-      in_agent_scripts && /^[[:space:]]*'"$script_variant"':[[:space:]]*/ {
-        sub(/^[[:space:]]*'"$script_variant"':[[:space:]]*/, "")
-        print
-        exit
-      }
-      in_agent_scripts && /^[a-zA-Z]/ { in_agent_scripts=0 }
-    ')
-
-    # Build body: replace placeholders, strip scripts sections, rewrite paths
-    local body
-    body=$(printf '%s\n' "$file_content" | sed "s|{SCRIPT}|${script_command}|g")
-    if [[ -n $agent_script_command ]]; then
-      body=$(printf '%s\n' "$body" | sed "s|{AGENT_SCRIPT}|${agent_script_command}|g")
-    fi
-    body=$(printf '%s\n' "$body" | awk '
-      /^---$/ { print; if (++dash_count == 1) in_frontmatter=1; else in_frontmatter=0; next }
-      in_frontmatter && /^scripts:$/ { skip_scripts=1; next }
-      in_frontmatter && /^agent_scripts:$/ { skip_scripts=1; next }
-      in_frontmatter && /^[a-zA-Z].*:/ && skip_scripts { skip_scripts=0 }
-      in_frontmatter && skip_scripts && /^[[:space:]]/ { next }
-      { print }
-    ')
-    body=$(printf '%s\n' "$body" | sed 's/{ARGS}/\$ARGUMENTS/g' | sed 's/__AGENT__/kimi/g' | rewrite_paths)
-
-    # Strip existing frontmatter and prepend Kimi frontmatter
-    local template_body
-    template_body=$(printf '%s\n' "$body" | awk '/^---/{p++; if(p==2){found=1; next}} found')
-
-    {
-      printf -- '---\n'
-      printf 'name: "%s"\n' "$skill_name"
-      printf 'description: "%s"\n' "$description"
-      printf -- '---\n\n'
-      printf '%s\n' "$template_body"
-    } > "$skill_dir/SKILL.md"
-  done
-}
-
 build_variant() {
  local agent=$1 script=$2
  local base_dir="$GENRELEASES_DIR/sdd-${agent}-package-${script}"
  echo "Building $agent ($script) package..."
  mkdir -p "$base_dir"
-
+  
  # Copy base structure but filter scripts by variant
  SPEC_DIR="$base_dir/.specify"
  mkdir -p "$SPEC_DIR"
-
+  
  [[ -d memory ]] && { cp -r memory "$SPEC_DIR/"; echo "Copied memory -> .specify"; }
-
+  
  # Only copy the relevant script variant directory
  if [[ -d scripts ]]; then
    mkdir -p "$SPEC_DIR/scripts"
    case $script in
      sh)
        [[ -d scripts/bash ]] && { cp -r scripts/bash "$SPEC_DIR/scripts/"; echo "Copied scripts/bash -> .specify/scripts"; }
+        # Copy any script files that aren't in variant-specific directories
        find scripts -maxdepth 1 -type f -exec cp {} "$SPEC_DIR/scripts/" \; 2>/dev/null || true
        ;;
      ps)
        [[ -d scripts/powershell ]] && { cp -r scripts/powershell "$SPEC_DIR/scripts/"; echo "Copied scripts/powershell -> .specify/scripts"; }
+        # Copy any script files that aren't in variant-specific directories
        find scripts -maxdepth 1 -type f -exec cp {} "$SPEC_DIR/scripts/" \; 2>/dev/null || true
        ;;
    esac
  fi
-
+  
  [[ -d templates ]] && { mkdir -p "$SPEC_DIR/templates"; find templates -type f -not -path "templates/commands/*" -not -name "vscode-settings.json" -exec cp --parents {} "$SPEC_DIR"/ \; ; echo "Copied templates -> .specify/templates"; }
+  
+  # NOTE: We substitute {ARGS} internally. Outward tokens differ intentionally:
+  #   * Markdown/prompt (claude, copilot, cursor-agent, opencode): $ARGUMENTS
+  #   * TOML (gemini, qwen, tabnine): {{args}}
+  # This keeps formats readable without extra abstraction.

  case $agent in
    claude)
@@ -231,7 +169,9 @@ build_variant() {
    copilot)
      mkdir -p "$base_dir/.github/agents"
      generate_commands copilot agent.md "\$ARGUMENTS" "$base_dir/.github/agents" "$script"
+      # Generate companion prompt files
      generate_copilot_prompts "$base_dir/.github/agents" "$base_dir/.github/prompts"
+      # 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"
      ;;
@@ -240,7 +180,7 @@ build_variant() {
      generate_commands cursor-agent md "\$ARGUMENTS" "$base_dir/.cursor/commands" "$script" ;;
    qwen)
      mkdir -p "$base_dir/.qwen/commands"
-      generate_commands qwen md "\$ARGUMENTS" "$base_dir/.qwen/commands" "$script"
+      generate_commands qwen toml "{{args}}" "$base_dir/.qwen/commands" "$script"
      [[ -f agent_templates/qwen/QWEN.md ]] && cp agent_templates/qwen/QWEN.md "$base_dir/QWEN.md" ;;
    opencode)
      mkdir -p "$base_dir/.opencode/command"
@@ -280,20 +220,14 @@ build_variant() {
      mkdir -p "$base_dir/.kiro/prompts"
      generate_commands kiro-cli md "\$ARGUMENTS" "$base_dir/.kiro/prompts" "$script" ;;
    agy)
-      mkdir -p "$base_dir/.agent/commands"
-      generate_commands agy md "\$ARGUMENTS" "$base_dir/.agent/commands" "$script" ;;
+      mkdir -p "$base_dir/.agent/workflows"
+      generate_commands agy md "\$ARGUMENTS" "$base_dir/.agent/workflows" "$script" ;;
    bob)
      mkdir -p "$base_dir/.bob/commands"
      generate_commands bob md "\$ARGUMENTS" "$base_dir/.bob/commands" "$script" ;;
    vibe)
      mkdir -p "$base_dir/.vibe/prompts"
      generate_commands vibe md "\$ARGUMENTS" "$base_dir/.vibe/prompts" "$script" ;;
-    kimi)
-      mkdir -p "$base_dir/.kimi/skills"
-      create_kimi_skills "$base_dir/.kimi/skills" "$script" ;;
-    trae)
-      mkdir -p "$base_dir/.trae/rules"
-      generate_commands trae md "\$ARGUMENTS" "$base_dir/.trae/rules" "$script" ;;
    generic)
      mkdir -p "$base_dir/.speckit/commands"
      generate_commands generic md "\$ARGUMENTS" "$base_dir/.speckit/commands" "$script" ;;
@@ -303,10 +237,11 @@ build_variant() {
 }

 # Determine agent list
-ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai tabnine kiro-cli agy bob vibe qodercli kimi trae generic)
+ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf codex kilocode auggie roo codebuddy amp shai tabnine kiro-cli agy bob vibe qodercli generic)
 ALL_SCRIPTS=(sh ps)

 norm_list() {
+  # convert comma+space separated -> line separated unique while preserving order of first occurrence
  tr ',\n' '  ' | awk '{for(i=1;i<=NF;i++){if(!seen[$i]++){printf((out?"\n":"") $i);out=1}}}END{printf("\n")}'
 }

--- a/AGENTS.md
+++ b/AGENTS.md
@@ -10,6 +10,10 @@ The toolkit supports multiple AI coding assistants, allowing teams to use their

 ---

+## General practices
+
+- Any changes to `__init__.py` for the Specify CLI require a version rev in `pyproject.toml` and addition of entries to `CHANGELOG.md`.
+
 ## Adding New Agent Support

 This section explains how to add support for new AI agents/assistants to the Specify CLI. Use this guide as a reference when integrating new AI tools into the Spec-Driven Development workflow.
@@ -31,7 +35,7 @@ Specify supports multiple AI agents by generating agent-specific command files a
 | **Gemini CLI**             | `.gemini/commands/`    | TOML     | `gemini`        | Google's Gemini CLI         |
 | **GitHub Copilot**         | `.github/agents/`      | Markdown | N/A (IDE-based) | GitHub Copilot in VS Code   |
 | **Cursor**                 | `.cursor/commands/`    | Markdown | `cursor-agent`  | Cursor CLI                  |
-| **Qwen Code**              | `.qwen/commands/`      | Markdown | `qwen`          | Alibaba's Qwen Code CLI     |
+| **Qwen Code**              | `.qwen/commands/`      | TOML     | `qwen`          | Alibaba's Qwen Code CLI     |
 | **opencode**               | `.opencode/command/`   | Markdown | `opencode`      | opencode CLI                |
 | **Codex CLI**              | `.codex/commands/`     | Markdown | `codex`         | Codex CLI                   |
 | **Windsurf**               | `.windsurf/workflows/` | Markdown | N/A (IDE-based) | Windsurf IDE workflows      |
@@ -44,9 +48,7 @@ Specify supports multiple AI agents by generating agent-specific command files a
 | **Amp**                    | `.agents/commands/`    | Markdown | `amp`           | Amp CLI                     |
 | **SHAI**                   | `.shai/commands/`      | Markdown | `shai`          | SHAI CLI                    |
 | **Tabnine CLI**            | `.tabnine/agent/commands/` | TOML | `tabnine`       | Tabnine CLI                 |
-| **Kimi Code**              | `.kimi/skills/`        | Markdown | `kimi`          | Kimi Code CLI (Moonshot AI) |
 | **IBM Bob**                | `.bob/commands/`       | Markdown | N/A (IDE-based) | IBM Bob IDE                 |
-| **Trae**                   | `.trae/rules/`         | Markdown | N/A (IDE-based) | Trae IDE                    |
 | **Generic**                | User-specified via `--ai-commands-dir` | Markdown | N/A | Bring your own agent        |

 ### Step-by-Step Integration Guide
@@ -85,7 +87,7 @@ This eliminates the need for special-case mappings throughout the codebase.
 - `folder`: Directory where agent-specific files are stored (relative to project root)
 - `commands_subdir`: Subdirectory name within the agent folder where command/prompt files are stored (default: `"commands"`)
  - Most agents use `"commands"` (e.g., `.claude/commands/`)
-  - Some agents use alternative names: `"agents"` (copilot), `"workflows"` (windsurf, kilocode), `"prompts"` (codex, kiro-cli), `"command"` (opencode - singular)
+  - Some agents use alternative names: `"agents"` (copilot), `"workflows"` (windsurf, kilocode, agy), `"prompts"` (codex, kiro-cli), `"command"` (opencode - singular)
  - This field enables `--ai-skills` to locate command templates correctly for skill generation
 - `install_url`: Installation documentation URL (set to `None` for IDE-based agents)
 - `requires_cli`: Whether the agent requires a CLI tool check during initialization
@@ -322,7 +324,6 @@ Require a command-line tool to be installed:
 - **Amp**: `amp` CLI
 - **SHAI**: `shai` CLI
 - **Tabnine CLI**: `tabnine` CLI
- **Kimi Code**: `kimi` CLI

 ### IDE-Based Agents

@@ -336,7 +337,7 @@ Work within integrated development environments:

 ### Markdown Format

-Used by: Claude, Cursor, opencode, Windsurf, Kiro CLI, Amp, SHAI, IBM Bob, Kimi Code, Qwen
+Used by: Claude, Cursor, opencode, Windsurf, Kiro CLI, Amp, SHAI, IBM Bob

 **Standard format:**

@@ -361,7 +362,7 @@ Command content with {SCRIPT} and $ARGUMENTS placeholders.

 ### TOML Format

-Used by: Gemini, Tabnine
+Used by: Gemini, Qwen, Tabnine

 ```toml
 description = "Command description"
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,106 +7,10 @@ Recent changes to the Specify CLI and templates are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

-## [0.3.1] - 2026-03-17
-
-### Changed
-
- docs: add greenfield Spring Boot pirate-speak preset demo to README (#1878)
- fix(ai-skills): exclude non-speckit copilot agent markdown from skill… (#1867)
- feat: add Trae IDE support as a new agent (#1817)
- feat(cli): polite deep merge for settings.json and support JSONC (#1874)
- feat(extensions,presets): add priority-based resolution ordering (#1855)
- fix(scripts): suppress stdout from git fetch in create-new-feature.sh (#1876)
- fix(scripts): harden bash scripts — escape, compat, and error handling (#1869)
- Add cognitive-squad to community extension catalog (#1870)
- docs: add Go / React brownfield walkthrough to community walkthroughs (#1868)
- chore: update DocGuard extension to v0.9.8 (#1859)
- Feature: add specify status command (#1837)
- fix(extensions): show extension ID in list output (#1843)
- feat(extensions): add Archive and Reconcile extensions to community catalog (#1844)
- feat: Add DocGuard CDD enforcement extension to community catalog (#1838)
- chore: bump version to 0.3.0 (#1839)
- feat(presets): Pluggable preset system with catalog, resolver, and skills propagation (#1787)
- fix: match 'Last updated' timestamp with or without bold markers (#1836)
- Add specify doctor command for project health diagnostics (#1828)
- fix: harden bash scripts against shell injection and improve robustness (#1809)
- fix: clean up command templates (specify, analyze) (#1810)
- fix: migrate Qwen Code CLI from TOML to Markdown format (#1589) (#1730)
- fix(cli): deprecate explicit command support for agy (#1798) (#1808)
- Add /selftest.extension core extension to test other extensions (#1758)
- feat(extensions): Quality of life improvements for RFC-aligned catalog integration (#1776)
- Add Java brownfield walkthrough to community walkthroughs (#1820)
- chore: bump version to 0.2.1 (#1813)
- Added February 2026 newsletter (#1812)
- feat: add Kimi Code CLI agent support (#1790)
- docs: fix broken links in quickstart guide (#1759) (#1797)
- docs: add catalog cli help documentation (#1793) (#1794)
- fix: use quiet checkout to avoid exception on git checkout (#1792)
- feat(extensions): support .extensionignore to exclude files during install (#1781)
- feat: add Codex support for extension command registration (#1767)
- chore: bump version to 0.2.0 (#1786)
- fix: sync agent list comments with actual supported agents (#1785)
- feat(extensions): support multiple active catalogs simultaneously (#1720)
- Pavel/add tabnine cli support (#1503)
- Add Understanding extension to community catalog (#1778)
- Add ralph extension to community catalog (#1780)
- Update README with project initialization instructions (#1772)
- feat: add review extension to community catalog (#1775)
- Add fleet extension to community catalog (#1771)
- Integration of Mistral vibe support into speckit (#1725)
- fix: Remove duplicate options in specify.md (#1765)
- fix: use global branch numbering instead of per-short-name detection (#1757)
- Add Community Walkthroughs section to README (#1766)
- feat(extensions): add Jira Integration to community catalog (#1764)
- Add Azure DevOps Integration extension to community catalog (#1734)
- Fix docs: update Antigravity link and add initialization example (#1748)
- fix: wire after_tasks and after_implement hook events into command templates (#1702)
- make c ignores consistent with c++ (#1747)
- chore: bump version to 0.1.13 (#1746)
- feat: add kiro-cli and AGENT_CONFIG consistency coverage (#1690)
- feat: add verify extension to community catalog (#1726)
- Add Retrospective Extension to community catalog README table (#1741)
- fix(scripts): add empty description validation and branch checkout error handling (#1559)
- fix: correct Copilot extension command registration (#1724)
- fix(implement): remove Makefile from C ignore patterns (#1558)
- Add sync extension to community catalog (#1728)
- fix(checklist): clarify file handling behavior for append vs create (#1556)
- fix(clarify): correct conflicting question limit from 10 to 5 (#1557)
- chore: bump version to 0.1.12 (#1737)
- fix: use RELEASE_PAT so tag push triggers release workflow (#1736)
- fix: release-trigger uses release branch + PR instead of direct push to main (#1733)
- fix: Split release process to sync pyproject.toml version with git tags (#1732)
-
-
-## [0.3.0] - 2026-03-13
-
-### Changed
-
- No changes have been documented for this release yet.
-
-<!-- Entries for 0.2.x and earlier releases are documented in their respective sections below. -->
- make c ignores consistent with c++ (#1747)
- chore: bump version to 0.1.13 (#1746)
- feat: add kiro-cli and AGENT_CONFIG consistency coverage (#1690)
- feat: add verify extension to community catalog (#1726)
- Add Retrospective Extension to community catalog README table (#1741)
- fix(scripts): add empty description validation and branch checkout error handling (#1559)
- fix: correct Copilot extension command registration (#1724)
- fix(implement): remove Makefile from C ignore patterns (#1558)
- Add sync extension to community catalog (#1728)
- fix(checklist): clarify file handling behavior for append vs create (#1556)
- fix(clarify): correct conflicting question limit from 10 to 5 (#1557)
- chore: bump version to 0.1.12 (#1737)
- fix: use RELEASE_PAT so tag push triggers release workflow (#1736)
- fix: release-trigger uses release branch + PR instead of direct push to main (#1733)
- fix: Split release process to sync pyproject.toml version with git tags (#1732)
-
-
-## [Unreleased]
+## [0.2.1] - 2026-03-10

 ### Added

- feat(cli): polite deep merge for VSCode settings.json with JSONC support via `json5` and zero-data-loss fallbacks
 - feat(presets): Pluggable preset system with preset catalog and template resolver
 - Preset manifest (`preset.yml`) with validation for artifact, command, and script types
 - `PresetManifest`, `PresetRegistry`, `PresetManager`, `PresetCatalog`, `PresetResolver` classes in `src/specify_cli/presets.py`
@@ -124,55 +28,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - feat: `specify init` persists CLI options to `.specify/init-options.json` for downstream operations
 - feat(extensions): support `.extensionignore` to exclude files/folders during `specify extension add` (#1781)

-## [0.2.1] - 2026-03-11
-
-### Changed
-
- Added February 2026 newsletter (#1812)
- feat: add Kimi Code CLI agent support (#1790)
- docs: fix broken links in quickstart guide (#1759) (#1797)
- docs: add catalog cli help documentation (#1793) (#1794)
- fix: use quiet checkout to avoid exception on git checkout (#1792)
- feat(extensions): support .extensionignore to exclude files during install (#1781)
- feat: add Codex support for extension command registration (#1767)
- chore: bump version to 0.2.0 (#1786)
- fix: sync agent list comments with actual supported agents (#1785)
- feat(extensions): support multiple active catalogs simultaneously (#1720)
- Pavel/add tabnine cli support (#1503)
- Add Understanding extension to community catalog (#1778)
- Add ralph extension to community catalog (#1780)
- Update README with project initialization instructions (#1772)
- feat: add review extension to community catalog (#1775)
- Add fleet extension to community catalog (#1771)
- Integration of Mistral vibe support into speckit (#1725)
- fix: Remove duplicate options in specify.md (#1765)
- fix: use global branch numbering instead of per-short-name detection (#1757)
- Add Community Walkthroughs section to README (#1766)
- feat(extensions): add Jira Integration to community catalog (#1764)
- Add Azure DevOps Integration extension to community catalog (#1734)
- Fix docs: update Antigravity link and add initialization example (#1748)
- fix: wire after_tasks and after_implement hook events into command templates (#1702)
- make c ignores consistent with c++ (#1747)
- chore: bump version to 0.1.13 (#1746)
- feat: add kiro-cli and AGENT_CONFIG consistency coverage (#1690)
- feat: add verify extension to community catalog (#1726)
- Add Retrospective Extension to community catalog README table (#1741)
- fix(scripts): add empty description validation and branch checkout error handling (#1559)
- fix: correct Copilot extension command registration (#1724)
- fix(implement): remove Makefile from C ignore patterns (#1558)
- Add sync extension to community catalog (#1728)
- fix(checklist): clarify file handling behavior for append vs create (#1556)
- fix(clarify): correct conflicting question limit from 10 to 5 (#1557)
- chore: bump version to 0.1.12 (#1737)
- fix: use RELEASE_PAT so tag push triggers release workflow (#1736)
- fix: release-trigger uses release branch + PR instead of direct push to main (#1733)
- fix: Split release process to sync pyproject.toml version with git tags (#1732)
-
 ## [0.2.0] - 2026-03-09

 ### Changed

- feat: add Kimi Code CLI agent support
 - fix: sync agent list comments with actual supported agents (#1785)
 - feat(extensions): support multiple active catalogs simultaneously (#1720)
 - Pavel/add tabnine cli support (#1503)
--- a/README.md
+++ b/README.md
@@ -154,13 +154,7 @@ See Spec-Driven Development in action across different scenarios with these comm

 - **[Greenfield Spring Boot + React platform](https://github.com/mnriem/spec-kit-spring-react-demo)** — Builds an LLM performance analytics platform (REST API, graphs, iteration tracking) from scratch using Spring Boot, embedded React, PostgreSQL, and Docker Compose, with a clarify step and a cross-artifact consistency analysis pass included.

- **[Brownfield ASP.NET CMS extension](https://github.com/mnriem/spec-kit-aspnet-brownfield-demo)** — Extends an existing open-source .NET CMS (CarrotCakeCMS-Core, ~307,000 lines of C#, Razor, SQL, JavaScript, and config files) with two new features — cross-platform Docker Compose infrastructure and a token-authenticated headless REST API — demonstrating how spec-kit fits into existing codebases without prior specs or a constitution.
-
- **[Brownfield Java runtime extension](https://github.com/mnriem/spec-kit-java-brownfield-demo)** — Extends an existing open-source Jakarta EE runtime (Piranha, ~420,000 lines of Java, XML, JSP, HTML, and config files across 180 Maven modules) with a password-protected Server Admin Console, demonstrating spec-kit on a large multi-module Java project with no prior specs or constitution.
-
- **[Brownfield Go / React dashboard demo](https://github.com/mnriem/spec-kit-go-brownfield-demo)** — Demonstrates spec-kit driven entirely from the **terminal using GitHub Copilot CLI**. Extends NASA's open-source Hermes ground support system (Go) with a lightweight React-based web telemetry dashboard, showing that the full constitution → specify → plan → tasks → implement workflow works from the terminal.
-
- **[Greenfield Spring Boot MVC with a custom preset](https://github.com/mnriem/spec-kit-pirate-speak-preset-demo)** — Builds a Spring Boot MVC application from scratch using a custom pirate-speak preset, demonstrating how presets can reshape the entire spec-kit experience: specifications become "Voyage Manifests," plans become "Battle Plans," and tasks become "Crew Assignments" — all generated in full pirate vernacular without changing any tooling.
+- **[Brownfield ASP.NET CMS extension](https://github.com/mnriem/spec-kit-aspnet-brownfield-demo)** — Extends an existing open-source .NET CMS (CarrotCakeCMS-Core) with two new features — cross-platform Docker Compose infrastructure and a token-authenticated headless REST API — demonstrating how spec-kit fits into existing codebases without prior specs or a constitution.

 ## 🤖 Supported AI Agents

@@ -185,10 +179,8 @@ See Spec-Driven Development in action across different scenarios with these comm
 | [SHAI (OVHcloud)](https://github.com/ovh/shai)                                       | ✅      |                                                                                                                                           |
 | [Tabnine CLI](https://docs.tabnine.com/main/getting-started/tabnine-cli)             | ✅      |                                                                                                                                           |
 | [Mistral Vibe](https://github.com/mistralai/mistral-vibe)                            | ✅      |                                                                                                                                           |
-| [Kimi Code](https://code.kimi.com/)                                                  | ✅      |                                                                                                                                           |
 | [Windsurf](https://windsurf.com/)                                                    | ✅      |                                                                                                                                           |
-| [Antigravity (agy)](https://antigravity.google/)                                     | ✅      | Requires `--ai-skills` |
-| [Trae](https://www.trae.ai/)                                                         | ✅      |                                                                                                                                           |
+| [Antigravity (agy)](https://antigravity.google/)                                     | ✅      |                                                                                                                                           |
 | Generic                                                                              | ✅      | Bring your own agent — use `--ai generic --ai-commands-dir <path>` for unsupported agents                                                 |

 ## 🔧 Specify CLI Reference
@@ -200,14 +192,14 @@ The `specify` command supports the following options:
 | Command | Description                                                                                                                                             |
 | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `init`  | Initialize a new Specify project from the latest template                                                                                               |
-| `check` | Check for installed tools (`git`, `claude`, `gemini`, `code`/`code-insiders`, `cursor-agent`, `windsurf`, `qwen`, `opencode`, `codex`, `kiro-cli`, `shai`, `qodercli`, `vibe`, `kimi`) |
+| `check` | Check for installed tools (`git`, `claude`, `gemini`, `code`/`code-insiders`, `cursor-agent`, `windsurf`, `qwen`, `opencode`, `codex`, `kiro-cli`, `shai`, `qodercli`, `vibe`) |

 ### `specify init` Arguments & Options

 | 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-agent`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, `roo`, `codebuddy`, `amp`, `shai`, `kiro-cli` (`kiro` alias), `agy`, `bob`, `qodercli`, `vibe`, `kimi`, or `generic` (requires `--ai-commands-dir`) |
+| `--ai`                 | Option   | AI assistant to use: `claude`, `gemini`, `copilot`, `cursor-agent`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, `roo`, `codebuddy`, `amp`, `shai`, `kiro-cli` (`kiro` alias), `agy`, `bob`, `qodercli`, `vibe`, or `generic` (requires `--ai-commands-dir`) |
 | `--ai-commands-dir`    | Option   | Directory for agent command files (required with `--ai generic`, e.g. `.myagent/commands/`)                                                                                                  |
 | `--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                                                                                                                                              |
@@ -253,7 +245,7 @@ specify init my-project --ai vibe
 specify init my-project --ai bob

 # Initialize with Antigravity support
-specify init my-project --ai agy --ai-skills
+specify init my-project --ai agy

 # Initialize with an unsupported agent (generic / bring your own agent)
 specify init my-project --ai generic --ai-commands-dir .myagent/commands/
--- a/docs/quickstart.md
+++ b/docs/quickstart.md
@@ -173,6 +173,6 @@ Finally, implement the solution:

 ## Next Steps

- Read the [complete methodology](https://github.com/github/spec-kit/blob/main/spec-driven.md) for in-depth guidance
- Check out [more examples](https://github.com/github/spec-kit/tree/main/templates) in the repository
+- Read the [complete methodology](../spec-driven.md) for in-depth guidance
+- Check out [more examples](../templates) in the repository
 - Explore the [source code on GitHub](https://github.com/github/spec-kit)
--- a/extensions/EXTENSION-USER-GUIDE.md
+++ b/extensions/EXTENSION-USER-GUIDE.md
@@ -432,26 +432,6 @@ Spec Kit uses a **catalog stack** — an ordered list of catalogs searched simul
 specify extension catalog list
 ```

-### Managing Catalogs via CLI
-
-You can view the main catalog management commands using `--help`:
-
-```text
-specify extension catalog --help
-
- Usage: specify extension catalog [OPTIONS] COMMAND [ARGS]...
-
- Manage extension catalogs
-╭─ Options ────────────────────────────────────────────────────────────────────────╮
-│ --help          Show this message and exit.                                      │
-╰──────────────────────────────────────────────────────────────────────────────────╯
-╭─ Commands ───────────────────────────────────────────────────────────────────────╮
-│ list     List all active extension catalogs.                                     │
-│ add      Add a catalog to .specify/extension-catalogs.yml.                       │
-│ remove   Remove a catalog from .specify/extension-catalogs.yml.                  │
-╰──────────────────────────────────────────────────────────────────────────────────╯
-```
-
 ### Adding a Catalog (Project-scoped)

 ```bash
--- a/extensions/README.md
+++ b/extensions/README.md
@@ -72,17 +72,11 @@ The following community-contributed extensions are available in [`catalog.commun

 | Extension | Purpose | URL |
 |-----------|---------|-----|
-| Archive Extension | Archive merged features into main project memory. | [spec-kit-archive](https://github.com/stn1slv/spec-kit-archive) |
 | Azure DevOps Integration | Sync user stories and tasks to Azure DevOps work items using OAuth authentication | [spec-kit-azure-devops](https://github.com/pragya247/spec-kit-azure-devops) |
 | Cleanup Extension | Post-implementation quality gate that reviews changes, fixes small issues (scout rule), creates tasks for medium issues, and generates analysis for large issues | [spec-kit-cleanup](https://github.com/dsrednicki/spec-kit-cleanup) |
-| Cognitive Squad | 19-function cognitive agent squad for autonomous pre-code analysis — 7 core agents, 7 specialists, 4 learning functions with feedback loop | [cognitive-squad](https://github.com/Testimonial/cognitive-squad) |
-| DocGuard — CDD Enforcement | Canonical-Driven Development enforcement. Validates, scores, and traces project documentation with automated checks, AI-driven workflows, and spec-kit hooks. Zero dependencies. | [spec-kit-docguard](https://github.com/raccioly/docguard) |
 | Fleet Orchestrator | Orchestrate a full feature lifecycle with human-in-the-loop gates across all SpecKit phases | [spec-kit-fleet](https://github.com/sharathsatish/spec-kit-fleet) |
 | Jira Integration | Create Jira Epics, Stories, and Issues from spec-kit specifications and task breakdowns with configurable hierarchy and custom field support | [spec-kit-jira](https://github.com/mbachorik/spec-kit-jira) |
-| Project Health Check | Diagnose a Spec Kit project and report health issues across structure, agents, features, scripts, extensions, and git | [spec-kit-doctor](https://github.com/KhawarHabibKhan/spec-kit-doctor) |
-| Project Status | Show current SDD workflow progress — active feature, artifact status, task completion, workflow phase, and extensions summary | [spec-kit-status](https://github.com/KhawarHabibKhan/spec-kit-status) |
 | Ralph Loop | Autonomous implementation loop using AI agent CLI | [spec-kit-ralph](https://github.com/Rubiss/spec-kit-ralph) |
-| Reconcile Extension | Reconcile implementation drift by surgically updating feature artifacts. | [spec-kit-reconcile](https://github.com/stn1slv/spec-kit-reconcile) |
 | Retrospective Extension | Post-implementation retrospective with spec adherence scoring, drift analysis, and human-gated spec updates | [spec-kit-retrospective](https://github.com/emi-dm/spec-kit-retrospective) |
 | Review Extension | Post-implementation comprehensive code review with specialized agents for code quality, comments, tests, error handling, type design, and simplification | [spec-kit-review](https://github.com/ismaelJimenez/spec-kit-review) |
 | Spec Sync | Detect and resolve drift between specs and implementation. AI-assisted resolution with human approval | [spec-kit-sync](https://github.com/bgervin/spec-kit-sync) |
--- a/extensions/RFC-EXTENSION-SYSTEM.md
+++ b/extensions/RFC-EXTENSION-SYSTEM.md
@@ -1,9 +1,9 @@
 # RFC: Spec Kit Extension System

-**Status**: Implemented
+**Status**: Draft
 **Author**: Stats Perform Engineering
 **Created**: 2026-01-28
-**Updated**: 2026-03-11
+**Updated**: 2026-01-28

 ---

@@ -24,9 +24,8 @@
 13. [Security Considerations](#security-considerations)
 14. [Migration Strategy](#migration-strategy)
 15. [Implementation Phases](#implementation-phases)
-16. [Resolved Questions](#resolved-questions)
-17. [Open Questions (Remaining)](#open-questions-remaining)
-18. [Appendices](#appendices)
+16. [Open Questions](#open-questions)
+17. [Appendices](#appendices)

 ---

@@ -359,15 +358,12 @@ specify extension add jira
      "installed_at": "2026-01-28T14:30:00Z",
      "source": "catalog",
      "manifest_hash": "sha256:abc123...",
-      "enabled": true,
-      "priority": 10
+      "enabled": true
    }
  }
 }
 ```

-**Priority Field**: Extensions are ordered by `priority` (lower = higher precedence). Default is 10. Used for template resolution when multiple extensions provide the same template.
-
 ### 3. Configuration

 ```bash
@@ -1087,15 +1083,11 @@ List installed extensions in current project.
 $ specify extension list

 Installed Extensions:
-  ✓ Jira Integration (v1.0.0)
-     jira
-     Create Jira issues from spec-kit artifacts
-     Commands: 3 | Hooks: 2 | Priority: 10 | Status: Enabled
+  ✓ jira (v1.0.0) - Jira Integration
+    Commands: 3 | Hooks: 2 | Status: Enabled

-  ✓ Linear Integration (v0.9.0)
-     linear
-     Create Linear issues from spec-kit artifacts
-     Commands: 1 | Hooks: 1 | Priority: 10 | Status: Enabled
+  ✓ linear (v0.9.0) - Linear Integration
+    Commands: 1 | Hooks: 1 | Status: Enabled
 ```

 **Options:**
@@ -1203,9 +1195,10 @@ Next steps:

 **Options:**

- `--from URL`: Install from a remote URL (archive). Does not accept Git repositories directly.
- `--dev`: Install from a local path in development mode (the PATH is the positional `extension` argument).
- `--priority NUMBER`: Set resolution priority (lower = higher precedence, default 10)
+- `--from URL`: Install from custom URL or Git repo
+- `--version VERSION`: Install specific version
+- `--dev PATH`: Install from local path (development mode)
+- `--no-register`: Skip command registration (manual setup)

 #### `specify extension remove NAME`

@@ -1286,29 +1279,6 @@ $ specify extension disable jira
 To re-enable: specify extension enable jira
 ```

-#### `specify extension set-priority NAME PRIORITY`
-
-Change the resolution priority of an installed extension.
-
-```bash
-$ specify extension set-priority jira 5
-
-✓ Extension 'Jira Integration' priority changed: 10 → 5
-
-Lower priority = higher precedence in template resolution
-```
-
-**Priority Values:**
-
- Lower numbers = higher precedence (checked first in resolution)
- Default priority is 10
- Must be a positive integer (1 or higher)
-
-**Use Cases:**
-
- Ensure a critical extension's templates take precedence
- Override default resolution order when multiple extensions provide similar templates
-
 ---

 ## Compatibility & Versioning
@@ -1534,225 +1504,203 @@ AI agent registers both names, so old scripts work.

 ## Implementation Phases

-### Phase 1: Core Extension System ✅ COMPLETED
+### Phase 1: Core Extension System (Week 1-2)

 **Goal**: Basic extension infrastructure

 **Deliverables**:

- [x] Extension manifest schema (`extension.yml`)
- [x] Extension directory structure
- [x] CLI commands:
-  - [x] `specify extension list`
-  - [x] `specify extension add` (from URL and local `--dev`)
-  - [x] `specify extension remove`
- [x] Extension registry (`.specify/extensions/.registry`)
- [x] Command registration (Claude and 15+ other agents)
- [x] Basic validation (manifest schema, compatibility)
- [x] Documentation (extension development guide)
+- [ ] Extension manifest schema (`extension.yml`)
+- [ ] Extension directory structure
+- [ ] CLI commands:
+  - [ ] `specify extension list`
+  - [ ] `specify extension add` (from URL)
+  - [ ] `specify extension remove`
+- [ ] Extension registry (`.specify/extensions/.registry`)
+- [ ] Command registration (Claude only initially)
+- [ ] Basic validation (manifest schema, compatibility)
+- [ ] Documentation (extension development guide)

 **Testing**:

- [x] Unit tests for manifest parsing
- [x] Integration test: Install dummy extension
- [x] Integration test: Register commands with Claude
+- [ ] Unit tests for manifest parsing
+- [ ] Integration test: Install dummy extension
+- [ ] Integration test: Register commands with Claude

-### Phase 2: Jira Extension ✅ COMPLETED
+### Phase 2: Jira Extension (Week 3)

 **Goal**: First production extension

 **Deliverables**:

- [x] Create `spec-kit-jira` repository
- [x] Port Jira functionality to extension
- [x] Create `jira-config.yml` template
- [x] Commands:
-  - [x] `specstoissues.md`
-  - [x] `discover-fields.md`
-  - [x] `sync-status.md`
- [x] Helper scripts
- [x] Documentation (README, configuration guide, examples)
- [x] Release v3.0.0
+- [ ] Create `spec-kit-jira` repository
+- [ ] Port Jira functionality to extension
+- [ ] Create `jira-config.yml` template
+- [ ] Commands:
+  - [ ] `specstoissues.md`
+  - [ ] `discover-fields.md`
+  - [ ] `sync-status.md`
+- [ ] Helper scripts
+- [ ] Documentation (README, configuration guide, examples)
+- [ ] Release v1.0.0

 **Testing**:

- [x] Test on `eng-msa-ts` project
- [x] Verify spec→Epic, phase→Story, task→Issue mapping
- [x] Test configuration loading and validation
- [x] Test custom field application
+- [ ] Test on `eng-msa-ts` project
+- [ ] Verify spec→Epic, phase→Story, task→Issue mapping
+- [ ] Test configuration loading and validation
+- [ ] Test custom field application

-### Phase 3: Extension Catalog ✅ COMPLETED
+### Phase 3: Extension Catalog (Week 4)

 **Goal**: Discovery and distribution

 **Deliverables**:

- [x] Central catalog (`extensions/catalog.json` in spec-kit repo)
- [x] Community catalog (`extensions/catalog.community.json`)
- [x] Catalog fetch and parsing with multi-catalog support
- [x] CLI commands:
-  - [x] `specify extension search`
-  - [x] `specify extension info`
-  - [x] `specify extension catalog list`
-  - [x] `specify extension catalog add`
-  - [x] `specify extension catalog remove`
- [x] Documentation (how to publish extensions)
+- [ ] Central catalog (`extensions/catalog.json` in spec-kit repo)
+- [ ] Catalog fetch and parsing
+- [ ] CLI commands:
+  - [ ] `specify extension search`
+  - [ ] `specify extension info`
+- [ ] Catalog publishing process (GitHub Action)
+- [ ] Documentation (how to publish extensions)

 **Testing**:

- [x] Test catalog fetch
- [x] Test extension search/filtering
- [x] Test catalog caching
- [x] Test multi-catalog merge with priority
+- [ ] Test catalog fetch
+- [ ] Test extension search/filtering
+- [ ] Test catalog caching

-### Phase 4: Advanced Features ✅ COMPLETED
+### Phase 4: Advanced Features (Week 5-6)

 **Goal**: Hooks, updates, multi-agent support

 **Deliverables**:

- [x] Hook system (`hooks` in extension.yml)
- [x] Hook registration and execution
- [x] Project extensions config (`.specify/extensions.yml`)
- [x] CLI commands:
-  - [x] `specify extension update` (with atomic backup/restore)
-  - [x] `specify extension enable/disable`
- [x] Command registration for multiple agents (15+ agents including Claude, Copilot, Gemini, Cursor, etc.)
- [x] Extension update notifications (version comparison)
- [x] Configuration layer resolution (project, local, env)
-
-**Additional features implemented beyond original RFC**:
-
- [x] **Display name resolution**: All commands accept extension display names in addition to IDs
- [x] **Ambiguous name handling**: User-friendly tables when multiple extensions match a name
- [x] **Atomic update with rollback**: Full backup of extension dir, commands, hooks, and registry with automatic rollback on failure
- [x] **Pre-install ID validation**: Validates extension ID from ZIP before installing (security)
- [x] **Enabled state preservation**: Disabled extensions stay disabled after update
- [x] **Registry update/restore methods**: Clean API for enable/disable and rollback operations
- [x] **Catalog error fallback**: `extension info` falls back to local info when catalog unavailable
- [x] **`_install_allowed` flag**: Discovery-only catalogs can't be used for installation
- [x] **Cache invalidation**: Cache invalidated when `SPECKIT_CATALOG_URL` changes
+- [ ] Hook system (`hooks` in extension.yml)
+- [ ] Hook registration and execution
+- [ ] Project extensions config (`.specify/extensions.yml`)
+- [ ] CLI commands:
+  - [ ] `specify extension update`
+  - [ ] `specify extension enable/disable`
+- [ ] Command registration for multiple agents (Gemini, Copilot)
+- [ ] Extension update notifications
+- [ ] Configuration layer resolution (project, local, env)

 **Testing**:

- [x] Test hooks in core commands
- [x] Test extension updates (preserve config)
- [x] Test multi-agent registration
- [x] Test atomic rollback on update failure
- [x] Test enabled state preservation
- [x] Test display name resolution
+- [ ] Test hooks in core commands
+- [ ] Test extension updates (preserve config)
+- [ ] Test multi-agent registration

-### Phase 5: Polish & Documentation ✅ COMPLETED
+### Phase 5: Polish & Documentation (Week 7)

 **Goal**: Production ready

 **Deliverables**:

- [x] Comprehensive documentation:
-  - [x] User guide (EXTENSION-USER-GUIDE.md)
-  - [x] Extension development guide (EXTENSION-DEV-GUIDE.md)
-  - [x] Extension API reference (EXTENSION-API-REFERENCE.md)
- [x] Error messages and validation improvements
- [x] CLI help text updates
+- [ ] Comprehensive documentation:
+  - [ ] User guide (installing/using extensions)
+  - [ ] Extension development guide
+  - [ ] Extension API reference
+  - [ ] Migration guide (core → extension)
+- [ ] Error messages and validation improvements
+- [ ] CLI help text updates
+- [ ] Example extension template (cookiecutter)
+- [ ] Blog post / announcement
+- [ ] Video tutorial

 **Testing**:

- [x] End-to-end testing on multiple projects
- [x] 163 unit tests passing
+- [ ] End-to-end testing on multiple projects
+- [ ] Community beta testing
+- [ ] Performance testing (large projects)

 ---

-## Resolved Questions
+## Open Questions

-The following questions from the original RFC have been resolved during implementation:
-
-### 1. Extension Namespace ✅ RESOLVED
+### 1. Extension Namespace

 **Question**: Should extension commands use namespace prefix?

-**Decision**: **Option C** - Both prefixed and aliases are supported. Commands use `speckit.{extension}.{command}` as canonical name, with optional aliases defined in manifest.
+**Options**:

-**Implementation**: The `aliases` field in `extension.yml` allows extensions to register additional command names.
+- A) Prefixed: `/speckit.jira.specstoissues` (explicit, avoids conflicts)
+- B) Short alias: `/jira.specstoissues` (shorter, less verbose)
+- C) Both: Register both names, prefer prefixed in docs
+
+**Recommendation**: C (both), prefixed is canonical

 ---

-### 2. Config File Location ✅ RESOLVED
+### 2. Config File Location

 **Question**: Where should extension configs live?

-**Decision**: **Option A** - Extension directory (`.specify/extensions/{ext-id}/{ext-id}-config.yml`). This keeps extensions self-contained and easier to manage.
+**Options**:

-**Implementation**: Each extension has its own config file within its directory, with layered resolution (defaults → project → local → env vars).
+- A) Extension directory: `.specify/extensions/jira/jira-config.yml` (encapsulated)
+- B) Root level: `.specify/jira-config.yml` (more visible)
+- C) Unified: `.specify/extensions.yml` (all extension configs in one file)
+
+**Recommendation**: A (extension directory), cleaner separation

 ---

-### 3. Command File Format ✅ RESOLVED
+### 3. Command File Format

 **Question**: Should extensions use universal format or agent-specific?

-**Decision**: **Option A** - Universal Markdown format. Extensions write commands once, CLI converts to agent-specific format during registration.
+**Options**:

-**Implementation**: `CommandRegistrar` class handles conversion to 15+ agent formats (Claude, Copilot, Gemini, Cursor, etc.).
+- A) Universal Markdown: Extensions write once, CLI converts per-agent
+- B) Agent-specific: Extensions provide separate files for each agent
+- C) Hybrid: Universal default, agent-specific overrides
+
+**Recommendation**: A (universal), reduces duplication

 ---

-### 4. Hook Execution Model ✅ RESOLVED
+### 4. Hook Execution Model

 **Question**: How should hooks execute?

-**Decision**: **Option A** - Hooks are registered in `.specify/extensions.yml` and executed by the AI agent when it sees the hook trigger. Hook state (enabled/disabled) is managed per-extension.
+**Options**:

-**Implementation**: `HookExecutor` class manages hook registration and state in `extensions.yml`.
+- A) AI agent interprets: Core commands output `EXECUTE_COMMAND: name`
+- B) CLI executes: Core commands call `specify extension hook after_tasks`
+- C) Agent built-in: Extension system built into AI agent (Claude SDK)
+
+**Recommendation**: A initially (simpler), move to C long-term

 ---

-### 5. Extension Distribution ✅ RESOLVED
+### 5. Extension Distribution

 **Question**: How should extensions be packaged?

-**Decision**: **Option A** - ZIP archives downloaded from GitHub releases (via catalog `download_url`). Local development uses `--dev` flag with directory path.
+**Options**:

-**Implementation**: `ExtensionManager.install_from_zip()` handles ZIP extraction and validation.
+- A) ZIP archives: Downloaded from GitHub releases
+- B) Git repos: Cloned directly (`git clone`)
+- C) Python packages: Installable via `uv tool install`
+
+**Recommendation**: A (ZIP), simpler for non-Python extensions in future

 ---

-### 6. Multi-Version Support ✅ RESOLVED
+### 6. Multi-Version Support

 **Question**: Can multiple versions of same extension coexist?

-**Decision**: **Option A** - Single version only. Updates replace the existing version with atomic rollback on failure.
-
-**Implementation**: `extension update` performs atomic backup/restore to ensure safe updates.
-
---
-
-## Open Questions (Remaining)
-
-### 1. Sandboxing / Permissions (Future)
-
-**Question**: Should extensions declare required permissions?
-
 **Options**:

- A) No sandboxing (current): Extensions run with same privileges as AI agent
- B) Permission declarations: Extensions declare `filesystem:read`, `network:external`, etc.
- C) Opt-in sandboxing: Organizations can enable permission enforcement
+- A) Single version: Only one version installed at a time
+- B) Multi-version: Side-by-side versions (`.specify/extensions/jira@1.0/`, `.specify/extensions/jira@2.0/`)
+- C) Per-branch: Different branches use different versions

-**Status**: Deferred to future version. Currently using trust-based model where users trust extension authors.
-
---
-
-### 2. Package Signatures (Future)
-
-**Question**: Should extensions be cryptographically signed?
-
-**Options**:
-
- A) No signatures (current): Trust based on catalog source
- B) GPG/Sigstore signatures: Verify package integrity
- C) Catalog-level verification: Catalog maintainers verify packages
-
-**Status**: Deferred to future version. `checksum` field is available in catalog schema but not enforced.
+**Recommendation**: A initially (simpler), consider B in future if needed

 ---

--- a/extensions/catalog.community.json
+++ b/extensions/catalog.community.json
@@ -1,39 +1,8 @@
 {
  "schema_version": "1.0",
-  "updated_at": "2026-03-16T00:00:00Z",
+  "updated_at": "2026-03-09T00:00:00Z",
  "catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/extensions/catalog.community.json",
  "extensions": {
-    "archive": {
-      "name": "Archive Extension",
-      "id": "archive",
-      "description": "Archive merged features into main project memory, resolving gaps and conflicts.",
-      "author": "Stanislav Deviatov",
-      "version": "1.0.0",
-      "download_url": "https://github.com/stn1slv/spec-kit-archive/archive/refs/tags/v1.0.0.zip",
-      "repository": "https://github.com/stn1slv/spec-kit-archive",
-      "homepage": "https://github.com/stn1slv/spec-kit-archive",
-      "documentation": "https://github.com/stn1slv/spec-kit-archive/blob/main/README.md",
-      "changelog": "https://github.com/stn1slv/spec-kit-archive/blob/main/CHANGELOG.md",
-      "license": "MIT",
-      "requires": {
-        "speckit_version": ">=0.1.0"
-      },
-      "provides": {
-        "commands": 1,
-        "hooks": 0
-      },
-      "tags": [
-        "archive",
-        "memory",
-        "merge",
-        "changelog"
-      ],
-      "verified": false,
-      "downloads": 0,
-      "stars": 0,
-      "created_at": "2026-03-14T00:00:00Z",
-      "updated_at": "2026-03-14T00:00:00Z"
-    },
    "azure-devops": {
      "name": "Azure DevOps Integration",
      "id": "azure-devops",
@@ -105,123 +74,6 @@
      "created_at": "2026-02-22T00:00:00Z",
      "updated_at": "2026-02-22T00:00:00Z"
    },
-    "cognitive-squad": {
-      "name": "Cognitive Squad",
-      "id": "cognitive-squad",
-      "description": "19-function cognitive agent squad for autonomous pre-code analysis — 7 core agents, 7 specialists, 4 learning functions with feedback loop",
-      "author": "Testimonial",
-      "version": "0.1.0",
-      "download_url": "https://github.com/Testimonial/cognitive-squad/archive/refs/tags/v0.1.0.zip",
-      "repository": "https://github.com/Testimonial/cognitive-squad",
-      "homepage": "https://github.com/Testimonial/cognitive-squad",
-      "documentation": "https://github.com/Testimonial/cognitive-squad/blob/main/README.md",
-      "changelog": "https://github.com/Testimonial/cognitive-squad/blob/main/CHANGELOG.md",
-      "license": "MIT",
-      "requires": {
-        "speckit_version": ">=0.3.0",
-        "tools": [
-          {
-            "name": "understanding",
-            "version": ">=3.4.0",
-            "required": false
-          },
-          {
-            "name": "spec-kit-reverse-eng",
-            "version": ">=1.0.0",
-            "required": false
-          }
-        ]
-      },
-      "provides": {
-        "commands": 7,
-        "hooks": 1
-      },
-      "tags": [
-        "ai-agents",
-        "cognitive",
-        "pre-code",
-        "analysis",
-        "multi-agent"
-      ],
-      "verified": false,
-      "downloads": 0,
-      "stars": 0,
-      "created_at": "2026-03-16T00:00:00Z",
-      "updated_at": "2026-03-16T00:00:00Z"
-    },
-    "docguard": {
-      "name": "DocGuard \u2014 CDD Enforcement",
-      "id": "docguard",
-      "description": "Canonical-Driven Development enforcement. Validates, scores, and traces project documentation with automated checks, AI-driven workflows, and spec-kit hooks. Zero dependencies.",
-      "author": "raccioly",
-      "version": "0.9.8",
-      "download_url": "https://github.com/raccioly/docguard/releases/download/v0.9.8/spec-kit-docguard-v0.9.8.zip",
-      "repository": "https://github.com/raccioly/docguard",
-      "homepage": "https://www.npmjs.com/package/docguard-cli",
-      "documentation": "https://github.com/raccioly/docguard/blob/main/extensions/spec-kit-docguard/README.md",
-      "changelog": "https://github.com/raccioly/docguard/blob/main/CHANGELOG.md",
-      "license": "MIT",
-      "requires": {
-        "speckit_version": ">=0.1.0",
-        "tools": [
-          {
-            "name": "node",
-            "version": ">=18.0.0",
-            "required": true
-          }
-        ]
-      },
-      "provides": {
-        "commands": 6,
-        "hooks": 3
-      },
-      "tags": [
-        "documentation",
-        "validation",
-        "quality",
-        "cdd",
-        "traceability",
-        "ai-agents",
-        "enforcement",
-        "spec-kit"
-      ],
-      "verified": false,
-      "downloads": 0,
-      "stars": 0,
-      "created_at": "2026-03-13T00:00:00Z",
-      "updated_at": "2026-03-15T20:00:00Z"
-    },
-    "doctor": {
-      "name": "Project Health Check",
-      "id": "doctor",
-      "description": "Diagnose a Spec Kit project and report health issues across structure, agents, features, scripts, extensions, and git.",
-      "author": "KhawarHabibKhan",
-      "version": "1.0.0",
-      "download_url": "https://github.com/KhawarHabibKhan/spec-kit-doctor/archive/refs/tags/v1.0.0.zip",
-      "repository": "https://github.com/KhawarHabibKhan/spec-kit-doctor",
-      "homepage": "https://github.com/KhawarHabibKhan/spec-kit-doctor",
-      "documentation": "https://github.com/KhawarHabibKhan/spec-kit-doctor/blob/main/README.md",
-      "changelog": "https://github.com/KhawarHabibKhan/spec-kit-doctor/blob/main/CHANGELOG.md",
-      "license": "MIT",
-      "requires": {
-        "speckit_version": ">=0.1.0"
-      },
-      "provides": {
-        "commands": 1,
-        "hooks": 0
-      },
-      "tags": [
-        "diagnostics",
-        "health-check",
-        "validation",
-        "project-structure"
-      ],
-      "verified": false,
-      "downloads": 0,
-      "stars": 0,
-      "created_at": "2026-03-13T00:00:00Z",
-      "updated_at": "2026-03-13T00:00:00Z"
-    },
    "fleet": {
      "name": "Fleet Orchestrator",
      "id": "fleet",
@@ -241,12 +93,7 @@
        "commands": 2,
        "hooks": 1
      },
-      "tags": [
-        "orchestration",
-        "workflow",
-        "human-in-the-loop",
-        "parallel"
-      ],
+      "tags": ["orchestration", "workflow", "human-in-the-loop", "parallel"],
      "verified": false,
      "downloads": 0,
      "stars": 0,
@@ -313,49 +160,13 @@
        "commands": 2,
        "hooks": 1
      },
-      "tags": [
-        "implementation",
-        "automation",
-        "loop",
-        "copilot"
-      ],
+      "tags": ["implementation", "automation", "loop", "copilot"],
      "verified": false,
      "downloads": 0,
      "stars": 0,
      "created_at": "2026-03-09T00:00:00Z",
      "updated_at": "2026-03-09T00:00:00Z"
    },
-    "reconcile": {
-      "name": "Reconcile Extension",
-      "id": "reconcile",
-      "description": "Reconcile implementation drift by surgically updating the feature's own spec, plan, and tasks.",
-      "author": "Stanislav Deviatov",
-      "version": "1.0.0",
-      "download_url": "https://github.com/stn1slv/spec-kit-reconcile/archive/refs/tags/v1.0.0.zip",
-      "repository": "https://github.com/stn1slv/spec-kit-reconcile",
-      "homepage": "https://github.com/stn1slv/spec-kit-reconcile",
-      "documentation": "https://github.com/stn1slv/spec-kit-reconcile/blob/main/README.md",
-      "changelog": "https://github.com/stn1slv/spec-kit-reconcile/blob/main/CHANGELOG.md",
-      "license": "MIT",
-      "requires": {
-        "speckit_version": ">=0.1.0"
-      },
-      "provides": {
-        "commands": 1,
-        "hooks": 0
-      },
-      "tags": [
-        "reconcile",
-        "drift",
-        "tasks",
-        "remediation"
-      ],
-      "verified": false,
-      "downloads": 0,
-      "stars": 0,
-      "created_at": "2026-03-14T00:00:00Z",
-      "updated_at": "2026-03-14T00:00:00Z"
-    },
    "retrospective": {
      "name": "Retrospective Extension",
      "id": "retrospective",
@@ -407,15 +218,7 @@
        "commands": 7,
        "hooks": 1
      },
-      "tags": [
-        "code-review",
-        "quality",
-        "review",
-        "testing",
-        "error-handling",
-        "type-design",
-        "simplification"
-      ],
+      "tags": ["code-review", "quality", "review", "testing", "error-handling", "type-design", "simplification"],
      "verified": false,
      "downloads": 0,
      "stars": 0,
@@ -457,7 +260,7 @@
    "understanding": {
      "name": "Understanding",
      "id": "understanding",
-      "description": "Automated requirements quality analysis \u2014 validates specs against IEEE/ISO standards using 31 deterministic metrics. Catches ambiguity, missing testability, and structural issues before they reach implementation. Includes experimental energy-based ambiguity detection using local LM token perplexity.",
+      "description": "Automated requirements quality analysis — validates specs against IEEE/ISO standards using 31 deterministic metrics. Catches ambiguity, missing testability, and structural issues before they reach implementation. Includes experimental energy-based ambiguity detection using local LM token perplexity.",
      "author": "Ladislav Bihari",
      "version": "3.4.0",
      "download_url": "https://github.com/Testimonial/understanding/archive/refs/tags/v3.4.0.zip",
@@ -495,38 +298,6 @@
      "created_at": "2026-03-07T00:00:00Z",
      "updated_at": "2026-03-07T00:00:00Z"
    },
-    "status": {
-      "name": "Project Status",
-      "id": "status",
-      "description": "Show current SDD workflow progress — active feature, artifact status, task completion, workflow phase, and extensions summary.",
-      "author": "KhawarHabibKhan",
-      "version": "1.0.0",
-      "download_url": "https://github.com/KhawarHabibKhan/spec-kit-status/archive/refs/tags/v1.0.0.zip",
-      "repository": "https://github.com/KhawarHabibKhan/spec-kit-status",
-      "homepage": "https://github.com/KhawarHabibKhan/spec-kit-status",
-      "documentation": "https://github.com/KhawarHabibKhan/spec-kit-status/blob/main/README.md",
-      "changelog": "https://github.com/KhawarHabibKhan/spec-kit-status/blob/main/CHANGELOG.md",
-      "license": "MIT",
-      "requires": {
-        "speckit_version": ">=0.1.0"
-      },
-      "provides": {
-        "commands": 1,
-        "hooks": 0
-      },
-      "tags": [
-        "status",
-        "workflow",
-        "progress",
-        "feature-tracking",
-        "task-progress"
-      ],
-      "verified": false,
-      "downloads": 0,
-      "stars": 0,
-      "created_at": "2026-03-16T00:00:00Z",
-      "updated_at": "2026-03-16T00:00:00Z"
-    },
    "v-model": {
      "name": "V-Model Extension Pack",
      "id": "v-model",
--- a/extensions/catalog.json
+++ b/extensions/catalog.json
@@ -1,21 +1,6 @@
 {
  "schema_version": "1.0",
-  "updated_at": "2026-03-10T00:00:00Z",
+  "updated_at": "2026-02-03T00:00:00Z",
  "catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/extensions/catalog.json",
-  "extensions": {
-    "selftest": {
-      "name": "Spec Kit Self-Test Utility",
-      "id": "selftest",
-      "version": "1.0.0",
-      "description": "Verifies catalog extensions by programmatically walking through the discovery, installation, and registration lifecycle.",
-      "author": "spec-kit-core",
-      "repository": "https://github.com/github/spec-kit",
-      "download_url": "https://github.com/github/spec-kit/releases/download/selftest-v1.0.0/selftest.zip",
-      "tags": [
-        "testing",
-        "core",
-        "utility"
-      ]
-    }
-  }
-}
+  "extensions": {}
+}
--- a/extensions/selftest/commands/selftest.md
+++ b/extensions/selftest/commands/selftest.md
@@ -1,69 +0,0 @@
---
-description: "Validate the lifecycle of an extension from the catalog."
---
-
-# Extension Self-Test: `$ARGUMENTS`
-
-This command drives a self-test simulating the developer experience with the `$ARGUMENTS` extension.
-
-## Goal
-
-Validate the end-to-end lifecycle (discovery, installation, registration) for the extension: `$ARGUMENTS`.
-If `$ARGUMENTS` is empty, you must tell the user to provide an extension name, for example: `/speckit.selftest.extension linear`.
-
-## Steps
-
-### Step 1: Catalog Discovery Validation
-
-Check if the extension exists in the Spec Kit catalog.
-Execute this command and verify that it completes successfully and that the returned extension ID exactly matches `$ARGUMENTS`. If the command fails or the ID does not match `$ARGUMENTS`, fail the test.
-
-```bash
-specify extension info "$ARGUMENTS"
-```
-
-### Step 2: Simulate Installation
-
-First, try to add the extension to the current workspace configuration directly. If the catalog provides the extension as `install_allowed: false` (discovery-only), this step is *expected* to fail.
-
-```bash
-specify extension add "$ARGUMENTS"
-```
-
-Then, simulate adding the extension by installing it from its catalog download URL, which should bypass the restriction.
-Obtain the extension's `download_url` from the catalog metadata (for example, via a catalog info command or UI), then run:
-
-```bash
-specify extension add "$ARGUMENTS" --from "<download_url>"
-```
-
-### Step 3: Registration Verification
-
-Once the `add` command completes, verify the installation by checking the project configuration.
-Use terminal tools (like `cat`) to verify that the following file contains a record for `$ARGUMENTS`.
-
-```bash
-cat .specify/extensions/.registry/$ARGUMENTS.json
-```
-
-### Step 4: Verification Report
-
-Analyze the standard output of the three steps. 
-Generate a terminal-style test output format detailing the results of discovery, installation, and registration. Return this directly to the user.
-
-Example output format:
-```text
-============================= test session starts ==============================
-collected 3 items
-
-test_selftest_discovery.py::test_catalog_search [PASS/FAIL]
-  Details: [Provide execution result of specify extension search]
-
-test_selftest_installation.py::test_extension_add [PASS/FAIL]
-  Details: [Provide execution result of specify extension add]
-
-test_selftest_registration.py::test_config_verification [PASS/FAIL]
-  Details: [Provide execution result of registry record verification]
-
-============================== [X] passed in ... ==============================
-```
--- a/extensions/selftest/extension.yml
+++ b/extensions/selftest/extension.yml
@@ -1,16 +0,0 @@
-schema_version: "1.0"
-extension:
-  id: selftest
-  name: Spec Kit Self-Test Utility
-  version: 1.0.0
-  description: Verifies catalog extensions by programmatically walking through the discovery, installation, and registration lifecycle.
-  author: spec-kit-core
-  repository: https://github.com/github/spec-kit
-  license: MIT
-requires:
-  speckit_version: ">=0.2.0"
-provides:
-  commands:
-    - name: speckit.selftest.extension
-      file: commands/selftest.md
-      description: Validate the lifecycle of an extension from the catalog.
--- a/newsletters/2026-February.md
+++ b/newsletters/2026-February.md
@@ -1,54 +0,0 @@
-# Spec Kit - February 2026 Newsletter
-
-This edition covers Spec Kit activity in February 2026. Versions v0.1.7 through v0.1.13 shipped during the month, addressing bugs and adding features including a dual-catalog extension system and additional agent integrations. Community activity included blog posts, tutorials, and meetup sessions. A category summary is in the table below, followed by details.
-
-| **Spec Kit Core (Feb 2026)** | **Community & Content** | **Roadmap & Next** |
-| --- | --- | --- |
-| Versions **v0.1.7** through **v0.1.13** shipped with bug fixes and features, including a **dual-catalog extension system** and new agent integrations. Over 300 issues were closed (of ~800 filed). The repo reached 71k stars and 6.4k forks. [\[github.com\]](https://github.com/github/spec-kit/releases) [\[github.com\]](https://github.com/github/spec-kit/issues) [\[rywalker.com\]](https://rywalker.com/research/github-spec-kit) | Eduardo Luz published a LinkedIn article on SDD and Spec Kit [\[linkedin.com\]](https://www.linkedin.com/pulse/specification-driven-development-sdd-github-spec-kit-elevating-luz-tojmc?tl=en). Erick Matsen blogged a walkthrough of building a bioinformatics pipeline with Spec Kit [\[matsen.fredhutch.org\]](https://matsen.fredhutch.org/general/2026/02/10/spec-kit-walkthrough.html). Microsoft MVP [Eric Boyd](https://ericboyd.com/) (not the Microsoft AI Platform VP of the same name) presented at the Cleveland .NET User Group [\[ericboyd.com\]](https://ericboyd.com/events/cleveland-csharp-user-group-february-25-2026-spec-driven-development-sdd-github-spec-kit). | **v0.2.0** was released in early March, consolidating February's work. It added extensions for Jira and Azure DevOps, community plugin support, and agents for Tabnine CLI and Kiro CLI [\[github.com\]](https://github.com/github/spec-kit/releases). Future work includes spec lifecycle management and progress toward a stable 1.0 release [\[martinfowler.com\]](https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html). |
-
-***
-
-## Spec Kit Project Updates
-
-Spec Kit released versions **v0.1.7** through **v0.1.13** during February. Version 0.1.7 (early February) updated documentation for the newly introduced **dual-catalog extension system**, which allows both core and community extension catalogs to coexist. Subsequent patches (0.1.8, 0.1.9, etc.) bumped dependencies such as GitHub Actions versions and resolved minor issues. **v0.1.10** fixed YAML front-matter handling in generated files. By late February, **v0.1.12** and **v0.1.13** shipped with additional fixes in preparation for the next version bump. [\[github.com\]](https://github.com/github/spec-kit/releases)
-
-The main architectural addition was the **modular extension system** with separate "core" and "community" extension catalogs for third-party add-ons. Multiple community-contributed extensions were merged during the month, including a **Jira extension** for issue tracker integration, an **Azure DevOps extension**, and utility extensions for code review, retrospective documentation, and CI/CD sync. The pending 0.2.0 release changelog lists over a dozen changes from February, including the extension additions and support for **multiple agent catalogs concurrently**. [\[github.com\]](https://github.com/github/spec-kit/releases)
-
-By end of February, **over 330 issues/feature requests had been closed on GitHub** (out of ~870 filed to date). External contributors submitted pull requests including the **Tabnine CLI support**, which was merged in late February. The repository reached ~71k stars and crossed 6,000 forks. [\[github.com\]](https://github.com/github/spec-kit/issues) [\[github.com\]](https://github.com/github/spec-kit/releases) [\[rywalker.com\]](https://rywalker.com/research/github-spec-kit)
-
-On the stability side, February's work focused on tightening core workflows and fixing edge-case bugs in the specification, planning, and task-generation commands. The team addressed file-handling issues (e.g., clarifying how output files are created/appended) and improved the reliability of the automated release pipeline. The project also added **Kiro CLI** to the supported agent list and updated integration scripts for Cursor and Code Interpreter, bringing the total number of supported AI coding assistants to over 20. [\[github.com\]](https://github.com/github/spec-kit/releases) [\[github.com\]](https://github.com/github/spec-kit)
-
-## Community & Content
-
-**Eduardo Luz** published a LinkedIn article on Feb 15 titled *"Specification Driven Development (SDD) and the GitHub Spec Kit: Elevating Software Engineering."* The article draws on his experience as a senior engineer to describe common causes of technical debt and inconsistent designs, and how SDD addresses them. It walks through Spec Kit's **four-layer approach** (Constitution, Design, Tasks, Implementation) and discusses treating specifications as a source of truth. The post generated discussion among software architects on LinkedIn about reducing misunderstandings and rework through spec-driven workflows. [\[linkedin.com\]](https://www.linkedin.com/pulse/specification-driven-development-sdd-github-spec-kit-elevating-luz-tojmc?tl=en)
-
-**Erick Matsen** (Fred Hutchinson Cancer Center) posted a detailed walkthrough on Feb 10 titled *"Spec-Driven Development with spec-kit."* He describes building a **bioinformatics pipeline** in a single day using Spec Kit's workflow (from `speckit.constitution` to `speckit.implement`). The post includes command outputs and notes on decisions made along the way, such as refining the spec to add domain-specific requirements. He writes: "I really recommend this approach. This feels like the way software development should be." [\[matsen.fredhutch.org\]](https://matsen.fredhutch.org/general/2026/02/10/spec-kit-walkthrough.html) [\[github.com\]](https://github.com/mnriem/spec-kit-dotnet-cli-demo)
-
-Several other tutorials and guides appeared during the month. An article on *IntuitionLabs* (updated Feb 21) provided a guide to Spec Kit covering the philosophy behind SDD and a walkthrough of the four-phase workflow with examples. A piece by Ry Walker (Feb 22) summarized key aspects of Spec Kit, noting its agent-agnostic design and 71k-star count. Microsoft's Developer Blog post from late 2025 (*"Diving Into Spec-Driven Development with GitHub Spec Kit"* by Den Delimarsky) continued to circulate among new users. [\[intuitionlabs.ai\]](https://intuitionlabs.ai/articles/spec-driven-development-spec-kit) [\[rywalker.com\]](https://rywalker.com/research/github-spec-kit)
-
-On **Feb 25**, the Cleveland C# .NET User Group hosted a session titled *"Spec Driven Development with GitHub Spec Kit."* The talk was delivered by Microsoft MVP **[Eric Boyd](https://ericboyd.com/)** (Cleveland-based .NET developer; not to be confused with the Microsoft AI Platform VP of the same name). Boyd covered how specs change an AI coding assistant's output, patterns for iterating and refining specs over multiple cycles, and moving from ad-hoc prompting to a repeatable spec-driven workflow. Other groups, including GDG Madison, also listed sessions on spec-driven development in late February and early March. [\[ericboyd.com\]](https://ericboyd.com/events/cleveland-csharp-user-group-february-25-2026-spec-driven-development-sdd-github-spec-kit)
-
-On GitHub, the **Spec Kit Discussions forum** saw activity around installation troubleshooting, handling multi-feature projects with Spec Kit's branching model, and feature suggestions. One thread discussed how Spec Kit treats each spec as a short-lived artifact tied to a feature branch, which led to discussion about future support for long-running "spec of record" use cases. [\[martinfowler.com\]](https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html)
-
-## SDD Ecosystem
-
-Other spec-driven development tools also saw activity in February.
-
-AWS **Kiro** released version 0.10 on Feb 18 with two new spec workflows: a **Design-First** mode (starting from architecture/pseudocode to derive requirements) and a **Bugfix** mode (structured root-cause analysis producing a `bugfix.md` spec file). Kiro also added hunk-level code review for AI-generated changes and pre/post task hooks for custom automation. AWS expanded Kiro to GovCloud regions on Feb 17 for government compliance use cases. [\[kiro.dev\]](https://kiro.dev/changelog/)
-
-**OpenSpec** (by Fission AI), a lightweight SDD framework, reached ~29.3k stars and nearly 2k forks. Its community published guides and comparisons during the month, including *"Spec-Driven Development Made Easy: A Practical Guide with OpenSpec."* OpenSpec emphasizes simplicity and flexibility, integrating with multiple AI coding assistants via YAML configs.
-
-**Tessl** remained in private beta. As described by Thoughtworks writer Birgitta Boeckeler, Tessl pursues a **spec-as-source** model where specifications are maintained long-term and directly generate code files one-to-one, with generated code labeled as "do not edit." This contrasts with Spec Kit's current approach of creating specs per feature/branch. [\[martinfowler.com\]](https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html)
-
-An **arXiv preprint** (January 2026) categorized SDD implementations into three levels: *spec-first*, *spec-anchored*, and *spec-as-source*. Spec Kit was identified as primarily spec-first with elements of spec-anchored. Tech media published reviews including a *Vibe Coding* "GitHub Spec Kit Review (2026)" and a blog post titled *"Putting Spec Kit Through Its Paces: Radical Idea or Reinvented Waterfall?"* which concluded that SDD with AI assistance is more iterative than traditional Waterfall. [\[intuitionlabs.ai\]](https://intuitionlabs.ai/articles/spec-driven-development-spec-kit) [\[martinfowler.com\]](https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html)
-
-## Roadmap
-
-**v0.2.0** was released on March 10, 2026, consolidating the month's work. It includes new extensions (Jira, Azure DevOps, review, sync), support for multiple extension catalogs and community plugins, and additional agent integrations (Tabnine CLI, Kiro CLI). [\[github.com\]](https://github.com/github/spec-kit/releases)
-
-Areas under discussion or in progress for future development:
-
- **Spec lifecycle management** -- supporting longer-lived specifications that can evolve across multiple iterations, rather than being tied to a single feature branch. Users have raised this in GitHub Discussions, and the concept of "spec-anchored" development is under consideration. [\[martinfowler.com\]](https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html)
- **CI/CD integration** -- incorporating Spec Kit verification (e.g., `speckit.checklist` or `speckit.verify`) into pull request workflows and project management tools. February's Jira and Azure DevOps extensions are a step in this direction. [\[github.com\]](https://github.com/github/spec-kit/releases)
- **Continued agent support** -- adding integrations as new AI coding assistants emerge. The project currently supports over 20 agents and has been adding new ones (Kiro CLI, Tabnine CLI) as they become available. [\[github.com\]](https://github.com/github/spec-kit)
- **Community ecosystem** -- the open extension model allows external contributors to add functionality directly. February's Jira and Azure DevOps plugins were community-contributed. The Spec Kit README now links to community walkthrough demos for .NET, Spring Boot, and other stacks. [\[github.com\]](https://github.com/github/spec-kit)
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "specify-cli"
-version = "0.3.1"
+version = "0.2.1"
 description = "Specify CLI, part of GitHub Spec Kit. A tool to bootstrap your projects for Spec-Driven Development (SDD)."
 requires-python = ">=3.11"
 dependencies = [
@@ -14,7 +14,6 @@ dependencies = [
    "pyyaml>=6.0",
    "packaging>=23.0",
    "pathspec>=0.12.0",
-    "json5>=0.13.0",
 ]

 [project.scripts]
--- a/scripts/bash/check-prerequisites.sh
+++ b/scripts/bash/check-prerequisites.sh
@@ -79,28 +79,15 @@ SCRIPT_DIR="$(CDPATH="" cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 source "$SCRIPT_DIR/common.sh"

 # Get feature paths and validate branch
-_paths_output=$(get_feature_paths) || { echo "ERROR: Failed to resolve feature paths" >&2; exit 1; }
-eval "$_paths_output"
-unset _paths_output
+eval $(get_feature_paths)
 check_feature_branch "$CURRENT_BRANCH" "$HAS_GIT" || exit 1

 # If paths-only mode, output paths and exit (support JSON + paths-only combined)
 if $PATHS_ONLY; then
    if $JSON_MODE; then
        # Minimal JSON paths payload (no validation performed)
-        if has_jq; then
-            jq -cn \
-                --arg repo_root "$REPO_ROOT" \
-                --arg branch "$CURRENT_BRANCH" \
-                --arg feature_dir "$FEATURE_DIR" \
-                --arg feature_spec "$FEATURE_SPEC" \
-                --arg impl_plan "$IMPL_PLAN" \
-                --arg tasks "$TASKS" \
-                '{REPO_ROOT:$repo_root,BRANCH:$branch,FEATURE_DIR:$feature_dir,FEATURE_SPEC:$feature_spec,IMPL_PLAN:$impl_plan,TASKS:$tasks}'
-        else
-            printf '{"REPO_ROOT":"%s","BRANCH":"%s","FEATURE_DIR":"%s","FEATURE_SPEC":"%s","IMPL_PLAN":"%s","TASKS":"%s"}\n' \
-                "$(json_escape "$REPO_ROOT")" "$(json_escape "$CURRENT_BRANCH")" "$(json_escape "$FEATURE_DIR")" "$(json_escape "$FEATURE_SPEC")" "$(json_escape "$IMPL_PLAN")" "$(json_escape "$TASKS")"
-        fi
+        printf '{"REPO_ROOT":"%s","BRANCH":"%s","FEATURE_DIR":"%s","FEATURE_SPEC":"%s","IMPL_PLAN":"%s","TASKS":"%s"}\n' \
+            "$REPO_ROOT" "$CURRENT_BRANCH" "$FEATURE_DIR" "$FEATURE_SPEC" "$IMPL_PLAN" "$TASKS"
    else
        echo "REPO_ROOT: $REPO_ROOT"
        echo "BRANCH: $CURRENT_BRANCH"
@@ -154,25 +141,14 @@ fi
 # Output results
 if $JSON_MODE; then
    # Build JSON array of documents
-    if has_jq; then
-        if [[ ${#docs[@]} -eq 0 ]]; then
-            json_docs="[]"
-        else
-            json_docs=$(printf '%s\n' "${docs[@]}" | jq -R . | jq -s .)
-        fi
-        jq -cn \
-            --arg feature_dir "$FEATURE_DIR" \
-            --argjson docs "$json_docs" \
-            '{FEATURE_DIR:$feature_dir,AVAILABLE_DOCS:$docs}'
+    if [[ ${#docs[@]} -eq 0 ]]; then
+        json_docs="[]"
    else
-        if [[ ${#docs[@]} -eq 0 ]]; then
-            json_docs="[]"
-        else
-            json_docs=$(for d in "${docs[@]}"; do printf '"%s",' "$(json_escape "$d")"; done)
-            json_docs="[${json_docs%,}]"
-        fi
-        printf '{"FEATURE_DIR":"%s","AVAILABLE_DOCS":%s}\n' "$(json_escape "$FEATURE_DIR")" "$json_docs"
+        json_docs=$(printf '"%s",' "${docs[@]}")
+        json_docs="[${json_docs%,}]"
    fi
+    
+    printf '{"FEATURE_DIR":"%s","AVAILABLE_DOCS":%s}\n' "$FEATURE_DIR" "$json_docs"
 else
    # Text output
    echo "FEATURE_DIR:$FEATURE_DIR"
--- a/scripts/bash/common.sh
+++ b/scripts/bash/common.sh
@@ -120,7 +120,7 @@ find_feature_dir_by_prefix() {
        # Multiple matches - this shouldn't happen with proper naming convention
        echo "ERROR: Multiple spec directories found with prefix '$prefix': ${matches[*]}" >&2
        echo "Please ensure only one spec directory exists per numeric prefix." >&2
-        return 1
+        echo "$specs_dir/$branch_name"  # Return something to avoid breaking the script
    fi
 }

@@ -134,46 +134,21 @@ get_feature_paths() {
    fi

    # Use prefix-based lookup to support multiple branches per spec
-    local feature_dir
-    if ! feature_dir=$(find_feature_dir_by_prefix "$repo_root" "$current_branch"); then
-        echo "ERROR: Failed to resolve feature directory" >&2
-        return 1
-    fi
+    local feature_dir=$(find_feature_dir_by_prefix "$repo_root" "$current_branch")

-    # Use printf '%q' to safely quote values, preventing shell injection
-    # via crafted branch names or paths containing special characters
-    printf 'REPO_ROOT=%q\n' "$repo_root"
-    printf 'CURRENT_BRANCH=%q\n' "$current_branch"
-    printf 'HAS_GIT=%q\n' "$has_git_repo"
-    printf 'FEATURE_DIR=%q\n' "$feature_dir"
-    printf 'FEATURE_SPEC=%q\n' "$feature_dir/spec.md"
-    printf 'IMPL_PLAN=%q\n' "$feature_dir/plan.md"
-    printf 'TASKS=%q\n' "$feature_dir/tasks.md"
-    printf 'RESEARCH=%q\n' "$feature_dir/research.md"
-    printf 'DATA_MODEL=%q\n' "$feature_dir/data-model.md"
-    printf 'QUICKSTART=%q\n' "$feature_dir/quickstart.md"
-    printf 'CONTRACTS_DIR=%q\n' "$feature_dir/contracts"
-}
-
-# Check if jq is available for safe JSON construction
-has_jq() {
-    command -v jq >/dev/null 2>&1
-}
-
-# Escape a string for safe embedding in a JSON value (fallback when jq is unavailable).
-# Handles backslash, double-quote, and JSON-required control character escapes (RFC 8259).
-json_escape() {
-    local s="$1"
-    s="${s//\\/\\\\}"
-    s="${s//\"/\\\"}"
-    s="${s//$'\n'/\\n}"
-    s="${s//$'\t'/\\t}"
-    s="${s//$'\r'/\\r}"
-    s="${s//$'\b'/\\b}"
-    s="${s//$'\f'/\\f}"
-    # Strip remaining control characters (U+0000–U+001F) not individually escaped above
-    s=$(printf '%s' "$s" | tr -d '\000-\007\013\016-\037')
-    printf '%s' "$s"
+    cat <<EOF
+REPO_ROOT='$repo_root'
+CURRENT_BRANCH='$current_branch'
+HAS_GIT='$has_git_repo'
+FEATURE_DIR='$feature_dir'
+FEATURE_SPEC='$feature_dir/spec.md'
+IMPL_PLAN='$feature_dir/plan.md'
+TASKS='$feature_dir/tasks.md'
+RESEARCH='$feature_dir/research.md'
+DATA_MODEL='$feature_dir/data-model.md'
+QUICKSTART='$feature_dir/quickstart.md'
+CONTRACTS_DIR='$feature_dir/contracts'
+EOF
 }

 check_file() { [[ -f "$1" ]] && echo "  ✓ $2" || echo "  ✗ $2"; }
@@ -198,11 +173,9 @@ resolve_template() {
    if [ -d "$presets_dir" ]; then
        local registry_file="$presets_dir/.registry"
        if [ -f "$registry_file" ] && command -v python3 >/dev/null 2>&1; then
-            # Read preset IDs sorted by priority (lower number = higher precedence).
-            # The python3 call is wrapped in an if-condition so that set -e does not
-            # abort the function when python3 exits non-zero (e.g. invalid JSON).
-            local sorted_presets=""
-            if sorted_presets=$(SPECKIT_REGISTRY="$registry_file" python3 -c "
+            # Read preset IDs sorted by priority (lower number = higher precedence)
+            local sorted_presets
+            sorted_presets=$(SPECKIT_REGISTRY="$registry_file" python3 -c "
 import json, sys, os
 try:
    with open(os.environ['SPECKIT_REGISTRY']) as f:
@@ -212,17 +185,14 @@ try:
        print(pid)
 except Exception:
    sys.exit(1)
-" 2>/dev/null); then
-                if [ -n "$sorted_presets" ]; then
-                    # python3 succeeded and returned preset IDs — search in priority order
-                    while IFS= read -r preset_id; do
-                        local candidate="$presets_dir/$preset_id/templates/${template_name}.md"
-                        [ -f "$candidate" ] && echo "$candidate" && return 0
-                    done <<< "$sorted_presets"
-                fi
-                # python3 succeeded but registry has no presets — nothing to search
+" 2>/dev/null)
+            if [ $? -eq 0 ] && [ -n "$sorted_presets" ]; then
+                while IFS= read -r preset_id; do
+                    local candidate="$presets_dir/$preset_id/templates/${template_name}.md"
+                    [ -f "$candidate" ] && echo "$candidate" && return 0
+                done <<< "$sorted_presets"
            else
-                # python3 failed (missing, or registry parse error) — fall back to unordered directory scan
+                # python3 returned empty list — fall through to directory scan
                for preset in "$presets_dir"/*/; do
                    [ -d "$preset" ] || continue
                    local candidate="$preset/templates/${template_name}.md"
@@ -255,9 +225,6 @@ except Exception:
    local core="$base/${template_name}.md"
    [ -f "$core" ] && echo "$core" && return 0

-    # Template not found in any location.
-    # Return 1 so callers can distinguish "not found" from "found".
-    # Callers running under set -e should use: TEMPLATE=$(resolve_template ...) || true
    return 1
 }

--- a/scripts/bash/create-new-feature.sh
+++ b/scripts/bash/create-new-feature.sh
@@ -138,7 +138,7 @@ check_existing_branches() {
    local specs_dir="$1"

    # Fetch all remotes to get latest branch info (suppress errors if no remotes)
-    git fetch --all --prune >/dev/null 2>&1 || true
+    git fetch --all --prune 2>/dev/null || true

    # Get highest number from ALL branches (not just matching short name)
    local highest_branch=$(get_highest_from_branches)
@@ -297,31 +297,18 @@ fi
 FEATURE_DIR="$SPECS_DIR/$BRANCH_NAME"
 mkdir -p "$FEATURE_DIR"

-TEMPLATE=$(resolve_template "spec-template" "$REPO_ROOT") || true
+TEMPLATE=$(resolve_template "spec-template" "$REPO_ROOT")
 SPEC_FILE="$FEATURE_DIR/spec.md"
-if [ -n "$TEMPLATE" ] && [ -f "$TEMPLATE" ]; then
-    cp "$TEMPLATE" "$SPEC_FILE"
-else
-    echo "Warning: Spec template not found; created empty spec file" >&2
-    touch "$SPEC_FILE"
-fi
+if [ -n "$TEMPLATE" ] && [ -f "$TEMPLATE" ]; then cp "$TEMPLATE" "$SPEC_FILE"; else touch "$SPEC_FILE"; fi

-# Inform the user how to persist the feature variable in their own shell
-printf '# To persist: export SPECIFY_FEATURE=%q\n' "$BRANCH_NAME" >&2
+# Set the SPECIFY_FEATURE environment variable for the current session
+export SPECIFY_FEATURE="$BRANCH_NAME"

 if $JSON_MODE; then
-    if command -v jq >/dev/null 2>&1; then
-        jq -cn \
-            --arg branch_name "$BRANCH_NAME" \
-            --arg spec_file "$SPEC_FILE" \
-            --arg feature_num "$FEATURE_NUM" \
-            '{BRANCH_NAME:$branch_name,SPEC_FILE:$spec_file,FEATURE_NUM:$feature_num}'
-    else
-        printf '{"BRANCH_NAME":"%s","SPEC_FILE":"%s","FEATURE_NUM":"%s"}\n' "$(json_escape "$BRANCH_NAME")" "$(json_escape "$SPEC_FILE")" "$(json_escape "$FEATURE_NUM")"
-    fi
+    printf '{"BRANCH_NAME":"%s","SPEC_FILE":"%s","FEATURE_NUM":"%s"}\n' "$BRANCH_NAME" "$SPEC_FILE" "$FEATURE_NUM"
 else
    echo "BRANCH_NAME: $BRANCH_NAME"
    echo "SPEC_FILE: $SPEC_FILE"
    echo "FEATURE_NUM: $FEATURE_NUM"
-    printf '# To persist in your shell: export SPECIFY_FEATURE=%q\n' "$BRANCH_NAME"
+    echo "SPECIFY_FEATURE environment variable set to: $BRANCH_NAME"
 fi
--- a/scripts/bash/setup-plan.sh
+++ b/scripts/bash/setup-plan.sh
@@ -28,9 +28,7 @@ SCRIPT_DIR="$(CDPATH="" cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 source "$SCRIPT_DIR/common.sh"

 # Get all paths and variables from common functions
-_paths_output=$(get_feature_paths) || { echo "ERROR: Failed to resolve feature paths" >&2; exit 1; }
-eval "$_paths_output"
-unset _paths_output
+eval $(get_feature_paths)

 # Check if we're on a proper feature branch (only for git repos)
 check_feature_branch "$CURRENT_BRANCH" "$HAS_GIT" || exit 1
@@ -39,7 +37,7 @@ check_feature_branch "$CURRENT_BRANCH" "$HAS_GIT" || exit 1
 mkdir -p "$FEATURE_DIR"

 # Copy plan template if it exists
-TEMPLATE=$(resolve_template "plan-template" "$REPO_ROOT") || true
+TEMPLATE=$(resolve_template "plan-template" "$REPO_ROOT")
 if [[ -n "$TEMPLATE" ]] && [[ -f "$TEMPLATE" ]]; then
    cp "$TEMPLATE" "$IMPL_PLAN"
    echo "Copied plan template to $IMPL_PLAN"
@@ -51,18 +49,8 @@ fi

 # Output results
 if $JSON_MODE; then
-    if has_jq; then
-        jq -cn \
-            --arg feature_spec "$FEATURE_SPEC" \
-            --arg impl_plan "$IMPL_PLAN" \
-            --arg specs_dir "$FEATURE_DIR" \
-            --arg branch "$CURRENT_BRANCH" \
-            --arg has_git "$HAS_GIT" \
-            '{FEATURE_SPEC:$feature_spec,IMPL_PLAN:$impl_plan,SPECS_DIR:$specs_dir,BRANCH:$branch,HAS_GIT:$has_git}'
-    else
-        printf '{"FEATURE_SPEC":"%s","IMPL_PLAN":"%s","SPECS_DIR":"%s","BRANCH":"%s","HAS_GIT":"%s"}\n' \
-            "$(json_escape "$FEATURE_SPEC")" "$(json_escape "$IMPL_PLAN")" "$(json_escape "$FEATURE_DIR")" "$(json_escape "$CURRENT_BRANCH")" "$(json_escape "$HAS_GIT")"
-    fi
+    printf '{"FEATURE_SPEC":"%s","IMPL_PLAN":"%s","SPECS_DIR":"%s","BRANCH":"%s","HAS_GIT":"%s"}\n' \
+        "$FEATURE_SPEC" "$IMPL_PLAN" "$FEATURE_DIR" "$CURRENT_BRANCH" "$HAS_GIT"
 else
    echo "FEATURE_SPEC: $FEATURE_SPEC"
    echo "IMPL_PLAN: $IMPL_PLAN" 
--- a/scripts/bash/update-agent-context.sh
+++ b/scripts/bash/update-agent-context.sh
@@ -30,12 +30,12 @@
 #
 # 5. Multi-Agent Support
 #    - Handles agent-specific file paths and naming conventions
-#    - Supports: Claude, Gemini, Copilot, Cursor, Qwen, opencode, Codex, Windsurf, Kilo Code, Auggie CLI, Roo Code, CodeBuddy CLI, Qoder CLI, Amp, SHAI, Tabnine CLI, Kiro CLI, Mistral Vibe, Kimi Code, Antigravity or Generic
+#    - Supports: Claude, Gemini, Copilot, Cursor, Qwen, opencode, Codex, Windsurf, Kilo Code, Auggie CLI, Roo Code, CodeBuddy CLI, Qoder CLI, Amp, SHAI, Tabnine CLI, Kiro CLI, Mistral Vibe, Antigravity or Generic
 #    - Can update single agents or all existing agent files
 #    - Creates default Claude file if no agent files exist
 #
 # Usage: ./update-agent-context.sh [agent_type]
-# Agent types: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|trae|generic
+# Agent types: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|generic
 # Leave empty to update all existing agent files

 set -e
@@ -53,9 +53,7 @@ SCRIPT_DIR="$(CDPATH="" cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 source "$SCRIPT_DIR/common.sh"

 # Get all paths and variables from common functions
-_paths_output=$(get_feature_paths) || { echo "ERROR: Failed to resolve feature paths" >&2; exit 1; }
-eval "$_paths_output"
-unset _paths_output
+eval $(get_feature_paths)

 NEW_PLAN="$IMPL_PLAN"  # Alias for compatibility with existing code
 AGENT_TYPE="${1:-}"
@@ -73,17 +71,13 @@ AUGGIE_FILE="$REPO_ROOT/.augment/rules/specify-rules.md"
 ROO_FILE="$REPO_ROOT/.roo/rules/specify-rules.md"
 CODEBUDDY_FILE="$REPO_ROOT/CODEBUDDY.md"
 QODER_FILE="$REPO_ROOT/QODER.md"
-# AMP, Kiro CLI, and IBM Bob all share AGENTS.md — use AGENTS_FILE to avoid
-# updating the same file multiple times.
-AMP_FILE="$AGENTS_FILE"
+AMP_FILE="$REPO_ROOT/AGENTS.md"
 SHAI_FILE="$REPO_ROOT/SHAI.md"
 TABNINE_FILE="$REPO_ROOT/TABNINE.md"
-KIRO_FILE="$AGENTS_FILE"
+KIRO_FILE="$REPO_ROOT/AGENTS.md"
 AGY_FILE="$REPO_ROOT/.agent/rules/specify-rules.md"
-BOB_FILE="$AGENTS_FILE"
+BOB_FILE="$REPO_ROOT/AGENTS.md"
 VIBE_FILE="$REPO_ROOT/.vibe/agents/specify-agents.md"
-KIMI_FILE="$REPO_ROOT/KIMI.md"
-TRAE_FILE="$REPO_ROOT/.trae/rules/AGENTS.md"

 # Template file
 TEMPLATE_FILE="$REPO_ROOT/.specify/templates/agent-file-template.md"
@@ -117,8 +111,6 @@ log_warning() {
 # Cleanup function for temporary files
 cleanup() {
    local exit_code=$?
-    # Disarm traps to prevent re-entrant loop
-    trap - EXIT INT TERM
    rm -f /tmp/agent_update_*_$$
    rm -f /tmp/manual_additions_$$
    exit $exit_code
@@ -483,7 +475,7 @@ update_existing_agent_file() {
        fi
        
        # Update timestamp
-        if [[ "$line" =~ (\*\*)?Last\ updated(\*\*)?:.*[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9] ]]; then
+        if [[ "$line" =~ \*\*Last\ updated\*\*:.*[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9] ]]; then
            echo "$line" | sed "s/[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]/$current_date/" >> "$temp_file"
        else
            echo "$line" >> "$temp_file"
@@ -614,144 +606,174 @@ update_specific_agent() {
    
    case "$agent_type" in
        claude)
-            update_agent_file "$CLAUDE_FILE" "Claude Code" || return 1
+            update_agent_file "$CLAUDE_FILE" "Claude Code"
            ;;
        gemini)
-            update_agent_file "$GEMINI_FILE" "Gemini CLI" || return 1
+            update_agent_file "$GEMINI_FILE" "Gemini CLI"
            ;;
        copilot)
-            update_agent_file "$COPILOT_FILE" "GitHub Copilot" || return 1
+            update_agent_file "$COPILOT_FILE" "GitHub Copilot"
            ;;
        cursor-agent)
-            update_agent_file "$CURSOR_FILE" "Cursor IDE" || return 1
+            update_agent_file "$CURSOR_FILE" "Cursor IDE"
            ;;
        qwen)
-            update_agent_file "$QWEN_FILE" "Qwen Code" || return 1
+            update_agent_file "$QWEN_FILE" "Qwen Code"
            ;;
        opencode)
-            update_agent_file "$AGENTS_FILE" "opencode" || return 1
+            update_agent_file "$AGENTS_FILE" "opencode"
            ;;
        codex)
-            update_agent_file "$AGENTS_FILE" "Codex CLI" || return 1
+            update_agent_file "$AGENTS_FILE" "Codex CLI"
            ;;
        windsurf)
-            update_agent_file "$WINDSURF_FILE" "Windsurf" || return 1
+            update_agent_file "$WINDSURF_FILE" "Windsurf"
            ;;
        kilocode)
-            update_agent_file "$KILOCODE_FILE" "Kilo Code" || return 1
+            update_agent_file "$KILOCODE_FILE" "Kilo Code"
            ;;
        auggie)
-            update_agent_file "$AUGGIE_FILE" "Auggie CLI" || return 1
+            update_agent_file "$AUGGIE_FILE" "Auggie CLI"
            ;;
        roo)
-            update_agent_file "$ROO_FILE" "Roo Code" || return 1
+            update_agent_file "$ROO_FILE" "Roo Code"
            ;;
        codebuddy)
-            update_agent_file "$CODEBUDDY_FILE" "CodeBuddy CLI" || return 1
+            update_agent_file "$CODEBUDDY_FILE" "CodeBuddy CLI"
            ;;
        qodercli)
-            update_agent_file "$QODER_FILE" "Qoder CLI" || return 1
+            update_agent_file "$QODER_FILE" "Qoder CLI"
            ;;
        amp)
-            update_agent_file "$AMP_FILE" "Amp" || return 1
+            update_agent_file "$AMP_FILE" "Amp"
            ;;
        shai)
-            update_agent_file "$SHAI_FILE" "SHAI" || return 1
+            update_agent_file "$SHAI_FILE" "SHAI"
            ;;
        tabnine)
-            update_agent_file "$TABNINE_FILE" "Tabnine CLI" || return 1
+            update_agent_file "$TABNINE_FILE" "Tabnine CLI"
            ;;
        kiro-cli)
-            update_agent_file "$KIRO_FILE" "Kiro CLI" || return 1
+            update_agent_file "$KIRO_FILE" "Kiro CLI"
            ;;
        agy)
-            update_agent_file "$AGY_FILE" "Antigravity" || return 1
+            update_agent_file "$AGY_FILE" "Antigravity"
            ;;
        bob)
-            update_agent_file "$BOB_FILE" "IBM Bob" || return 1
+            update_agent_file "$BOB_FILE" "IBM Bob"
            ;;
        vibe)
-            update_agent_file "$VIBE_FILE" "Mistral Vibe" || return 1
-            ;;
-        kimi)
-            update_agent_file "$KIMI_FILE" "Kimi Code" || return 1
-            ;;
-        trae)
-            update_agent_file "$TRAE_FILE" "Trae" || return 1
+            update_agent_file "$VIBE_FILE" "Mistral Vibe"
            ;;
        generic)
            log_info "Generic agent: no predefined context file. Use the agent-specific update script for your agent."
            ;;
        *)
            log_error "Unknown agent type '$agent_type'"
-            log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|trae|generic"
+            log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|generic"
            exit 1
            ;;
    esac
 }

-# Helper: skip non-existent files and files already updated (dedup by
-# realpath so that variables pointing to the same file — e.g. AMP_FILE,
-# KIRO_FILE, BOB_FILE all resolving to AGENTS_FILE — are only written once).
-# Uses a linear array instead of associative array for bash 3.2 compatibility.
-# Note: defined at top level because bash 3.2 does not support true
-# nested/local functions. _updated_paths, _found_agent, and _all_ok are
-# initialised exclusively inside update_all_existing_agents so that
-# sourcing this script has no side effects on the caller's environment.
-
-_update_if_new() {
-    local file="$1" name="$2"
-    [[ -f "$file" ]] || return 0
-    local real_path
-    real_path=$(realpath "$file" 2>/dev/null || echo "$file")
-    local p
-    if [[ ${#_updated_paths[@]} -gt 0 ]]; then
-        for p in "${_updated_paths[@]}"; do
-            [[ "$p" == "$real_path" ]] && return 0
-        done
-    fi
-    # Record the file as seen before attempting the update so that:
-    # (a) aliases pointing to the same path are not retried on failure
-    # (b) _found_agent reflects file existence, not update success
-    _updated_paths+=("$real_path")
-    _found_agent=true
-    update_agent_file "$file" "$name"
-}
-
 update_all_existing_agents() {
-    _found_agent=false
-    _updated_paths=()
-    local _all_ok=true
-
-    _update_if_new "$CLAUDE_FILE" "Claude Code"           || _all_ok=false
-    _update_if_new "$GEMINI_FILE" "Gemini CLI"             || _all_ok=false
-    _update_if_new "$COPILOT_FILE" "GitHub Copilot"        || _all_ok=false
-    _update_if_new "$CURSOR_FILE" "Cursor IDE"             || _all_ok=false
-    _update_if_new "$QWEN_FILE" "Qwen Code"                || _all_ok=false
-    _update_if_new "$AGENTS_FILE" "Codex/opencode"         || _all_ok=false
-    _update_if_new "$AMP_FILE" "Amp"                       || _all_ok=false
-    _update_if_new "$KIRO_FILE" "Kiro CLI"                 || _all_ok=false
-    _update_if_new "$BOB_FILE" "IBM Bob"                   || _all_ok=false
-    _update_if_new "$WINDSURF_FILE" "Windsurf"             || _all_ok=false
-    _update_if_new "$KILOCODE_FILE" "Kilo Code"            || _all_ok=false
-    _update_if_new "$AUGGIE_FILE" "Auggie CLI"             || _all_ok=false
-    _update_if_new "$ROO_FILE" "Roo Code"                  || _all_ok=false
-    _update_if_new "$CODEBUDDY_FILE" "CodeBuddy CLI"       || _all_ok=false
-    _update_if_new "$SHAI_FILE" "SHAI"                     || _all_ok=false
-    _update_if_new "$TABNINE_FILE" "Tabnine CLI"           || _all_ok=false
-    _update_if_new "$QODER_FILE" "Qoder CLI"               || _all_ok=false
-    _update_if_new "$AGY_FILE" "Antigravity"               || _all_ok=false
-    _update_if_new "$VIBE_FILE" "Mistral Vibe"             || _all_ok=false
-    _update_if_new "$KIMI_FILE" "Kimi Code"                || _all_ok=false
-    _update_if_new "$TRAE_FILE" "Trae"                     || _all_ok=false
-
-    # If no agent files exist, create a default Claude file
-    if [[ "$_found_agent" == false ]]; then
-        log_info "No existing agent files found, creating default Claude file..."
-        update_agent_file "$CLAUDE_FILE" "Claude Code" || return 1
+    local found_agent=false
+    
+    # Check each possible agent file and update if it exists
+    if [[ -f "$CLAUDE_FILE" ]]; then
+        update_agent_file "$CLAUDE_FILE" "Claude Code"
+        found_agent=true
+    fi
+    
+    if [[ -f "$GEMINI_FILE" ]]; then
+        update_agent_file "$GEMINI_FILE" "Gemini CLI"
+        found_agent=true
+    fi
+    
+    if [[ -f "$COPILOT_FILE" ]]; then
+        update_agent_file "$COPILOT_FILE" "GitHub Copilot"
+        found_agent=true
+    fi
+    
+    if [[ -f "$CURSOR_FILE" ]]; then
+        update_agent_file "$CURSOR_FILE" "Cursor IDE"
+        found_agent=true
+    fi
+    
+    if [[ -f "$QWEN_FILE" ]]; then
+        update_agent_file "$QWEN_FILE" "Qwen Code"
+        found_agent=true
+    fi
+    
+    if [[ -f "$AGENTS_FILE" ]]; then
+        update_agent_file "$AGENTS_FILE" "Codex/opencode"
+        found_agent=true
+    fi
+    
+    if [[ -f "$WINDSURF_FILE" ]]; then
+        update_agent_file "$WINDSURF_FILE" "Windsurf"
+        found_agent=true
+    fi
+    
+    if [[ -f "$KILOCODE_FILE" ]]; then
+        update_agent_file "$KILOCODE_FILE" "Kilo Code"
+        found_agent=true
    fi

-    [[ "$_all_ok" == true ]]
+    if [[ -f "$AUGGIE_FILE" ]]; then
+        update_agent_file "$AUGGIE_FILE" "Auggie CLI"
+        found_agent=true
+    fi
+    
+    if [[ -f "$ROO_FILE" ]]; then
+        update_agent_file "$ROO_FILE" "Roo Code"
+        found_agent=true
+    fi
+
+    if [[ -f "$CODEBUDDY_FILE" ]]; then
+        update_agent_file "$CODEBUDDY_FILE" "CodeBuddy CLI"
+        found_agent=true
+    fi
+
+    if [[ -f "$SHAI_FILE" ]]; then
+        update_agent_file "$SHAI_FILE" "SHAI"
+        found_agent=true
+    fi
+
+    if [[ -f "$TABNINE_FILE" ]]; then
+        update_agent_file "$TABNINE_FILE" "Tabnine CLI"
+        found_agent=true
+    fi
+
+    if [[ -f "$QODER_FILE" ]]; then
+        update_agent_file "$QODER_FILE" "Qoder CLI"
+        found_agent=true
+    fi
+
+    if [[ -f "$KIRO_FILE" ]]; then
+        update_agent_file "$KIRO_FILE" "Kiro CLI"
+        found_agent=true
+    fi
+
+    if [[ -f "$AGY_FILE" ]]; then
+        update_agent_file "$AGY_FILE" "Antigravity"
+        found_agent=true
+    fi
+    if [[ -f "$BOB_FILE" ]]; then
+        update_agent_file "$BOB_FILE" "IBM Bob"
+        found_agent=true
+    fi
+
+    if [[ -f "$VIBE_FILE" ]]; then
+        update_agent_file "$VIBE_FILE" "Mistral Vibe"
+        found_agent=true
+    fi
+    
+    # If no agent files exist, create a default Claude file
+    if [[ "$found_agent" == false ]]; then
+        log_info "No existing agent files found, creating default Claude file..."
+        update_agent_file "$CLAUDE_FILE" "Claude Code"
+    fi
 }
 print_summary() {
    echo
@@ -770,7 +792,7 @@ print_summary() {
    fi
    
    echo
-    log_info "Usage: $0 [claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|trae|generic]"
+    log_info "Usage: $0 [claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|generic]"
 }

 #==============================================================================
--- a/scripts/powershell/common.ps1
+++ b/scripts/powershell/common.ps1
@@ -163,7 +163,7 @@ function Resolve-Template {
                $presets = $registryData.presets
                if ($presets) {
                    $sortedPresets = $presets.PSObject.Properties |
-                        Sort-Object { if ($null -ne $_.Value.priority) { $_.Value.priority } else { 10 } } |
+                        Sort-Object { if ($_.Value.priority) { $_.Value.priority } else { 10 } } |
                        ForEach-Object { $_.Name }
                }
            } catch {
--- a/scripts/powershell/create-new-feature.ps1
+++ b/scripts/powershell/create-new-feature.ps1
@@ -253,7 +253,7 @@ if ($branchName.Length -gt $maxBranchLength) {
 if ($hasGit) {
    $branchCreated = $false
    try {
-        git checkout -q -b $branchName 2>$null | Out-Null
+        git checkout -b $branchName 2>$null | Out-Null
        if ($LASTEXITCODE -eq 0) {
            $branchCreated = $true
        }
--- a/scripts/powershell/update-agent-context.ps1
+++ b/scripts/powershell/update-agent-context.ps1
@@ -9,7 +9,7 @@ Mirrors the behavior of scripts/bash/update-agent-context.sh:
 2. Plan Data Extraction
 3. Agent File Management (create from template or update existing)
 4. Content Generation (technology stack, recent changes, timestamp)
- 5. Multi-Agent Support (claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, roo, codebuddy, amp, shai, tabnine, kiro-cli, agy, bob, vibe, qodercli, kimi, trae, generic)
+ 5. Multi-Agent Support (claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, roo, codebuddy, amp, shai, tabnine, kiro-cli, agy, bob, vibe, qodercli, generic)

 .PARAMETER AgentType
 Optional agent key to update a single agent. If omitted, updates all existing agent files (creating a default Claude file if none exist).
@@ -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','shai','tabnine','kiro-cli','agy','bob','qodercli','vibe','kimi','trae','generic')]
+    [ValidateSet('claude','gemini','copilot','cursor-agent','qwen','opencode','codex','windsurf','kilocode','auggie','roo','codebuddy','amp','shai','tabnine','kiro-cli','agy','bob','qodercli','vibe','generic')]
    [string]$AgentType
 )

@@ -63,8 +63,6 @@ $KIRO_FILE     = Join-Path $REPO_ROOT 'AGENTS.md'
 $AGY_FILE      = Join-Path $REPO_ROOT '.agent/rules/specify-rules.md'
 $BOB_FILE      = Join-Path $REPO_ROOT 'AGENTS.md'
 $VIBE_FILE     = Join-Path $REPO_ROOT '.vibe/agents/specify-agents.md'
-$KIMI_FILE     = Join-Path $REPO_ROOT 'KIMI.md'
-$TRAE_FILE     = Join-Path $REPO_ROOT '.trae/rules/AGENTS.md'

 $TEMPLATE_FILE = Join-Path $REPO_ROOT '.specify/templates/agent-file-template.md'

@@ -332,7 +330,7 @@ function Update-ExistingAgentFile {
            if ($existingChanges -lt 2) { $output.Add($line); $existingChanges++ }
            continue
        }
-        if ($line -match '(\*\*)?Last updated(\*\*)?: .*\d{4}-\d{2}-\d{2}') {
+        if ($line -match '\*\*Last updated\*\*: .*\d{4}-\d{2}-\d{2}') {
            $output.Add(($line -replace '\d{4}-\d{2}-\d{2}',$Date.ToString('yyyy-MM-dd')))
            continue
        }
@@ -408,10 +406,8 @@ function Update-SpecificAgent {
        'agy'      { Update-AgentFile -TargetFile $AGY_FILE      -AgentName 'Antigravity' }
        'bob'      { Update-AgentFile -TargetFile $BOB_FILE      -AgentName 'IBM Bob' }
        'vibe'     { Update-AgentFile -TargetFile $VIBE_FILE     -AgentName 'Mistral Vibe' }
-        'kimi'     { Update-AgentFile -TargetFile $KIMI_FILE     -AgentName 'Kimi Code' }
-        'trae'     { Update-AgentFile -TargetFile $TRAE_FILE     -AgentName 'Trae' }
        'generic'  { Write-Info 'Generic agent: no predefined context file. Use the agent-specific update script for your agent.' }
-        default { Write-Err "Unknown agent type '$Type'"; Write-Err 'Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|trae|generic'; 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|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|generic'; return $false }
    }
 }

@@ -436,8 +432,6 @@ function Update-AllExistingAgents {
    if (Test-Path $AGY_FILE)      { if (-not (Update-AgentFile -TargetFile $AGY_FILE      -AgentName 'Antigravity')) { $ok = $false }; $found = $true }
    if (Test-Path $BOB_FILE)      { if (-not (Update-AgentFile -TargetFile $BOB_FILE      -AgentName 'IBM Bob')) { $ok = $false }; $found = $true }
    if (Test-Path $VIBE_FILE)     { if (-not (Update-AgentFile -TargetFile $VIBE_FILE     -AgentName 'Mistral Vibe')) { $ok = $false }; $found = $true }
-    if (Test-Path $KIMI_FILE)     { if (-not (Update-AgentFile -TargetFile $KIMI_FILE     -AgentName 'Kimi Code')) { $ok = $false }; $found = $true }
-    if (Test-Path $TRAE_FILE)     { if (-not (Update-AgentFile -TargetFile $TRAE_FILE     -AgentName 'Trae')) { $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 }
--- a/src/specify_cli/init.py
+++ b/src/specify_cli/init.py
--- a/src/specify_cli/agents.py
+++ b/src/specify_cli/agents.py
@@ -48,9 +48,9 @@ class CommandRegistrar:
        },
        "qwen": {
            "dir": ".qwen/commands",
-            "format": "markdown",
-            "args": "$ARGUMENTS",
-            "extension": ".md"
+            "format": "toml",
+            "args": "{{args}}",
+            "extension": ".toml"
        },
        "opencode": {
            "dir": ".opencode/command",
@@ -71,19 +71,19 @@ class CommandRegistrar:
            "extension": ".md"
        },
        "kilocode": {
-            "dir": ".kilocode/workflows",
+            "dir": ".kilocode/rules",
            "format": "markdown",
            "args": "$ARGUMENTS",
            "extension": ".md"
        },
        "auggie": {
-            "dir": ".augment/commands",
+            "dir": ".augment/rules",
            "format": "markdown",
            "args": "$ARGUMENTS",
            "extension": ".md"
        },
        "roo": {
-            "dir": ".roo/commands",
+            "dir": ".roo/rules",
            "format": "markdown",
            "args": "$ARGUMENTS",
            "extension": ".md"
@@ -129,18 +129,6 @@ class CommandRegistrar:
            "format": "markdown",
            "args": "$ARGUMENTS",
            "extension": ".md"
-        },
-        "kimi": {
-            "dir": ".kimi/skills",
-            "format": "markdown",
-            "args": "$ARGUMENTS",
-            "extension": "/SKILL.md"
-        },
-        "trae": {
-            "dir": ".trae/rules",
-            "format": "markdown",
-            "args": "$ARGUMENTS",
-            "extension": ".md"
        }
    }

@@ -330,7 +318,6 @@ class CommandRegistrar:
                raise ValueError(f"Unsupported format: {agent_config['format']}")

            dest_file = commands_dir / f"{cmd_name}{agent_config['extension']}"
-            dest_file.parent.mkdir(parents=True, exist_ok=True)
            dest_file.write_text(output, encoding="utf-8")

            if agent_name == "copilot":
@@ -340,7 +327,6 @@ class CommandRegistrar:

            for alias in cmd_info.get("aliases", []):
                alias_file = commands_dir / f"{alias}{agent_config['extension']}"
-                alias_file.parent.mkdir(parents=True, exist_ok=True)
                alias_file.write_text(output, encoding="utf-8")
                if agent_name == "copilot":
                    self.write_copilot_prompt(project_root, alias)
--- a/src/specify_cli/extensions.py
+++ b/src/specify_cli/extensions.py
@@ -12,7 +12,6 @@ import os
 import tempfile
 import zipfile
 import shutil
-import copy
 from dataclasses import dataclass
 from pathlib import Path
 from typing import Optional, Dict, List, Any, Callable, Set
@@ -41,26 +40,6 @@ class CompatibilityError(ExtensionError):
    pass


-def normalize_priority(value: Any, default: int = 10) -> int:
-    """Normalize a stored priority value for sorting and display.
-
-    Corrupted registry data may contain missing, non-numeric, or non-positive
-    values. In those cases, fall back to the default priority.
-
-    Args:
-        value: Priority value to normalize (may be int, str, None, etc.)
-        default: Default priority to use for invalid values (default: 10)
-
-    Returns:
-        Normalized priority as positive integer (>= 1)
-    """
-    try:
-        priority = int(value)
-    except (TypeError, ValueError):
-        return default
-    return priority if priority >= 1 else default
-
-
@dataclass
 class CatalogEntry:
    """Represents a single catalog entry in the catalog stack."""
@@ -249,57 +228,6 @@ class ExtensionRegistry:
        }
        self._save()

-    def update(self, extension_id: str, metadata: dict):
-        """Update extension metadata in registry, merging with existing entry.
-
-        Merges the provided metadata with the existing entry, preserving any
-        fields not specified in the new metadata. The installed_at timestamp
-        is always preserved from the original entry.
-
-        Use this method instead of add() when updating existing extension
-        metadata (e.g., enabling/disabling) to preserve the original
-        installation timestamp and other existing fields.
-
-        Args:
-            extension_id: Extension ID
-            metadata: Extension metadata fields to update (merged with existing)
-
-        Raises:
-            KeyError: If extension is not installed
-        """
-        if extension_id not in self.data["extensions"]:
-            raise KeyError(f"Extension '{extension_id}' is not installed")
-        # Merge new metadata with existing, preserving original installed_at
-        existing = self.data["extensions"][extension_id]
-        # Handle corrupted registry entries (e.g., string/list instead of dict)
-        if not isinstance(existing, dict):
-            existing = {}
-        # Merge: existing fields preserved, new fields override
-        merged = {**existing, **metadata}
-        # Always preserve original installed_at based on key existence, not truthiness,
-        # to handle cases where the field exists but may be falsy (legacy/corruption)
-        if "installed_at" in existing:
-            merged["installed_at"] = existing["installed_at"]
-        else:
-            # If not present in existing, explicitly remove from merged if caller provided it
-            merged.pop("installed_at", None)
-        self.data["extensions"][extension_id] = merged
-        self._save()
-
-    def restore(self, extension_id: str, metadata: dict):
-        """Restore extension metadata to registry without modifying timestamps.
-
-        Use this method for rollback scenarios where you have a complete backup
-        of the registry entry (including installed_at) and want to restore it
-        exactly as it was.
-
-        Args:
-            extension_id: Extension ID
-            metadata: Complete extension metadata including installed_at
-        """
-        self.data["extensions"][extension_id] = dict(metadata)
-        self._save()
-
    def remove(self, extension_id: str):
        """Remove extension from registry.

@@ -313,28 +241,21 @@ class ExtensionRegistry:
    def get(self, extension_id: str) -> Optional[dict]:
        """Get extension metadata from registry.

-        Returns a deep copy to prevent callers from accidentally mutating
-        nested internal registry state without going through the write path.
-
        Args:
            extension_id: Extension ID

        Returns:
-            Deep copy of extension metadata, or None if not found
+            Extension metadata or None if not found
        """
-        entry = self.data["extensions"].get(extension_id)
-        return copy.deepcopy(entry) if entry is not None else None
+        return self.data["extensions"].get(extension_id)

    def list(self) -> Dict[str, dict]:
        """Get all installed extensions.

-        Returns a deep copy of the extensions mapping to prevent callers
-        from accidentally mutating nested internal registry state.
-
        Returns:
-            Dictionary of extension_id -> metadata (deep copies)
+            Dictionary of extension_id -> metadata
        """
-        return copy.deepcopy(self.data["extensions"])
+        return self.data["extensions"]

    def is_installed(self, extension_id: str) -> bool:
        """Check if extension is installed.
@@ -347,32 +268,6 @@ class ExtensionRegistry:
        """
        return extension_id in self.data["extensions"]

-    def list_by_priority(self) -> List[tuple]:
-        """Get all installed extensions sorted by priority.
-
-        Lower priority number = higher precedence (checked first).
-        Extensions with equal priority are sorted alphabetically by ID
-        for deterministic ordering.
-
-        Returns:
-            List of (extension_id, metadata_copy) tuples sorted by priority.
-            Metadata is deep-copied to prevent accidental mutation.
-        """
-        extensions = self.data.get("extensions", {}) or {}
-        if not isinstance(extensions, dict):
-            extensions = {}
-        sortable_extensions = []
-        for ext_id, meta in extensions.items():
-            if not isinstance(meta, dict):
-                continue
-            metadata_copy = copy.deepcopy(meta)
-            metadata_copy["priority"] = normalize_priority(metadata_copy.get("priority", 10))
-            sortable_extensions.append((ext_id, metadata_copy))
-        return sorted(
-            sortable_extensions,
-            key=lambda item: (item[1]["priority"], item[0]),
-        )
-

 class ExtensionManager:
    """Manages extension lifecycle: installation, removal, updates."""
@@ -489,8 +384,7 @@ class ExtensionManager:
        self,
        source_dir: Path,
        speckit_version: str,
-        register_commands: bool = True,
-        priority: int = 10,
+        register_commands: bool = True
    ) -> ExtensionManifest:
        """Install extension from a local directory.

@@ -498,19 +392,14 @@ class ExtensionManager:
            source_dir: Path to extension directory
            speckit_version: Current spec-kit version
            register_commands: If True, register commands with AI agents
-            priority: Resolution priority (lower = higher precedence, default 10)

        Returns:
            Installed extension manifest

        Raises:
-            ValidationError: If manifest is invalid or priority is invalid
+            ValidationError: If manifest is invalid
            CompatibilityError: If extension is incompatible
        """
-        # Validate priority
-        if priority < 1:
-            raise ValidationError("Priority must be a positive integer (1 or higher)")
-
        # Load and validate manifest
        manifest_path = source_dir / "extension.yml"
        manifest = ExtensionManifest(manifest_path)
@@ -552,7 +441,6 @@ class ExtensionManager:
            "source": "local",
            "manifest_hash": manifest.get_hash(),
            "enabled": True,
-            "priority": priority,
            "registered_commands": registered_commands
        })

@@ -561,27 +449,21 @@ class ExtensionManager:
    def install_from_zip(
        self,
        zip_path: Path,
-        speckit_version: str,
-        priority: int = 10,
+        speckit_version: str
    ) -> ExtensionManifest:
        """Install extension from ZIP file.

        Args:
            zip_path: Path to extension ZIP file
            speckit_version: Current spec-kit version
-            priority: Resolution priority (lower = higher precedence, default 10)

        Returns:
            Installed extension manifest

        Raises:
-            ValidationError: If manifest is invalid or priority is invalid
+            ValidationError: If manifest is invalid
            CompatibilityError: If extension is incompatible
        """
-        # Validate priority early
-        if priority < 1:
-            raise ValidationError("Priority must be a positive integer (1 or higher)")
-
        with tempfile.TemporaryDirectory() as tmpdir:
            temp_path = Path(tmpdir)

@@ -616,7 +498,7 @@ class ExtensionManager:
                raise ValidationError("No extension.yml found in ZIP file")

            # Install from extracted directory
-            return self.install_from_directory(extension_dir, speckit_version, priority=priority)
+            return self.install_from_directory(extension_dir, speckit_version)

    def remove(self, extension_id: str, keep_config: bool = False) -> bool:
        """Remove an installed extension.
@@ -694,9 +576,6 @@ class ExtensionManager:
        result = []

        for ext_id, metadata in self.registry.list().items():
-            # Ensure metadata is a dictionary to avoid AttributeError when using .get()
-            if not isinstance(metadata, dict):
-                metadata = {}
            ext_dir = self.extensions_dir / ext_id
            manifest_path = ext_dir / "extension.yml"

@@ -705,10 +584,9 @@ class ExtensionManager:
                result.append({
                    "id": ext_id,
                    "name": manifest.name,
-                    "version": metadata.get("version", "unknown"),
+                    "version": metadata["version"],
                    "description": manifest.description,
                    "enabled": metadata.get("enabled", True),
-                    "priority": normalize_priority(metadata.get("priority")),
                    "installed_at": metadata.get("installed_at"),
                    "command_count": len(manifest.commands),
                    "hook_count": len(manifest.hooks)
@@ -721,7 +599,6 @@ class ExtensionManager:
                    "version": metadata.get("version", "unknown"),
                    "description": "⚠️ Corrupted extension",
                    "enabled": False,
-                    "priority": normalize_priority(metadata.get("priority")),
                    "installed_at": metadata.get("installed_at"),
                    "command_count": 0,
                    "hook_count": 0
@@ -806,10 +683,7 @@ class CommandRegistrar:
        return self._registrar.render_frontmatter(frontmatter) + "\n" + context_note + body

    def _render_toml_command(self, frontmatter, body, ext_id):
-        # Preserve extension-specific context comments for backward compatibility
-        base = self._registrar.render_toml_command(frontmatter, body, ext_id)
-        context_lines = f"# Extension: {ext_id}\n# Config: .specify/extensions/{ext_id}/\n"
-        return base.rstrip("\n") + "\n" + context_lines
+        return self._registrar.render_toml_command(frontmatter, body, ext_id)

    def register_commands_for_agent(
        self,
@@ -905,13 +779,12 @@ class ExtensionCatalog:
            config_path: Path to extension-catalogs.yml

        Returns:
-            Ordered list of CatalogEntry objects, or None if file doesn't exist.
+            Ordered list of CatalogEntry objects, or None if file doesn't exist
+            or contains no valid catalog entries.

        Raises:
            ValidationError: If any catalog entry has an invalid URL,
-                the file cannot be parsed, a priority value is invalid,
-                or the file exists but contains no valid catalog entries
-                (fail-closed for security).
+                the file cannot be parsed, or a priority value is invalid.
        """
        if not config_path.exists():
            return None
@@ -923,17 +796,12 @@ class ExtensionCatalog:
            )
        catalogs_data = data.get("catalogs", [])
        if not catalogs_data:
-            # File exists but has no catalogs key or empty list - fail closed
-            raise ValidationError(
-                f"Catalog config {config_path} exists but contains no 'catalogs' entries. "
-                f"Remove the file to use built-in defaults, or add valid catalog entries."
-            )
+            return None
        if not isinstance(catalogs_data, list):
            raise ValidationError(
                f"Invalid catalog config: 'catalogs' must be a list, got {type(catalogs_data).__name__}"
            )
        entries: List[CatalogEntry] = []
-        skipped_entries: List[int] = []
        for idx, item in enumerate(catalogs_data):
            if not isinstance(item, dict):
                raise ValidationError(
@@ -941,7 +809,6 @@ class ExtensionCatalog:
                )
            url = str(item.get("url", "")).strip()
            if not url:
-                skipped_entries.append(idx)
                continue
            self._validate_catalog_url(url)
            try:
@@ -964,14 +831,7 @@ class ExtensionCatalog:
                description=str(item.get("description", "")),
            ))
        entries.sort(key=lambda e: e.priority)
-        if not entries:
-            # All entries were invalid (missing URLs) - fail closed for security
-            raise ValidationError(
-                f"Catalog config {config_path} contains {len(catalogs_data)} entries but none have valid URLs "
-                f"(entries at indices {skipped_entries} were skipped). "
-                f"Each catalog entry must have a 'url' field."
-            )
-        return entries
+        return entries if entries else None

    def get_active_catalogs(self) -> List[CatalogEntry]:
        """Get the ordered list of active catalogs.
--- a/src/specify_cli/presets.py
+++ b/src/specify_cli/presets.py
@@ -7,7 +7,6 @@ Presets are self-contained, versioned collections of templates
 customize the Spec-Driven Development workflow.
 """

-import copy
 import json
 import hashlib
 import os
@@ -24,8 +23,6 @@ import yaml
 from packaging import version as pkg_version
 from packaging.specifiers import SpecifierSet, InvalidSpecifier

-from .extensions import ExtensionRegistry, normalize_priority
-

@dataclass
 class PresetCatalogEntry:
@@ -142,15 +139,6 @@ class PresetManifest:
                    f"must be one of {sorted(VALID_PRESET_TEMPLATE_TYPES)}"
                )

-            # Validate file path safety: must be relative, no parent traversal
-            file_path = tmpl["file"]
-            normalized = os.path.normpath(file_path)
-            if os.path.isabs(normalized) or normalized.startswith(".."):
-                raise PresetValidationError(
-                    f"Invalid template file path '{file_path}': "
-                    "must be a relative path within the preset directory"
-                )
-
            # Validate template name format
            if tmpl["type"] == "command":
                # Commands use dot notation (e.g. speckit.specify)
@@ -274,38 +262,6 @@ class PresetRegistry:
            del self.data["presets"][pack_id]
            self._save()

-    def update(self, pack_id: str, updates: dict):
-        """Update preset metadata in registry.
-
-        Merges the provided updates with the existing entry, preserving any
-        fields not specified. The installed_at timestamp is always preserved
-        from the original entry.
-
-        Args:
-            pack_id: Preset ID
-            updates: Partial metadata to merge into existing metadata
-
-        Raises:
-            KeyError: If preset is not installed
-        """
-        if pack_id not in self.data["presets"]:
-            raise KeyError(f"Preset '{pack_id}' not found in registry")
-        existing = self.data["presets"][pack_id]
-        # Handle corrupted registry entries (e.g., string/list instead of dict)
-        if not isinstance(existing, dict):
-            existing = {}
-        # Merge: existing fields preserved, new fields override
-        merged = {**existing, **updates}
-        # Always preserve original installed_at based on key existence, not truthiness,
-        # to handle cases where the field exists but may be falsy (legacy/corruption)
-        if "installed_at" in existing:
-            merged["installed_at"] = existing["installed_at"]
-        else:
-            # If not present in existing, explicitly remove from merged if caller provided it
-            merged.pop("installed_at", None)
-        self.data["presets"][pack_id] = merged
-        self._save()
-
    def get(self, pack_id: str) -> Optional[dict]:
        """Get preset metadata from registry.

@@ -329,26 +285,14 @@ class PresetRegistry:
        """Get all installed presets sorted by priority.

        Lower priority number = higher precedence (checked first).
-        Presets with equal priority are sorted alphabetically by ID
-        for deterministic ordering.

        Returns:
-            List of (pack_id, metadata_copy) tuples sorted by priority.
-            Metadata is deep-copied to prevent accidental mutation.
+            List of (pack_id, metadata) tuples sorted by priority
        """
-        packs = self.data.get("presets", {}) or {}
-        if not isinstance(packs, dict):
-            packs = {}
-        sortable_packs = []
-        for pack_id, meta in packs.items():
-            if not isinstance(meta, dict):
-                continue
-            metadata_copy = copy.deepcopy(meta)
-            metadata_copy["priority"] = normalize_priority(metadata_copy.get("priority", 10))
-            sortable_packs.append((pack_id, metadata_copy))
+        packs = self.data["presets"]
        return sorted(
-            sortable_packs,
-            key=lambda item: (item[1]["priority"], item[0]),
+            packs.items(),
+            key=lambda item: item[1].get("priority", 10),
        )

    def is_installed(self, pack_id: str) -> bool:
@@ -420,7 +364,7 @@ class PresetManager:

        Scans the preset's templates for type "command", reads each command
        file, and writes it to every detected agent directory using the
-        CommandRegistrar from the agents module.
+        CommandRegistrar from the extensions module.

        Args:
            manifest: Preset manifest
@@ -480,7 +424,7 @@ class PresetManager:

        Reads ``.specify/init-options.json`` to determine whether skills
        are enabled and which agent was selected, then delegates to
-        the module-level ``_get_skills_dir()`` helper for the concrete path.
+        ``_get_skills_dir()`` for the concrete path.

        Returns:
            The skills directory ``Path``, or ``None`` if skills were not
@@ -529,33 +473,15 @@ class PresetManager:
        if not command_templates:
            return []

-        # Filter out extension command overrides if the extension isn't installed,
-        # matching the same logic used by _register_commands().
-        extensions_dir = self.project_root / ".specify" / "extensions"
-        filtered = []
-        for cmd in command_templates:
-            parts = cmd["name"].split(".")
-            if len(parts) >= 3 and parts[0] == "speckit":
-                ext_id = parts[1]
-                if not (extensions_dir / ext_id).is_dir():
-                    continue
-            filtered.append(cmd)
-
-        if not filtered:
-            return []
-
        skills_dir = self._get_skills_dir()
        if not skills_dir:
            return []

-        from . import SKILL_DESCRIPTIONS, load_init_options
-
-        opts = load_init_options(self.project_root)
-        selected_ai = opts.get("ai", "")
+        from . import SKILL_DESCRIPTIONS

        written: List[str] = []

-        for cmd_tmpl in filtered:
+        for cmd_tmpl in command_templates:
            cmd_name = cmd_tmpl["name"]
            cmd_file_rel = cmd_tmpl["file"]
            source_file = preset_dir / cmd_file_rel
@@ -566,12 +492,7 @@ class PresetManager:
            short_name = cmd_name
            if short_name.startswith("speckit."):
                short_name = short_name[len("speckit."):]
-            # Kimi CLI discovers skills by directory name and invokes them as
-            # /skill:<name> — use dot separator to match packaging convention.
-            if selected_ai == "kimi":
-                skill_name = f"speckit.{short_name}"
-            else:
-                skill_name = f"speckit-{short_name}"
+            skill_name = f"speckit-{short_name}"

            # Only overwrite if the skill already exists (i.e. --ai-skills was used)
            skill_subdir = skills_dir / skill_name
@@ -652,8 +573,6 @@ class PresetManager:
            short_name = skill_name
            if short_name.startswith("speckit-"):
                short_name = short_name[len("speckit-"):]
-            elif short_name.startswith("speckit."):
-                short_name = short_name[len("speckit."):]

            skill_subdir = skills_dir / skill_name
            skill_file = skill_subdir / "SKILL.md"
@@ -727,13 +646,9 @@ class PresetManager:
            Installed preset manifest

        Raises:
-            PresetValidationError: If manifest is invalid or priority is invalid
+            PresetValidationError: If manifest is invalid
            PresetCompatibilityError: If pack is incompatible
        """
-        # Validate priority
-        if priority < 1:
-            raise PresetValidationError("Priority must be a positive integer (1 or higher)")
-
        manifest_path = source_dir / "preset.yml"
        manifest = PresetManifest(manifest_path)

@@ -780,19 +695,14 @@ class PresetManager:
        Args:
            zip_path: Path to preset ZIP file
            speckit_version: Current spec-kit version
-            priority: Resolution priority (lower = higher precedence, default 10)

        Returns:
            Installed preset manifest

        Raises:
-            PresetValidationError: If manifest is invalid or priority is invalid
+            PresetValidationError: If manifest is invalid
            PresetCompatibilityError: If pack is incompatible
        """
-        # Validate priority early
-        if priority < 1:
-            raise PresetValidationError("Priority must be a positive integer (1 or higher)")
-
        with tempfile.TemporaryDirectory() as tmpdir:
            temp_path = Path(tmpdir)

@@ -864,9 +774,6 @@ class PresetManager:
        result = []

        for pack_id, metadata in self.registry.list().items():
-            # Ensure metadata is a dictionary to avoid AttributeError when using .get()
-            if not isinstance(metadata, dict):
-                metadata = {}
            pack_dir = self.presets_dir / pack_id
            manifest_path = pack_dir / "preset.yml"

@@ -875,13 +782,13 @@ class PresetManager:
                result.append({
                    "id": pack_id,
                    "name": manifest.name,
-                    "version": metadata.get("version", manifest.version),
+                    "version": metadata["version"],
                    "description": manifest.description,
                    "enabled": metadata.get("enabled", True),
                    "installed_at": metadata.get("installed_at"),
                    "template_count": len(manifest.templates),
                    "tags": manifest.tags,
-                    "priority": normalize_priority(metadata.get("priority")),
+                    "priority": metadata.get("priority", 10),
                })
            except PresetValidationError:
                result.append({
@@ -893,7 +800,7 @@ class PresetManager:
                    "installed_at": metadata.get("installed_at"),
                    "template_count": 0,
                    "tags": [],
-                    "priority": normalize_priority(metadata.get("priority")),
+                    "priority": metadata.get("priority", 10),
                })

        return result
@@ -989,10 +896,6 @@ class PresetCatalog:
            raise PresetValidationError(
                f"Failed to read catalog config {config_path}: {e}"
            )
-        if not isinstance(data, dict):
-            raise PresetValidationError(
-                f"Invalid catalog config {config_path}: expected a mapping at root, got {type(data).__name__}"
-            )
        catalogs_data = data.get("catalogs", [])
        if not catalogs_data:
            return None
@@ -1423,11 +1326,11 @@ class PresetCatalog:
            raise PresetError(f"Failed to save preset ZIP: {e}")

    def clear_cache(self):
-        """Clear all catalog cache files, including per-URL hashed caches."""
-        if self.cache_dir.exists():
-            for f in self.cache_dir.iterdir():
-                if f.is_file() and f.name.startswith("catalog"):
-                    f.unlink(missing_ok=True)
+        """Clear the catalog cache."""
+        if self.cache_file.exists():
+            self.cache_file.unlink()
+        if self.cache_metadata_file.exists():
+            self.cache_metadata_file.unlink()


 class PresetResolver:
@@ -1452,40 +1355,6 @@ class PresetResolver:
        self.overrides_dir = self.templates_dir / "overrides"
        self.extensions_dir = project_root / ".specify" / "extensions"

-    def _get_all_extensions_by_priority(self) -> list[tuple[int, str, dict | None]]:
-        """Build unified list of registered and unregistered extensions sorted by priority.
-
-        Registered extensions use their stored priority; unregistered directories
-        get implicit priority=10. Results are sorted by (priority, ext_id) for
-        deterministic ordering.
-
-        Returns:
-            List of (priority, ext_id, metadata_or_none) tuples sorted by priority.
-        """
-        if not self.extensions_dir.exists():
-            return []
-
-        registry = ExtensionRegistry(self.extensions_dir)
-        registered_extensions = registry.list_by_priority()
-        registered_extension_ids = {ext_id for ext_id, _ in registered_extensions}
-
-        all_extensions: list[tuple[int, str, dict | None]] = []
-
-        for ext_id, metadata in registered_extensions:
-            priority = normalize_priority(metadata.get("priority") if metadata else None)
-            all_extensions.append((priority, ext_id, metadata))
-
-        # Add unregistered directories with implicit priority=10
-        for ext_dir in self.extensions_dir.iterdir():
-            if not ext_dir.is_dir() or ext_dir.name.startswith("."):
-                continue
-            if ext_dir.name not in registered_extension_ids:
-                all_extensions.append((10, ext_dir.name, None))
-
-        # Sort by (priority, ext_id) for deterministic ordering
-        all_extensions.sort(key=lambda x: (x[0], x[1]))
-        return all_extensions
-
    def resolve(
        self,
        template_name: str,
@@ -1538,18 +1407,18 @@ class PresetResolver:
                    if candidate.exists():
                        return candidate

-        # Priority 3: Extension-provided templates (sorted by priority — lower number wins)
-        for _priority, ext_id, _metadata in self._get_all_extensions_by_priority():
-            ext_dir = self.extensions_dir / ext_id
-            if not ext_dir.is_dir():
-                continue
-            for subdir in subdirs:
-                if subdir:
-                    candidate = ext_dir / subdir / f"{template_name}{ext}"
-                else:
-                    candidate = ext_dir / f"{template_name}{ext}"
-                if candidate.exists():
-                    return candidate
+        # Priority 3: Extension-provided templates
+        if self.extensions_dir.exists():
+            for ext_dir in sorted(self.extensions_dir.iterdir()):
+                if not ext_dir.is_dir() or ext_dir.name.startswith("."):
+                    continue
+                for subdir in subdirs:
+                    if subdir:
+                        candidate = ext_dir / subdir / f"{template_name}{ext}"
+                    else:
+                        candidate = ext_dir / "templates" / f"{template_name}{ext}"
+                    if candidate.exists():
+                        return candidate

        # Priority 4: Core templates
        if template_type == "template":
@@ -1607,24 +1476,17 @@ class PresetResolver:
                except ValueError:
                    continue

-        for _priority, ext_id, ext_meta in self._get_all_extensions_by_priority():
-            ext_dir = self.extensions_dir / ext_id
-            if not ext_dir.is_dir():
-                continue
-            try:
-                resolved.relative_to(ext_dir)
-                if ext_meta:
-                    version = ext_meta.get("version", "?")
+        if self.extensions_dir.exists():
+            for ext_dir in sorted(self.extensions_dir.iterdir()):
+                if not ext_dir.is_dir() or ext_dir.name.startswith("."):
+                    continue
+                try:
+                    resolved.relative_to(ext_dir)
                    return {
                        "path": resolved_str,
-                        "source": f"extension:{ext_id} v{version}",
+                        "source": f"extension:{ext_dir.name}",
                    }
-                else:
-                    return {
-                        "path": resolved_str,
-                        "source": f"extension:{ext_id} (unregistered)",
-                    }
-            except ValueError:
-                continue
+                except ValueError:
+                    continue

        return {"path": resolved_str, "source": "core"}
--- a/templates/commands/specify.md
+++ b/templates/commands/specify.md
@@ -129,7 +129,7 @@ Given that feature description, do this:

   c. **Handle Validation Results**:

-      - **If all items pass**: Mark checklist complete and proceed to step 7
+      - **If all items pass**: Mark checklist complete and proceed to step 6

      - **If items fail (excluding [NEEDS CLARIFICATION])**:
        1. List the failing items and specific issues
@@ -178,6 +178,8 @@ Given that feature description, do this:

 **NOTE:** The script creates and checks out the new branch and initializes the spec file before writing.

+## General Guidelines
+
 ## Quick Guidelines

 - Focus on **WHAT** users need and **WHY**.
--- a/tests/test_agent_config_consistency.py
+++ b/tests/test_agent_config_consistency.py
@@ -62,14 +62,7 @@ class TestAgentConfigConsistency:
        ps_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-release-packages.ps1").read_text(encoding="utf-8")

        assert re.search(r"'shai'\s*\{.*?\.shai/commands", ps_text, re.S) is not None
-        assert re.search(r"'agy'\s*\{.*?\.agent/commands", ps_text, re.S) is not None
-
-    def test_release_sh_switch_has_shai_and_agy_generation(self):
-        """Bash release builder must generate files for shai and agy agents."""
-        sh_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-release-packages.sh").read_text(encoding="utf-8")
-
-        assert re.search(r"shai\)\s*\n.*?\.shai/commands", sh_text, re.S) is not None
-        assert re.search(r"agy\)\s*\n.*?\.agent/commands", sh_text, re.S) is not None
+        assert re.search(r"'agy'\s*\{.*?\.agent/workflows", ps_text, re.S) is not None

    def test_init_ai_help_includes_roo_and_kiro_alias(self):
        """CLI help text for --ai should stay in sync with agent config and alias guidance."""
@@ -178,134 +171,3 @@ class TestAgentConfigConsistency:
    def test_ai_help_includes_tabnine(self):
        """CLI help text for --ai should include tabnine."""
        assert "tabnine" in AI_ASSISTANT_HELP
-
-    # --- Kimi Code CLI consistency checks ---
-
-    def test_kimi_in_agent_config(self):
-        """AGENT_CONFIG should include kimi with correct folder and commands_subdir."""
-        assert "kimi" in AGENT_CONFIG
-        assert AGENT_CONFIG["kimi"]["folder"] == ".kimi/"
-        assert AGENT_CONFIG["kimi"]["commands_subdir"] == "skills"
-        assert AGENT_CONFIG["kimi"]["requires_cli"] is True
-
-    def test_kimi_in_extension_registrar(self):
-        """Extension command registrar should include kimi using .kimi/skills and SKILL.md."""
-        cfg = CommandRegistrar.AGENT_CONFIGS
-
-        assert "kimi" in cfg
-        kimi_cfg = cfg["kimi"]
-        assert kimi_cfg["dir"] == ".kimi/skills"
-        assert kimi_cfg["extension"] == "/SKILL.md"
-
-    def test_kimi_in_release_agent_lists(self):
-        """Bash and PowerShell release scripts should include kimi in agent lists."""
-        sh_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-release-packages.sh").read_text(encoding="utf-8")
-        ps_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-release-packages.ps1").read_text(encoding="utf-8")
-
-        sh_match = re.search(r"ALL_AGENTS=\(([^)]*)\)", sh_text)
-        assert sh_match is not None
-        sh_agents = sh_match.group(1).split()
-
-        ps_match = re.search(r"\$AllAgents = @\(([^)]*)\)", ps_text)
-        assert ps_match is not None
-        ps_agents = re.findall(r"'([^']+)'", ps_match.group(1))
-
-        assert "kimi" in sh_agents
-        assert "kimi" in ps_agents
-
-    def test_kimi_in_powershell_validate_set(self):
-        """PowerShell update-agent-context script should include 'kimi' in ValidateSet."""
-        ps_text = (REPO_ROOT / "scripts" / "powershell" / "update-agent-context.ps1").read_text(encoding="utf-8")
-
-        validate_set_match = re.search(r"\[ValidateSet\(([^)]*)\)\]", ps_text)
-        assert validate_set_match is not None
-        validate_set_values = re.findall(r"'([^']+)'", validate_set_match.group(1))
-
-        assert "kimi" in validate_set_values
-
-    def test_kimi_in_github_release_output(self):
-        """GitHub release script should include kimi template packages."""
-        gh_release_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-github-release.sh").read_text(encoding="utf-8")
-
-        assert "spec-kit-template-kimi-sh-" in gh_release_text
-        assert "spec-kit-template-kimi-ps-" in gh_release_text
-
-    def test_ai_help_includes_kimi(self):
-        """CLI help text for --ai should include kimi."""
-        assert "kimi" in AI_ASSISTANT_HELP
-
-    # --- Trae IDE consistency checks ---
-
-    def test_trae_in_agent_config(self):
-        """AGENT_CONFIG should include trae with correct folder and commands_subdir."""
-        assert "trae" in AGENT_CONFIG
-        assert AGENT_CONFIG["trae"]["folder"] == ".trae/"
-        assert AGENT_CONFIG["trae"]["commands_subdir"] == "rules"
-        assert AGENT_CONFIG["trae"]["requires_cli"] is False
-        assert AGENT_CONFIG["trae"]["install_url"] is None
-
-    def test_trae_in_extension_registrar(self):
-        """Extension command registrar should include trae using .trae/rules and markdown, if present."""
-        cfg = CommandRegistrar.AGENT_CONFIGS
-
-        assert "trae" in cfg
-        trae_cfg = cfg["trae"]
-        assert trae_cfg["format"] == "markdown"
-        assert trae_cfg["args"] == "$ARGUMENTS"
-        assert trae_cfg["extension"] == ".md"
-
-    def test_trae_in_release_agent_lists(self):
-        """Bash and PowerShell release scripts should include trae in agent lists."""
-        sh_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-release-packages.sh").read_text(encoding="utf-8")
-        ps_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-release-packages.ps1").read_text(encoding="utf-8")
-
-        sh_match = re.search(r"ALL_AGENTS=\(([^)]*)\)", sh_text)
-        assert sh_match is not None
-        sh_agents = sh_match.group(1).split()
-
-        ps_match = re.search(r"\$AllAgents = @\(([^)]*)\)", ps_text)
-        assert ps_match is not None
-        ps_agents = re.findall(r"'([^']+)'", ps_match.group(1))
-
-        assert "trae" in sh_agents
-        assert "trae" in ps_agents
-
-    def test_trae_in_release_scripts_generate_commands(self):
-        """Release scripts should generate markdown commands for trae in .trae/rules."""
-        sh_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-release-packages.sh").read_text(encoding="utf-8")
-        ps_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-release-packages.ps1").read_text(encoding="utf-8")
-
-        assert ".trae/rules" in sh_text
-        assert ".trae/rules" in ps_text
-        assert re.search(r"'trae'\s*\{.*?\.trae/rules", ps_text, re.S) is not None
-
-    def test_trae_in_github_release_output(self):
-        """GitHub release script should include trae template packages."""
-        gh_release_text = (REPO_ROOT / ".github" / "workflows" / "scripts" / "create-github-release.sh").read_text(encoding="utf-8")
-
-        assert "spec-kit-template-trae-sh-" in gh_release_text
-        assert "spec-kit-template-trae-ps-" in gh_release_text
-
-    def test_trae_in_agent_context_scripts(self):
-        """Agent context scripts should support trae agent type."""
-        bash_text = (REPO_ROOT / "scripts" / "bash" / "update-agent-context.sh").read_text(encoding="utf-8")
-        pwsh_text = (REPO_ROOT / "scripts" / "powershell" / "update-agent-context.ps1").read_text(encoding="utf-8")
-
-        assert "trae" in bash_text
-        assert "TRAE_FILE" in bash_text
-        assert "trae" in pwsh_text
-        assert "TRAE_FILE" in pwsh_text
-
-    def test_trae_in_powershell_validate_set(self):
-        """PowerShell update-agent-context script should include 'trae' in ValidateSet."""
-        ps_text = (REPO_ROOT / "scripts" / "powershell" / "update-agent-context.ps1").read_text(encoding="utf-8")
-
-        validate_set_match = re.search(r"\[ValidateSet\(([^)]*)\)\]", ps_text)
-        assert validate_set_match is not None
-        validate_set_values = re.findall(r"'([^']+)'", validate_set_match.group(1))
-
-        assert "trae" in validate_set_values
-
-    def test_ai_help_includes_trae(self):
-        """CLI help text for --ai should include trae."""
-        assert "trae" in AI_ASSISTANT_HELP
--- a/tests/test_ai_skills.py
+++ b/tests/test_ai_skills.py
@@ -62,7 +62,7 @@ def templates_dir(project_dir):
    tpl_root.mkdir(parents=True, exist_ok=True)

    # Template with valid YAML frontmatter
-    (tpl_root / "speckit.specify.md").write_text(
+    (tpl_root / "specify.md").write_text(
        "---\n"
        "description: Create or update the feature specification.\n"
        "handoffs:\n"
@@ -79,7 +79,7 @@ def templates_dir(project_dir):
    )

    # Template with minimal frontmatter
-    (tpl_root / "speckit.plan.md").write_text(
+    (tpl_root / "plan.md").write_text(
        "---\n"
        "description: Generate implementation plan.\n"
        "---\n"
@@ -91,7 +91,7 @@ def templates_dir(project_dir):
    )

    # Template with no frontmatter
-    (tpl_root / "speckit.tasks.md").write_text(
+    (tpl_root / "tasks.md").write_text(
        "# Tasks Command\n"
        "\n"
        "Body without frontmatter.\n",
@@ -99,7 +99,7 @@ def templates_dir(project_dir):
    )

    # Template with empty YAML frontmatter (yaml.safe_load returns None)
-    (tpl_root / "speckit.empty_fm.md").write_text(
+    (tpl_root / "empty_fm.md").write_text(
        "---\n"
        "---\n"
        "\n"
@@ -132,16 +132,6 @@ def commands_dir_gemini(project_dir):
    return cmd_dir


-@pytest.fixture
-def commands_dir_qwen(project_dir):
-    """Create a populated .qwen/commands directory (Markdown format)."""
-    cmd_dir = project_dir / ".qwen" / "commands"
-    cmd_dir.mkdir(parents=True, exist_ok=True)
-    for name in ["speckit.specify.md", "speckit.plan.md", "speckit.tasks.md"]:
-        (cmd_dir / name).write_text(f"# {name}\nContent here\n")
-    return cmd_dir
-
-
 # ===== _get_skills_dir Tests =====

 class TestGetSkillsDir:
@@ -337,7 +327,7 @@ class TestInstallAiSkills:
        cmds_dir = project_dir / ".claude" / "commands"
        cmds_dir.mkdir(parents=True)

-        (cmds_dir / "speckit.broken.md").write_text(
+        (cmds_dir / "broken.md").write_text(
            "---\n"
            "description: [unclosed bracket\n"
            "  invalid: yaml: content: here\n"
@@ -400,28 +390,6 @@ class TestInstallAiSkills:
        # .toml commands should be untouched
        assert (cmds_dir / "speckit.specify.toml").exists()

-    def test_qwen_md_commands_dir_installs_skills(self, project_dir):
-        """Qwen now uses Markdown format; skills should install directly from .qwen/commands/."""
-        cmds_dir = project_dir / ".qwen" / "commands"
-        cmds_dir.mkdir(parents=True)
-        (cmds_dir / "speckit.specify.md").write_text(
-            "---\ndescription: Create or update the feature specification.\n---\n\n# Specify\n\nBody.\n"
-        )
-        (cmds_dir / "speckit.plan.md").write_text(
-            "---\ndescription: Generate implementation plan.\n---\n\n# Plan\n\nBody.\n"
-        )
-
-        result = install_ai_skills(project_dir, "qwen")
-
-        assert result is True
-        skills_dir = project_dir / ".qwen" / "skills"
-        assert skills_dir.exists()
-        skill_dirs = [d.name for d in skills_dir.iterdir() if d.is_dir()]
-        assert len(skill_dirs) >= 1
-        # .md commands should be untouched
-        assert (cmds_dir / "speckit.specify.md").exists()
-        assert (cmds_dir / "speckit.plan.md").exists()
-
    @pytest.mark.parametrize("agent_key", [k for k in AGENT_CONFIG.keys() if k != "generic"])
    def test_skills_install_for_all_agents(self, temp_dir, agent_key):
        """install_ai_skills should produce skills for every configured agent."""
@@ -430,12 +398,9 @@ class TestInstallAiSkills:

        # Place .md templates in the agent's commands directory
        agent_folder = AGENT_CONFIG[agent_key]["folder"]
-        commands_subdir = AGENT_CONFIG[agent_key].get("commands_subdir", "commands")
-        cmds_dir = proj / agent_folder.rstrip("/") / commands_subdir
+        cmds_dir = proj / agent_folder.rstrip("/") / "commands"
        cmds_dir.mkdir(parents=True)
-        # Copilot uses speckit.*.agent.md templates; other agents use speckit.*.md
-        fname = "speckit.specify.agent.md" if agent_key == "copilot" else "speckit.specify.md"
-        (cmds_dir / fname).write_text(
+        (cmds_dir / "specify.md").write_text(
            "---\ndescription: Test command\n---\n\n# Test\n\nBody.\n"
        )

@@ -445,106 +410,10 @@ class TestInstallAiSkills:
        skills_dir = _get_skills_dir(proj, agent_key)
        assert skills_dir.exists()
        skill_dirs = [d.name for d in skills_dir.iterdir() if d.is_dir()]
-        # Kimi uses dot-separator (speckit.specify) to match /skill:speckit.* invocation;
-        # all other agents use hyphen-separator (speckit-specify).
-        expected_skill_name = "speckit.specify" if agent_key == "kimi" else "speckit-specify"
-        assert expected_skill_name in skill_dirs
-        assert (skills_dir / expected_skill_name / "SKILL.md").exists()
-
-    def test_copilot_ignores_non_speckit_agents(self, project_dir):
-        """Non-speckit markdown in .github/agents/ must not produce skills."""
-        agents_dir = project_dir / ".github" / "agents"
-        agents_dir.mkdir(parents=True, exist_ok=True)
-        (agents_dir / "speckit.plan.agent.md").write_text(
-            "---\ndescription: Generate implementation plan.\n---\n\n# Plan\n\nBody.\n"
-        )
-        (agents_dir / "my-custom-agent.agent.md").write_text(
-            "---\ndescription: A user custom agent\n---\n\n# Custom\n\nBody.\n"
-        )
-
-        result = install_ai_skills(project_dir, "copilot")
-
-        assert result is True
-        skills_dir = _get_skills_dir(project_dir, "copilot")
-        assert skills_dir.exists()
-        skill_dirs = [d.name for d in skills_dir.iterdir() if d.is_dir()]
-        assert "speckit-plan" in skill_dirs
-        assert "speckit-my-custom-agent.agent" not in skill_dirs
-        assert "speckit-my-custom-agent" not in skill_dirs
-
-    @pytest.mark.parametrize("agent_key,custom_file", [
-        ("claude", "review.md"),
-        ("cursor-agent", "deploy.md"),
-        ("qwen", "my-workflow.md"),
-    ])
-    def test_non_speckit_commands_ignored_for_all_agents(self, temp_dir, agent_key, custom_file):
-        """User-authored command files must not produce skills for any agent."""
-        proj = temp_dir / f"proj-{agent_key}"
-        proj.mkdir()
-
-        agent_folder = AGENT_CONFIG[agent_key]["folder"]
-        commands_subdir = AGENT_CONFIG[agent_key].get("commands_subdir", "commands")
-        cmds_dir = proj / agent_folder.rstrip("/") / commands_subdir
-        cmds_dir.mkdir(parents=True)
-        (cmds_dir / "speckit.specify.md").write_text(
-            "---\ndescription: Create spec.\n---\n\n# Specify\n\nBody.\n"
-        )
-        (cmds_dir / custom_file).write_text(
-            "---\ndescription: User custom command\n---\n\n# Custom\n\nBody.\n"
-        )
-
-        result = install_ai_skills(proj, agent_key)
-
-        assert result is True
-        skills_dir = _get_skills_dir(proj, agent_key)
-        skill_dirs = [d.name for d in skills_dir.iterdir() if d.is_dir()]
        assert "speckit-specify" in skill_dirs
-        custom_stem = Path(custom_file).stem
-        assert f"speckit-{custom_stem}" not in skill_dirs
+        assert (skills_dir / "speckit-specify" / "SKILL.md").exists()

-    def test_copilot_fallback_when_only_non_speckit_agents(self, project_dir):
-        """Fallback to templates/commands/ when .github/agents/ has no speckit.*.md files."""
-        agents_dir = project_dir / ".github" / "agents"
-        agents_dir.mkdir(parents=True, exist_ok=True)
-        # Only a user-authored agent, no speckit.* templates
-        (agents_dir / "my-custom-agent.agent.md").write_text(
-            "---\ndescription: A user custom agent\n---\n\n# Custom\n\nBody.\n"
-        )

-        result = install_ai_skills(project_dir, "copilot")
-
-        # Should succeed via fallback to templates/commands/
-        assert result is True
-        skills_dir = _get_skills_dir(project_dir, "copilot")
-        assert skills_dir.exists()
-        skill_dirs = [d.name for d in skills_dir.iterdir() if d.is_dir()]
-        # Should have skills from fallback templates, not from the custom agent
-        assert "speckit-plan" in skill_dirs
-        assert not any("my-custom" in d for d in skill_dirs)
-
-    @pytest.mark.parametrize("agent_key", ["claude", "cursor-agent", "qwen"])
-    def test_fallback_when_only_non_speckit_commands(self, temp_dir, agent_key):
-        """Fallback to templates/commands/ when agent dir has no speckit.*.md files."""
-        proj = temp_dir / f"proj-{agent_key}"
-        proj.mkdir()
-
-        agent_folder = AGENT_CONFIG[agent_key]["folder"]
-        commands_subdir = AGENT_CONFIG[agent_key].get("commands_subdir", "commands")
-        cmds_dir = proj / agent_folder.rstrip("/") / commands_subdir
-        cmds_dir.mkdir(parents=True)
-        # Only a user-authored command, no speckit.* templates
-        (cmds_dir / "my-custom-command.md").write_text(
-            "---\ndescription: User custom command\n---\n\n# Custom\n\nBody.\n"
-        )
-
-        result = install_ai_skills(proj, agent_key)
-
-        # Should succeed via fallback to templates/commands/
-        assert result is True
-        skills_dir = _get_skills_dir(proj, agent_key)
-        assert skills_dir.exists()
-        skill_dirs = [d.name for d in skills_dir.iterdir() if d.is_dir()]
-        assert not any("my-custom" in d for d in skill_dirs)

 class TestCommandCoexistence:
    """Verify install_ai_skills never touches command files.
@@ -556,16 +425,14 @@ class TestCommandCoexistence:

    def test_existing_commands_preserved_claude(self, project_dir, templates_dir, commands_dir_claude):
        """install_ai_skills must NOT remove pre-existing .claude/commands files."""
-        # Verify commands exist before (templates_dir adds 4 speckit.* files,
-        # commands_dir_claude overlaps with 3 of them)
-        before = list(commands_dir_claude.glob("speckit.*"))
-        assert len(before) >= 3
+        # Verify commands exist before
+        assert len(list(commands_dir_claude.glob("speckit.*"))) == 3

        install_ai_skills(project_dir, "claude")

        # Commands must still be there — install_ai_skills never touches them
        remaining = list(commands_dir_claude.glob("speckit.*"))
-        assert len(remaining) == len(before)
+        assert len(remaining) == 3

    def test_existing_commands_preserved_gemini(self, project_dir, templates_dir, commands_dir_gemini):
        """install_ai_skills must NOT remove pre-existing .gemini/commands files."""
@@ -576,15 +443,6 @@ class TestCommandCoexistence:
        remaining = list(commands_dir_gemini.glob("speckit.*"))
        assert len(remaining) == 3

-    def test_existing_commands_preserved_qwen(self, project_dir, templates_dir, commands_dir_qwen):
-        """install_ai_skills must NOT remove pre-existing .qwen/commands files."""
-        assert len(list(commands_dir_qwen.glob("speckit.*"))) == 3
-
-        install_ai_skills(project_dir, "qwen")
-
-        remaining = list(commands_dir_qwen.glob("speckit.*"))
-        assert len(remaining) == 3
-
    def test_commands_dir_not_removed(self, project_dir, templates_dir, commands_dir_claude):
        """install_ai_skills must not remove the commands directory."""
        install_ai_skills(project_dir, "claude")
@@ -800,59 +658,6 @@ class TestCliValidation:
        assert "Usage:" in result.output
        assert "--ai" in result.output

-    def test_agy_without_ai_skills_fails(self):
-        """--ai agy without --ai-skills should fail with exit code 1."""
-        from typer.testing import CliRunner
-
-        runner = CliRunner()
-        result = runner.invoke(app, ["init", "test-proj", "--ai", "agy"])
-
-        assert result.exit_code == 1
-        assert "Explicit command support was deprecated in Antigravity version 1.20.5." in result.output
-        assert "--ai-skills" in result.output
-
-    def test_interactive_agy_without_ai_skills_prompts_skills(self, monkeypatch):
-        """Interactive selector returning agy without --ai-skills should automatically enable --ai-skills."""
-        from typer.testing import CliRunner
-
-        # Mock select_with_arrows to simulate the user picking 'agy' for AI,
-        # and return a deterministic default for any other prompts to avoid
-        # calling the real interactive implementation.
-        def _fake_select_with_arrows(*args, **kwargs):
-            options = kwargs.get("options")
-            if options is None and len(args) >= 1:
-                options = args[0]
-
-            # If the options include 'agy', simulate selecting it.
-            if isinstance(options, dict) and "agy" in options:
-                return "agy"
-            if isinstance(options, (list, tuple)) and "agy" in options:
-                return "agy"
-
-            # For any other prompt, return a deterministic, non-interactive default:
-            # pick the first option if available.
-            if isinstance(options, dict) and options:
-                return next(iter(options.keys()))
-            if isinstance(options, (list, tuple)) and options:
-                return options[0]
-
-            # If no options are provided, fall back to None (should not occur in normal use).
-            return None
-
-        monkeypatch.setattr("specify_cli.select_with_arrows", _fake_select_with_arrows)
-        
-        # Mock download_and_extract_template to prevent real HTTP downloads during testing
-        monkeypatch.setattr("specify_cli.download_and_extract_template", lambda *args, **kwargs: None)
-        # We need to bypass the `git init` step, wait, it has `--no-git` by default in tests maybe?
-        runner = CliRunner()
-        # Create temp dir to avoid directory already exists errors or whatever
-        with runner.isolated_filesystem():
-            result = runner.invoke(app, ["init", "test-proj", "--no-git"])
-
-            # Interactive selection should NOT raise the deprecation error!
-            assert result.exit_code == 0
-            assert "Explicit command support was deprecated" not in result.output
-
    def test_ai_skills_flag_appears_in_help(self):
        """--ai-skills should appear in init --help output."""
        from typer.testing import CliRunner
--- a/tests/test_extensions.py
+++ b/tests/test_extensions.py
@@ -26,7 +26,6 @@ from specify_cli.extensions import (
    ExtensionError,
    ValidationError,
    CompatibilityError,
-    normalize_priority,
    version_satisfies,
 )

@@ -122,57 +121,6 @@ def project_dir(temp_dir):
    return proj_dir


-# ===== normalize_priority Tests =====
-
-class TestNormalizePriority:
-    """Test normalize_priority helper function."""
-
-    def test_valid_integer(self):
-        """Test with valid integer priority."""
-        assert normalize_priority(5) == 5
-        assert normalize_priority(1) == 1
-        assert normalize_priority(100) == 100
-
-    def test_valid_string_number(self):
-        """Test with string that can be converted to int."""
-        assert normalize_priority("5") == 5
-        assert normalize_priority("10") == 10
-
-    def test_zero_returns_default(self):
-        """Test that zero priority returns default."""
-        assert normalize_priority(0) == 10
-        assert normalize_priority(0, default=5) == 5
-
-    def test_negative_returns_default(self):
-        """Test that negative priority returns default."""
-        assert normalize_priority(-1) == 10
-        assert normalize_priority(-100, default=5) == 5
-
-    def test_none_returns_default(self):
-        """Test that None returns default."""
-        assert normalize_priority(None) == 10
-        assert normalize_priority(None, default=5) == 5
-
-    def test_invalid_string_returns_default(self):
-        """Test that non-numeric string returns default."""
-        assert normalize_priority("invalid") == 10
-        assert normalize_priority("abc", default=5) == 5
-
-    def test_float_truncates(self):
-        """Test that float is truncated to int."""
-        assert normalize_priority(5.9) == 5
-        assert normalize_priority(3.1) == 3
-
-    def test_empty_string_returns_default(self):
-        """Test that empty string returns default."""
-        assert normalize_priority("") == 10
-
-    def test_custom_default(self):
-        """Test custom default value."""
-        assert normalize_priority(None, default=20) == 20
-        assert normalize_priority("invalid", default=1) == 1
-
-
 # ===== ExtensionManifest Tests =====

 class TestExtensionManifest:
@@ -329,135 +277,6 @@ class TestExtensionRegistry:
        assert registry2.is_installed("test-ext")
        assert registry2.get("test-ext")["version"] == "1.0.0"

-    def test_update_preserves_installed_at(self, temp_dir):
-        """Test that update() preserves the original installed_at timestamp."""
-        extensions_dir = temp_dir / "extensions"
-        extensions_dir.mkdir()
-
-        registry = ExtensionRegistry(extensions_dir)
-        registry.add("test-ext", {"version": "1.0.0", "enabled": True})
-
-        # Get original installed_at
-        original_data = registry.get("test-ext")
-        original_installed_at = original_data["installed_at"]
-
-        # Update with new metadata
-        registry.update("test-ext", {"version": "2.0.0", "enabled": False})
-
-        # Verify installed_at is preserved
-        updated_data = registry.get("test-ext")
-        assert updated_data["installed_at"] == original_installed_at
-        assert updated_data["version"] == "2.0.0"
-        assert updated_data["enabled"] is False
-
-    def test_update_merges_with_existing(self, temp_dir):
-        """Test that update() merges new metadata with existing fields."""
-        extensions_dir = temp_dir / "extensions"
-        extensions_dir.mkdir()
-
-        registry = ExtensionRegistry(extensions_dir)
-        registry.add("test-ext", {
-            "version": "1.0.0",
-            "enabled": True,
-            "registered_commands": {"claude": ["cmd1", "cmd2"]},
-        })
-
-        # Update with partial metadata (only enabled field)
-        registry.update("test-ext", {"enabled": False})
-
-        # Verify existing fields are preserved
-        updated_data = registry.get("test-ext")
-        assert updated_data["enabled"] is False
-        assert updated_data["version"] == "1.0.0"  # Preserved
-        assert updated_data["registered_commands"] == {"claude": ["cmd1", "cmd2"]}  # Preserved
-
-    def test_update_raises_for_missing_extension(self, temp_dir):
-        """Test that update() raises KeyError for non-installed extension."""
-        extensions_dir = temp_dir / "extensions"
-        extensions_dir.mkdir()
-
-        registry = ExtensionRegistry(extensions_dir)
-
-        with pytest.raises(KeyError, match="not installed"):
-            registry.update("nonexistent-ext", {"enabled": False})
-
-    def test_restore_overwrites_completely(self, temp_dir):
-        """Test that restore() overwrites the registry entry completely."""
-        extensions_dir = temp_dir / "extensions"
-        extensions_dir.mkdir()
-
-        registry = ExtensionRegistry(extensions_dir)
-        registry.add("test-ext", {"version": "2.0.0", "enabled": True})
-
-        # Restore with complete backup data
-        backup_data = {
-            "version": "1.0.0",
-            "enabled": False,
-            "installed_at": "2024-01-01T00:00:00+00:00",
-            "registered_commands": {"claude": ["old-cmd"]},
-        }
-        registry.restore("test-ext", backup_data)
-
-        # Verify entry is exactly as restored
-        restored_data = registry.get("test-ext")
-        assert restored_data == backup_data
-
-    def test_restore_can_recreate_removed_entry(self, temp_dir):
-        """Test that restore() can recreate an entry after remove()."""
-        extensions_dir = temp_dir / "extensions"
-        extensions_dir.mkdir()
-
-        registry = ExtensionRegistry(extensions_dir)
-        registry.add("test-ext", {"version": "1.0.0"})
-
-        # Save backup and remove
-        backup = registry.get("test-ext").copy()
-        registry.remove("test-ext")
-        assert not registry.is_installed("test-ext")
-
-        # Restore should recreate the entry
-        registry.restore("test-ext", backup)
-        assert registry.is_installed("test-ext")
-        assert registry.get("test-ext")["version"] == "1.0.0"
-
-    def test_get_returns_deep_copy(self, temp_dir):
-        """Test that get() returns deep copies for nested structures."""
-        extensions_dir = temp_dir / "extensions"
-        extensions_dir.mkdir()
-
-        registry = ExtensionRegistry(extensions_dir)
-        metadata = {
-            "version": "1.0.0",
-            "registered_commands": {"claude": ["cmd1"]},
-        }
-        registry.add("test-ext", metadata)
-
-        fetched = registry.get("test-ext")
-        fetched["registered_commands"]["claude"].append("cmd2")
-
-        # Internal registry must remain unchanged.
-        internal = registry.data["extensions"]["test-ext"]
-        assert internal["registered_commands"] == {"claude": ["cmd1"]}
-
-    def test_list_returns_deep_copy(self, temp_dir):
-        """Test that list() returns deep copies for nested structures."""
-        extensions_dir = temp_dir / "extensions"
-        extensions_dir.mkdir()
-
-        registry = ExtensionRegistry(extensions_dir)
-        metadata = {
-            "version": "1.0.0",
-            "registered_commands": {"claude": ["cmd1"]},
-        }
-        registry.add("test-ext", metadata)
-
-        listed = registry.list()
-        listed["test-ext"]["registered_commands"]["claude"].append("cmd2")
-
-        # Internal registry must remain unchanged.
-        internal = registry.data["extensions"]["test-ext"]
-        assert internal["registered_commands"] == {"claude": ["cmd1"]}
-

 # ===== ExtensionManager Tests =====

@@ -593,15 +412,6 @@ class TestCommandRegistrar:
        assert "codex" in CommandRegistrar.AGENT_CONFIGS
        assert CommandRegistrar.AGENT_CONFIGS["codex"]["dir"] == ".codex/prompts"

-    def test_qwen_agent_config_is_markdown(self):
-        """Qwen should use Markdown format with $ARGUMENTS (not TOML)."""
-        assert "qwen" in CommandRegistrar.AGENT_CONFIGS
-        cfg = CommandRegistrar.AGENT_CONFIGS["qwen"]
-        assert cfg["dir"] == ".qwen/commands"
-        assert cfg["format"] == "markdown"
-        assert cfg["args"] == "$ARGUMENTS"
-        assert cfg["extension"] == ".md"
-
    def test_parse_frontmatter_valid(self):
        """Test parsing valid YAML frontmatter."""
        content = """---
@@ -1592,8 +1402,8 @@ class TestCatalogStack:
        with pytest.raises(ValidationError, match="HTTPS"):
            catalog.get_active_catalogs()

-    def test_empty_project_config_raises_error(self, temp_dir):
-        """Empty catalogs list in config raises ValidationError (fail-closed for security)."""
+    def test_empty_project_config_falls_back_to_defaults(self, temp_dir):
+        """Empty catalogs list in config falls back to default stack."""
        import yaml as yaml_module

        project_dir = self._make_project(temp_dir)
@@ -1602,32 +1412,11 @@ class TestCatalogStack:
            yaml_module.dump({"catalogs": []}, f)

        catalog = ExtensionCatalog(project_dir)
+        entries = catalog.get_active_catalogs()

-        # Fail-closed: empty config should raise, not fall back to defaults
-        with pytest.raises(ValidationError) as exc_info:
-            catalog.get_active_catalogs()
-        assert "contains no 'catalogs' entries" in str(exc_info.value)
-
-    def test_catalog_entries_without_urls_raises_error(self, temp_dir):
-        """Catalog entries without URLs raise ValidationError (fail-closed for security)."""
-        import yaml as yaml_module
-
-        project_dir = self._make_project(temp_dir)
-        config_path = project_dir / ".specify" / "extension-catalogs.yml"
-        with open(config_path, "w") as f:
-            yaml_module.dump({
-                "catalogs": [
-                    {"name": "no-url-catalog", "priority": 1},
-                    {"name": "another-no-url", "description": "Also missing URL"},
-                ]
-            }, f)
-
-        catalog = ExtensionCatalog(project_dir)
-
-        # Fail-closed: entries without URLs should raise, not fall back to defaults
-        with pytest.raises(ValidationError) as exc_info:
-            catalog.get_active_catalogs()
-        assert "none have valid URLs" in str(exc_info.value)
+        # Falls back to default stack
+        assert len(entries) == 2
+        assert entries[0].url == ExtensionCatalog.DEFAULT_CATALOG_URL

    # --- _load_catalog_config ---

@@ -2154,639 +1943,3 @@ class TestExtensionIgnore:
        assert not (dest / "docs" / "guide.md").exists()
        assert not (dest / "docs" / "internal.md").exists()
        assert (dest / "docs" / "api.md").exists()
-
-
-class TestExtensionAddCLI:
-    """CLI integration tests for extension add command."""
-
-    def test_add_by_display_name_uses_resolved_id_for_download(self, tmp_path):
-        """extension add by display name should use resolved ID for download_extension()."""
-        from typer.testing import CliRunner
-        from unittest.mock import patch, MagicMock
-        from specify_cli import app
-
-        runner = CliRunner()
-
-        # Create project structure
-        project_dir = tmp_path / "test-project"
-        project_dir.mkdir()
-        (project_dir / ".specify").mkdir()
-        (project_dir / ".specify" / "extensions").mkdir(parents=True)
-
-        # Mock catalog that returns extension by display name
-        mock_catalog = MagicMock()
-        mock_catalog.get_extension_info.return_value = None  # ID lookup fails
-        mock_catalog.search.return_value = [
-            {
-                "id": "acme-jira-integration",
-                "name": "Jira Integration",
-                "version": "1.0.0",
-                "description": "Jira integration extension",
-                "_install_allowed": True,
-            }
-        ]
-
-        # Track what ID was passed to download_extension
-        download_called_with = []
-        def mock_download(extension_id):
-            download_called_with.append(extension_id)
-            # Return a path that will fail install (we just want to verify the ID)
-            raise ExtensionError("Mock download - checking ID was resolved")
-
-        mock_catalog.download_extension.side_effect = mock_download
-
-        with patch("specify_cli.extensions.ExtensionCatalog", return_value=mock_catalog), \
-             patch.object(Path, "cwd", return_value=project_dir):
-            result = runner.invoke(
-                app,
-                ["extension", "add", "Jira Integration"],
-                catch_exceptions=True,
-            )
-
-        assert result.exit_code != 0, (
-            f"Expected non-zero exit code since mock download raises, got {result.exit_code}"
-        )
-
-        # Verify download_extension was called with the resolved ID, not the display name
-        assert len(download_called_with) == 1
-        assert download_called_with[0] == "acme-jira-integration", (
-            f"Expected download_extension to be called with resolved ID 'acme-jira-integration', "
-            f"but was called with '{download_called_with[0]}'"
-        )
-
-
-class TestExtensionUpdateCLI:
-    """CLI integration tests for extension update command."""
-
-    @staticmethod
-    def _create_extension_source(base_dir: Path, version: str, include_config: bool = False) -> Path:
-        """Create a minimal extension source directory for install tests."""
-        import yaml
-
-        ext_dir = base_dir / f"test-ext-{version}"
-        ext_dir.mkdir(parents=True, exist_ok=True)
-
-        manifest = {
-            "schema_version": "1.0",
-            "extension": {
-                "id": "test-ext",
-                "name": "Test Extension",
-                "version": version,
-                "description": "A test extension",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {
-                "commands": [
-                    {
-                        "name": "speckit.test.hello",
-                        "file": "commands/hello.md",
-                        "description": "Test command",
-                    }
-                ]
-            },
-            "hooks": {
-                "after_tasks": {
-                    "command": "speckit.test.hello",
-                    "optional": True,
-                }
-            },
-        }
-
-        (ext_dir / "extension.yml").write_text(yaml.dump(manifest, sort_keys=False))
-        commands_dir = ext_dir / "commands"
-        commands_dir.mkdir(exist_ok=True)
-        (commands_dir / "hello.md").write_text("---\ndescription: Test\n---\n\n$ARGUMENTS\n")
-        if include_config:
-            (ext_dir / "linear-config.yml").write_text("custom: true\nvalue: original\n")
-        return ext_dir
-
-    @staticmethod
-    def _create_catalog_zip(zip_path: Path, version: str):
-        """Create a minimal ZIP that passes extension_update ID validation."""
-        import zipfile
-        import yaml
-
-        manifest = {
-            "schema_version": "1.0",
-            "extension": {
-                "id": "test-ext",
-                "name": "Test Extension",
-                "version": version,
-                "description": "A test extension",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {"commands": [{"name": "speckit.test.hello", "file": "commands/hello.md"}]},
-        }
-
-        with zipfile.ZipFile(zip_path, "w") as zf:
-            zf.writestr("extension.yml", yaml.dump(manifest, sort_keys=False))
-
-    def test_update_success_preserves_installed_at(self, tmp_path):
-        """Successful update should keep original installed_at and apply new version."""
-        from typer.testing import CliRunner
-        from unittest.mock import patch
-        from specify_cli import app
-
-        runner = CliRunner()
-        project_dir = tmp_path / "project"
-        project_dir.mkdir()
-        (project_dir / ".specify").mkdir()
-        (project_dir / ".claude" / "commands").mkdir(parents=True)
-
-        manager = ExtensionManager(project_dir)
-        v1_dir = self._create_extension_source(tmp_path, "1.0.0", include_config=True)
-        manager.install_from_directory(v1_dir, "0.1.0")
-        original_installed_at = manager.registry.get("test-ext")["installed_at"]
-        original_config_content = (
-            project_dir / ".specify" / "extensions" / "test-ext" / "linear-config.yml"
-        ).read_text()
-
-        zip_path = tmp_path / "test-ext-update.zip"
-        self._create_catalog_zip(zip_path, "2.0.0")
-        v2_dir = self._create_extension_source(tmp_path, "2.0.0")
-
-        def fake_install_from_zip(self_obj, _zip_path, speckit_version):
-            return self_obj.install_from_directory(v2_dir, speckit_version)
-
-        with patch.object(Path, "cwd", return_value=project_dir), \
-             patch.object(ExtensionCatalog, "get_extension_info", return_value={
-                 "id": "test-ext",
-                 "name": "Test Extension",
-                 "version": "2.0.0",
-                 "_install_allowed": True,
-             }), \
-             patch.object(ExtensionCatalog, "download_extension", return_value=zip_path), \
-             patch.object(ExtensionManager, "install_from_zip", fake_install_from_zip):
-            result = runner.invoke(app, ["extension", "update", "test-ext"], input="y\n", catch_exceptions=True)
-
-        assert result.exit_code == 0, result.output
-
-        updated = ExtensionManager(project_dir).registry.get("test-ext")
-        assert updated["version"] == "2.0.0"
-        assert updated["installed_at"] == original_installed_at
-        restored_config_content = (
-            project_dir / ".specify" / "extensions" / "test-ext" / "linear-config.yml"
-        ).read_text()
-        assert restored_config_content == original_config_content
-
-    def test_update_failure_rolls_back_registry_hooks_and_commands(self, tmp_path):
-        """Failed update should restore original registry, hooks, and command files."""
-        from typer.testing import CliRunner
-        from unittest.mock import patch
-        from specify_cli import app
-        import yaml
-
-        runner = CliRunner()
-        project_dir = tmp_path / "project"
-        project_dir.mkdir()
-        (project_dir / ".specify").mkdir()
-        (project_dir / ".claude" / "commands").mkdir(parents=True)
-
-        manager = ExtensionManager(project_dir)
-        v1_dir = self._create_extension_source(tmp_path, "1.0.0")
-        manager.install_from_directory(v1_dir, "0.1.0")
-
-        backup_registry_entry = manager.registry.get("test-ext")
-        hooks_before = yaml.safe_load((project_dir / ".specify" / "extensions.yml").read_text())
-
-        registered_commands = backup_registry_entry.get("registered_commands", {})
-        command_files = []
-        registrar = CommandRegistrar()
-        for agent_name, cmd_names in registered_commands.items():
-            if agent_name not in registrar.AGENT_CONFIGS:
-                continue
-            agent_cfg = registrar.AGENT_CONFIGS[agent_name]
-            commands_dir = project_dir / agent_cfg["dir"]
-            for cmd_name in cmd_names:
-                cmd_path = commands_dir / f"{cmd_name}{agent_cfg['extension']}"
-                command_files.append(cmd_path)
-
-        assert command_files, "Expected at least one registered command file"
-        for cmd_file in command_files:
-            assert cmd_file.exists(), f"Expected command file to exist before update: {cmd_file}"
-
-        zip_path = tmp_path / "test-ext-update.zip"
-        self._create_catalog_zip(zip_path, "2.0.0")
-
-        with patch.object(Path, "cwd", return_value=project_dir), \
-             patch.object(ExtensionCatalog, "get_extension_info", return_value={
-                 "id": "test-ext",
-                 "name": "Test Extension",
-                 "version": "2.0.0",
-                 "_install_allowed": True,
-             }), \
-             patch.object(ExtensionCatalog, "download_extension", return_value=zip_path), \
-             patch.object(ExtensionManager, "install_from_zip", side_effect=RuntimeError("install failed")):
-            result = runner.invoke(app, ["extension", "update", "test-ext"], input="y\n", catch_exceptions=True)
-
-        assert result.exit_code == 1, result.output
-
-        restored_entry = ExtensionManager(project_dir).registry.get("test-ext")
-        assert restored_entry == backup_registry_entry
-
-        hooks_after = yaml.safe_load((project_dir / ".specify" / "extensions.yml").read_text())
-        assert hooks_after == hooks_before
-
-        for cmd_file in command_files:
-            assert cmd_file.exists(), f"Expected command file to be restored after rollback: {cmd_file}"
-
-
-class TestExtensionListCLI:
-    """Test extension list CLI output format."""
-
-    def test_list_shows_extension_id(self, extension_dir, project_dir):
-        """extension list should display the extension ID."""
-        from typer.testing import CliRunner
-        from unittest.mock import patch
-        from specify_cli import app
-
-        runner = CliRunner()
-
-        # Install the extension using the manager
-        manager = ExtensionManager(project_dir)
-        manager.install_from_directory(extension_dir, "0.1.0", register_commands=False)
-
-        with patch.object(Path, "cwd", return_value=project_dir):
-            result = runner.invoke(app, ["extension", "list"])
-
-        assert result.exit_code == 0, result.output
-        # Verify the extension ID is shown in the output
-        assert "test-ext" in result.output
-        # Verify name and version are also shown
-        assert "Test Extension" in result.output
-        assert "1.0.0" in result.output
-
-
-class TestExtensionPriority:
-    """Test extension priority-based resolution."""
-
-    def test_list_by_priority_empty(self, temp_dir):
-        """Test list_by_priority on empty registry."""
-        extensions_dir = temp_dir / "extensions"
-        extensions_dir.mkdir()
-
-        registry = ExtensionRegistry(extensions_dir)
-        result = registry.list_by_priority()
-
-        assert result == []
-
-    def test_list_by_priority_single(self, temp_dir):
-        """Test list_by_priority with single extension."""
-        extensions_dir = temp_dir / "extensions"
-        extensions_dir.mkdir()
-
-        registry = ExtensionRegistry(extensions_dir)
-        registry.add("test-ext", {"version": "1.0.0", "priority": 5})
-
-        result = registry.list_by_priority()
-
-        assert len(result) == 1
-        assert result[0][0] == "test-ext"
-        assert result[0][1]["priority"] == 5
-
-    def test_list_by_priority_ordering(self, temp_dir):
-        """Test list_by_priority returns extensions sorted by priority."""
-        extensions_dir = temp_dir / "extensions"
-        extensions_dir.mkdir()
-
-        registry = ExtensionRegistry(extensions_dir)
-        # Add in non-priority order
-        registry.add("ext-low", {"version": "1.0.0", "priority": 20})
-        registry.add("ext-high", {"version": "1.0.0", "priority": 1})
-        registry.add("ext-mid", {"version": "1.0.0", "priority": 10})
-
-        result = registry.list_by_priority()
-
-        assert len(result) == 3
-        # Lower priority number = higher precedence (first)
-        assert result[0][0] == "ext-high"
-        assert result[1][0] == "ext-mid"
-        assert result[2][0] == "ext-low"
-
-    def test_list_by_priority_default(self, temp_dir):
-        """Test list_by_priority uses default priority of 10."""
-        extensions_dir = temp_dir / "extensions"
-        extensions_dir.mkdir()
-
-        registry = ExtensionRegistry(extensions_dir)
-        # Add without explicit priority
-        registry.add("ext-default", {"version": "1.0.0"})
-        registry.add("ext-high", {"version": "1.0.0", "priority": 1})
-        registry.add("ext-low", {"version": "1.0.0", "priority": 20})
-
-        result = registry.list_by_priority()
-
-        assert len(result) == 3
-        # ext-high (1), ext-default (10), ext-low (20)
-        assert result[0][0] == "ext-high"
-        assert result[1][0] == "ext-default"
-        assert result[2][0] == "ext-low"
-
-    def test_list_by_priority_invalid_priority_defaults(self, temp_dir):
-        """Malformed priority values fall back to the default priority."""
-        extensions_dir = temp_dir / "extensions"
-        extensions_dir.mkdir()
-
-        registry = ExtensionRegistry(extensions_dir)
-        registry.add("ext-high", {"version": "1.0.0", "priority": 1})
-        registry.data["extensions"]["ext-invalid"] = {
-            "version": "1.0.0",
-            "priority": "high",
-        }
-        registry._save()
-
-        result = registry.list_by_priority()
-
-        assert [item[0] for item in result] == ["ext-high", "ext-invalid"]
-        assert result[1][1]["priority"] == 10
-
-    def test_install_with_priority(self, extension_dir, project_dir):
-        """Test that install_from_directory stores priority."""
-        manager = ExtensionManager(project_dir)
-        manager.install_from_directory(extension_dir, "0.1.0", register_commands=False, priority=5)
-
-        metadata = manager.registry.get("test-ext")
-        assert metadata["priority"] == 5
-
-    def test_install_default_priority(self, extension_dir, project_dir):
-        """Test that install_from_directory uses default priority of 10."""
-        manager = ExtensionManager(project_dir)
-        manager.install_from_directory(extension_dir, "0.1.0", register_commands=False)
-
-        metadata = manager.registry.get("test-ext")
-        assert metadata["priority"] == 10
-
-    def test_list_installed_includes_priority(self, extension_dir, project_dir):
-        """Test that list_installed includes priority in returned data."""
-        manager = ExtensionManager(project_dir)
-        manager.install_from_directory(extension_dir, "0.1.0", register_commands=False, priority=3)
-
-        installed = manager.list_installed()
-
-        assert len(installed) == 1
-        assert installed[0]["priority"] == 3
-
-    def test_priority_preserved_on_update(self, temp_dir):
-        """Test that registry update preserves priority."""
-        extensions_dir = temp_dir / "extensions"
-        extensions_dir.mkdir()
-
-        registry = ExtensionRegistry(extensions_dir)
-        registry.add("test-ext", {"version": "1.0.0", "priority": 5, "enabled": True})
-
-        # Update with new metadata (no priority specified)
-        registry.update("test-ext", {"enabled": False})
-
-        updated = registry.get("test-ext")
-        assert updated["priority"] == 5  # Preserved
-        assert updated["enabled"] is False  # Updated
-
-    def test_resolve_uses_unregistered_extension_dirs_when_registry_partially_corrupted(self, project_dir):
-        """Resolution scans unregistered extension dirs after valid registry entries."""
-        extensions_dir = project_dir / ".specify" / "extensions"
-
-        valid_dir = extensions_dir / "valid-ext" / "templates"
-        valid_dir.mkdir(parents=True)
-        (valid_dir / "other-template.md").write_text("# Valid\n")
-
-        broken_dir = extensions_dir / "broken-ext" / "templates"
-        broken_dir.mkdir(parents=True)
-        (broken_dir / "target-template.md").write_text("# Broken Target\n")
-
-        registry = ExtensionRegistry(extensions_dir)
-        registry.add("valid-ext", {"version": "1.0.0", "priority": 10})
-        registry.data["extensions"]["broken-ext"] = "corrupted"
-        registry._save()
-
-        from specify_cli.presets import PresetResolver
-
-        resolver = PresetResolver(project_dir)
-        resolved = resolver.resolve("target-template")
-        sourced = resolver.resolve_with_source("target-template")
-
-        assert resolved is not None
-        assert resolved.name == "target-template.md"
-        assert "Broken Target" in resolved.read_text()
-        assert sourced is not None
-        assert sourced["source"] == "extension:broken-ext (unregistered)"
-
-
-class TestExtensionPriorityCLI:
-    """Test extension priority CLI integration."""
-
-    def test_add_with_priority_option(self, extension_dir, project_dir):
-        """Test extension add command with --priority option."""
-        from typer.testing import CliRunner
-        from unittest.mock import patch
-        from specify_cli import app
-
-        runner = CliRunner()
-
-        with patch.object(Path, "cwd", return_value=project_dir):
-            result = runner.invoke(app, [
-                "extension", "add", str(extension_dir), "--dev", "--priority", "3"
-            ])
-
-        assert result.exit_code == 0, result.output
-
-        manager = ExtensionManager(project_dir)
-        metadata = manager.registry.get("test-ext")
-        assert metadata["priority"] == 3
-
-    def test_list_shows_priority(self, extension_dir, project_dir):
-        """Test extension list shows priority."""
-        from typer.testing import CliRunner
-        from unittest.mock import patch
-        from specify_cli import app
-
-        runner = CliRunner()
-
-        # Install extension with priority
-        manager = ExtensionManager(project_dir)
-        manager.install_from_directory(extension_dir, "0.1.0", register_commands=False, priority=7)
-
-        with patch.object(Path, "cwd", return_value=project_dir):
-            result = runner.invoke(app, ["extension", "list"])
-
-        assert result.exit_code == 0, result.output
-        assert "Priority: 7" in result.output
-
-    def test_set_priority_changes_priority(self, extension_dir, project_dir):
-        """Test set-priority command changes extension priority."""
-        from typer.testing import CliRunner
-        from unittest.mock import patch
-        from specify_cli import app
-
-        runner = CliRunner()
-
-        # Install extension with default priority
-        manager = ExtensionManager(project_dir)
-        manager.install_from_directory(extension_dir, "0.1.0", register_commands=False)
-
-        # Verify default priority
-        assert manager.registry.get("test-ext")["priority"] == 10
-
-        with patch.object(Path, "cwd", return_value=project_dir):
-            result = runner.invoke(app, ["extension", "set-priority", "test-ext", "5"])
-
-        assert result.exit_code == 0, result.output
-        assert "priority changed: 10 → 5" in result.output
-
-        # Reload registry to see updated value
-        manager2 = ExtensionManager(project_dir)
-        assert manager2.registry.get("test-ext")["priority"] == 5
-
-    def test_set_priority_same_value_no_change(self, extension_dir, project_dir):
-        """Test set-priority with same value shows already set message."""
-        from typer.testing import CliRunner
-        from unittest.mock import patch
-        from specify_cli import app
-
-        runner = CliRunner()
-
-        # Install extension with priority 5
-        manager = ExtensionManager(project_dir)
-        manager.install_from_directory(extension_dir, "0.1.0", register_commands=False, priority=5)
-
-        with patch.object(Path, "cwd", return_value=project_dir):
-            result = runner.invoke(app, ["extension", "set-priority", "test-ext", "5"])
-
-        assert result.exit_code == 0, result.output
-        assert "already has priority 5" in result.output
-
-    def test_set_priority_invalid_value(self, extension_dir, project_dir):
-        """Test set-priority rejects invalid priority values."""
-        from typer.testing import CliRunner
-        from unittest.mock import patch
-        from specify_cli import app
-
-        runner = CliRunner()
-
-        # Install extension
-        manager = ExtensionManager(project_dir)
-        manager.install_from_directory(extension_dir, "0.1.0", register_commands=False)
-
-        with patch.object(Path, "cwd", return_value=project_dir):
-            result = runner.invoke(app, ["extension", "set-priority", "test-ext", "0"])
-
-        assert result.exit_code == 1, result.output
-        assert "Priority must be a positive integer" in result.output
-
-    def test_set_priority_not_installed(self, project_dir):
-        """Test set-priority fails for non-installed extension."""
-        from typer.testing import CliRunner
-        from unittest.mock import patch
-        from specify_cli import app
-
-        runner = CliRunner()
-
-        # Ensure .specify exists
-        (project_dir / ".specify").mkdir(parents=True, exist_ok=True)
-
-        with patch.object(Path, "cwd", return_value=project_dir):
-            result = runner.invoke(app, ["extension", "set-priority", "nonexistent", "5"])
-
-        assert result.exit_code == 1, result.output
-        assert "not installed" in result.output.lower() or "no extensions installed" in result.output.lower()
-
-    def test_set_priority_by_display_name(self, extension_dir, project_dir):
-        """Test set-priority works with extension display name."""
-        from typer.testing import CliRunner
-        from unittest.mock import patch
-        from specify_cli import app
-
-        runner = CliRunner()
-
-        # Install extension
-        manager = ExtensionManager(project_dir)
-        manager.install_from_directory(extension_dir, "0.1.0", register_commands=False)
-
-        # Use display name "Test Extension" instead of ID "test-ext"
-        with patch.object(Path, "cwd", return_value=project_dir):
-            result = runner.invoke(app, ["extension", "set-priority", "Test Extension", "3"])
-
-        assert result.exit_code == 0, result.output
-        assert "priority changed" in result.output
-
-        # Reload registry to see updated value
-        manager2 = ExtensionManager(project_dir)
-        assert manager2.registry.get("test-ext")["priority"] == 3
-
-
-class TestExtensionPriorityBackwardsCompatibility:
-    """Test backwards compatibility for extensions installed before priority feature."""
-
-    def test_legacy_extension_without_priority_field(self, temp_dir):
-        """Extensions installed before priority feature should default to 10."""
-        extensions_dir = temp_dir / "extensions"
-        extensions_dir.mkdir()
-
-        # Simulate legacy registry entry without priority field
-        registry = ExtensionRegistry(extensions_dir)
-        registry.data["extensions"]["legacy-ext"] = {
-            "version": "1.0.0",
-            "source": "local",
-            "enabled": True,
-            "installed_at": "2025-01-01T00:00:00Z",
-            # No "priority" field - simulates pre-feature extension
-        }
-        registry._save()
-
-        # Reload registry
-        registry2 = ExtensionRegistry(extensions_dir)
-
-        # list_by_priority should use default of 10
-        result = registry2.list_by_priority()
-        assert len(result) == 1
-        assert result[0][0] == "legacy-ext"
-        # Priority defaults to 10 and is normalized in returned metadata
-        assert result[0][1]["priority"] == 10
-
-    def test_legacy_extension_in_list_installed(self, extension_dir, project_dir):
-        """list_installed returns priority=10 for legacy extensions without priority field."""
-        manager = ExtensionManager(project_dir)
-
-        # Install extension normally
-        manager.install_from_directory(extension_dir, "0.1.0", register_commands=False)
-
-        # Manually remove priority to simulate legacy extension
-        ext_data = manager.registry.data["extensions"]["test-ext"]
-        del ext_data["priority"]
-        manager.registry._save()
-
-        # list_installed should still return priority=10
-        installed = manager.list_installed()
-        assert len(installed) == 1
-        assert installed[0]["priority"] == 10
-
-    def test_mixed_legacy_and_new_extensions_ordering(self, temp_dir):
-        """Legacy extensions (no priority) sort with default=10 among prioritized extensions."""
-        extensions_dir = temp_dir / "extensions"
-        extensions_dir.mkdir()
-
-        registry = ExtensionRegistry(extensions_dir)
-
-        # Add extension with explicit priority=5
-        registry.add("ext-with-priority", {"version": "1.0.0", "priority": 5})
-
-        # Add legacy extension without priority (manually)
-        registry.data["extensions"]["legacy-ext"] = {
-            "version": "1.0.0",
-            "source": "local",
-            "enabled": True,
-            # No priority field
-        }
-        registry._save()
-
-        # Add extension with priority=15
-        registry.add("ext-low-priority", {"version": "1.0.0", "priority": 15})
-
-        # Reload and check ordering
-        registry2 = ExtensionRegistry(extensions_dir)
-        result = registry2.list_by_priority()
-
-        assert len(result) == 3
-        # Order: ext-with-priority (5), legacy-ext (defaults to 10), ext-low-priority (15)
-        assert result[0][0] == "ext-with-priority"
-        assert result[1][0] == "legacy-ext"
-        assert result[2][0] == "ext-low-priority"
--- a/tests/test_merge.py
+++ b/tests/test_merge.py
@@ -1,190 +0,0 @@
-import stat
-
-from specify_cli import merge_json_files
-from specify_cli import handle_vscode_settings
-
-# --- Dimension 2: Polite Deep Merge Strategy ---
-
-def test_merge_json_files_type_mismatch_preservation(tmp_path):
-    """If user has a string but template wants a dict, PRESERVE user's string."""
-    existing_file = tmp_path / "settings.json"
-    # User might have overridden a setting with a simple string or different type
-    existing_file.write_text('{"chat.editor.fontFamily": "CustomFont"}')
-    
-    # Template might expect a dict for the same key (hypothetically)
-    new_settings = {
-        "chat.editor.fontFamily": {"font": "TemplateFont"}
-    }
-    
-    merged = merge_json_files(existing_file, new_settings)
-    # Result is None because user settings were preserved and nothing else changed
-    assert merged is None
-
-def test_merge_json_files_deep_nesting(tmp_path):
-    """Verify deep recursive merging of new keys."""
-    existing_file = tmp_path / "settings.json"
-    existing_file.write_text("""
-    {
-        "a": {
-            "b": {
-                "c": 1
-            }
-        }
-    }
-    """)
-    
-    new_settings = {
-        "a": {
-            "b": {
-                "d": 2  # New nested key
-            },
-            "e": 3      # New mid-level key
-        }
-    }
-    
-    merged = merge_json_files(existing_file, new_settings)
-    assert merged["a"]["b"]["c"] == 1
-    assert merged["a"]["b"]["d"] == 2
-    assert merged["a"]["e"] == 3
-
-def test_merge_json_files_empty_existing(tmp_path):
-    """Merging into an empty/new file."""
-    existing_file = tmp_path / "empty.json"
-    existing_file.write_text("{}")
-    
-    new_settings = {"a": 1}
-    merged = merge_json_files(existing_file, new_settings)
-    assert merged == {"a": 1}
-
-# --- Dimension 3: Real-world Simulation ---
-
-def test_merge_vscode_realistic_scenario(tmp_path):
-    """A realistic VSCode settings.json with many existing preferences, comments, and trailing commas."""
-    existing_file = tmp_path / "vscode_settings.json"
-    existing_file.write_text("""
-    {
-        "editor.fontSize": 12,
-        "editor.formatOnSave": true, /* block comment */
-        "files.exclude": {
-            "**/.git": true,
-            "**/node_modules": true,
-        },
-        "chat.promptFilesRecommendations": {
-            "existing.tool": true,
-        } // User comment
-    }
-    """)
-    
-    template_settings = {
-        "chat.promptFilesRecommendations": {
-            "speckit.specify": True,
-            "speckit.plan": True
-        },
-        "chat.tools.terminal.autoApprove": {
-            ".specify/scripts/bash/": True
-        }
-    }
-    
-    merged = merge_json_files(existing_file, template_settings)
-    
-    # Check preservation
-    assert merged["editor.fontSize"] == 12
-    assert merged["files.exclude"]["**/.git"] is True
-    assert merged["chat.promptFilesRecommendations"]["existing.tool"] is True
-    
-    # Check additions
-    assert merged["chat.promptFilesRecommendations"]["speckit.specify"] is True
-    assert merged["chat.tools.terminal.autoApprove"][".specify/scripts/bash/"] is True
-
-# --- Dimension 4: Error Handling & Robustness ---
-
-def test_merge_json_files_with_bom(tmp_path):
-    """Test files with UTF-8 BOM (sometimes created on Windows)."""
-    existing_file = tmp_path / "bom.json"
-    content = '{"a": 1}'
-    # Prepend UTF-8 BOM
-    existing_file.write_bytes(b'\xef\xbb\xbf' + content.encode('utf-8'))
-    
-    new_settings = {"b": 2}
-    merged = merge_json_files(existing_file, new_settings)
-    assert merged == {"a": 1, "b": 2}
-
-def test_merge_json_files_not_a_dictionary_template(tmp_path):
-    """If for some reason new_content is not a dict, PRESERVE existing settings by returning None."""
-    existing_file = tmp_path / "ok.json"
-    existing_file.write_text('{"a": 1}')
-    
-    # Secure fallback: return None to skip writing and avoid clobbering
-    assert merge_json_files(existing_file, ["not", "a", "dict"]) is None
-
-def test_merge_json_files_unparseable_existing(tmp_path):
-    """If the existing file is unparseable JSON, return None to avoid overwriting it."""
-    bad_file = tmp_path / "bad.json"
-    bad_file.write_text('{"a": 1, missing_value}') # Invalid JSON
-    
-    assert merge_json_files(bad_file, {"b": 2}) is None
-
-
-def test_merge_json_files_list_preservation(tmp_path):
-    """Verify that existing list values are preserved and NOT merged or overwritten."""
-    existing_file = tmp_path / "list.json"
-    existing_file.write_text('{"my.list": ["user_item"]}')
-    
-    template_settings = {
-        "my.list": ["template_item"]
-    }
-    
-    merged = merge_json_files(existing_file, template_settings)
-    # The polite merge policy says: keep existing values if they exist and aren't both dicts.
-    # Since nothing changed, it returns None.
-    assert merged is None
-
-def test_merge_json_files_no_changes(tmp_path):
-    """If the merge doesn't introduce any new keys or changes, return None to skip rewrite."""
-    existing_file = tmp_path / "no_change.json"
-    existing_file.write_text('{"a": 1, "b": {"c": 2}}')
-    
-    template_settings = {
-        "a": 1,          # Already exists
-        "b": {"c": 2}    # Already exists nested
-    }
-    
-    # Should return None because result == existing
-    assert merge_json_files(existing_file, template_settings) is None
-
-def test_merge_json_files_type_mismatch_no_op(tmp_path):
-    """If a key exists with different type and we preserve it, it might still result in no change."""
-    existing_file = tmp_path / "mismatch_no_op.json"
-    existing_file.write_text('{"a": "user_string"}')
-    
-    template_settings = {
-        "a": {"key": "template_dict"} # Mismatch, will be ignored
-    }
-    
-    # Should return None because we preserved the user's string and nothing else changed
-    assert merge_json_files(existing_file, template_settings) is None
-
-
-def test_handle_vscode_settings_preserves_mode_on_atomic_write(tmp_path):
-    """Atomic rewrite should preserve existing file mode bits."""
-    vscode_dir = tmp_path / ".vscode"
-    vscode_dir.mkdir()
-    dest_file = vscode_dir / "settings.json"
-    template_file = tmp_path / "template_settings.json"
-
-    dest_file.write_text('{"a": 1}\n', encoding="utf-8")
-    dest_file.chmod(0o640)
-    before_mode = stat.S_IMODE(dest_file.stat().st_mode)
-
-    template_file.write_text('{"b": 2}\n', encoding="utf-8")
-
-    handle_vscode_settings(
-        template_file,
-        dest_file,
-        "settings.json",
-        verbose=False,
-        tracker=None,
-    )
-
-    after_mode = stat.S_IMODE(dest_file.stat().st_mode)
-    assert after_mode == before_mode
--- a/tests/test_presets.py
+++ b/tests/test_presets.py
@@ -32,7 +32,6 @@ from specify_cli.presets import (
    PresetCompatibilityError,
    VALID_PRESET_TEMPLATE_TYPES,
 )
-from specify_cli.extensions import ExtensionRegistry


 # ===== Fixtures =====
@@ -574,24 +573,6 @@ class TestRegistryPriority:
        assert sorted_packs[0][0] == "pack-b"
        assert sorted_packs[1][0] == "pack-a"

-    def test_list_by_priority_invalid_priority_defaults(self, temp_dir):
-        """Malformed priority values fall back to the default priority."""
-        packs_dir = temp_dir / "packs"
-        packs_dir.mkdir()
-        registry = PresetRegistry(packs_dir)
-
-        registry.add("pack-high", {"version": "1.0.0", "priority": 1})
-        registry.data["presets"]["pack-invalid"] = {
-            "version": "1.0.0",
-            "priority": "high",
-        }
-        registry._save()
-
-        sorted_packs = registry.list_by_priority()
-
-        assert [item[0] for item in sorted_packs] == ["pack-high", "pack-invalid"]
-        assert sorted_packs[1][1]["priority"] == 10
-

 # ===== PresetResolver Tests =====

@@ -697,11 +678,6 @@ class TestPresetResolver:
        ext_template = ext_templates_dir / "custom-template.md"
        ext_template.write_text("# Extension Custom Template\n")

-        # Register extension in registry
-        extensions_dir = project_dir / ".specify" / "extensions"
-        ext_registry = ExtensionRegistry(extensions_dir)
-        ext_registry.add("my-ext", {"version": "1.0.0", "priority": 10})
-
        resolver = PresetResolver(project_dir)
        result = resolver.resolve("custom-template")
        assert result is not None
@@ -765,15 +741,10 @@ class TestPresetResolver:
        ext_template = ext_templates_dir / "unique-template.md"
        ext_template.write_text("# Unique\n")

-        # Register extension in registry
-        extensions_dir = project_dir / ".specify" / "extensions"
-        ext_registry = ExtensionRegistry(extensions_dir)
-        ext_registry.add("my-ext", {"version": "1.0.0", "priority": 10})
-
        resolver = PresetResolver(project_dir)
        result = resolver.resolve_with_source("unique-template")
        assert result is not None
-        assert result["source"] == "extension:my-ext v1.0.0"
+        assert result["source"] == "extension:my-ext"

    def test_resolve_with_source_not_found(self, project_dir):
        """Test resolve_with_source for nonexistent template."""
@@ -794,104 +765,6 @@ class TestPresetResolver:
        assert result is None


-class TestExtensionPriorityResolution:
-    """Test extension priority resolution with registered and unregistered extensions."""
-
-    def test_unregistered_beats_registered_with_lower_precedence(self, project_dir):
-        """Unregistered extension (implicit priority 10) beats registered with priority 20."""
-        extensions_dir = project_dir / ".specify" / "extensions"
-        extensions_dir.mkdir(parents=True, exist_ok=True)
-
-        # Create registered extension with priority 20 (lower precedence than 10)
-        registered_dir = extensions_dir / "registered-ext"
-        (registered_dir / "templates").mkdir(parents=True)
-        (registered_dir / "templates" / "test-template.md").write_text("# From Registered\n")
-
-        ext_registry = ExtensionRegistry(extensions_dir)
-        ext_registry.add("registered-ext", {"version": "1.0.0", "priority": 20})
-
-        # Create unregistered extension directory (implicit priority 10)
-        unregistered_dir = extensions_dir / "unregistered-ext"
-        (unregistered_dir / "templates").mkdir(parents=True)
-        (unregistered_dir / "templates" / "test-template.md").write_text("# From Unregistered\n")
-
-        # Unregistered (priority 10) should beat registered (priority 20)
-        resolver = PresetResolver(project_dir)
-        result = resolver.resolve("test-template")
-        assert result is not None
-        assert "From Unregistered" in result.read_text()
-
-    def test_registered_with_higher_precedence_beats_unregistered(self, project_dir):
-        """Registered extension with priority 5 beats unregistered (implicit priority 10)."""
-        extensions_dir = project_dir / ".specify" / "extensions"
-        extensions_dir.mkdir(parents=True, exist_ok=True)
-
-        # Create registered extension with priority 5 (higher precedence than 10)
-        registered_dir = extensions_dir / "registered-ext"
-        (registered_dir / "templates").mkdir(parents=True)
-        (registered_dir / "templates" / "test-template.md").write_text("# From Registered\n")
-
-        ext_registry = ExtensionRegistry(extensions_dir)
-        ext_registry.add("registered-ext", {"version": "1.0.0", "priority": 5})
-
-        # Create unregistered extension directory (implicit priority 10)
-        unregistered_dir = extensions_dir / "unregistered-ext"
-        (unregistered_dir / "templates").mkdir(parents=True)
-        (unregistered_dir / "templates" / "test-template.md").write_text("# From Unregistered\n")
-
-        # Registered (priority 5) should beat unregistered (priority 10)
-        resolver = PresetResolver(project_dir)
-        result = resolver.resolve("test-template")
-        assert result is not None
-        assert "From Registered" in result.read_text()
-
-    def test_unregistered_attribution_with_priority_ordering(self, project_dir):
-        """Test resolve_with_source correctly attributes unregistered extension."""
-        extensions_dir = project_dir / ".specify" / "extensions"
-        extensions_dir.mkdir(parents=True, exist_ok=True)
-
-        # Create registered extension with priority 20
-        registered_dir = extensions_dir / "registered-ext"
-        (registered_dir / "templates").mkdir(parents=True)
-        (registered_dir / "templates" / "test-template.md").write_text("# From Registered\n")
-
-        ext_registry = ExtensionRegistry(extensions_dir)
-        ext_registry.add("registered-ext", {"version": "1.0.0", "priority": 20})
-
-        # Create unregistered extension (implicit priority 10)
-        unregistered_dir = extensions_dir / "unregistered-ext"
-        (unregistered_dir / "templates").mkdir(parents=True)
-        (unregistered_dir / "templates" / "test-template.md").write_text("# From Unregistered\n")
-
-        # Attribution should show unregistered extension
-        resolver = PresetResolver(project_dir)
-        result = resolver.resolve_with_source("test-template")
-        assert result is not None
-        assert "unregistered-ext" in result["source"]
-        assert "(unregistered)" in result["source"]
-
-    def test_same_priority_sorted_alphabetically(self, project_dir):
-        """Extensions with same priority are sorted alphabetically by ID."""
-        extensions_dir = project_dir / ".specify" / "extensions"
-        extensions_dir.mkdir(parents=True, exist_ok=True)
-
-        # Create two unregistered extensions (both implicit priority 10)
-        # "aaa-ext" should come before "zzz-ext" alphabetically
-        zzz_dir = extensions_dir / "zzz-ext"
-        (zzz_dir / "templates").mkdir(parents=True)
-        (zzz_dir / "templates" / "test-template.md").write_text("# From ZZZ\n")
-
-        aaa_dir = extensions_dir / "aaa-ext"
-        (aaa_dir / "templates").mkdir(parents=True)
-        (aaa_dir / "templates" / "test-template.md").write_text("# From AAA\n")
-
-        # AAA should win due to alphabetical ordering at same priority
-        resolver = PresetResolver(project_dir)
-        result = resolver.resolve("test-template")
-        assert result is not None
-        assert "From AAA" in result.read_text()
-
-
 # ===== PresetCatalog Tests =====


@@ -1106,13 +979,8 @@ class TestIntegration:
        ext_templates_dir.mkdir(parents=True)
        (ext_templates_dir / "spec-template.md").write_text("# Extension\n")

-        # Register extension in registry
-        extensions_dir = project_dir / ".specify" / "extensions"
-        ext_registry = ExtensionRegistry(extensions_dir)
-        ext_registry.add("my-ext", {"version": "1.0.0", "priority": 10})
-
        result = resolver.resolve_with_source("spec-template")
-        assert result["source"] == "extension:my-ext v1.0.0"
+        assert result["source"] == "extension:my-ext"

        # Install pack — should win over extension
        manager = PresetManager(project_dir)
@@ -1842,162 +1710,3 @@ class TestPresetSkills:

        metadata = manager.registry.get("self-test")
        assert metadata.get("registered_skills", []) == []
-
-
-class TestPresetSetPriority:
-    """Test preset set-priority CLI command."""
-
-    def test_set_priority_changes_priority(self, project_dir, pack_dir):
-        """Test set-priority command changes preset priority."""
-        from typer.testing import CliRunner
-        from unittest.mock import patch
-        from specify_cli import app
-
-        runner = CliRunner()
-
-        # Install preset with default priority
-        manager = PresetManager(project_dir)
-        manager.install_from_directory(pack_dir, "0.1.5")
-
-        # Verify default priority
-        assert manager.registry.get("test-pack")["priority"] == 10
-
-        with patch.object(Path, "cwd", return_value=project_dir):
-            result = runner.invoke(app, ["preset", "set-priority", "test-pack", "5"])
-
-        assert result.exit_code == 0, result.output
-        assert "priority changed: 10 → 5" in result.output
-
-        # Reload registry to see updated value
-        manager2 = PresetManager(project_dir)
-        assert manager2.registry.get("test-pack")["priority"] == 5
-
-    def test_set_priority_same_value_no_change(self, project_dir, pack_dir):
-        """Test set-priority with same value shows already set message."""
-        from typer.testing import CliRunner
-        from unittest.mock import patch
-        from specify_cli import app
-
-        runner = CliRunner()
-
-        # Install preset with priority 5
-        manager = PresetManager(project_dir)
-        manager.install_from_directory(pack_dir, "0.1.5", priority=5)
-
-        with patch.object(Path, "cwd", return_value=project_dir):
-            result = runner.invoke(app, ["preset", "set-priority", "test-pack", "5"])
-
-        assert result.exit_code == 0, result.output
-        assert "already has priority 5" in result.output
-
-    def test_set_priority_invalid_value(self, project_dir, pack_dir):
-        """Test set-priority rejects invalid priority values."""
-        from typer.testing import CliRunner
-        from unittest.mock import patch
-        from specify_cli import app
-
-        runner = CliRunner()
-
-        # Install preset
-        manager = PresetManager(project_dir)
-        manager.install_from_directory(pack_dir, "0.1.5")
-
-        with patch.object(Path, "cwd", return_value=project_dir):
-            result = runner.invoke(app, ["preset", "set-priority", "test-pack", "0"])
-
-        assert result.exit_code == 1, result.output
-        assert "Priority must be a positive integer" in result.output
-
-    def test_set_priority_not_installed(self, project_dir):
-        """Test set-priority fails for non-installed preset."""
-        from typer.testing import CliRunner
-        from unittest.mock import patch
-        from specify_cli import app
-
-        runner = CliRunner()
-
-        with patch.object(Path, "cwd", return_value=project_dir):
-            result = runner.invoke(app, ["preset", "set-priority", "nonexistent", "5"])
-
-        assert result.exit_code == 1, result.output
-        assert "not installed" in result.output.lower()
-
-
-class TestPresetPriorityBackwardsCompatibility:
-    """Test backwards compatibility for presets installed before priority feature."""
-
-    def test_legacy_preset_without_priority_field(self, temp_dir):
-        """Presets installed before priority feature should default to 10."""
-        presets_dir = temp_dir / ".specify" / "presets"
-        presets_dir.mkdir(parents=True)
-
-        # Simulate legacy registry entry without priority field
-        registry = PresetRegistry(presets_dir)
-        registry.data["presets"]["legacy-pack"] = {
-            "version": "1.0.0",
-            "source": "local",
-            "enabled": True,
-            "installed_at": "2025-01-01T00:00:00Z",
-            # No "priority" field - simulates pre-feature preset
-        }
-        registry._save()
-
-        # Reload registry
-        registry2 = PresetRegistry(presets_dir)
-
-        # list_by_priority should use default of 10
-        result = registry2.list_by_priority()
-        assert len(result) == 1
-        assert result[0][0] == "legacy-pack"
-        # Priority defaults to 10 and is normalized in returned metadata
-        assert result[0][1]["priority"] == 10
-
-    def test_legacy_preset_in_list_installed(self, project_dir, pack_dir):
-        """list_installed returns priority=10 for legacy presets without priority field."""
-        manager = PresetManager(project_dir)
-
-        # Install preset normally
-        manager.install_from_directory(pack_dir, "0.1.5")
-
-        # Manually remove priority to simulate legacy preset
-        pack_data = manager.registry.data["presets"]["test-pack"]
-        del pack_data["priority"]
-        manager.registry._save()
-
-        # list_installed should still return priority=10
-        installed = manager.list_installed()
-        assert len(installed) == 1
-        assert installed[0]["priority"] == 10
-
-    def test_mixed_legacy_and_new_presets_ordering(self, temp_dir):
-        """Legacy presets (no priority) sort with default=10 among prioritized presets."""
-        presets_dir = temp_dir / ".specify" / "presets"
-        presets_dir.mkdir(parents=True)
-
-        registry = PresetRegistry(presets_dir)
-
-        # Add preset with explicit priority=5
-        registry.add("pack-with-priority", {"version": "1.0.0", "priority": 5})
-
-        # Add legacy preset without priority (manually)
-        registry.data["presets"]["legacy-pack"] = {
-            "version": "1.0.0",
-            "source": "local",
-            "enabled": True,
-            # No priority field
-        }
-
-        # Add another preset with priority=15
-        registry.add("low-priority-pack", {"version": "1.0.0", "priority": 15})
-        registry._save()
-
-        # Reload and check ordering
-        registry2 = PresetRegistry(presets_dir)
-        sorted_presets = registry2.list_by_priority()
-
-        # Should be: pack-with-priority (5), legacy-pack (default 10), low-priority-pack (15)
-        assert [p[0] for p in sorted_presets] == [
-            "pack-with-priority",
-            "legacy-pack",
-            "low-priority-pack",
-        ]
Author	SHA1	Message	Date
Manfred Riem	f5f8311415	fix: correct PresetError docstring from template to preset	2026-03-10 17:20:54 -05:00
Manfred Riem	6da1375396	fix: address Copilot PR review comments (round 3) - Fix PS Resolve-Template fallback to skip dot-prefixed dirs (.cache) - Rename _catalog to _catalog_name for consistency with extension system - Enforce install_allowed policy in CLI preset add and download_pack() - Fix shell injection: pass registry path via env var instead of string interpolation	2026-03-10 17:06:34 -05:00
Manfred Riem	1c143e64b1	fix: remove self-test from catalog.json (local-only preset)	2026-03-10 16:39:07 -05:00
Manfred Riem	da6e7d2283	fix: address Copilot PR review comments (round 2) - Fix init --preset error masking: distinguish "not found" from real errors - Fix bash resolve_template: skip hidden dirs in extensions (match Python/PS) - Fix temp dir leaks in tests: use temp_dir fixture instead of mkdtemp - Fix self-test catalog entry: add note that it's local-only (no download_url) - Fix Windows path issue in resolve_with_source: use Path.relative_to() - Fix skill restore path: use project's .specify/templates/commands/ not source tree - Add encoding="utf-8" to all file read/write in agents.py - Update test to set up core command templates for skill restoration	2026-03-10 16:35:17 -05:00
Manfred Riem	3ffef55954	fix: narrow empty except blocks and add explanatory comments	2026-03-10 15:16:43 -05:00
Manfred Riem	52f137ce84	fix: address Copilot PR review comments - Move save_init_options() before preset install so skills propagation works during 'specify init --preset --ai-skills' - Clean up downloaded ZIP after successful preset install during init - Validate --from URL scheme (require HTTPS, HTTP only for localhost) - Expose unregister_commands() on extensions.py CommandRegistrar wrapper instead of reaching into private _registrar field - Use _get_merged_packs() for search() and get_pack_info() so all active catalogs are searched, not just the highest-priority one - Fix fetch_catalog() cache to verify cached URL matches current URL - Fix PresetResolver: script resolution uses .sh extension, consistent file extensions throughout resolve(), and resolve_with_source() delegates to resolve() to honor template_type parameter - Fix bash common.sh: fall through to directory scan when python3 returns empty preset list - Fix PowerShell Resolve-Template: filter out dot-folders and sort extensions deterministically	2026-03-10 15:11:31 -05:00
Manfred Riem	445eefe5ba	fix: address PR check failures (ruff F541, CodeQL URL substring) - Remove extraneous f-prefix from two f-strings without placeholders - Replace substring URL check in test with startswith/endswith assertions to satisfy CodeQL incomplete URL substring sanitization rule	2026-03-10 14:45:16 -05:00
Manfred Riem	35ced30747	feat(presets): propagate command overrides to skills via init-options - Add save_init_options() / load_init_options() helpers that persist CLI flags from 'specify init' to .specify/init-options.json - PresetManager._register_skills() overwrites SKILL.md files when --ai-skills was used during init and corresponding skill dirs exist - PresetManager._unregister_skills() restores core template content on preset removal - registered_skills stored in preset registry metadata - 8 new tests covering skill override, skip conditions, and restore	2026-03-10 14:31:17 -05:00
Manfred Riem	914a06a89f	Merge remote-tracking branch 'upstream/main' into pr-1787 # Conflicts: # CHANGELOG.md # src/specify_cli/extensions.py	2026-03-10 14:20:38 -05:00
Manfred Riem	abf4aebdb3	feat(presets): pluggable preset system with template/command overrides, catalog, and resolver - Rename 'template packs' to 'presets' to avoid naming collision with core templates - PresetManifest, PresetRegistry, PresetManager, PresetCatalog, PresetResolver in presets.py - Extract CommandRegistrar to agents.py as shared infrastructure - CLI: specify preset list/add/remove/search/resolve/info - CLI: specify preset catalog list/add/remove - --preset option on specify init - Priority-based preset stacking (--priority, lower = higher precedence) - Command overrides registered into all detected agent directories (17+ agents) - Extension command safety: skip registration if target extension not installed - Multi-catalog support: env var, project config, user config, built-in defaults - resolve_template() / Resolve-Template in bash/PowerShell scripts - Self-test preset: overrides all 6 core templates + 1 command - Scaffold with 4 examples: core/extension template and command overrides - Preset catalog (catalog.json, catalog.community.json) - Documentation: README.md, ARCHITECTURE.md, PUBLISHING.md - 110 preset tests, 253 total tests passing	2026-03-10 14:17:44 -05:00
copilot-swe-agent[bot]	6003a232d8	test(templates): add comprehensive unit tests for template pack system Co-authored-by: mnriem <15701806+mnriem@users.noreply.github.com>	2026-03-09 21:05:27 +00:00
copilot-swe-agent[bot]	2e8a4d6432	feat(templates): add pluggable template system with packs, catalog, resolver, and CLI commands Co-authored-by: mnriem <15701806+mnriem@users.noreply.github.com>	2026-03-09 21:02:52 +00:00
copilot-swe-agent[bot]	65ecaa9fe4	Initial plan	2026-03-09 20:53:50 +00:00