---
name: gz-adr-status
description: Show the ADR table for summary requests, or show focused lifecycle and OBPI detail for one ADR.
category: adr-lifecycle
compatibility: GovZero v6 framework; uses gz CLI status surfaces
metadata:
  skill-version: "1.12.1"
  govzero-framework-version: "v6"
  govzero-author: "GovZero governance team"
  govzero_layer: "Layer 1 - Evidence Gathering"
gz_command: adr status
invocation: uv run gz adr report | uv run gz adr status ADR-0.3.0
lifecycle_state: active
owner: gzkit-governance
last_reviewed: 2026-06-10
model: haiku
---

# gz-adr-status

Show ADR status using the current `gz` command surface.

## When to Use

- Inspect all ADRs for pending gates and lifecycle at a glance
- Provide repeatable operator summaries in a consistent table format
- Inspect one ADR's lifecycle, QC posture, and OBPI breakdown without reprinting the global table

## Behavior

When this skill is invoked, **immediately run the appropriate command** — do not ask clarifying questions.

- **No arguments** or `--summary`: run `uv run gz adr report` and present the output.
- **With an ADR ID** (e.g., `ADR-0.3.0`): run `uv run gz adr status ADR-0.3.0`. This is the focused single-ADR drilldown — detailed OBPI progress, lifecycle, and QC posture for one ADR. Pass `--show-gates` only when the user explicitly asks for gate-level diagnostics.

## Invocation

```text
/gz-adr-status              ← summary (all ADRs)
/gz-adr-status --summary    ← summary (explicit)
/gz-adr-status ADR-0.3.0    ← focused drilldown
```

## Commands

```bash
# Summary view (table across all ADRs)
uv run gz adr report

# Focused ADR drilldown (single-ADR lifecycle, OBPI breakdown, QC posture)
uv run gz adr status ADR-0.3.0

# Focused drilldown with gate-level diagnostics (only when explicitly requested)
uv run gz adr status ADR-0.3.0 --show-gates
```

## Output Contract

Declared form: **table** (both modes).

Locked by: `tests/commands/test_status.py::TestLifecycleStatusSemantics::test_adr_status_renders_shared_table_via_deterministic_renderer` (single-ADR drilldown) and the shared `adr report` table renderer tests in the same module.

### Both modes

- The command output is already visible to the user from tool execution — do NOT re-print it.
- `--json` on either verb is for machine consumption only — never present raw JSON to a human operator.
- Do not paraphrase, condense, or replace the table with prose unless the user explicitly asks for analysis.
- Optional commentary belongs after the command runs and only when the user asks for interpretation.

## References

- Command implementation: `src/gzkit/cli.py`
- User docs: `docs/user/manpages/adr-status.md`, `docs/user/manpages/status.md`
