From 34ce4eb5c5e3c08e432f216083ba37cb59b4f7c1 Mon Sep 17 00:00:00 2001
From: Giancarmine Salucci <mozempk@gmail.com>
Date: Thu, 10 Sep 2026 02:30:08 +0200
Subject: [PATCH] fix(agents): correct user-invocable typo; document exact lh
 run flags

- All agent profiles used the misspelled 'user-invokable' property, which
  Copilot CLI silently ignores, so internal-only agents (scout, splitter,
  builder, verifier, integrator, scribe) were never actually hidden from
  the /agent picker. Renamed to the documented 'user-invocable'.
- conductor/architect instructions said only 'Run lh run event' with no
  flags, forcing the model to trial-and-error discover --type/--status/
  etc. Documented the exact lh run start/event/end CLI syntax inline.
---
 .github/agents/architect.agent.md    | 4 ++--
 .github/agents/builder.agent.md      | 2 +-
 .github/agents/conductor.agent.md    | 8 ++++----
 .github/agents/integrator.agent.md   | 2 +-
 .github/agents/interrogator.agent.md | 2 +-
 .github/agents/reviewer.agent.md     | 2 +-
 .github/agents/scout.agent.md        | 2 +-
 .github/agents/scribe.agent.md       | 2 +-
 .github/agents/splitter.agent.md     | 2 +-
 .github/agents/verifier.agent.md     | 2 +-
 10 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/.github/agents/architect.agent.md b/.github/agents/architect.agent.md
index 4edaa92..0bebc4c 100644
--- a/.github/agents/architect.agent.md
+++ b/.github/agents/architect.agent.md
@@ -4,7 +4,7 @@ description: Turns decisions into a checkable spec, acceptance criteria, archite
 model: claude-opus-5
 tools: [read, search, edit, execute, agent, context7]
 agents: [Scout]
-user-invokable: true
+user-invocable: true
 ---
 
 # Architect
@@ -34,7 +34,7 @@ Write the spec. Make every acceptance criterion checkable.
 19. Append ADR entries inside `.agents/architecture.md`.
 20. Use ADR ids: `ADR-YYYYMMDD-<slug>-<n>`.
 21. Update `.agents/conventions.md` only for durable conventions.
-22. Emit `lh run event` for spec completion when a run id exists.
+22. Emit `lh run event --type spec --status ok --run-id <runId>` for spec completion when a run id exists (skip silently if none).
 23. Return spec path, acceptance ids, ADR ids, and open risks.
 
 ## SPEC SHAPE
diff --git a/.github/agents/builder.agent.md b/.github/agents/builder.agent.md
index 61a72aa..6a8fbfc 100644
--- a/.github/agents/builder.agent.md
+++ b/.github/agents/builder.agent.md
@@ -3,7 +3,7 @@ name: Builder
 description: Implements one write lane inside its worktree and runs the Ralph loop with verifier until acceptance passes or escalates.
 model: claude-sonnet-5
 tools: [read, search, edit, execute]
-user-invokable: false
+user-invocable: false
 ---
 
 # Builder
diff --git a/.github/agents/conductor.agent.md b/.github/agents/conductor.agent.md
index 3b19205..8e1d520 100644
--- a/.github/agents/conductor.agent.md
+++ b/.github/agents/conductor.agent.md
@@ -4,7 +4,7 @@ description: Entry point that runs the lean harness pipeline, owns the dynamic D
 model: claude-opus-5
 tools: [read, search, edit, execute, agent]
 agents: [Interrogator, Scout, Architect, Splitter, Builder, Verifier, Reviewer, Integrator, Scribe]
-user-invokable: true
+user-invocable: true
 ---
 
 # Conductor
@@ -20,8 +20,8 @@ Run the full lean harness pipeline. Edit no product files.
 5. Read the printed host strategy before any other action.
 6. If the strategy permits parallel lanes, use host fan-out.
 7. If the strategy says sequential, run every lane one at a time.
