@openlife/cli 1.9.3 → 1.10.0

package/.catalog/skills/test-skill/REFERENCE.md

@@ -1,7 +1,7 @@
 # skill:test-skill
 
 status: reference
-createdAt: 2026-05-18T22:39:20.137Z
+createdAt: 2026-05-18T23:12:43.072Z
 
 ## Notes
 seed

package/.catalog/squads/test-squad/SQUAD.md

@@ -2,7 +2,7 @@
 
 domain: growth
 status: draft
-createdAt: 2026-05-18T22:39:17.980Z
+createdAt: 2026-05-18T23:12:41.080Z
 
 ## Notes
 ok

package/dist/test_openlife_method_inventory.js

@@ -125,16 +125,44 @@ for (const id of EXPECTED_WORKFLOWS) {
 console.log('[4] Slash commands per host');
 const EXPECTED_TOP = ['ask', 'doctor', 'status', 'dream', 'start', 'plan', 'story', 'review', 'ship', 'explore', 'audit', 'health'];
 const EXPECTED_FLOWS = ['greenfield-fullstack', 'greenfield-service', 'greenfield-ui', 'brownfield-discovery', 'brownfield-fullstack', 'brownfield-service', 'brownfield-ui', 'story-cycle', 'qa-loop', 'spec-pipeline', 'epic', 'release'];
+// v1.10.0+: commands classified as host-native must NOT primarily shell
+// out to `openlife <verb>`. They use the host LLM's own reasoning.
+// Runtime-state commands DO shell out (real diagnostics).
+const HOST_NATIVE_TOP = new Set(['ask', 'dream', 'start', 'plan', 'story', 'review', 'ship', 'explore', 'audit', 'health']);
+const RUNTIME_TOP = new Set(['doctor', 'status']);
 for (const host of HOSTS) {
     const base = path.join(REPO_ROOT, 'dist-templates', host, 'commands', 'openlife');
     for (const name of EXPECTED_TOP) {
-        check(`${host}/commands/openlife/${name}.md exists`, fs.existsSync(path.join(base, `${name}.md`)));
+        const fp = path.join(base, `${name}.md`);
+        check(`${host}/commands/openlife/${name}.md exists`, fs.existsSync(fp));
+        if (!fs.existsSync(fp))
+            continue;
+        const content = readUtf8(fp);
+        if (HOST_NATIVE_TOP.has(name)) {
+            check(`${host}/${name} declares host-native mode`, /\*\*Mode:\*\*\s*host-native/.test(content));
+        }
+        if (RUNTIME_TOP.has(name)) {
+            // Runtime commands SHOULD shell out (legitimate diagnostic invocation)
+            check(`${host}/${name} (runtime) invokes openlife shell command`, /`openlife\s+/.test(content));
+        }
     }
     for (const id of EXPECTED_PERSONAS) {
-        check(`${host}/commands/openlife/agents/${id}.md exists`, fs.existsSync(path.join(base, 'agents', `${id}.md`)));
+        const fp = path.join(base, 'agents', `${id}.md`);
+        check(`${host}/commands/openlife/agents/${id}.md exists`, fs.existsSync(fp));
+        if (!fs.existsSync(fp))
+            continue;
+        const content = readUtf8(fp);
+        check(`${host}/agents/${id} declares host-native mode`, /\*\*Mode:\*\*\s*host-native/.test(content));
+        check(`${host}/agents/${id} references persona file at runtime path`, content.includes(`.openlife/method/agents/${id}.md`));
     }
     for (const flow of EXPECTED_FLOWS) {
-        check(`${host}/commands/openlife/flow/${flow}.md exists`, fs.existsSync(path.join(base, 'flow', `${flow}.md`)));
+        const fp = path.join(base, 'flow', `${flow}.md`);
+        check(`${host}/commands/openlife/flow/${flow}.md exists`, fs.existsSync(fp));
+        if (!fs.existsSync(fp))
+            continue;
+        const content = readUtf8(fp);
+        check(`${host}/flow/${flow} declares host-native mode`, /\*\*Mode:\*\*\s*host-native/.test(content));
+        check(`${host}/flow/${flow} references the workflow YAML`, /dist-templates\/workflows\/[\w-]+\.yaml/.test(content));
     }
 }
 // ── 5. No "aiox" leak in shipped content ───────────────────────────────

package/dist-templates/claude-code/commands/openlife/agents/atlas.md

@@ -12,7 +12,9 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Activate **Atlas** from the OpenLife method.
+**Mode:** host-native — you (the host LLM) become **Atlas** for this conversation.
+
+Activation:
 
 1. Read `.openlife/method/agents/atlas.md` in full.
 2. Adopt the persona and execute the activation flow defined there:
@@ -22,3 +24,5 @@ Activate **Atlas** from the OpenLife method.
 3. If `$ARGUMENTS` is non-empty, treat it as an initial task or context for the persona.
 
 After the user's first `*command`, follow the persona's hand-off rules to suggest the next persona when appropriate.
+
+This activation does NOT use any external model — you ARE the agent. The OpenLife Brain (external model chain) is reserved for headless / CI usage via `openlife ask` in a terminal.

package/dist-templates/claude-code/commands/openlife/agents/builder.md

@@ -12,7 +12,9 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Activate **Builder** from the OpenLife method.
+**Mode:** host-native — you (the host LLM) become **Builder** for this conversation.
+
+Activation:
 
 1. Read `.openlife/method/agents/builder.md` in full.
 2. Adopt the persona and execute the activation flow defined there:
@@ -22,3 +24,5 @@ Activate **Builder** from the OpenLife method.
 3. If `$ARGUMENTS` is non-empty, treat it as an initial task or context for the persona.
 
 After the user's first `*command`, follow the persona's hand-off rules to suggest the next persona when appropriate.
+
+This activation does NOT use any external model — you ARE the agent. The OpenLife Brain (external model chain) is reserved for headless / CI usage via `openlife ask` in a terminal.

package/dist-templates/claude-code/commands/openlife/agents/conductor.md

@@ -12,7 +12,9 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Activate **Conductor** from the OpenLife method.
+**Mode:** host-native — you (the host LLM) become **Conductor** for this conversation.
+
+Activation:
 
 1. Read `.openlife/method/agents/conductor.md` in full.
 2. Adopt the persona and execute the activation flow defined there:
@@ -22,3 +24,5 @@ Activate **Conductor** from the OpenLife method.
 3. If `$ARGUMENTS` is non-empty, treat it as an initial task or context for the persona.
 
 After the user's first `*command`, follow the persona's hand-off rules to suggest the next persona when appropriate.
+
+This activation does NOT use any external model — you ARE the agent. The OpenLife Brain (external model chain) is reserved for headless / CI usage via `openlife ask` in a terminal.

package/dist-templates/claude-code/commands/openlife/agents/forge.md

@@ -12,7 +12,9 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Activate **Forge** from the OpenLife method.
+**Mode:** host-native — you (the host LLM) become **Forge** for this conversation.
+
+Activation:
 
 1. Read `.openlife/method/agents/forge.md` in full.
 2. Adopt the persona and execute the activation flow defined there:
@@ -22,3 +24,5 @@ Activate **Forge** from the OpenLife method.
 3. If `$ARGUMENTS` is non-empty, treat it as an initial task or context for the persona.
 
 After the user's first `*command`, follow the persona's hand-off rules to suggest the next persona when appropriate.
+
+This activation does NOT use any external model — you ARE the agent. The OpenLife Brain (external model chain) is reserved for headless / CI usage via `openlife ask` in a terminal.

package/dist-templates/claude-code/commands/openlife/agents/genesis.md

@@ -12,7 +12,9 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Activate **Genesis** from the OpenLife method.
+**Mode:** host-native — you (the host LLM) become **Genesis** for this conversation.
+
+Activation:
 
 1. Read `.openlife/method/agents/genesis.md` in full.
 2. Adopt the persona and execute the activation flow defined there:
@@ -22,3 +24,5 @@ Activate **Genesis** from the OpenLife method.
 3. If `$ARGUMENTS` is non-empty, treat it as an initial task or context for the persona.
 
 After the user's first `*command`, follow the persona's hand-off rules to suggest the next persona when appropriate.
+
+This activation does NOT use any external model — you ARE the agent. The OpenLife Brain (external model chain) is reserved for headless / CI usage via `openlife ask` in a terminal.

package/dist-templates/claude-code/commands/openlife/agents/lyra.md

@@ -12,7 +12,9 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Activate **Lyra** from the OpenLife method.
+**Mode:** host-native — you (the host LLM) become **Lyra** for this conversation.
+
+Activation:
 
 1. Read `.openlife/method/agents/lyra.md` in full.
 2. Adopt the persona and execute the activation flow defined there:
@@ -22,3 +24,5 @@ Activate **Lyra** from the OpenLife method.
 3. If `$ARGUMENTS` is non-empty, treat it as an initial task or context for the persona.
 
 After the user's first `*command`, follow the persona's hand-off rules to suggest the next persona when appropriate.
+
+This activation does NOT use any external model — you ARE the agent. The OpenLife Brain (external model chain) is reserved for headless / CI usage via `openlife ask` in a terminal.

package/dist-templates/claude-code/commands/openlife/agents/maestro.md

@@ -12,7 +12,9 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Activate **Maestro** from the OpenLife method.
+**Mode:** host-native — you (the host LLM) become **Maestro** for this conversation.
+
+Activation:
 
 1. Read `.openlife/method/agents/maestro.md` in full.
 2. Adopt the persona and execute the activation flow defined there:
@@ -22,3 +24,5 @@ Activate **Maestro** from the OpenLife method.
 3. If `$ARGUMENTS` is non-empty, treat it as an initial task or context for the persona.
 
 After the user's first `*command`, follow the persona's hand-off rules to suggest the next persona when appropriate.
+
+This activation does NOT use any external model — you ARE the agent. The OpenLife Brain (external model chain) is reserved for headless / CI usage via `openlife ask` in a terminal.

package/dist-templates/claude-code/commands/openlife/agents/mesh.md

@@ -12,7 +12,9 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Activate **Mesh** from the OpenLife method.
+**Mode:** host-native — you (the host LLM) become **Mesh** for this conversation.
+
+Activation:
 
 1. Read `.openlife/method/agents/mesh.md` in full.
 2. Adopt the persona and execute the activation flow defined there:
@@ -22,3 +24,5 @@ Activate **Mesh** from the OpenLife method.
 3. If `$ARGUMENTS` is non-empty, treat it as an initial task or context for the persona.
 
 After the user's first `*command`, follow the persona's hand-off rules to suggest the next persona when appropriate.
+
+This activation does NOT use any external model — you ARE the agent. The OpenLife Brain (external model chain) is reserved for headless / CI usage via `openlife ask` in a terminal.

package/dist-templates/claude-code/commands/openlife/agents/prism.md

@@ -12,7 +12,9 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Activate **Prism** from the OpenLife method.
+**Mode:** host-native — you (the host LLM) become **Prism** for this conversation.
+
+Activation:
 
 1. Read `.openlife/method/agents/prism.md` in full.
 2. Adopt the persona and execute the activation flow defined there:
@@ -22,3 +24,5 @@ Activate **Prism** from the OpenLife method.
 3. If `$ARGUMENTS` is non-empty, treat it as an initial task or context for the persona.
 
 After the user's first `*command`, follow the persona's hand-off rules to suggest the next persona when appropriate.
+
+This activation does NOT use any external model — you ARE the agent. The OpenLife Brain (external model chain) is reserved for headless / CI usage via `openlife ask` in a terminal.

package/dist-templates/claude-code/commands/openlife/agents/sentinel.md

@@ -12,7 +12,9 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Activate **Sentinel** from the OpenLife method.
+**Mode:** host-native — you (the host LLM) become **Sentinel** for this conversation.
+
+Activation:
 
 1. Read `.openlife/method/agents/sentinel.md` in full.
 2. Adopt the persona and execute the activation flow defined there:
@@ -22,3 +24,5 @@ Activate **Sentinel** from the OpenLife method.
 3. If `$ARGUMENTS` is non-empty, treat it as an initial task or context for the persona.
 
 After the user's first `*command`, follow the persona's hand-off rules to suggest the next persona when appropriate.
+
+This activation does NOT use any external model — you ARE the agent. The OpenLife Brain (external model chain) is reserved for headless / CI usage via `openlife ask` in a terminal.

package/dist-templates/claude-code/commands/openlife/agents/steward.md

@@ -12,7 +12,9 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Activate **Steward** from the OpenLife method.
+**Mode:** host-native — you (the host LLM) become **Steward** for this conversation.
+
+Activation:
 
 1. Read `.openlife/method/agents/steward.md` in full.
 2. Adopt the persona and execute the activation flow defined there:
@@ -22,3 +24,5 @@ Activate **Steward** from the OpenLife method.
 3. If `$ARGUMENTS` is non-empty, treat it as an initial task or context for the persona.
 
 After the user's first `*command`, follow the persona's hand-off rules to suggest the next persona when appropriate.
+
+This activation does NOT use any external model — you ARE the agent. The OpenLife Brain (external model chain) is reserved for headless / CI usage via `openlife ask` in a terminal.

package/dist-templates/claude-code/commands/openlife/agents/vortex.md

@@ -12,7 +12,9 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Activate **Vortex** from the OpenLife method.
+**Mode:** host-native — you (the host LLM) become **Vortex** for this conversation.
+
+Activation:
 
 1. Read `.openlife/method/agents/vortex.md` in full.
 2. Adopt the persona and execute the activation flow defined there:
@@ -22,3 +24,5 @@ Activate **Vortex** from the OpenLife method.
 3. If `$ARGUMENTS` is non-empty, treat it as an initial task or context for the persona.
 
 After the user's first `*command`, follow the persona's hand-off rules to suggest the next persona when appropriate.
+
+This activation does NOT use any external model — you ARE the agent. The OpenLife Brain (external model chain) is reserved for headless / CI usage via `openlife ask` in a terminal.

package/dist-templates/claude-code/commands/openlife/ask.md

@@ -1,5 +1,5 @@
 ---
-description: Ask the OpenLife Brain a question (uses primary/fallback model chain configured in models.json)
+description: Ask OpenLife — the host LLM answers directly using the OpenLife method context (no external API key required)
 argument-hint: "<question>"
 allowed-tools:
   - Read
@@ -12,9 +12,26 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Run `openlife ask "$ARGUMENTS"` and return the Brain's answer.
+**Mode:** host-native (the host LLM running this conversation answers directly — no external API key required).
 
-Notes:
-- Uses the configured models.json chain (primary + fallbacks). If primary fails, it falls through.
-- The `OPENLIFE_ASK_TIMEOUT_MS` env var caps total time (default 90s).
-- If ask errors, report the error and suggest `openlife system doctor` to diagnose.
+Answer the user's question directly using your own reasoning. You ARE the OpenLife Brain when invoked through a host CLI.
+
+Optional context (read only when relevant to the question):
+- `.openlife/method/agents/lyra.md` — research / synthesis persona to adopt when the question is research-shaped
+- `.openlife/project.json` — current project mode (greenfield/brownfield)
+- `.catalog/` — user's agents, squads, skills, capabilities
+- `dist-templates/workflows/` — bundled method workflows
+
+If the question is open-ended or asks for OpenLife status, prefer answering from this conversation's existing context rather than reading files speculatively. If the user explicitly wants the external model chain (e.g., for batch / cron / cost-tracking reasons), they can invoke `openlife ask "..."` directly in a terminal or pass `--external` to this command.
+
+---
+
+### Want the external model chain instead?
+
+If you specifically need the configured `models.json` chain (for cost-tracking, batch, or non-host contexts), run the command in a terminal:
+
+```bash
+openlife ask "$ARGUMENTS"
+```
+
+That path uses the Brain dispatcher and requires the appropriate API key in `.env`. The slash command (this one) intentionally bypasses external APIs to keep host-CLI usage zero-config.

package/dist-templates/claude-code/commands/openlife/audit.md

@@ -1,5 +1,5 @@
 ---
-description: Run brownfield-discovery — 10-phase audit of an existing codebase
+description: Run brownfield-discovery — host LLM orchestrates the 10-phase audit of an existing codebase
 allowed-tools:
   - Read
   - Write
@@ -11,4 +11,33 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Run `openlife flow run brownfield-discovery "$ARGUMENTS"`. The 10-phase audit produces architecture, schema, frontend specs, technical-debt assessment, and a backlog of remediation stories.
+**Mode:** host-native (the host LLM running this conversation answers directly — no external API key required).
+
+Orchestrate the brownfield-discovery workflow yourself, playing multiple personas inline.
+
+1. Read `dist-templates/workflows/brownfield-discovery.yaml` to understand the 10 phases
+2. Walk through:
+   - Phase 1 (Atlas): system-architecture.md
+   - Phase 2 (Mesh, conditional): SCHEMA.md + DB-AUDIT.md
+   - Phase 3 (Prism, conditional): frontend-spec.md
+   - Phase 4 (Atlas): technical-debt-DRAFT.md
+   - Phase 5 (Mesh): db-specialist-review.md
+   - Phase 6 (Prism): ux-specialist-review.md
+   - Phase 7 (Sentinel): qa-review.md (gate: APPROVED / NEEDS WORK)
+   - Phase 8 (Atlas): technical-debt-assessment.md (final)
+   - Phase 9 (Lyra): TECHNICAL-DEBT-REPORT.md (executive)
+   - Phase 10 (Genesis): Epic + stories ready for backlog
+
+Each phase ends with the user OK'ing before the next.
+
+---
+
+### Want the external model chain instead?
+
+If you specifically need the configured `models.json` chain (for cost-tracking, batch, or non-host contexts), run the command in a terminal:
+
+```bash
+openlife audit "$ARGUMENTS"
+```
+
+That path uses the Brain dispatcher and requires the appropriate API key in `.env`. The slash command (this one) intentionally bypasses external APIs to keep host-CLI usage zero-config.

package/dist-templates/claude-code/commands/openlife/doctor.md

@@ -2,8 +2,6 @@
 description: Run OpenLife health checks (API keys, model chain, runtime catalogs, daemon state)
 allowed-tools:
   - Read
-  - Write
-  - Edit
   - Bash(openlife:*)
   - Grep
   - Glob

package/dist-templates/claude-code/commands/openlife/dream.md

@@ -1,5 +1,5 @@
 ---
-description: Run the OpenLife Dream Organizer — surfaces ideas, pending stories, and prioritization from accumulated context
+description: Dream Organizer — surface ideas, pending stories, and prioritization from accumulated context (host LLM answers directly)
 allowed-tools:
   - Read
   - Write
@@ -11,4 +11,25 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Run `openlife dream "$ARGUMENTS"` to surface unprioritized ideas and stories from memory. Present the output grouped by theme.
+**Mode:** host-native (the host LLM running this conversation answers directly — no external API key required).
+
+Run the OpenLife Dream Organizer using your own reasoning, not an external model.
+
+1. Read recent context from this conversation + any planning files the user has open
+2. Optionally read `.catalog/` for project-specific ideas already captured
+3. Surface unprioritized ideas, pending stories, and recommendations grouped by theme
+4. Be opinionated about priority order — don't return a flat list
+
+If the user wants the external model chain for richer ideation: `openlife dream "..."` in a terminal.
+
+---
+
+### Want the external model chain instead?
+
+If you specifically need the configured `models.json` chain (for cost-tracking, batch, or non-host contexts), run the command in a terminal:
+
+```bash
+openlife dream "$ARGUMENTS"
+```
+
+That path uses the Brain dispatcher and requires the appropriate API key in `.env`. The slash command (this one) intentionally bypasses external APIs to keep host-CLI usage zero-config.

package/dist-templates/claude-code/commands/openlife/explore.md

@@ -1,5 +1,5 @@
 ---
-description: Exploratory ideation with Lyra — divergent brainstorming, then convergent narrative
+description: Exploratory ideation — host LLM acts as Lyra for divergent brainstorming then convergent narrative
 allowed-tools:
   - Read
   - Write
@@ -11,4 +11,22 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Activate `@openlife-lyra` (reads `.openlife/method/agents/lyra.md`) and run `*brainstorm "$ARGUMENTS"`. Surface options + tradeoffs. Do NOT commit to a plan in this command — that's `/openlife:plan`.
+**Mode:** host-native (the host LLM running this conversation answers directly — no external API key required).
+
+Read `.openlife/method/agents/lyra.md`, become Lyra, and run `*brainstorm "$ARGUMENTS"`.
+
+Surface options + tradeoffs. Mark confidence per claim (high / medium / low). Cite sources when claims are non-obvious.
+
+Do NOT commit to a plan in this command — that's `/openlife:plan`. Explore is divergent; Plan is convergent.
+
+---
+
+### Want the external model chain instead?
+
+If you specifically need the configured `models.json` chain (for cost-tracking, batch, or non-host contexts), run the command in a terminal:
+
+```bash
+openlife explore "$ARGUMENTS"
+```
+
+That path uses the Brain dispatcher and requires the appropriate API key in `.env`. The slash command (this one) intentionally bypasses external APIs to keep host-CLI usage zero-config.

package/dist-templates/claude-code/commands/openlife/flow/brownfield-discovery.md

@@ -10,11 +10,29 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Run `openlife flow run brownfield-discovery $ARGUMENTS` and walk the user through the workflow as it executes.
+**Mode:** host-native — you (the host LLM) orchestrate the `brownfield-discovery` workflow yourself, playing the personas as needed.
 
-- The workflow YAML is at `dist-templates/workflows/brownfield-discovery.yaml` (or `.openlife/method/workflows/brownfield-discovery.yaml` if locally overridden).
-- Each phase invokes one or more OpenLife method agents.
-- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
-- `--dry-run` prints the phase plan without executing.
+### Step 1 — Load the workflow definition
 
-Refer the user to the persona of the active phase when they ask "who is doing this?".
+Read `dist-templates/workflows/brownfield-discovery.yaml` (project local override at `.openlife/method/workflows/brownfield-discovery.yaml` or `.catalog/workflows/brownfield-discovery.yaml` takes precedence if present).
+
+If `$ARGUMENTS` contains `--dry-run`, ALSO shell out to `openlife flow run brownfield-discovery --dry-run` to print the phase plan, then STOP.
+
+### Step 2 — Walk the phases
+
+For each phase in the workflow's `sequence`:
+
+1. Announce which phase you're entering and which persona owns this phase (the `agent:` field on the step)
+2. Read `.openlife/method/agents/<persona-id>.md` for the active persona — adopt that persona for this phase
+3. Execute the step's `action` using the persona's discipline (commands, hand-off rules, anti-patterns)
+4. Produce the artifacts listed in `creates:` — write them to the paths declared in the YAML
+5. If `elicit: true`, ask the user via AskUserQuestion before proceeding
+6. Hand off to the next phase's persona; announce the handoff
+
+### Step 3 — Surface failures explicitly
+
+On any step failure: identify the failing step, the active persona, and offer to escalate to `@openlife-maestro` (read `.openlife/method/agents/maestro.md`).
+
+### Why host-native, not shell?
+
+Running the workflow this way uses your reasoning (the host LLM) instead of the external Brain chain. Zero API key needed for orchestration. If the user wants the external Brain to drive (headless / batch / cron), they can run `openlife flow run brownfield-discovery "$ARGUMENTS"` in a terminal.

package/dist-templates/claude-code/commands/openlife/flow/brownfield-fullstack.md

@@ -10,11 +10,29 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Run `openlife flow run brownfield-fullstack $ARGUMENTS` and walk the user through the workflow as it executes.
+**Mode:** host-native — you (the host LLM) orchestrate the `brownfield-fullstack` workflow yourself, playing the personas as needed.
 
-- The workflow YAML is at `dist-templates/workflows/brownfield-fullstack.yaml` (or `.openlife/method/workflows/brownfield-fullstack.yaml` if locally overridden).
-- Each phase invokes one or more OpenLife method agents.
-- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
-- `--dry-run` prints the phase plan without executing.
+### Step 1 — Load the workflow definition
 
-Refer the user to the persona of the active phase when they ask "who is doing this?".
+Read `dist-templates/workflows/brownfield-fullstack.yaml` (project local override at `.openlife/method/workflows/brownfield-fullstack.yaml` or `.catalog/workflows/brownfield-fullstack.yaml` takes precedence if present).
+
+If `$ARGUMENTS` contains `--dry-run`, ALSO shell out to `openlife flow run brownfield-fullstack --dry-run` to print the phase plan, then STOP.
+
+### Step 2 — Walk the phases
+
+For each phase in the workflow's `sequence`:
+
+1. Announce which phase you're entering and which persona owns this phase (the `agent:` field on the step)
+2. Read `.openlife/method/agents/<persona-id>.md` for the active persona — adopt that persona for this phase
+3. Execute the step's `action` using the persona's discipline (commands, hand-off rules, anti-patterns)
+4. Produce the artifacts listed in `creates:` — write them to the paths declared in the YAML
+5. If `elicit: true`, ask the user via AskUserQuestion before proceeding
+6. Hand off to the next phase's persona; announce the handoff
+
+### Step 3 — Surface failures explicitly
+
+On any step failure: identify the failing step, the active persona, and offer to escalate to `@openlife-maestro` (read `.openlife/method/agents/maestro.md`).
+
+### Why host-native, not shell?
+
+Running the workflow this way uses your reasoning (the host LLM) instead of the external Brain chain. Zero API key needed for orchestration. If the user wants the external Brain to drive (headless / batch / cron), they can run `openlife flow run brownfield-fullstack "$ARGUMENTS"` in a terminal.

package/dist-templates/claude-code/commands/openlife/flow/brownfield-service.md

@@ -10,11 +10,29 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Run `openlife flow run brownfield-service $ARGUMENTS` and walk the user through the workflow as it executes.
+**Mode:** host-native — you (the host LLM) orchestrate the `brownfield-service` workflow yourself, playing the personas as needed.
 
-- The workflow YAML is at `dist-templates/workflows/brownfield-service.yaml` (or `.openlife/method/workflows/brownfield-service.yaml` if locally overridden).
-- Each phase invokes one or more OpenLife method agents.
-- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
-- `--dry-run` prints the phase plan without executing.
+### Step 1 — Load the workflow definition
 
-Refer the user to the persona of the active phase when they ask "who is doing this?".
+Read `dist-templates/workflows/brownfield-service.yaml` (project local override at `.openlife/method/workflows/brownfield-service.yaml` or `.catalog/workflows/brownfield-service.yaml` takes precedence if present).
+
+If `$ARGUMENTS` contains `--dry-run`, ALSO shell out to `openlife flow run brownfield-service --dry-run` to print the phase plan, then STOP.
+
+### Step 2 — Walk the phases
+
+For each phase in the workflow's `sequence`:
+
+1. Announce which phase you're entering and which persona owns this phase (the `agent:` field on the step)
+2. Read `.openlife/method/agents/<persona-id>.md` for the active persona — adopt that persona for this phase
+3. Execute the step's `action` using the persona's discipline (commands, hand-off rules, anti-patterns)
+4. Produce the artifacts listed in `creates:` — write them to the paths declared in the YAML
+5. If `elicit: true`, ask the user via AskUserQuestion before proceeding
+6. Hand off to the next phase's persona; announce the handoff
+
+### Step 3 — Surface failures explicitly
+
+On any step failure: identify the failing step, the active persona, and offer to escalate to `@openlife-maestro` (read `.openlife/method/agents/maestro.md`).
+
+### Why host-native, not shell?
+
+Running the workflow this way uses your reasoning (the host LLM) instead of the external Brain chain. Zero API key needed for orchestration. If the user wants the external Brain to drive (headless / batch / cron), they can run `openlife flow run brownfield-service "$ARGUMENTS"` in a terminal.

package/dist-templates/claude-code/commands/openlife/flow/brownfield-ui.md

@@ -10,11 +10,29 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Run `openlife flow run brownfield-ui $ARGUMENTS` and walk the user through the workflow as it executes.
+**Mode:** host-native — you (the host LLM) orchestrate the `brownfield-ui` workflow yourself, playing the personas as needed.
 
-- The workflow YAML is at `dist-templates/workflows/brownfield-ui.yaml` (or `.openlife/method/workflows/brownfield-ui.yaml` if locally overridden).
-- Each phase invokes one or more OpenLife method agents.
-- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
-- `--dry-run` prints the phase plan without executing.
+### Step 1 — Load the workflow definition
 
-Refer the user to the persona of the active phase when they ask "who is doing this?".
+Read `dist-templates/workflows/brownfield-ui.yaml` (project local override at `.openlife/method/workflows/brownfield-ui.yaml` or `.catalog/workflows/brownfield-ui.yaml` takes precedence if present).
+
+If `$ARGUMENTS` contains `--dry-run`, ALSO shell out to `openlife flow run brownfield-ui --dry-run` to print the phase plan, then STOP.
+
+### Step 2 — Walk the phases
+
+For each phase in the workflow's `sequence`:
+
+1. Announce which phase you're entering and which persona owns this phase (the `agent:` field on the step)
+2. Read `.openlife/method/agents/<persona-id>.md` for the active persona — adopt that persona for this phase
+3. Execute the step's `action` using the persona's discipline (commands, hand-off rules, anti-patterns)
+4. Produce the artifacts listed in `creates:` — write them to the paths declared in the YAML
+5. If `elicit: true`, ask the user via AskUserQuestion before proceeding
+6. Hand off to the next phase's persona; announce the handoff
+
+### Step 3 — Surface failures explicitly
+
+On any step failure: identify the failing step, the active persona, and offer to escalate to `@openlife-maestro` (read `.openlife/method/agents/maestro.md`).
+
+### Why host-native, not shell?
+
+Running the workflow this way uses your reasoning (the host LLM) instead of the external Brain chain. Zero API key needed for orchestration. If the user wants the external Brain to drive (headless / batch / cron), they can run `openlife flow run brownfield-ui "$ARGUMENTS"` in a terminal.

package/dist-templates/claude-code/commands/openlife/flow/epic.md

@@ -10,11 +10,29 @@ allowed-tools:
   - AskUserQuestion
 ---
 
-Run `openlife flow run epic-orchestration $ARGUMENTS` and walk the user through the workflow as it executes.
+**Mode:** host-native — you (the host LLM) orchestrate the `epic-orchestration` workflow yourself, playing the personas as needed.
 
-- The workflow YAML is at `dist-templates/workflows/epic-orchestration.yaml` (or `.openlife/method/workflows/epic-orchestration.yaml` if locally overridden).
-- Each phase invokes one or more OpenLife method agents.
-- On any failure: surface the failing step + which agent is responsible, then offer to escalate to `@openlife-maestro`.
-- `--dry-run` prints the phase plan without executing.
+### Step 1 — Load the workflow definition
 
-Refer the user to the persona of the active phase when they ask "who is doing this?".
+Read `dist-templates/workflows/epic-orchestration.yaml` (project local override at `.openlife/method/workflows/epic-orchestration.yaml` or `.catalog/workflows/epic-orchestration.yaml` takes precedence if present).
+
+If `$ARGUMENTS` contains `--dry-run`, ALSO shell out to `openlife flow run epic-orchestration --dry-run` to print the phase plan, then STOP.
+
+### Step 2 — Walk the phases
+
+For each phase in the workflow's `sequence`:
+
+1. Announce which phase you're entering and which persona owns this phase (the `agent:` field on the step)
+2. Read `.openlife/method/agents/<persona-id>.md` for the active persona — adopt that persona for this phase
+3. Execute the step's `action` using the persona's discipline (commands, hand-off rules, anti-patterns)
+4. Produce the artifacts listed in `creates:` — write them to the paths declared in the YAML
+5. If `elicit: true`, ask the user via AskUserQuestion before proceeding
+6. Hand off to the next phase's persona; announce the handoff
+
+### Step 3 — Surface failures explicitly
+
+On any step failure: identify the failing step, the active persona, and offer to escalate to `@openlife-maestro` (read `.openlife/method/agents/maestro.md`).
+
+### Why host-native, not shell?
+
+Running the workflow this way uses your reasoning (the host LLM) instead of the external Brain chain. Zero API key needed for orchestration. If the user wants the external Brain to drive (headless / batch / cron), they can run `openlife flow run epic-orchestration "$ARGUMENTS"` in a terminal.