Creating OpenSpec Change
Purpose
Initializes a new change proposal directory with the standard OpenSpec structure, enabling spec-driven development for a new task.
1. Safety & Verification
- •Check Help: Run
npx @fission-ai/openspec@latest new change --help. - •Naming: Use a slug-style name (e.g.,
add-dark-mode).
2. Common Workflows
Workflow: Start a New Change
- •Run
npx @fission-ai/openspec@latest new change <name>. - •This creates a directory under
openspec/changes/<name>/.
3. Error Handling
- •If the directory already exists: Choose a different name or manually manage the existing directory.
4. Examples
Example: Create a New Feature Proposal
Command: npx @fission-ai/openspec@latest new change user-auth
Expected Output: A new directory openspec/changes/user-auth/ is created with initial template files.