Extension Lifecycle

1. Discovery

specify extension search jira
# Searches catalog for extensions matching "jira"

Process:

1. Fetch extension catalog from GitHub
2. Filter by search term (name, tags, description)
3. Display results with metadata

2. Installation

specify extension add jira

Process:

1. Resolve: Look up extension in catalog
2. Download: Fetch extension package (ZIP from GitHub release)
3. Validate: Check manifest schema, compatibility
4. Extract: Unpack to .specify/extensions/jira/
5. Configure: Copy config templates
6. Register: Add commands to AI agent config
7. Record: Update .specify/extensions/.registry

Registry Format (.specify/extensions/.registry):

{
  "schema_version": "1.0",
  "extensions": {
    "jira": {
      "version": "1.0.0",
      "installed_at": "2026-01-28T14:30:00Z",
      "source": "catalog",
      "manifest_hash": "sha256:abc123...",
      "enabled": true,
      "priority": 10
    }
  }
}

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

3. Configuration

# User edits extension config
vim .specify/extensions/jira/jira-config.yml

Config discovery order:

1. Extension defaults (extension.yml → defaults)
2. Project config (jira-config.yml)
3. Local overrides (jira-config.local.yml - gitignored)
4. Environment variables (SPECKIT_JIRA_*)

4. Usage

claude
> /speckit.jira.specstoissues

Command resolution:

1. AI agent finds command in .claude/commands/speckit.jira.specstoissues.md
2. Command file references extension scripts/config
3. Extension executes with full context

5. Update

specify extension update jira

Process:

1. Check catalog for newer version
2. Download new version
3. Validate compatibility
4. Back up current config
5. Extract new version (preserve config)
6. Re-register commands
7. Update registry

6. Removal

specify extension remove jira

Process:

1. Confirm with user (show what will be removed)
2. Unregister commands from AI agent
3. Remove from .specify/extensions/jira/
4. Update registry
5. Optionally preserve config for reinstall