init

init — set up specwright in this repository

The plugin already provides every workflow skill. This command creates only project-scoped content, and only what is missing:

• the .specwright/ vault;
• a ## specwright section in the canonical AGENTS instructions, plus the Claude adapter symlink;
• the ignore rules for the chosen mode.

That is the whole list. Role profiles are not project state — see step 5.

It never installs or enables a plugin, edits personal host configuration, copies skill bodies, or creates .claude/settings.json.

Announce at start: "Setting up specwright..."

1. Resolve the plugin root

Resolve SW_PLUGIN_ROOT before any project write:

1. use PLUGIN_ROOT when it contains .codex-plugin/plugin.json;
2. otherwise use CLAUDE_PLUGIN_ROOT when it contains .claude-plugin/plugin.json;
3. otherwise derive it from this loaded skills/init/SKILL.md real path — the plugin root is two parents above the skills/init/ directory.

Require scripts/sw_init.py and both templates/codex-agents/sw-*.toml beneath that root. Stop before writing if resolution fails, and report the missing path. Never look for bundled resources inside the target repository.

2. Pick the mode

Ask once, unless $ARGUMENTS already says shared or local:

• shared — specwright state is versioned with the project. Tracks .specwright/, AGENTS.md, CLAUDE.md -> AGENTS.md, and the two Codex profiles. Ignores only .specwright/worktrees/. Pick this for your own repo.
• local — specwright state stays private to this checkout. Uses AGENTS.override.md, CLAUDE.local.md -> AGENTS.override.md, and ignores the whole vault, both instruction paths, and the profiles. Pick this for a repo you cannot or would rather not commit workflow artifacts to.

The canonical instruction file is always the AGENTS* path; the CLAUDE* path is only a compatibility symlink, never the source of truth.

3. Run the scaffolder

python3 "$SW_PLUGIN_ROOT/scripts/sw_init.py" \
  --project "$PWD" \
  --mode "<shared-or-local>"