---
id: OBPI-0.24.0-04-runbook-skill-entries
parent: ADR-0.24.0-skill-documentation-contract
item: 4
status: Completed
lane: lite
date: 2026-03-21
completed: 2026-03-29
---

# OBPI-0.24.0-04: Runbook Skill Invocation Entries

## ADR ITEM — Level 1 WBS Reference

- Source ADR: `docs/design/adr/pre-release/ADR-0.24.0-skill-documentation-contract/ADR-0.24.0-skill-documentation-contract.md`
- OBPI Entry (Level 1 WBS): `OBPI-0.24.0-04 — "Add skill invocation entries to operator and governance runbooks"`

## OBJECTIVE

Add skill invocation entries to `docs/user/runbook.md` and `docs/governance/governance_runbook.md` at the natural workflow insertion points where operators should reach for skills.

## ASSUMPTIONS

- Skills participate in identifiable workflows (ADR lifecycle, quality checks, governance ceremonies, etc.)
- The runbook already has workflow sections where skills naturally fit
- Not every skill needs a runbook entry — only those that participate in documented workflows

## NON-GOALS

- Rewriting runbook structure or workflow sequences
- Documenting skills that are purely agent-internal (no operator invocation point)
- Creating new workflow sections in runbooks (only adding to existing sections)

## REQUIREMENTS (FAIL-CLOSED)

1. Identify workflow insertion points in `docs/user/runbook.md` where operator-invocable skills should be referenced
1. Identify workflow insertion points in `docs/governance/governance_runbook.md` for governance skills
1. Add skill references with brief context: what the skill does and why it's invoked at this point in the workflow
1. Link each runbook skill reference to the corresponding manpage in `docs/user/skills/`
1. Do not disrupt existing runbook flow — skill entries are additive

## Acceptance Criteria

<!--
Specific, testable criteria for completion.
Each checkbox carries a deterministic REQ ID: REQ-<semver>-<obpi_item>-<criterion_index>.
Backfilled 2026-04-15 under GHI #160 Phase 3 from REQUIREMENTS prose above.
-->

- [x] REQ-0.24.0-04-01: Identify workflow insertion points in `docs/user/runbook.md` where operator-invocable skills should be referenced
- [x] REQ-0.24.0-04-02: Identify workflow insertion points in `docs/governance/governance_runbook.md` for governance skills
- [x] REQ-0.24.0-04-03: Add skill references with brief context: what the skill does and why it's invoked at this point in the workflow
- [x] REQ-0.24.0-04-04: Link each runbook skill reference to the corresponding manpage in `docs/user/skills/`
- [x] REQ-0.24.0-04-05: Do not disrupt existing runbook flow — skill entries are additive


## ALLOWED PATHS

- `docs/user/runbook.md`
- `docs/governance/governance_runbook.md`
- `docs/design/adr/pre-release/ADR-0.24.0-skill-documentation-contract/` — this ADR and briefs

## QUALITY GATES (Lite)

- [x] Gate 1 (ADR): Intent recorded in this brief
- [x] Gate 2 (TDD): `uv run mkdocs build --strict` passes
- [x] Code Quality: `uv run gz lint` passes

## VERIFICATION COMMANDS

- `uv run mkdocs build --strict`
- `rg -n "\\]\\(.*skills/.*\\.md\\)" docs/user/runbook.md docs/governance/governance_runbook.md`
- `rg -n "what the skill does|why it's invoked|workflow" docs/user/runbook.md docs/governance/governance_runbook.md`

### Closing Argument

### Implementation Summary

- Files modified: `docs/user/runbook.md`, `docs/governance/governance_runbook.md`
- Tests added: (none — documentation-only OBPI)
- Date completed: 2026-03-29

### Key Proof

```bash
$ rg -c '\]\(.*skills/.*\.md\)' docs/user/runbook.md docs/governance/governance_runbook.md
docs/user/runbook.md:17
docs/governance/governance_runbook.md:24
```

41 skill-to-manpage links added across both runbooks at natural workflow insertion points. `uv run mkdocs build --strict` passes with all links resolving correctly.
