Setup

Setup -- Configuration Wizard

Activate When

• /godmode:setup, first-time use (no .godmode/)
• A skill needs test/lint/build cmd but none exists
• "configure godmode", "set up", "initialize"

Workflow

Step 1: Detect Stack

# Check manifests (most specific first)
ls package.json pyproject.toml Cargo.toml go.mod \
  Gemfile pom.xml build.gradle composer.json 2>/dev/null

# Check framework configs
ls next.config.* nuxt.config.* angular.json \
  tsconfig.json vite.config.* 2>/dev/null

# Check lockfiles (determines package manager)
ls yarn.lock pnpm-lock.yaml package-lock.json \
  uv.lock poetry.lock Cargo.lock go.sum 2>/dev/null

# Check language versions
node --version 2>/dev/null
python3 --version 2>/dev/null
go version 2>/dev/null

# Detect Docker
docker --version 2>/dev/null

If Docker is present, note in .godmode/config. When Docker is available and a Dockerfile exists: offer containerized metric runs.

DETECTION MATRIX:
package.json + next.config.* -> Next.js
  test: npm test | lint: eslint --fix | build: npm run build
package.json + vite.config.* -> Vite
  test: npx vitest | lint: eslint --fix | build: npx vite build
package.json + tsconfig.json -> TypeScript
  test: npx vitest | lint: eslint --fix | build: tsc --noEmit
pyproject.toml -> Python
  test: pytest | lint: ruff check . | build: --
Cargo.toml -> Rust
  test: cargo test | lint: cargo clippy | build: cargo build
go.mod -> Go
  test: go test ./... | lint: golangci-lint | build: go build

LOCKFILE -> PACKAGE MANAGER:
  yarn.lock -> yarn
  pnpm-lock.yaml -> pnpm
  package-lock.json -> npm
  uv.lock -> uv
  poetry.lock -> poetry

Step 2: Detect Platform

PLATFORM DETECTION (first match):
  IF subagent spawn + worktree isolation available: Parallel-capable harness
  IF read_file + run_shell_command: Gemini CLI
  IF slash commands + no Agent(): OpenCode
  IF .codex/ directory: Codex
  IF .cursorrules file: Cursor
  ELSE: Unknown (sequential, manual worktrees)

| Platform    | Parallel | Worktrees    |
|------------|---------|-------------|
| Parallel-capable harness | yes     | native       |
| Gemini CLI | no      | manual       |
| Codex      | no      | branch-based |
| Cursor     | no      | manual       |

Step 3: Validate Commands

# Run each command and capture exit code
{test_cmd}; echo "EXIT:$?"
{lint_cmd}; echo "EXIT:$?"
{build_cmd}; echo "EXIT:$?"

| Command | Value       | Status | Time |
|---------|-----------|--------|------|
| test    | npx vitest | PASS   | 4.2s |
| lint    | eslint --fix| PASS  | 1.8s |
| build   | tsc --noEmit| FAIL  | 0.3s |

FOR each FAIL:
  Print last 20 lines of error
  Ask user for alternative (one question at a time)
  IF skipped: set to -- (unavailable)
  Max 3 retries per command

Step 4: Configure Optimization

Only if user wants /godmode:optimize:

# Run metric 3 times, take median
for i in 1 2 3; do {verify_cmd}; done

IF 3 runs differ by >10%: warn metric is unstable. Collect: goal, metric command, direction, target, max iterations (default 25).

Step 5: Define Scope

# Auto-detect source directories
git ls-files | grep -oP '^[^/]+/' | sort -u

# Auto-detect excludes
ls -d node_modules dist build .git __pycache__ \
  .next .nuxt target vendor 2>/dev/null

Step 6: Save Config

Write .godmode/config.yaml with keys: project, commands, platform, optimization, scope, guard_rails.

Step 6b: Model Tiering (optional)

Only if user wants per-role models. Max 3 questions total, then stop asking. Model values are opaque strings passed as parameters to child dispatches -- never evaluated. Resolution order: GODMODE_MODEL_<ROLE> env -> godmode.models.json (per-role merge: current project root file wins per-key over ~/.config/godmode/models.json) -> session model. Missing config = VALID zero-config default; every role inherits the session model.

# 1) Detect authed providers WITHOUT asking first.
# Key NAMES only -- never print values.
printenv | grep -E '_(API_KEY|TOKEN)=' | cut -d= -f1 || true
# Harness-native checks where available (the harness's own
# auth/model-registry status commands, if present):
command -v pi >/dev/null 2>&1 && pi auth check 2>/dev/null || true

