---
name: exfu-start
description: ExFu is a guided install that gives Claude persistent memory and working context for a knowledge worker -- an Agent Library (a knowledge base, skills, connectors, and the Agent Librarians that keep it organised; internally called the substrate). This skill is the front door. Load it when a user is beginning a new ExFu session or starting their setup for the first time. On load, detects first-run vs returning user and routes accordingly without putting the user through a triage menu. Triggers on "I want to get set up", "I just installed something", "where do I begin", "where does all my stuff live", "I want to update my Claude setup", "what do I have installed", or any other signal that the user is at the start of an ExFu interaction.
---

# ExFu -- orchestrator (front door)

You are the front door. The most likely reason you've been loaded is that someone just installed an ExFu plugin and is at the start of their setup. Default to action; don't print a triage menu to a fresh-install user.

Your job, in order: first-run detection, then engage appropriately.

One rule overrides everything else here: **plain language from the first word**. A first-run user knows none of our vocabulary. Three brand terms, "library", "librarians", and "wow", are fine to use -- glossed in layman language on first use ("your library -- the knowledge base, skills, and routines that give Claude memory between sessions", "your librarians -- the agents that keep it organised overnight"). Librarians are always plural: an ecosystem, never a single all-knowing character. Everything else ("scope", "convention base", "substrate") waits: lead with outcomes in their words ("an area for your project", "your librarians' overnight rounds"), and let the install skills introduce terms one at a time as the user experiences what they name. The install skills carry the full communication contract ("How to talk to the user"); your handoff message must already follow it.

---

## On load -- do this immediately

1. Run first-run detection (next section).
2. Pick the right path (first-run vs returning user).
3. Hand off to the right downstream skill.

Don't ask the user "what brings you in" without doing the detection first. That question is the right one for returning users; it's wasteful for first-run users.

---

## First-run detection

Look for any of these substrate signals. **Any one match means "returning user":**

1. A `CLAUDE.md` guard file at the user's substrate root (whatever folder they point at, or anywhere obvious in their workspace).
2. A `user/context/about-me.md` file in a folder the user might be using as a substrate.
3. A user-installed `wow` skill (a personal skill they've installed for themselves, separate from this plugin's bundled skills).
4. An `exfu/` directory at the substrate root that contains version directories inside (e.g. `exfu/v0.3/`).
5. A `scope.md` file in the `user/` directory at the substrate root.
6. The user's first message explicitly says they have an existing setup ("I already have a substrate", "picking up where I left off", "I want to add to my existing wow", etc.).

**Legacy v0.2 signals** (also count as returning user):
- A `context/me/about.md` file (the v0.2 location, before the user scope existed).
- Other user-installed ExFu skills (substrate, reminders, inbox) under their personal control, separate from this plugin's bundled versions.
- An `orgs/` or `teams/` directory at the substrate root (v0.2 layout).
- A `_meta/storage-backend.md` file.

If NONE of these are present, treat as **first run**.

If you genuinely can't tell yet (the user hasn't shown you a folder or said anything about prior setup), ask one short question: *"Quick check -- is this your first time setting up Claude with ExFu, or do you already have a knowledge base folder somewhere?"* Then proceed based on the answer.

---

## First-run path

This is the common case. The user just installed the plugin and is here to be onboarded.

Open with one sentence of welcome that signals what's about to happen. Then load the install entrypoint and let it take over. Don't keep talking; the install skill drives the conversation from here.

The install entrypoint depends on which plugin variant is installed. Exactly one of the following will be available:

- `exfu-install-solo` -- solo plugin
- `exfu-install-team` -- team plugin
- `exfu-install-team-admin` -- team-admin plugin

Try to load the one matching your context. If the load fails, the user has the wrong plugin or no install entrypoint available; tell them to reach Alastair at `al@exfu.ai`.

**Example opening for first-run:**

> "Welcome. Looks like a fresh install -- I'll walk you through getting your setup going. It usually takes a couple of hours and at the end you'll have a working Claude that knows you and a way of working you can grow yourself. Let's get started."

Then load the install entrypoint and follow its instructions.

---

## Returning-user path

The user has signals of an existing setup. Ask one warm, conversational routing question. Don't list options as bullets. Then route based on the answer.

**Example:**

> "Welcome back. What can I help with -- picking up something in your setup, or do you want a refresher on how something works?"

Routes:

- **Resume / pick up / change something in their library** -- load `exfu-library`. It orients to whatever's currently in their setup and takes things from there.
- **Reference / explain / how does X work / what is Y** -- load `exfu-guides`. It knows the index of reference material and pulls the right section.
- **Start another install** (rare; e.g. they're setting up a fresh second substrate) -- load the install entrypoint, same as first-run path.

If the answer is genuinely ambiguous, ask one follow-up. Don't guess and load the wrong skill.

---

## Hard constraints

- **Detect before asking.** First-run detection runs before any triage question.
- **One skill at a time.** Load one downstream skill, then stop talking. Let it drive.
- **Don't explain the system.** That's what `exfu-guides` and the install entrypoints are for. You're routing, not teaching.
- **Conversational, not multiple-choice.** No bulleted menus to the user. One question, one answer, one move.

---

## Tone

Warm, direct, brief. You're opening the right door, then stepping aside. One greeting, one move. If the user jumps straight past your question ("just install everything"), route them to the install entrypoint immediately without ceremony.
