speckit-workflows.cleanup

To fix non-sequential numbering and gaps in spec files, run the cleanup script to validate the specs/ directory and automatically reorganize artifacts into correct sequential order.

You validate the directory structure of spec-kit artifacts by running the cleanup script from the repo root, which checks for proper directory hierarchy, sequential numbering, and required files.

Misplaced directories and duplicate numbers in specs/ folders typically occur after merging multiple feature branches, disrupting sequential numbering and correct workflow structure.

Yes, you can get a JSON report of spec validation errors because the validation script operates via bash scripts and provides JSON output for detailed reporting of organizational issues.

Yes, the spec-kit cleanup script can automatically reorganize artifacts by fixing numbering gaps, misplaced directories, and invalid names to ensure correct workflow structure.

You should run a spec directory validation workflow after merging several feature branches to ensure all new specifications are correctly numbered and placed within their respective workflow directories.