-8. Run `lh run start` and capture the run id.
-9. Emit `lh run event` for every phase transition.
+8. Run `lh run start --objective "<one-line goal>" [--spec <slug>] --json` and capture `runId` from the JSON output.
+9. Emit `lh run event --type <phase> --status ok|error [--name <label>] [--lane <laneId>] [--agent <agentName>] [--duration-ms <n>] [--exit-code <n>] [--run-id <runId>]` for every phase transition. `--type` and `--run-id` are required (run-id may be omitted only if it's the latest run); everything else is optional context.
 10. Load only `.agents/memory/INDEX.md` by default.
 11. Pull memory shards only when the current phase needs them.
 12. Start `scribe` after run start.
@@ -51,7 +51,7 @@ Run the full lean harness pipeline. Edit no product files.
 36. Require one final full verify after all lane merges.
 37. Invoke `reviewer` for final approval if not already done by integrator.
 38. Run `scribe` for final journal and deltas.
-39. Run `lh run end` with success or failure.
+39. Run `lh run end --run-id <runId> --status ok|error [--summary "<text>"]` with success or failure.
 40. Return only run id, changed lanes, verify status, and blockers.
 
 ## INPUTS
diff --git a/.github/agents/integrator.agent.md b/.github/agents/integrator.agent.md
index 3f25828..7d93399 100644
--- a/.github/agents/integrator.agent.md
+++ b/.github/agents/integrator.agent.md
@@ -4,7 +4,7 @@ description: Merges lane branches sequentially, resolves or escalates conflicts,
 model: claude-opus-5
 tools: [read, search, edit, execute, agent]
 agents: [Verifier, Reviewer]
-user-invokable: false
+user-invocable: false
 ---
 
 # Integrator
diff --git a/.github/agents/interrogator.agent.md b/.github/agents/interrogator.agent.md
index a34a541..d393834 100644
--- a/.github/agents/interrogator.agent.md
+++ b/.github/agents/interrogator.agent.md
@@ -3,7 +3,7 @@ name: Interrogator
 description: Runs gated design discovery by asking numbered questions with recommended answers and persisting final decisions.
 model: claude-opus-5
 tools: [read, search, edit, execute]
-user-invokable: true
+user-invocable: true
 ---
 
 # Interrogator
diff --git a/.github/agents/reviewer.agent.md b/.github/agents/reviewer.agent.md
index 00076bb..e87287c 100644
--- a/.github/agents/reviewer.agent.md
+++ b/.github/agents/reviewer.agent.md
@@ -3,7 +3,7 @@ name: Reviewer
 description: Reviews completed lanes against every acceptance criterion and scope rule, then returns explicit approval or rejection.
 model: claude-opus-5
 tools: [read, search, execute]
-user-invokable: true
+user-invocable: true
 ---
 
 # Reviewer
diff --git a/.github/agents/scout.agent.md b/.github/agents/scout.agent.md
index 1984cf6..e37b73a 100644
--- a/.github/agents/scout.agent.md
+++ b/.github/agents/scout.agent.md
@@ -3,7 +3,7 @@ name: Scout
 description: Read-only reconnaissance agent that summarizes repository facts under a token ceiling without editing files.
 model: claude-haiku-4.5
 tools: [read, search, execute]
-user-invokable: false
+user-invocable: false
 ---
 
 # Scout
diff --git a/.github/agents/scribe.agent.md b/.github/agents/scribe.agent.md
index 1cec80b..b0df592 100644
--- a/.github/agents/scribe.agent.md
+++ b/.github/agents/scribe.agent.md
@@ -3,7 +3,7 @@ name: Scribe
 description: Continuously writes non-blocking journal, ADR, living spec, and convention updates from pipeline events.
 model: claude-haiku-4.5
 tools: [read, search, edit, execute]
-user-invokable: false
+user-invocable: false
 ---
 
 # Scribe
diff --git a/.github/agents/splitter.agent.md b/.github/agents/splitter.agent.md
index cde2c79..a0ba28a 100644
--- a/.github/agents/splitter.agent.md
+++ b/.github/agents/splitter.agent.md
@@ -3,7 +3,7 @@ name: Splitter
 description: Converts a checkable spec into a DAG of read and write lanes with non-overlapping write scopes.
 model: claude-sonnet-5
 tools: [read, search, edit, execute]
-user-invokable: false
+user-invocable: false
 ---
 
 # Splitter
diff --git a/.github/agents/verifier.agent.md b/.github/agents/verifier.agent.md
index 1e207b2..d036825 100644
--- a/.github/agents/verifier.agent.md
+++ b/.github/agents/verifier.agent.md
@@ -3,7 +3,7 @@ name: Verifier
 description: Runs configured verification commands plus lh graph and returns only a terse pass or fail table.
 model: claude-haiku-4.5
 tools: [read, search, execute]
-user-invokable: false
+user-invocable: false
 ---
 
 # Verifier