openspec-new-change

To start an OpenSpec change, run npx openspec new change "<name>" from the workspace root and follow the interactive prompts to scaffold the modification. This automates creating a structured, step-by-step artifact workflow for your project change.

The OpenSpec artifact workflow is a structured, step-by-step approach for defining new features, fixes, or modifications. It guides you through a sequence of artifacts and validations to ensure your project change is properly scaffolded and documented.

Yes, OpenSpec requires kebab-case naming for new changes. The skill validates your input names before proceeding to ensure they meet the required formatting standard for the artifact workflow scaffolding process.

No, you must run the OpenSpec change scaffolding command from the workspace root. The tool requires the workspace to be in the OpenSpec root directory to properly validate and generate the artifact workflow for your new change.

The best way to structure a new modification is using the experimental artifact workflow via npx openspec. This provides guided change scaffolding, outlining the sequence of artifacts, validations, and user prompts needed for your feature or fix.

OpenSpec change scaffolding fails during input validation if your change name is not in kebab-case or if you are not running the command from the OpenSpec workspace root directory. Ensure your workspace is properly configured before proceeding.