메뉴
Preview complexity advisor diagnosis, understand auto-chain context, or check intrinsic complexity attestation guidance. Use when the operator says "preview complexity advisor", "complexity diagnosis", "advisor recommendation", "what does the advisor say", or "intrinsic complexity attestation".
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Validate and stage a candidate rendition from the corpus via gz content compose. Use when the agent has made compression decisions (drop/combine/rewrite of compressible corpus entries toward the declared setpoint) and wants the tool to validate invariant-floor compliance, compute byte evidence, write the candidate artifact, and emit a ledger event.
Enter and exit the MX Maintenance Hangar — operator's interface to gz mx. Use when entering the hangar to perform governance repair, checking hangar status mid-session, or cleanly exiting when repair is complete. Operator operates the skill; the skill invokes gz mx; nobody shells out.
Create and resume session handoff documents for agent context preservation across engineering sessions.
Create and resume session handoff documents for agent context preservation across engineering sessions.
Collaborative design dialogue that produces GovZero ADR artifacts. Use when exploring a new feature, capability, or architectural change before implementation — replaces superpowers brainstorming for this project. Triggers on "design X", "let's design", "brainstorm X", "I want to build X", "gz-design".
Cross the airlock membrane — the entry/exit gate every unit of work passes through (ADR-0.33.0). Use to inspect a target's seam-map before touching it (`gz airlock in`), account for what a transit disturbed (`gz airlock out`), or make a governed ad-hoc reconnaissance entry with light repair at most (`gz permitted-entry`). Diagnostic-only for now — a staged posture, not the declared end state; never writes L1 canon.
| name | gz-complexity-advisor |
| description | Preview complexity advisor diagnosis, understand auto-chain context, or check intrinsic complexity attestation guidance. Use when the operator says "preview complexity advisor", "complexity diagnosis", "advisor recommendation", "what does the advisor say", or "intrinsic complexity attestation". |
| category | code-quality |
| lifecycle_state | active |
| owner | gzkit-governance |
| last_reviewed | "2026-07-25T00:00:00.000Z" |
| metadata | {"skill-version":"0.1.2","govzero-framework-version":"v6","govzero_layer":"Layer 3 - File Sync"} |
| gz_command | complexity advise |
| model | opus |
Operator-runnable skill wrapping the gz complexity advise CLI verb
(ADR-0.0.29, OBPI-0.0.29-03). The advisor is the trigger-time doctrinal-frame
surface for the four-ADR complexity-doctrine cluster (ADR-0.0.27 corpus /
0.0.28 thresholds / 0.0.29 advisor / 0.0.30 authoring-guidance). Every
diagnosis cites the active distilled-characteristics document and the canonical
ThresholdTable, carries a proof field linking to responsible AST nodes /
line ranges, and respects the two-path intrinsic-complexity attestation.
Three operator moments trigger this skill — any one fires the advisor:
@intrinsic_complexity (decorator) vs --attest-intrinsic
(commit-time flag) for irreducibly complex functions.The operator invokes the advisor directly to preview diagnosis before commit. This is the OEE-aligned preview-before-fail moment: the developer sees the full diagnosis (archetype, authority, proof range, recommended move) without waiting for xenon-as-gate to trip.
gz complexity advise src/gzkit/commands/validate.py
gz complexity advise src/gzkit/ --json
Default output is structured prose with a per-diagnosis block. The --json
flag emits the canonical AdvisorDiagnosis Pydantic serialization for
machine consumption.
When installed, the auto-chain hook (OBPI-0.0.29-05) fires
gz complexity advise --auto-chain automatically on a non-zero
xenon-as-gate exit at pre-commit time. It is not installed in this
repo — .pre-commit-config.yaml carries the plain xenon-complexity
hook, not the composite complexity-advisor-auto-chain id, so the
advisor must be invoked by hand after a xenon failure.
The --auto-chain flag signals that the invocation is trigger-fired (not
operator-initiated), producing a condensed presentation default suited to
the commit-time moment rather than the verbose preview the ad-hoc path emits.
The auto-chain pathway preserves the existing SKIP-bypass guard wiring from
the complexity-reduction-xenon chore — modules previously marked with a
SKIP annotation continue to bypass both xenon-as-gate and the advisor.
For functions whose complexity is irreducibly algorithmic (e.g. CC=24 in a query optimizer's join-cost calculator), two attestation paths exist:
@intrinsic_complexity(reason=..., attestor=...) — decorator applied
to the function definition. The advisor honors this at diagnosis time and
skips the function. Use for known-irreducible functions whose complexity
will not change.
--attest-intrinsic — commit-time flag passed to
gz complexity advise. Records the attestation to
.gzkit/ledger.jsonl via canonical event emission with Gate 5
follow-up persistence. Use for newly-discovered irreducible complexity
where amending the source with a decorator is premature.
Both paths land at brief-level Gate 5; neither produces a silent escape hatch. The decorator path pre-attests (skips at diagnosis time); the commit-time path post-attests (records and schedules review).
The advisor's pre-commit hook (OBPI-0.0.29-09) wraps the invocation in a
configurable timeout (default 30s). On timeout the hook fails open: the commit
proceeds and a warning is logged to .gzkit/insights/advisor-failures.jsonl
for later operator review. The fail-open is deliberate — blocking commits
on advisor failure is worse than letting them through with a logged warning.
Declared form: structured prose (default human-readable).
Each diagnosis block in the default output contains:
radon_cc=14)warn or block)Machine-readable mode: --json emits the canonical AdvisorDiagnosis
Pydantic serialization as a JSON array. Each element is a frozen Pydantic
model with fields: metric, crossing_band, crossing_value, archetype,
doctrinal_frame, proof, recommended_move, intrinsic_attestation.
# Ad-hoc preview (verbose structured prose)
gz complexity advise <path>
# Machine-readable output
gz complexity advise <path> --json
# Auto-chain mode (condensed, trigger-fired)
gz complexity advise <path> --auto-chain
# Intrinsic attestation (interactive TTY required; headless is refused)
gz complexity advise <file_path>:<qualname> --attest-intrinsic \
--reason "<why this complexity is intrinsic>" --attestor "<name>"
docs/user/manpages/complexity-advise.mddocs/user/runbook.md § Governance Doctrine Surfacesdocs/design/adr/foundation/ADR-0.0.29-complexity-advisor/.gzkit/rules/complexity-thresholds.json (ADR-0.0.28)data/exemplar_corpus.json + distillation output
(ADR-0.0.27 OBPI-04).gzkit/skills/gz-complexity-distill/SKILL.md