fix: only delete manifest when full tracked set was processed

When remove_tracked_files is called with an explicit files dict (subset),
skip manifest deletion to avoid losing tracking of entries not in the
subset. Manifest cleanup only runs when the full set is read from the
manifest itself (files=None).

AGENTS.md

@@ -427,4 +427,56 @@ When adding new agents:
 
 ---
 
+## Agent Pack System (new)
+
+The agent pack system is a declarative, self-contained replacement for the legacy `AGENT_CONFIG` + case/switch architecture. Each agent is defined by a `speckit-agent.yml` manifest and an optional `bootstrap.py` module. When `bootstrap.py` is absent, the built-in `DefaultBootstrap` class derives its directory layout from the manifest's `commands_dir` field.
+
+### `--agent` flag on `specify init`
+
+`specify init --agent <id>` uses the pack-based init flow instead of the legacy `--ai` flow. Both accept the same agent IDs, but `--agent` additionally enables installed-file tracking so that `specify agent switch` can cleanly tear down agent files later.
+
+```bash
+specify init my-project --agent claude          # Pack-based flow (with file tracking)
+specify init --here --agent gemini --ai-skills  # With skills
+```
+
+`--agent` and `--ai` are mutually exclusive. When `--agent` is used, `init-options.json` gains `"agent_pack": true`. The `generic` agent (which requires `--ai-commands-dir`) falls through to the legacy flow since it has no embedded pack.
+
+### `specify agent` subcommands
+
+| Command                         | Description |
+| ------------------------------- | ----------- |
+| `specify agent list`            | List all available agent packs |
+| `specify agent list --installed`| List only agents installed in the current project |
+| `specify agent info <id>`       | Show detailed information about an agent pack |
+| `specify agent switch <id>`     | Switch the active agent (tears down old, sets up new) |
+| `specify agent search [query]`  | Search agents by name, ID, description, or tags |
+| `specify agent validate <path>` | Validate an agent pack directory |
+| `specify agent export <id>`     | Export an agent pack for editing |
+| `specify agent add <id> --from <path>` | Install an agent pack from a local directory |
+| `specify agent remove <id>`     | Remove a cached/override agent pack |
+
+> **Note:** `specify agent add <id>` without `--from <path>` is reserved for future catalog-based installation, which is not yet implemented.
+
+### Pack resolution order
+
+Agent packs resolve by priority (highest first):
+1. **User-level** (`~/.specify/agents/<id>/`) — applies to all projects
+2. **Project-level** (`.specify/agents/<id>/`) — project-specific override
+3. **Catalog cache** (downloaded via `specify agent add`)
+4. **Embedded** (bundled in the specify-cli wheel)
+
+### Trust boundary
+
+Agent packs can include a `bootstrap.py` module that is dynamically imported and executed. Pack authors can run arbitrary code through this mechanism. Only install packs from trusted sources. The 4-level resolution stack means that placing a pack in any of the resolution directories causes its code to run when the agent is loaded.
+
+### Installed-file tracking
+
+When using `--agent`, all installed files are recorded in `.specify/agent-manifest-<id>.json` with SHA-256 hashes. During `specify agent switch`, the CLI:
+1. Checks for user-modified files before teardown
+2. Prompts for confirmation if files were changed
+3. Feeds tracked file lists into teardown for precise, file-level removal (directories are never deleted)
+
+---
+
 *This documentation should be updated whenever new agents are added to maintain accuracy and completeness.*

CHANGELOG.md

@@ -1,33 +1,11 @@
 # Changelog
 
-## [0.4.1] - 2026-03-24
+## [0.3.2] - 2026-03-19
 
 ### Changes
 
