chore: bump version to 0.3.2

2026-03-28 00:03:08 +00:00 · 2026-03-19 13:24:09 +00:00
45 changed files with 830 additions and 6495 deletions
--- a/.devcontainer/post-create.sh
+++ b/.devcontainer/post-create.sh
@@ -51,10 +51,6 @@ echo -e "\n🤖 Installing OpenCode CLI..."
 run_command "npm install -g opencode-ai@latest"
 echo "✅ Done"

-echo -e "\n🤖 Installing Junie CLI..."
-run_command "npm install -g @jetbrains/junie-cli@latest"
-echo "✅ Done"
-
 echo -e "\n🤖 Installing Pi Coding Agent..."
 run_command "npm install -g @mariozechner/pi-coding-agent@latest"
 echo "✅ Done"
--- a/.github/ISSUE_TEMPLATE/agent_request.yml
+++ b/.github/ISSUE_TEMPLATE/agent_request.yml
@@ -8,7 +8,7 @@ body:
      value: |
        Thanks for requesting a new agent! Before submitting, please check if the agent is already supported.
        
-        **Currently supported agents**: Claude Code, Gemini CLI, GitHub Copilot, Cursor, Qwen Code, opencode, Codex CLI, Windsurf, Kilo Code, Auggie CLI, Roo Code, CodeBuddy, Qoder CLI, Kiro CLI, Amp, SHAI, Tabnine CLI, Antigravity, IBM Bob, Mistral Vibe, Kimi Code, Trae, Pi Coding Agent, iFlow CLI
+        **Currently supported agents**: Claude Code, Gemini CLI, GitHub Copilot, Cursor, Qwen Code, opencode, Codex CLI, Windsurf, Kilo Code, Auggie CLI, Roo Code, CodeBuddy, Qoder CLI, Kiro CLI, Amp, SHAI, IBM Bob, Antigravity

  - type: input
    id: agent-name
--- a/.github/ISSUE_TEMPLATE/config.yml
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -7,7 +7,7 @@ contact_links:
    url: https://github.com/github/spec-kit/blob/main/README.md
    about: Read the Spec Kit documentation and guides
  - name: 🛠️ Extension Development Guide
-    url: https://github.com/github/spec-kit/blob/main/extensions/EXTENSION-DEVELOPMENT-GUIDE.md
+    url: https://github.com/manfredseee/spec-kit/blob/main/extensions/EXTENSION-DEVELOPMENT-GUIDE.md
    about: Learn how to develop and publish Spec Kit extensions
  - name: 🤝 Contributing Guide
    url: https://github.com/github/spec-kit/blob/main/CONTRIBUTING.md
--- a/.github/ISSUE_TEMPLATE/preset_submission.yml
+++ b/.github/ISSUE_TEMPLATE/preset_submission.yml
@@ -1,169 +0,0 @@
-name: Preset Submission
-description: Submit your preset to the Spec Kit preset catalog
-title: "[Preset]: Add "
-labels: ["preset-submission", "enhancement", "needs-triage"]
-body:
-  - type: markdown
-    attributes:
-      value: |
-        Thanks for contributing a preset! This template helps you submit your preset to the community catalog.
-        
-        **Before submitting:**
-        - Review the [Preset Publishing Guide](https://github.com/github/spec-kit/blob/main/presets/PUBLISHING.md)
-        - Ensure your preset has a valid `preset.yml` manifest
-        - Create a GitHub release with a version tag (e.g., v1.0.0)
-        - Test installation from the release archive: `specify preset add --from <download-url>`
-
-  - type: input
-    id: preset-id
-    attributes:
-      label: Preset ID
-      description: Unique preset identifier (lowercase with hyphens only)
-      placeholder: "e.g., healthcare-compliance"
-    validations:
-      required: true
-
-  - type: input
-    id: preset-name
-    attributes:
-      label: Preset Name
-      description: Human-readable preset name
-      placeholder: "e.g., Healthcare Compliance"
-    validations:
-      required: true
-
-  - type: input
-    id: version
-    attributes:
-      label: Version
-      description: Semantic version number
-      placeholder: "e.g., 1.0.0"
-    validations:
-      required: true
-
-  - type: textarea
-    id: description
-    attributes:
-      label: Description
-      description: Brief description of what your preset does (under 200 characters)
-      placeholder: Enforces HIPAA-compliant spec workflows with audit templates and compliance checklists
-    validations:
-      required: true
-
-  - type: input
-    id: author
-    attributes:
-      label: Author
-      description: Your name or organization
-      placeholder: "e.g., John Doe or Acme Corp"
-    validations:
-      required: true
-
-  - type: input
-    id: repository
-    attributes:
-      label: Repository URL
-      description: GitHub repository URL for your preset
-      placeholder: "https://github.com/your-org/spec-kit-your-preset"
-    validations:
-      required: true
-
-  - type: input
-    id: download-url
-    attributes:
-      label: Download URL
-      description: URL to the GitHub release archive for your preset (e.g., https://github.com/your-org/spec-kit-preset-your-preset/archive/refs/tags/v1.0.0.zip)
-      placeholder: "https://github.com/your-org/spec-kit-preset-your-preset/archive/refs/tags/v1.0.0.zip"
-    validations:
-      required: true
-
-  - type: input
-    id: license
-    attributes:
-      label: License
-      description: Open source license type
-      placeholder: "e.g., MIT, Apache-2.0"
-    validations:
-      required: true
-
-  - type: input
-    id: speckit-version
-    attributes:
-      label: Required Spec Kit Version
-      description: Minimum Spec Kit version required
-      placeholder: "e.g., >=0.3.0"
-    validations:
-      required: true
-
-  - type: textarea
-    id: templates-provided
-    attributes:
-      label: Templates Provided
-      description: List the template overrides your preset provides
-      placeholder: |
-        - spec-template.md — adds compliance section
-        - plan-template.md — includes audit checkpoints
-        - checklist-template.md — HIPAA compliance checklist
-    validations:
-      required: true
-
-  - type: textarea
-    id: commands-provided
-    attributes:
-      label: Commands Provided (optional)
-      description: List any command overrides your preset provides
-      placeholder: |
-        - speckit.specify.md — customized for compliance workflows
-
-  - type: textarea
-    id: tags
-    attributes:
-      label: Tags
-      description: 2-5 relevant tags (lowercase, separated by commas)
-      placeholder: "compliance, healthcare, hipaa, audit"
-    validations:
-      required: true
-
-  - type: textarea
-    id: features
-    attributes:
-      label: Key Features
-      description: List the main features and capabilities of your preset
-      placeholder: |
-        - HIPAA-compliant spec templates
-        - Audit trail checklists
-        - Compliance review workflow
-    validations:
-      required: true
-
-  - type: checkboxes
-    id: testing
-    attributes:
-      label: Testing Checklist
-      description: Confirm that your preset has been tested
-      options:
-        - label: Preset installs successfully via `specify preset add`
-          required: true
-        - label: Template resolution works correctly after installation
-          required: true
-        - label: Documentation is complete and accurate
-          required: true
-        - label: Tested on at least one real project
-          required: true
-
-  - type: checkboxes
-    id: requirements
-    attributes:
-      label: Submission Requirements
-      description: Verify your preset meets all requirements
-      options:
-        - label: Valid `preset.yml` manifest included
-          required: true
-        - label: README.md with description and usage instructions
-          required: true
-        - label: LICENSE file included
-          required: true
-        - label: GitHub release created with version tag
-          required: true
-        - label: Preset ID follows naming conventions (lowercase-with-hyphens)
-          required: true
--- a/.github/workflows/release-trigger.yml
+++ b/.github/workflows/release-trigger.yml
@@ -86,10 +86,8 @@ jobs:
          if [ -f "CHANGELOG.md" ]; then
            DATE=$(date +%Y-%m-%d)

-            # Get the previous tag by sorting all version tags numerically
-            # (git describe --tags only finds tags reachable from HEAD,
-            #  which misses tags on unmerged release branches)
-            PREVIOUS_TAG=$(git tag -l 'v*' --sort=-version:refname | head -n 1)
+            # Get the previous tag to compare commits
+            PREVIOUS_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")

            echo "Generating changelog from commits..."
            if [[ -n "$PREVIOUS_TAG" ]]; then
@@ -100,16 +98,18 @@ jobs:
              COMMITS="- Initial release"
            fi

-            # Create new changelog entry — insert after the marker comment
-            NEW_ENTRY=$(printf '%s\n' \
-              "" \
-              "## [${{ steps.version.outputs.version }}] - $DATE" \
-              "" \
-              "### Changed" \
-              "" \
-              "$COMMITS")
-
-            awk -v entry="$NEW_ENTRY" '/<!-- insert new changelog below this comment -->/ { print; print entry; next } {print}' CHANGELOG.md > CHANGELOG.md.tmp
+            # Create new changelog entry
+            {
+              head -n 8 CHANGELOG.md
+              echo ""
+              echo "## [${{ steps.version.outputs.version }}] - $DATE"
+              echo ""
+              echo "### Changed"
+              echo ""
+              echo "$COMMITS"
+              echo ""
+              tail -n +9 CHANGELOG.md
+            } > CHANGELOG.md.tmp
            mv CHANGELOG.md.tmp CHANGELOG.md

            echo "✅ Updated CHANGELOG.md with commits since $PREVIOUS_TAG"
--- a/.github/workflows/scripts/create-github-release.sh
+++ b/.github/workflows/scripts/create-github-release.sh
@@ -30,8 +30,6 @@ gh release create "$VERSION" \
  .genreleases/spec-kit-template-qwen-ps-"$VERSION".zip \
  .genreleases/spec-kit-template-windsurf-sh-"$VERSION".zip \
  .genreleases/spec-kit-template-windsurf-ps-"$VERSION".zip \
-  .genreleases/spec-kit-template-junie-sh-"$VERSION".zip \
-  .genreleases/spec-kit-template-junie-ps-"$VERSION".zip \
  .genreleases/spec-kit-template-codex-sh-"$VERSION".zip \
  .genreleases/spec-kit-template-codex-ps-"$VERSION".zip \
  .genreleases/spec-kit-template-kilocode-sh-"$VERSION".zip \
--- a/.github/workflows/scripts/create-release-packages.ps1
+++ b/.github/workflows/scripts/create-release-packages.ps1
@@ -14,7 +14,7 @@

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

 .PARAMETER Scripts
    Comma or space separated subset of script types to build (default: both)
@@ -201,25 +201,20 @@ agent: $basename
    }
 }

