@skill-map/cli 0.67.0 → 0.68.1

package/dist/cli/tutorial/sm-tutorial/references/_core.md

@@ -20,7 +20,7 @@ Two numbering systems coexist; keep them apart:
 
 - **Internal (authoring only)**: the `order` field in `_manifest.yml`
   and the `# Part N` file headers, 0-based (Part 0 the prologue …
-  Part 5 the CLI deep-dive; `mcp` at Part 6 is parked / hidden). Use it
+  Part 4 the CLI deep-dive; `mcp` at Part 5 is parked / hidden). Use it
   in `**Context**:` blocks and author
   notes; NEVER say it to the tester, it is off by one from what they
   see.
@@ -251,54 +251,103 @@ first kind quoted, the second kind never.
    command blocks assume the second terminal is anchored to the
    fixture folder.
 
-## Provider detection
-
-Skill-map ships built-in vendor providers, each walking its own
-on-disk convention:
-
-| Provider       | Base dir          | Kinds it claims             | Detect via env var(s)                                  |
-|----------------|-------------------|-----------------------------|--------------------------------------------------------|
-| `claude`       | `.claude/`        | `agent`, `command`, `skill` | `CLAUDECODE=1` OR `AI_AGENT` starts with `claude-code` |
-| `agent-skills` | `.agents/skills/` | `skill` only (vendor-neutral; also the on-disk home for Google's Antigravity CLI, which replaced the Gemini CLI on 2026-05-19 and adopted this open standard) | experimental (ships disabled; `sm tutorial --experimental` to offer it) |
-| `codex`       | `.codex/`         | `agent` (`.codex/agents/*.toml`) | experimental (ships disabled by default) |
-
-**Decision logic, applied silently during pre-flight**: the tutorial
-demonstrates the `claude` provider only. `agent-skills` and `codex`
-are **experimental** (ship disabled by default) and are not selectable
-here, so there is no runtime to detect or opt into.
-
-1. `provider = claude`, `<provider_dir> = .claude`, kinds =
-   `{agent, command, skill}`. Always.
-2. Do NOT offer Antigravity / agent-skills / codex as an alternative,
-   and do NOT ask the tester which runtime hosts them. If a tester
-   says they use another runtime, acknowledge it briefly and explain
-   that those providers are experimental, the tutorial demos `claude`
-   (`.claude/`) today:
-
-   > Heads up: skill-map also reads Antigravity, agent-skills and
-   > Codex projects, but those providers are experimental in this
-   > tutorial. We'll demo skill-map's Claude provider (`.claude/`)
-   > today.
-
-Persist `provider` into the state file (`tutorial.provider`) so a
-resumed session does not re-detect. (It is always `claude` for now.)
+## Provider detection (and the track it selects)
+
+A skill-map project reads its files through exactly ONE active lens
+(provider). The built-in providers and what each claims:
+
+| Provider       | Asset layout                              | Kinds                          | Connectors that form           | Marker             | Stability        | Track   |
+|----------------|-------------------------------------------|--------------------------------|--------------------------------|--------------------|------------------|---------|
+| `claude`       | `.claude/` (agents, commands, skills)     | agent, command, skill, markdown| `/` invokes, `@` mentions, refs| `.claude/`         | stable           | rich    |
+| `codex`        | `.codex/agents/*.toml` + `.agents/skills/`| agent (TOML), skill, markdown  | `/` invokes, `@` mentions, refs| `.codex/`          | beta             | rich    |
+| `antigravity`  | `.agents/skills/`                         | skill, markdown                | `/` invokes, refs              | `.agent/workflows/`| beta             | basic   |
+| `agent-skills` | `.agents/skills/`                         | skill, markdown                | refs only                      | `.agents/`         | stable (default) | basic   |
+
+`core/markdown` classifies every orphan `.md` under whatever lens is
+active; it is the universal base, never a selectable lens.
+
+**Two tracks, by capability** (the axis is "does the lens have an
+`agent` kind?"):
+
+- **rich** (`claude`, `codex`): agents + skills (+ commands on claude),
+  wired with `/` invocations and `@` mentions plus markdown references.
+- **basic** (`agent-skills`, `antigravity`): the open-standard family,
+  `skill` + `markdown` only, wired with **markdown references**
+  (`[text](path)`), the one connection the Agent Skills standard
+  documents. No `@`. `/` invocation is an Antigravity-only bonus, it is
+  NOT part of the neutral standard, so under the `agent-skills` lens only
+  references form.
+
+Why references and not slash on the open standard: the Agent Skills
+spec (agentskills.io) activates a skill by its `description` and
+connects files by relative markdown links; it has no `/`-invocation
+syntax. claude/codex add `/` and `@` as vendor features on top.
+
+**Decision logic, applied silently at pre-flight:**
+
+1. The provider is the lens the scaffold set up. Check the vendor markers
+   FIRST (they ride on top of the shared `.agents/skills/` skill home), then
+   the skill home itself:
+   - a `.codex/` dir present (the marker `sm tutorial --for codex` drops) →
+     `provider = codex`, `track = rich`.
+   - else a `.agent/workflows/` dir present → `provider = antigravity`,
+     `track = basic`.
+   - else skill under `.claude/skills/sm-tutorial/` → `provider = claude`,
+     `<provider_dir> = .claude`, `track = rich`.
+   - else skill under `.agents/skills/sm-tutorial/` → `provider = agent-skills`,
+     `<provider_dir> = .agents/skills`, `track = basic`.
+   **Lens ambiguity for codex / antigravity**: both adopt the open
+   `.agents/skills/` layout, so their own marker (`.codex/` or
+   `.agent/workflows/`) coexists with the `agent-skills` marker (`.agents/`)
+   and a plain `sm scan --yes` reports the lens as ambiguous. For those two,
+   set it explicitly once before the first scan, `sm config set
+   activeProvider <codex|antigravity> --yes`, then the book runs unchanged
+   (the fixture engine renders the right shape: codex its TOML agents +
+   command-as-skill, antigravity reuses the `agent-skills` overlays).
+2. `state.js init --provider <p>` persists `provider` plus the derived
+   `track`, so a resumed session never re-detects.
+3. Render only the parts whose `track` is `tutorial.track` (or `both`).
+   Never offer a rich-only part under the basic track, or vice versa.
 
 **Global substitution rule**: the fixture scripts do the file-level
 work. You pass `--provider <p>` (the value persisted in
 `tutorial.provider`) and `--lang <l>`, and they resolve the
-`__PROVIDER__` path token, skip files whose kind the provider does
-not claim, and report the adjusted `nodeCount` plus the `skipped`
-list in their summary. Today `provider` is always `claude`, so the
-narration uses `.claude/` throughout; the `--provider` plumbing stays
-wired so the coming-soon providers (`agent-skills` / Antigravity,
-`codex`) drop in later without a narrative rewrite. The campaign
-cross-link chapters target `claude` today (see the reality check
-below).
-
-**Reality check (don't mention to the tester)**: this skill ships
-at `.claude/skills/sm-tutorial/`, so Claude Code is the only host
-today. The detection wiring is here so mirrored skills at
-`.agents/skills/sm-tutorial/` reuse it as-is.
+`__PROVIDER__` path token, skip files whose kind the provider does not
+claim, lay any per-provider skill overlay (the open standard renders an
+agent/command as a `skill`), and report the adjusted `nodeCount` plus
+the `skipped` list. Narrate with `<provider_dir>` resolved to the value
+above, never a hard-coded `.claude/`.
+
+**Reality check (don't mention to the tester)**: the source skill ships
+at `.claude/skills/sm-tutorial/` (this repo is itself a Claude project);
+`sm tutorial` materializes it under `.claude/skills/` (rich) or
+`.agents/skills/` (basic). Both are real, walkable books.
+
+### Rendering the rich book on Codex
+
+The rich track has two lenses, `claude` and `codex`. They teach the SAME
+lessons with the SAME connectors (`/` invocations, `@` mentions, markdown
+references all resolve on both), so the rich part bodies are written in the
+`claude` shape; when `tutorial.provider == codex`, apply these substitutions:
+
+- **Agents are TOML.** A Codex agent is a single `.codex/agents/<name>.toml`
+  file (the prompt lives in its `developer_instructions` field), NOT a
+  `.claude/agents/<name>.md`. The fixtures lay them, so when a chapter says
+  "open the agent file" point at the `.toml`; a chapter that has the tester
+  read or tweak an agent works on the TOML frontmatter / `developer_instructions`.
+- **No `command` kind.** Where the claude book authors a `command` (the
+  `/publish` command, the reserved-name chapter's `init` command), Codex uses a
+  **skill** at `.agents/skills/<name>/SKILL.md`. The body is identical (same
+  `/check-links` + `@content-editor` + deploy reference); only the kind and path
+  change. `cat <set> --file … --provider codex` already returns the Codex skill
+  body, so the create-the-file block stays a copy-paste. The reserved-name beat
+  uses a skill named with a reserved verb (Codex inherits the open-standard
+  `COMMONS_RESERVED_NAMES`, e.g. `config`), exactly like the basic track's
+  `reserved` chapter, on a skill instead of a command.
+- **Skills** live under `.agents/skills/<name>/SKILL.md` (the open layout Codex
+  adopted), same as the basic family.
+- Everything else (the `@`/`/` syntax, the confidence numbers, the hub, the
+  broken-reference contrast) is identical to claude; the graph topology matches.
 
 ## Per-step cycle (inside a chapter)
 
@@ -357,10 +406,14 @@ For every chapter:
   parts with a `✓` in their description line, not on the title (see
   §Menu format).
 - **Which parts to list**: parts in `order`, `status: active` only
-  (`planned` parts are hidden). A part with a `seed` (the campaign
-  parts plus `cli`) is always shown, even out of order, its
-  `preflight: seed` fast-forwards the project into it (SKILL.md
-  §Entering a part). A part with a `prereq` but NO `seed` would be
+  (`planned` parts are hidden), AND **matching the active track**, a
+  part whose `track` is `tutorial.track` (`rich` or `basic`) or `both`.
+  The rich and basic campaigns share titles and `order`, so the track
+  filter is what keeps the menu showing exactly ONE book, never both;
+  list a part once, by the track the session resolved at pre-flight.
+  A part with a `seed` (the campaign parts plus `cli`) is always shown,
+  even out of order, its `preflight: seed` fast-forwards the project
+  into it (SKILL.md §Entering a part). A part with a `prereq` but NO `seed` would be
   shown only once its `prereq` is `done`; no active part is in that
   state today (`cli` used to be, now it self-seeds).
 - **After the tester picks**: walk that part; when it ends, run

package/dist/cli/tutorial/sm-tutorial/references/_manifest.json

@@ -9,6 +9,7 @@
       "seed": null,
       "prereq": null,
       "pace": "per-step",
+      "track": "rich",
       "chapters": [
         {
           "id": "init",
@@ -52,6 +53,59 @@
         }
       ]
     },
+    {
+      "id": "basic-fundamentals",
+      "order": 0,
+      "title": "The live map (prologue)",
+      "status": "active",
+      "preflight": "taught-init",
+      "seed": null,
+      "prereq": null,
+      "pace": "per-step",
+      "track": "basic",
+      "chapters": [
+        {
+          "id": "init",
+          "title": "Your first node (sm init, sm, the UI)",
+          "est_min": 2
+        },
+        {
+          "id": "kinds",
+          "title": "Skills and notes appear",
+          "est_min": 1
+        },
+        {
+          "id": "first-edit",
+          "title": "Your first edit (the watcher reacts)",
+          "est_min": 1
+        },
+        {
+          "id": "connectors",
+          "title": "Connect with references (markdown links)",
+          "est_min": 2
+        },
+        {
+          "id": "inspector",
+          "title": "The inspector and connections",
+          "est_min": 1
+        },
+        {
+          "id": "edit-link",
+          "title": "Edit a link, the topology changes",
+          "est_min": 3
+        },
+        {
+          "id": "workspace",
+          "title": "Navigate the workspace (files, search, isolate)",
+          "est_min": 2
+        },
+        {
+          "id": "ignore",
+          "title": "Silence a file via .skillmapignore",
+          "est_min": 2
+        }
+      ]
+    },
     {
       "id": "project-kickoff",
       "order": 1,
@@ -61,6 +115,7 @@
       "seed": null,
       "prereq": null,
       "pace": "per-step",
+      "track": "rich",
       "chapters": [
         {
           "id": "kickoff",
@@ -81,19 +136,7 @@
           "id": "real-kinds",
           "title": "The real kinds in context",
           "est_min": 2
-        }
-      ]
-    },
-    {
-      "id": "connect-harness",
-      "order": 2,
-      "title": "Connect the harness",
-      "status": "active",
-      "preflight": "seed",
-      "seed": "harness-built",
-      "prereq": "project-kickoff",
-      "pace": "auto-advance",
-      "chapters": [
+        },
         {
           "id": "check-links",
           "title": "The check-links skill",
@@ -116,15 +159,69 @@
         }
       ]
     },
+    {
+      "id": "basic-kickoff",
+      "order": 1,
+      "title": "The project from zero",
+      "status": "active",
+      "preflight": "portfolio-init",
+      "seed": null,
+      "prereq": null,
+      "pace": "per-step",
+      "track": "basic",
+      "chapters": [
+        {
+          "id": "kickoff",
+          "title": "Start the portfolio (sm init on the real skeleton)",
+          "est_min": 2
+        },
+        {
+          "id": "manual",
+          "title": "The handbook (AGENTS.md) and an entry pointer",
+          "est_min": 2
+        },
+        {
+          "id": "first-skill",
+          "title": "The first harness skill (content-editor)",
+          "est_min": 2
+        },
+        {
+          "id": "real-kinds",
+          "title": "The kinds in context",
+          "est_min": 2
+        },
+        {
+          "id": "check-links",
+          "title": "The link checker",
+          "est_min": 3
+        },
+        {
+          "id": "publish",
+          "title": "The publish skill references the harness",
+          "est_min": 4
+        },
+        {
+          "id": "links",
+          "title": "The handbook becomes the hub (references)",
+          "est_min": 4
+        },
+        {
+          "id": "confidence",
+          "title": "Connector confidence (opacity = certainty)",
+          "est_min": 3
+        }
+      ]
+    },
     {
       "id": "daily-loop",
-      "order": 3,
+      "order": 2,
       "title": "The daily loop (add, improve, publish)",
       "status": "active",
       "preflight": "seed",
       "seed": "harness-connected",
-      "prereq": "connect-harness",
+      "prereq": "project-kickoff",
       "pace": "auto-advance",
+      "track": "rich",
       "chapters": [
         {
           "id": "setup",
@@ -158,20 +255,69 @@
         },
         {
           "id": "golive",
-          "title": "Your portfolio, live next to the graph",
+          "title": "Your website, live next to the graph",
+          "est_min": 3
+        }
+      ]
+    },
+    {
+      "id": "basic-daily",
+      "order": 2,
+      "title": "The daily loop (add, improve, publish)",
+      "status": "active",
+      "preflight": "seed",
+      "seed": "harness-connected",
+      "prereq": "basic-kickoff",
+      "pace": "auto-advance",
+      "track": "basic",
+      "chapters": [
+        {
+          "id": "setup",
+          "title": "Make it yours and bring it up",
+          "est_min": 5
+        },
+        {
+          "id": "add-page",
+          "title": "Add a page with your skill",
+          "est_min": 4
+        },
+        {
+          "id": "broken-ref",
+          "title": "A rename breaks a link",
+          "est_min": 4
+        },
+        {
+          "id": "reserved",
+          "title": "A reserved name collides",
+          "est_min": 2
+        },
+        {
+          "id": "publish",
+          "title": "Ship it: run the publish skill for real",
+          "est_min": 4
+        },
+        {
+          "id": "stability",
+          "title": "Set a node's stability (and the `.sm` sidecar)",
+          "est_min": 3
+        },
+        {
+          "id": "golive",
+          "title": "Your website, live next to the graph",
           "est_min": 3
         }
       ]
     },
     {
       "id": "extend",
-      "order": 4,
+      "order": 3,
       "title": "Extend skill-map for the site",
       "status": "active",
       "preflight": "backstage-init",
       "seed": null,
       "prereq": null,
       "pace": "auto-advance",
+      "track": "both",
       "chapters": [
         {
           "id": "settings-1-layers",
@@ -232,13 +378,14 @@
     },
     {
       "id": "cli",
-      "order": 5,
+      "order": 4,
       "title": "The CLI in depth",
       "status": "active",
       "preflight": "seed",
       "seed": "prologue-built",
       "prereq": "fundamentals",
       "pace": "auto-advance",
+      "track": "both",
       "chapters": [
         {
           "id": "browse",
@@ -269,13 +416,14 @@
     },
     {
       "id": "mcp",
-      "order": 6,
+      "order": 5,
       "title": "MCP",
       "status": "planned",
       "preflight": "seed",
       "seed": "harness-connected",
-      "prereq": "connect-harness",
+      "prereq": "project-kickoff",
       "pace": "auto-advance",
+      "track": "rich",
       "chapters": [
         {
           "id": "mcp-node",

package/dist/cli/tutorial/sm-tutorial/references/_manifest.yml

@@ -27,6 +27,14 @@
 #   fixture      which fixture this part lays (see fixtures.md / the
 #                part body); `inline` means the chapters lay it as a
 #                taught step.
+#   track        which capability track shows this part (see _core.md
+#                §Provider detection): `rich` (claude/codex: agent +
+#                command + slash + `@`), `basic` (the open-standard
+#                family agent-skills/antigravity: skill + markdown,
+#                connected by markdown references), or `both` (renders
+#                lens-aware, slash/`@` on rich, references on basic).
+#                The menu shows only parts whose track is the resolved
+#                `tutorial.track` or `both`.
 #   status       active (default, shown) | planned (no body yet, hidden).
 
 parts:
@@ -39,6 +47,7 @@ parts:
     pace: per-step
     preflight: taught-init
     fixture: inline           # the chapters lay the basics fixture as taught steps
+    track: rich               # claude/codex prologue: agent/command kinds, slash + @ connectors
     status: active
     chapters:
       - id: init            ; title: "Your first node (sm init, sm, the UI)" ; est_min: 2
@@ -50,8 +59,27 @@ parts:
       - id: workspace       ; title: "Navigate the workspace (files, search, isolate)" ; est_min: 2
       - id: ignore          ; title: "Silence a file via .skillmapignore"  ; est_min: 2
 
+  - id: basic-fundamentals
+    order: 0
+    title: "The live map (prologue)"
+    step_file: part-basic-fundamentals.md
+    pace: per-step
+    preflight: taught-init    # same flavour as `fundamentals`; the boot node is demo-skill on the basic track
+    fixture: inline           # the chapters lay the basics fixture (skill + markdown only) as taught steps
+    track: basic              # open-standard family: skill + markdown, connected by markdown references
+    status: active
+    chapters:
+      - id: init            ; title: "Your first node (sm init, sm, the UI)" ; est_min: 2
+      - id: kinds           ; title: "Skills and notes appear"             ; est_min: 1
+      - id: first-edit      ; title: "Your first edit (the watcher reacts)" ; est_min: 1
+      - id: connectors      ; title: "Connect with references (markdown links)" ; est_min: 2
+      - id: inspector       ; title: "The inspector and connections"       ; est_min: 1
+      - id: edit-link       ; title: "Edit a link, the topology changes"   ; est_min: 3
+      - id: workspace       ; title: "Navigate the workspace (files, search, isolate)" ; est_min: 2
+      - id: ignore          ; title: "Silence a file via .skillmapignore"  ; est_min: 2
+
   - id: extend
-    order: 4
+    order: 3
     title: "Extend skill-map for the site"
     # Spans three chapter libraries; dispatch by chapter-id prefix:
     #   settings-*  -> part-settings.md
@@ -64,6 +92,7 @@ parts:
     pace: auto-advance
     preflight: backstage-init  # lays the fixture below + sm init --no-scan
     fixture: master            # master-agent / master-skill / notes/ideas (fixtures.md)
+    track: both                # settings / plugins / authoring are lens-agnostic
     status: active
     chapters:
       - id: settings-1-layers        ; title: "The config layers and `sm config list`" ; est_min: 3
@@ -79,13 +108,14 @@ parts:
       - id: authoring-5-doctor-author ; title: "Catch a manifest mistake with `sm plugins doctor`" ; est_min: 2
 
   - id: cli
-    order: 5
+    order: 4
     title: "The CLI in depth"
     step_file: part-cli.md
     pace: auto-advance
     preflight: seed            # self-seeds the Part 0 demo fixture
     seed: prologue-built       # the prologue demo fixture (not the cumulative portfolio)
     prereq: fundamentals       # recommended predecessor; cli self-seeds, so it is always shown
+    track: both                # CLI verbs are lens-agnostic; prose notes lens-specific node counts
     status: active
     chapters:
       - id: browse           ; title: "list / show / check" ; est_min: 3
@@ -108,37 +138,28 @@ parts:
     pace: per-step
     preflight: portfolio-init   # lays the Express skeleton + AGENTS.md; clears the prologue demo fixture if present
     fixture: portfolio
+    track: rich                 # uses the agent kind; basic track has its own counterpart
     status: active
     chapters:
       - id: kickoff     ; title: "Start the portfolio (sm init on the real skeleton)" ; est_min: 2
       - id: manual      ; title: "The handbook (AGENTS.md) and CLAUDE.md" ; est_min: 2
       - id: first-agent ; title: "The first harness agent (content-editor)" ; est_min: 2
       - id: real-kinds  ; title: "The real kinds in context" ; est_min: 2
-
-  - id: connect-harness
-    order: 2
-    title: "Connect the harness"
-    step_file: part-connect-harness.md
-    pace: auto-advance
-    preflight: seed
-    seed: harness-built     # fast-forward to here if project-kickoff is not done
-    prereq: project-kickoff
-    status: active
-    chapters:
       - id: check-links ; title: "The check-links skill" ; est_min: 2
       - id: publish     ; title: "The /publish command invokes the skill" ; est_min: 3
       - id: links       ; title: "Mentions (@) and references between assets" ; est_min: 3
       - id: confidence  ; title: "Connector confidence (opacity = certainty)" ; est_min: 2
 
   - id: daily-loop
-    order: 3
+    order: 2
     title: "The daily loop (add, improve, publish)"   # the campaign finale
     step_file: part-daily-loop.md
     pace: auto-advance
     preflight: seed
-    seed: harness-connected   # fast-forward to here if the earlier parts are not done
-    prereq: connect-harness
+    seed: harness-connected   # fast-forward to here if project-kickoff is not done
+    prereq: project-kickoff
     fixture: portfolio        # reuses the wired harness; lays the pretty site (style.css + pages) as taught steps
+    track: rich               # agent-driven page add + reserved command; basic track has its own counterpart
     status: active
     chapters:
       - id: setup            ; title: "Make it yours and bring it up" ; est_min: 5
@@ -147,17 +168,62 @@ parts:
       - id: reserved         ; title: "A reserved name collides" ; est_min: 2
       - id: publish          ; title: "Ship it: run /publish for real" ; est_min: 4
       - id: stability        ; title: "Set a node's stability (and the `.sm` sidecar)" ; est_min: 3
-      - id: golive           ; title: "Your portfolio, live next to the graph" ; est_min: 3
+      - id: golive           ; title: "Your website, live next to the graph" ; est_min: 3
+
+  # ----- the basic-track campaign (open-standard family: agent-skills / antigravity) -----
+  # Mirrors the rich campaign arc with skill + markdown only, connected by
+  # markdown references. Same fixtures (portfolio / harness) laid under the
+  # basic provider, which renders the agent/command nodes as skills.
+
+  - id: basic-kickoff
+    order: 1
+    title: "The project from zero"
+    step_file: part-basic-kickoff.md
+    pace: per-step
+    preflight: portfolio-init
+    fixture: portfolio
+    track: basic
+    status: active
+    chapters:
+      - id: kickoff      ; title: "Start the portfolio (sm init on the real skeleton)" ; est_min: 2
+      - id: manual       ; title: "The handbook (AGENTS.md) and an entry pointer" ; est_min: 2
+      - id: first-skill  ; title: "The first harness skill (content-editor)" ; est_min: 2
+      - id: real-kinds   ; title: "The kinds in context" ; est_min: 2
+      - id: check-links ; title: "The link checker" ; est_min: 3
+      - id: publish     ; title: "The publish skill references the harness" ; est_min: 4
+      - id: links       ; title: "The handbook becomes the hub (references)" ; est_min: 4
+      - id: confidence  ; title: "Connector confidence (opacity = certainty)" ; est_min: 3
+
+  - id: basic-daily
+    order: 2
+    title: "The daily loop (add, improve, publish)"
+    step_file: part-basic-daily.md
+    pace: auto-advance
+    preflight: seed
+    seed: harness-connected
+    prereq: basic-kickoff
+    fixture: portfolio
+    track: basic
+    status: active
+    chapters:
+      - id: setup       ; title: "Make it yours and bring it up" ; est_min: 5
+      - id: add-page    ; title: "Add a page with your skill" ; est_min: 4
+      - id: broken-ref  ; title: "A rename breaks a link" ; est_min: 4
+      - id: reserved    ; title: "A reserved name collides" ; est_min: 2
+      - id: publish     ; title: "Ship it: run the publish skill for real" ; est_min: 4
+      - id: stability   ; title: "Set a node's stability (and the `.sm` sidecar)" ; est_min: 3
+      - id: golive      ; title: "Your website, live next to the graph" ; est_min: 3
 
   # ----- parked: MCP returns later as its own iteration (body kept in part-mcp.md) -----
   - id: mcp
-    order: 6
+    order: 5
     title: "MCP"
     step_file: part-mcp.md
     pace: auto-advance
     preflight: seed
     seed: harness-connected
-    prereq: connect-harness
+    prereq: project-kickoff
+    track: rich               # MCP tool declaration sits on an agent/command body
     status: planned           # temporarily disabled, hidden from the menu. Body exists; re-enable when MCP returns.
     chapters:
       - id: mcp-node ; title: "content-editor declares an MCP tool; the mcp:// node appears" ; est_min: 3

package/dist/cli/tutorial/sm-tutorial/references/fixtures.md

@@ -38,10 +38,10 @@ fixtures-data/
 |---|---|---|
 | `universal` | `.skillmapignore`, `findings.md` | pre-flight |
 | `prologue` | the seven Part 0 demo nodes | Part 0 (progressive, `--only`), `prologue-built` seed |
-| `portfolio` | Express skeleton, handbook, `content-editor`, `docs/STYLE` + `DEPLOY` | Part 1 (`--only` boot, chapters lay the rest), `harness-*` seeds |
-| `harness` | `check-links` skill, `publish` command | Part 2 chapters, `harness-connected` seed |
-| `master` | `master-agent`, `master-skill`, `notes/ideas` | Part 4 `backstage-init` |
-| `cli-external` | `link-validation/hijoA` + `hijoB` | Part 5 `reference-paths` |
+| `portfolio` | Express skeleton, handbook, `content-editor`, `docs/STYLE` + `DEPLOY` | Part 1 (`--only` boot, chapters lay the rest), `harness-connected` seed |
+| `harness` | `check-links` skill, `publish` command | Part 1 connect chapters, `harness-connected` seed |
+| `master` | `master-agent`, `master-skill`, `notes/ideas` | Part 3 `backstage-init` |
+| `cli-external` | `link-validation/hijoA` + `hijoB` | Part 4 `reference-paths` |
 
 ## Edits (append fragments)
 
@@ -62,9 +62,8 @@ entered out of order.
 
 | Seed | Lays | Edits | Drops |
 |---|---|---|---|
-| `prologue-built` (Part 5) | `prologue` | `todo-connectors` | `notes/private-credentials.md` |
-| `harness-built` (Part 2) | `portfolio` | , | , |
-| `harness-connected` (Part 3) | `portfolio` + `harness` | `agents-hub`, `content-editor-style` | , |
+| `prologue-built` (Part 4) | `prologue` | `todo-connectors` | `notes/private-credentials.md` |
+| `harness-connected` (Part 2) | `portfolio` + `harness` | `agents-hub`, `content-editor-style` | , |
 
 ## Footprints (what `clear` and `wipe` remove)