DETECTED AUTH -> WORKS-ON-THIS-MACHINE LIST:
  *_API_KEY / *_TOKEN env name -> provider authed via env
  harness auth/registry check  -> provider authed via harness

IF none detected OR user skips:
  Print the zero-config promise: every role inherits the
  session model -- valid default, nothing to configure.
  STOP this step.

2. Propose a tiering derived from what works on this machine -- never hard-coded vendor names as "required":

STRONG tier -> review, security, plan
FAST tier   -> build, optimize, docs, explore
  (placeholders: vendor/strong, vendor/fast -- substitute
  whatever the detected providers actually offer)

Ask AT MOST 3 questions, then stop asking: Q1: use this proposal as-is? Fold the target-file choice in here: ~/.config/godmode/models.json (personal, default) or godmode.models.json at repo root (share with team). Q2: which model for strong roles? Q3: which model for fast roles? Roles are open-ended user keys; unknown role -> session model. Case-folded roles (Plan/plan) collapse to one env var -- document, do not special-case. Zero-file alternative: GODMODE_MODEL_<ROLE> env one-liners win over the file.

3. Validate BEFORE writing; never write unvalidated config. File shape: {"roles": {: "provider/id"}}. A value is valid iff it fully matches ^[A-Za-z0-9.-]+/[A-Za-z0-9.-]+$ or is the literal string "session". An invalid value at ANY layer: one stderr warning ("[models] warning: ignoring invalid model value for role ") + treat as absent (fall through to the next layer).

# chosen = answers to Q1-Q3; pass role/model pairs as ARGV (never splice
# user answers into python source); validate BEFORE writing
python3 -c 'import json, re, sys
pat = r"^[A-Za-z0-9._-]+/[A-Za-z0-9._-]+$"
roles = dict(zip(sys.argv[2::2], sys.argv[3::2]))
assert all(re.fullmatch(pat, v) or v == "session"
           for v in roles.values()), "invalid model value"
json.dump({"roles": roles}, open(sys.argv[1], "w"), indent=2)' \
  "$file" review "$strong" build "$fast"

Env name per role: printf '%s' "$role" | tr '[:lower:]._-' '[:upper:]___' -> GODMODE_MODEL_; read with printenv "$name" 2>/dev/null || true; set-but-empty = NOT an override (fall through).

4. Verify the write. ALWAYS the json check (mirrors Step 7's yaml check); doctor ONLY inside a godmode repo checkout (skills-only installs have no adapters/):

python3 -m json.tool "$file"
if [ -f adapters/pi/models.sh ]; then
  bash adapters/pi/models.sh doctor  # role -> model + source
fi

Emit the applicable "Setup: models:" Output Format line(s).

Step 7: Final Validation

{test_cmd} && {lint_cmd} && {build_cmd}
python3 -c 'import yaml; yaml.safe_load(
  open(".godmode/config.yaml"))'
if [ -f godmode.models.json ]; then python3 -c 'import json
r = json.load(open("godmode.models.json"))["roles"]
assert all(v == "session" or "/" in v for v in r.values())'; fi
git add .godmode/config.yaml
[ -f godmode.models.json ] && git add godmode.models.json
git commit -m "setup: configure godmode"

Output Format

Setup: detected {language} ({framework}) with {pm}.
Setup: platform: {name}. Parallel: {yes|no}.
Setup: test ({cmd}) -- PASS ({time}s).
Setup: lint ({cmd}) -- PASS ({time}s).
Setup: build ({cmd}) -- PASS ({time}s).
Setup: wrote .godmode/config.yaml. Committed.
Setup: models: proposal made ({n} providers detected).
Setup: models: wrote {path} (validated).
Setup: models: zero-config kept (roles -> session model).

TSV Logging

Append to .godmode/setup-log.tsv: timestamp\tlanguage\tframework\tplatform\ttest\tlint\tbuild

Quality Targets

• Target: <15min from git clone to running dev environment
• Target: <5 manual steps in setup process
• Target: 100% of required tools auto-installed

Hard Rules

1. Auto-detect before asking. Never ask "what language?" when package.json exists.
2. Never store unvalidated commands.
3. Never put secrets in config.yaml.
4. Skills not needing commands (think, debug) skip setup.
5. Max 3 retries per command, then set to --.
6. Guard: test_cmd && lint_cmd.
7. On failure: git reset --hard HEAD~1.
8. Never ask to continue. Loop autonomously.

Keep/Discard Discipline

KEEP if: command exits 0 AND produces output
  within timeout
DISCARD if: fails OR times out OR no output
  Max 3 retries, then set to --.

Stop Conditions

STOP when FIRST of:
  - .godmode/config.yaml written and committed
  - 3 retries per command exhausted
  - User skips all remaining optional commands