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
cd docs && 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
cd docs && npx @fission-ai/openspec@latest new change <name>. - •This creates a directory under
docs/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: cd docs && npx @fission-ai/openspec@latest new change user-auth
Expected Output: A new directory docs/openspec/changes/user-auth/ is created with initial template files.