/init-openspec

name: init-openspec
description: Initialize OpenSpec in a project directory with the scaffolding-workflow schema.

/init-openspec Command

Initialize OpenSpec in a project directory with the scaffolding-workflow schema.

Usage

/init-openspec [project-path]

If no path is provided, initializes in the current working directory.

What It Does

Sets up OpenSpec spec-driven development tooling in a project:

1. Installs/verifies OpenSpec CLI 2. Initializes OpenSpec directory structure 3. Copies the scaffolding-workflow custom schema

Steps

1. **Verify OpenSpec CLI is available**

   openspec --version || npm install -g @fission-ai/openspec@latest

2. **Initialize OpenSpec in target directory**

   openspec init --tools claude [project-path]

This creates `.scaffolding/openspec/` directory and `.claude/commands/specs/` command files.

3. **Copy the scaffolding-workflow schema**

   openspec schema fork spec-driven scaffolding-workflow

Then replace the generated schema with the customized version from: `./schemas/scaffolding-workflow/schema.yaml`

4. **Create the conversations directory**

   mkdir -p .scaffolding/conversations/
   # link it to the shared NFS share (no-op without a reachable share)
   bash "${CLAUDE_PLUGIN_ROOT}/hooks/nfs-sync.sh" link "$PWD"

5. **Verify installation**

   openspec schemas
   openspec schema validate scaffolding-workflow

Output

After completion, confirm:

• OpenSpec version installed
• Directory structure created (`.scaffolding/openspec/specs/`, `.scaffolding/openspec/schemas/`, `.scaffolding/conversations/`)
• Commands available (`/specs:new`, `/specs:ff`, `/specs:apply`, etc.)
• Custom schema `scaffolding-workflow` validated and available

Available OpenSpec Commands After Init

| Command | Purpose | |---------|---------| | `/specs:new` | Start a new spec-driven change | | `/specs:ff` | Fast-forward: generate all artifacts at once | | `/specs:apply` | Implement tasks from specs | | `/specs:continue` | Create the next artifact | | `/specs:verify` | Verify implementation matches specs | | `/specs:archive` | Archive completed change |

Notes

• Requires Node.js >= 20.19.0
• Does not modify existing `.claude/commands/` files
• Specs in `.scaffolding/openspec/specs/` and schemas in `.scaffolding/openspec/schemas/` are tracked in git
• Conversation specs live in `.scaffolding/conversations/{conversation_id}/specs/` (`conversations/` is a symlink to `<share>/projects/<repo-name>/conversations`)