-- Add checkpoint extension (#1947)
-- fix(scripts): prioritize .specify over git for repo root detection (#1933)
-- docs: add AIDE extension demo to community projects (#1943)
-- fix(templates): add missing Assumptions section to spec template (#1939)
-- chore: bump version to 0.4.1 (#1937)
-
-## [0.4.0] - 2026-03-23
-
-### Changes
-
-- fix(cli): add allow_unicode=True and encoding="utf-8" to YAML I/O (#1936)
-- fix(codex): native skills fallback refresh + legacy prompt suppression (#1930)
-
-- feat(cli): embed core pack in wheel for offline/air-gapped deployment (#1803)
-- ci: increase stale workflow operations-per-run to 250 (#1922)
-- docs: update publishing guide with Category and Effect columns (#1913)
-- fix: Align native skills frontmatter with install_ai_skills (#1920)
-- feat: add timestamp-based branch naming option for `specify init` (#1911)
-- docs: add Extension Comparison Guide for community extensions (#1897)
-- docs: update SUPPORT.md, fix issue templates, add preset submission template (#1910)
-- Add support for Junie (#1831)
-- feat: migrate Codex/agy init to native skills workflow (#1906)
-- chore: bump version to 0.3.2 (#1909)
-
+- chore: bump version to 0.3.2
+- Add conduct extension to community catalog (#1908)
 - feat(extensions): add verify-tasks extension to community catalog (#1871)
 - feat(presets): add enable/disable toggle and update semantics (#1891)
 - feat: add iFlow CLI support (#1875)
@@ -43,13 +21,6 @@
 - Feature/spec kit add pi coding agent pullrequest (#1853)
 - feat: register spec-kit-learn extension (#1883)
 
-## [0.3.2] - 2026-03-19
-
-### Changes
-
-- chore: bump version to 0.3.2
-- Add conduct extension to community catalog (#1908)
-
 ## [0.3.1] - 2026-03-17
 
 ### Changed

README.md

@@ -171,8 +171,6 @@ See Spec-Driven Development in action across different scenarios with these comm
 
 - **[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.
 
-- **[Greenfield Spring Boot + React with a custom extension](https://github.com/mnriem/spec-kit-aide-extension-demo)** — Walks through the **AIDE extension**, a community extension that adds an alternative spec-driven workflow to spec-kit with high-level specs (vision) and low-level specs (work items) organized in a 7-step iterative lifecycle: vision → roadmap → progress tracking → work queue → work items → execution → feedback loops. Uses a family trading platform (Spring Boot 4, React 19, PostgreSQL, Docker Compose) as the scenario to illustrate how the extension mechanism lets you plug in a different style of spec-driven development without changing any core tooling — truly utilizing the "Kit" in Spec Kit.
-
 ## 🤖 Supported AI Agents
 
 | Agent                                                                                | Support | Notes                                                                                                                                     |

extensions/README.md

@@ -78,7 +78,6 @@ The following community-contributed extensions are available in [`catalog.commun
 |-----------|---------|----------|--------|-----|
 | Archive Extension | Archive merged features into main project memory. | `docs` | Read+Write | [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 | `integration` | Read+Write | [spec-kit-azure-devops](https://github.com/pragya247/spec-kit-azure-devops) |
-| Checkpoint Extension | Commit the changes made during the middle of the implementation, so you don't end up with just one very large commit at the end | `code` | Read+Write | [spec-kit-checkpoint](https://github.com/aaronrsun/spec-kit-checkpoint) |
 | 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 | `code` | Read+Write | [spec-kit-cleanup](https://github.com/dsrednicki/spec-kit-cleanup) |
 | Cognitive Squad | Multi-agent cognitive system with Triadic Model: understanding, internalization, application — with quality gates, backpropagation verification, and self-healing | `docs` | Read+Write | [cognitive-squad](https://github.com/Testimonial/cognitive-squad) |
 | Conduct Extension | Orchestrates spec-kit phases via sub-agent delegation to reduce context pollution. | `process` | Read+Write | [spec-kit-conduct-ext](https://github.com/twbrandon7/spec-kit-conduct-ext) |

extensions/catalog.community.json

@@ -73,35 +73,6 @@
       "created_at": "2026-03-03T00:00:00Z",
       "updated_at": "2026-03-03T00:00:00Z"
     },
-    "checkpoint": {
-      "name": "Checkpoint Extension",
-      "id": "checkpoint",
-      "description": "An extension to commit the changes made during the middle of the implementation, so you don't end up with just one very large commit at the end.",
-      "author": "aaronrsun",
-      "version": "1.0.0",
-      "download_url": "https://github.com/aaronrsun/spec-kit-checkpoint/archive/refs/tags/v1.0.0.zip",
-      "repository": "https://github.com/aaronrsun/spec-kit-checkpoint",
-      "homepage": "https://github.com/aaronrsun/spec-kit-checkpoint",
-      "documentation": "https://github.com/aaronrsun/spec-kit-checkpoint/blob/main/README.md",
-      "changelog": "https://github.com/aaronrsun/spec-kit-checkpoint/blob/main/CHANGELOG.md",
-      "license": "MIT",
-      "requires": {
-        "speckit_version": ">=0.1.0"
-      },
-      "provides": {
-        "commands": 1,
-        "hooks": 0
-      },
-      "tags": [
-        "checkpoint",
-        "commit"
-      ],
-      "verified": false,
-      "downloads": 0,
-      "stars": 0,
-      "created_at": "2026-03-22T00:00:00Z",
-      "updated_at": "2026-03-22T00:00:00Z"
-    },
     "cleanup": {
       "name": "Cleanup Extension",
       "id": "cleanup",

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "specify-cli"
-version = "0.4.1"
+version = "0.3.2"
 description = "Specify CLI, part of GitHub Spec Kit. A tool to bootstrap your projects for Spec-Driven Development (SDD)."
 requires-python = ">=3.11"
 dependencies = [
@@ -43,6 +43,8 @@ packages = ["src/specify_cli"]
 "scripts/powershell" = "specify_cli/core_pack/scripts/powershell"
 ".github/workflows/scripts/create-release-packages.sh" = "specify_cli/core_pack/release_scripts/create-release-packages.sh"
 ".github/workflows/scripts/create-release-packages.ps1" = "specify_cli/core_pack/release_scripts/create-release-packages.ps1"
+# Official agent packs (embedded in wheel for zero-config offline operation)
+"src/specify_cli/core_pack/agents" = "specify_cli/core_pack/agents"
 
 [project.optional-dependencies]
 test = [

scripts/bash/common.sh

@@ -1,48 +1,15 @@
 #!/usr/bin/env bash
 # Common functions and variables for all scripts
 
-# Find repository root by searching upward for .specify directory
-# This is the primary marker for spec-kit projects
-find_specify_root() {
-    local dir="${1:-$(pwd)}"
-    # Normalize to absolute path to prevent infinite loop with relative paths
-    # Use -- to handle paths starting with - (e.g., -P, -L)
-    dir="$(cd -- "$dir" 2>/dev/null && pwd)" || return 1
-    local prev_dir=""
-    while true; do
-        if [ -d "$dir/.specify" ]; then
-            echo "$dir"
-            return 0
-        fi
-        # Stop if we've reached filesystem root or dirname stops changing
-        if [ "$dir" = "/" ] || [ "$dir" = "$prev_dir" ]; then
-            break
-        fi
-        prev_dir="$dir"
-        dir="$(dirname "$dir")"
-    done
-    return 1
-}
-
-# Get repository root, prioritizing .specify directory over git
-# This prevents using a parent git repo when spec-kit is initialized in a subdirectory
+# Get repository root, with fallback for non-git repositories
 get_repo_root() {
-    # First, look for .specify directory (spec-kit's own marker)
-    local specify_root
-    if specify_root=$(find_specify_root); then
-        echo "$specify_root"
-        return
-    fi
-
-    # Fallback to git if no .specify found
     if git rev-parse --show-toplevel >/dev/null 2>&1; then
         git rev-parse --show-toplevel
-        return
+    else
+        # Fall back to script location for non-git repos
+        local script_dir="$(CDPATH="" cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+        (cd "$script_dir/../../.." && pwd)
     fi
-
-    # Final fallback to script location for non-git repos
-    local script_dir="$(CDPATH="" cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-    (cd "$script_dir/../../.." && pwd)
 }
 
 # Get current branch, with fallback for non-git repositories
@@ -53,14 +20,14 @@ get_current_branch() {
         return
     fi
 
-    # Then check git if available at the spec-kit root (not parent)
-    local repo_root=$(get_repo_root)
-    if has_git; then
-        git -C "$repo_root" rev-parse --abbrev-ref HEAD
+    # Then check git if available
+    if git rev-parse --abbrev-ref HEAD >/dev/null 2>&1; then
+        git rev-parse --abbrev-ref HEAD
         return
     fi
 
     # For non-git repos, try to find the latest feature directory
+    local repo_root=$(get_repo_root)
     local specs_dir="$repo_root/specs"
 
     if [[ -d "$specs_dir" ]]; then
@@ -101,17 +68,9 @@ get_current_branch() {
     echo "main"  # Final fallback
 }
 
-# Check if we have git available at the spec-kit root level
-# Returns true only if git is installed and the repo root is inside a git work tree
-# Handles both regular repos (.git directory) and worktrees/submodules (.git file)
+# Check if we have git available
 has_git() {
-    # First check if git command is available (before calling get_repo_root which may use git)
-    command -v git >/dev/null 2>&1 || return 1
-    local repo_root=$(get_repo_root)
-    # Check if .git exists (directory or file for worktrees/submodules)
-    [ -e "$repo_root/.git" ] || return 1
-    # Verify it's actually a valid git work tree
-    git -C "$repo_root" rev-parse --is-inside-work-tree >/dev/null 2>&1
+    git rev-parse --show-toplevel >/dev/null 2>&1
 }
 
 check_feature_branch() {

scripts/bash/create-new-feature.sh

@@ -80,6 +80,19 @@ if [ -z "$FEATURE_DESCRIPTION" ]; then
     exit 1
 fi
 
+# Function to find the repository root by searching for existing project markers
+find_repo_root() {
+    local dir="$1"
+    while [ "$dir" != "/" ]; do
+        if [ -d "$dir/.git" ] || [ -d "$dir/.specify" ]; then
+            echo "$dir"
+            return 0
+        fi
+        dir="$(dirname "$dir")"
+    done
+    return 1
+}
+
 # Function to get highest number from specs directory
 get_highest_from_specs() {
     local specs_dir="$1"
@@ -158,16 +171,21 @@ clean_branch_name() {
     echo "$name" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/-\+/-/g' | sed 's/^-//' | sed 's/-$//'
 }
 
-# Resolve repository root using common.sh functions which prioritize .specify over git
+# Resolve repository root. Prefer git information when available, but fall back
+# to searching for repository markers so the workflow still functions in repositories that
+# were initialised with --no-git.
 SCRIPT_DIR="$(CDPATH="" cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 source "$SCRIPT_DIR/common.sh"
 
-REPO_ROOT=$(get_repo_root)
-
-# Check if git is available at this repo root (not a parent)
-if has_git; then
+if git rev-parse --show-toplevel >/dev/null 2>&1; then
+    REPO_ROOT=$(git rev-parse --show-toplevel)
     HAS_GIT=true
 else
+    REPO_ROOT="$(find_repo_root "$SCRIPT_DIR")"
+    if [ -z "$REPO_ROOT" ]; then
+        echo "Error: Could not determine repository root. Please run this script from within the repository." >&2
+        exit 1
+    fi
     HAS_GIT=false
 fi
 

scripts/powershell/common.ps1

@@ -1,38 +1,7 @@
 #!/usr/bin/env pwsh
 # Common PowerShell functions analogous to common.sh
 
-# Find repository root by searching upward for .specify directory
-# This is the primary marker for spec-kit projects
-function Find-SpecifyRoot {
-    param([string]$StartDir = (Get-Location).Path)
-
-    # Normalize to absolute path to prevent issues with relative paths
-    # Use -LiteralPath to handle paths with wildcard characters ([, ], *, ?)
-    $current = (Resolve-Path -LiteralPath $StartDir -ErrorAction SilentlyContinue)?.Path
-    if (-not $current) { return $null }
-
-    while ($true) {
-        if (Test-Path -LiteralPath (Join-Path $current ".specify") -PathType Container) {
-            return $current
-        }
-        $parent = Split-Path $current -Parent
-        if ([string]::IsNullOrEmpty($parent) -or $parent -eq $current) {
-            return $null
-        }
-        $current = $parent
-    }
-}
-
-# Get repository root, prioritizing .specify directory over git
-# This prevents using a parent git repo when spec-kit is initialized in a subdirectory
 function Get-RepoRoot {
-    # First, look for .specify directory (spec-kit's own marker)
-    $specifyRoot = Find-SpecifyRoot
-    if ($specifyRoot) {
-        return $specifyRoot
-    }
-
-    # Fallback to git if no .specify found
     try {
         $result = git rev-parse --show-toplevel 2>$null
         if ($LASTEXITCODE -eq 0) {
@@ -41,10 +10,9 @@ function Get-RepoRoot {
     } catch {
         # Git command failed
     }
-
-    # Final fallback to script location for non-git repos
-    # Use -LiteralPath to handle paths with wildcard characters
-    return (Resolve-Path -LiteralPath (Join-Path $PSScriptRoot "../../..")).Path
+    
+    # Fall back to script location for non-git repos
+    return (Resolve-Path (Join-Path $PSScriptRoot "../../..")).Path
 }
 
 function Get-CurrentBranch {
@@ -52,21 +20,19 @@ function Get-CurrentBranch {
     if ($env:SPECIFY_FEATURE) {
         return $env:SPECIFY_FEATURE
     }
-
-    # Then check git if available at the spec-kit root (not parent)
-    $repoRoot = Get-RepoRoot
-    if (Test-HasGit) {
-        try {
-            $result = git -C $repoRoot rev-parse --abbrev-ref HEAD 2>$null
-            if ($LASTEXITCODE -eq 0) {
-                return $result
-            }
-        } catch {
-            # Git command failed
+    
+    # Then check git if available
+    try {
+        $result = git rev-parse --abbrev-ref HEAD 2>$null
+        if ($LASTEXITCODE -eq 0) {
+            return $result
         }
+    } catch {
+        # Git command failed
     }
-
+    
     # For non-git repos, try to find the latest feature directory
+    $repoRoot = Get-RepoRoot
     $specsDir = Join-Path $repoRoot "specs"
     
     if (Test-Path $specsDir) {
@@ -103,23 +69,9 @@ function Get-CurrentBranch {
     return "main"
 }
 
-# Check if we have git available at the spec-kit root level
-# Returns true only if git is installed and the repo root is inside a git work tree
-# Handles both regular repos (.git directory) and worktrees/submodules (.git file)
 function Test-HasGit {
-    # First check if git command is available (before calling Get-RepoRoot which may use git)
-    if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
-        return $false
-    }
-    $repoRoot = Get-RepoRoot
-    # Check if .git exists (directory or file for worktrees/submodules)
-    # Use -LiteralPath to handle paths with wildcard characters
-    if (-not (Test-Path -LiteralPath (Join-Path $repoRoot ".git"))) {
-        return $false
-    }
-    # Verify it's actually a valid git work tree
     try {
-        $null = git -C $repoRoot rev-parse --is-inside-work-tree 2>$null
+        git rev-parse --show-toplevel 2>$null | Out-Null
         return ($LASTEXITCODE -eq 0)
     } catch {
         return $false

scripts/powershell/create-new-feature.ps1

@@ -45,6 +45,30 @@ if ([string]::IsNullOrWhiteSpace($featureDesc)) {
     exit 1
 }
 
+# Resolve repository root. Prefer git information when available, but fall back
+# to searching for repository markers so the workflow still functions in repositories that
+# were initialized with --no-git.
+function Find-RepositoryRoot {
+    param(
+        [string]$StartDir,
+        [string[]]$Markers = @('.git', '.specify')
+    )
+    $current = Resolve-Path $StartDir
+    while ($true) {
+        foreach ($marker in $Markers) {
+            if (Test-Path (Join-Path $current $marker)) {
+                return $current
+            }
+        }
+        $parent = Split-Path $current -Parent
+        if ($parent -eq $current) {
+            # Reached filesystem root without finding markers
+            return $null
+        }
+        $current = $parent
+    }
+}
+
 function Get-HighestNumberFromSpecs {
     param([string]$SpecsDir)
     
@@ -115,14 +139,26 @@ function ConvertTo-CleanBranchName {
     
     return $Name.ToLower() -replace '[^a-z0-9]', '-' -replace '-{2,}', '-' -replace '^-', '' -replace '-$', ''
 }
-# Load common functions (includes Get-RepoRoot, Test-HasGit, Resolve-Template)
+$fallbackRoot = (Find-RepositoryRoot -StartDir $PSScriptRoot)
+if (-not $fallbackRoot) {
+    Write-Error "Error: Could not determine repository root. Please run this script from within the repository."
+    exit 1
+}
+
+# Load common functions (includes Resolve-Template)
 . "$PSScriptRoot/common.ps1"
 
-# Use common.ps1 functions which prioritize .specify over git
-$repoRoot = Get-RepoRoot
-
-# Check if git is available at this repo root (not a parent)
-$hasGit = Test-HasGit
+try {
+    $repoRoot = git rev-parse --show-toplevel 2>$null
+    if ($LASTEXITCODE -eq 0) {
+        $hasGit = $true
+    } else {
+        throw "Git not available"
+    }
+} catch {
+    $repoRoot = $fallbackRoot
+    $hasGit = $false
+}
 
 Set-Location $repoRoot
 

src/specify_cli/agents.py

@@ -47,6 +47,12 @@ class CommandRegistrar:
             "args": "$ARGUMENTS",
             "extension": ".md"
         },
+        "cursor-agent": {
+            "dir": ".cursor/commands",
+            "format": "markdown",
+            "args": "$ARGUMENTS",
+            "extension": ".md"
+        },
         "qwen": {
             "dir": ".qwen/commands",
             "format": "markdown",
@@ -207,7 +213,7 @@ class CommandRegistrar:
         if not fm:
             return ""
 
-        yaml_str = yaml.dump(fm, default_flow_style=False, sort_keys=False, allow_unicode=True)
+        yaml_str = yaml.dump(fm, default_flow_style=False, sort_keys=False)
         return f"---\n{yaml_str}---\n"
 
     def _adjust_script_paths(self, frontmatter: dict) -> dict:

src/specify_cli/core_pack/agents/agy/speckit-agent.yml

@@ -0,0 +1,23 @@
+schema_version: "1.0"
+
+agent:
+  id: "agy"
+  name: "Antigravity"
+  version: "1.0.0"
+  description: "Antigravity IDE for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: false
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['ide', 'antigravity']
+
+command_registration:
+  commands_dir: ".agent/commands"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/amp/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "amp"
+  name: "Amp"
+  version: "1.0.0"
+  description: "Amp CLI for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://ampcode.com/manual#install"
+  cli_tool: "amp"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'amp']
+
+command_registration:
+  commands_dir: ".agents/commands"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/auggie/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "auggie"
+  name: "Auggie CLI"
+  version: "1.0.0"
+  description: "Auggie CLI for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://docs.augmentcode.com/cli/setup-auggie/install-auggie-cli"
+  cli_tool: "auggie"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'augment', 'auggie']
+
+command_registration:
+  commands_dir: ".augment/commands"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/bob/speckit-agent.yml

@@ -0,0 +1,23 @@
+schema_version: "1.0"
+
+agent:
+  id: "bob"
+  name: "IBM Bob"
+  version: "1.0.0"
+  description: "IBM Bob IDE for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: false
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['ide', 'ibm', 'bob']
+
+command_registration:
+  commands_dir: ".bob/commands"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/claude/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "claude"
+  name: "Claude Code"
+  version: "1.0.0"
+  description: "Anthropic's Claude Code CLI for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://docs.anthropic.com/en/docs/claude-code/setup"
+  cli_tool: "claude"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'anthropic', 'claude']
+
+command_registration:
+  commands_dir: ".claude/commands"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/codebuddy/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "codebuddy"
+  name: "CodeBuddy"
+  version: "1.0.0"
+  description: "CodeBuddy CLI for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://www.codebuddy.ai/cli"
+  cli_tool: "codebuddy"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'codebuddy']
+
+command_registration:
+  commands_dir: ".codebuddy/commands"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/codex/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "codex"
+  name: "Codex CLI"
+  version: "1.0.0"
+  description: "OpenAI Codex CLI with project skills support"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://github.com/openai/codex"
+  cli_tool: "codex"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'openai', 'codex', 'skills']
+
+command_registration:
+  commands_dir: ".agents/skills"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: "/SKILL.md"

src/specify_cli/core_pack/agents/copilot/speckit-agent.yml

@@ -0,0 +1,23 @@
+schema_version: "1.0"
+
+agent:
+  id: "copilot"
+  name: "GitHub Copilot"
+  version: "1.0.0"
+  description: "GitHub Copilot for AI-assisted development in VS Code"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: false
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['ide', 'github', 'copilot']
+
+command_registration:
+  commands_dir: ".github/agents"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".agent.md"

src/specify_cli/core_pack/agents/cursor-agent/speckit-agent.yml

@@ -0,0 +1,23 @@
+schema_version: "1.0"
+
+agent:
+  id: "cursor-agent"
+  name: "Cursor"
+  version: "1.0.0"
+  description: "Cursor IDE for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: false
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['ide', 'cursor']
+
+command_registration:
+  commands_dir: ".cursor/commands"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/gemini/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "gemini"
+  name: "Gemini CLI"
+  version: "1.0.0"
+  description: "Google's Gemini CLI for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://github.com/google-gemini/gemini-cli"
+  cli_tool: "gemini"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'google', 'gemini']
+
+command_registration:
+  commands_dir: ".gemini/commands"
+  format: "toml"
+  arg_placeholder: "{{args}}"
+  file_extension: ".toml"

src/specify_cli/core_pack/agents/iflow/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "iflow"
+  name: "iFlow CLI"
+  version: "1.0.0"
+  description: "iFlow CLI by iflow-ai for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://docs.iflow.cn/en/cli/quickstart"
+  cli_tool: "iflow"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'iflow']
+
+command_registration:
+  commands_dir: ".iflow/commands"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/junie/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "junie"
+  name: "Junie"
+  version: "1.0.0"
+  description: "Junie by JetBrains for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://junie.jetbrains.com/"
+  cli_tool: "junie"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'jetbrains', 'junie']
+
+command_registration:
+  commands_dir: ".junie/commands"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/kilocode/speckit-agent.yml

@@ -0,0 +1,23 @@
+schema_version: "1.0"
+
+agent:
+  id: "kilocode"
+  name: "Kilo Code"
+  version: "1.0.0"
+  description: "Kilo Code IDE for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: false
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['ide', 'kilocode']
+
+command_registration:
+  commands_dir: ".kilocode/workflows"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/kimi/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "kimi"
+  name: "Kimi Code"
+  version: "1.0.0"
+  description: "Kimi Code CLI by Moonshot AI with skills support"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://code.kimi.com/"
+  cli_tool: "kimi"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'moonshot', 'kimi', 'skills']
+
+command_registration:
+  commands_dir: ".kimi/skills"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: "/SKILL.md"

src/specify_cli/core_pack/agents/kiro-cli/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "kiro-cli"
+  name: "Kiro CLI"
+  version: "1.0.0"
+  description: "Kiro CLI by Amazon for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://kiro.dev/docs/cli/"
+  cli_tool: "kiro-cli"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'amazon', 'kiro']
+
+command_registration:
+  commands_dir: ".kiro/prompts"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/opencode/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "opencode"
+  name: "opencode"
+  version: "1.0.0"
+  description: "opencode CLI for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://opencode.ai"
+  cli_tool: "opencode"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'opencode']
+
+command_registration:
+  commands_dir: ".opencode/command"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/pi/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "pi"
+  name: "Pi Coding Agent"
+  version: "1.0.0"
+  description: "Pi terminal coding agent for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://www.npmjs.com/package/@mariozechner/pi-coding-agent"
+  cli_tool: "pi"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'pi']
+
+command_registration:
+  commands_dir: ".pi/prompts"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/qodercli/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "qodercli"
+  name: "Qoder CLI"
+  version: "1.0.0"
+  description: "Qoder CLI for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://qoder.com/cli"
+  cli_tool: "qodercli"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'qoder']
+
+command_registration:
+  commands_dir: ".qoder/commands"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/qwen/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "qwen"
+  name: "Qwen Code"
+  version: "1.0.0"
+  description: "Alibaba's Qwen Code CLI for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://github.com/QwenLM/qwen-code"
+  cli_tool: "qwen"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'alibaba', 'qwen']
+
+command_registration:
+  commands_dir: ".qwen/commands"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/roo/speckit-agent.yml

@@ -0,0 +1,23 @@
+schema_version: "1.0"
+
+agent:
+  id: "roo"
+  name: "Roo Code"
+  version: "1.0.0"
+  description: "Roo Code IDE for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: false
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['ide', 'roo']
+
+command_registration:
+  commands_dir: ".roo/commands"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/shai/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "shai"
+  name: "SHAI"
+  version: "1.0.0"
+  description: "SHAI CLI for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://github.com/ovh/shai"
+  cli_tool: "shai"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'ovh', 'shai']
+
+command_registration:
+  commands_dir: ".shai/commands"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/tabnine/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "tabnine"
+  name: "Tabnine CLI"
+  version: "1.0.0"
+  description: "Tabnine CLI for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://docs.tabnine.com/main/getting-started/tabnine-cli"
+  cli_tool: "tabnine"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'tabnine']
+
+command_registration:
+  commands_dir: ".tabnine/agent/commands"
+  format: "toml"
+  arg_placeholder: "{{args}}"
+  file_extension: ".toml"

src/specify_cli/core_pack/agents/trae/speckit-agent.yml

@@ -0,0 +1,23 @@
+schema_version: "1.0"
+
+agent:
+  id: "trae"
+  name: "Trae"
+  version: "1.0.0"
+  description: "Trae IDE for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: false
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['ide', 'trae']
+
+command_registration:
+  commands_dir: ".trae/rules"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/vibe/speckit-agent.yml

@@ -0,0 +1,25 @@
+schema_version: "1.0"
+
+agent:
+  id: "vibe"
+  name: "Mistral Vibe"
+  version: "1.0.0"
+  description: "Mistral Vibe CLI for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: true
+  install_url: "https://github.com/mistralai/mistral-vibe"
+  cli_tool: "vibe"
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['cli', 'mistral', 'vibe']
+
+command_registration:
+  commands_dir: ".vibe/prompts"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/core_pack/agents/windsurf/speckit-agent.yml

@@ -0,0 +1,23 @@
+schema_version: "1.0"
+
+agent:
+  id: "windsurf"
+  name: "Windsurf"
+  version: "1.0.0"
+  description: "Windsurf IDE for AI-assisted development"
+  author: "github"
+  license: "MIT"
+
+runtime:
+  requires_cli: false
+
+requires:
+  speckit_version: ">=0.1.0"
+
+tags: ['ide', 'windsurf']
+
+command_registration:
+  commands_dir: ".windsurf/workflows"
+  format: "markdown"
+  arg_placeholder: "$ARGUMENTS"
+  file_extension: ".md"

src/specify_cli/extensions.py

@@ -975,8 +975,8 @@ class ExtensionCatalog:
         if not config_path.exists():
             return None
         try:
-            data = yaml.safe_load(config_path.read_text(encoding="utf-8")) or {}
-        except (yaml.YAMLError, OSError, UnicodeError) as e:
+            data = yaml.safe_load(config_path.read_text()) or {}
+        except (yaml.YAMLError, OSError) as e:
             raise ValidationError(
                 f"Failed to read catalog config {config_path}: {e}"
             )
@@ -1467,8 +1467,8 @@ class ConfigManager:
             return {}
 
         try:
-            return yaml.safe_load(file_path.read_text(encoding="utf-8")) or {}
-        except (yaml.YAMLError, OSError, UnicodeError):
+            return yaml.safe_load(file_path.read_text()) or {}
+        except (yaml.YAMLError, OSError):
             return {}
 
     def _get_extension_defaults(self) -> Dict[str, Any]:
@@ -1659,8 +1659,8 @@ class HookExecutor:
             }
 
         try:
-            return yaml.safe_load(self.config_file.read_text(encoding="utf-8")) or {}
-        except (yaml.YAMLError, OSError, UnicodeError):
+            return yaml.safe_load(self.config_file.read_text()) or {}
+        except (yaml.YAMLError, OSError):
             return {
                 "installed": [],
                 "settings": {"auto_execute_hooks": True},
@@ -1675,8 +1675,7 @@ class HookExecutor:
         """
         self.config_file.parent.mkdir(parents=True, exist_ok=True)
         self.config_file.write_text(
-            yaml.dump(config, default_flow_style=False, sort_keys=False, allow_unicode=True),
-            encoding="utf-8",
+            yaml.dump(config, default_flow_style=False, sort_keys=False)
         )
 
     def register_hooks(self, manifest: ExtensionManifest):

src/specify_cli/presets.py

@@ -1062,8 +1062,8 @@ class PresetCatalog:
         if not config_path.exists():
             return None
         try:
-            data = yaml.safe_load(config_path.read_text(encoding="utf-8")) or {}
-        except (yaml.YAMLError, OSError, UnicodeError) as e:
+            data = yaml.safe_load(config_path.read_text()) or {}
+        except (yaml.YAMLError, OSError) as e:
             raise PresetValidationError(
                 f"Failed to read catalog config {config_path}: {e}"
             )

templates/spec-template.md

@@ -113,16 +113,3 @@
 - **SC-002**: [Measurable metric, e.g., "System handles 1000 concurrent users without degradation"]
 - **SC-003**: [User satisfaction metric, e.g., "90% of users successfully complete primary task on first attempt"]
 - **SC-004**: [Business metric, e.g., "Reduce support tickets related to [X] by 50%"]
-
-## Assumptions
-
-<!--
-  ACTION REQUIRED: The content in this section represents placeholders.
-  Fill them out with the right assumptions based on reasonable defaults
-  chosen when the feature description did not specify certain details.
--->
-
-- [Assumption about target users, e.g., "Users have stable internet connectivity"]
-- [Assumption about scope boundaries, e.g., "Mobile support is out of scope for v1"]
-- [Assumption about data/environment, e.g., "Existing authentication system will be reused"]
-- [Dependency on existing system/service, e.g., "Requires access to the existing user profile API"]

tests/test_ai_skills.py

@@ -11,12 +11,10 @@ Tests cover:
 """
 
 import re
-import zipfile
 import pytest
 import tempfile
 import shutil
 import yaml
-import typer
 from pathlib import Path
 from unittest.mock import patch
 
@@ -722,8 +720,8 @@ class TestNewProjectCommandSkip:
         mock_skills.assert_not_called()
         assert (target / ".agents" / "skills" / "speckit-specify" / "SKILL.md").exists()
 
-    def test_codex_native_skills_missing_falls_back_then_fails_cleanly(self, tmp_path):
-        """Codex should attempt fallback conversion when bundled skills are missing."""
+    def test_codex_native_skills_missing_fails_clearly(self, tmp_path):
+        """Codex native skills init should fail if bundled skills are missing."""
         from typer.testing import CliRunner
 
         runner = CliRunner()
@@ -732,7 +730,7 @@ class TestNewProjectCommandSkip:
         with patch("specify_cli.download_and_extract_template", lambda *args, **kwargs: None), \
              patch("specify_cli.ensure_executable_scripts"), \
              patch("specify_cli.ensure_constitution_from_template"), \
-             patch("specify_cli.install_ai_skills", return_value=False) as mock_skills, \
+             patch("specify_cli.install_ai_skills") as mock_skills, \
              patch("specify_cli.is_git_repo", return_value=False), \
              patch("specify_cli.shutil.which", return_value="/usr/bin/codex"):
             result = runner.invoke(
@@ -741,13 +739,11 @@ class TestNewProjectCommandSkip:
             )
 
         assert result.exit_code == 1
-        mock_skills.assert_called_once()
-        assert mock_skills.call_args.kwargs.get("overwrite_existing") is True
+        mock_skills.assert_not_called()
         assert "Expected bundled agent skills" in result.output
-        assert "fallback conversion failed" in result.output
 
     def test_codex_native_skills_ignores_non_speckit_skill_dirs(self, tmp_path):
-        """Non-spec-kit SKILL.md files should trigger fallback conversion, not hard-fail."""
+        """Non-spec-kit SKILL.md files should not satisfy Codex bundled-skills validation."""
         from typer.testing import CliRunner
 
         runner = CliRunner()
@@ -761,7 +757,7 @@ class TestNewProjectCommandSkip:
         with patch("specify_cli.download_and_extract_template", side_effect=fake_download), \
              patch("specify_cli.ensure_executable_scripts"), \
              patch("specify_cli.ensure_constitution_from_template"), \
-             patch("specify_cli.install_ai_skills", return_value=True) as mock_skills, \
+             patch("specify_cli.install_ai_skills") as mock_skills, \
              patch("specify_cli.is_git_repo", return_value=False), \
              patch("specify_cli.shutil.which", return_value="/usr/bin/codex"):
             result = runner.invoke(
@@ -769,100 +765,9 @@ class TestNewProjectCommandSkip:
                 ["init", str(target), "--ai", "codex", "--ai-skills", "--script", "sh", "--no-git"],
             )
 
-        assert result.exit_code == 0
-        mock_skills.assert_called_once()
-        assert mock_skills.call_args.kwargs.get("overwrite_existing") is True
-
-    def test_codex_ai_skills_here_mode_preserves_existing_codex_dir(self, tmp_path, monkeypatch):
-        """Codex --here skills init should not delete a pre-existing .codex directory."""
-        from typer.testing import CliRunner
-
-        runner = CliRunner()
-        target = tmp_path / "codex-preserve-here"
-        target.mkdir()
-        existing_prompts = target / ".codex" / "prompts"
-        existing_prompts.mkdir(parents=True)
-        (existing_prompts / "custom.md").write_text("custom")
-        monkeypatch.chdir(target)
-
-        with patch("specify_cli.download_and_extract_template", return_value=target), \
-             patch("specify_cli.ensure_executable_scripts"), \
-             patch("specify_cli.ensure_constitution_from_template"), \
-             patch("specify_cli.install_ai_skills", return_value=True), \
-             patch("specify_cli.is_git_repo", return_value=True), \
-             patch("specify_cli.shutil.which", return_value="/usr/bin/codex"):
-            result = runner.invoke(
-                app,
-                ["init", "--here", "--ai", "codex", "--ai-skills", "--script", "sh", "--no-git"],
-                input="y\n",
-            )
-
-        assert result.exit_code == 0
-        assert (target / ".codex").exists()
-        assert (existing_prompts / "custom.md").exists()
-
-    def test_codex_ai_skills_fresh_dir_does_not_create_codex_dir(self, tmp_path):
-        """Fresh-directory Codex skills init should not leave legacy .codex from archive."""
-        target = tmp_path / "fresh-codex-proj"
-        archive = tmp_path / "codex-template.zip"
-
-        with zipfile.ZipFile(archive, "w") as zf:
-            zf.writestr("template-root/.codex/prompts/speckit.specify.md", "legacy")
-            zf.writestr("template-root/.specify/templates/constitution-template.md", "constitution")
-
-        fake_meta = {
-            "filename": archive.name,
-            "size": archive.stat().st_size,
-            "release": "vtest",
-            "asset_url": "https://example.invalid/template.zip",
-        }
-
-        with patch("specify_cli.download_template_from_github", return_value=(archive, fake_meta)):
-            specify_cli.download_and_extract_template(
-                target,
-                "codex",
-                "sh",
-                is_current_dir=False,
-                skip_legacy_codex_prompts=True,
-                verbose=False,
-            )
-
-        assert target.exists()
-        assert (target / ".specify").exists()
-        assert not (target / ".codex").exists()
-
-    @pytest.mark.parametrize("is_current_dir", [False, True])
-    def test_download_and_extract_template_blocks_zip_path_traversal(self, tmp_path, monkeypatch, is_current_dir):
-        """Extraction should reject ZIP members escaping the target directory."""
-        target = (tmp_path / "here-proj") if is_current_dir else (tmp_path / "new-proj")
-        if is_current_dir:
-            target.mkdir()
-            monkeypatch.chdir(target)
-
-        archive = tmp_path / "malicious-template.zip"
-        with zipfile.ZipFile(archive, "w") as zf:
-            zf.writestr("../evil.txt", "pwned")
-            zf.writestr("template-root/.specify/templates/constitution-template.md", "constitution")
-
-        fake_meta = {
-            "filename": archive.name,
-            "size": archive.stat().st_size,
-            "release": "vtest",
-            "asset_url": "https://example.invalid/template.zip",
-        }
-
-        with patch("specify_cli.download_template_from_github", return_value=(archive, fake_meta)):
-            with pytest.raises(typer.Exit):
-                specify_cli.download_and_extract_template(
-                    target,
-                    "codex",
-                    "sh",
-                    is_current_dir=is_current_dir,
-                    skip_legacy_codex_prompts=True,
-                    verbose=False,
-                )
-
-        assert not (tmp_path / "evil.txt").exists()
+        assert result.exit_code == 1
+        mock_skills.assert_not_called()
+        assert "Expected bundled agent skills" in result.output
 
     def test_commands_preserved_when_skills_fail(self, tmp_path):
         """If skills fail, commands should NOT be removed (safety net)."""
@@ -954,21 +859,6 @@ class TestSkipIfExists:
         # All 4 templates should produce skills (specify, plan, tasks, empty_fm)
         assert len(skill_dirs) == 4
 
-    def test_existing_skill_overwritten_when_enabled(self, project_dir, templates_dir):
-        """When overwrite_existing=True, pre-existing SKILL.md should be replaced."""
-        skill_dir = project_dir / ".claude" / "skills" / "speckit-specify"
-        skill_dir.mkdir(parents=True)
-        custom_content = "# My Custom Specify Skill\nUser-modified content\n"
-        skill_file = skill_dir / "SKILL.md"
-        skill_file.write_text(custom_content)
-
-        result = install_ai_skills(project_dir, "claude", overwrite_existing=True)
-
-        assert result is True
-        updated_content = skill_file.read_text()
-        assert updated_content != custom_content
-        assert "name: speckit-specify" in updated_content
-
 
 # ===== SKILL_DESCRIPTIONS Coverage Tests =====
 

tests/test_extensions.py

@@ -747,18 +747,6 @@ $ARGUMENTS
         assert output.endswith("---\n")
         assert "description: Test command" in output
 
-    def test_render_frontmatter_unicode(self):
-        """Test rendering frontmatter preserves non-ASCII characters."""
-        frontmatter = {
-            "description": "Prüfe Konformität der Implementierung"
-        }
-
-        registrar = CommandRegistrar()
-        output = registrar.render_frontmatter(frontmatter)
-
-        assert "Prüfe Konformität" in output
-        assert "\\u" not in output
-
     def test_register_commands_for_claude(self, extension_dir, project_dir):
         """Test registering commands for Claude agent."""
         # Create .claude directory