setup

1# /do setup — First-Run Experience
2 
3Configures the harness for a specific project: installs hooks, detects stack, writes harness.json, and optionally demos the system on real code. Flag: `/do setup --express` skips mode selection and runs Express directly. Reference tables and layouts: docs/SETUP_REFERENCE.md.
4 
5## Orientation
6 
7**Use when:** first-run configuration of Citadel on a new project -- installs hooks, generates harness.json, scaffolds .planning/.
8**Don't use when:** harness is already configured and you want to verify it (use /verify); adding a single skill to an existing project (copy SKILL.md manually).
9 
10## Protocol
11 
12### Step -1: ARCHIVE DETECTION (all modes, before anything else)
13 
14Run `ls docs/citadel/ 2>/dev/null`. If `docs/citadel/` exists and contains `.md` files with `citadel-archive: true` in frontmatter, extract the `exported-at` date and prompt once:
15 
16```
17Found a Citadel archive from {exported-at date}.
18  Campaigns: {N}  Postmortems: {N}  Backlog items: {N}  Research: {N}
19 
20Restore history into .planning/ during setup? [Y/n]
21```
22 
23Y or Enter → set `restoreArchive = true`, restore after Step 1 (below). n → skip silently. No archive found → skip entirely, no output.
24 
25**ARCHIVE RESTORE** (runs after Step 1 if `restoreArchive = true`). Splitting: each `## Section Title` becomes one restored file; strip frontmatter before writing.
26 
27| File | Restore to |
28|---|---|
29| `campaigns.md` | Split sections → `.planning/campaigns/completed/{name}.md` |
30…