setup

# /craftsman:setup - Configuration Wizard ## Outcome Contract - **Outcome**: a configuration derived from what the repository actually is, with only the undeterminable parts asked. - **Done when**: the inferred conventions were shown before being written, .craft-config.yml is valid against the schema, and healthcheck reports no config error. - **Evidence**: the conventions analysis output, the written config, and the healthcheck result. ## Modes | Command | Description | |---------|-------------| | `/craftsman:setup` | Full interactive setup (default) | | `/craftsman:setup --quick` | Zero-question auto-setup with smart defaults | | `/craftsman:setup --refresh` | Regenerate observed artifacts (conventions skill, codemap) | | `/craftsman:setup --global` | Workshop profile: asked once per machine, inherited by every project | --- ## Setup by Observation (ADR-0022) Every mode (including `--quick`) ends with the observation step. The repository answers most setup questions itself; only ask the user what observation cannot determine (strictness preference, pack opt-ins). 1. Run the conventions analyzer and SHOW the user what was inferred before writing anything: ```bash bash ~/.claude/craftsman-conventions.sh analyze ``` 2. On confirmation (automatic in `--quick` and `--refresh`), generate the project conventions skill: ```bash bash ~/.claude/craftsman-conventions.sh generate "$PWD/.claude/skills" ``` This writes `.claude/skills/project-conventions/SKIL...