init

name	init
description	First-time setup or upgrade for the learning-loop plugin. Configures vault path, persona voice, CLAUDE.md integration, and verifies the installation. Hands federation off to /learning-loop:federation. Safe to re-run: detects existing state and skips completed steps.

Init: Learning Loop Setup

Seven-phase detect-confirm-apply flow. One question at a time. Safe to re-run: detects existing state and skips completed steps.

All operations use Node.js APIs (fs, path, child_process). No bash find, no shell globbing for detection.

Paths

PLUGIN, PLUGIN_DATA, and VAULT are injected by the session-start hook (see "Learning Loop Paths" in your context). Use those resolved values for ALL path references in the phase files. If not present, resolve them by running:

node PLUGIN/scripts/resolve-paths.mjs

Process

Read each phase file in order and execute its instructions. After Phase 1's dashboard, only enter the phases the dashboard reports as needing work.

1. Read PLUGIN/skills/init/phases/01-detect.md -- detect state, present dashboard. If everything is configured, stop here.
2. Read PLUGIN/skills/init/phases/02-vault.md -- vault path, folders, system files.
3. Read PLUGIN/skills/init/phases/03-binary.md -- binary, vendor deps, orphan cleanup, index, shims, plugin deps.
4. Read PLUGIN/skills/init/phases/04-federation.md -- single yes/no, hands off to /learning-loop:federation for the full flow.
5. Read PLUGIN/skills/init/phases/05-claudemd.md -- CLAUDE.md integration.
6. Read PLUGIN/skills/init/phases/06-cache-health.md -- optional cache-health statusline.
7. Read PLUGIN/skills/init/phases/07-librarian.md -- optional librarian background agent.

After all phases complete, present the summary below.

Summary

Learning loop configured.

  Vault:        [path] ([N] notes)
  Folders:      [N]/7 present
  Binary:       ll-search vX.Y
  Search:       [N] notes indexed
  Federation:   [configured | deferred to /learning-loop:federation | not requested]
  CLAUDE.md:    [status]
  Cache health: [installed | skipped: oh-my-claude not found]
  Librarian:    [enabled | skipped: ollama/hardware not available]
  Shims:        ll-watch + ll-search installed in ~/.local/bin

Start the watcher with: ll-watch
Run /learning-loop:help to see available commands.

Rules

• One question at a time. Wait for the answer before moving on.
• Validate paths before writing config.
• Never overwrite existing vault files without asking.
• Never restructure an existing vault.
• Preserve existing config.json fields when updating: read, merge, write.
• All detection via Node.js APIs. No find, no shell globbing.
• If any step fails, explain what went wrong and how to fix it.
• Works for: fresh install, existing vault + new plugin, or upgrade.