---
id: OBPI-0.1.0-04
parent: ADR-0.1.0-enforced-governance-foundation
item: 4
lane: Heavy
status: Completed
---

# OBPI-0.1.0-04: Implement gz specify

## Objective

Implement `gz specify` command that creates briefs linked to PRD/constitution.

## Parent ADR

- **ADR**: [ADR-0.1.0-enforced-governance-foundation](../ADR-0.1.0-enforced-governance-foundation.md)
- **Checklist Item**: #4 (AC-004: Brief Command)

## Lane

**Heavy** — External CLI contract

## Allowed Paths

- Create brief from template in configured briefs directory
- Insert constitution reference automatically
- Generate unique brief ID
- Append `brief_created` event to ledger with `parent` reference

## Denied Paths

- Creating brief without constitution existing
- Creating brief without parent reference

## Requirements

- Brief must link to constitution
- Brief must have unique ID
- Ledger event must include `parent` field

## Acceptance Criteria

- [x] REQ-0.1.0-04-01: `gz specify my-feature` creates brief in configured directory
- [x] REQ-0.1.0-04-02: Brief contains constitution reference
- [x] REQ-0.1.0-04-03: Brief has unique ID
- [x] REQ-0.1.0-04-04: `brief_created` event appended to ledger with `parent`
- [x] REQ-0.1.0-04-05: Command fails if constitution does not exist

## Gate Evidence

| Gate | Evidence | Command/Path |
|------|----------|--------------|
| Gate 2 (TDD) | Tests pass | `uv run -m unittest tests/test_cli.py` |

## Evidence

### Implementation Summary

- Completion evidence: Capability is implemented in the current `gz` runtime and validated by repository quality gates.
- Reconciliation date: 2026-02-22
