smith-migrate-specs

Migrate flat feature specs by running smith migrate-specs to scan the specs/ directory and copy NNN-* feature folders into .specify/systems/<system>/features/ with added frontmatter for traceability.

Structuring existing spec folders into a system hierarchy involves cross-referencing each feature with system specs under .specify/systems/system-*/spec.md to determine the primary system and identify other affected systems.

Yes, you need .specify/systems/ to exist with system folders before migrating specs, because the migration determines primary systems by cross-referencing system specs located within that directory structure.

Yes, you can preview a spec migration before applying changes by using the optional dry-run preview feature to see how feature folders will be copied and mapped without modifying the actual system hierarchy.

Spec migration skips directories in the specs folder that do not match the NNN-* naming convention or lack a spec.md file, excluding non-feature directories to ensure only valid feature folders are migrated.

Spec migration handles traceability for copied feature files by appending proper frontmatter to the spec.md files during the copy process into the new .specify/systems/<system>/features/<NNN-feature>/ structure.