docs: document ward agents in Product surfaces #1680

Merged

coilyco-ops merged 2 commits from docs/readme-agents-surface into main

2026-08-25 08:43:39 +00:00

coilyco-ops commented

2026-08-24 01:18:07 +00:00

Owner

ward agents list ships and prints the fixed typed harness roster. The README's Product surfaces section listed exec, git, audit, and agent but not it, so a reader asking which harnesses they can request had no supported way to answer from the front door.

One line added. Everything else in this README was checked and left alone: all nine doc links resolve, every documented verb exists against the built binary, and engineer is a real Ward role rather than a stale compose-roster slug.

Part of a cross-repo README pass, parent audit coilysiren/inbox#397.

Note: code-comments and source-doc-refs already fail on this repo's clean main, in Go files this branch does not touch. Filing separately.

`ward agents list` ships and prints the fixed typed harness roster. The README's Product surfaces section listed exec, git, audit, and agent but not it, so a reader asking which harnesses they can request had no supported way to answer from the front door. One line added. Everything else in this README was checked and left alone: all nine doc links resolve, every documented verb exists against the built binary, and `engineer` is a real Ward role rather than a stale compose-roster slug. Part of a cross-repo README pass, parent audit `coilysiren/inbox#397`. Note: `code-comments` and `source-doc-refs` already fail on this repo's clean `main`, in Go files this branch does not touch. Filing separately.

coilyco-ops added 1 commit

2026-08-24 01:18:07 +00:00

docs: document ward agents in Product surfaces

test / test (pull_request) Failing after 51s

Details

188fbab4b9

`ward agents list` ships and prints the fixed typed harness roster, and the
README's Product surfaces section listed exec, git, audit, and agent but not
it. A reader asking "which harnesses can I ask for" had no supported way to
find the answer from the front door.

Everything else in this README checked out against the binary and the tree:
all nine doc links resolve, every documented verb exists, and `engineer` is a
real Ward role rather than a stale compose-roster slug.

Note: code-comments and source-doc-refs already fail on this repo's clean
main, in Go files this does not touch. Filed separately.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-authored-by: Kai Siren <coilysiren@gmail.com>
Co-authored-by: Claude <noreply@anthropic.com>
Agent-Role: devrel

coilyco-ops requested review from coilysiren

2026-08-24 01:18:08 +00:00

coilyco-ops referenced this pull request

2026-08-24 01:23:54 +00:00

main has been red since 2026-08-17: TestClassifyForgejoPRRepairBuckets, promote and release stalled #1681

coilyco-ops referenced this pull request

2026-08-25 08:36:59 +00:00

fix(test): state the mirrored-verb set instead of reading this repo's ward.yaml #1682

coilyco-ops added 1 commit

2026-08-25 08:38:56 +00:00

Merge branch 'main' into docs/readme-agents-surface

test / test (pull_request) Successful in 49s