fix(agents): document exact lh CLI flags in every agent profile

Every agent's PROCEDURE/OUTPUTS referenced lh subcommands vaguely (e.g.
'Run lh run event', 'lh memory get --shard failures'), forcing models to
guess flags at runtime instead of following the profile. Two real bugs
found this way:

- 'lh memory get --shard X' silently ignores --shard (it's a positional
  arg on get, not a flag) and returns the whole INDEX.md instead of the
  targeted shard. Fixed to 'lh memory get X' everywhere.
- lh run event/lane create calls had no required --type/--status/--id/
  --kind/--scope documented, so agents had to trial-and-error discover
  them. Added full, exact invocation syntax inline for every command
  each agent actually issues (run event, lane create, memory get/put,
  host --strategy, graph).
This commit is contained in:
2026-09-10 02:33:22 +02:00
parent 34ce4eb5c5
commit 099001728c
10 changed files with 21 additions and 21 deletions
+4 -4
View File
@@ -24,9 +24,9 @@ Document continuously. Never block the pipeline.
10. Append ADR notes inside `.agents/architecture.md` only when durable architectural decisions appear.
11. Update `.agents/specs/<slug>/spec.md` only for accepted living-spec deltas.
12. Update `.agents/conventions.md` only for durable project conventions.
13. Write memory shards through `lh memory put` when events reveal reusable facts.
14. Use shards: failures, corrections, insights, conventions, quirks.
15. Run `lh memory scan` before writing memory if secrets may appear.
13. Write memory shards through `lh memory put --shard <name> --title "<short title>" --body "<text>" [--tags a,b]` when events reveal reusable facts.
14. Use shard names: `failures`, `corrections`, `insights`, `conventions`, `quirks`.
15. Run `lh memory scan` (scans all shards; pass filenames as positional args to scan specific files) before writing memory if secrets may appear.
16. Keep every entry short and dated.
17. If write conflicts occur, emit a note and continue later.
18. Return latest journal path and any skipped updates.
@@ -46,7 +46,7 @@ Document continuously. Never block the pipeline.
- Write `.agents/architecture.md` when ADRs change.
- Write `.agents/specs/<slug>/spec.md` when living spec changes.
- Write `.agents/conventions.md` when conventions change.
- Write memory shards through `lh memory put`.
- Write memory shards through `lh memory put --shard <name> --title "<text>" --body "<text>"`.
## STOP CONDITIONS