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
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
+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.
model: claude-sonnet-5
tools: [read, search, edit, execute]
user-invokable: false
user-invocable: false
---
# 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
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
+1 -1
View File
@@ -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
+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.
model: claude-opus-5
tools: [read, search, edit, execute]
user-invokable: true
user-invocable: true
---
# 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.
model: claude-opus-5
tools: [read, search, execute]
user-invokable: true
user-invocable: true
---
# 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.
model: claude-haiku-4.5
tools: [read, search, execute]
user-invokable: false
user-invocable: false
---
# 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.
model: claude-haiku-4.5
tools: [read, search, edit, execute]
user-invokable: false
user-invocable: false
---
# 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.
model: claude-sonnet-5
tools: [read, search, edit, execute]
user-invokable: false
user-invocable: false
---
# 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.
model: claude-haiku-4.5
tools: [read, search, execute]
user-invokable: false
user-invocable: false
---
# Verifier