-# Create skills in <skills_dir>\<name>\SKILL.md format.
-# Skills use hyphenated names (e.g. speckit-plan).
-#
-# Technical debt note:
-# Keep SKILL.md frontmatter aligned with `install_ai_skills()` and extension
-# overrides (at minimum: name/description/compatibility/metadata.{author,source}).
-function New-Skills {
+# 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,
-        [string]$AgentName,
-        [string]$Separator = '-'
+        [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${Separator}$name"
+        $skillName = "speckit.$name"
        $skillDir = Join-Path $SkillsDir $skillName
        New-Item -ItemType Directory -Force -Path $skillDir | Out-Null

@@ -272,7 +267,7 @@ function New-Skills {

        $body = $outputLines -join "`n"
        $body = $body -replace '\{ARGS\}', '$ARGUMENTS'
-        $body = $body -replace '__AGENT__', $AgentName
+        $body = $body -replace '__AGENT__', 'kimi'
        $body = Rewrite-Paths -Content $body

        # Strip existing frontmatter, keep only body
@@ -288,7 +283,7 @@ function New-Skills {
            if ($inBody) { $templateBody += "$line`n" }
        }

-        $skillContent = "---`nname: `"$skillName`"`ndescription: `"$description`"`ncompatibility: `"Requires spec-kit project structure with .specify/ directory`"`nmetadata:`n  author: `"github-spec-kit`"`n  source: `"templates/commands/$name.md`"`n---`n`n$templateBody"
+        $skillContent = "---`nname: `"$skillName`"`ndescription: `"$description`"`n---`n`n$templateBody"
        Set-Content -Path (Join-Path $skillDir "SKILL.md") -Value $skillContent -NoNewline
    }
 }
@@ -400,14 +395,9 @@ function Build-Variant {
            $cmdDir = Join-Path $baseDir ".windsurf/workflows"
            Generate-Commands -Agent 'windsurf' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
        }
-        'junie' {
-            $cmdDir = Join-Path $baseDir ".junie/commands"
-            Generate-Commands -Agent 'junie' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
-        }
        'codex' {
-            $skillsDir = Join-Path $baseDir ".agents/skills"
-            New-Item -ItemType Directory -Force -Path $skillsDir | Out-Null
-            New-Skills -SkillsDir $skillsDir -ScriptVariant $Script -AgentName 'codex' -Separator '-'
+            $cmdDir = Join-Path $baseDir ".codex/prompts"
+            Generate-Commands -Agent 'codex' -Extension 'md' -ArgFormat '$ARGUMENTS' -OutputDir $cmdDir -ScriptVariant $Script
        }
        'kilocode' {
            $cmdDir = Join-Path $baseDir ".kilocode/workflows"
@@ -462,7 +452,7 @@ function Build-Variant {
        'kimi' {
            $skillsDir = Join-Path $baseDir ".kimi/skills"
            New-Item -ItemType Directory -Force -Path $skillsDir | Out-Null
-            New-Skills -SkillsDir $skillsDir -ScriptVariant $Script -AgentName 'kimi'
+            New-KimiSkills -SkillsDir $skillsDir -ScriptVariant $Script
        }
        'trae' {
            $rulesDir = Join-Path $baseDir ".trae/rules"
@@ -493,7 +483,7 @@ function Build-Variant {
 }

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

 function Normalize-List {
--- 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 junie codex kilocode auggie roo codebuddy amp shai tabnine kiro-cli agy bob vibe qodercli kimi trae pi iflow 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 kimi trae pi iflow generic (default: all)
 #     SCRIPTS : space or comma separated subset of: sh ps (default: both)
 #   Examples:
 #     AGENTS=claude SCRIPTS=sh $0 v0.2.0
@@ -26,27 +26,9 @@ fi
 echo "Building release packages for $NEW_VERSION"

 # Create and use .genreleases directory for all build artifacts
-# Override via GENRELEASES_DIR env var (e.g. for tests writing to a temp dir)
-GENRELEASES_DIR="${GENRELEASES_DIR:-.genreleases}"
-
-# Guard against unsafe GENRELEASES_DIR values before cleaning
-if [[ -z "$GENRELEASES_DIR" ]]; then
-  echo "GENRELEASES_DIR must not be empty" >&2
-  exit 1
-fi
-case "$GENRELEASES_DIR" in
-  '/'|'.'|'..')
-    echo "Refusing to use unsafe GENRELEASES_DIR value: $GENRELEASES_DIR" >&2
-    exit 1
-    ;;
-esac
-if [[ "$GENRELEASES_DIR" == *".."* ]]; then
-  echo "Refusing to use GENRELEASES_DIR containing '..' path segments: $GENRELEASES_DIR" >&2
-  exit 1
-fi
-
+GENRELEASES_DIR=".genreleases"
 mkdir -p "$GENRELEASES_DIR"
-rm -rf "${GENRELEASES_DIR%/}/"* || true
+rm -rf "$GENRELEASES_DIR"/* || true

 rewrite_paths() {
  sed -E \
@@ -139,23 +121,18 @@ EOF
  done
 }

-# Create skills in <skills_dir>/<name>/SKILL.md format.
-# Skills use hyphenated names (e.g. speckit-plan).
-#
-# Technical debt note:
-# Keep SKILL.md frontmatter aligned with `install_ai_skills()` and extension
-# overrides (at minimum: name/description/compatibility/metadata.{author,source}).
-create_skills() {
+# 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"
-  local agent_name="$3"
-  local separator="${4:-"-"}"

  for template in templates/commands/*.md; do
    [[ -f "$template" ]] || continue
    local name
    name=$(basename "$template" .md)
-    local skill_name="speckit${separator}${name}"
+    local skill_name="speckit.${name}"
    local skill_dir="${skills_dir}/${skill_name}"
    mkdir -p "$skill_dir"

@@ -198,9 +175,9 @@ create_skills() {
      in_frontmatter && skip_scripts && /^[[:space:]]/ { next }
      { print }
    ')
-    body=$(printf '%s\n' "$body" | sed 's/{ARGS}/\$ARGUMENTS/g' | sed "s/__AGENT__/$agent_name/g" | rewrite_paths)
+    body=$(printf '%s\n' "$body" | sed 's/{ARGS}/\$ARGUMENTS/g' | sed 's/__AGENT__/kimi/g' | rewrite_paths)

-    # Strip existing frontmatter and prepend skills frontmatter.
+    # 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')

@@ -208,10 +185,6 @@ create_skills() {
      printf -- '---\n'
      printf 'name: "%s"\n' "$skill_name"
      printf 'description: "%s"\n' "$description"
-      printf 'compatibility: "%s"\n' "Requires spec-kit project structure with .specify/ directory"
-      printf -- 'metadata:\n'
-      printf '  author: "%s"\n' "github-spec-kit"
-      printf '  source: "%s"\n' "templates/commands/${name}.md"
      printf -- '---\n\n'
      printf '%s\n' "$template_body"
    } > "$skill_dir/SKILL.md"
@@ -245,7 +218,7 @@ build_variant() {
    esac
  fi

-  [[ -d templates ]] && { mkdir -p "$SPEC_DIR/templates"; find templates -type f -not -path "templates/commands/*" -not -name "vscode-settings.json" | while IFS= read -r f; do d="$SPEC_DIR/$(dirname "$f")"; mkdir -p "$d"; cp "$f" "$d/"; done; echo "Copied templates -> .specify/templates"; }
+  [[ -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"; }

  case $agent in
    claude)
@@ -275,12 +248,9 @@ build_variant() {
    windsurf)
      mkdir -p "$base_dir/.windsurf/workflows"
      generate_commands windsurf md "\$ARGUMENTS" "$base_dir/.windsurf/workflows" "$script" ;;
-    junie)
-      mkdir -p "$base_dir/.junie/commands"
-      generate_commands junie md "\$ARGUMENTS" "$base_dir/.junie/commands" "$script" ;;
    codex)
-      mkdir -p "$base_dir/.agents/skills"
-      create_skills "$base_dir/.agents/skills" "$script" "codex" "-" ;;
+      mkdir -p "$base_dir/.codex/prompts"
+      generate_commands codex md "\$ARGUMENTS" "$base_dir/.codex/prompts" "$script" ;;
    kilocode)
      mkdir -p "$base_dir/.kilocode/workflows"
      generate_commands kilocode md "\$ARGUMENTS" "$base_dir/.kilocode/workflows" "$script" ;;
@@ -320,7 +290,7 @@ build_variant() {
      generate_commands vibe md "\$ARGUMENTS" "$base_dir/.vibe/prompts" "$script" ;;
    kimi)
      mkdir -p "$base_dir/.kimi/skills"
-      create_skills "$base_dir/.kimi/skills" "$script" "kimi" ;;
+      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" ;;
@@ -339,38 +309,37 @@ build_variant() {
 }

 # Determine agent list
-ALL_AGENTS=(claude gemini copilot cursor-agent qwen opencode windsurf junie codex kilocode auggie roo codebuddy amp shai tabnine kiro-cli agy bob vibe qodercli kimi trae pi iflow 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 kimi trae pi iflow generic)
 ALL_SCRIPTS=(sh ps)

+norm_list() {
+  tr ',\n' '  ' | awk '{for(i=1;i<=NF;i++){if(!seen[$i]++){printf((out?"\n":"") $i);out=1}}}END{printf("\n")}'
+}
+
 validate_subset() {
-  local type=$1; shift
-  local allowed_str="$1"; shift
+  local type=$1; shift; local -n allowed=$1; shift; local items=("$@")
  local invalid=0
-  for it in "$@"; do
+  for it in "${items[@]}"; do
    local found=0
-    for a in $allowed_str; do
-      if [[ "$it" == "$a" ]]; then found=1; break; fi
-    done
+    for a in "${allowed[@]}"; do [[ $it == "$a" ]] && { found=1; break; }; done
    if [[ $found -eq 0 ]]; then
-      echo "Error: unknown $type '$it' (allowed: $allowed_str)" >&2
+      echo "Error: unknown $type '$it' (allowed: ${allowed[*]})" >&2
      invalid=1
    fi
  done
  return $invalid
 }

-read_list() { tr ',\n' '  ' | awk '{for(i=1;i<=NF;i++){if(!seen[$i]++){printf((out?" ":"") $i);out=1}}}END{printf("\n")}'; }
-
 if [[ -n ${AGENTS:-} ]]; then
-  read -ra AGENT_LIST <<< "$(printf '%s' "$AGENTS" | read_list)"
-  validate_subset agent "${ALL_AGENTS[*]}" "${AGENT_LIST[@]}" || exit 1
+  mapfile -t AGENT_LIST < <(printf '%s' "$AGENTS" | norm_list)
+  validate_subset agent ALL_AGENTS "${AGENT_LIST[@]}" || exit 1
 else
  AGENT_LIST=("${ALL_AGENTS[@]}")
 fi

 if [[ -n ${SCRIPTS:-} ]]; then
-  read -ra SCRIPT_LIST <<< "$(printf '%s' "$SCRIPTS" | read_list)"
-  validate_subset script "${ALL_SCRIPTS[*]}" "${SCRIPT_LIST[@]}" || exit 1
+  mapfile -t SCRIPT_LIST < <(printf '%s' "$SCRIPTS" | norm_list)
+  validate_subset script ALL_SCRIPTS "${SCRIPT_LIST[@]}" || exit 1
 else
  SCRIPT_LIST=("${ALL_SCRIPTS[@]}")
 fi
--- a/.github/workflows/stale.yml
+++ b/.github/workflows/stale.yml
@@ -39,4 +39,4 @@ jobs:
          any-of-labels: ''
          
          # Operations per run (helps avoid rate limits)
-          operations-per-run: 250
+          operations-per-run: 100
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -33,9 +33,8 @@ Specify supports multiple AI agents by generating agent-specific command files a
 | **Cursor**                 | `.cursor/commands/`    | Markdown | `cursor-agent`  | Cursor CLI                  |
 | **Qwen Code**              | `.qwen/commands/`      | Markdown | `qwen`          | Alibaba's Qwen Code CLI     |
 | **opencode**               | `.opencode/command/`   | Markdown | `opencode`      | opencode CLI                |
-| **Codex CLI**              | `.agents/skills/`      | Markdown | `codex`         | Codex CLI (skills)          |
+| **Codex CLI**              | `.codex/prompts/`      | Markdown | `codex`         | Codex CLI                   |
 | **Windsurf**               | `.windsurf/workflows/` | Markdown | N/A (IDE-based) | Windsurf IDE workflows      |
-| **Junie**                  | `.junie/commands/`     | Markdown | `junie`         | Junie by JetBrains          |
 | **Kilo Code**              | `.kilocode/workflows/` | Markdown | N/A (IDE-based) | Kilo Code IDE               |
 | **Auggie CLI**             | `.augment/commands/`   | Markdown | `auggie`        | Auggie CLI                  |
 | **Roo Code**               | `.roo/commands/`       | Markdown | N/A (IDE-based) | Roo Code IDE                |
@@ -319,7 +318,6 @@ Require a command-line tool to be installed:
 - **Cursor**: `cursor-agent` CLI
 - **Qwen Code**: `qwen` CLI
 - **opencode**: `opencode` CLI
- **Junie**: `junie` CLI
 - **Kiro CLI**: `kiro-cli` CLI
 - **CodeBuddy CLI**: `codebuddy` CLI
 - **Qoder CLI**: `qodercli` CLI
@@ -341,7 +339,7 @@ Work within integrated development environments:

 ### Markdown Format

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

 **Standard format:**

@@ -379,9 +377,8 @@ Command content with {SCRIPT} and {{args}} placeholders.
 ## Directory Conventions

 - **CLI agents**: Usually `.<agent-name>/commands/`
- **Skills-based exceptions**:
-  - Codex: `.agents/skills/` (skills, invoked as `$speckit-<command>`)
- **Prompt-based exceptions**:
+- **Common prompt-based exceptions**:
+  - Codex: `.codex/prompts/`
  - Kiro CLI: `.kiro/prompts/`
  - Pi: `.pi/prompts/`
 - **IDE agents**: Follow IDE-specific patterns:
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
--- a/README.md
+++ b/README.md
@@ -22,10 +22,7 @@
 - [🤔 What is Spec-Driven Development?](#-what-is-spec-driven-development)
 - [⚡ Get Started](#-get-started)
 - [📽️ Video Overview](#️-video-overview)
- [🧩 Community Extensions](#-community-extensions)
- [🎨 Community Presets](#-community-presets)
 - [🚶 Community Walkthroughs](#-community-walkthroughs)
- [🛠️ Community Friends](#️-community-friends)
 - [🤖 Supported AI Agents](#-supported-ai-agents)
 - [🔧 Specify CLI Reference](#-specify-cli-reference)
 - [🧩 Making Spec Kit Your Own: Extensions & Presets](#-making-spec-kit-your-own-extensions--presets)
@@ -52,13 +49,9 @@ Choose your preferred installation method:

 #### Option 1: Persistent Installation (Recommended)

-Install once and use everywhere. Pin a specific release tag for stability (check [Releases](https://github.com/github/spec-kit/releases) for the latest):
+Install once and use everywhere:

 ```bash
-# Install a specific stable release (recommended — replace vX.Y.Z with the latest tag)
-uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@vX.Y.Z
-
-# Or install latest from main (may include unreleased changes)
 uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
 ```

@@ -80,7 +73,7 @@ specify check
 To upgrade Specify, see the [Upgrade Guide](./docs/upgrade.md) for detailed instructions. Quick upgrade:

 ```bash
-uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git@vX.Y.Z
+uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git
 ```

 #### Option 2: One-time Usage
@@ -88,13 +81,13 @@ uv tool install specify-cli --force --from git+https://github.com/github/spec-ki
 Run directly without installing:

 ```bash
-# Create new project (pinned to a stable release — replace vX.Y.Z with the latest tag)
-uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <PROJECT_NAME>
+# Create new project
+uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME>

 # Or initialize in existing project
-uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init . --ai claude
+uvx --from git+https://github.com/github/spec-kit.git specify init . --ai claude
 # or
-uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init --here --ai claude
+uvx --from git+https://github.com/github/spec-kit.git specify init --here --ai claude
 ```

 **Benefits of persistent installation:**
@@ -104,13 +97,9 @@ uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init --here
 - Better tool management with `uv tool list`, `uv tool upgrade`, `uv tool uninstall`
 - Cleaner shell configuration

-#### Option 3: Enterprise / Air-Gapped Installation
-
-If your environment blocks access to PyPI or GitHub, see the [Enterprise / Air-Gapped Installation](./docs/installation.md#enterprise--air-gapped-installation) guide for step-by-step instructions on using `pip download` to create portable, OS-specific wheel bundles on a connected machine.
-
 ### 2. Establish project principles

-Launch your AI assistant in the project directory. Most agents expose spec-kit as `/speckit.*` slash commands; Codex CLI in skills mode uses `$speckit-*` instead.
+Launch your AI assistant in the project directory. The `/speckit.*` commands are available in the assistant.

 Use the **`/speckit.constitution`** command to create your project's governing principles and development guidelines that will guide all subsequent development.

@@ -158,56 +147,6 @@ Want to see Spec Kit in action? Watch our [video overview](https://www.youtube.c

 [![Spec Kit video header](/media/spec-kit-video-header.jpg)](https://www.youtube.com/watch?v=a9eR1xsfvHg&pp=0gcJCckJAYcqIYzv)

-## 🧩 Community Extensions
-
-The following community-contributed extensions are available in [`catalog.community.json`](extensions/catalog.community.json):
-
-**Categories:** `docs` — reads, validates, or generates spec artifacts · `code` — reviews, validates, or modifies source code · `process` — orchestrates workflow across phases · `integration` — syncs with external platforms · `visibility` — reports on project health or progress
-
-**Effect:** `Read-only` — produces reports without modifying files · `Read+Write` — modifies files, creates artifacts, or updates specs
-
-| Extension | Purpose | Category | Effect | URL |
-|-----------|---------|----------|--------|-----|
-| AI-Driven Engineering (AIDE) | A structured 7-step workflow for building new projects from scratch with AI assistants — from vision through implementation | `process` | Read+Write | [aide](https://github.com/mnriem/spec-kit-extensions/tree/main/aide) |
-| 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) |
-| DocGuard — CDD Enforcement | Canonical-Driven Development enforcement. Validates, scores, and traces project documentation with automated checks, AI-driven workflows, and spec-kit hooks. Zero NPM runtime dependencies. | `docs` | Read+Write | [spec-kit-docguard](https://github.com/raccioly/docguard) |
-| Extensify | Create and validate extensions and extension catalogs | `process` | Read+Write | [extensify](https://github.com/mnriem/spec-kit-extensions/tree/main/extensify) |
-| Fleet Orchestrator | Orchestrate a full feature lifecycle with human-in-the-loop gates across all SpecKit phases | `process` | Read+Write | [spec-kit-fleet](https://github.com/sharathsatish/spec-kit-fleet) |
-| Iterate | Iterate on spec documents with a two-phase define-and-apply workflow — refine specs mid-implementation and go straight back to building | `docs` | Read+Write | [spec-kit-iterate](https://github.com/imviancagrace/spec-kit-iterate) |
-| Jira Integration | Create Jira Epics, Stories, and Issues from spec-kit specifications and task breakdowns with configurable hierarchy and custom field support | `integration` | Read+Write | [spec-kit-jira](https://github.com/mbachorik/spec-kit-jira) |
-| Learning Extension | Generate educational guides from implementations and enhance clarifications with mentoring context | `docs` | Read+Write | [spec-kit-learn](https://github.com/imviancagrace/spec-kit-learn) |
-| Presetify | Create and validate presets and preset catalogs | `process` | Read+Write | [presetify](https://github.com/mnriem/spec-kit-extensions/tree/main/presetify) |
-| Project Health Check | Diagnose a Spec Kit project and report health issues across structure, agents, features, scripts, extensions, and git | `visibility` | Read-only | [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 | `visibility` | Read-only | [spec-kit-status](https://github.com/KhawarHabibKhan/spec-kit-status) |
-| Ralph Loop | Autonomous implementation loop using AI agent CLI | `code` | Read+Write | [spec-kit-ralph](https://github.com/Rubiss/spec-kit-ralph) |
-| Reconcile Extension | Reconcile implementation drift by surgically updating feature artifacts. | `docs` | Read+Write | [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 | `docs` | Read+Write | [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 | `code` | Read-only | [spec-kit-review](https://github.com/ismaelJimenez/spec-kit-review) |
-| SDD Utilities | Resume interrupted workflows, validate project health, and verify spec-to-task traceability | `process` | Read+Write | [speckit-utils](https://github.com/mvanhorn/speckit-utils) |
-| Spec Sync | Detect and resolve drift between specs and implementation. AI-assisted resolution with human approval | `docs` | Read+Write | [spec-kit-sync](https://github.com/bgervin/spec-kit-sync) |
-| Understanding | Automated requirements quality analysis — 31 deterministic metrics against IEEE/ISO standards with experimental energy-based ambiguity detection | `docs` | Read-only | [understanding](https://github.com/Testimonial/understanding) |
-| V-Model Extension Pack | Enforces V-Model paired generation of development specs and test specs with full traceability | `docs` | Read+Write | [spec-kit-v-model](https://github.com/leocamello/spec-kit-v-model) |
-| Verify Extension | Post-implementation quality gate that validates implemented code against specification artifacts | `code` | Read-only | [spec-kit-verify](https://github.com/ismaelJimenez/spec-kit-verify) |
-| Verify Tasks Extension | Detect phantom completions: tasks marked [X] in tasks.md with no real implementation | `code` | Read-only | [spec-kit-verify-tasks](https://github.com/datastone-inc/spec-kit-verify-tasks) |
-
-To submit your own extension, see the [Extension Publishing Guide](extensions/EXTENSION-PUBLISHING-GUIDE.md).
-
-## 🎨 Community Presets
-
-The following community-contributed presets customize how Spec Kit behaves — overriding templates, commands, and terminology without changing any tooling. Presets are available in [`catalog.community.json`](presets/catalog.community.json):
-
-| Preset | Purpose | Provides | Requires | URL |
-|--------|---------|----------|----------|-----|
-| AIDE In-Place Migration | Adapts the AIDE extension workflow for in-place technology migrations (X → Y pattern) — adds migration objectives, verification gates, knowledge documents, and behavioral equivalence criteria | 2 templates, 8 commands | AIDE extension | [spec-kit-presets](https://github.com/mnriem/spec-kit-presets) |
-| Pirate Speak (Full) | Transforms all Spec Kit output into pirate speak — specs become "Voyage Manifests", plans become "Battle Plans", tasks become "Crew Assignments" | 6 templates, 9 commands | — | [spec-kit-presets](https://github.com/mnriem/spec-kit-presets) |
-
-To build and publish your own preset, see the [Presets Publishing Guide](presets/PUBLISHING.md).
-
 ## 🚶 Community Walkthroughs

 See Spec-Driven Development in action across different scenarios with these community-contributed walkthroughs:
@@ -224,16 +163,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.
-
-## 🛠️ Community Friends
-
-Community projects that extend, visualize, or build on Spec Kit:
-
- **[cc-sdd](https://github.com/rhuss/cc-sdd)** - A Claude Code plugin that adds composable traits on top of Spec Kit with [Superpowers](https://github.com/obra/superpowers)-based quality gates, spec/code review, git worktree isolation, and parallel implementation via agent teams.
-
- **[Spec Kit Assistant](https://marketplace.visualstudio.com/items?itemName=rfsales.speckit-assistant)** — A VS Code extension that provides a visual orchestrator for the full SDD workflow (constitution → specification → planning → tasks → implementation) with phase status visualization, an interactive task checklist, DAG visualization, and support for Claude, Gemini, GitHub Copilot, and OpenAI backends. Requires the `specify` CLI in your PATH.
-
 ## 🤖 Supported AI Agents

 | Agent                                                                                | Support | Notes                                                                                                                                     |
@@ -244,7 +173,7 @@ Community projects that extend, visualize, or build on Spec Kit:
 | [Auggie CLI](https://docs.augmentcode.com/cli/overview)                              | ✅      |                                                                                                                                           |
 | [Claude Code](https://www.anthropic.com/claude-code)                                 | ✅      |                                                                                                                                           |
 | [CodeBuddy CLI](https://www.codebuddy.ai/cli)                                        | ✅      |                                                                                                                                           |
-| [Codex CLI](https://github.com/openai/codex)                                         | ✅      | Requires `--ai-skills`. Codex recommends [skills](https://developers.openai.com/codex/skills) and treats [custom prompts](https://developers.openai.com/codex/custom-prompts) as deprecated. Spec-kit installs Codex skills into `.agents/skills` and invokes them as `$speckit-<command>`. |
+| [Codex CLI](https://github.com/openai/codex)                                         | ✅      |                                                                                                                                           |
 | [Cursor](https://cursor.sh/)                                                         | ✅      |                                                                                                                                           |
 | [Gemini CLI](https://github.com/google-gemini/gemini-cli)                            | ✅      |                                                                                                                                           |
 | [GitHub Copilot](https://code.visualstudio.com/)                                     | ✅      |                                                                                                                                           |
@@ -261,7 +190,6 @@ Community projects that extend, visualize, or build on Spec Kit:
 | [Kimi Code](https://code.kimi.com/)                                                  | ✅      |                                                                                                                                           |
 | [iFlow CLI](https://docs.iflow.cn/en/cli/quickstart)                                 | ✅      |                                                                                                                                           |
 | [Windsurf](https://windsurf.com/)                                                    | ✅      |                                                                                                                                           |
-| [Junie](https://junie.jetbrains.com/)                                                | ✅      |                                                                                                                                           |
 | [Antigravity (agy)](https://antigravity.google/)                                     | ✅      | Requires `--ai-skills` |
 | [Trae](https://www.trae.ai/)                                                         | ✅      |                                                                                                                                           |
 | Generic                                                                              | ✅      | Bring your own agent — use `--ai generic --ai-commands-dir <path>` for unsupported agents                                                 |
@@ -272,28 +200,27 @@ The `specify` command supports the following options:

 ### Commands

-| Command | Description                                                                                                                                                                                                                                                                              |
-| ------- |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `init`  | Initialize a new Specify project from the latest template                                                                                                                                                                                                                                |
-| `check` | Check for installed tools: `git` plus all CLI-based agents configured in `AGENT_CONFIG` (for example: `claude`, `gemini`, `code`/`code-insiders`, `cursor-agent`, `windsurf`, `junie`, `qwen`, `opencode`, `codex`, `kiro-cli`, `shai`, `qodercli`, `vibe`, `kimi`, `iflow`, `pi`, etc.) |
+| Command | Description                                                                                                                                                                                                                  |
+| ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `init`  | Initialize a new Specify project from the latest template                                                                                                                                                                    |
+| `check` | Check for installed tools: `git` plus all CLI-based agents configured in `AGENT_CONFIG` (for example: `claude`, `gemini`, `code`/`code-insiders`, `cursor-agent`, `windsurf`, `qwen`, `opencode`, `codex`, `kiro-cli`, `shai`, `qodercli`, `vibe`, `kimi`, `iflow`, `pi`, etc.) |

 ### `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 (see `AGENT_CONFIG` for the full, up-to-date list). Common options include: `claude`, `gemini`, `copilot`, `cursor-agent`, `qwen`, `opencode`, `codex`, `windsurf`, `junie`, `kilocode`, `auggie`, `roo`, `codebuddy`, `amp`, `shai`, `kiro-cli` (`kiro` alias), `agy`, `bob`, `qodercli`, `vibe`, `kimi`, `iflow`, `pi`, 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                                                                                                                                                                                                                                                                                                                                           |
-| `--no-git`             | Flag     | Skip git repository initialization                                                                                                                                                                                                                                                                                                                                                        |
-| `--here`               | Flag     | Initialize project in the current directory instead of creating a new one                                                                                                                                                                                                                                                                                                                 |
-| `--force`              | Flag     | Force merge/overwrite when initializing in current directory (skip confirmation)                                                                                                                                                                                                                                                                                                          |
-| `--skip-tls`           | Flag     | Skip SSL/TLS verification (not recommended)                                                                                                                                                                                                                                                                                                                                               |
-| `--debug`              | Flag     | Enable detailed debug output for troubleshooting                                                                                                                                                                                                                                                                                                                                          |
-| `--github-token`       | Option   | GitHub token for API requests (or set GH_TOKEN/GITHUB_TOKEN env variable)                                                                                                                                                                                                                                                                                                                 |
-| `--ai-skills`          | Flag     | Install Prompt.MD templates as agent skills in agent-specific `skills/` directory (requires `--ai`). Extension commands are also auto-registered as skills when extensions are added later.                                                                                                                                                                                               |
-| `--branch-numbering`   | Option   | Branch numbering strategy: `sequential` (default — `001`, `002`, `003`) or `timestamp` (`YYYYMMDD-HHMMSS`). Timestamp mode is useful for distributed teams to avoid numbering conflicts                                                                                                                                                                                                  |
+| 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 (see `AGENT_CONFIG` for the full, up-to-date list). Common options include: `claude`, `gemini`, `copilot`, `cursor-agent`, `qwen`, `opencode`, `codex`, `windsurf`, `kilocode`, `auggie`, `roo`, `codebuddy`, `amp`, `shai`, `kiro-cli` (`kiro` alias), `agy`, `bob`, `qodercli`, `vibe`, `kimi`, `iflow`, `pi`, 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                                                                                                                                              |
+| `--no-git`             | Flag     | Skip git repository initialization                                                                                                                                                           |
+| `--here`               | Flag     | Initialize project in the current directory instead of creating a new one                                                                                                                    |
+| `--force`              | Flag     | Force merge/overwrite when initializing in current directory (skip confirmation)                                                                                                             |
+| `--skip-tls`           | Flag     | Skip SSL/TLS verification (not recommended)                                                                                                                                                  |
+| `--debug`              | Flag     | Enable detailed debug output for troubleshooting                                                                                                                                             |
+| `--github-token`       | Option   | GitHub token for API requests (or set GH_TOKEN/GITHUB_TOKEN env variable)                                                                                                                    |
+| `--ai-skills`          | Flag     | Install Prompt.MD templates as agent skills in agent-specific `skills/` directory (requires `--ai`)                                                                                          |

 ### Examples

@@ -331,9 +258,6 @@ specify init my-project --ai bob
 # Initialize with Pi Coding Agent support
 specify init my-project --ai pi

-# Initialize with Codex CLI support
-specify init my-project --ai codex --ai-skills
-
 # Initialize with Antigravity support
 specify init my-project --ai agy --ai-skills

@@ -368,18 +292,13 @@ specify init my-project --ai claude --ai-skills
 # Initialize in current directory with agent skills
 specify init --here --ai gemini --ai-skills

-# Use timestamp-based branch numbering (useful for distributed teams)
-specify init my-project --ai claude --branch-numbering timestamp
-
 # Check system requirements
 specify check
 ```

 ### Available Slash Commands

-After running `specify init`, your AI coding agent will have access to these slash commands for structured development.
-
-For Codex CLI, `--ai-skills` installs spec-kit as agent skills instead of slash-command prompt files. In Codex skills mode, invoke spec-kit as `$speckit-constitution`, `$speckit-specify`, `$speckit-plan`, `$speckit-tasks`, and `$speckit-implement`.
+After running `specify init`, your AI coding agent will have access to these slash commands for structured development:

 #### Core Commands

@@ -443,7 +362,7 @@ specify extension add <extension-name>

 For example, extensions could add Jira integration, post-implementation code review, V-Model test traceability, or project health diagnostics.

-See the [Extensions README](./extensions/README.md) for the full guide and how to build and publish your own. Browse the [community extensions](#-community-extensions) above for what's available.
+See the [Extensions README](./extensions/README.md) for the full guide, the complete community catalog, and how to build and publish your own.

 ### Presets — Customize Existing Workflows

@@ -565,11 +484,11 @@ specify init <project_name> --ai copilot

 # Or in current directory:
 specify init . --ai claude
-specify init . --ai codex --ai-skills
+specify init . --ai codex

 # or use --here flag
 specify init --here --ai claude
-specify init --here --ai codex --ai-skills
+specify init --here --ai codex

 # Force merge into a non-empty current directory
 specify init . --force --ai claude
--- a/SUPPORT.md
+++ b/SUPPORT.md
@@ -1,17 +1,18 @@
 # Support

-## How to get help
+## How to file issues and get help

-Please search existing [issues](https://github.com/github/spec-kit/issues) and [discussions](https://github.com/github/spec-kit/discussions) before creating new ones to avoid duplicates.
+This project uses GitHub issues to track bugs and feature requests. Please search the existing issues before filing new issues to avoid duplicates. For new issues, file your bug or feature request as a new issue.

- Review the [README](./README.md) for getting started instructions and troubleshooting tips
+For help or questions about using this project, please:
+
+- Open a [GitHub issue](https://github.com/github/spec-kit/issues/new) for bug reports, feature requests, or questions about the Spec-Driven Development methodology
 - Check the [comprehensive guide](./spec-driven.md) for detailed documentation on the Spec-Driven Development process
- Ask in [GitHub Discussions](https://github.com/github/spec-kit/discussions) for questions about using Spec Kit or the Spec-Driven Development methodology
- Open a [GitHub issue](https://github.com/github/spec-kit/issues/new) for bug reports and feature requests
+- Review the [README](./README.md) for getting started instructions and troubleshooting tips

 ## Project Status

-**Spec Kit** is under active development and maintained by GitHub staff and the community. We will do our best to respond to support, feature requests, and community questions as time permits.
+**Spec Kit** is under active development and maintained by GitHub staff **AND THE COMMUNITY**. We will do our best to respond to support, feature requests, and community questions in a timely manner.

 ## GitHub Support Policy

--- a/TESTING.md
+++ b/TESTING.md
@@ -1,79 +0,0 @@
-# Manual Testing Guide
-
-Any change that affects a slash command's behavior requires manually testing that command through an AI agent and submitting results with the PR.
-
-## Process
-
-1. **Identify affected commands** — use the [prompt below](#determining-which-tests-to-run) to have your agent analyze your changed files and determine which commands need testing.
-2. **Set up a test project** — scaffold from your local branch (see [Setup](#setup)).
-3. **Run each affected command** — invoke it in your agent, verify it completes successfully, and confirm it produces the expected output (files created, scripts executed, artifacts populated).
-4. **Run prerequisites first** — commands that depend on earlier commands (e.g., `/speckit.tasks` requires `/speckit.plan` which requires `/speckit.specify`) must be run in order.
-5. **Report results** — paste the [reporting template](#reporting-results) into your PR with pass/fail for each command tested.
-
-## Setup
-
-```bash
-# Install the CLI from your local branch
-cd <spec-kit-repo>
-uv venv .venv
-source .venv/bin/activate  # On Windows: .venv\Scripts\activate
-uv pip install -e .
-
-# Initialize a test project using your local changes
-specify init /tmp/speckit-test --ai <agent> --offline
-cd /tmp/speckit-test
-
-# Open in your agent
-```
-
-## Reporting results
-
-Paste this into your PR:
-
-~~~markdown
-## Manual test results
-
-**Agent**: [e.g., GitHub Copilot in VS Code]  |  **OS/Shell**: [e.g., macOS/zsh]
-
-| Command tested | Notes |
-|----------------|-------|
-| `/speckit.command` | |
-~~~
-
-## Determining which tests to run
-
-Copy this prompt into your agent. Include the agent's response (selected tests plus a brief explanation of the mapping) in your PR.
-
-~~~text
-Read TESTING.md, then run `git diff --name-only main` to get my changed files.
-For each changed file, determine which slash commands it affects by reading
-the command templates in templates/commands/ to understand what each command
-invokes. Use these mapping rules:
-
- templates/commands/X.md → the command it defines
- scripts/bash/Y.sh or scripts/powershell/Y.ps1 → every command that invokes that script (grep templates/commands/ for the script name). Also check transitive dependencies: if the changed script is sourced by other scripts (e.g., common.sh is sourced by create-new-feature.sh, check-prerequisites.sh, setup-plan.sh, update-agent-context.sh), then every command invoking those downstream scripts is also affected
- templates/Z-template.md → every command that consumes that template during execution
- src/specify_cli/*.py → CLI commands (`specify init`, `specify check`, `specify extension *`, `specify preset *`); test the affected CLI command and, for init/scaffolding changes, at minimum test /speckit.specify
- extensions/X/commands/* → the extension command it defines
- extensions/X/scripts/* → every extension command that invokes that script
- extensions/X/extension.yml or config-template.yml → every command in that extension. Also check if the manifest defines hooks (look for `hooks:` entries like `before_specify`, `after_implement`, etc.) — if so, the core commands those hooks attach to are also affected
- presets/*/* → test preset scaffolding via `specify init` with the preset
- pyproject.toml → packaging/bundling; test `specify init` and verify bundled assets
-
-Include prerequisite tests (e.g., T5 requires T3 requires T1).
-
-Output in this format:
-
-### Test selection reasoning
-
-| Changed file | Affects | Test | Why |
-|---|---|---|---|
-| (path) | (command) | T# | (reason) |
-
-### Required tests
-
-Number each test sequentially (T1, T2, ...). List prerequisite tests first.
-
- T1: /speckit.command — (reason)
- T2: /speckit.command — (reason)
-~~~
--- a/docs/installation.md
+++ b/docs/installation.md
@@ -12,22 +12,18 @@

 ### Initialize a New Project

-The easiest way to get started is to initialize a new project. Pin a specific release tag for stability (check [Releases](https://github.com/github/spec-kit/releases) for the latest):
+The easiest way to get started is to initialize a new project:

 ```bash
-# Install from a specific stable release (recommended — replace vX.Y.Z with the latest tag)
-uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <PROJECT_NAME>
-
-# Or install latest from main (may include unreleased changes)
 uvx --from git+https://github.com/github/spec-kit.git specify init <PROJECT_NAME>
 ```

 Or initialize in the current directory:

 ```bash
-uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init .
+uvx --from git+https://github.com/github/spec-kit.git specify init .
 # or use the --here flag
-uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init --here
+uvx --from git+https://github.com/github/spec-kit.git specify init --here
 ```

 ### Specify AI Agent
@@ -35,11 +31,11 @@ uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init --here
 You can proactively specify your AI agent during initialization:

 ```bash
-uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <project_name> --ai claude
-uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <project_name> --ai gemini
-uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <project_name> --ai copilot
-uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <project_name> --ai codebuddy
-uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <project_name> --ai pi
+uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --ai claude
+uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --ai gemini
+uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --ai copilot
+uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --ai codebuddy
+uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --ai pi
 ```

 ### Specify Script Type (Shell vs PowerShell)
@@ -55,8 +51,8 @@ Auto behavior:
 Force a specific script type:

 ```bash
-uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <project_name> --script sh
-uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <project_name> --script ps
+uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --script sh
+uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --script ps
 ```

 ### Ignore Agent Tools Check
@@ -64,7 +60,7 @@ uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <proje
 If you prefer to get the templates without checking for the right tools:

 ```bash
-uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init <project_name> --ai claude --ignore-agent-tools
+uvx --from git+https://github.com/github/spec-kit.git specify init <project_name> --ai claude --ignore-agent-tools
 ```

 ## Verification
@@ -79,52 +75,6 @@ The `.specify/scripts` directory will contain both `.sh` and `.ps1` scripts.

 ## Troubleshooting

-### Enterprise / Air-Gapped Installation
-
-If your environment blocks access to PyPI (you see 403 errors when running `uv tool install` or `pip install`), you can create a portable wheel bundle on a connected machine and transfer it to the air-gapped target.
-
-**Step 1: Build the wheel on a connected machine (same OS and Python version as the target)**
-
-```bash
-# Clone the repository
-git clone https://github.com/github/spec-kit.git
-cd spec-kit
-
-# Build the wheel
-pip install build
-python -m build --wheel --outdir dist/
-
-# Download the wheel and all its runtime dependencies
-pip download -d dist/ dist/specify_cli-*.whl
-```
-
-> **Important:** `pip download` resolves platform-specific wheels (e.g., PyYAML includes native extensions). You must run this step on a machine with the **same OS and Python version** as the air-gapped target. If you need to support multiple platforms, repeat this step on each target OS (Linux, macOS, Windows) and Python version.
-
-**Step 2: Transfer the `dist/` directory to the air-gapped machine**
-
-Copy the entire `dist/` directory (which contains the `specify-cli` wheel and all dependency wheels) to the target machine via USB, network share, or other approved transfer method.
-
-**Step 3: Install on the air-gapped machine**
-
-```bash
-pip install --no-index --find-links=./dist specify-cli
-```
-
-**Step 4: Initialize a project (no network required)**
-
-```bash
-# Initialize a project — no GitHub access needed
-specify init my-project --ai claude --offline
-```
-
-The `--offline` flag tells the CLI to use the templates, commands, and scripts bundled inside the wheel instead of downloading from GitHub.
-
-> **Deprecation notice:** Starting with v0.6.0, `specify init` will use bundled assets by default and the `--offline` flag will be removed. The GitHub download path will be retired because bundled assets eliminate the need for network access, avoid proxy/firewall issues, and guarantee that templates always match the installed CLI version. No action will be needed — `specify init` will simply work without network access out of the box.
-
-> **Note:** Python 3.11+ is required.
-
-> **Windows note:** Offline scaffolding requires PowerShell 7+ (`pwsh`), not Windows PowerShell 5.x (`powershell.exe`). Install from https://aka.ms/powershell.
-
 ### Git Credential Manager on Linux

 If you're having issues with Git authentication on Linux, you can install Git Credential Manager:
--- a/docs/upgrade.md
+++ b/docs/upgrade.md
@@ -8,7 +8,7 @@

 | What to Upgrade | Command | When to Use |
 |----------------|---------|-------------|
-| **CLI Tool Only** | `uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git@vX.Y.Z` | Get latest CLI features without touching project files |
+| **CLI Tool Only** | `uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git` | Get latest CLI features without touching project files |
 | **Project Files** | `specify init --here --force --ai <your-agent>` | Update slash commands, templates, and scripts in your project |
 | **Both** | Run CLI upgrade, then project update | Recommended for major version updates |

@@ -20,18 +20,16 @@ The CLI tool (`specify`) is separate from your project files. Upgrade it to get

 ### If you installed with `uv tool install`

-Upgrade to a specific release (check [Releases](https://github.com/github/spec-kit/releases) for the latest tag):
-
 ```bash
-uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git@vX.Y.Z
+uv tool install specify-cli --force --from git+https://github.com/github/spec-kit.git
 ```

 ### If you use one-shot `uvx` commands

-Specify the desired release tag:
+No upgrade needed—`uvx` always fetches the latest version. Just run your commands as normal:

 ```bash
-uvx --from git+https://github.com/github/spec-kit.git@vX.Y.Z specify init --here --ai copilot
+uvx --from git+https://github.com/github/spec-kit.git specify init --here --ai copilot
 ```

 ### Verify the upgrade
--- a/extensions/EXTENSION-DEVELOPMENT-GUIDE.md
+++ b/extensions/EXTENSION-DEVELOPMENT-GUIDE.md
@@ -523,7 +523,7 @@ Submit to the community catalog for public discovery:

 1. **Fork** spec-kit repository
 2. **Add entry** to `extensions/catalog.community.json`
-3. **Update** the Community Extensions table in `README.md` with your extension
+3. **Update** `extensions/README.md` with your extension
 4. **Create PR** following the [Extension Publishing Guide](EXTENSION-PUBLISHING-GUIDE.md)
 5. **After merge**, your extension becomes available:
   - Users can browse `catalog.community.json` to discover your extension
--- a/extensions/EXTENSION-PUBLISHING-GUIDE.md
+++ b/extensions/EXTENSION-PUBLISHING-GUIDE.md
@@ -204,27 +204,14 @@ Edit `extensions/catalog.community.json` and add your extension:
 - Use current timestamp for `created_at` and `updated_at`
 - Update the top-level `updated_at` to current time

-### 3. Update Community Extensions Table
+### 3. Update Extensions README

-Add your extension to the Community Extensions table in the project root `README.md`:
+Add your extension to the Available Extensions table in `extensions/README.md`:

 ```markdown
-| Your Extension Name | Brief description of what it does | `<category>` | <effect> | [repo-name](https://github.com/your-org/spec-kit-your-extension) |
+| Your Extension Name | Brief description of what it does | [repo-name](https://github.com/your-org/spec-kit-your-extension) |
 ```

-**(Table) Category** — pick the one that best fits your extension:
-
- `docs` — reads, validates, or generates spec artifacts
- `code` — reviews, validates, or modifies source code
- `process` — orchestrates workflow across phases
- `integration` — syncs with external platforms
- `visibility` — reports on project health or progress
-
-**Effect** — choose one:
-
- Read-only — produces reports without modifying files
- Read+Write — modifies files, creates artifacts, or updates specs
-
 Insert your extension in alphabetical order in the table.

 ### 4. Submit Pull Request
@@ -234,7 +221,7 @@ Insert your extension in alphabetical order in the table.
 git checkout -b add-your-extension

 # Commit your changes
-git add extensions/catalog.community.json README.md
+git add extensions/catalog.community.json extensions/README.md
 git commit -m "Add your-extension to community catalog

 - Extension ID: your-extension
@@ -273,7 +260,7 @@ Brief description of what your extension does.
 - [x] All commands working
 - [x] No security vulnerabilities
 - [x] Added to extensions/catalog.community.json
- [x] Added to Community Extensions table in README.md
+- [x] Added to extensions/README.md Available Extensions table

 ### Testing
 Tested on:
--- a/extensions/EXTENSION-USER-GUIDE.md
+++ b/extensions/EXTENSION-USER-GUIDE.md
@@ -187,21 +187,6 @@ Provided commands:
   Check: .specify/extensions/jira/
 ```

-### Automatic Agent Skill Registration
-
-If your project was initialized with `--ai-skills`, extension commands are **automatically registered as agent skills** during installation. This ensures that extensions are discoverable by agents that use the [agentskills.io](https://agentskills.io) skill specification.
-
-```text
-✓ Extension installed successfully!
-
-Jira Integration (v1.0.0)
-  ...
-
-✓ 3 agent skill(s) auto-registered
-```
-
-When an extension is removed, its corresponding skills are also cleaned up automatically. Pre-existing skills that were manually customized are never overwritten.
-
 ---

 ## Using Extensions
--- a/extensions/README.md
+++ b/extensions/README.md
@@ -68,9 +68,32 @@ specify extension add --from https://github.com/org/spec-kit-ext/archive/refs/ta

 ## Available Community Extensions

-See the [Community Extensions](../README.md#-community-extensions) section in the main README for the full list of available community-contributed extensions.
+The following community-contributed extensions are available in [`catalog.community.json`](catalog.community.json):

-For the raw catalog data, see [`catalog.community.json`](catalog.community.json).
+| 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 | Multi-agent cognitive system with Triadic Model: understanding, internalization, application — with quality gates, backpropagation verification, and self-healing | [cognitive-squad](https://github.com/Testimonial/cognitive-squad) |
+| Conduct Extension | Orchestrates spec-kit phases via sub-agent delegation to reduce context pollution. | [spec-kit-conduct-ext](https://github.com/twbrandon7/spec-kit-conduct-ext) |
+| DocGuard — CDD Enforcement | Canonical-Driven Development enforcement. Validates, scores, and traces project documentation with automated checks, AI-driven workflows, and spec-kit hooks. Zero NPM runtime 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) |
+| Iterate | Iterate on spec documents with a two-phase define-and-apply workflow — refine specs mid-implementation and go straight back to building | [spec-kit-iterate](https://github.com/imviancagrace/spec-kit-iterate) |
+| 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) |
+| Learning Extension | Generate educational guides from implementations and enhance clarifications with mentoring context | [spec-kit-learn](https://github.com/imviancagrace/spec-kit-learn) |
+| 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) |
+| SDD Utilities | Resume interrupted workflows, validate project health, and verify spec-to-task traceability | [speckit-utils](https://github.com/mvanhorn/speckit-utils) |
+| 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) |
+| Understanding | Automated requirements quality analysis — 31 deterministic metrics against IEEE/ISO standards with experimental energy-based ambiguity detection | [understanding](https://github.com/Testimonial/understanding) |
+| V-Model Extension Pack | Enforces V-Model paired generation of development specs and test specs with full traceability | [spec-kit-v-model](https://github.com/leocamello/spec-kit-v-model) |
+| Verify Extension | Post-implementation quality gate that validates implemented code against specification artifacts | [spec-kit-verify](https://github.com/ismaelJimenez/spec-kit-verify) |
+| Verify Tasks Extension | Detect phantom completions: tasks marked [X] in tasks.md with no real implementation | [spec-kit-verify-tasks](https://github.com/datastone-inc/spec-kit-verify-tasks) |


 ## Adding Your Extension
--- a/extensions/catalog.community.json
+++ b/extensions/catalog.community.json
@@ -3,39 +3,6 @@
  "updated_at": "2026-03-19T12:08:20Z",
  "catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/extensions/catalog.community.json",
  "extensions": {
-    "aide": {
-      "name": "AI-Driven Engineering (AIDE)",
-      "id": "aide",
-      "description": "A structured 7-step workflow for building new projects from scratch with AI assistants — from vision through implementation.",
-      "author": "mnriem",
-      "version": "1.0.0",
-      "download_url": "https://github.com/mnriem/spec-kit-extensions/releases/download/aide-v1.0.0/aide.zip",
-      "repository": "https://github.com/mnriem/spec-kit-extensions",
-      "homepage": "https://github.com/mnriem/spec-kit-extensions",
-      "documentation": "https://github.com/mnriem/spec-kit-extensions/blob/main/aide/README.md",
-      "changelog": "https://github.com/mnriem/spec-kit-extensions/blob/main/aide/CHANGELOG.md",
-      "license": "MIT",
-      "requires": {
-        "speckit_version": ">=0.2.0"
-      },
-      "provides": {
-        "commands": 7,
-        "hooks": 0
-      },
-      "tags": [
-        "workflow",
-        "project-management",
-        "ai-driven",
-        "new-project",
-        "planning",
-        "experimental"
-      ],
-      "verified": false,
-      "downloads": 0,
-      "stars": 0,
-      "created_at": "2026-03-18T00:00:00Z",
-      "updated_at": "2026-03-18T00:00:00Z"
-    },
    "archive": {
      "name": "Archive Extension",
      "id": "archive",
@@ -106,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",
@@ -314,37 +252,6 @@
      "created_at": "2026-03-13T00:00:00Z",
      "updated_at": "2026-03-13T00:00:00Z"
    },
-    "extensify": {
-      "name": "Extensify",
-      "id": "extensify",
-      "description": "Create and validate extensions and extension catalogs.",
-      "author": "mnriem",
-      "version": "1.0.0",
-      "download_url": "https://github.com/mnriem/spec-kit-extensions/releases/download/extensify-v1.0.0/extensify.zip",
-      "repository": "https://github.com/mnriem/spec-kit-extensions",
-      "homepage": "https://github.com/mnriem/spec-kit-extensions",
-      "documentation": "https://github.com/mnriem/spec-kit-extensions/blob/main/extensify/README.md",
-      "changelog": "https://github.com/mnriem/spec-kit-extensions/blob/main/extensify/CHANGELOG.md",
-      "license": "MIT",
-      "requires": {
-        "speckit_version": ">=0.2.0"
-      },
-      "provides": {
-        "commands": 4,
-        "hooks": 0
-      },
-      "tags": [
-        "extensions",
-        "workflow",
-        "validation",
-        "experimental"
-      ],
-      "verified": false,
-      "downloads": 0,
-      "stars": 0,
-      "created_at": "2026-03-18T00:00:00Z",
-      "updated_at": "2026-03-18T00:00:00Z"
-    },
    "fleet": {
      "name": "Fleet Orchestrator",
      "id": "fleet",
@@ -437,37 +344,6 @@
      "created_at": "2026-03-05T00:00:00Z",
      "updated_at": "2026-03-05T00:00:00Z"
    },
-    "presetify": {
-      "name": "Presetify",
-      "id": "presetify",
-      "description": "Create and validate presets and preset catalogs.",
-      "author": "mnriem",
-      "version": "1.0.0",
-      "download_url": "https://github.com/mnriem/spec-kit-extensions/releases/download/presetify-v1.0.0/presetify.zip",
-      "repository": "https://github.com/mnriem/spec-kit-extensions",
-      "homepage": "https://github.com/mnriem/spec-kit-extensions",
-      "documentation": "https://github.com/mnriem/spec-kit-extensions/blob/main/presetify/README.md",
-      "changelog": "https://github.com/mnriem/spec-kit-extensions/blob/main/presetify/CHANGELOG.md",
-      "license": "MIT",
-      "requires": {
-        "speckit_version": ">=0.2.0"
-      },
-      "provides": {
-        "commands": 4,
-        "hooks": 0
-      },
-      "tags": [
-        "presets",
-        "workflow",
-        "templates",
-        "experimental"
-      ],
-      "verified": false,
-      "downloads": 0,
-      "stars": 0,
-      "created_at": "2026-03-18T00:00:00Z",
-      "updated_at": "2026-03-18T00:00:00Z"
-    },
    "ralph": {
      "name": "Ralph Loop",
      "id": "ralph",
--- a/presets/catalog.community.json
+++ b/presets/catalog.community.json
@@ -1,58 +1,6 @@
 {
  "schema_version": "1.0",
-  "updated_at": "2026-03-24T00:00:00Z",
+  "updated_at": "2026-03-09T00:00:00Z",
  "catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/presets/catalog.community.json",
-  "presets": {
-    "aide-in-place": {
-      "name": "AIDE In-Place Migration",
-      "id": "aide-in-place",
-      "version": "1.0.0",
-      "description": "Adapts the AIDE workflow for in-place technology migrations (X → Y pattern). Overrides vision, roadmap, progress, and work item commands with migration-specific guidance.",
-      "author": "mnriem",
-      "repository": "https://github.com/mnriem/spec-kit-presets",
-      "download_url": "https://github.com/mnriem/spec-kit-presets/releases/download/aide-in-place-v1.0.0/aide-in-place.zip",
-      "homepage": "https://github.com/mnriem/spec-kit-presets",
-      "documentation": "https://github.com/mnriem/spec-kit-presets/blob/main/aide-in-place/README.md",
-      "license": "MIT",
-      "requires": {
-        "speckit_version": ">=0.2.0",
-        "extensions": ["aide"]
-      },
-      "provides": {
-        "templates": 2,
-        "commands": 8
-      },
-      "tags": [
-        "migration",
-        "in-place",
-        "brownfield",
-        "aide"
-      ]
-    },
-    "pirate": {
-      "name": "Pirate Speak (Full)",
-      "id": "pirate",
-      "version": "1.0.0",
-      "description": "Arrr! Transforms all Spec Kit output into pirate speak. Specs, plans, and tasks be written fer scallywags.",
-      "author": "mnriem",
-      "repository": "https://github.com/mnriem/spec-kit-presets",
-      "download_url": "https://github.com/mnriem/spec-kit-presets/releases/download/pirate-v1.0.0/pirate.zip",
-      "homepage": "https://github.com/mnriem/spec-kit-presets",
-      "documentation": "https://github.com/mnriem/spec-kit-presets/blob/main/pirate/README.md",
-      "license": "MIT",
-      "requires": {
-        "speckit_version": ">=0.1.0"
-      },
-      "provides": {
-        "templates": 6,
-        "commands": 9
-      },
-      "tags": [
-        "pirate",
-        "theme",
-        "fun",
-        "experimental"
-      ]
-    }
-  }
+  "presets": {}
 }
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "specify-cli"
-version = "0.4.3"
+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 = [
@@ -27,23 +27,6 @@ build-backend = "hatchling.build"
 [tool.hatch.build.targets.wheel]
 packages = ["src/specify_cli"]

-[tool.hatch.build.targets.wheel.force-include]
-# Bundle core assets so `specify init` works without network access (air-gapped / enterprise)
-# Page templates (exclude commands/ — bundled separately below to avoid duplication)
-"templates/agent-file-template.md" = "specify_cli/core_pack/templates/agent-file-template.md"
-"templates/checklist-template.md" = "specify_cli/core_pack/templates/checklist-template.md"
-"templates/constitution-template.md" = "specify_cli/core_pack/templates/constitution-template.md"
-"templates/plan-template.md" = "specify_cli/core_pack/templates/plan-template.md"
-"templates/spec-template.md" = "specify_cli/core_pack/templates/spec-template.md"
-"templates/tasks-template.md" = "specify_cli/core_pack/templates/tasks-template.md"
-"templates/vscode-settings.json" = "specify_cli/core_pack/templates/vscode-settings.json"
-# Command templates
-"templates/commands" = "specify_cli/core_pack/commands"
-"scripts/bash" = "specify_cli/core_pack/scripts/bash"
-"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"
-
 [project.optional-dependencies]
 test = [
    "pytest>=7.0",
--- a/scripts/bash/common.sh
+++ b/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,40 +20,29 @@ 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
        local latest_feature=""
        local highest=0
-        local latest_timestamp=""

        for dir in "$specs_dir"/*; do
            if [[ -d "$dir" ]]; then
                local dirname=$(basename "$dir")
-                if [[ "$dirname" =~ ^([0-9]{8}-[0-9]{6})- ]]; then
-                    # Timestamp-based branch: compare lexicographically
-                    local ts="${BASH_REMATCH[1]}"
-                    if [[ "$ts" > "$latest_timestamp" ]]; then
-                        latest_timestamp="$ts"
-                        latest_feature=$dirname
-                    fi
-                elif [[ "$dirname" =~ ^([0-9]{3})- ]]; then
+                if [[ "$dirname" =~ ^([0-9]{3})- ]]; then
                    local number=${BASH_REMATCH[1]}
                    number=$((10#$number))
                    if [[ "$number" -gt "$highest" ]]; then
                        highest=$number
-                        # Only update if no timestamp branch found yet
-                        if [[ -z "$latest_timestamp" ]]; then
-                            latest_feature=$dirname
-                        fi
+                        latest_feature=$dirname
                    fi
                fi
            fi
@@ -101,17 +57,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() {
@@ -124,9 +72,9 @@ check_feature_branch() {
        return 0
    fi

-    if [[ ! "$branch" =~ ^[0-9]{3}- ]] && [[ ! "$branch" =~ ^[0-9]{8}-[0-9]{6}- ]]; then
+    if [[ ! "$branch" =~ ^[0-9]{3}- ]]; then
        echo "ERROR: Not on a feature branch. Current branch: $branch" >&2
-        echo "Feature branches should be named like: 001-feature-name or 20260319-143022-feature-name" >&2
+        echo "Feature branches should be named like: 001-feature-name" >&2
        return 1
    fi

@@ -142,18 +90,15 @@ find_feature_dir_by_prefix() {
    local branch_name="$2"
    local specs_dir="$repo_root/specs"

-    # Extract prefix from branch (e.g., "004" from "004-whatever" or "20260319-143022" from timestamp branches)
-    local prefix=""
-    if [[ "$branch_name" =~ ^([0-9]{8}-[0-9]{6})- ]]; then
-        prefix="${BASH_REMATCH[1]}"
-    elif [[ "$branch_name" =~ ^([0-9]{3})- ]]; then
-        prefix="${BASH_REMATCH[1]}"
-    else
-        # If branch doesn't have a recognized prefix, fall back to exact match
+    # Extract numeric prefix from branch (e.g., "004" from "004-whatever")
+    if [[ ! "$branch_name" =~ ^([0-9]{3})- ]]; then
+        # If branch doesn't have numeric prefix, fall back to exact match
        echo "$specs_dir/$branch_name"
        return
    fi

+    local prefix="${BASH_REMATCH[1]}"
+
    # Search for directories in specs/ that start with this prefix
    local matches=()
    if [[ -d "$specs_dir" ]]; then
@@ -174,7 +119,7 @@ find_feature_dir_by_prefix() {
    else
        # 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 prefix." >&2
+        echo "Please ensure only one spec directory exists per numeric prefix." >&2
        return 1
    fi
 }
--- a/scripts/bash/create-new-feature.sh
+++ b/scripts/bash/create-new-feature.sh
@@ -5,14 +5,13 @@ set -e
 JSON_MODE=false
 SHORT_NAME=""
 BRANCH_NUMBER=""
-USE_TIMESTAMP=false
 ARGS=()
 i=1
 while [ $i -le $# ]; do
    arg="${!i}"
    case "$arg" in
-        --json)
-            JSON_MODE=true
+        --json) 
+            JSON_MODE=true 
            ;;
        --short-name)
            if [ $((i + 1)) -gt $# ]; then
@@ -41,27 +40,22 @@ while [ $i -le $# ]; do
            fi
            BRANCH_NUMBER="$next_arg"
            ;;
-        --timestamp)
-            USE_TIMESTAMP=true
-            ;;
-        --help|-h)
-            echo "Usage: $0 [--json] [--short-name <name>] [--number N] [--timestamp] <feature_description>"
+        --help|-h) 
+            echo "Usage: $0 [--json] [--short-name <name>] [--number N] <feature_description>"
            echo ""
            echo "Options:"
            echo "  --json              Output in JSON format"
            echo "  --short-name <name> Provide a custom short name (2-4 words) for the branch"
            echo "  --number N          Specify branch number manually (overrides auto-detection)"
-            echo "  --timestamp         Use timestamp prefix (YYYYMMDD-HHMMSS) instead of sequential numbering"
            echo "  --help, -h          Show this help message"
            echo ""
            echo "Examples:"
            echo "  $0 'Add user authentication system' --short-name 'user-auth'"
            echo "  $0 'Implement OAuth2 integration for API' --number 5"
-            echo "  $0 --timestamp --short-name 'user-auth' 'Add user authentication'"
            exit 0
            ;;
-        *)
-            ARGS+=("$arg")
+        *) 
+            ARGS+=("$arg") 
            ;;
    esac
    i=$((i + 1))
@@ -69,7 +63,7 @@ done

 FEATURE_DESCRIPTION="${ARGS[*]}"
 if [ -z "$FEATURE_DESCRIPTION" ]; then
-    echo "Usage: $0 [--json] [--short-name <name>] [--number N] [--timestamp] <feature_description>" >&2
+    echo "Usage: $0 [--json] [--short-name <name>] [--number N] <feature_description>" >&2
    exit 1
 fi

@@ -80,6 +74,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"
@@ -89,13 +96,10 @@ get_highest_from_specs() {
        for dir in "$specs_dir"/*; do
            [ -d "$dir" ] || continue
            dirname=$(basename "$dir")
-            # Match sequential prefixes (>=3 digits), but skip timestamp dirs.
-            if echo "$dirname" | grep -Eq '^[0-9]{3,}-' && ! echo "$dirname" | grep -Eq '^[0-9]{8}-[0-9]{6}-'; then
-                number=$(echo "$dirname" | grep -Eo '^[0-9]+')
-                number=$((10#$number))
-                if [ "$number" -gt "$highest" ]; then
-                    highest=$number
-                fi
+            number=$(echo "$dirname" | grep -o '^[0-9]\+' || echo "0")
+            number=$((10#$number))
+            if [ "$number" -gt "$highest" ]; then
+                highest=$number
            fi
        done
    fi
@@ -115,9 +119,9 @@ get_highest_from_branches() {
            # Clean branch name: remove leading markers and remote prefixes
            clean_branch=$(echo "$branch" | sed 's/^[* ]*//; s|^remotes/[^/]*/||')
            
-            # Extract sequential feature number (>=3 digits), skip timestamp branches.
-            if echo "$clean_branch" | grep -Eq '^[0-9]{3,}-' && ! echo "$clean_branch" | grep -Eq '^[0-9]{8}-[0-9]{6}-'; then
-                number=$(echo "$clean_branch" | grep -Eo '^[0-9]+' || echo "0")
+            # Extract feature number if branch matches pattern ###-*
+            if echo "$clean_branch" | grep -q '^[0-9]\{3\}-'; then
+                number=$(echo "$clean_branch" | grep -o '^[0-9]\{3\}' || echo "0")
                number=$((10#$number))
                if [ "$number" -gt "$highest" ]; then
                    highest=$number
@@ -158,16 +162,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

@@ -233,42 +242,29 @@ else
    BRANCH_SUFFIX=$(generate_branch_name "$FEATURE_DESCRIPTION")
 fi

-# Warn if --number and --timestamp are both specified
-if [ "$USE_TIMESTAMP" = true ] && [ -n "$BRANCH_NUMBER" ]; then
-    >&2 echo "[specify] Warning: --number is ignored when --timestamp is used"
-    BRANCH_NUMBER=""
-fi
-
-# Determine branch prefix
-if [ "$USE_TIMESTAMP" = true ]; then
-    FEATURE_NUM=$(date +%Y%m%d-%H%M%S)
-    BRANCH_NAME="${FEATURE_NUM}-${BRANCH_SUFFIX}"
-else
-    # Determine branch number
-    if [ -z "$BRANCH_NUMBER" ]; then
-        if [ "$HAS_GIT" = true ]; then
-            # Check existing branches on remotes
-            BRANCH_NUMBER=$(check_existing_branches "$SPECS_DIR")
-        else
-            # Fall back to local directory check
-            HIGHEST=$(get_highest_from_specs "$SPECS_DIR")
-            BRANCH_NUMBER=$((HIGHEST + 1))
-        fi
+# Determine branch number
+if [ -z "$BRANCH_NUMBER" ]; then
+    if [ "$HAS_GIT" = true ]; then
+        # Check existing branches on remotes
+        BRANCH_NUMBER=$(check_existing_branches "$SPECS_DIR")
+    else
+        # Fall back to local directory check
+        HIGHEST=$(get_highest_from_specs "$SPECS_DIR")
+        BRANCH_NUMBER=$((HIGHEST + 1))
    fi
-
-    # Force base-10 interpretation to prevent octal conversion (e.g., 010 → 8 in octal, but should be 10 in decimal)
-    FEATURE_NUM=$(printf "%03d" "$((10#$BRANCH_NUMBER))")
-    BRANCH_NAME="${FEATURE_NUM}-${BRANCH_SUFFIX}"
 fi

+# Force base-10 interpretation to prevent octal conversion (e.g., 010 → 8 in octal, but should be 10 in decimal)
+FEATURE_NUM=$(printf "%03d" "$((10#$BRANCH_NUMBER))")
+BRANCH_NAME="${FEATURE_NUM}-${BRANCH_SUFFIX}"
+
 # GitHub enforces a 244-byte limit on branch names
 # Validate and truncate if necessary
 MAX_BRANCH_LENGTH=244
 if [ ${#BRANCH_NAME} -gt $MAX_BRANCH_LENGTH ]; then
    # Calculate how much we need to trim from suffix
-    # Account for prefix length: timestamp (15) + hyphen (1) = 16, or sequential (3) + hyphen (1) = 4
-    PREFIX_LENGTH=$(( ${#FEATURE_NUM} + 1 ))
-    MAX_SUFFIX_LENGTH=$((MAX_BRANCH_LENGTH - PREFIX_LENGTH))
+    # Account for: feature number (3) + hyphen (1) = 4 chars
+    MAX_SUFFIX_LENGTH=$((MAX_BRANCH_LENGTH - 4))
    
    # Truncate suffix at word boundary if possible
    TRUNCATED_SUFFIX=$(echo "$BRANCH_SUFFIX" | cut -c1-$MAX_SUFFIX_LENGTH)
@@ -287,11 +283,7 @@ if [ "$HAS_GIT" = true ]; then
    if ! git checkout -b "$BRANCH_NAME" 2>/dev/null; then
        # Check if branch already exists
        if git branch --list "$BRANCH_NAME" | grep -q .; then
-            if [ "$USE_TIMESTAMP" = true ]; then
-                >&2 echo "Error: Branch '$BRANCH_NAME' already exists. Rerun to get a new timestamp or use a different --short-name."
-            else
-                >&2 echo "Error: Branch '$BRANCH_NAME' already exists. Please use a different feature name or specify a different number with --number."
-            fi
+            >&2 echo "Error: Branch '$BRANCH_NAME' already exists. Please use a different feature name or specify a different number with --number."
            exit 1
        else
            >&2 echo "Error: Failed to create git branch '$BRANCH_NAME'. Please check your git configuration and try again."
--- 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, Junie, Kilo Code, Auggie CLI, Roo Code, CodeBuddy CLI, Qoder CLI, Amp, SHAI, Tabnine CLI, Kiro CLI, Mistral Vibe, Kimi Code, Pi Coding Agent, iFlow CLI, 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, Kimi Code, Pi Coding Agent, iFlow CLI, 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|junie|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|trae|pi|iflow|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|kimi|trae|pi|iflow|generic
 # Leave empty to update all existing agent files

 set -e
@@ -68,7 +68,6 @@ CURSOR_FILE="$REPO_ROOT/.cursor/rules/specify-rules.mdc"
 QWEN_FILE="$REPO_ROOT/QWEN.md"
 AGENTS_FILE="$REPO_ROOT/AGENTS.md"
 WINDSURF_FILE="$REPO_ROOT/.windsurf/rules/specify-rules.md"
-JUNIE_FILE="$REPO_ROOT/.junie/AGENTS.md"
 KILOCODE_FILE="$REPO_ROOT/.kilocode/rules/specify-rules.md"
 AUGGIE_FILE="$REPO_ROOT/.augment/rules/specify-rules.md"
 ROO_FILE="$REPO_ROOT/.roo/rules/specify-rules.md"
@@ -639,9 +638,6 @@ update_specific_agent() {
        windsurf)
            update_agent_file "$WINDSURF_FILE" "Windsurf" || return 1
            ;;
-        junie)
-            update_agent_file "$JUNIE_FILE" "Junie" || return 1
-            ;;
        kilocode)
            update_agent_file "$KILOCODE_FILE" "Kilo Code" || return 1
            ;;
@@ -695,7 +691,7 @@ update_specific_agent() {
            ;;
        *)
            log_error "Unknown agent type '$agent_type'"
-            log_error "Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|junie|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|trae|pi|iflow|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|kimi|trae|pi|iflow|generic"
            exit 1
            ;;
    esac
@@ -744,7 +740,6 @@ update_all_existing_agents() {
    _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 "$JUNIE_FILE" "Junie"                || _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
@@ -783,7 +778,7 @@ print_summary() {
    fi
    
    echo
-    log_info "Usage: $0 [claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|junie|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|trae|pi|iflow|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|kimi|trae|pi|iflow|generic]"
 }

 #==============================================================================
--- a/scripts/powershell/common.ps1
+++ b/scripts/powershell/common.ps1
@@ -1,39 +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 ([, ], *, ?)
-    $resolved = Resolve-Path -LiteralPath $StartDir -ErrorAction SilentlyContinue
-    $current = if ($resolved) { $resolved.Path } else { $null }
-    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) {
@@ -42,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 {
@@ -53,48 +20,35 @@ 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) {
        $latestFeature = ""
        $highest = 0
-        $latestTimestamp = ""
-
+        
        Get-ChildItem -Path $specsDir -Directory | ForEach-Object {
-            if ($_.Name -match '^(\d{8}-\d{6})-') {
-                # Timestamp-based branch: compare lexicographically
-                $ts = $matches[1]
-                if ($ts -gt $latestTimestamp) {
-                    $latestTimestamp = $ts
-                    $latestFeature = $_.Name
-                }
-            } elseif ($_.Name -match '^(\d{3})-') {
+            if ($_.Name -match '^(\d{3})-') {
                $num = [int]$matches[1]
                if ($num -gt $highest) {
                    $highest = $num
-                    # Only update if no timestamp branch found yet
-                    if (-not $latestTimestamp) {
-                        $latestFeature = $_.Name
-                    }
+                    $latestFeature = $_.Name
                }
            }
        }
-
+        
        if ($latestFeature) {
            return $latestFeature
        }
@@ -104,23 +58,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
@@ -139,9 +79,9 @@ function Test-FeatureBranch {
        return $true
    }
    
-    if ($Branch -notmatch '^[0-9]{3}-' -and $Branch -notmatch '^\d{8}-\d{6}-') {
+    if ($Branch -notmatch '^[0-9]{3}-') {
        Write-Output "ERROR: Not on a feature branch. Current branch: $Branch"
-        Write-Output "Feature branches should be named like: 001-feature-name or 20260319-143022-feature-name"
+        Write-Output "Feature branches should be named like: 001-feature-name"
        return $false
    }
    return $true
--- a/scripts/powershell/create-new-feature.ps1
+++ b/scripts/powershell/create-new-feature.ps1
@@ -5,8 +5,7 @@ param(
    [switch]$Json,
    [string]$ShortName,
    [Parameter()]
-    [long]$Number = 0,
-    [switch]$Timestamp,
+    [int]$Number = 0,
    [switch]$Help,
    [Parameter(Position = 0, ValueFromRemainingArguments = $true)]
    [string[]]$FeatureDescription
@@ -15,25 +14,23 @@ $ErrorActionPreference = 'Stop'

 # Show help if requested
 if ($Help) {
-    Write-Host "Usage: ./create-new-feature.ps1 [-Json] [-ShortName <name>] [-Number N] [-Timestamp] <feature description>"
+    Write-Host "Usage: ./create-new-feature.ps1 [-Json] [-ShortName <name>] [-Number N] <feature description>"
    Write-Host ""
    Write-Host "Options:"
    Write-Host "  -Json               Output in JSON format"
    Write-Host "  -ShortName <name>   Provide a custom short name (2-4 words) for the branch"
    Write-Host "  -Number N           Specify branch number manually (overrides auto-detection)"
-    Write-Host "  -Timestamp          Use timestamp prefix (YYYYMMDD-HHMMSS) instead of sequential numbering"
    Write-Host "  -Help               Show this help message"
    Write-Host ""
    Write-Host "Examples:"
    Write-Host "  ./create-new-feature.ps1 'Add user authentication system' -ShortName 'user-auth'"
    Write-Host "  ./create-new-feature.ps1 'Implement OAuth2 integration for API'"
-    Write-Host "  ./create-new-feature.ps1 -Timestamp -ShortName 'user-auth' 'Add user authentication'"
    exit 0
 }

 # Check if feature description provided
 if (-not $FeatureDescription -or $FeatureDescription.Count -eq 0) {
-    Write-Error "Usage: ./create-new-feature.ps1 [-Json] [-ShortName <name>] [-Number N] [-Timestamp] <feature description>"
+    Write-Error "Usage: ./create-new-feature.ps1 [-Json] [-ShortName <name>] <feature description>"
    exit 1
 }

@@ -45,18 +42,39 @@ 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)
    
-    [long]$highest = 0
+    $highest = 0
    if (Test-Path $SpecsDir) {
        Get-ChildItem -Path $SpecsDir -Directory | ForEach-Object {
-            # Match sequential prefixes (>=3 digits), but skip timestamp dirs.
-            if ($_.Name -match '^(\d{3,})-' -and $_.Name -notmatch '^\d{8}-\d{6}-') {
-                [long]$num = 0
-                if ([long]::TryParse($matches[1], [ref]$num) -and $num -gt $highest) {
-                    $highest = $num
-                }
+            if ($_.Name -match '^(\d+)') {
+                $num = [int]$matches[1]
+                if ($num -gt $highest) { $highest = $num }
            }
        }
    }
@@ -66,7 +84,7 @@ function Get-HighestNumberFromSpecs {
 function Get-HighestNumberFromBranches {
    param()
    
-    [long]$highest = 0
+    $highest = 0
    try {
        $branches = git branch -a 2>$null
        if ($LASTEXITCODE -eq 0) {
@@ -74,12 +92,10 @@ function Get-HighestNumberFromBranches {
                # Clean branch name: remove leading markers and remote prefixes
                $cleanBranch = $branch.Trim() -replace '^\*?\s+', '' -replace '^remotes/[^/]+/', ''
                
-                # Extract sequential feature number (>=3 digits), skip timestamp branches.
-                if ($cleanBranch -match '^(\d{3,})-' -and $cleanBranch -notmatch '^\d{8}-\d{6}-') {
-                    [long]$num = 0
-                    if ([long]::TryParse($matches[1], [ref]$num) -and $num -gt $highest) {
-                        $highest = $num
-                    }
+                # Extract feature number if branch matches pattern ###-*
+                if ($cleanBranch -match '^(\d+)-') {
+                    $num = [int]$matches[1]
+                    if ($num -gt $highest) { $highest = $num }
                }
            }
        }
@@ -120,14 +136,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

@@ -188,40 +216,27 @@ if ($ShortName) {
    $branchSuffix = Get-BranchName -Description $featureDesc
 }

-# Warn if -Number and -Timestamp are both specified
-if ($Timestamp -and $Number -ne 0) {
-    Write-Warning "[specify] Warning: -Number is ignored when -Timestamp is used"
-    $Number = 0
-}
-
-# Determine branch prefix
-if ($Timestamp) {
-    $featureNum = Get-Date -Format 'yyyyMMdd-HHmmss'
-    $branchName = "$featureNum-$branchSuffix"
-} else {
-    # Determine branch number
-    if ($Number -eq 0) {
-        if ($hasGit) {
-            # Check existing branches on remotes
-            $Number = Get-NextBranchNumber -SpecsDir $specsDir
-        } else {
-            # Fall back to local directory check
-            $Number = (Get-HighestNumberFromSpecs -SpecsDir $specsDir) + 1
-        }
+# Determine branch number
+if ($Number -eq 0) {
+    if ($hasGit) {
+        # Check existing branches on remotes
+        $Number = Get-NextBranchNumber -SpecsDir $specsDir
+    } else {
+        # Fall back to local directory check
+        $Number = (Get-HighestNumberFromSpecs -SpecsDir $specsDir) + 1
    }
-
-    $featureNum = ('{0:000}' -f $Number)
-    $branchName = "$featureNum-$branchSuffix"
 }

+$featureNum = ('{0:000}' -f $Number)
+$branchName = "$featureNum-$branchSuffix"
+
 # GitHub enforces a 244-byte limit on branch names
 # Validate and truncate if necessary
 $maxBranchLength = 244
 if ($branchName.Length -gt $maxBranchLength) {
    # Calculate how much we need to trim from suffix
-    # Account for prefix length: timestamp (15) + hyphen (1) = 16, or sequential (3) + hyphen (1) = 4
-    $prefixLength = $featureNum.Length + 1
-    $maxSuffixLength = $maxBranchLength - $prefixLength
+    # Account for: feature number (3) + hyphen (1) = 4 chars
+    $maxSuffixLength = $maxBranchLength - 4
    
    # Truncate suffix
    $truncatedSuffix = $branchSuffix.Substring(0, [Math]::Min($branchSuffix.Length, $maxSuffixLength))
@@ -251,11 +266,7 @@ if ($hasGit) {
        # Check if branch already exists
        $existingBranch = git branch --list $branchName 2>$null
        if ($existingBranch) {
-            if ($Timestamp) {
-                Write-Error "Error: Branch '$branchName' already exists. Rerun to get a new timestamp or use a different -ShortName."
-            } else {
-                Write-Error "Error: Branch '$branchName' already exists. Please use a different feature name or specify a different number with -Number."
-            }
+            Write-Error "Error: Branch '$branchName' already exists. Please use a different feature name or specify a different number with -Number."
            exit 1
        } else {
            Write-Error "Error: Failed to create git branch '$branchName'. Please check your git configuration and try again."
@@ -295,3 +306,4 @@ if ($Json) {
    Write-Output "HAS_GIT: $hasGit"
    Write-Output "SPECIFY_FEATURE environment variable set to: $branchName"
 }
+
--- 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, junie, kilocode, auggie, roo, codebuddy, amp, shai, tabnine, kiro-cli, agy, bob, vibe, qodercli, kimi, trae, pi, iflow, 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, kimi, trae, pi, iflow, 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','junie','kilocode','auggie','roo','codebuddy','amp','shai','tabnine','kiro-cli','agy','bob','qodercli','vibe','kimi','trae','pi','iflow','generic')]
+    [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','pi','iflow','generic')]
    [string]$AgentType
 )

@@ -51,7 +51,6 @@ $CURSOR_FILE   = Join-Path $REPO_ROOT '.cursor/rules/specify-rules.mdc'
 $QWEN_FILE     = Join-Path $REPO_ROOT 'QWEN.md'
 $AGENTS_FILE   = Join-Path $REPO_ROOT 'AGENTS.md'
 $WINDSURF_FILE = Join-Path $REPO_ROOT '.windsurf/rules/specify-rules.md'
-$JUNIE_FILE = Join-Path $REPO_ROOT '.junie/AGENTS.md'
 $KILOCODE_FILE = Join-Path $REPO_ROOT '.kilocode/rules/specify-rules.md'
 $AUGGIE_FILE   = Join-Path $REPO_ROOT '.augment/rules/specify-rules.md'
 $ROO_FILE      = Join-Path $REPO_ROOT '.roo/rules/specify-rules.md'
@@ -398,7 +397,6 @@ function Update-SpecificAgent {
        'opencode' { Update-AgentFile -TargetFile $AGENTS_FILE   -AgentName 'opencode' }
        'codex'    { Update-AgentFile -TargetFile $AGENTS_FILE   -AgentName 'Codex CLI' }
        'windsurf' { Update-AgentFile -TargetFile $WINDSURF_FILE -AgentName 'Windsurf' }
-        'junie'    { Update-AgentFile -TargetFile $JUNIE_FILE    -AgentName 'Junie' }
        'kilocode' { Update-AgentFile -TargetFile $KILOCODE_FILE -AgentName 'Kilo Code' }
        'auggie'   { Update-AgentFile -TargetFile $AUGGIE_FILE   -AgentName 'Auggie CLI' }
        'roo'      { Update-AgentFile -TargetFile $ROO_FILE      -AgentName 'Roo Code' }
@@ -416,7 +414,7 @@ function Update-SpecificAgent {
        'pi'       { Update-AgentFile -TargetFile $AGENTS_FILE   -AgentName 'Pi Coding Agent' }
        'iflow'    { Update-AgentFile -TargetFile $IFLOW_FILE    -AgentName 'iFlow CLI' }
        '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|junie|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|trae|pi|iflow|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|kimi|trae|pi|iflow|generic'; return $false }
    }
 }

@@ -430,7 +428,6 @@ function Update-AllExistingAgents {
    if (Test-Path $QWEN_FILE)     { if (-not (Update-AgentFile -TargetFile $QWEN_FILE     -AgentName 'Qwen Code')) { $ok = $false }; $found = $true }
    if (Test-Path $AGENTS_FILE)   { if (-not (Update-AgentFile -TargetFile $AGENTS_FILE   -AgentName 'Codex/opencode')) { $ok = $false }; $found = $true }
    if (Test-Path $WINDSURF_FILE) { if (-not (Update-AgentFile -TargetFile $WINDSURF_FILE -AgentName 'Windsurf')) { $ok = $false }; $found = $true }
-    if (Test-Path $JUNIE_FILE)    { if (-not (Update-AgentFile -TargetFile $JUNIE_FILE    -AgentName 'Junie')) { $ok = $false }; $found = $true }
    if (Test-Path $KILOCODE_FILE) { if (-not (Update-AgentFile -TargetFile $KILOCODE_FILE -AgentName 'Kilo Code')) { $ok = $false }; $found = $true }
    if (Test-Path $AUGGIE_FILE)   { if (-not (Update-AgentFile -TargetFile $AUGGIE_FILE   -AgentName 'Auggie CLI')) { $ok = $false }; $found = $true }
    if (Test-Path $ROO_FILE)      { if (-not (Update-AgentFile -TargetFile $ROO_FILE      -AgentName 'Roo Code')) { $ok = $false }; $found = $true }
@@ -459,7 +456,7 @@ function Print-Summary {
    if ($NEW_FRAMEWORK) { Write-Host "  - Added framework: $NEW_FRAMEWORK" }
    if ($NEW_DB -and $NEW_DB -ne 'N/A') { Write-Host "  - Added database: $NEW_DB" }
    Write-Host ''
-    Write-Info 'Usage: ./update-agent-context.ps1 [-AgentType claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|junie|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|trae|pi|iflow|generic]'
+    Write-Info 'Usage: ./update-agent-context.ps1 [-AgentType claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|tabnine|kiro-cli|agy|bob|vibe|qodercli|kimi|trae|pi|iflow|generic]'
 }

 function Main {
--- a/src/specify_cli/init.py
+++ b/src/specify_cli/init.py
--- a/src/specify_cli/agents.py
+++ b/src/specify_cli/agents.py
@@ -9,9 +9,6 @@ command files into agent-specific directories in the correct format.
 from pathlib import Path
 from typing import Dict, List, Any

-import platform
-import re
-from copy import deepcopy
 import yaml


@@ -62,19 +59,13 @@ class CommandRegistrar:
            "extension": ".md"
        },
        "codex": {
-            "dir": ".agents/skills",
-            "format": "markdown",
-            "args": "$ARGUMENTS",
-            "extension": "/SKILL.md",
-        },
-        "windsurf": {
-            "dir": ".windsurf/workflows",
+            "dir": ".codex/prompts",
            "format": "markdown",
            "args": "$ARGUMENTS",
            "extension": ".md"
        },
-        "junie": {
-            "dir": ".junie/commands",
+        "windsurf": {
+            "dir": ".windsurf/workflows",
            "format": "markdown",
            "args": "$ARGUMENTS",
            "extension": ".md"
@@ -149,7 +140,7 @@ class CommandRegistrar:
            "dir": ".kimi/skills",
            "format": "markdown",
            "args": "$ARGUMENTS",
-            "extension": "/SKILL.md",
+            "extension": "/SKILL.md"
        },
        "trae": {
            "dir": ".trae/rules",
@@ -191,9 +182,6 @@ class CommandRegistrar:
        except yaml.YAMLError:
            frontmatter = {}

-        if not isinstance(frontmatter, dict):
-            frontmatter = {}
-
        return frontmatter, body

    @staticmethod
@@ -209,56 +197,25 @@ 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:
-        """Normalize script paths in frontmatter to generated project locations.
-
-        Rewrites known repo-relative and top-level script paths under the
-        `scripts` and `agent_scripts` keys (for example `../../scripts/`,
-        `../../templates/`, `../../memory/`, `scripts/`, `templates/`, and
-        `memory/`) to the `.specify/...` paths used in generated projects.
+        """Adjust script paths from extension-relative to repo-relative.

        Args:
            frontmatter: Frontmatter dictionary

        Returns:
-            Modified frontmatter with normalized project paths
+            Modified frontmatter with adjusted paths
        """
-        frontmatter = deepcopy(frontmatter)
-
-        for script_key in ("scripts", "agent_scripts"):
-            scripts = frontmatter.get(script_key)
-            if not isinstance(scripts, dict):
-                continue
-
-            for key, script_path in scripts.items():
-                if isinstance(script_path, str):
-                    scripts[key] = self._rewrite_project_relative_paths(script_path)
+        if "scripts" in frontmatter:
+            for key in frontmatter["scripts"]:
+                script_path = frontmatter["scripts"][key]
+                if script_path.startswith("../../scripts/"):
+                    frontmatter["scripts"][key] = f".specify/scripts/{script_path[14:]}"
        return frontmatter

-    @staticmethod
-    def _rewrite_project_relative_paths(text: str) -> str:
-        """Rewrite repo-relative paths to their generated project locations."""
-        if not isinstance(text, str) or not text:
-            return text
-
-        for old, new in (
-            ("../../memory/", ".specify/memory/"),
-            ("../../scripts/", ".specify/scripts/"),
-            ("../../templates/", ".specify/templates/"),
-        ):
-            text = text.replace(old, new)
-
-        # Only rewrite top-level style references so extension-local paths like
-        # ".specify/extensions/<ext>/scripts/..." remain intact.
-        text = re.sub(r'(^|[\s`"\'(])(?:\.?/)?memory/', r"\1.specify/memory/", text)
-        text = re.sub(r'(^|[\s`"\'(])(?:\.?/)?scripts/', r"\1.specify/scripts/", text)
-        text = re.sub(r'(^|[\s`"\'(])(?:\.?/)?templates/', r"\1.specify/templates/", text)
-
-        return text.replace(".specify/.specify/", ".specify/").replace(".specify.specify/", ".specify/")
-
    def render_markdown_command(
        self,
        frontmatter: dict,
@@ -307,123 +264,12 @@ class CommandRegistrar:
        toml_lines.append(f"# Source: {source_id}")
        toml_lines.append("")

-        # Keep TOML output valid even when body contains triple-quote delimiters.
-        # Prefer multiline forms, then fall back to escaped basic string.
-        if '"""' not in body:
-            toml_lines.append('prompt = """')
-            toml_lines.append(body)
-            toml_lines.append('"""')
-        elif "'''" not in body:
-            toml_lines.append("prompt = '''")
-            toml_lines.append(body)
-            toml_lines.append("'''")
-        else:
-            escaped_body = (
-                body.replace("\\", "\\\\")
-                .replace('"', '\\"')
-                .replace("\n", "\\n")
-                .replace("\r", "\\r")
-                .replace("\t", "\\t")
-            )
-            toml_lines.append(f'prompt = "{escaped_body}"')
+        toml_lines.append('prompt = """')
+        toml_lines.append(body)
+        toml_lines.append('"""')

        return "\n".join(toml_lines)

-    def render_skill_command(
-        self,
-        agent_name: str,
-        skill_name: str,
-        frontmatter: dict,
-        body: str,
-        source_id: str,
-        source_file: str,
-        project_root: Path,
-    ) -> str:
-        """Render a command override as a SKILL.md file.
-
-        SKILL-target agents should receive the same skills-oriented
-        frontmatter shape used elsewhere in the project instead of the
-        original command frontmatter.
-
-        Technical debt note:
-        Spec-kit currently has multiple SKILL.md generators (template packaging,
-        init-time conversion, and extension/preset overrides). Keep the skill
-        frontmatter keys aligned (name/description/compatibility/metadata, with
-        metadata.author and metadata.source subkeys) to avoid drift across agents.
-        """
-        if not isinstance(frontmatter, dict):
-            frontmatter = {}
-
-        if agent_name in {"codex", "kimi"}:
-            body = self.resolve_skill_placeholders(agent_name, frontmatter, body, project_root)
-
-        description = frontmatter.get("description", f"Spec-kit workflow command: {skill_name}")
-        skill_frontmatter = {
-            "name": skill_name,
-            "description": description,
-            "compatibility": "Requires spec-kit project structure with .specify/ directory",
-            "metadata": {
-                "author": "github-spec-kit",
-                "source": f"{source_id}:{source_file}",
-            },
-        }
-        return self.render_frontmatter(skill_frontmatter) + "\n" + body
-
-    @staticmethod
-    def resolve_skill_placeholders(agent_name: str, frontmatter: dict, body: str, project_root: Path) -> str:
-        """Resolve script placeholders for skills-backed agents."""
-        try:
-            from . import load_init_options
-        except ImportError:
-            return body
-
-        if not isinstance(frontmatter, dict):
-            frontmatter = {}
-
-        scripts = frontmatter.get("scripts", {}) or {}
-        agent_scripts = frontmatter.get("agent_scripts", {}) or {}
-        if not isinstance(scripts, dict):
-            scripts = {}
-        if not isinstance(agent_scripts, dict):
-            agent_scripts = {}
-
-        init_opts = load_init_options(project_root)
-        if not isinstance(init_opts, dict):
-            init_opts = {}
-
-        script_variant = init_opts.get("script")
-        if script_variant not in {"sh", "ps"}:
-            fallback_order = []
-            default_variant = "ps" if platform.system().lower().startswith("win") else "sh"
-            secondary_variant = "sh" if default_variant == "ps" else "ps"
-
-            if default_variant in scripts or default_variant in agent_scripts:
-                fallback_order.append(default_variant)
-            if secondary_variant in scripts or secondary_variant in agent_scripts:
-                fallback_order.append(secondary_variant)
-
-            for key in scripts:
-                if key not in fallback_order:
-                    fallback_order.append(key)
-            for key in agent_scripts:
-                if key not in fallback_order:
-                    fallback_order.append(key)
-
-            script_variant = fallback_order[0] if fallback_order else None
-
-        script_command = scripts.get(script_variant) if script_variant else None
-        if script_command:
-            script_command = script_command.replace("{ARGS}", "$ARGUMENTS")
-            body = body.replace("{SCRIPT}", script_command)
-
-        agent_script_command = agent_scripts.get(script_variant) if script_variant else None
-        if agent_script_command:
-            agent_script_command = agent_script_command.replace("{ARGS}", "$ARGUMENTS")
-            body = body.replace("{AGENT_SCRIPT}", agent_script_command)
-
-        body = body.replace("{ARGS}", "$ARGUMENTS").replace("__AGENT__", agent_name)
-        return CommandRegistrar._rewrite_project_relative_paths(body)
-
    def _convert_argument_placeholder(self, content: str, from_placeholder: str, to_placeholder: str) -> str:
        """Convert argument placeholder format.

@@ -437,19 +283,6 @@ class CommandRegistrar:
        """
        return content.replace(from_placeholder, to_placeholder)

-    @staticmethod
-    def _compute_output_name(agent_name: str, cmd_name: str, agent_config: Dict[str, Any]) -> str:
-        """Compute the on-disk command or skill name for an agent."""
-        if agent_config["extension"] != "/SKILL.md":
-            return cmd_name
-
-        short_name = cmd_name
-        if short_name.startswith("speckit."):
-            short_name = short_name[len("speckit."):]
-        short_name = short_name.replace(".", "-")
-
-        return f"speckit-{short_name}"
-
    def register_commands(
        self,
        agent_name: str,
@@ -501,20 +334,14 @@ class CommandRegistrar:
                body, "$ARGUMENTS", agent_config["args"]
            )

-            output_name = self._compute_output_name(agent_name, cmd_name, agent_config)
-
-            if agent_config["extension"] == "/SKILL.md":
-                output = self.render_skill_command(
-                    agent_name, output_name, frontmatter, body, source_id, cmd_file, project_root
-                )
-            elif agent_config["format"] == "markdown":
+            if agent_config["format"] == "markdown":
                output = self.render_markdown_command(frontmatter, body, source_id, context_note)
            elif agent_config["format"] == "toml":
                output = self.render_toml_command(frontmatter, body, source_id)
            else:
                raise ValueError(f"Unsupported format: {agent_config['format']}")

-            dest_file = commands_dir / f"{output_name}{agent_config['extension']}"
+            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")

@@ -524,15 +351,9 @@ class CommandRegistrar:
            registered.append(cmd_name)

            for alias in cmd_info.get("aliases", []):
-                alias_output_name = self._compute_output_name(agent_name, alias, agent_config)
-                alias_output = output
-                if agent_config["extension"] == "/SKILL.md":
-                    alias_output = self.render_skill_command(
-                        agent_name, alias_output_name, frontmatter, body, source_id, cmd_file, project_root
-                    )
-                alias_file = commands_dir / f"{alias_output_name}{agent_config['extension']}"
+                alias_file = commands_dir / f"{alias}{agent_config['extension']}"
                alias_file.parent.mkdir(parents=True, exist_ok=True)
-                alias_file.write_text(alias_output, encoding="utf-8")
+                alias_file.write_text(output, encoding="utf-8")
                if agent_name == "copilot":
                    self.write_copilot_prompt(project_root, alias)
                registered.append(alias)
@@ -575,7 +396,7 @@ class CommandRegistrar:
        results = {}

        for agent_name, agent_config in self.AGENT_CONFIGS.items():
-            agent_dir = project_root / agent_config["dir"]
+            agent_dir = project_root / agent_config["dir"].split("/")[0]

            if agent_dir.exists():
                try:
@@ -609,8 +430,7 @@ class CommandRegistrar:
            commands_dir = project_root / agent_config["dir"]

            for cmd_name in cmd_names:
-                output_name = self._compute_output_name(agent_name, cmd_name, agent_config)
-                cmd_file = commands_dir / f"{output_name}{agent_config['extension']}"
+                cmd_file = commands_dir / f"{cmd_name}{agent_config['extension']}"
                if cmd_file.exists():
                    cmd_file.unlink()

--- a/src/specify_cli/extensions.py
+++ b/src/specify_cli/extensions.py
@@ -510,283 +510,6 @@ class ExtensionManager:

        return _ignore

-    def _get_skills_dir(self) -> Optional[Path]:
-        """Return the active skills directory for extension skill registration.
-
-        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.
-
-        Kimi is treated as a native-skills agent: if ``ai == "kimi"`` and
-        ``.kimi/skills`` exists, extension installs should still propagate
-        command skills even when ``ai_skills`` is false.
-
-        Returns:
-            The skills directory ``Path``, or ``None`` if skills were not
-            enabled and no native-skills fallback applies.
-        """
-        from . import load_init_options, _get_skills_dir as resolve_skills_dir
-
-        opts = load_init_options(self.project_root)
-        if not isinstance(opts, dict):
-            opts = {}
-
-        agent = opts.get("ai")
-        if not isinstance(agent, str) or not agent:
-            return None
-
-        ai_skills_enabled = bool(opts.get("ai_skills"))
-        if not ai_skills_enabled and agent != "kimi":
-            return None
-
-        skills_dir = resolve_skills_dir(self.project_root, agent)
-        if not skills_dir.is_dir():
-            return None
-
-        return skills_dir
-
-    def _register_extension_skills(
-        self,
-        manifest: ExtensionManifest,
-        extension_dir: Path,
-    ) -> List[str]:
-        """Generate SKILL.md files for extension commands as agent skills.
-
-        For every command in the extension manifest, creates a SKILL.md
-        file in the agent's skills directory following the agentskills.io
-        specification.  This is only done when ``--ai-skills`` was used
-        during project initialisation.
-
-        Args:
-            manifest: Extension manifest.
-            extension_dir: Installed extension directory.
-
-        Returns:
-            List of skill names that were created (for registry storage).
-        """
-        skills_dir = self._get_skills_dir()
-        if not skills_dir:
-            return []
-
-        from . import load_init_options
-        from .agents import CommandRegistrar
-        import yaml
-
-        written: List[str] = []
-        opts = load_init_options(self.project_root)
-        if not isinstance(opts, dict):
-            opts = {}
-        selected_ai = opts.get("ai")
-        if not isinstance(selected_ai, str) or not selected_ai:
-            return []
-        registrar = CommandRegistrar()
-
-        for cmd_info in manifest.commands:
-            cmd_name = cmd_info["name"]
-            cmd_file_rel = cmd_info["file"]
-
-            # Guard against path traversal: reject absolute paths and ensure
-            # the resolved file stays within the extension directory.
-            cmd_path = Path(cmd_file_rel)
-            if cmd_path.is_absolute():
-                continue
-            try:
-                ext_root = extension_dir.resolve()
-                source_file = (ext_root / cmd_path).resolve()
-                source_file.relative_to(ext_root)  # raises ValueError if outside
-            except (OSError, ValueError):
-                continue
-
-            if not source_file.is_file():
-                continue
-
-            # Derive skill name from command name using the same hyphenated
-            # convention as hook rendering and preset skill registration.
-            short_name_raw = cmd_name
-            if short_name_raw.startswith("speckit."):
-                short_name_raw = short_name_raw[len("speckit."):]
-            skill_name = f"speckit-{short_name_raw.replace('.', '-')}"
-
-            # Check if skill already exists before creating the directory
-            skill_subdir = skills_dir / skill_name
-            skill_file = skill_subdir / "SKILL.md"
-            if skill_file.exists():
-                # Do not overwrite user-customized skills
-                continue
-
-            # Create skill directory; track whether we created it so we can clean
-            # up safely if reading the source file subsequently fails.
-            created_now = not skill_subdir.exists()
-            skill_subdir.mkdir(parents=True, exist_ok=True)
-
-            # Parse the command file — guard against IsADirectoryError / decode errors
-            try:
-                content = source_file.read_text(encoding="utf-8")
-            except (OSError, UnicodeDecodeError):
-                if created_now:
-                    try:
-                        skill_subdir.rmdir()  # undo the mkdir; dir is empty at this point
-                    except OSError:
-                        pass  # best-effort cleanup
-                continue
-            frontmatter, body = registrar.parse_frontmatter(content)
-            frontmatter = registrar._adjust_script_paths(frontmatter)
-            body = registrar.resolve_skill_placeholders(
-                selected_ai, frontmatter, body, self.project_root
-            )
-
-            original_desc = frontmatter.get("description", "")
-            description = original_desc or f"Extension command: {cmd_name}"
-
-            frontmatter_data = {
-                "name": skill_name,
-                "description": description,
-                "compatibility": "Requires spec-kit project structure with .specify/ directory",
-                "metadata": {
-                    "author": "github-spec-kit",
-                    "source": f"extension:{manifest.id}",
-                },
-            }
-            frontmatter_text = yaml.safe_dump(frontmatter_data, sort_keys=False).strip()
-
-            # Derive a human-friendly title from the command name
-            short_name = cmd_name
-            if short_name.startswith("speckit."):
-                short_name = short_name[len("speckit."):]
-            title_name = short_name.replace(".", " ").replace("-", " ").title()
-
-            skill_content = (
-                f"---\n"
-                f"{frontmatter_text}\n"
-                f"---\n\n"
-                f"# {title_name} Skill\n\n"
-                f"{body}\n"
-            )
-
-            skill_file.write_text(skill_content, encoding="utf-8")
-            written.append(skill_name)
-
-        return written
-
-    def _unregister_extension_skills(self, skill_names: List[str], extension_id: str) -> None:
-        """Remove SKILL.md directories for extension skills.
-
-        Called during extension removal to clean up skill files that
-        were created by ``_register_extension_skills()``.
-
-        If ``_get_skills_dir()`` returns ``None`` (e.g. the user removed
-        init-options.json or toggled ai_skills after installation), we
-        fall back to scanning all known agent skills directories so that
-        orphaned skill directories are still cleaned up.  In that case
-        each candidate directory is verified against the SKILL.md
-        ``metadata.source`` field before removal to avoid accidentally
-        deleting user-created skills with the same name.
-
-        Args:
-            skill_names: List of skill names to remove.
-            extension_id: Extension ID used to verify ownership during
-                fallback candidate scanning.
-        """
-        if not skill_names:
-            return
-
-        skills_dir = self._get_skills_dir()
-
-        if skills_dir:
-            # Fast path: we know the exact skills directory
-            for skill_name in skill_names:
-                # Guard against path traversal from a corrupted registry entry:
-                # reject names that are absolute, contain path separators, or
-                # resolve to a path outside the skills directory.
-                sn_path = Path(skill_name)
-                if sn_path.is_absolute() or len(sn_path.parts) != 1:
-                    continue
-                try:
-                    skill_subdir = (skills_dir / skill_name).resolve()
-                    skill_subdir.relative_to(skills_dir.resolve())  # raises if outside
-                except (OSError, ValueError):
-                    continue
-                if not skill_subdir.is_dir():
-                    continue
-                # Safety check: only delete if SKILL.md exists and its
-                # metadata.source matches exactly this extension — mirroring
-                # the fallback branch — so a corrupted registry entry cannot
-                # delete an unrelated user skill.
-                skill_md = skill_subdir / "SKILL.md"
-                if not skill_md.is_file():
-                    continue
-                try:
-                    import yaml as _yaml
-                    raw = skill_md.read_text(encoding="utf-8")
-                    source = ""
-                    if raw.startswith("---"):
-                        parts = raw.split("---", 2)
-                        if len(parts) >= 3:
-                            fm = _yaml.safe_load(parts[1]) or {}
-                            source = (
-                                fm.get("metadata", {}).get("source", "")
-                                if isinstance(fm, dict)
-                                else ""
-                            )
-                    if source != f"extension:{extension_id}":
-                        continue
-                except (OSError, UnicodeDecodeError, Exception):
-                    continue
-                shutil.rmtree(skill_subdir)
-        else:
-            # Fallback: scan all possible agent skills directories
-            from . import AGENT_CONFIG, DEFAULT_SKILLS_DIR
-
-            candidate_dirs: set[Path] = set()
-            for cfg in AGENT_CONFIG.values():
-                folder = cfg.get("folder", "")
-                if folder:
-                    candidate_dirs.add(self.project_root / folder.rstrip("/") / "skills")
-            candidate_dirs.add(self.project_root / DEFAULT_SKILLS_DIR)
-
-            for skills_candidate in candidate_dirs:
-                if not skills_candidate.is_dir():
-                    continue
-                for skill_name in skill_names:
-                    # Same path-traversal guard as the fast path above
-                    sn_path = Path(skill_name)
-                    if sn_path.is_absolute() or len(sn_path.parts) != 1:
-                        continue
-                    try:
-                        skill_subdir = (skills_candidate / skill_name).resolve()
-                        skill_subdir.relative_to(skills_candidate.resolve())  # raises if outside
-                    except (OSError, ValueError):
-                        continue
-                    if not skill_subdir.is_dir():
-                        continue
-                    # Safety check: only delete if SKILL.md exists and its
-                    # metadata.source matches exactly this extension.  If the
-                    # file is missing or unreadable we skip to avoid deleting
-                    # unrelated user-created directories.
-                    skill_md = skill_subdir / "SKILL.md"
-                    if not skill_md.is_file():
-                        continue
-                    try:
-                        import yaml as _yaml
-                        raw = skill_md.read_text(encoding="utf-8")
-                        source = ""
-                        if raw.startswith("---"):
-                            parts = raw.split("---", 2)
-                            if len(parts) >= 3:
-                                fm = _yaml.safe_load(parts[1]) or {}
-                                source = (
-                                    fm.get("metadata", {}).get("source", "")
-                                    if isinstance(fm, dict)
-                                    else ""
-                                )
-                        # Only remove skills explicitly created by this extension
-                        if source != f"extension:{extension_id}":
-                            continue
-                    except (OSError, UnicodeDecodeError, Exception):
-                        # If we can't verify, skip to avoid accidental deletion
-                        continue
-                    shutil.rmtree(skill_subdir)
-
    def check_compatibility(
        self,
        manifest: ExtensionManifest,
@@ -878,10 +601,6 @@ class ExtensionManager:
                manifest, dest_dir, self.project_root
            )

-        # Auto-register extension commands as agent skills when --ai-skills
-        # was used during project initialisation (feature parity).
-        registered_skills = self._register_extension_skills(manifest, dest_dir)
-
        # Register hooks
        hook_executor = HookExecutor(self.project_root)
        hook_executor.register_hooks(manifest)
@@ -893,8 +612,7 @@ class ExtensionManager:
            "manifest_hash": manifest.get_hash(),
            "enabled": True,
            "priority": priority,
-            "registered_commands": registered_commands,
-            "registered_skills": registered_skills,
+            "registered_commands": registered_commands
        })

        return manifest
@@ -972,15 +690,9 @@ class ExtensionManager:
        if not self.registry.is_installed(extension_id):
            return False

-        # Get registered commands and skills before removal
+        # Get registered commands before removal
        metadata = self.registry.get(extension_id)
        registered_commands = metadata.get("registered_commands", {}) if metadata else {}
-        raw_skills = metadata.get("registered_skills", []) if metadata else []
-        # Normalize: must be a list of plain strings to avoid corrupted-registry errors
-        if isinstance(raw_skills, list):
-            registered_skills = [s for s in raw_skills if isinstance(s, str)]
-        else:
-            registered_skills = []

        extension_dir = self.extensions_dir / extension_id

@@ -989,9 +701,6 @@ class ExtensionManager:
            registrar = CommandRegistrar()
            registrar.unregister_commands(registered_commands, self.project_root)

-        # Unregister agent skills
-        self._unregister_extension_skills(registered_skills, extension_id)
-
        if keep_config:
            # Preserve config files, only remove non-config files
            if extension_dir.exists():
@@ -1266,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}"
            )
@@ -1758,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]:
@@ -1935,52 +1644,6 @@ class HookExecutor:
        self.project_root = project_root
        self.extensions_dir = project_root / ".specify" / "extensions"
        self.config_file = project_root / ".specify" / "extensions.yml"
-        self._init_options_cache: Optional[Dict[str, Any]] = None
-
-    def _load_init_options(self) -> Dict[str, Any]:
-        """Load persisted init options used to determine invocation style.
-
-        Uses the shared helper from specify_cli and caches values per executor
-        instance to avoid repeated filesystem reads during hook rendering.
-        """
-        if self._init_options_cache is None:
-            from . import load_init_options
-
-            payload = load_init_options(self.project_root)
-            self._init_options_cache = payload if isinstance(payload, dict) else {}
-        return self._init_options_cache
-
-    @staticmethod
-    def _skill_name_from_command(command: Any) -> str:
-        """Map a command id like speckit.plan to speckit-plan skill name."""
-        if not isinstance(command, str):
-            return ""
-        command_id = command.strip()
-        if not command_id.startswith("speckit."):
-            return ""
-        return f"speckit-{command_id[len('speckit.'):].replace('.', '-')}"
-
-    def _render_hook_invocation(self, command: Any) -> str:
-        """Render an agent-specific invocation string for a hook command."""
-        if not isinstance(command, str):
-            return ""
-
-        command_id = command.strip()
-        if not command_id:
-            return ""
-
-        init_options = self._load_init_options()
-        selected_ai = init_options.get("ai")
-        codex_skill_mode = selected_ai == "codex" and bool(init_options.get("ai_skills"))
-        kimi_skill_mode = selected_ai == "kimi"
-
-        skill_name = self._skill_name_from_command(command_id)
-        if codex_skill_mode and skill_name:
-            return f"${skill_name}"
-        if kimi_skill_mode and skill_name:
-            return f"/skill:{skill_name}"
-
-        return f"/{command_id}"

    def get_project_config(self) -> Dict[str, Any]:
        """Load project-level extension configuration.
@@ -1996,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},
@@ -2012,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):
@@ -2224,27 +1886,21 @@ class HookExecutor:
        for hook in hooks:
            extension = hook.get("extension")
            command = hook.get("command")
-            invocation = self._render_hook_invocation(command)
-            command_text = command if isinstance(command, str) and command.strip() else "<missing command>"
-            display_invocation = invocation or (
-                f"/{command_text}" if command_text != "<missing command>" else "/<missing command>"
-            )
            optional = hook.get("optional", True)
            prompt = hook.get("prompt", "")
            description = hook.get("description", "")

            if optional:
                lines.append(f"\n**Optional Hook**: {extension}")
-                lines.append(f"Command: `{display_invocation}`")
+                lines.append(f"Command: `/{command}`")
                if description:
                    lines.append(f"Description: {description}")
                lines.append(f"\nPrompt: {prompt}")
-                lines.append(f"To execute: `{display_invocation}`")
+                lines.append(f"To execute: `/{command}`")
            else:
                lines.append(f"\n**Automatic Hook**: {extension}")
-                lines.append(f"Executing: `{display_invocation}`")
-                lines.append(f"EXECUTE_COMMAND: {command_text}")
-                lines.append(f"EXECUTE_COMMAND_INVOCATION: {display_invocation}")
+                lines.append(f"Executing: `/{command}`")
+                lines.append(f"EXECUTE_COMMAND: {command}")

        return "\n".join(lines)

@@ -2308,7 +1964,6 @@ class HookExecutor:
        """
        return {
            "command": hook.get("command"),
-            "invocation": self._render_hook_invocation(hook.get("command")),
            "extension": hook.get("extension"),
            "optional": hook.get("optional", True),
            "description": hook.get("description", ""),
@@ -2352,3 +2007,4 @@ class HookExecutor:
                    hook["enabled"] = False

        self.save_project_config(config)
+
--- a/src/specify_cli/presets.py
+++ b/src/specify_cli/presets.py
@@ -556,31 +556,24 @@ class PresetManager:
        registrar.unregister_commands(registered_commands, self.project_root)

    def _get_skills_dir(self) -> Optional[Path]:
-        """Return the active skills directory for preset skill overrides.
+        """Return the skills directory if ``--ai-skills`` was used during init.

        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.

-        Kimi is treated as a native-skills agent: if ``ai == "kimi"`` and
-        ``.kimi/skills`` exists, presets should still propagate command
-        overrides to skills even when ``ai_skills`` is false.
-
        Returns:
            The skills directory ``Path``, or ``None`` if skills were not
-            enabled and no native-skills fallback applies.
+            enabled or the init-options file is missing.
        """
        from . import load_init_options, _get_skills_dir

        opts = load_init_options(self.project_root)
-        if not isinstance(opts, dict):
-            opts = {}
-        agent = opts.get("ai")
-        if not isinstance(agent, str) or not agent:
+        if not opts.get("ai_skills"):
            return None

-        ai_skills_enabled = bool(opts.get("ai_skills"))
-        if not ai_skills_enabled and agent != "kimi":
+        agent = opts.get("ai")
+        if not agent:
            return None

        skills_dir = _get_skills_dir(self.project_root, agent)
@@ -589,76 +582,6 @@ class PresetManager:

        return skills_dir

-    @staticmethod
-    def _skill_names_for_command(cmd_name: str) -> tuple[str, str]:
-        """Return the modern and legacy skill directory names for a command."""
-        raw_short_name = cmd_name
-        if raw_short_name.startswith("speckit."):
-            raw_short_name = raw_short_name[len("speckit."):]
-
-        modern_skill_name = f"speckit-{raw_short_name.replace('.', '-')}"
-        legacy_skill_name = f"speckit.{raw_short_name}"
-        return modern_skill_name, legacy_skill_name
-
-    @staticmethod
-    def _skill_title_from_command(cmd_name: str) -> str:
-        """Return a human-friendly title for a skill command name."""
-        title_name = cmd_name
-        if title_name.startswith("speckit."):
-            title_name = title_name[len("speckit."):]
-        return title_name.replace(".", " ").replace("-", " ").title()
-
-    def _build_extension_skill_restore_index(self) -> Dict[str, Dict[str, Any]]:
-        """Index extension-backed skill restore data by skill directory name."""
-        from .extensions import ExtensionManifest, ValidationError
-
-        resolver = PresetResolver(self.project_root)
-        extensions_dir = self.project_root / ".specify" / "extensions"
-        restore_index: Dict[str, Dict[str, Any]] = {}
-
-        for _priority, ext_id, _metadata in resolver._get_all_extensions_by_priority():
-            ext_dir = extensions_dir / ext_id
-            manifest_path = ext_dir / "extension.yml"
-            if not manifest_path.is_file():
-                continue
-
-            try:
-                manifest = ExtensionManifest(manifest_path)
-            except ValidationError:
-                continue
-
-            ext_root = ext_dir.resolve()
-            for cmd_info in manifest.commands:
-                cmd_name = cmd_info.get("name")
-                cmd_file_rel = cmd_info.get("file")
-                if not isinstance(cmd_name, str) or not isinstance(cmd_file_rel, str):
-                    continue
-
-                cmd_path = Path(cmd_file_rel)
-                if cmd_path.is_absolute():
-                    continue
-
-                try:
-                    source_file = (ext_root / cmd_path).resolve()
-                    source_file.relative_to(ext_root)
-                except (OSError, ValueError):
-                    continue
-
-                if not source_file.is_file():
-                    continue
-
-                restore_info = {
-                    "command_name": cmd_name,
-                    "source_file": source_file,
-                    "source": f"extension:{manifest.id}",
-                }
-                modern_skill_name, legacy_skill_name = self._skill_names_for_command(cmd_name)
-                restore_index.setdefault(modern_skill_name, restore_info)
-                if legacy_skill_name != modern_skill_name:
-                    restore_index.setdefault(legacy_skill_name, restore_info)
-
-        return restore_index
-
    def _register_skills(
        self,
        manifest: "PresetManifest",
@@ -706,15 +629,9 @@ class PresetManager:
            return []

        from . import SKILL_DESCRIPTIONS, load_init_options
-        from .agents import CommandRegistrar

-        init_opts = load_init_options(self.project_root)
-        if not isinstance(init_opts, dict):
-            init_opts = {}
-        selected_ai = init_opts.get("ai")
-        if not isinstance(selected_ai, str):
-            return []
-        registrar = CommandRegistrar()
+        opts = load_init_options(self.project_root)
+        selected_ai = opts.get("ai", "")

        written: List[str] = []

@@ -726,61 +643,64 @@ class PresetManager:
                continue

            # Derive the short command name (e.g. "specify" from "speckit.specify")
-            raw_short_name = cmd_name
-            if raw_short_name.startswith("speckit."):
-                raw_short_name = raw_short_name[len("speckit."):]
-            short_name = raw_short_name.replace(".", "-")
-            skill_name, legacy_skill_name = self._skill_names_for_command(cmd_name)
-            skill_title = self._skill_title_from_command(cmd_name)
+            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}"

-            # Only overwrite skills that already exist under skills_dir,
-            # including Kimi native skills when ai_skills is false.
-            # If both modern and legacy directories exist, update both.
-            target_skill_names: List[str] = []
-            if (skills_dir / skill_name).is_dir():
-                target_skill_names.append(skill_name)
-            if legacy_skill_name != skill_name and (skills_dir / legacy_skill_name).is_dir():
-                target_skill_names.append(legacy_skill_name)
-            if not target_skill_names:
+            # Only overwrite if the skill already exists (i.e. --ai-skills was used)
+            skill_subdir = skills_dir / skill_name
+            if not skill_subdir.exists():
                continue

            # Parse the command file
            content = source_file.read_text(encoding="utf-8")
-            frontmatter, body = registrar.parse_frontmatter(content)
+            if content.startswith("---"):
+                parts = content.split("---", 2)
+                if len(parts) >= 3:
+                    frontmatter = yaml.safe_load(parts[1])
+                    if not isinstance(frontmatter, dict):
+                        frontmatter = {}
+                    body = parts[2].strip()
+                else:
+                    frontmatter = {}
+                    body = content
+            else:
+                frontmatter = {}
+                body = content

            original_desc = frontmatter.get("description", "")
            enhanced_desc = SKILL_DESCRIPTIONS.get(
                short_name,
                original_desc or f"Spec-kit workflow command: {short_name}",
            )
-            frontmatter = dict(frontmatter)
-            frontmatter["description"] = enhanced_desc
-            body = registrar.resolve_skill_placeholders(
-                selected_ai, frontmatter, body, self.project_root
+
+            frontmatter_data = {
+                "name": skill_name,
+                "description": enhanced_desc,
+                "compatibility": "Requires spec-kit project structure with .specify/ directory",
+                "metadata": {
+                    "author": "github-spec-kit",
+                    "source": f"preset:{manifest.id}",
+                },
+            }
+            frontmatter_text = yaml.safe_dump(frontmatter_data, sort_keys=False).strip()
+            skill_content = (
+                f"---\n"
+                f"{frontmatter_text}\n"
+                f"---\n\n"
+                f"# Speckit {short_name.title()} Skill\n\n"
+                f"{body}\n"
            )

-            for target_skill_name in target_skill_names:
-                frontmatter_data = {
-                    "name": target_skill_name,
-                    "description": enhanced_desc,
-                    "compatibility": "Requires spec-kit project structure with .specify/ directory",
-                    "metadata": {
-                        "author": "github-spec-kit",
-                        "source": f"preset:{manifest.id}",
-                    },
-                }
-                frontmatter_text = yaml.safe_dump(frontmatter_data, sort_keys=False).strip()
-                skill_content = (
-                    f"---\n"
-                    f"{frontmatter_text}\n"
-                    f"---\n\n"
-                    f"# Speckit {skill_title} Skill\n\n"
-                    f"{body}\n"
-                )
-
-                skill_file = skills_dir / target_skill_name / "SKILL.md"
-                skill_file.write_text(skill_content, encoding="utf-8")
-                written.append(target_skill_name)
+            skill_file = skill_subdir / "SKILL.md"
+            skill_file.write_text(skill_content, encoding="utf-8")
+            written.append(skill_name)

        return written

@@ -802,17 +722,10 @@ class PresetManager:
        if not skills_dir:
            return

-        from . import SKILL_DESCRIPTIONS, load_init_options
-        from .agents import CommandRegistrar
+        from . import SKILL_DESCRIPTIONS

        # Locate core command templates from the project's installed templates
        core_templates_dir = self.project_root / ".specify" / "templates" / "commands"
-        init_opts = load_init_options(self.project_root)
-        if not isinstance(init_opts, dict):
-            init_opts = {}
-        selected_ai = init_opts.get("ai")
-        registrar = CommandRegistrar()
-        extension_restore_index = self._build_extension_skill_restore_index()

        for skill_name in skill_names:
            # Derive command name from skill name (speckit-specify -> specify)
@@ -824,10 +737,7 @@ class PresetManager:

            skill_subdir = skills_dir / skill_name
            skill_file = skill_subdir / "SKILL.md"
-            if not skill_subdir.is_dir():
-                continue
-            if not skill_file.is_file():
-                # Only manage directories that contain the expected skill entrypoint.
+            if not skill_file.exists():
                continue

            # Try to find the core command template
@@ -838,11 +748,19 @@ class PresetManager:
            if core_file:
                # Restore from core template
                content = core_file.read_text(encoding="utf-8")
-                frontmatter, body = registrar.parse_frontmatter(content)
-                if isinstance(selected_ai, str):
-                    body = registrar.resolve_skill_placeholders(
-                        selected_ai, frontmatter, body, self.project_root
-                    )
+                if content.startswith("---"):
+                    parts = content.split("---", 2)
+                    if len(parts) >= 3:
+                        frontmatter = yaml.safe_load(parts[1])
+                        if not isinstance(frontmatter, dict):
+                            frontmatter = {}
+                        body = parts[2].strip()
+                    else:
+                        frontmatter = {}
+                        body = content
+                else:
+                    frontmatter = {}
+                    body = content

                original_desc = frontmatter.get("description", "")
                enhanced_desc = SKILL_DESCRIPTIONS.get(
@@ -860,49 +778,16 @@ class PresetManager:
                    },
                }
                frontmatter_text = yaml.safe_dump(frontmatter_data, sort_keys=False).strip()
-                skill_title = self._skill_title_from_command(short_name)
                skill_content = (
                    f"---\n"
                    f"{frontmatter_text}\n"
                    f"---\n\n"
-                    f"# Speckit {skill_title} Skill\n\n"
-                    f"{body}\n"
-                )
-                skill_file.write_text(skill_content, encoding="utf-8")
-                continue
-
-            extension_restore = extension_restore_index.get(skill_name)
-            if extension_restore:
-                content = extension_restore["source_file"].read_text(encoding="utf-8")
-                frontmatter, body = registrar.parse_frontmatter(content)
-                if isinstance(selected_ai, str):
-                    body = registrar.resolve_skill_placeholders(
-                        selected_ai, frontmatter, body, self.project_root
-                    )
-
-                command_name = extension_restore["command_name"]
-                title_name = self._skill_title_from_command(command_name)
-
-                frontmatter_data = {
-                    "name": skill_name,
-                    "description": frontmatter.get("description", f"Extension command: {command_name}"),
-                    "compatibility": "Requires spec-kit project structure with .specify/ directory",
-                    "metadata": {
-                        "author": "github-spec-kit",
-                        "source": extension_restore["source"],
-                    },
-                }
-                frontmatter_text = yaml.safe_dump(frontmatter_data, sort_keys=False).strip()
-                skill_content = (
-                    f"---\n"
-                    f"{frontmatter_text}\n"
-                    f"---\n\n"
-                    f"# {title_name} Skill\n\n"
+                    f"# Speckit {short_name.title()} Skill\n\n"
                    f"{body}\n"
                )
                skill_file.write_text(skill_content, encoding="utf-8")
            else:
-                # No core or extension template — remove the skill entirely
+                # No core template — remove the skill entirely
                shutil.rmtree(skill_subdir)

    def install_from_directory(
@@ -1032,26 +917,17 @@ class PresetManager:
        if not self.registry.is_installed(pack_id):
            return False

+        # Unregister commands from AI agents
        metadata = self.registry.get(pack_id)
+        registered_commands = metadata.get("registered_commands", {}) if metadata else {}
+        if registered_commands:
+            self._unregister_commands(registered_commands)
+
        # Restore original skills when preset is removed
        registered_skills = metadata.get("registered_skills", []) if metadata else []
-        registered_commands = metadata.get("registered_commands", {}) if metadata else {}
        pack_dir = self.presets_dir / pack_id
        if registered_skills:
            self._unregister_skills(registered_skills, pack_dir)
-            try:
-                from . import NATIVE_SKILLS_AGENTS
-            except ImportError:
-                NATIVE_SKILLS_AGENTS = set()
-            registered_commands = {
-                agent_name: cmd_names
-                for agent_name, cmd_names in registered_commands.items()
-                if agent_name not in NATIVE_SKILLS_AGENTS
-            }
-
-        # Unregister non-skill command files from AI agents.
-        if registered_commands:
-            self._unregister_commands(registered_commands)

        if pack_dir.exists():
            shutil.rmtree(pack_dir)
@@ -1188,8 +1064,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}"
            )
--- a/templates/commands/analyze.md
+++ b/templates/commands/analyze.md
@@ -44,7 +44,7 @@ Load only the minimal necessary context from each artifact:

 - Overview/Context
 - Functional Requirements
- Success Criteria (measurable outcomes — e.g., performance, security, availability, user success, business impact)
+- Non-Functional Requirements
 - User Stories
 - Edge Cases (if present)

@@ -71,7 +71,7 @@ Load only the minimal necessary context from each artifact:

 Create internal representations (do not include raw artifacts in output):

- **Requirements inventory**: For each Functional Requirement (FR-###) and Success Criterion (SC-###), record a stable key. Use the explicit FR-/SC- identifier as the primary key when present, and optionally also derive an imperative-phrase slug for readability (e.g., "User can upload file" → `user-can-upload-file`). Include only Success Criteria items that require buildable work (e.g., load-testing infrastructure, security audit tooling), and exclude post-launch outcome metrics and business KPIs (e.g., "Reduce support tickets by 50%").
+- **Requirements inventory**: Each functional + non-functional requirement with a stable key (derive slug based on imperative phrase; e.g., "User can upload file" → `user-can-upload-file`)
 - **User story/action inventory**: Discrete user actions with acceptance criteria
 - **Task coverage mapping**: Map each task to one or more requirements or stories (inference by keyword / explicit reference patterns like IDs or key phrases)
 - **Constitution rule set**: Extract principle names and MUST/SHOULD normative statements
@@ -105,7 +105,7 @@ Focus on high-signal findings. Limit to 50 findings total; aggregate remainder i

 - Requirements with zero associated tasks
 - Tasks with no mapped requirement/story
- Success Criteria requiring buildable work (performance, security, availability) not reflected in tasks
+- Non-functional requirements not reflected in tasks (e.g., performance, security)

 #### F. Inconsistency

--- a/templates/commands/clarify.md
+++ b/templates/commands/clarify.md
@@ -145,7 +145,7 @@ Execution steps:
       - Functional ambiguity → Update or add a bullet in Functional Requirements.
       - User interaction / actor distinction → Update User Stories or Actors subsection (if present) with clarified role, constraint, or scenario.
       - Data shape / entities → Update Data Model (add fields, types, relationships) preserving ordering; note added constraints succinctly.
-       - Non-functional constraint → Add/modify measurable criteria in Success Criteria > Measurable Outcomes (convert vague adjective to metric or explicit target).
+       - Non-functional constraint → Add/modify measurable criteria in Non-Functional / Quality Attributes section (convert vague adjective to metric or explicit target).
       - Edge case / negative flow → Add a new bullet under Edge Cases / Error Handling (or create such subsection if template provides placeholder for it).
       - Terminology conflict → Normalize term across spec; retain original only if necessary by adding `(formerly referred to as "X")` once.
    - If the clarification invalidates an earlier ambiguous statement, replace that statement instead of duplicating; leave no obsolete contradictory text.
--- a/templates/commands/specify.md
+++ b/templates/commands/specify.md
@@ -73,16 +73,10 @@ Given that feature description, do this:
     - "Create a dashboard for analytics" → "analytics-dashboard"
     - "Fix payment processing timeout bug" → "fix-payment-timeout"

-2. **Create the feature branch** by running the script with `--short-name` (and `--json`). In sequential mode, do NOT pass `--number` — the script auto-detects the next available number. In timestamp mode, the script generates a `YYYYMMDD-HHMMSS` prefix automatically:
-
-   **Branch numbering mode**: Before running the script, check if `.specify/init-options.json` exists and read the `branch_numbering` value.
-   - If `"timestamp"`, add `--timestamp` (Bash) or `-Timestamp` (PowerShell) to the script invocation
-   - If `"sequential"` or absent, do not add any extra flag (default behavior)
+2. **Create the feature branch** by running the script with `--short-name` (and `--json`), and do NOT pass `--number` (the script auto-detects the next globally available number across all branches and spec directories):

   - Bash example: `{SCRIPT} --json --short-name "user-auth" "Add user authentication"`
-   - Bash (timestamp): `{SCRIPT} --json --timestamp --short-name "user-auth" "Add user authentication"`
   - PowerShell example: `{SCRIPT} -Json -ShortName "user-auth" "Add user authentication"`
-   - PowerShell (timestamp): `{SCRIPT} -Json -Timestamp -ShortName "user-auth" "Add user authentication"`

   **IMPORTANT**:
   - Do NOT pass `--number` — the script determines the correct next number automatically
--- a/templates/spec-template.md
+++ b/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"]
--- a/tests/test_agent_config_consistency.py
+++ b/tests/test_agent_config_consistency.py
@@ -29,17 +29,11 @@ class TestAgentConfigConsistency:
        assert "q" not in cfg

    def test_extension_registrar_includes_codex(self):
-        """Extension command registrar should include codex targeting .agents/skills."""
+        """Extension command registrar should include codex targeting .codex/prompts."""
        cfg = CommandRegistrar.AGENT_CONFIGS

        assert "codex" in cfg
-        assert cfg["codex"]["dir"] == ".agents/skills"
-        assert cfg["codex"]["extension"] == "/SKILL.md"
-
-    def test_runtime_codex_uses_native_skills(self):
-        """Codex runtime config should point at .agents/skills."""
-        assert AGENT_CONFIG["codex"]["folder"] == ".agents/"
-        assert AGENT_CONFIG["codex"]["commands_subdir"] == "skills"
+        assert cfg["codex"]["dir"] == ".codex/prompts"

    def test_release_agent_lists_include_kiro_cli_and_exclude_q(self):
        """Bash and PowerShell release scripts should agree on agent key set for Kiro."""
@@ -77,16 +71,6 @@ class TestAgentConfigConsistency:
        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

-    def test_release_scripts_generate_codex_skills(self):
-        """Release scripts should generate Codex skills in .agents/skills."""
-        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 ".agents/skills" in sh_text
-        assert ".agents/skills" in ps_text
-        assert re.search(r"codex\)\s*\n.*?create_skills.*?\.agents/skills.*?\"-\"", sh_text, re.S) is not None
-        assert re.search(r"'codex'\s*\{.*?\.agents/skills.*?New-Skills.*?-Separator '-'", 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."""
        assert "roo" in AI_ASSISTANT_HELP
--- a/tests/test_ai_skills.py
+++ b/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

@@ -24,8 +22,8 @@ import specify_cli

 from specify_cli import (
    _get_skills_dir,
-    _migrate_legacy_kimi_dotted_skills,
    install_ai_skills,
+    AGENT_SKILLS_DIR_OVERRIDES,
    DEFAULT_SKILLS_DIR,
    SKILL_DESCRIPTIONS,
    AGENT_CONFIG,
@@ -169,8 +167,8 @@ class TestGetSkillsDir:
        result = _get_skills_dir(project_dir, "copilot")
        assert result == project_dir / ".github" / "skills"

-    def test_codex_skills_dir_from_agent_config(self, project_dir):
-        """Codex should resolve skills directory from AGENT_CONFIG folder."""
+    def test_codex_uses_override(self, project_dir):
+        """Codex should use the AGENT_SKILLS_DIR_OVERRIDES value."""
        result = _get_skills_dir(project_dir, "codex")
        assert result == project_dir / ".agents" / "skills"

@@ -203,71 +201,12 @@ class TestGetSkillsDir:
            # Should always end with "skills"
            assert result.name == "skills"

-class TestKimiLegacySkillMigration:
-    """Test temporary migration from Kimi dotted skill names to hyphenated names."""
-
-    def test_migrates_legacy_dotted_skill_directory(self, project_dir):
-        skills_dir = project_dir / ".kimi" / "skills"
-        legacy_dir = skills_dir / "speckit.plan"
-        legacy_dir.mkdir(parents=True)
-        (legacy_dir / "SKILL.md").write_text("legacy")
-
-        migrated, removed = _migrate_legacy_kimi_dotted_skills(skills_dir)
-
-        assert migrated == 1
-        assert removed == 0
-        assert not legacy_dir.exists()
-        assert (skills_dir / "speckit-plan" / "SKILL.md").exists()
-
-    def test_removes_legacy_dir_when_hyphenated_target_exists_with_same_content(self, project_dir):
-        skills_dir = project_dir / ".kimi" / "skills"
-        legacy_dir = skills_dir / "speckit.plan"
-        legacy_dir.mkdir(parents=True)
-        (legacy_dir / "SKILL.md").write_text("legacy")
-        target_dir = skills_dir / "speckit-plan"
-        target_dir.mkdir(parents=True)
-        (target_dir / "SKILL.md").write_text("legacy")
-
-        migrated, removed = _migrate_legacy_kimi_dotted_skills(skills_dir)
-
-        assert migrated == 0
-        assert removed == 1
-        assert not legacy_dir.exists()
-        assert (target_dir / "SKILL.md").read_text() == "legacy"
-
-    def test_keeps_legacy_dir_when_hyphenated_target_differs(self, project_dir):
-        skills_dir = project_dir / ".kimi" / "skills"
-        legacy_dir = skills_dir / "speckit.plan"
-        legacy_dir.mkdir(parents=True)
-        (legacy_dir / "SKILL.md").write_text("legacy")
-        target_dir = skills_dir / "speckit-plan"
-        target_dir.mkdir(parents=True)
-        (target_dir / "SKILL.md").write_text("new")
-
-        migrated, removed = _migrate_legacy_kimi_dotted_skills(skills_dir)
-
-        assert migrated == 0
-        assert removed == 0
-        assert legacy_dir.exists()
-        assert (legacy_dir / "SKILL.md").read_text() == "legacy"
-        assert (target_dir / "SKILL.md").read_text() == "new"
-
-    def test_keeps_legacy_dir_when_matching_target_but_extra_files_exist(self, project_dir):
-        skills_dir = project_dir / ".kimi" / "skills"
-        legacy_dir = skills_dir / "speckit.plan"
-        legacy_dir.mkdir(parents=True)
-        (legacy_dir / "SKILL.md").write_text("legacy")
-        (legacy_dir / "notes.txt").write_text("custom")
-        target_dir = skills_dir / "speckit-plan"
-        target_dir.mkdir(parents=True)
-        (target_dir / "SKILL.md").write_text("legacy")
-
-        migrated, removed = _migrate_legacy_kimi_dotted_skills(skills_dir)
-
-        assert migrated == 0
-        assert removed == 0
-        assert legacy_dir.exists()
-        assert (legacy_dir / "notes.txt").read_text() == "custom"
+    def test_override_takes_precedence_over_config(self, project_dir):
+        """AGENT_SKILLS_DIR_OVERRIDES should take precedence over AGENT_CONFIG."""
+        for agent_key in AGENT_SKILLS_DIR_OVERRIDES:
+            result = _get_skills_dir(project_dir, agent_key)
+            expected = project_dir / AGENT_SKILLS_DIR_OVERRIDES[agent_key]
+            assert result == expected


 # ===== install_ai_skills Tests =====
@@ -532,7 +471,9 @@ 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()]
-        expected_skill_name = "speckit-specify"
+        # 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()

@@ -753,201 +694,6 @@ class TestNewProjectCommandSkip:
        prompts_dir = target / ".kiro" / "prompts"
        assert not prompts_dir.exists()

-    def test_codex_native_skills_preserved_without_conversion(self, tmp_path):
-        """Codex should keep bundled .agents/skills and skip install_ai_skills conversion."""
-        from typer.testing import CliRunner
-
-        runner = CliRunner()
-        target = tmp_path / "new-codex-proj"
-
-        def fake_download(project_path, *args, **kwargs):
-            skill_dir = project_path / ".agents" / "skills" / "speckit-specify"
-            skill_dir.mkdir(parents=True, exist_ok=True)
-            (skill_dir / "SKILL.md").write_text("---\ndescription: Test skill\n---\n\nBody.\n")
-
-        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") 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(
-                app,
-                ["init", str(target), "--ai", "codex", "--ai-skills", "--script", "sh", "--no-git"],
-            )
-
-        assert result.exit_code == 0
-        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."""
-        from typer.testing import CliRunner
-
-        runner = CliRunner()
-        target = tmp_path / "missing-codex-skills"
-
-        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.is_git_repo", return_value=False), \
-             patch("specify_cli.shutil.which", return_value="/usr/bin/codex"):
-            result = runner.invoke(
-                app,
-                ["init", str(target), "--ai", "codex", "--ai-skills", "--script", "sh", "--no-git"],
-            )
-
-        assert result.exit_code == 1
-        mock_skills.assert_called_once()
-        assert mock_skills.call_args.kwargs.get("overwrite_existing") is True
-        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."""
-        from typer.testing import CliRunner
-
-        runner = CliRunner()
-        target = tmp_path / "foreign-codex-skills"
-
-        def fake_download(project_path, *args, **kwargs):
-            skill_dir = project_path / ".agents" / "skills" / "other-tool"
-            skill_dir.mkdir(parents=True, exist_ok=True)
-            (skill_dir / "SKILL.md").write_text("---\ndescription: Foreign skill\n---\n\nBody.\n")
-
-        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.is_git_repo", return_value=False), \
-             patch("specify_cli.shutil.which", return_value="/usr/bin/codex"):
-            result = runner.invoke(
-                app,
-                ["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_kimi_legacy_migration_runs_without_ai_skills_flag(self, tmp_path):
-        """Kimi init should migrate dotted legacy skills even when --ai-skills is not set."""
-        from typer.testing import CliRunner
-
-        runner = CliRunner()
-        target = tmp_path / "kimi-legacy-no-ai-skills"
-
-        def fake_download(project_path, *args, **kwargs):
-            legacy_dir = project_path / ".kimi" / "skills" / "speckit.plan"
-            legacy_dir.mkdir(parents=True, exist_ok=True)
-            (legacy_dir / "SKILL.md").write_text("---\nname: speckit.plan\n---\n\nlegacy\n")
-
-        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.is_git_repo", return_value=False), \
-             patch("specify_cli.shutil.which", return_value="/usr/bin/kimi"):
-            result = runner.invoke(
-                app,
-                ["init", str(target), "--ai", "kimi", "--script", "sh", "--no-git"],
-            )
-
-        assert result.exit_code == 0
-        assert not (target / ".kimi" / "skills" / "speckit.plan").exists()
-        assert (target / ".kimi" / "skills" / "speckit-plan" / "SKILL.md").exists()
-
-    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()
-
    def test_commands_preserved_when_skills_fail(self, tmp_path):
        """If skills fail, commands should NOT be removed (safety net)."""
        from typer.testing import CliRunner
@@ -1038,21 +784,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 =====

@@ -1106,17 +837,6 @@ class TestCliValidation:
        assert "Explicit command support was deprecated in Antigravity version 1.20.5." in result.output
        assert "--ai-skills" in result.output

-    def test_codex_without_ai_skills_fails(self):
-        """--ai codex without --ai-skills should fail with exit code 1."""
-        from typer.testing import CliRunner
-
-        runner = CliRunner()
-        result = runner.invoke(app, ["init", "test-proj", "--ai", "codex"])
-
-        assert result.exit_code == 1
-        assert "Custom prompt-based spec-kit initialization is deprecated for Codex CLI" 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
@@ -1159,72 +879,6 @@ class TestCliValidation:
            assert result.exit_code == 0
            assert "Explicit command support was deprecated" not in result.output

-    def test_interactive_codex_without_ai_skills_enables_skills(self, monkeypatch):
-        """Interactive selector returning codex without --ai-skills should automatically enable --ai-skills."""
-        from typer.testing import CliRunner
-
-        def _fake_select_with_arrows(*args, **kwargs):
-            options = kwargs.get("options")
-            if options is None and len(args) >= 1:
-                options = args[0]
-
-            if isinstance(options, dict) and "codex" in options:
-                return "codex"
-            if isinstance(options, (list, tuple)) and "codex" in options:
-                return "codex"
-
-            if isinstance(options, dict) and options:
-                return next(iter(options.keys()))
-            if isinstance(options, (list, tuple)) and options:
-                return options[0]
-
-            return None
-
-        monkeypatch.setattr("specify_cli.select_with_arrows", _fake_select_with_arrows)
-
-        def _fake_download(*args, **kwargs):
-            project_path = Path(args[0])
-            skill_dir = project_path / ".agents" / "skills" / "speckit-specify"
-            skill_dir.mkdir(parents=True, exist_ok=True)
-            (skill_dir / "SKILL.md").write_text("---\ndescription: Test skill\n---\n\nBody.\n")
-
-        monkeypatch.setattr("specify_cli.download_and_extract_template", _fake_download)
-
-        runner = CliRunner()
-        with runner.isolated_filesystem():
-            result = runner.invoke(app, ["init", "test-proj", "--no-git", "--ignore-agent-tools"])
-
-            assert result.exit_code == 0
-            assert "Custom prompt-based spec-kit initialization is deprecated for Codex CLI" not in result.output
-            assert ".agents/skills" in result.output
-            assert "$speckit-constitution" in result.output
-            assert "/speckit.constitution" not in result.output
-            assert "Optional skills that you can use for your specs" in result.output
-
-    def test_kimi_next_steps_show_skill_invocation(self, monkeypatch):
-        """Kimi next-steps guidance should display /skill:speckit-* usage."""
-        from typer.testing import CliRunner
-
-        def _fake_download(*args, **kwargs):
-            project_path = Path(args[0])
-            skill_dir = project_path / ".kimi" / "skills" / "speckit-specify"
-            skill_dir.mkdir(parents=True, exist_ok=True)
-            (skill_dir / "SKILL.md").write_text("---\ndescription: Test skill\n---\n\nBody.\n")
-
-        monkeypatch.setattr("specify_cli.download_and_extract_template", _fake_download)
-
-        runner = CliRunner()
-        with runner.isolated_filesystem():
-            result = runner.invoke(
-                app,
-                ["init", "test-proj", "--ai", "kimi", "--no-git", "--ignore-agent-tools"],
-            )
-
-            assert result.exit_code == 0
-            assert "/skill:speckit-constitution" in result.output
-            assert "/speckit.constitution" not in result.output
-            assert "Optional skills that you can use for your specs" 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
@@ -1244,12 +898,10 @@ class TestCliValidation:
        target = tmp_path / "kiro-alias-proj"

        with patch("specify_cli.download_and_extract_template") as mock_download, \
-             patch("specify_cli.scaffold_from_core_pack", create=True) as mock_scaffold, \
             patch("specify_cli.ensure_executable_scripts"), \
             patch("specify_cli.ensure_constitution_from_template"), \
             patch("specify_cli.is_git_repo", return_value=False), \
             patch("specify_cli.shutil.which", return_value="/usr/bin/git"):
-            mock_scaffold.return_value = True
            result = runner.invoke(
                app,
                [
@@ -1265,14 +917,9 @@ class TestCliValidation:
            )

        assert result.exit_code == 0
-        # Without --offline, the download path should be taken.
-        assert mock_download.called, (
-            "Expected download_and_extract_template to be called (default non-offline path)"
-        )
+        assert mock_download.called
+        # download_and_extract_template(project_path, ai_assistant, script_type, ...)
        assert mock_download.call_args.args[1] == "kiro-cli"
-        assert not mock_scaffold.called, (
-            "scaffold_from_core_pack should not be called without --offline"
-        )

    def test_q_removed_from_agent_config(self):
        """Amazon Q legacy key should not remain in AGENT_CONFIG."""
--- a/tests/test_branch_numbering.py
+++ b/tests/test_branch_numbering.py
@@ -1,89 +0,0 @@
-"""
-Unit tests for branch numbering options (sequential vs timestamp).
-
-Tests cover:
- Persisting branch_numbering in init-options.json
- Default value when branch_numbering is None
- Validation of branch_numbering values
-"""
-
-import json
-from pathlib import Path
-
-from specify_cli import save_init_options
-
-
-class TestSaveBranchNumbering:
-    """Tests for save_init_options with branch_numbering."""
-
-    def test_save_branch_numbering_timestamp(self, tmp_path: Path):
-        opts = {"branch_numbering": "timestamp", "ai": "claude"}
-        save_init_options(tmp_path, opts)
-
-        saved = json.loads((tmp_path / ".specify/init-options.json").read_text())
-        assert saved["branch_numbering"] == "timestamp"
-
-    def test_save_branch_numbering_sequential(self, tmp_path: Path):
-        opts = {"branch_numbering": "sequential", "ai": "claude"}
-        save_init_options(tmp_path, opts)
-
-        saved = json.loads((tmp_path / ".specify/init-options.json").read_text())
-        assert saved["branch_numbering"] == "sequential"
-
-    def test_branch_numbering_defaults_to_sequential(self, tmp_path: Path, monkeypatch):
-        from typer.testing import CliRunner
-        from specify_cli import app
-
-        def _fake_download(project_path, *args, **kwargs):
-            Path(project_path).mkdir(parents=True, exist_ok=True)
-
-        monkeypatch.setattr("specify_cli.download_and_extract_template", _fake_download)
-
-        project_dir = tmp_path / "proj"
-        runner = CliRunner()
-        result = runner.invoke(app, ["init", str(project_dir), "--ai", "claude", "--ignore-agent-tools"])
-        assert result.exit_code == 0
-
-        saved = json.loads((project_dir / ".specify/init-options.json").read_text())
-        assert saved["branch_numbering"] == "sequential"
-
-
-class TestBranchNumberingValidation:
-    """Tests for branch_numbering CLI validation via CliRunner."""
-
-    def test_invalid_branch_numbering_rejected(self, tmp_path: Path):
-        from typer.testing import CliRunner
-        from specify_cli import app
-
-        runner = CliRunner()
-        result = runner.invoke(app, ["init", str(tmp_path / "proj"), "--ai", "claude", "--branch-numbering", "foobar"])
-        assert result.exit_code == 1
-        assert "Invalid --branch-numbering" in result.output
-
-    def test_valid_branch_numbering_sequential(self, tmp_path: Path, monkeypatch):
-        from typer.testing import CliRunner
-        from specify_cli import app
-
-        def _fake_download(project_path, *args, **kwargs):
-            Path(project_path).mkdir(parents=True, exist_ok=True)
-
-        monkeypatch.setattr("specify_cli.download_and_extract_template", _fake_download)
-
-        runner = CliRunner()
-        result = runner.invoke(app, ["init", str(tmp_path / "proj"), "--ai", "claude", "--branch-numbering", "sequential", "--ignore-agent-tools"])
-        assert result.exit_code == 0
-        assert "Invalid --branch-numbering" not in (result.output or "")
-
-    def test_valid_branch_numbering_timestamp(self, tmp_path: Path, monkeypatch):
-        from typer.testing import CliRunner
-        from specify_cli import app
-
-        def _fake_download(project_path, *args, **kwargs):
-            Path(project_path).mkdir(parents=True, exist_ok=True)
-
-        monkeypatch.setattr("specify_cli.download_and_extract_template", _fake_download)
-
-        runner = CliRunner()
-        result = runner.invoke(app, ["init", str(tmp_path / "proj"), "--ai", "claude", "--branch-numbering", "timestamp", "--ignore-agent-tools"])
-        assert result.exit_code == 0
-        assert "Invalid --branch-numbering" not in (result.output or "")
--- a/tests/test_core_pack_scaffold.py
+++ b/tests/test_core_pack_scaffold.py
@@ -1,613 +0,0 @@
-"""
-Validation tests for offline/air-gapped scaffolding (PR #1803).
-
-For every supported AI agent (except "generic") the scaffold output is verified
-against invariants and compared byte-for-byte with the canonical output produced
-by create-release-packages.sh.
-
-Since scaffold_from_core_pack() now invokes the release script at runtime, the
-parity test (section 9) runs the script independently and compares the results
-to ensure the integration is correct.
-
-Per-agent invariants verified
-──────────────────────────────
-  • Command files are written to the directory declared in AGENT_CONFIG
-  • File count matches the number of source templates
-  • Extension is correct: .toml (TOML agents), .agent.md (copilot), .md (rest)
-  • No unresolved placeholders remain ({SCRIPT}, {ARGS}, __AGENT__)
-  • Argument token is correct: {{args}} for TOML agents, $ARGUMENTS for others
-  • Path rewrites applied: scripts/ → .specify/scripts/ etc.
-  • TOML files have "description" and "prompt" fields
-  • Markdown files have parseable YAML frontmatter
-  • Copilot: companion speckit.*.prompt.md files are generated in prompts/
-  • .specify/scripts/ contains at least one script file
-  • .specify/templates/ contains at least one template file
-
-Parity invariant
-────────────────
-  Every file produced by scaffold_from_core_pack() must be byte-for-byte
-  identical to the same file in the ZIP produced by the release script.
-"""
-
-import os
-import re
-import shutil
-import subprocess
-import tomllib
-import zipfile
-from pathlib import Path
-
-import pytest
-import yaml
-
-from specify_cli import (
-    AGENT_CONFIG,
-    _TOML_AGENTS,
-    _locate_core_pack,
-    scaffold_from_core_pack,
-)
-
-_REPO_ROOT = Path(__file__).parent.parent
-_RELEASE_SCRIPT = _REPO_ROOT / ".github" / "workflows" / "scripts" / "create-release-packages.sh"
-
-
-def _find_bash() -> str | None:
-    """Return the path to a usable bash on this machine, or None."""
-    # Prefer PATH lookup so non-standard install locations (Nix, CI) are found.
-    on_path = shutil.which("bash")
-    if on_path:
-        return on_path
-    candidates = [
-        "/opt/homebrew/bin/bash",
-        "/usr/local/bin/bash",
-        "/bin/bash",
-        "/usr/bin/bash",
-    ]
-    for candidate in candidates:
-        try:
-            result = subprocess.run(
-                [candidate, "--version"],
-                capture_output=True, text=True, timeout=5,
-            )
-            if result.returncode == 0:
-                return candidate
-        except (FileNotFoundError, subprocess.TimeoutExpired):
-            continue
-    return None
-
-
-def _run_release_script(agent: str, script_type: str, bash: str, output_dir: Path) -> Path:
-    """Run create-release-packages.sh for *agent*/*script_type* and return the
-    path to the generated ZIP.  *output_dir* receives the build artifacts so
-    the repo working tree stays clean."""
-    env = os.environ.copy()
-    env["AGENTS"] = agent
-    env["SCRIPTS"] = script_type
-    env["GENRELEASES_DIR"] = str(output_dir)
-
-    result = subprocess.run(
-        [bash, str(_RELEASE_SCRIPT), "v0.0.0"],
-        capture_output=True, text=True,
-        cwd=str(_REPO_ROOT),
-        env=env,
-        timeout=300,
-    )
-
-    if result.returncode != 0:
-        pytest.fail(
-            f"Release script failed with exit code {result.returncode}\n"
-            f"stdout:\n{result.stdout}\nstderr:\n{result.stderr}"
-        )
-
-    zip_pattern = f"spec-kit-template-{agent}-{script_type}-v0.0.0.zip"
-    zip_path = output_dir / zip_pattern
-    if not zip_path.exists():
-        pytest.fail(
-            f"Release script did not produce expected ZIP: {zip_path}\n"
-            f"stdout:\n{result.stdout}\nstderr:\n{result.stderr}"
-        )
-    return zip_path
-
-# ---------------------------------------------------------------------------
-# Helpers
-# ---------------------------------------------------------------------------
-
-# Number of source command templates (one per .md file in templates/commands/)
-
-
-def _commands_dir() -> Path:
-    """Return the command templates directory (source-checkout or core_pack)."""
-    core = _locate_core_pack()
-    if core and (core / "commands").is_dir():
-        return core / "commands"
-    # Source-checkout fallback
-    repo_root = Path(__file__).parent.parent
-    return repo_root / "templates" / "commands"
-
-
-def _get_source_template_stems() -> list[str]:
-    """Return the stems of source command template files (e.g. ['specify', 'plan', ...])."""
-    return sorted(p.stem for p in _commands_dir().glob("*.md"))
-
-
-def _expected_cmd_dir(project_path: Path, agent: str) -> Path:
-    """Return the expected command-files directory for a given agent."""
-    cfg = AGENT_CONFIG[agent]
-    folder = (cfg.get("folder") or "").rstrip("/")
-    subdir = cfg.get("commands_subdir", "commands")
-    if folder:
-        return project_path / folder / subdir
-    return project_path / ".speckit" / subdir
-
-
-# Agents whose commands are laid out as <skills_dir>/<name>/SKILL.md.
-# Maps agent -> separator used in skill directory names.
-_SKILL_AGENTS: dict[str, str] = {"codex": "-", "kimi": "-"}
-
-
-def _expected_ext(agent: str) -> str:
-    if agent in _TOML_AGENTS:
-        return "toml"
-    if agent == "copilot":
-        return "agent.md"
-    if agent in _SKILL_AGENTS:
-        return "SKILL.md"
-    return "md"
-
-
-def _list_command_files(cmd_dir: Path, agent: str) -> list[Path]:
-    """List generated command files, handling skills-based directory layouts."""
-    if agent in _SKILL_AGENTS:
-        sep = _SKILL_AGENTS[agent]
-        return sorted(cmd_dir.glob(f"speckit{sep}*/SKILL.md"))
-    ext = _expected_ext(agent)
-    return sorted(cmd_dir.glob(f"speckit.*.{ext}"))
-
-
-def _collect_relative_files(root: Path) -> dict[str, bytes]:
-    """Walk *root* and return {relative_posix_path: file_bytes}."""
-    result: dict[str, bytes] = {}
-    for p in root.rglob("*"):
-        if p.is_file():
-            result[p.relative_to(root).as_posix()] = p.read_bytes()
-    return result
-
-
-# ---------------------------------------------------------------------------
-# Fixtures
-# ---------------------------------------------------------------------------
-
-@pytest.fixture(scope="session")
-def source_template_stems() -> list[str]:
-    return _get_source_template_stems()
-
-
-@pytest.fixture(scope="session")
-def scaffolded_sh(tmp_path_factory):
-    """Session-scoped cache: scaffold once per agent with script_type='sh'."""
-    cache = {}
-    def _get(agent: str) -> Path:
-        if agent not in cache:
-            project = tmp_path_factory.mktemp(f"scaffold_sh_{agent}")
-            ok = scaffold_from_core_pack(project, agent, "sh")
-            assert ok, f"scaffold_from_core_pack returned False for agent '{agent}'"
-            cache[agent] = project
-        return cache[agent]
-    return _get
-
-
-@pytest.fixture(scope="session")
-def scaffolded_ps(tmp_path_factory):
-    """Session-scoped cache: scaffold once per agent with script_type='ps'."""
-    cache = {}
-    def _get(agent: str) -> Path:
-        if agent not in cache:
-            project = tmp_path_factory.mktemp(f"scaffold_ps_{agent}")
-            ok = scaffold_from_core_pack(project, agent, "ps")
-            assert ok, f"scaffold_from_core_pack returned False for agent '{agent}'"
-            cache[agent] = project
-        return cache[agent]
-    return _get
-
-
-# ---------------------------------------------------------------------------
-# Parametrize over all agents except "generic"
-# ---------------------------------------------------------------------------
-
-_TESTABLE_AGENTS = [a for a in AGENT_CONFIG if a != "generic"]
-
-
-# ---------------------------------------------------------------------------
-# 1. Bundled scaffold — directory structure
-# ---------------------------------------------------------------------------
-
-@pytest.mark.parametrize("agent", _TESTABLE_AGENTS)
-def test_scaffold_creates_specify_scripts(agent, scaffolded_sh):
-    """scaffold_from_core_pack copies at least one script into .specify/scripts/."""
-    project = scaffolded_sh(agent)
-
-    scripts_dir = project / ".specify" / "scripts" / "bash"
-    assert scripts_dir.is_dir(), f".specify/scripts/bash/ missing for agent '{agent}'"
-    assert any(scripts_dir.iterdir()), f".specify/scripts/bash/ is empty for agent '{agent}'"
-
-
-@pytest.mark.parametrize("agent", _TESTABLE_AGENTS)
-def test_scaffold_creates_specify_templates(agent, scaffolded_sh):
-    """scaffold_from_core_pack copies at least one page template into .specify/templates/."""
-    project = scaffolded_sh(agent)
-
-    tpl_dir = project / ".specify" / "templates"
-    assert tpl_dir.is_dir(), f".specify/templates/ missing for agent '{agent}'"
-    assert any(tpl_dir.iterdir()), ".specify/templates/ is empty"
-
-
-@pytest.mark.parametrize("agent", _TESTABLE_AGENTS)
-def test_scaffold_command_dir_location(agent, scaffolded_sh):
-    """Command files land in the directory declared by AGENT_CONFIG."""
-    project = scaffolded_sh(agent)
-
-    cmd_dir = _expected_cmd_dir(project, agent)
-    assert cmd_dir.is_dir(), (
-        f"Command dir '{cmd_dir.relative_to(project)}' not created for agent '{agent}'"
-    )
-
-
-# ---------------------------------------------------------------------------
-# 2. Bundled scaffold — file count
-# ---------------------------------------------------------------------------
-
-@pytest.mark.parametrize("agent", _TESTABLE_AGENTS)
-def test_scaffold_command_file_count(agent, scaffolded_sh, source_template_stems):
-    """One command file is generated per source template for every agent."""
-    project = scaffolded_sh(agent)
-
-    cmd_dir = _expected_cmd_dir(project, agent)
-    generated = _list_command_files(cmd_dir, agent)
-
-    if cmd_dir.is_dir():
-        dir_listing = list(cmd_dir.iterdir())
-    else:
-        dir_listing = f"<command dir missing: {cmd_dir}>"
-
-    assert len(generated) == len(source_template_stems), (
-        f"Agent '{agent}': expected {len(source_template_stems)} command files "
-        f"({_expected_ext(agent)}), found {len(generated)}. Dir: {dir_listing}"
-    )
-
-
-@pytest.mark.parametrize("agent", _TESTABLE_AGENTS)
-def test_scaffold_command_file_names(agent, scaffolded_sh, source_template_stems):
-    """Each source template stem maps to a corresponding speckit.<stem>.<ext> file."""
-    project = scaffolded_sh(agent)
-
-    cmd_dir = _expected_cmd_dir(project, agent)
-    for stem in source_template_stems:
-        if agent in _SKILL_AGENTS:
-            sep = _SKILL_AGENTS[agent]
-            expected = cmd_dir / f"speckit{sep}{stem}" / "SKILL.md"
-        else:
-            ext = _expected_ext(agent)
-            expected = cmd_dir / f"speckit.{stem}.{ext}"
-        assert expected.is_file(), (
-            f"Agent '{agent}': expected file '{expected.name}' not found in '{cmd_dir}'"
-        )
-
-
-# ---------------------------------------------------------------------------
-# 3. Bundled scaffold — content invariants
-# ---------------------------------------------------------------------------
-
-@pytest.mark.parametrize("agent", _TESTABLE_AGENTS)
-def test_no_unresolved_script_placeholder(agent, scaffolded_sh):
-    """{SCRIPT} must not appear in any generated command file."""
-    project = scaffolded_sh(agent)
-
-    cmd_dir = _expected_cmd_dir(project, agent)
-    for f in cmd_dir.rglob("*"):
-        if f.is_file():
-            content = f.read_text(encoding="utf-8")
-            assert "{SCRIPT}" not in content, (
-                f"Unresolved {{SCRIPT}} in '{f.relative_to(project)}' for agent '{agent}'"
-            )
-
-
-@pytest.mark.parametrize("agent", _TESTABLE_AGENTS)
-def test_no_unresolved_agent_placeholder(agent, scaffolded_sh):
-    """__AGENT__ must not appear in any generated command file."""
-    project = scaffolded_sh(agent)
-
-    cmd_dir = _expected_cmd_dir(project, agent)
-    for f in cmd_dir.rglob("*"):
-        if f.is_file():
-            content = f.read_text(encoding="utf-8")
-            assert "__AGENT__" not in content, (
-                f"Unresolved __AGENT__ in '{f.relative_to(project)}' for agent '{agent}'"
-            )
-
-
-@pytest.mark.parametrize("agent", _TESTABLE_AGENTS)
-def test_no_unresolved_args_placeholder(agent, scaffolded_sh):
-    """{ARGS} must not appear in any generated command file (replaced with agent-specific token)."""
-    project = scaffolded_sh(agent)
-
-    cmd_dir = _expected_cmd_dir(project, agent)
-    for f in cmd_dir.rglob("*"):
-        if f.is_file():
-            content = f.read_text(encoding="utf-8")
-            assert "{ARGS}" not in content, (
-                f"Unresolved {{ARGS}} in '{f.relative_to(project)}' for agent '{agent}'"
-            )
-
-
-# Build a set of template stems that actually contain {ARGS} in their source.
-_TEMPLATES_WITH_ARGS: frozenset[str] = frozenset(
-    p.stem
-    for p in _commands_dir().glob("*.md")
-    if "{ARGS}" in p.read_text(encoding="utf-8")
-)
-
-
-@pytest.mark.parametrize("agent", _TESTABLE_AGENTS)
-def test_argument_token_format(agent, scaffolded_sh):
-    """For templates that carry an {ARGS} token:
-    - TOML agents must emit {{args}}
-    - Markdown agents must emit $ARGUMENTS
-    Templates without {ARGS} (e.g. implement, plan) are skipped.
-    """
-    project = scaffolded_sh(agent)
-
-    cmd_dir = _expected_cmd_dir(project, agent)
-
-    for f in _list_command_files(cmd_dir, agent):
-        # Recover the stem from the file path
-        if agent in _SKILL_AGENTS:
-            sep = _SKILL_AGENTS[agent]
-            stem = f.parent.name.removeprefix(f"speckit{sep}")
-        else:
-            ext = _expected_ext(agent)
-            stem = f.name.removeprefix("speckit.").removesuffix(f".{ext}")
-        if stem not in _TEMPLATES_WITH_ARGS:
-            continue  # this template has no argument token
-
-        content = f.read_text(encoding="utf-8")
-        if agent in _TOML_AGENTS:
-            assert "{{args}}" in content, (
-                f"TOML agent '{agent}': expected '{{{{args}}}}' in '{f.name}'"
-            )
-        else:
-            assert "$ARGUMENTS" in content, (
-                f"Markdown agent '{agent}': expected '$ARGUMENTS' in '{f.name}'"
-            )
-
-
-@pytest.mark.parametrize("agent", _TESTABLE_AGENTS)
-def test_path_rewrites_applied(agent, scaffolded_sh):
-    """Bare scripts/ and templates/ paths must be rewritten to .specify/ variants.
-
-    YAML frontmatter 'source:' metadata fields are excluded — they reference
-    the original template path for provenance, not a runtime path.
-    """
-    project = scaffolded_sh(agent)
-
-    cmd_dir = _expected_cmd_dir(project, agent)
-    for f in cmd_dir.rglob("*"):
-        if not f.is_file():
-            continue
-        content = f.read_text(encoding="utf-8")
-
-        # Strip YAML frontmatter before checking — source: metadata is not a runtime path
-        body = content
-        if content.startswith("---"):
-            parts = content.split("---", 2)
-            if len(parts) >= 3:
-                body = parts[2]
-
-        # Should not contain bare (non-.specify/) script paths
-        assert not re.search(r'(?<!\.specify/)scripts/', body), (
-            f"Bare scripts/ path found in '{f.relative_to(project)}' for agent '{agent}'"
-        )
-        assert not re.search(r'(?<!\.specify/)templates/', body), (
-            f"Bare templates/ path found in '{f.relative_to(project)}' for agent '{agent}'"
-        )
-
-
-# ---------------------------------------------------------------------------
-# 4. TOML format checks
-# ---------------------------------------------------------------------------
-
-@pytest.mark.parametrize("agent", sorted(_TOML_AGENTS))
-def test_toml_format_valid(agent, scaffolded_sh):
-    """TOML agents: every command file must have description and prompt fields."""
-    project = scaffolded_sh(agent)
-
-    cmd_dir = _expected_cmd_dir(project, agent)
-    for f in cmd_dir.glob("speckit.*.toml"):
-        content = f.read_text(encoding="utf-8")
-        assert 'description = "' in content, (
-            f"Missing 'description' in '{f.name}' for agent '{agent}'"
-        )
-        assert 'prompt = """' in content, (
-            f"Missing 'prompt' block in '{f.name}' for agent '{agent}'"
-        )
-
-
-# ---------------------------------------------------------------------------
-# 5. Markdown frontmatter checks
-# ---------------------------------------------------------------------------
-
-_MARKDOWN_AGENTS = [a for a in _TESTABLE_AGENTS if a not in _TOML_AGENTS]
-
-
-@pytest.mark.parametrize("agent", _MARKDOWN_AGENTS)
-def test_markdown_has_frontmatter(agent, scaffolded_sh):
-    """Markdown agents: every command file must start with valid YAML frontmatter."""
-    project = scaffolded_sh(agent)
-
-    cmd_dir = _expected_cmd_dir(project, agent)
-    for f in _list_command_files(cmd_dir, agent):
-        content = f.read_text(encoding="utf-8")
-        assert content.startswith("---"), (
-            f"No YAML frontmatter in '{f.name}' for agent '{agent}'"
-        )
-        parts = content.split("---", 2)
-        assert len(parts) >= 3, f"Incomplete frontmatter in '{f.name}'"
-        fm = yaml.safe_load(parts[1])
-        assert fm is not None, f"Empty frontmatter in '{f.name}'"
-        assert "description" in fm, (
-            f"'description' key missing from frontmatter in '{f.name}' for agent '{agent}'"
-        )
-
-
-# ---------------------------------------------------------------------------
-# 6. Copilot-specific: companion .prompt.md files
-# ---------------------------------------------------------------------------
-
-def test_copilot_companion_prompt_files(scaffolded_sh, source_template_stems):
-    """Copilot: a speckit.<stem>.prompt.md companion is created for every .agent.md file."""
-    project = scaffolded_sh("copilot")
-
-    prompts_dir = project / ".github" / "prompts"
-    assert prompts_dir.is_dir(), ".github/prompts/ not created for copilot"
-
-    for stem in source_template_stems:
-        prompt_file = prompts_dir / f"speckit.{stem}.prompt.md"
-        assert prompt_file.is_file(), (
-            f"Companion prompt file '{prompt_file.name}' missing for copilot"
-        )
-
-
-def test_copilot_prompt_file_content(scaffolded_sh, source_template_stems):
-    """Copilot companion .prompt.md files must reference their parent .agent.md."""
-    project = scaffolded_sh("copilot")
-
-    prompts_dir = project / ".github" / "prompts"
-    for stem in source_template_stems:
-        f = prompts_dir / f"speckit.{stem}.prompt.md"
-        content = f.read_text(encoding="utf-8")
-        assert f"agent: speckit.{stem}" in content, (
-            f"Companion '{f.name}' does not reference 'speckit.{stem}'"
-        )
-
-
-# ---------------------------------------------------------------------------
-# 7. PowerShell script variant
-# ---------------------------------------------------------------------------
-
-@pytest.mark.parametrize("agent", _TESTABLE_AGENTS)
-def test_scaffold_powershell_variant(agent, scaffolded_ps, source_template_stems):
-    """scaffold_from_core_pack with script_type='ps' creates correct files."""
-    project = scaffolded_ps(agent)
-
-    scripts_dir = project / ".specify" / "scripts" / "powershell"
-    assert scripts_dir.is_dir(), f".specify/scripts/powershell/ missing for '{agent}'"
-    assert any(scripts_dir.iterdir()), ".specify/scripts/powershell/ is empty"
-
-    cmd_dir = _expected_cmd_dir(project, agent)
-    generated = _list_command_files(cmd_dir, agent)
-    assert len(generated) == len(source_template_stems)
-
-
-# ---------------------------------------------------------------------------
-# 8. Parity: bundled vs. real create-release-packages.sh ZIP
-# ---------------------------------------------------------------------------
-
-@pytest.fixture(scope="session")
-def release_script_trees(tmp_path_factory):
-    """Session-scoped cache: run release script once per (agent, script_type)."""
-    cache: dict[tuple[str, str], dict[str, bytes]] = {}
-    bash = _find_bash()
-
-    def _get(agent: str, script_type: str) -> dict[str, bytes] | None:
-        if bash is None:
-            return None
-        key = (agent, script_type)
-        if key not in cache:
-            tmp = tmp_path_factory.mktemp(f"release_{agent}_{script_type}")
-            gen_dir = tmp / "genreleases"
-            gen_dir.mkdir()
-            zip_path = _run_release_script(agent, script_type, bash, gen_dir)
-            extracted = tmp / "extracted"
-            extracted.mkdir()
-            with zipfile.ZipFile(zip_path) as zf:
-                zf.extractall(extracted)
-            cache[key] = _collect_relative_files(extracted)
-        return cache[key]
-    return _get
-
-
-@pytest.mark.parametrize("script_type", ["sh", "ps"])
-@pytest.mark.parametrize("agent", _TESTABLE_AGENTS)
-def test_parity_bundled_vs_release_script(agent, script_type, scaffolded_sh, scaffolded_ps, release_script_trees):
-    """scaffold_from_core_pack() file tree is identical to the ZIP produced by
-    create-release-packages.sh for every agent and script type.
-
-    This is the true end-to-end parity check: the Python offline path must
-    produce exactly the same artifacts as the canonical shell release script.
-
-    Both sides are session-cached: each agent/script_type combination is
-    scaffolded and release-scripted only once across all tests.
-    """
-    script_tree = release_script_trees(agent, script_type)
-    if script_tree is None:
-        pytest.skip("bash required to run create-release-packages.sh")
-
-    # Reuse session-cached scaffold output
-    if script_type == "sh":
-        bundled_dir = scaffolded_sh(agent)
-    else:
-        bundled_dir = scaffolded_ps(agent)
-
-    bundled_tree = _collect_relative_files(bundled_dir)
-
-    only_bundled = set(bundled_tree) - set(script_tree)
-    only_script = set(script_tree) - set(bundled_tree)
-
-    assert not only_bundled, (
-        f"Agent '{agent}' ({script_type}): files only in bundled output (not in release ZIP):\n  "
-        + "\n  ".join(sorted(only_bundled))
-    )
-    assert not only_script, (
-        f"Agent '{agent}' ({script_type}): files only in release ZIP (not in bundled output):\n  "
-        + "\n  ".join(sorted(only_script))
-    )
-
-    for name in bundled_tree:
-        assert bundled_tree[name] == script_tree[name], (
-            f"Agent '{agent}' ({script_type}): file '{name}' content differs between "
-            f"bundled output and release script ZIP"
-        )
-
-
-# ---------------------------------------------------------------------------
-# Section 10 – pyproject.toml force-include covers all template files
-# ---------------------------------------------------------------------------
-
-def test_pyproject_force_include_covers_all_templates():
-    """Every file in templates/ (excluding commands/) must be listed in
-    pyproject.toml's [tool.hatch.build.targets.wheel.force-include] section.
-
-    This prevents new template files from being silently omitted from the
-    wheel, which would break ``specify init --offline``.
-    """
-    templates_dir = _REPO_ROOT / "templates"
-    # Collect all files directly in templates/ (not in subdirectories like commands/)
-    repo_template_files = sorted(
-        f.name for f in templates_dir.iterdir()
-        if f.is_file()
-    )
-    assert repo_template_files, "Expected at least one template file in templates/"
-
-    pyproject_path = _REPO_ROOT / "pyproject.toml"
-    with open(pyproject_path, "rb") as f:
-        pyproject = tomllib.load(f)
-    force_include = pyproject.get("tool", {}).get("hatch", {}).get("build", {}).get("targets", {}).get("wheel", {}).get("force-include", {})
-
-    missing = [
-        name for name in repo_template_files
-        if f"templates/{name}" not in force_include
-    ]
-    assert not missing, (
-        "Template files not listed in pyproject.toml force-include "
-        "(offline scaffolding will miss them):\n  "
-        + "\n  ".join(missing)
-    )
--- a/tests/test_extension_skills.py
+++ b/tests/test_extension_skills.py
@@ -1,741 +0,0 @@
-"""
-Unit tests for extension skill auto-registration.
-
-Tests cover:
- SKILL.md generation when --ai-skills was used during init
- No skills created when ai_skills not active
- SKILL.md content correctness
- Existing user-modified skills not overwritten
- Skill cleanup on extension removal
- Registry metadata includes registered_skills
-"""
-
-import json
-import pytest
-import tempfile
-import shutil
-import yaml
-from pathlib import Path
-
-from specify_cli.extensions import (
-    ExtensionManifest,
-    ExtensionManager,
-    ExtensionError,
-)
-
-
-# ===== Helpers =====
-
-def _create_init_options(project_root: Path, ai: str = "claude", ai_skills: bool = True):
-    """Write a .specify/init-options.json file."""
-    opts_dir = project_root / ".specify"
-    opts_dir.mkdir(parents=True, exist_ok=True)
-    opts_file = opts_dir / "init-options.json"
-    opts_file.write_text(json.dumps({
-        "ai": ai,
-        "ai_skills": ai_skills,
-        "script": "sh",
-    }))
-
-
-def _create_skills_dir(project_root: Path, ai: str = "claude") -> Path:
-    """Create and return the expected skills directory for the given agent."""
-    # Match the logic in _get_skills_dir() from specify_cli
-    from specify_cli import AGENT_CONFIG, DEFAULT_SKILLS_DIR
-
-    agent_config = AGENT_CONFIG.get(ai, {})
-    agent_folder = agent_config.get("folder", "")
-    if agent_folder:
-        skills_dir = project_root / agent_folder.rstrip("/") / "skills"
-    else:
-        skills_dir = project_root / DEFAULT_SKILLS_DIR
-
-    skills_dir.mkdir(parents=True, exist_ok=True)
-    return skills_dir
-
-
-def _create_extension_dir(temp_dir: Path, ext_id: str = "test-ext") -> Path:
-    """Create a complete extension directory with manifest and command files."""
-    ext_dir = temp_dir / ext_id
-    ext_dir.mkdir()
-
-    manifest_data = {
-        "schema_version": "1.0",
-        "extension": {
-            "id": ext_id,
-            "name": "Test Extension",
-            "version": "1.0.0",
-            "description": "A test extension for skill registration",
-        },
-        "requires": {
-            "speckit_version": ">=0.1.0",
-        },
-        "provides": {
-            "commands": [
-                {
-                    "name": f"speckit.{ext_id}.hello",
-                    "file": "commands/hello.md",
-                    "description": "Test hello command",
-                },
-                {
-                    "name": f"speckit.{ext_id}.world",
-                    "file": "commands/world.md",
-                    "description": "Test world command",
-                },
-            ]
-        },
-    }
-
-    with open(ext_dir / "extension.yml", "w") as f:
-        yaml.dump(manifest_data, f)
-
-    commands_dir = ext_dir / "commands"
-    commands_dir.mkdir()
-
-    (commands_dir / "hello.md").write_text(
-        "---\n"
-        "description: \"Test hello command\"\n"
-        "---\n"
-        "\n"
-        "# Hello Command\n"
-        "\n"
-        "Run this to say hello.\n"
-        "$ARGUMENTS\n"
-    )
-
-    (commands_dir / "world.md").write_text(
-        "---\n"
-        "description: \"Test world command\"\n"
-        "---\n"
-        "\n"
-        "# World Command\n"
-        "\n"
-        "Run this to greet the world.\n"
-    )
-
-    return ext_dir
-
-
-# ===== Fixtures =====
-
-@pytest.fixture
-def temp_dir():
-    """Create a temporary directory for tests."""
-    tmpdir = tempfile.mkdtemp()
-    yield Path(tmpdir)
-    shutil.rmtree(tmpdir)
-
-
-@pytest.fixture
-def project_dir(temp_dir):
-    """Create a mock spec-kit project directory."""
-    proj_dir = temp_dir / "project"
-    proj_dir.mkdir()
-
-    # Create .specify directory
-    specify_dir = proj_dir / ".specify"
-    specify_dir.mkdir()
-
-    return proj_dir
-
-
-@pytest.fixture
-def extension_dir(temp_dir):
-    """Create a complete extension directory."""
-    return _create_extension_dir(temp_dir)
-
-
-@pytest.fixture
-def skills_project(project_dir):
-    """Create a project with --ai-skills enabled and skills directory."""
-    _create_init_options(project_dir, ai="claude", ai_skills=True)
-    skills_dir = _create_skills_dir(project_dir, ai="claude")
-    return project_dir, skills_dir
-
-
-@pytest.fixture
-def no_skills_project(project_dir):
-    """Create a project without --ai-skills."""
-    _create_init_options(project_dir, ai="claude", ai_skills=False)
-    return project_dir
-
-
-# ===== ExtensionManager._get_skills_dir Tests =====
-
-class TestExtensionManagerGetSkillsDir:
-    """Test _get_skills_dir() on ExtensionManager."""
-
-    def test_returns_skills_dir_when_active(self, skills_project):
-        """Should return skills dir when ai_skills is true and dir exists."""
-        project_dir, skills_dir = skills_project
-        manager = ExtensionManager(project_dir)
-        result = manager._get_skills_dir()
-        assert result == skills_dir
-
-    def test_returns_none_when_no_ai_skills(self, no_skills_project):
-        """Should return None when ai_skills is false."""
-        manager = ExtensionManager(no_skills_project)
-        result = manager._get_skills_dir()
-        assert result is None
-
-    def test_returns_none_when_no_init_options(self, project_dir):
-        """Should return None when init-options.json is missing."""
-        manager = ExtensionManager(project_dir)
-        result = manager._get_skills_dir()
-        assert result is None
-
-    def test_returns_none_when_skills_dir_missing(self, project_dir):
-        """Should return None when skills dir doesn't exist on disk."""
-        _create_init_options(project_dir, ai="claude", ai_skills=True)
-        # Don't create the skills directory
-        manager = ExtensionManager(project_dir)
-        result = manager._get_skills_dir()
-        assert result is None
-
-    def test_returns_kimi_skills_dir_when_ai_skills_disabled(self, project_dir):
-        """Kimi should still use its native skills dir when ai_skills is false."""
-        _create_init_options(project_dir, ai="kimi", ai_skills=False)
-        skills_dir = _create_skills_dir(project_dir, ai="kimi")
-        manager = ExtensionManager(project_dir)
-        result = manager._get_skills_dir()
-        assert result == skills_dir
-
-    def test_returns_none_for_non_dict_init_options(self, project_dir):
-        """Corrupted-but-parseable init-options should not crash skill-dir lookup."""
-        opts_file = project_dir / ".specify" / "init-options.json"
-        opts_file.parent.mkdir(parents=True, exist_ok=True)
-        opts_file.write_text("[]")
-        _create_skills_dir(project_dir, ai="claude")
-        manager = ExtensionManager(project_dir)
-        result = manager._get_skills_dir()
-        assert result is None
-
-
-# ===== Extension Skill Registration Tests =====
-
-class TestExtensionSkillRegistration:
-    """Test _register_extension_skills() on ExtensionManager."""
-
-    def test_skills_created_when_ai_skills_active(self, skills_project, extension_dir):
-        """Skills should be created when ai_skills is enabled."""
-        project_dir, skills_dir = skills_project
-        manager = ExtensionManager(project_dir)
-        manifest = manager.install_from_directory(
-            extension_dir, "0.1.0", register_commands=False
-        )
-
-        # Check that skill directories were created
-        skill_dirs = sorted([d.name for d in skills_dir.iterdir() if d.is_dir()])
-        assert "speckit-test-ext-hello" in skill_dirs
-        assert "speckit-test-ext-world" in skill_dirs
-
-    def test_skill_md_content_correct(self, skills_project, extension_dir):
-        """SKILL.md should have correct agentskills.io structure."""
-        project_dir, skills_dir = skills_project
-        manager = ExtensionManager(project_dir)
-        manager.install_from_directory(
-            extension_dir, "0.1.0", register_commands=False
-        )
-
-        skill_file = skills_dir / "speckit-test-ext-hello" / "SKILL.md"
-        assert skill_file.exists()
-        content = skill_file.read_text()
-
-        # Check structure
-        assert content.startswith("---\n")
-        assert "name: speckit-test-ext-hello" in content
-        assert "description:" in content
-        assert "Test hello command" in content
-        assert "source: extension:test-ext" in content
-        assert "author: github-spec-kit" in content
-        assert "compatibility:" in content
-        assert "Run this to say hello." in content
-
-    def test_skill_md_has_parseable_yaml(self, skills_project, extension_dir):
-        """Generated SKILL.md should contain valid, parseable YAML frontmatter."""
-        project_dir, skills_dir = skills_project
-        manager = ExtensionManager(project_dir)
-        manager.install_from_directory(
-            extension_dir, "0.1.0", register_commands=False
-        )
-
-        skill_file = skills_dir / "speckit-test-ext-hello" / "SKILL.md"
-        content = skill_file.read_text()
-
-        assert content.startswith("---\n")
-        parts = content.split("---", 2)
-        assert len(parts) >= 3
-        parsed = yaml.safe_load(parts[1])
-        assert isinstance(parsed, dict)
-        assert parsed["name"] == "speckit-test-ext-hello"
-        assert "description" in parsed
-
-    def test_no_skills_when_ai_skills_disabled(self, no_skills_project, extension_dir):
-        """No skills should be created when ai_skills is false."""
-        manager = ExtensionManager(no_skills_project)
-        manifest = manager.install_from_directory(
-            extension_dir, "0.1.0", register_commands=False
-        )
-
-        # Verify registry
-        metadata = manager.registry.get(manifest.id)
-        assert metadata["registered_skills"] == []
-
-    def test_no_skills_when_init_options_missing(self, project_dir, extension_dir):
-        """No skills should be created when init-options.json is absent."""
-        manager = ExtensionManager(project_dir)
-        manifest = manager.install_from_directory(
-            extension_dir, "0.1.0", register_commands=False
-        )
-
-        metadata = manager.registry.get(manifest.id)
-        assert metadata["registered_skills"] == []
-
-    def test_existing_skill_not_overwritten(self, skills_project, extension_dir):
-        """Pre-existing SKILL.md should not be overwritten."""
-        project_dir, skills_dir = skills_project
-
-        # Pre-create a custom skill
-        custom_dir = skills_dir / "speckit-test-ext-hello"
-        custom_dir.mkdir(parents=True)
-        custom_content = "# My Custom Hello Skill\nUser-modified content\n"
-        (custom_dir / "SKILL.md").write_text(custom_content)
-
-        manager = ExtensionManager(project_dir)
-        manifest = manager.install_from_directory(
-            extension_dir, "0.1.0", register_commands=False
-        )
-
-        # Custom skill should be untouched
-        assert (custom_dir / "SKILL.md").read_text() == custom_content
-
-        # But the other skill should still be created
-        metadata = manager.registry.get(manifest.id)
-        assert "speckit-test-ext-world" in metadata["registered_skills"]
-        # The pre-existing one should NOT be in registered_skills (it was skipped)
-        assert "speckit-test-ext-hello" not in metadata["registered_skills"]
-
-    def test_registered_skills_in_registry(self, skills_project, extension_dir):
-        """Registry should contain registered_skills list."""
-        project_dir, skills_dir = skills_project
-        manager = ExtensionManager(project_dir)
-        manifest = manager.install_from_directory(
-            extension_dir, "0.1.0", register_commands=False
-        )
-
-        metadata = manager.registry.get(manifest.id)
-        assert "registered_skills" in metadata
-        assert len(metadata["registered_skills"]) == 2
-        assert "speckit-test-ext-hello" in metadata["registered_skills"]
-        assert "speckit-test-ext-world" in metadata["registered_skills"]
-
-    def test_kimi_uses_hyphenated_skill_names(self, project_dir, temp_dir):
-        """Kimi agent should use the same hyphenated skill names as hooks."""
-        _create_init_options(project_dir, ai="kimi", ai_skills=True)
-        _create_skills_dir(project_dir, ai="kimi")
-        ext_dir = _create_extension_dir(temp_dir, ext_id="test-ext")
-
-        manager = ExtensionManager(project_dir)
-        manifest = manager.install_from_directory(
-            ext_dir, "0.1.0", register_commands=False
-        )
-
-        metadata = manager.registry.get(manifest.id)
-        assert "speckit-test-ext-hello" in metadata["registered_skills"]
-        assert "speckit-test-ext-world" in metadata["registered_skills"]
-
-    def test_kimi_creates_skills_when_ai_skills_disabled(self, project_dir, temp_dir):
-        """Kimi should still auto-register extension skills in native-skills mode."""
-        _create_init_options(project_dir, ai="kimi", ai_skills=False)
-        skills_dir = _create_skills_dir(project_dir, ai="kimi")
-        ext_dir = _create_extension_dir(temp_dir, ext_id="test-ext")
-
-        manager = ExtensionManager(project_dir)
-        manifest = manager.install_from_directory(
-            ext_dir, "0.1.0", register_commands=False
-        )
-
-        metadata = manager.registry.get(manifest.id)
-        assert "speckit-test-ext-hello" in metadata["registered_skills"]
-        assert "speckit-test-ext-world" in metadata["registered_skills"]
-        assert (skills_dir / "speckit-test-ext-hello" / "SKILL.md").exists()
-
-    def test_skill_registration_resolves_script_placeholders(self, project_dir, temp_dir):
-        """Auto-registered extension skills should resolve script placeholders."""
-        _create_init_options(project_dir, ai="claude", ai_skills=True)
-        skills_dir = _create_skills_dir(project_dir, ai="claude")
-
-        ext_dir = temp_dir / "scripted-ext"
-        ext_dir.mkdir()
-        manifest_data = {
-            "schema_version": "1.0",
-            "extension": {
-                "id": "scripted-ext",
-                "name": "Scripted Extension",
-                "version": "1.0.0",
-                "description": "Test",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {
-                "commands": [
-                    {
-                        "name": "speckit.scripted-ext.plan",
-                        "file": "commands/plan.md",
-                        "description": "Scripted plan command",
-                    }
-                ]
-            },
-        }
-        with open(ext_dir / "extension.yml", "w") as f:
-            yaml.dump(manifest_data, f)
-
-        (ext_dir / "commands").mkdir()
-        (ext_dir / "commands" / "plan.md").write_text(
-            "---\n"
-            "description: Scripted plan command\n"
-            "scripts:\n"
-            "  sh: ../../scripts/bash/setup-plan.sh --json \"{ARGS}\"\n"
-            "agent_scripts:\n"
-            "  sh: ../../scripts/bash/update-agent-context.sh __AGENT__\n"
-            "---\n\n"
-            "Run {SCRIPT}\n"
-            "Then {AGENT_SCRIPT}\n"
-            "Review templates/checklist.md and memory/constitution.md for __AGENT__.\n"
-        )
-
-        manager = ExtensionManager(project_dir)
-        manager.install_from_directory(ext_dir, "0.1.0", register_commands=False)
-
-        content = (skills_dir / "speckit-scripted-ext-plan" / "SKILL.md").read_text()
-        assert "{SCRIPT}" not in content
-        assert "{AGENT_SCRIPT}" not in content
-        assert "{ARGS}" not in content
-        assert "__AGENT__" not in content
-        assert '.specify/scripts/bash/setup-plan.sh --json "$ARGUMENTS"' in content
-        assert ".specify/scripts/bash/update-agent-context.sh claude" in content
-        assert ".specify/templates/checklist.md" in content
-        assert ".specify/memory/constitution.md" in content
-
-    def test_missing_command_file_skipped(self, skills_project, temp_dir):
-        """Commands with missing source files should be skipped gracefully."""
-        project_dir, skills_dir = skills_project
-
-        ext_dir = temp_dir / "missing-cmd-ext"
-        ext_dir.mkdir()
-        manifest_data = {
-            "schema_version": "1.0",
-            "extension": {
-                "id": "missing-cmd-ext",
-                "name": "Missing Cmd Extension",
-                "version": "1.0.0",
-                "description": "Test",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {
-                "commands": [
-                    {
-                        "name": "speckit.missing-cmd-ext.exists",
-                        "file": "commands/exists.md",
-                        "description": "Exists",
-                    },
-                    {
-                        "name": "speckit.missing-cmd-ext.ghost",
-                        "file": "commands/ghost.md",
-                        "description": "Does not exist",
-                    },
-                ]
-            },
-        }
-        with open(ext_dir / "extension.yml", "w") as f:
-            yaml.dump(manifest_data, f)
-
-        (ext_dir / "commands").mkdir()
-        (ext_dir / "commands" / "exists.md").write_text(
-            "---\ndescription: Exists\n---\n\n# Exists\n\nBody.\n"
-        )
-        # Intentionally do NOT create ghost.md
-
-        manager = ExtensionManager(project_dir)
-        manifest = manager.install_from_directory(
-            ext_dir, "0.1.0", register_commands=False
-        )
-
-        metadata = manager.registry.get(manifest.id)
-        assert "speckit-missing-cmd-ext-exists" in metadata["registered_skills"]
-        assert "speckit-missing-cmd-ext-ghost" not in metadata["registered_skills"]
-
-
-# ===== Extension Skill Unregistration Tests =====
-
-class TestExtensionSkillUnregistration:
-    """Test _unregister_extension_skills() on ExtensionManager."""
-
-    def test_skills_removed_on_extension_remove(self, skills_project, extension_dir):
-        """Removing an extension should clean up its skill directories."""
-        project_dir, skills_dir = skills_project
-        manager = ExtensionManager(project_dir)
-        manifest = manager.install_from_directory(
-            extension_dir, "0.1.0", register_commands=False
-        )
-
-        # Verify skills exist
-        assert (skills_dir / "speckit-test-ext-hello" / "SKILL.md").exists()
-        assert (skills_dir / "speckit-test-ext-world" / "SKILL.md").exists()
-
-        # Remove extension
-        result = manager.remove(manifest.id, keep_config=False)
-        assert result is True
-
-        # Skills should be gone
-        assert not (skills_dir / "speckit-test-ext-hello").exists()
-        assert not (skills_dir / "speckit-test-ext-world").exists()
-
-    def test_other_skills_preserved_on_remove(self, skills_project, extension_dir):
-        """Non-extension skills should not be affected by extension removal."""
-        project_dir, skills_dir = skills_project
-
-        # Pre-create a custom skill
-        custom_dir = skills_dir / "my-custom-skill"
-        custom_dir.mkdir(parents=True)
-        (custom_dir / "SKILL.md").write_text("# My Custom Skill\n")
-
-        manager = ExtensionManager(project_dir)
-        manifest = manager.install_from_directory(
-            extension_dir, "0.1.0", register_commands=False
-        )
-
-        manager.remove(manifest.id, keep_config=False)
-
-        # Custom skill should still exist
-        assert (custom_dir / "SKILL.md").exists()
-        assert (custom_dir / "SKILL.md").read_text() == "# My Custom Skill\n"
-
-    def test_remove_handles_already_deleted_skills(self, skills_project, extension_dir):
-        """Gracefully handle case where skill dirs were already deleted."""
-        project_dir, skills_dir = skills_project
-        manager = ExtensionManager(project_dir)
-        manifest = manager.install_from_directory(
-            extension_dir, "0.1.0", register_commands=False
-        )
-
-        # Manually delete skill dirs before calling remove
-        shutil.rmtree(skills_dir / "speckit-test-ext-hello")
-        shutil.rmtree(skills_dir / "speckit-test-ext-world")
-
-        # Should not raise
-        result = manager.remove(manifest.id, keep_config=False)
-        assert result is True
-
-    def test_remove_no_skills_when_not_active(self, no_skills_project, extension_dir):
-        """Removal without active skills should not attempt skill cleanup."""
-        manager = ExtensionManager(no_skills_project)
-        manifest = manager.install_from_directory(
-            extension_dir, "0.1.0", register_commands=False
-        )
-
-        # Should not raise even though no skills exist
-        result = manager.remove(manifest.id, keep_config=False)
-        assert result is True
-
-
-# ===== Command File Without Frontmatter =====
-
-class TestExtensionSkillEdgeCases:
-    """Test edge cases in extension skill registration."""
-
-    def test_install_with_non_dict_init_options_does_not_crash(self, project_dir, extension_dir):
-        """Corrupted init-options payloads should disable skill registration, not crash install."""
-        opts_file = project_dir / ".specify" / "init-options.json"
-        opts_file.parent.mkdir(parents=True, exist_ok=True)
-        opts_file.write_text("[]")
-        _create_skills_dir(project_dir, ai="claude")
-
-        manager = ExtensionManager(project_dir)
-        manifest = manager.install_from_directory(
-            extension_dir, "0.1.0", register_commands=False
-        )
-
-        metadata = manager.registry.get(manifest.id)
-        assert metadata["registered_skills"] == []
-
-    def test_command_without_frontmatter(self, skills_project, temp_dir):
-        """Commands without YAML frontmatter should still produce valid skills."""
-        project_dir, skills_dir = skills_project
-
-        ext_dir = temp_dir / "nofm-ext"
-        ext_dir.mkdir()
-        manifest_data = {
-            "schema_version": "1.0",
-            "extension": {
-                "id": "nofm-ext",
-                "name": "No Frontmatter Extension",
-                "version": "1.0.0",
-                "description": "Test",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {
-                "commands": [
-                    {
-                        "name": "speckit.nofm-ext.plain",
-                        "file": "commands/plain.md",
-                        "description": "Plain command",
-                    }
-                ]
-            },
-        }
-        with open(ext_dir / "extension.yml", "w") as f:
-            yaml.dump(manifest_data, f)
-
-        (ext_dir / "commands").mkdir()
-        (ext_dir / "commands" / "plain.md").write_text(
-            "# Plain Command\n\nBody without frontmatter.\n"
-        )
-
-        manager = ExtensionManager(project_dir)
-        manifest = manager.install_from_directory(
-            ext_dir, "0.1.0", register_commands=False
-        )
-
-        skill_file = skills_dir / "speckit-nofm-ext-plain" / "SKILL.md"
-        assert skill_file.exists()
-        content = skill_file.read_text()
-        assert "name: speckit-nofm-ext-plain" in content
-        # Fallback description when no frontmatter description
-        assert "Extension command: speckit.nofm-ext.plain" in content
-        assert "Body without frontmatter." in content
-
-    def test_gemini_agent_skills(self, project_dir, temp_dir):
-        """Gemini agent should use .gemini/skills/ for skill directory."""
-        _create_init_options(project_dir, ai="gemini", ai_skills=True)
-        _create_skills_dir(project_dir, ai="gemini")
-        ext_dir = _create_extension_dir(temp_dir, ext_id="test-ext")
-
-        manager = ExtensionManager(project_dir)
-        manifest = manager.install_from_directory(
-            ext_dir, "0.1.0", register_commands=False
-        )
-
-        skills_dir = project_dir / ".gemini" / "skills"
-        assert (skills_dir / "speckit-test-ext-hello" / "SKILL.md").exists()
-        assert (skills_dir / "speckit-test-ext-world" / "SKILL.md").exists()
-
-    def test_multiple_extensions_independent_skills(self, skills_project, temp_dir):
-        """Installing and removing different extensions should be independent."""
-        project_dir, skills_dir = skills_project
-
-        ext_dir_a = _create_extension_dir(temp_dir, ext_id="ext-a")
-        ext_dir_b = _create_extension_dir(temp_dir, ext_id="ext-b")
-
-        manager = ExtensionManager(project_dir)
-        manifest_a = manager.install_from_directory(
-            ext_dir_a, "0.1.0", register_commands=False
-        )
-        manifest_b = manager.install_from_directory(
-            ext_dir_b, "0.1.0", register_commands=False
-        )
-
-        # Both should have skills
-        assert (skills_dir / "speckit-ext-a-hello" / "SKILL.md").exists()
-        assert (skills_dir / "speckit-ext-b-hello" / "SKILL.md").exists()
-
-        # Remove ext-a
-        manager.remove("ext-a", keep_config=False)
-
-        # ext-a skills gone, ext-b skills preserved
-        assert not (skills_dir / "speckit-ext-a-hello").exists()
-        assert (skills_dir / "speckit-ext-b-hello" / "SKILL.md").exists()
-
-    def test_malformed_frontmatter_handled(self, skills_project, temp_dir):
-        """Commands with invalid YAML frontmatter should still produce valid skills."""
-        project_dir, skills_dir = skills_project
-
-        ext_dir = temp_dir / "badfm-ext"
-        ext_dir.mkdir()
-        manifest_data = {
-            "schema_version": "1.0",
-            "extension": {
-                "id": "badfm-ext",
-                "name": "Bad Frontmatter Extension",
-                "version": "1.0.0",
-                "description": "Test",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {
-                "commands": [
-                    {
-                        "name": "speckit.badfm-ext.broken",
-                        "file": "commands/broken.md",
-                        "description": "Broken frontmatter",
-                    }
-                ]
-            },
-        }
-        with open(ext_dir / "extension.yml", "w") as f:
-            yaml.dump(manifest_data, f)
-
-        (ext_dir / "commands").mkdir()
-        # Malformed YAML: invalid key-value syntax
-        (ext_dir / "commands" / "broken.md").write_text(
-            "---\n"
-            "description: [invalid yaml\n"
-            "  unclosed: bracket\n"
-            "---\n"
-            "\n"
-            "# Broken Command\n"
-            "\n"
-            "This body should still be used.\n"
-        )
-
-        manager = ExtensionManager(project_dir)
-        # Should not raise
-        manifest = manager.install_from_directory(
-            ext_dir, "0.1.0", register_commands=False
-        )
-
-        skill_file = skills_dir / "speckit-badfm-ext-broken" / "SKILL.md"
-        assert skill_file.exists()
-        content = skill_file.read_text()
-        # Fallback description since frontmatter was invalid
-        assert "Extension command: speckit.badfm-ext.broken" in content
-        assert "This body should still be used." in content
-
-    def test_remove_cleans_up_when_init_options_deleted(self, skills_project, extension_dir):
-        """Skills should be cleaned up even if init-options.json is deleted after install."""
-        project_dir, skills_dir = skills_project
-        manager = ExtensionManager(project_dir)
-        manifest = manager.install_from_directory(
-            extension_dir, "0.1.0", register_commands=False
-        )
-
-        # Verify skills exist
-        assert (skills_dir / "speckit-test-ext-hello" / "SKILL.md").exists()
-
-        # Delete init-options.json to simulate user change
-        init_opts = project_dir / ".specify" / "init-options.json"
-        init_opts.unlink()
-
-        # Remove should still clean up via fallback scan
-        result = manager.remove(manifest.id, keep_config=False)
-        assert result is True
-        assert not (skills_dir / "speckit-test-ext-hello").exists()
-        assert not (skills_dir / "speckit-test-ext-world").exists()
-
-    def test_remove_cleans_up_when_ai_skills_toggled(self, skills_project, extension_dir):
-        """Skills should be cleaned up even if ai_skills is toggled to false after install."""
-        project_dir, skills_dir = skills_project
-        manager = ExtensionManager(project_dir)
-        manifest = manager.install_from_directory(
-            extension_dir, "0.1.0", register_commands=False
-        )
-
-        # Verify skills exist
-        assert (skills_dir / "speckit-test-ext-hello" / "SKILL.md").exists()
-
-        # Toggle ai_skills to false
-        _create_init_options(project_dir, ai="claude", ai_skills=False)
-
-        # Remove should still clean up via fallback scan
-        result = manager.remove(manifest.id, keep_config=False)
-        assert result is True
-        assert not (skills_dir / "speckit-test-ext-hello").exists()
-        assert not (skills_dir / "speckit-test-ext-world").exists()
--- a/tests/test_extensions.py
+++ b/tests/test_extensions.py
@@ -22,7 +22,6 @@ from specify_cli.extensions import (
    ExtensionRegistry,
    ExtensionManager,
    CommandRegistrar,
-    HookExecutor,
    ExtensionCatalog,
    ExtensionError,
    ValidationError,
@@ -666,10 +665,9 @@ class TestCommandRegistrar:
        assert "q" not in CommandRegistrar.AGENT_CONFIGS

    def test_codex_agent_config_present(self):
-        """Codex should be mapped to .agents/skills."""
+        """Codex should be mapped to .codex/prompts."""
        assert "codex" in CommandRegistrar.AGENT_CONFIGS
-        assert CommandRegistrar.AGENT_CONFIGS["codex"]["dir"] == ".agents/skills"
-        assert CommandRegistrar.AGENT_CONFIGS["codex"]["extension"] == "/SKILL.md"
+        assert CommandRegistrar.AGENT_CONFIGS["codex"]["dir"] == ".codex/prompts"

    def test_pi_agent_config_present(self):
        """Pi should be mapped to .pi/prompts."""
@@ -719,21 +717,6 @@ $ARGUMENTS
        assert frontmatter == {}
        assert body == content

-    def test_parse_frontmatter_non_mapping_returns_empty_dict(self):
-        """Non-mapping YAML frontmatter should not crash downstream renderers."""
-        content = """---
- item1
- item2
---
-
-# Command body
-"""
-        registrar = CommandRegistrar()
-        frontmatter, body = registrar.parse_frontmatter(content)
-
-        assert frontmatter == {}
-        assert "Command body" in body
-
    def test_render_frontmatter(self):
        """Test rendering frontmatter to YAML."""
        frontmatter = {
@@ -748,93 +731,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_adjust_script_paths_does_not_mutate_input(self):
-        """Path adjustments should not mutate caller-owned frontmatter dicts."""
-        from specify_cli.agents import CommandRegistrar as AgentCommandRegistrar
-        registrar = AgentCommandRegistrar()
-        original = {
-            "scripts": {
-                "sh": "../../scripts/bash/setup-plan.sh {ARGS}",
-                "ps": "../../scripts/powershell/setup-plan.ps1 {ARGS}",
-            }
-        }
-        before = json.loads(json.dumps(original))
-
-        adjusted = registrar._adjust_script_paths(original)
-
-        assert original == before
-        assert adjusted["scripts"]["sh"] == ".specify/scripts/bash/setup-plan.sh {ARGS}"
-        assert adjusted["scripts"]["ps"] == ".specify/scripts/powershell/setup-plan.ps1 {ARGS}"
-
-    def test_adjust_script_paths_preserves_extension_local_paths(self):
-        """Extension-local script paths should not be rewritten into .specify/.specify."""
-        from specify_cli.agents import CommandRegistrar as AgentCommandRegistrar
-        registrar = AgentCommandRegistrar()
-        original = {
-            "scripts": {
-                "sh": ".specify/extensions/test-ext/scripts/setup.sh {ARGS}",
-                "ps": "scripts/powershell/setup-plan.ps1 {ARGS}",
-            }
-        }
-
-        adjusted = registrar._adjust_script_paths(original)
-
-        assert adjusted["scripts"]["sh"] == ".specify/extensions/test-ext/scripts/setup.sh {ARGS}"
-        assert adjusted["scripts"]["ps"] == ".specify/scripts/powershell/setup-plan.ps1 {ARGS}"
-
-    def test_rewrite_project_relative_paths_preserves_extension_local_body_paths(self):
-        """Body rewrites should preserve extension-local assets while fixing top-level refs."""
-        from specify_cli.agents import CommandRegistrar as AgentCommandRegistrar
-
-        body = (
-            "Read `.specify/extensions/test-ext/templates/spec.md`\n"
-            "Run scripts/bash/setup-plan.sh\n"
-        )
-
-        rewritten = AgentCommandRegistrar._rewrite_project_relative_paths(body)
-
-        assert ".specify/extensions/test-ext/templates/spec.md" in rewritten
-        assert ".specify/scripts/bash/setup-plan.sh" in rewritten
-
-    def test_render_toml_command_handles_embedded_triple_double_quotes(self):
-        """TOML renderer should stay valid when body includes triple double-quotes."""
-        from specify_cli.agents import CommandRegistrar as AgentCommandRegistrar
-        registrar = AgentCommandRegistrar()
-        output = registrar.render_toml_command(
-            {"description": "x"},
-            'line1\n"""danger"""\nline2',
-            "extension:test-ext",
-        )
-
-        assert "prompt = '''" in output
-        assert '"""danger"""' in output
-
-    def test_render_toml_command_escapes_when_both_triple_quote_styles_exist(self):
-        """If body has both triple quote styles, fall back to escaped basic string."""
-        from specify_cli.agents import CommandRegistrar as AgentCommandRegistrar
-        registrar = AgentCommandRegistrar()
-        output = registrar.render_toml_command(
-            {"description": "x"},
-            'a """ b\nc \'\'\' d',
-            "extension:test-ext",
-        )
-
-        assert 'prompt = "' in output
-        assert "\\n" in output
-        assert "\\\"\\\"\\\"" in output
-
    def test_register_commands_for_claude(self, extension_dir, project_dir):
        """Test registering commands for Claude agent."""
        # Create .claude directory
@@ -912,355 +808,6 @@ $ARGUMENTS
        assert (claude_dir / "speckit.alias.cmd.md").exists()
        assert (claude_dir / "speckit.shortcut.md").exists()

-    def test_unregister_commands_for_codex_skills_uses_mapped_names(self, project_dir):
-        """Codex skill cleanup should use the same mapped names as registration."""
-        skills_dir = project_dir / ".agents" / "skills"
-        (skills_dir / "speckit-specify").mkdir(parents=True)
-        (skills_dir / "speckit-specify" / "SKILL.md").write_text("body")
-        (skills_dir / "speckit-shortcut").mkdir(parents=True)
-        (skills_dir / "speckit-shortcut" / "SKILL.md").write_text("body")
-
-        registrar = CommandRegistrar()
-        registrar.unregister_commands(
-            {"codex": ["speckit.specify", "speckit.shortcut"]},
-            project_dir,
-        )
-
-        assert not (skills_dir / "speckit-specify" / "SKILL.md").exists()
-        assert not (skills_dir / "speckit-shortcut" / "SKILL.md").exists()
-
-    def test_register_commands_for_all_agents_distinguishes_codex_from_amp(self, extension_dir, project_dir):
-        """A Codex project under .agents/skills should not implicitly activate Amp."""
-        skills_dir = project_dir / ".agents" / "skills"
-        skills_dir.mkdir(parents=True)
-
-        manifest = ExtensionManifest(extension_dir / "extension.yml")
-        registrar = CommandRegistrar()
-        registered = registrar.register_commands_for_all_agents(manifest, extension_dir, project_dir)
-
-        assert "codex" in registered
-        assert "amp" not in registered
-        assert not (project_dir / ".agents" / "commands").exists()
-
-    def test_codex_skill_registration_writes_skill_frontmatter(self, extension_dir, project_dir):
-        """Codex SKILL.md output should use skills-oriented frontmatter."""
-        skills_dir = project_dir / ".agents" / "skills"
-        skills_dir.mkdir(parents=True)
-
-        manifest = ExtensionManifest(extension_dir / "extension.yml")
-        registrar = CommandRegistrar()
-        registrar.register_commands_for_agent("codex", manifest, extension_dir, project_dir)
-
-        skill_file = skills_dir / "speckit-test-hello" / "SKILL.md"
-        assert skill_file.exists()
-
-        content = skill_file.read_text()
-        assert "name: speckit-test-hello" in content
-        assert "description: Test hello command" in content
-        assert "compatibility:" in content
-        assert "metadata:" in content
-        assert "source: test-ext:commands/hello.md" in content
-        assert "<!-- Extension:" not in content
-
-    def test_codex_skill_registration_resolves_script_placeholders(self, project_dir, temp_dir):
-        """Codex SKILL.md overrides should resolve script placeholders."""
-        import yaml
-
-        ext_dir = temp_dir / "ext-scripted"
-        ext_dir.mkdir()
-        (ext_dir / "commands").mkdir()
-
-        manifest_data = {
-            "schema_version": "1.0",
-            "extension": {
-                "id": "ext-scripted",
-                "name": "Scripted Extension",
-                "version": "1.0.0",
-                "description": "Test",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {
-                "commands": [
-                    {
-                        "name": "speckit.test.plan",
-                        "file": "commands/plan.md",
-                        "description": "Scripted command",
-                    }
-                ]
-            },
-        }
-        with open(ext_dir / "extension.yml", "w") as f:
-            yaml.dump(manifest_data, f)
-
-        (ext_dir / "commands" / "plan.md").write_text(
-            """---
-description: "Scripted command"
-scripts:
-  sh: ../../scripts/bash/setup-plan.sh --json "{ARGS}"
-  ps: ../../scripts/powershell/setup-plan.ps1 -Json
-agent_scripts:
-  sh: ../../scripts/bash/update-agent-context.sh __AGENT__
-  ps: ../../scripts/powershell/update-agent-context.ps1 -AgentType __AGENT__
---
-
-Run {SCRIPT}
-Then {AGENT_SCRIPT}
-Agent __AGENT__
-"""
-        )
-
-        init_options = project_dir / ".specify" / "init-options.json"
-        init_options.parent.mkdir(parents=True, exist_ok=True)
-        init_options.write_text('{"ai":"codex","ai_skills":true,"script":"sh"}')
-
-        skills_dir = project_dir / ".agents" / "skills"
-        skills_dir.mkdir(parents=True)
-
-        manifest = ExtensionManifest(ext_dir / "extension.yml")
-        registrar = CommandRegistrar()
-        registrar.register_commands_for_agent("codex", manifest, ext_dir, project_dir)
-
-        skill_file = skills_dir / "speckit-test-plan" / "SKILL.md"
-        assert skill_file.exists()
-
-        content = skill_file.read_text()
-        assert "{SCRIPT}" not in content
-        assert "{AGENT_SCRIPT}" not in content
-        assert "__AGENT__" not in content
-        assert "{ARGS}" not in content
-        assert '.specify/scripts/bash/setup-plan.sh --json "$ARGUMENTS"' in content
-        assert ".specify/scripts/bash/update-agent-context.sh codex" in content
-
-    def test_codex_skill_alias_frontmatter_matches_alias_name(self, project_dir, temp_dir):
-        """Codex alias skills should render their own matching `name:` frontmatter."""
-        import yaml
-
-        ext_dir = temp_dir / "ext-alias-skill"
-        ext_dir.mkdir()
-        (ext_dir / "commands").mkdir()
-
-        manifest_data = {
-            "schema_version": "1.0",
-            "extension": {
-                "id": "ext-alias-skill",
-                "name": "Alias Skill Extension",
-                "version": "1.0.0",
-                "description": "Test",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {
-                "commands": [
-                    {
-                        "name": "speckit.alias.cmd",
-                        "file": "commands/cmd.md",
-                        "aliases": ["speckit.shortcut"],
-                    }
-                ]
-            },
-        }
-        with open(ext_dir / "extension.yml", "w") as f:
-            yaml.dump(manifest_data, f)
-
-        (ext_dir / "commands" / "cmd.md").write_text("---\ndescription: Alias skill\n---\n\nBody\n")
-
-        skills_dir = project_dir / ".agents" / "skills"
-        skills_dir.mkdir(parents=True)
-
-        manifest = ExtensionManifest(ext_dir / "extension.yml")
-        registrar = CommandRegistrar()
-        registrar.register_commands_for_agent("codex", manifest, ext_dir, project_dir)
-
-        primary = skills_dir / "speckit-alias-cmd" / "SKILL.md"
-        alias = skills_dir / "speckit-shortcut" / "SKILL.md"
-
-        assert primary.exists()
-        assert alias.exists()
-        assert "name: speckit-alias-cmd" in primary.read_text()
-        assert "name: speckit-shortcut" in alias.read_text()
-
-    def test_codex_skill_registration_uses_fallback_script_variant_without_init_options(
-        self, project_dir, temp_dir
-    ):
-        """Codex placeholder substitution should still work without init-options.json."""
-        import yaml
-
-        ext_dir = temp_dir / "ext-script-fallback"
-        ext_dir.mkdir()
-        (ext_dir / "commands").mkdir()
-
-        manifest_data = {
-            "schema_version": "1.0",
-            "extension": {
-                "id": "ext-script-fallback",
-                "name": "Script fallback",
-                "version": "1.0.0",
-                "description": "Test",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {
-                "commands": [
-                    {
-                        "name": "speckit.fallback.plan",
-                        "file": "commands/plan.md",
-                    }
-                ]
-            },
-        }
-        with open(ext_dir / "extension.yml", "w") as f:
-            yaml.dump(manifest_data, f)
-
-        (ext_dir / "commands" / "plan.md").write_text(
-            """---
-description: "Fallback scripted command"
-scripts:
-  sh: ../../scripts/bash/setup-plan.sh --json "{ARGS}"
-  ps: ../../scripts/powershell/setup-plan.ps1 -Json
-agent_scripts:
-  sh: ../../scripts/bash/update-agent-context.sh __AGENT__
---
-
-Run {SCRIPT}
-Then {AGENT_SCRIPT}
-"""
-        )
-
-        # Intentionally do NOT create .specify/init-options.json
-        skills_dir = project_dir / ".agents" / "skills"
-        skills_dir.mkdir(parents=True)
-
-        manifest = ExtensionManifest(ext_dir / "extension.yml")
-        registrar = CommandRegistrar()
-        registrar.register_commands_for_agent("codex", manifest, ext_dir, project_dir)
-
-        skill_file = skills_dir / "speckit-fallback-plan" / "SKILL.md"
-        assert skill_file.exists()
-
-        content = skill_file.read_text()
-        assert "{SCRIPT}" not in content
-        assert "{AGENT_SCRIPT}" not in content
-        assert '.specify/scripts/bash/setup-plan.sh --json "$ARGUMENTS"' in content
-        assert ".specify/scripts/bash/update-agent-context.sh codex" in content
-
-    def test_codex_skill_registration_handles_non_dict_init_options(
-        self, project_dir, temp_dir
-    ):
-        """Non-dict init-options payloads should not crash skill placeholder resolution."""
-        import yaml
-
-        ext_dir = temp_dir / "ext-script-list-init"
-        ext_dir.mkdir()
-        (ext_dir / "commands").mkdir()
-
-        manifest_data = {
-            "schema_version": "1.0",
-            "extension": {
-                "id": "ext-script-list-init",
-                "name": "List init options",
-                "version": "1.0.0",
-                "description": "Test",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {
-                "commands": [
-                    {
-                        "name": "speckit.list.plan",
-                        "file": "commands/plan.md",
-                    }
-                ]
-            },
-        }
-        with open(ext_dir / "extension.yml", "w") as f:
-            yaml.dump(manifest_data, f)
-
-        (ext_dir / "commands" / "plan.md").write_text(
-            """---
-description: "List init scripted command"
-scripts:
-  sh: ../../scripts/bash/setup-plan.sh --json "{ARGS}"
---
-
-Run {SCRIPT}
-"""
-        )
-
-        init_options = project_dir / ".specify" / "init-options.json"
-        init_options.parent.mkdir(parents=True, exist_ok=True)
-        init_options.write_text("[]")
-
-        skills_dir = project_dir / ".agents" / "skills"
-        skills_dir.mkdir(parents=True)
-
-        manifest = ExtensionManifest(ext_dir / "extension.yml")
-        registrar = CommandRegistrar()
-        registrar.register_commands_for_agent("codex", manifest, ext_dir, project_dir)
-
-        content = (skills_dir / "speckit-list-plan" / "SKILL.md").read_text()
-        assert '.specify/scripts/bash/setup-plan.sh --json "$ARGUMENTS"' in content
-
-    def test_codex_skill_registration_fallback_prefers_powershell_on_windows(
-        self, project_dir, temp_dir, monkeypatch
-    ):
-        """Without init metadata, Windows fallback should prefer ps scripts over sh."""
-        import yaml
-
-        monkeypatch.setattr("specify_cli.agents.platform.system", lambda: "Windows")
-
-        ext_dir = temp_dir / "ext-script-windows-fallback"
-        ext_dir.mkdir()
-        (ext_dir / "commands").mkdir()
-
-        manifest_data = {
-            "schema_version": "1.0",
-            "extension": {
-                "id": "ext-script-windows-fallback",
-                "name": "Script fallback windows",
-                "version": "1.0.0",
-                "description": "Test",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {
-                "commands": [
-                    {
-                        "name": "speckit.windows.plan",
-                        "file": "commands/plan.md",
-                    }
-                ]
-            },
-        }
-        with open(ext_dir / "extension.yml", "w") as f:
-            yaml.dump(manifest_data, f)
-
-        (ext_dir / "commands" / "plan.md").write_text(
-            """---
-description: "Windows fallback scripted command"
-scripts:
-  sh: ../../scripts/bash/setup-plan.sh --json "{ARGS}"
-  ps: ../../scripts/powershell/setup-plan.ps1 -Json
-agent_scripts:
-  sh: ../../scripts/bash/update-agent-context.sh __AGENT__
-  ps: ../../scripts/powershell/update-agent-context.ps1 -AgentType __AGENT__
---
-
-Run {SCRIPT}
-Then {AGENT_SCRIPT}
-"""
-        )
-
-        skills_dir = project_dir / ".agents" / "skills"
-        skills_dir.mkdir(parents=True)
-
-        manifest = ExtensionManifest(ext_dir / "extension.yml")
-        registrar = CommandRegistrar()
-        registrar.register_commands_for_agent("codex", manifest, ext_dir, project_dir)
-
-        skill_file = skills_dir / "speckit-windows-plan" / "SKILL.md"
-        assert skill_file.exists()
-
-        content = skill_file.read_text()
-        assert ".specify/scripts/powershell/setup-plan.ps1 -Json" in content
-        assert ".specify/scripts/powershell/update-agent-context.ps1 -AgentType codex" in content
-        assert ".specify/scripts/bash/setup-plan.sh" not in content
-
    def test_register_commands_for_copilot(self, extension_dir, project_dir):
        """Test registering commands for Copilot agent with .agent.md extension."""
        # Create .github/agents directory (Copilot project)
@@ -3363,128 +2910,3 @@ class TestExtensionPriorityBackwardsCompatibility:
        assert result[0][0] == "ext-with-priority"
        assert result[1][0] == "legacy-ext"
        assert result[2][0] == "ext-low-priority"
-
-
-class TestHookInvocationRendering:
-    """Test hook invocation formatting for different agent modes."""
-
-    def test_kimi_hooks_render_skill_invocation(self, project_dir):
-        """Kimi projects should render /skill:speckit-* invocations."""
-        init_options = project_dir / ".specify" / "init-options.json"
-        init_options.parent.mkdir(parents=True, exist_ok=True)
-        init_options.write_text(json.dumps({"ai": "kimi", "ai_skills": False}))
-
-        hook_executor = HookExecutor(project_dir)
-        message = hook_executor.format_hook_message(
-            "before_plan",
-            [
-                {
-                    "extension": "test-ext",
-                    "command": "speckit.plan",
-                    "optional": False,
-                }
-            ],
-        )
-
-        assert "Executing: `/skill:speckit-plan`" in message
-        assert "EXECUTE_COMMAND: speckit.plan" in message
-        assert "EXECUTE_COMMAND_INVOCATION: /skill:speckit-plan" in message
-
-    def test_codex_hooks_render_dollar_skill_invocation(self, project_dir):
-        """Codex projects with --ai-skills should render $speckit-* invocations."""
-        init_options = project_dir / ".specify" / "init-options.json"
-        init_options.parent.mkdir(parents=True, exist_ok=True)
-        init_options.write_text(json.dumps({"ai": "codex", "ai_skills": True}))
-
-        hook_executor = HookExecutor(project_dir)
-        execution = hook_executor.execute_hook(
-            {
-                "extension": "test-ext",
-                "command": "speckit.tasks",
-                "optional": False,
-            }
-        )
-
-        assert execution["command"] == "speckit.tasks"
-        assert execution["invocation"] == "$speckit-tasks"
-
-    def test_non_skill_command_keeps_slash_invocation(self, project_dir):
-        """Custom hook commands should keep slash invocation style."""
-        init_options = project_dir / ".specify" / "init-options.json"
-        init_options.parent.mkdir(parents=True, exist_ok=True)
-        init_options.write_text(json.dumps({"ai": "kimi", "ai_skills": False}))
-
-        hook_executor = HookExecutor(project_dir)
-        message = hook_executor.format_hook_message(
-            "before_tasks",
-            [
-                {
-                    "extension": "test-ext",
-                    "command": "pre_tasks_test",
-                    "optional": False,
-                }
-            ],
-        )
-
-        assert "Executing: `/pre_tasks_test`" in message
-        assert "EXECUTE_COMMAND: pre_tasks_test" in message
-        assert "EXECUTE_COMMAND_INVOCATION: /pre_tasks_test" in message
-
-    def test_extension_command_uses_hyphenated_skill_invocation(self, project_dir):
-        """Multi-segment extension command ids should map to hyphenated skills."""
-        init_options = project_dir / ".specify" / "init-options.json"
-        init_options.parent.mkdir(parents=True, exist_ok=True)
-        init_options.write_text(json.dumps({"ai": "kimi", "ai_skills": False}))
-
-        hook_executor = HookExecutor(project_dir)
-        message = hook_executor.format_hook_message(
-            "after_tasks",
-            [
-                {
-                    "extension": "test-ext",
-                    "command": "speckit.test.hello",
-                    "optional": False,
-                }
-            ],
-        )
-
-        assert "Executing: `/skill:speckit-test-hello`" in message
-        assert "EXECUTE_COMMAND: speckit.test.hello" in message
-        assert "EXECUTE_COMMAND_INVOCATION: /skill:speckit-test-hello" in message
-
-    def test_hook_executor_caches_init_options_lookup(self, project_dir, monkeypatch):
-        """Init options should be loaded once per executor instance."""
-        calls = {"count": 0}
-
-        def fake_load_init_options(_project_root):
-            calls["count"] += 1
-            return {"ai": "kimi", "ai_skills": False}
-
-        monkeypatch.setattr("specify_cli.load_init_options", fake_load_init_options)
-
-        hook_executor = HookExecutor(project_dir)
-        assert hook_executor._render_hook_invocation("speckit.plan") == "/skill:speckit-plan"
-        assert hook_executor._render_hook_invocation("speckit.tasks") == "/skill:speckit-tasks"
-        assert calls["count"] == 1
-
-    def test_hook_message_falls_back_when_invocation_is_empty(self, project_dir):
-        """Hook messages should still render actionable command placeholders."""
-        init_options = project_dir / ".specify" / "init-options.json"
-        init_options.parent.mkdir(parents=True, exist_ok=True)
-        init_options.write_text(json.dumps({"ai": "kimi", "ai_skills": False}))
-
-        hook_executor = HookExecutor(project_dir)
-        message = hook_executor.format_hook_message(
-            "after_tasks",
-            [
-                {
-                    "extension": "test-ext",
-                    "command": None,
-                    "optional": False,
-                }
-            ],
-        )
-
-        assert "Executing: `/<missing command>`" in message
-        assert "EXECUTE_COMMAND: <missing command>" in message
-        assert "EXECUTE_COMMAND_INVOCATION: /<missing command>" in message
--- a/tests/test_presets.py
+++ b/tests/test_presets.py
@@ -1170,12 +1170,8 @@ class TestPresetCatalog:
        assert not catalog.cache_file.exists()
        assert not catalog.cache_metadata_file.exists()

-    def test_search_with_cached_data(self, project_dir, monkeypatch):
+    def test_search_with_cached_data(self, project_dir):
        """Test search with cached catalog data."""
-        from unittest.mock import patch
-
-        # Only use the default catalog to prevent fetching the community catalog from the network
-        monkeypatch.setenv("SPECKIT_PRESET_CATALOG_URL", PresetCatalog.DEFAULT_CATALOG_URL)
        catalog = PresetCatalog(project_dir)
        catalog.cache_dir.mkdir(parents=True, exist_ok=True)

@@ -1204,26 +1200,23 @@ class TestPresetCatalog:
            "cached_at": datetime.now(timezone.utc).isoformat(),
        }))

-        # Isolate from community catalog so results are deterministic
-        default_only = [PresetCatalogEntry(url=catalog.DEFAULT_CATALOG_URL, name="default", priority=1, install_allowed=True)]
-        with patch.object(catalog, "get_active_catalogs", return_value=default_only):
-            # Search by query
-            results = catalog.search(query="agile")
-            assert len(results) == 1
-            assert results[0]["id"] == "safe-agile"
+        # Search by query
+        results = catalog.search(query="agile")
+        assert len(results) == 1
+        assert results[0]["id"] == "safe-agile"

-            # Search by tag
-            results = catalog.search(tag="hipaa")
-            assert len(results) == 1
-            assert results[0]["id"] == "healthcare"
+        # Search by tag
+        results = catalog.search(tag="hipaa")
+        assert len(results) == 1
+        assert results[0]["id"] == "healthcare"

-            # Search by author
-            results = catalog.search(author="agile-community")
-            assert len(results) == 1
+        # Search by author
+        results = catalog.search(author="agile-community")
+        assert len(results) == 1

-            # Search all
-            results = catalog.search()
-            assert len(results) == 2
+        # Search all
+        results = catalog.search()
+        assert len(results) == 2

    def test_get_pack_info(self, project_dir):
        """Test getting info for a specific pack."""
@@ -1942,10 +1935,10 @@ class TestInitOptions:
 class TestPresetSkills:
    """Tests for preset skill registration and unregistration."""

-    def _write_init_options(self, project_dir, ai="claude", ai_skills=True, script="sh"):
+    def _write_init_options(self, project_dir, ai="claude", ai_skills=True):
        from specify_cli import save_init_options

-        save_init_options(project_dir, {"ai": ai, "ai_skills": ai_skills, "script": script})
+        save_init_options(project_dir, {"ai": ai, "ai_skills": ai_skills})

    def _create_skill(self, skills_dir, skill_name, body="original body"):
        skill_dir = skills_dir / skill_name
@@ -1995,26 +1988,6 @@ class TestPresetSkills:
        content = skill_file.read_text()
        assert "untouched" in content, "Skill should not be modified when ai_skills=False"

-    def test_get_skills_dir_returns_none_for_non_string_ai(self, project_dir):
-        """Corrupted init-options ai values should not crash preset skill resolution."""
-        init_options = project_dir / ".specify" / "init-options.json"
-        init_options.parent.mkdir(parents=True, exist_ok=True)
-        init_options.write_text('{"ai":["codex"],"ai_skills":true,"script":"sh"}')
-
-        manager = PresetManager(project_dir)
-
-        assert manager._get_skills_dir() is None
-
-    def test_get_skills_dir_returns_none_for_non_dict_init_options(self, project_dir):
-        """Corrupted non-dict init-options payloads should fail closed."""
-        init_options = project_dir / ".specify" / "init-options.json"
-        init_options.parent.mkdir(parents=True, exist_ok=True)
-        init_options.write_text("[]")
-
-        manager = PresetManager(project_dir)
-
-        assert manager._get_skills_dir() is None
-
    def test_skill_not_updated_without_init_options(self, project_dir, temp_dir):
        """When no init-options.json exists, preset install should not touch skills."""
        skills_dir = project_dir / ".claude" / "skills"
@@ -2060,52 +2033,6 @@ class TestPresetSkills:
        assert "preset:self-test" not in content, "Preset content should be gone"
        assert "templates/commands/specify.md" in content, "Should reference core template"

-    def test_skill_restored_on_remove_resolves_script_placeholders(self, project_dir):
-        """Core restore should resolve {SCRIPT}/{ARGS} placeholders like other skill paths."""
-        self._write_init_options(project_dir, ai="claude", ai_skills=True, script="sh")
-        skills_dir = project_dir / ".claude" / "skills"
-        self._create_skill(skills_dir, "speckit-specify", body="old")
-        (project_dir / ".claude" / "commands").mkdir(parents=True, exist_ok=True)
-
-        core_cmds = project_dir / ".specify" / "templates" / "commands"
-        core_cmds.mkdir(parents=True, exist_ok=True)
-        (core_cmds / "specify.md").write_text(
-            "---\n"
-            "description: Core specify command\n"
-            "scripts:\n"
-            "  sh: .specify/scripts/bash/create-new-feature.sh --json \"{ARGS}\"\n"
-            "---\n\n"
-            "Run:\n"
-            "{SCRIPT}\n"
-        )
-
-        manager = PresetManager(project_dir)
-        SELF_TEST_DIR = Path(__file__).parent.parent / "presets" / "self-test"
-        manager.install_from_directory(SELF_TEST_DIR, "0.1.5")
-        manager.remove("self-test")
-
-        content = (skills_dir / "speckit-specify" / "SKILL.md").read_text()
-        assert "{SCRIPT}" not in content
-        assert "{ARGS}" not in content
-        assert ".specify/scripts/bash/create-new-feature.sh --json \"$ARGUMENTS\"" in content
-
-    def test_skill_not_overridden_when_skill_path_is_file(self, project_dir):
-        """Preset install should skip non-directory skill targets."""
-        self._write_init_options(project_dir, ai="claude")
-        skills_dir = project_dir / ".claude" / "skills"
-        skills_dir.mkdir(parents=True, exist_ok=True)
-        (skills_dir / "speckit-specify").write_text("not-a-directory")
-
-        (project_dir / ".claude" / "commands").mkdir(parents=True, exist_ok=True)
-
-        manager = PresetManager(project_dir)
-        SELF_TEST_DIR = Path(__file__).parent.parent / "presets" / "self-test"
-        manager.install_from_directory(SELF_TEST_DIR, "0.1.5")
-
-        assert (skills_dir / "speckit-specify").is_file()
-        metadata = manager.registry.get("self-test")
-        assert "speckit-specify" not in metadata.get("registered_skills", [])
-
    def test_no_skills_registered_when_no_skill_dir_exists(self, project_dir, temp_dir):
        """Skills should not be created when no existing skill dir is found."""
        self._write_init_options(project_dir, ai="claude")
@@ -2120,304 +2047,6 @@ class TestPresetSkills:
        metadata = manager.registry.get("self-test")
        assert metadata.get("registered_skills", []) == []

-    def test_extension_skill_override_matches_hyphenated_multisegment_name(self, project_dir, temp_dir):
-        """Preset overrides for speckit.<ext>.<cmd> should target speckit-<ext>-<cmd> skills."""
-        self._write_init_options(project_dir, ai="codex")
-        skills_dir = project_dir / ".agents" / "skills"
-        self._create_skill(skills_dir, "speckit-fakeext-cmd", body="untouched")
-        (project_dir / ".specify" / "extensions" / "fakeext").mkdir(parents=True, exist_ok=True)
-
-        preset_dir = temp_dir / "ext-skill-override"
-        preset_dir.mkdir()
-        (preset_dir / "commands").mkdir()
-        (preset_dir / "commands" / "speckit.fakeext.cmd.md").write_text(
-            "---\ndescription: Override fakeext cmd\n---\n\npreset:ext-skill-override\n"
-        )
-        manifest_data = {
-            "schema_version": "1.0",
-            "preset": {
-                "id": "ext-skill-override",
-                "name": "Ext Skill Override",
-                "version": "1.0.0",
-                "description": "Test",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {
-                "templates": [
-                    {
-                        "type": "command",
-                        "name": "speckit.fakeext.cmd",
-                        "file": "commands/speckit.fakeext.cmd.md",
-                    }
-                ]
-            },
-        }
-        with open(preset_dir / "preset.yml", "w") as f:
-            yaml.dump(manifest_data, f)
-
-        manager = PresetManager(project_dir)
-        manager.install_from_directory(preset_dir, "0.1.5")
-
-        skill_file = skills_dir / "speckit-fakeext-cmd" / "SKILL.md"
-        assert skill_file.exists()
-        content = skill_file.read_text()
-        assert "preset:ext-skill-override" in content
-        assert "name: speckit-fakeext-cmd" in content
-        assert "# Speckit Fakeext Cmd Skill" in content
-
-        metadata = manager.registry.get("ext-skill-override")
-        assert "speckit-fakeext-cmd" in metadata.get("registered_skills", [])
-
-    def test_extension_skill_restored_on_preset_remove(self, project_dir, temp_dir):
-        """Preset removal should restore an extension-backed skill instead of deleting it."""
-        self._write_init_options(project_dir, ai="codex")
-        skills_dir = project_dir / ".agents" / "skills"
-        self._create_skill(skills_dir, "speckit-fakeext-cmd", body="original extension skill")
-
-        extension_dir = project_dir / ".specify" / "extensions" / "fakeext"
-        (extension_dir / "commands").mkdir(parents=True, exist_ok=True)
-        (extension_dir / "commands" / "cmd.md").write_text(
-            "---\n"
-            "description: Extension fakeext cmd\n"
-            "scripts:\n"
-            "  sh: ../../scripts/bash/setup-plan.sh --json \"{ARGS}\"\n"
-            "---\n\n"
-            "extension:fakeext\n"
-            "Run {SCRIPT}\n"
-        )
-        extension_manifest = {
-            "schema_version": "1.0",
-            "extension": {
-                "id": "fakeext",
-                "name": "Fake Extension",
-                "version": "1.0.0",
-                "description": "Test",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {
-                "commands": [
-                    {
-                        "name": "speckit.fakeext.cmd",
-                        "file": "commands/cmd.md",
-                        "description": "Fake extension command",
-                    }
-                ]
-            },
-        }
-        with open(extension_dir / "extension.yml", "w") as f:
-            yaml.dump(extension_manifest, f)
-
-        preset_dir = temp_dir / "ext-skill-restore"
-        preset_dir.mkdir()
-        (preset_dir / "commands").mkdir()
-        (preset_dir / "commands" / "speckit.fakeext.cmd.md").write_text(
-            "---\ndescription: Override fakeext cmd\n---\n\npreset:ext-skill-restore\n"
-        )
-        preset_manifest = {
-            "schema_version": "1.0",
-            "preset": {
-                "id": "ext-skill-restore",
-                "name": "Ext Skill Restore",
-                "version": "1.0.0",
-                "description": "Test",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {
-                "templates": [
-                    {
-                        "type": "command",
-                        "name": "speckit.fakeext.cmd",
-                        "file": "commands/speckit.fakeext.cmd.md",
-                    }
-                ]
-            },
-        }
-        with open(preset_dir / "preset.yml", "w") as f:
-            yaml.dump(preset_manifest, f)
-
-        manager = PresetManager(project_dir)
-        manager.install_from_directory(preset_dir, "0.1.5")
-
-        skill_file = skills_dir / "speckit-fakeext-cmd" / "SKILL.md"
-        assert "preset:ext-skill-restore" in skill_file.read_text()
-
-        manager.remove("ext-skill-restore")
-
-        assert skill_file.exists()
-        content = skill_file.read_text()
-        assert "preset:ext-skill-restore" not in content
-        assert "source: extension:fakeext" in content
-        assert "extension:fakeext" in content
-        assert '.specify/scripts/bash/setup-plan.sh --json "$ARGUMENTS"' in content
-        assert "# Fakeext Cmd Skill" in content
-
-    def test_preset_remove_skips_skill_dir_without_skill_file(self, project_dir, temp_dir):
-        """Preset removal should not delete arbitrary directories missing SKILL.md."""
-        self._write_init_options(project_dir, ai="codex")
-        skills_dir = project_dir / ".agents" / "skills"
-        stray_skill_dir = skills_dir / "speckit-fakeext-cmd"
-        stray_skill_dir.mkdir(parents=True, exist_ok=True)
-        note_file = stray_skill_dir / "notes.txt"
-        note_file.write_text("user content", encoding="utf-8")
-
-        preset_dir = temp_dir / "ext-skill-missing-file"
-        preset_dir.mkdir()
-        (preset_dir / "commands").mkdir()
-        (preset_dir / "commands" / "speckit.fakeext.cmd.md").write_text(
-            "---\ndescription: Override fakeext cmd\n---\n\npreset:ext-skill-missing-file\n"
-        )
-        preset_manifest = {
-            "schema_version": "1.0",
-            "preset": {
-                "id": "ext-skill-missing-file",
-                "name": "Ext Skill Missing File",
-                "version": "1.0.0",
-                "description": "Test",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {
-                "templates": [
-                    {
-                        "type": "command",
-                        "name": "speckit.fakeext.cmd",
-                        "file": "commands/speckit.fakeext.cmd.md",
-                    }
-                ]
-            },
-        }
-        with open(preset_dir / "preset.yml", "w") as f:
-            yaml.dump(preset_manifest, f)
-
-        manager = PresetManager(project_dir)
-        installed_preset_dir = manager.presets_dir / "ext-skill-missing-file"
-        shutil.copytree(preset_dir, installed_preset_dir)
-        manager.registry.add(
-            "ext-skill-missing-file",
-            {
-                "version": "1.0.0",
-                "source": str(preset_dir),
-                "provides_templates": ["speckit.fakeext.cmd"],
-                "registered_skills": ["speckit-fakeext-cmd"],
-                "priority": 10,
-            },
-        )
-
-        manager.remove("ext-skill-missing-file")
-
-        assert stray_skill_dir.is_dir()
-        assert note_file.read_text(encoding="utf-8") == "user content"
-
-    def test_kimi_legacy_dotted_skill_override_still_applies(self, project_dir, temp_dir):
-        """Preset overrides should still target legacy dotted Kimi skill directories."""
-        self._write_init_options(project_dir, ai="kimi")
-        skills_dir = project_dir / ".kimi" / "skills"
-        self._create_skill(skills_dir, "speckit.specify", body="untouched")
-
-        (project_dir / ".kimi" / "commands").mkdir(parents=True, exist_ok=True)
-
-        manager = PresetManager(project_dir)
-        self_test_dir = Path(__file__).parent.parent / "presets" / "self-test"
-        manager.install_from_directory(self_test_dir, "0.1.5")
-
-        skill_file = skills_dir / "speckit.specify" / "SKILL.md"
-        assert skill_file.exists()
-        content = skill_file.read_text()
-        assert "preset:self-test" in content
-        assert "name: speckit.specify" in content
-
-        metadata = manager.registry.get("self-test")
-        assert "speckit.specify" in metadata.get("registered_skills", [])
-
-    def test_kimi_skill_updated_even_when_ai_skills_disabled(self, project_dir, temp_dir):
-        """Kimi presets should still propagate command overrides to existing skills."""
-        self._write_init_options(project_dir, ai="kimi", ai_skills=False)
-        skills_dir = project_dir / ".kimi" / "skills"
-        self._create_skill(skills_dir, "speckit-specify", body="untouched")
-
-        (project_dir / ".kimi" / "commands").mkdir(parents=True, exist_ok=True)
-
-        manager = PresetManager(project_dir)
-        self_test_dir = Path(__file__).parent.parent / "presets" / "self-test"
-        manager.install_from_directory(self_test_dir, "0.1.5")
-
-        skill_file = skills_dir / "speckit-specify" / "SKILL.md"
-        assert skill_file.exists()
-        content = skill_file.read_text()
-        assert "preset:self-test" in content
-        assert "name: speckit-specify" in content
-
-        metadata = manager.registry.get("self-test")
-        assert "speckit-specify" in metadata.get("registered_skills", [])
-
-    def test_kimi_preset_skill_override_resolves_script_placeholders(self, project_dir, temp_dir):
-        """Kimi preset skill overrides should resolve placeholders and rewrite project paths."""
-        self._write_init_options(project_dir, ai="kimi", ai_skills=False, script="sh")
-        skills_dir = project_dir / ".kimi" / "skills"
-        self._create_skill(skills_dir, "speckit-specify", body="untouched")
-        (project_dir / ".kimi" / "commands").mkdir(parents=True, exist_ok=True)
-
-        preset_dir = temp_dir / "kimi-placeholder-override"
-        preset_dir.mkdir()
-        (preset_dir / "commands").mkdir()
-        (preset_dir / "commands" / "speckit.specify.md").write_text(
-            "---\n"
-            "description: Kimi placeholder override\n"
-            "scripts:\n"
-            "  sh: scripts/bash/create-new-feature.sh --json \"{ARGS}\"\n"
-            "---\n\n"
-            "Execute `{SCRIPT}` for __AGENT__\n"
-            "Review templates/checklist.md and memory/constitution.md\n"
-        )
-        manifest_data = {
-            "schema_version": "1.0",
-            "preset": {
-                "id": "kimi-placeholder-override",
-                "name": "Kimi Placeholder Override",
-                "version": "1.0.0",
-                "description": "Test",
-            },
-            "requires": {"speckit_version": ">=0.1.0"},
-            "provides": {
-                "templates": [
-                    {
-                        "type": "command",
-                        "name": "speckit.specify",
-                        "file": "commands/speckit.specify.md",
-                    }
-                ]
-            },
-        }
-        with open(preset_dir / "preset.yml", "w") as f:
-            yaml.dump(manifest_data, f)
-
-        manager = PresetManager(project_dir)
-        manager.install_from_directory(preset_dir, "0.1.5")
-
-        content = (skills_dir / "speckit-specify" / "SKILL.md").read_text()
-        assert "{SCRIPT}" not in content
-        assert "__AGENT__" not in content
-        assert ".specify/scripts/bash/create-new-feature.sh --json \"$ARGUMENTS\"" in content
-        assert ".specify/templates/checklist.md" in content
-        assert ".specify/memory/constitution.md" in content
-        assert "for kimi" in content
-
-    def test_preset_skill_registration_handles_non_dict_init_options(self, project_dir, temp_dir):
-        """Non-dict init-options payloads should not crash preset install/remove flows."""
-        init_options = project_dir / ".specify" / "init-options.json"
-        init_options.parent.mkdir(parents=True, exist_ok=True)
-        init_options.write_text("[]")
-
-        skills_dir = project_dir / ".claude" / "skills"
-        self._create_skill(skills_dir, "speckit-specify", body="untouched")
-        (project_dir / ".claude" / "commands").mkdir(parents=True, exist_ok=True)
-
-        manager = PresetManager(project_dir)
-        self_test_dir = Path(__file__).parent.parent / "presets" / "self-test"
-        manager.install_from_directory(self_test_dir, "0.1.5")
-
-        content = (skills_dir / "speckit-specify" / "SKILL.md").read_text()
-        assert "untouched" in content
-

 class TestPresetSetPriority:
    """Test preset set-priority CLI command."""
--- a/tests/test_timestamp_branches.py
+++ b/tests/test_timestamp_branches.py
@@ -1,271 +0,0 @@
-"""
-Pytest tests for timestamp-based branch naming in create-new-feature.sh and common.sh.
-
-Converted from tests/test_timestamp_branches.sh so they are discovered by `uv run pytest`.
-"""
-
-import os
-import re
-import shutil
-import subprocess
-from pathlib import Path
-
-import pytest
-
-PROJECT_ROOT = Path(__file__).resolve().parent.parent
-CREATE_FEATURE = PROJECT_ROOT / "scripts" / "bash" / "create-new-feature.sh"
-CREATE_FEATURE_PS = PROJECT_ROOT / "scripts" / "powershell" / "create-new-feature.ps1"
-COMMON_SH = PROJECT_ROOT / "scripts" / "bash" / "common.sh"
-
-
-@pytest.fixture
-def git_repo(tmp_path: Path) -> Path:
-    """Create a temp git repo with scripts and .specify dir."""
-    subprocess.run(["git", "init", "-q"], cwd=tmp_path, check=True)
-    subprocess.run(
-        ["git", "config", "user.email", "test@example.com"], cwd=tmp_path, check=True
-    )
-    subprocess.run(
-        ["git", "config", "user.name", "Test User"], cwd=tmp_path, check=True
-    )
-    subprocess.run(
-        ["git", "commit", "--allow-empty", "-m", "init", "-q"],
-        cwd=tmp_path,
-        check=True,
-    )
-    scripts_dir = tmp_path / "scripts" / "bash"
-    scripts_dir.mkdir(parents=True)
-    shutil.copy(CREATE_FEATURE, scripts_dir / "create-new-feature.sh")
-    shutil.copy(COMMON_SH, scripts_dir / "common.sh")
-    (tmp_path / ".specify" / "templates").mkdir(parents=True)
-    return tmp_path
-
-
-@pytest.fixture
-def no_git_dir(tmp_path: Path) -> Path:
-    """Create a temp directory without git, but with scripts."""
-    scripts_dir = tmp_path / "scripts" / "bash"
-    scripts_dir.mkdir(parents=True)
-    shutil.copy(CREATE_FEATURE, scripts_dir / "create-new-feature.sh")
-    shutil.copy(COMMON_SH, scripts_dir / "common.sh")
-    (tmp_path / ".specify" / "templates").mkdir(parents=True)
-    return tmp_path
-
-
-def run_script(cwd: Path, *args: str) -> subprocess.CompletedProcess:
-    """Run create-new-feature.sh with given args."""
-    cmd = ["bash", "scripts/bash/create-new-feature.sh", *args]
-    return subprocess.run(
-        cmd,
-        cwd=cwd,
-        capture_output=True,
-        text=True,
-    )
-
-
-def source_and_call(func_call: str, env: dict | None = None) -> subprocess.CompletedProcess:
-    """Source common.sh and call a function."""
-    cmd = f'source "{COMMON_SH}" && {func_call}'
-    return subprocess.run(
-        ["bash", "-c", cmd],
-        capture_output=True,
-        text=True,
-        env={**os.environ, **(env or {})},
-    )
-
-
-# ── Timestamp Branch Tests ───────────────────────────────────────────────────
-
-
-class TestTimestampBranch:
-    def test_timestamp_creates_branch(self, git_repo: Path):
-        """Test 1: --timestamp creates branch with YYYYMMDD-HHMMSS prefix."""
-        result = run_script(git_repo, "--timestamp", "--short-name", "user-auth", "Add user auth")
-        assert result.returncode == 0, result.stderr
-        branch = None
-        for line in result.stdout.splitlines():
-            if line.startswith("BRANCH_NAME:"):
-                branch = line.split(":", 1)[1].strip()
-        assert branch is not None
-        assert re.match(r"^\d{8}-\d{6}-user-auth$", branch), f"unexpected branch: {branch}"
-
-    def test_number_and_timestamp_warns(self, git_repo: Path):
-        """Test 3: --number + --timestamp warns and uses timestamp."""
-        result = run_script(git_repo, "--timestamp", "--number", "42", "--short-name", "feat", "Feature")
-        assert result.returncode == 0, result.stderr
-        assert "Warning" in result.stderr and "--number" in result.stderr
-
-    def test_json_output_keys(self, git_repo: Path):
-        """Test 4: JSON output contains expected keys."""
-        import json
-        result = run_script(git_repo, "--json", "--timestamp", "--short-name", "api", "API feature")
-        assert result.returncode == 0, result.stderr
-        data = json.loads(result.stdout)
-        for key in ("BRANCH_NAME", "SPEC_FILE", "FEATURE_NUM"):
-            assert key in data, f"missing {key} in JSON: {data}"
-        assert re.match(r"^\d{8}-\d{6}$", data["FEATURE_NUM"])
-
-    def test_long_name_truncation(self, git_repo: Path):
-        """Test 5: Long branch name is truncated to <= 244 chars."""
-        long_name = "a-" * 150 + "end"
-        result = run_script(git_repo, "--timestamp", "--short-name", long_name, "Long feature")
-        assert result.returncode == 0, result.stderr
-        branch = None
-        for line in result.stdout.splitlines():
-            if line.startswith("BRANCH_NAME:"):
-                branch = line.split(":", 1)[1].strip()
-        assert branch is not None
-        assert len(branch) <= 244
-        assert re.match(r"^\d{8}-\d{6}-", branch)
-
-
-# ── Sequential Branch Tests ──────────────────────────────────────────────────
-
-
-class TestSequentialBranch:
-    def test_sequential_default_with_existing_specs(self, git_repo: Path):
-        """Test 2: Sequential default with existing specs."""
-        (git_repo / "specs" / "001-first-feat").mkdir(parents=True)
-        (git_repo / "specs" / "002-second-feat").mkdir(parents=True)
-        result = run_script(git_repo, "--short-name", "new-feat", "New feature")
-        assert result.returncode == 0, result.stderr
-        branch = None
-        for line in result.stdout.splitlines():
-            if line.startswith("BRANCH_NAME:"):
-                branch = line.split(":", 1)[1].strip()
-        assert branch is not None
-        assert re.match(r"^\d{3}-new-feat$", branch), f"unexpected branch: {branch}"
-
-    def test_sequential_ignores_timestamp_dirs(self, git_repo: Path):
-        """Sequential numbering skips timestamp dirs when computing next number."""
-        (git_repo / "specs" / "002-first-feat").mkdir(parents=True)
-        (git_repo / "specs" / "20260319-143022-ts-feat").mkdir(parents=True)
-        result = run_script(git_repo, "--short-name", "next-feat", "Next feature")
-        assert result.returncode == 0, result.stderr
-        branch = None
-        for line in result.stdout.splitlines():
-            if line.startswith("BRANCH_NAME:"):
-                branch = line.split(":", 1)[1].strip()
-        assert branch == "003-next-feat", f"expected 003-next-feat, got: {branch}"
-
-    def test_sequential_supports_four_digit_prefixes(self, git_repo: Path):
-        """Sequential numbering should continue past 999 without truncation."""
-        (git_repo / "specs" / "999-last-3digit").mkdir(parents=True)
-        (git_repo / "specs" / "1000-first-4digit").mkdir(parents=True)
-        result = run_script(git_repo, "--short-name", "next-feat", "Next feature")
-        assert result.returncode == 0, result.stderr
-        branch = None
-        for line in result.stdout.splitlines():
-            if line.startswith("BRANCH_NAME:"):
-                branch = line.split(":", 1)[1].strip()
-        assert branch == "1001-next-feat", f"expected 1001-next-feat, got: {branch}"
-
-    def test_powershell_scanner_uses_long_tryparse_for_large_prefixes(self):
-        """PowerShell scanner should parse large prefixes without [int] casts."""
-        content = CREATE_FEATURE_PS.read_text(encoding="utf-8")
-        assert "[long]::TryParse($matches[1], [ref]$num)" in content
-        assert "$num = [int]$matches[1]" not in content
-
-
-# ── check_feature_branch Tests ───────────────────────────────────────────────
-
-
-class TestCheckFeatureBranch:
-    def test_accepts_timestamp_branch(self):
-        """Test 6: check_feature_branch accepts timestamp branch."""
-        result = source_and_call('check_feature_branch "20260319-143022-feat" "true"')
-        assert result.returncode == 0
-
-    def test_accepts_sequential_branch(self):
-        """Test 7: check_feature_branch accepts sequential branch."""
-        result = source_and_call('check_feature_branch "004-feat" "true"')
-        assert result.returncode == 0
-
-    def test_rejects_main(self):
-        """Test 8: check_feature_branch rejects main."""
-        result = source_and_call('check_feature_branch "main" "true"')
-        assert result.returncode != 0
-
-    def test_rejects_partial_timestamp(self):
-        """Test 9: check_feature_branch rejects 7-digit date."""
-        result = source_and_call('check_feature_branch "2026031-143022-feat" "true"')
-        assert result.returncode != 0
-
-
-# ── find_feature_dir_by_prefix Tests ─────────────────────────────────────────
-
-
-class TestFindFeatureDirByPrefix:
-    def test_timestamp_branch(self, tmp_path: Path):
-        """Test 10: find_feature_dir_by_prefix with timestamp branch."""
-        (tmp_path / "specs" / "20260319-143022-user-auth").mkdir(parents=True)
-        result = source_and_call(
-            f'find_feature_dir_by_prefix "{tmp_path}" "20260319-143022-user-auth"'
-        )
-        assert result.returncode == 0
-        assert result.stdout.strip() == f"{tmp_path}/specs/20260319-143022-user-auth"
-
-    def test_cross_branch_prefix(self, tmp_path: Path):
-        """Test 11: find_feature_dir_by_prefix cross-branch (different suffix, same timestamp)."""
-        (tmp_path / "specs" / "20260319-143022-original-feat").mkdir(parents=True)
-        result = source_and_call(
-            f'find_feature_dir_by_prefix "{tmp_path}" "20260319-143022-different-name"'
-        )
-        assert result.returncode == 0
-        assert result.stdout.strip() == f"{tmp_path}/specs/20260319-143022-original-feat"
-
-
-# ── get_current_branch Tests ─────────────────────────────────────────────────
-
-
-class TestGetCurrentBranch:
-    def test_env_var(self):
-        """Test 12: get_current_branch returns SPECIFY_FEATURE env var."""
-        result = source_and_call("get_current_branch", env={"SPECIFY_FEATURE": "my-custom-branch"})
-        assert result.stdout.strip() == "my-custom-branch"
-
-
-# ── No-git Tests ─────────────────────────────────────────────────────────────
-
-
-class TestNoGitTimestamp:
-    def test_no_git_timestamp(self, no_git_dir: Path):
-        """Test 13: No-git repo + timestamp creates spec dir with warning."""
-        result = run_script(no_git_dir, "--timestamp", "--short-name", "no-git-feat", "No git feature")
-        assert result.returncode == 0, result.stderr
-        spec_dirs = list((no_git_dir / "specs").iterdir()) if (no_git_dir / "specs").exists() else []
-        assert len(spec_dirs) > 0, "spec dir not created"
-        assert "git" in result.stderr.lower() or "warning" in result.stderr.lower()
-
-
-# ── E2E Flow Tests ───────────────────────────────────────────────────────────
-
-
-class TestE2EFlow:
-    def test_e2e_timestamp(self, git_repo: Path):
-        """Test 14: E2E timestamp flow — branch, dir, validation."""
-        run_script(git_repo, "--timestamp", "--short-name", "e2e-ts", "E2E timestamp test")
-        branch = subprocess.run(
-            ["git", "rev-parse", "--abbrev-ref", "HEAD"],
-            cwd=git_repo,
-            capture_output=True,
-            text=True,
-        ).stdout.strip()
-        assert re.match(r"^\d{8}-\d{6}-e2e-ts$", branch), f"branch: {branch}"
-        assert (git_repo / "specs" / branch).is_dir()
-        val = source_and_call(f'check_feature_branch "{branch}" "true"')
-        assert val.returncode == 0
-
-    def test_e2e_sequential(self, git_repo: Path):
-        """Test 15: E2E sequential flow (regression guard)."""
-        run_script(git_repo, "--short-name", "seq-feat", "Sequential feature")
-        branch = subprocess.run(
-            ["git", "rev-parse", "--abbrev-ref", "HEAD"],
-            cwd=git_repo,
-            capture_output=True,
-            text=True,
-        ).stdout.strip()
-        assert re.match(r"^\d{3}-seq-feat$", branch), f"branch: {branch}"
-        assert (git_repo / "specs" / branch).is_dir()
-        val = source_and_call(f'check_feature_branch "{branch}" "true"')
-        assert val.returncode == 0