speckit-cleanup

To reorganize spec files with non-sequential numbering, run a validation and cleanup script. It automatically parses the specs directory, identifies numbering conflicts or duplicates, and renumbers artifacts sequentially to maintain a logical structure.

Spec-kit artifact validation is the process of checking the specs directory for correct sequential numbering, directory structure, and file presence. You need it after merging feature branches to prevent organizational chaos and ensure artifact discoverability.

To check for misplaced directories and invalid names in your specs folder, execute a cleanup script. It validates the placement of workflow-specific directories and flags unrecognized directories or invalid file names by parsing JSON status output.

The spec-kit cleanup script does not require any external dependencies to run. It operates via internal bash scripts to validate and reorganize artifacts, requiring only an existing specs directory containing your workflow documentation.

The cleanup script reports missing spec files and validation issues by generating and parsing JSON output. This structured output provides a clear status of your specs directory, highlighting any non-sequential numbering or file presence errors for resolution.