runbooks / command
Runbook coverage
Coverage report, overall or per capability, feature, slice or path
❯ /runbooks:coverage [--capability x | --feature y | --slice name | --path glob | --role r] [--all-slices] [--model <model>]❯ $runbooks:runbooks-coverage [--capability x | --feature y | --slice name | --path glob | --role r] [--all-slices] [--model <model>]When executing as a child, you cannot ask the user. When the main session executes this file inline, it asks the user directly and handles calls through the dispatcher. Where this file says to ask (AskUserQuestion, "ask the user", a diff approval), stop with status: question as agents.md says. Where it says to say something and stop, put the message in summary: and report status: done. Commit nothing: the main session commits after it prints your summary.
Parameters
Use at most one filter. Without one it writes the overall report. Slice and path filters reach entries only; requirements have no file to slice by. Reports go to _coverage/, which Git ignores, so they stay local. /runbooks:ui shows the same numbers in the browser.
| Parameter | What it does |
|---|---|
--capability <x> |
Entries whose file is in the slice x of the config slices. Report: _coverage/capability-x.md. |
--feature <y> |
Entries and requirements cited by runbooks with feature: y. |
--slice <name> |
The same entries as --capability. Report: _coverage/slice-name.md. |
--path <glob> |
Entries whose file matches the glob. |
--role <r> |
With role tracking on: the by-role section for one role, counted per matrix key of roles.json. Report: _coverage/role-r.md. |
--all-slices |
On its own: the overall report plus one report per slice in the config. |
--model <m> |
Run this invocation on one model: inline (in the main session), haiku, sonnet, opus or fable. Any value but inline runs the command in a sub-agent on that model. Without it, the command takes its row of the models table in the config: by default coverage runs on haiku. On Codex, the values are inline, inherit (a sub-agent on the session's model) or a model ID the session supports, and the table is codex.models, where every row that is not inline defaults to inherit. See models. |
/runbooks:coverage # the whole project
/runbooks:coverage --capability billing # one capability
/runbooks:coverage --feature invoices # one feature
/runbooks:coverage --slice billing # one slice from the config
/runbooks:coverage --path 'src/app/billing/**' # files under a path
/runbooks:coverage --role editor # the keys of one role
/runbooks:coverage --all-slices # overall plus every slice
/runbooks:coverage --model opus # on opus, this time only