strata-init

name	strata:init
disable-model-invocation	true
description	One-time setup. Creates the vault namespace, then guides the user through the two optional add-ons that unlock the differentiated features. Installing Graphify (for code-graph awareness) and running bootstrap (to migrate existing planning docs). Interactive. Invoke when the user says "set up strata", "initialise the vault", "first install", or when a session starts in a repo where `<vault>/<repo>/` is empty.

strata:init

Three-step onboarding. Always step 1; step 2 and 3 are user-chosen.

Step 1 · create the vault namespace

Always do this. Idempotent.

"${CLAUDE_PLUGIN_ROOT}/bin/strata" init

Creates <vault>/<repo>/{decisions,domain,lessons,procedural,propositions,pr-context}/ Plus INDEX.md. Vault path defaults to ~/StrataVault, overridable via STRATA_VAULT_PATH or plugin userConfig.vault_path.

init-memory.py also runs an inline venv health check at the end — imports every required package and reports any missing required or Optional deps. The bootstrap-venv.sh wrapper auto-installs from requirements.txt on first run, so this is usually green, but it Makes the state legible to the user before they invoke their first Save / decide / recall.

Show the user the resulting layout in one line:

✓ Strata initialised at ~/StrataVault/<repo>/
  scopes: decisions/ domain/ lessons/ procedural/ propositions/ pr-context/

Step 2 · ask about Graphify

Graphify is a separate tool that builds a code structure graph from your repo. With it, Strata unlocks code_map, drift detection, aDR↔commit linkage, hot-file ranking, and verified code_refs: on Notes. Without it, Strata still works. Minus code-graph awareness.

Ask the user (yes / no / later):

Want to install Graphify now? It unlocks code-graph features (code_map, drift detection, ADR verification). Separate binary, runs locally. Skip if you're just trying Strata out.

If yes

Show the install command. Don't run it yourself. Paths vary, they may want sudo, they may already have it:

# macOS via Homebrew
brew install graphifylabs/tap/graphify

# Or use the installer at https://graphifylabs.ai/install

Then offer to build the first graph:

"${CLAUDE_PLUGIN_ROOT}/bin/strata" graphify

If no / later

Acknowledge briefly. Mention /strata:graphify runs the build Whenever they're ready. Continue to step 3.

Step 3 · ask about bootstrap

If the repo has an existing .planning/, docs/, or similar directory of markdown that predates Strata, the bootstrap pipeline Can migrate that content into the vault. Cross-references claims Against git history + the code graph; classifies into ADR / domain / Lesson; writes notes with provenance.

Check first whether there's anything to bootstrap:

ls -la .planning docs 2>/dev/null | head -20

If there's substantial markdown content (>5 files), ask:

I see existing planning docs at <paths>. Want to run /strata:bootstrap to migrate the durable content into the vault? It groups sibling files, dispatches workers in parallel, respects .gitignore + .strataignore. Takes a few minutes.

If they say yes, invoke /strata:bootstrap.

If there's nothing substantial, skip this step entirely. Don't ask.

Final message

Single line summary:

Strata is ready. Three commands cover the common workflows:
  /strata:save     — capture branch context
  /strata:decide   — record a chosen option
  /strata:propose  — track an open question

Everything else auto-invokes on intent.

Don't do

• Don't run the Graphify install yourself. Show the command, let the user run it.
• Don't run /strata:bootstrap unprompted. Even when planning docs exist, opt-in only. Bootstrap writes a lot of notes and should be a deliberate choice.
• Don't repeat the setup if the vault already exists. The prompts in steps 2 and 3 only fire on first init.
• Don't auto-invoke this skill if <vault>/<repo>/INDEX.md already exists. The SessionStart auto-init handles the silent path; this skill is for the explicit / first-time UX.