Add custom schema support to openspec init

docs/cli.md

@@ -93,8 +93,13 @@ openspec init [path] [options]
 | `--tools <list>` | Configure AI tools non-interactively. Use `all`, `none`, or comma-separated list |
 | `--force` | Auto-cleanup legacy files without prompting |
 | `--profile <profile>` | Override global profile for this init run (`core` or `custom`) |
+| `--schema <name>` | Write the named workflow schema to `openspec/config.yaml` |
+| `--schema-source <dir>` | Import a schema bundle directory |
 
 `--profile custom` uses whatever workflows are currently selected in global config (`openspec config profile`).
+`--schema-source` copies the schema bundle directory into `openspec/schemas/<name>/` and
+uses the source `schema.yaml` `name` field unless `--schema <name>` is provided.
+When both are provided, the names must match.
 
 **Supported tool IDs (`--tools`):** `amazon-q`, `antigravity`, `auggie`, `bob`, `claude`, `cline`, `codex`, `forgecode`, `codebuddy`, `continue`, `costrict`, `crush`, `cursor`, `factory`, `gemini`, `github-copilot`, `iflow`, `junie`, `kilocode`, `kimi`, `kiro`, `opencode`, `pi`, `qoder`, `lingma`, `qwen`, `roocode`, `trae`, `windsurf`
 
@@ -110,6 +115,12 @@ openspec init ./my-project
 # Non-interactive: configure for Claude and Cursor
 openspec init --tools claude,cursor
 
+# Initialize with a custom schema already available to OpenSpec
+openspec init --schema my-workflow
+
+# Import a schema bundle into the project during initialization
+openspec init --schema-source ../omnidev/schemas/my-workflow
+
 # Configure for all supported tools
 openspec init --tools all
 

docs/customization.md

@@ -24,7 +24,20 @@ The `openspec/config.yaml` file is the easiest way to customize OpenSpec for you
 openspec init
 ```
 
-This walks you through creating a config interactively. Or create one manually:
+This creates `openspec/config.yaml` with the default schema. If your team schema
+is already available to OpenSpec, initialize with it directly:
+
+```bash
+openspec init --schema my-workflow
+```
+
+If your schema lives outside the project, import it during initialization:
+
+```bash
+openspec init --schema-source ../omnidev/schemas/my-workflow
+```
+
+Or create one manually:
 
 ```yaml
 # openspec/config.yaml

src/cli/index.ts

@@ -101,7 +101,12 @@ program
   .option('--tools <tools>', toolsOptionDescription)
   .option('--force', 'Auto-cleanup legacy files without prompting')
   .option('--profile <profile>', 'Override global config profile (core or custom)')
-  .action(async (targetPath = '.', options?: { tools?: string; force?: boolean; profile?: string }) => {
+  .option('--schema <name>', 'Workflow schema to write to openspec/config.yaml')
+  .option('--schema-source <dir>', 'Import a schema bundle directory')
+  .action(async (
+    targetPath = '.',
+    options?: { tools?: string; force?: boolean; profile?: string; schema?: string; schemaSource?: string }
+  ) => {
     try {
       // Validate that the path is a valid directory
       const resolvedPath = path.resolve(targetPath);
@@ -127,6 +132,8 @@ program
         tools: options?.tools,
         force: options?.force,
         profile: options?.profile,
+        schema: options?.schema,
+        schemaSource: options?.schemaSource,
       });
       await initCommand.execute(targetPath);
     } catch (error) {

src/core/completions/command-registry.ts

@@ -44,6 +44,26 @@ export const COMMAND_REGISTRY: CommandDefinition[] = [
         description: 'Configure AI tools non-interactively (e.g., "all", "none", or comma-separated tool IDs)',
         takesValue: true,
       },
+      {
+        name: 'force',
+        description: 'Auto-cleanup legacy files without prompting',
+      },
+      {
+        name: 'profile',
+        description: 'Override global config profile for this init run',
+        takesValue: true,
+        values: ['core', 'custom'],
+      },
+      {
+        name: 'schema',
+        description: 'Workflow schema to write to openspec/config.yaml',
+        takesValue: true,
+      },
+      {
+        name: 'schema-source',
+        description: 'Import a schema bundle directory',
+        takesValue: true,
+      },
     ],
   },
   {