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.
This commit is contained in:
2026-09-10 02:30:08 +02:00
parent 981cbceecf
commit 34ce4eb5c5
10 changed files with 14 additions and 14 deletions
+2 -2
View File
@@ -4,7 +4,7 @@ description: Turns decisions into a checkable spec, acceptance criteria, archite
model: claude-opus-5 model: claude-opus-5
tools: [read, search, edit, execute, agent, context7] tools: [read, search, edit, execute, agent, context7]
agents: [Scout] agents: [Scout]
user-invokable: true user-invocable: true
--- ---
# Architect # Architect
@@ -34,7 +34,7 @@ Write the spec. Make every acceptance criterion checkable.
19. Append ADR entries inside `.agents/architecture.md`. 19. Append ADR entries inside `.agents/architecture.md`.
20. Use ADR ids: `ADR-YYYYMMDD-<slug>-<n>`. 20. Use ADR ids: `ADR-YYYYMMDD-<slug>-<n>`.
21. Update `.agents/conventions.md` only for durable conventions. 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. 23. Return spec path, acceptance ids, ADR ids, and open risks.
## SPEC SHAPE ## SPEC SHAPE
+1 -1
View File
@@ -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. description: Implements one write lane inside its worktree and runs the Ralph loop with verifier until acceptance passes or escalates.
model: claude-sonnet-5 model: claude-sonnet-5
tools: [read, search, edit, execute] tools: [read, search, edit, execute]
user-invokable: false user-invocable: false
--- ---
# Builder # Builder
+4 -4
View File
@@ -4,7 +4,7 @@ description: Entry point that runs the lean harness pipeline, owns the dynamic D
model: claude-opus-5 model: claude-opus-5
tools: [read, search, edit, execute, agent] tools: [read, search, edit, execute, agent]
agents: [Interrogator, Scout, Architect, Splitter, Builder, Verifier, Reviewer, Integrator, Scribe] agents: [Interrogator, Scout, Architect, Splitter, Builder, Verifier, Reviewer, Integrator, Scribe]
user-invokable: true user-invocable: true
--- ---
# Conductor # 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. 5. Read the printed host strategy before any other action.
6. If the strategy permits parallel lanes, use host fan-out. 6. If the strategy permits parallel lanes, use host fan-out.
7. If the strategy says sequential, run every lane one at a time. 7. If the strategy says sequential, run every lane one at a time.
8. Run `lh run start` and capture the run id. 8. Run `lh run start --objective "<one-line goal>" [--spec <slug>] --json` and capture `runId` from the JSON output.
9. Emit `lh run event` for every phase transition. 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. 10. Load only `.agents/memory/INDEX.md` by default.
11. Pull memory shards only when the current phase needs them. 11. Pull memory shards only when the current phase needs them.
12. Start `scribe` after run start. 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. 36. Require one final full verify after all lane merges.
37. Invoke `reviewer` for final approval if not already done by integrator. 37. Invoke `reviewer` for final approval if not already done by integrator.
38. Run `scribe` for final journal and deltas. 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. 40. Return only run id, changed lanes, verify status, and blockers.
## INPUTS ## INPUTS
+1 -1
View File
@@ -4,7 +4,7 @@ description: Merges lane branches sequentially, resolves or escalates conflicts,
model: claude-opus-5 model: claude-opus-5
tools: [read, search, edit, execute, agent] tools: [read, search, edit, execute, agent]
agents: [Verifier, Reviewer] agents: [Verifier, Reviewer]
user-invokable: false user-invocable: false
--- ---
# Integrator # Integrator
+1 -1
View File
@@ -3,7 +3,7 @@ name: Interrogator
description: Runs gated design discovery by asking numbered questions with recommended answers and persisting final decisions. description: Runs gated design discovery by asking numbered questions with recommended answers and persisting final decisions.
model: claude-opus-5 model: claude-opus-5
tools: [read, search, edit, execute] tools: [read, search, edit, execute]
user-invokable: true user-invocable: true
--- ---
# Interrogator # Interrogator
+1 -1
View File
@@ -3,7 +3,7 @@ name: Reviewer
description: Reviews completed lanes against every acceptance criterion and scope rule, then returns explicit approval or rejection. description: Reviews completed lanes against every acceptance criterion and scope rule, then returns explicit approval or rejection.
model: claude-opus-5 model: claude-opus-5
tools: [read, search, execute] tools: [read, search, execute]
user-invokable: true user-invocable: true
--- ---
# Reviewer # Reviewer
+1 -1
View File
@@ -3,7 +3,7 @@ name: Scout
description: Read-only reconnaissance agent that summarizes repository facts under a token ceiling without editing files. description: Read-only reconnaissance agent that summarizes repository facts under a token ceiling without editing files.
model: claude-haiku-4.5 model: claude-haiku-4.5
tools: [read, search, execute] tools: [read, search, execute]
user-invokable: false user-invocable: false
--- ---
# Scout # Scout
+1 -1
View File
@@ -3,7 +3,7 @@ name: Scribe
description: Continuously writes non-blocking journal, ADR, living spec, and convention updates from pipeline events. description: Continuously writes non-blocking journal, ADR, living spec, and convention updates from pipeline events.
model: claude-haiku-4.5 model: claude-haiku-4.5
tools: [read, search, edit, execute] tools: [read, search, edit, execute]
user-invokable: false user-invocable: false
--- ---
# Scribe # Scribe
+1 -1
View File
@@ -3,7 +3,7 @@ name: Splitter
description: Converts a checkable spec into a DAG of read and write lanes with non-overlapping write scopes. description: Converts a checkable spec into a DAG of read and write lanes with non-overlapping write scopes.
model: claude-sonnet-5 model: claude-sonnet-5
tools: [read, search, edit, execute] tools: [read, search, edit, execute]
user-invokable: false user-invocable: false
--- ---
# Splitter # Splitter
+1 -1
View File
@@ -3,7 +3,7 @@ name: Verifier
description: Runs configured verification commands plus lh graph and returns only a terse pass or fail table. description: Runs configured verification commands plus lh graph and returns only a terse pass or fail table.
model: claude-haiku-4.5 model: claude-haiku-4.5
tools: [read, search, execute] tools: [read, search, execute]
user-invokable: false user-invocable: false
--- ---
# Verifier # Verifier