Skip to content

Comments

Add Cleanup Extension to catalog#1617

Open
dsrednicki wants to merge 1 commit intogithub:mainfrom
dsrednicki:feat/cleanup-command
Open

Add Cleanup Extension to catalog#1617
dsrednicki wants to merge 1 commit intogithub:mainfrom
dsrednicki:feat/cleanup-command

Conversation

@dsrednicki
Copy link

@dsrednicki dsrednicki commented Feb 17, 2026

Extension: Cleanup Extension

Repository: https://github.com/dsrednicki/spec-kit-cleanup
Version: 1.0.0
License: MIT
Author: @dsrednicki

What it does

Post-implementation quality gate that reviews changes and handles issues by severity:

Severity Examples Action
SMALL Debug statements, unused imports, dead code Fix immediately (Scout Rule)
MEDIUM Missing error handling, code duplication Create follow-up tasks in tasks.md
LARGE Architecture issues, security design flaws Generate tech-debt-report.md with options
CRITICAL Hardcoded secrets, disabled auth Halt and alert user

Key features

  • Scout Rule: Automatically fixes small mechanical issues with user confirmation
  • Constitution Compliance: All cleanup actions respect project constitution principles
  • Non-Destructive: Always confirms before modifying, rolls back on validation failure
  • Linter Integration: Defers to project linters for style issues
  • Tech Debt Tracking: Creates actionable tasks and detailed reports

Commands

Command Description
/speckit.cleanup.run Review implementation, fix small issues, identify tech debt
/speckit.cleanup Alias for above

Hook

  • after_implement - Prompts to run cleanup after /speckit.implement completes

Catalog entry changes

Adds a single entry to extensions/catalog.json with download URL pointing to the v1.0.0 release.

Installation (once merged)

specify extension add cleanup

@mnriem
Copy link
Collaborator

mnriem commented Feb 18, 2026

For new commands please use the extensions mechanism as described at https://github.com/github/spec-kit/tree/main/extensions

@dsrednicki
Copy link
Author

For new commands please use the extensions mechanism as described at https://github.com/github/spec-kit/tree/main/extensions

Change to use the extension mechanism

@mnriem
Copy link
Collaborator

mnriem commented Feb 20, 2026

@dsrednicki You will have to host it on a GitHub repo you own similar to the V-Model extension does, see #1640 and the repository for the extension itself at https://github.com/leocamello/spec-kit-v-model

I hope that clarifies it enough? Feel free to ask more questions.

Tagging @leocamello as well as he just went through the process and might be available to answer questions as well

@dsrednicki dsrednicki changed the title feat: add /speckit.cleanup command for post-implementation review Add Cleanup Extension to catalog Feb 22, 2026
**Repository**: https://github.com/dsrednicki/spec-kit-cleanup
**Version**: 1.0.0
**License**: MIT
**Author**: @dsrednicki

Adds catalog entry for the Cleanup Extension - a post-implementation
quality gate that fixes small issues (scout rule), creates tasks for
medium issues, and generates analysis for large issues.
@dsrednicki
Copy link
Author

@dsrednicki You will have to host it on a GitHub repo you own similar to the V-Model extension does, see #1640 and the repository for the extension itself at https://github.com/leocamello/spec-kit-v-model

I hope that clarifies it enough? Feel free to ask more questions.

Tagging @leocamello as well as he just went through the process and might be available to answer questions as well

Thanks for the support.
Done. Hope it fits.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants