spec-workflow-init

# Spec Workflow Init

Scaffolds the spec-workflow configuration structure in your project.

## Arguments

- `--minimal`: Create only `config.yaml` with documented options
- `--full`: Create all files with example content (default)
- `--philosophy-only`: Create only philosophy and persona files

## What Gets Created

### Minimal (`--minimal`)

```
.claude/
└── spec-workflow/
    └── config.yaml         # Commented config with all options
```

### Full (`--full`, default)

```
.claude/
└── spec-workflow/
    ├── config.yaml         # Commented config
    ├── philosophy/
    │   ├── exploration.md  # Exploration guidance
    │   ├── spec-standards.md  # Spec quality standards
    │   └── review-criteria.md # Review focus areas
    ├── personas/
    │   └── example.md      # Example custom persona
    └── templates/
        └── spec.md         # Spec template (customize as needed)
```

### Philosophy Only (`--philosophy-only`)

```
.claude/
└── spec-workflow/
    ├── philosophy/
    │   ├── exploration.md
    │   ├── spec-standards.md
    │   └── review-criteria.md
    └── personas/
        └── example.md
```

---

## Process

1. **Check for existing config**
   - If `.claude/spec-workflow/` exists, ask user before overwriting
   - Options: Skip existing files / Overwrite all / Cancel

2. **Detect project structure**
   - Look for package.json, Cargo.toml, go.mod, etc.
   - Identify services/workspaces
   - Pre-populate config with detected structure

3. **Create directory structure**
   ```bash
   mkdir -p .claude/spec-workflow/{philosophy,personas,templates}
   ```

4. **Generate config.yaml**
   - Include all options with comments
   - Pre-fill detected services
   - Pre-fill detected build/test commands

5. **Generate philosophy files** (unless --minimal)
   - Create starter templates with guidance

6. **Generate example persona** (unless --minimal)
   - Create one example to show the format

7. **Generate spec template** (unless --minimal or --philosophy-only)
   -