superspec create

Create a change directory and git branch. Artifact files (proposal, spec, etc.) are generated on demand by AI via /ss-create, not by the CLI.

Syntax

superspec create <feature> [options]

Arguments

Argument	Description	Required
<feature>	Change name / feature description	Yes

Options

Option	Description	Default
-b, --boost	Boost mode	false
-c, --creative	Creative mode	false
-d, --description <desc>	Change description	-
--spec-dir <dir>	Custom spec directory	Config value
--no-branch	Don't create git branch	false
--intent-type <type>	Intent type	-
--branch-prefix <prefix>	Branch prefix	Config value
--branch-template <tpl>	Branch name template	Config value
--change-name-template <tpl>	Folder name template	Config value
--user <user>	Developer identifier	-
--lang <lang>	SDD document language	-

--intent-type Option

Supported intent types:

• feature - New feature
• hotfix - Hotfix
• bugfix - Bug fix
• refactor - Refactoring
• chore - Chore

Template Variables

Branch template and folder name template support the following variables:

• {prefix} - Branch prefix
• {intentType} - Intent type
• {feature} - Feature name
• {date} - Date (YYYYMMDD)
• {user} - Developer identifier

Examples

Standard Mode

superspec create add-dark-mode

Creates change folder + git branch. Then AI generates artifacts on demand via /ss-create.

Boost Mode

superspec create add-user-auth -b

Creates change folder + git branch (boost flag stored). Then AI generates artifacts on demand via /ss-create -b.

Creative Mode

superspec create redesign-ui -c

Boost + Creative Mode

superspec create new-architecture -b -c

With Description

superspec create add-auth -d "OAuth2 integration with Google and GitHub login"

Without Branch Creation

superspec create add-feature --no-branch

Custom Branch

# Custom prefix
superspec create add-auth --branch-prefix feature/

# Custom template
superspec create add-auth --branch-template "{prefix}{date}-{feature}-{user}"

# Specify intent type and user
superspec create add-auth --intent-type feature --user jay

Custom Folder Name

superspec create add-auth --change-name-template "{date}-{feature}-{user}"

What CLI Creates

The CLI only creates the change folder and git branch. No artifact files are generated.

superspec/changes/<name>/     (empty folder)

AI generates artifacts on demand during /ss-create:

Standard mode: proposal.md → checklist.md (via auto checklist /10) Boost mode: proposal.md → spec.md → design.md (optional) → checklist.md (via auto checklist /25) Later via /ss-tasks: tasks.md

Output Example

╭────────────────────────────────────────────────╮
  Creating change: feature-20240115-add-auth-jay
╰────────────────────────────────────────────────╯

Intent type: feature
⚡ Boost mode enabled
✓ Branch: feature/feature-20240115-add-auth-jay

✨ Change created successfully!
Path: superspec/changes/feature-20240115-add-auth-jay/
Templates: superspec/templates/
Expected artifacts: proposal, spec, design, tasks, checklist
Next: AI generates artifacts on demand via /ss-create

Notes

1. Change already exists: If a change with the same name exists, the command shows a warning and exits
2. Git branch: A git branch is created by default; use --no-branch to skip
3. Template language: Use --lang to override the language setting in the configuration file