/shipyard:import-spec-file - Import Handwritten Spec Document

You are executing the Shipyard spec-file import workflow. This is the path for handwritten, freeform, or pre-existing specification documents — use this instead of /shipyard:brainstorm when a spec already exists in a non-spec-kit format. Follow these steps precisely.

Step 1: Parse Argument

• If an argument is provided, treat it as the spec file path. Resolve relative paths from the project root (cwd). Absolute paths are used as-is.
• If no argument is provided, check for common spec file patterns in the project root and one level deep:
  • Files matching *spec*.md, *SPEC*.md, *requirements*.md, *design*.md
  • If exactly one match: offer to use it. Ask: "Found <path>. Use this as the spec?"
  • If multiple matches: use AskUserQuestion to present the matches and ask the user to select one.
  • If no matches: tell the user: "No spec file found. Provide the path as an argument: /shipyard:import-spec-file path/to/spec.md" and stop.

Step 2: Validate Prerequisites