[Extension]: Add Improve Extension

[d0whc3r]

Extension ID

improve

Extension Name

Improve Extension

Version

1.0.0

Description

Audits any codebase as a senior advisor and writes prioritized, self-contained spec prompts under specs/ that the spec-kit lifecycle can process.

Author

d0whc3r

Repository URL

https://github.com/d0whc3r/spec-kit-improve

Download URL

https://github.com/d0whc3r/spec-kit-improve/releases/download/v1.0.0/improve-1.0.0.zip

License

MIT

Homepage (optional)

https://d0whc3r.github.io/spec-kit-improve/

Documentation URL (optional)

https://github.com/d0whc3r/spec-kit-improve/wiki

Changelog URL (optional)

https://github.com/d0whc3r/spec-kit-improve/blob/main/CHANGELOG.md

Required Spec Kit Version

=0.2.0

Required Tools (optional)

None. This extension is plain Markdown command and template text. It adds no external tool or runtime dependencies beyond Spec Kit itself.

Number of Commands

1

Number of Hooks (optional)

0

Tags

advisor, audit, code-quality, code-review, improvement, performance, planning, refactoring, security, spec-kit, spec-kit-extension, specs, tech-debt, testing

Key Features

• /speckit.improve: Audit any codebase as a senior advisor and write self-contained spec prompts under specs//improve/ for the spec-kit lifecycle to process: surface prioritized findings with evidence, write a single prompt for a specific change, or re-run to refresh prompts whose code has drifted

Testing Checklist

• Extension installs successfully via download URL
• All commands execute without errors
• Documentation is complete and accurate
• No security vulnerabilities identified
• Tested on at least one real project

Submission Requirements

• Valid extension.yml manifest included
• README.md with installation and usage instructions
• LICENSE file included
• GitHub release created with version tag
• All command files exist and are properly formatted
• Extension ID follows naming conventions (lowercase-with-hyphens)

Testing Details

Tested by the https://github.com/d0whc3r/spec-kit-improve release pipeline (release):

• Manifest validation (pnpm run validate) confirms extension.yml and catalog.json agree on version, command count, and hook count.
• Content lint (pnpm run lint:content) enforces the output style rules every command must follow.
• The release archive improve-1.0.0.zip is built and attached to the GitHub release at tag v1.0.0.
• Install is exercised from the published download URL above.

Test project: the extension is dogfooded on this repository itself; the committed examples/ plans were generated by running the audit against real codebases.

Example Usage

# Install the extension from the release archive
specify extension add improve --from https://github.com/d0whc3r/spec-kit-improve/releases/download/v1.0.0/improve-1.0.0.zip

# Audit the codebase and write spec prompts
/speckit.improve

# Or spec one known change directly
/speckit.improve migrate the config loader to zod

# Hand a prompt to the spec-kit lifecycle
/speckit.specify <prompt body>   # then /speckit.clarify, /speckit.plan, /speckit.tasks, /speckit.implement

# Next session: re-run to refresh drifted prompts and dedupe
/speckit.improve

Proposed Catalog Entry

{
  "improve": {
    "name": "Improve Extension",
    "id": "improve",
    "description": "Audits any codebase as a senior advisor and writes prioritized, self-contained spec prompts under specs/ that the spec-kit lifecycle can process.",
    "author": "d0whc3r",
    "version": "1.0.0",
    "download_url": "https://github.com/d0whc3r/spec-kit-improve/releases/download/v1.0.0/improve-1.0.0.zip",
    "repository": "https://github.com/d0whc3r/spec-kit-improve",
    "homepage": "https://d0whc3r.github.io/spec-kit-improve/",
    "documentation": "https://github.com/d0whc3r/spec-kit-improve/wiki",
    "changelog": "https://github.com/d0whc3r/spec-kit-improve/blob/main/CHANGELOG.md",
    "license": "MIT",
    "requires": {
      "speckit_version": ">=0.2.0"
    },
    "provides": {
      "commands": 1,
      "hooks": 0
    },
    "tags": [
      "advisor",
      "audit",
      "code-quality",
      "code-review",
      "improvement",
      "performance",
      "planning",
      "refactoring",
      "security",
      "spec-kit",
      "spec-kit-extension",
      "specs",
      "tech-debt",
      "testing"
    ],
    "verified": false,
    "created_at": "2026-06-11T00:00:00Z",
    "updated_at": "2026-06-13T22:39:17Z",
    "downloads": 0,
    "stars": 0
  }
}

Additional Context

Full user documentation lives on the project website (https://d0whc3r.github.io/spec-kit-improve/) and the project wiki, with reference docs at https://github.com/d0whc3r/spec-kit-improve/wiki. Source repository: https://github.com/d0whc3r/spec-kit-improve.

A complete, real worked example (a generated findings table and the resulting plan files) is committed at https://github.com/d0whc3r/spec-kit-improve/tree/main/examples so reviewers and users can see exactly what each command reads and writes.

[github-actions]

cc @github/spec-kit-maintainers — new catalog submission for review.