review-agent-readiness
Assemble a bounded readiness review for one frozen agent candidate before a production release, pilot, promotion, or material change. Use to consume a Part 4 evaluation handoff; verify code, configura
SKILL.mddevelopment-skills/review-agent-readiness/SKILL.md
GitHubReview Agent Readiness
Purpose and boundary
Assemble a review packet for one frozen candidate and one proposed exposure. Consume the distinct Part 4 evaluation conclusion and its limits; do not recreate, re-score, or upgrade that conclusion. A favorable evaluation conclusion is not release authority, and a generated packet is not evidence that a control operated.
Use this skill for a proposed pilot, production release, promotion, or material change. Do not use it to write implementation code, design trust controls, create or grade cases, execute a test or disable action, grant data or tool access, approve residual risk, deploy, resume, or certify an agent as production-ready.
Direct resources and named dependencies
Load the owner map before mapping a readiness item to its canonical owner. Load the packet contract before creating or checking a packet. Load the fictional examples only to compare packet structure or dispositions; they establish no candidate fact. Start from the packet template, and treat evaluation cases as selection/procedure fixtures, not live behavioral evidence.
This package supports direct invocation. It does not silently activate any sibling.
When the Part 4 handoff is absent or needs repair, explicitly name and load
build-agent-evidence only if it is available to the caller; otherwise record the
external dependency. Do not fetch an absent dependency, infer it from prose, or use
this readiness review to manufacture it.
Preflight
- Confirm the review subject is one proposed candidate and one proposed exposure, not a mutable label, a nearby candidate, or an aggregate dashboard.
- Obtain an inspectable frozen identity for all behavior-affecting material: code revision and build artifact; resolved instructions and configuration; selected model, route, fallback, and settings; effective capabilities and permissions; source, corpus, filter, and data identities; dependency versions or digests; risk assessment version; and evaluation subject, fixtures, evaluators, trial policy, and run/evidence identities.
- Obtain the Part 4 conclusion, its accountable owner and decision rule, evidence
links and statuses, hard-gate results, applicable profiles, known limits, required
next action, and exact candidate/scope. Preserve its
go,conditional_go, orno_goas an evaluation fact rather than a release decision. - Obtain intended and prohibited use, proposed users/tenants, enabled capabilities, stage limits, applicable requirements, risk scenarios, and the material-change comparison when this is not a first release.
- Obtain operations and lifecycle inputs: signal and stop criteria, an authorized stop/disable/containment path, evidence that the path was tested, in-flight and external-effect treatment, support and escalation contacts, and recovery authority.
If a required identity, evidence record, owner, external dependency, or tested control
is missing, mark it unmet and blocking. Set the packet to needs_information or
blocked as appropriate and recommend no_go; do not substitute web research,
planned work, a score, or a generated document.
Review procedure
1. Freeze and compare the subject
Copy the supplied identities into the packet's frozen-candidate record. Verify that the code, configuration, dependency, evaluation, risk, capability, source, and scope references name the same candidate. Record a first-release baseline rationale, or the identified baseline and comparable-case rule. Treat a missing digest, unresolved setting, floating route, unpinned dependency, or ambiguous source identity as a blocker rather than guessing its value.
For a change, make an impact table for instructions, model/route/fallback, permissions,
tools, sources, data handling, dependencies, population, execution, and operating
assumptions. For every affected assumption, risk scenario, control, evaluation case,
and rollout constraint, record unaffected, targeted_confirmation, or invalidated.
Require refreshed evidence before a material promotion when an item is invalidated.
2. Consume, but do not re-grade, Part 4
Link the complete evaluation handoff: conclusion identifier, frozen subject, authority, predeclared gates, applicable profiles, evidence and attempt-status ledger, limits, and next action. Check only its relevance and traceability to this candidate; the evaluation owner retains responsibility for evaluating it.
Carry forward invalid, inconclusive, failed, and missing evidence visibly. Retain failed
trials and bounded-repair records. Where implementation changed, require evidence of
the applicable end-to-end test, cleanup, and full retest before treating the package as
ready for this review. Never convert a positive average, a diagnostic, a planned test,
or a Part 4 go into a release authorization.
3. Build the readiness ledger
For each applicable readiness item, record the trigger, candidate-specific evidence
identifiers, owner, rationale, and exactly one status: met, not_applicable, unmet,
or exception_proposed. Use not_applicable only when its trigger is absent for the
named candidate and stage. A met item needs matching observed passing evidence.
Review the seven rollout groups in the owner map: subject and scope; evidence ledger; separate decision record; governed exception boundary; conditional obligations; staged exposure and tested response; and material-change reassessment. Keep operational telemetry, task outcome, evaluation conclusion, authorization, and external effect in separate packet fields.
An exception proposal is not an approved waiver and earns no readiness credit. Keep it blocking until an authorized external approver records its permitted scope, rationale, compensating controls, owner, review or expiry, and missed-condition consequence. Never propose it for a prohibited use, mandatory floor, required authorization, non-waivable hard gate, or missing/invalid/inconclusive required evidence.
4. Assess support, stop, and effect evidence
Verify that a reachable support owner, technical contact, escalation route, and restart/material-change authority cover the proposed stage. Verify an authorized operator can stop new work or disable the candidate/capability, and distinguish a stop request from confirmed cancellation, rollback, containment, reconciliation, and a forward fix. A diagram or runbook without exercised evidence is planned, not tested.
Where active work or external effects exist, require a safe-stop and reconciliation path. Where durable work or approvals exist, verify compatible handling of in-flight work and the applicable approval/effect evidence. Do not claim rollback reverses saved state, approved work, or an uncertain external effect.
5. Define proportionate staged exposure
For every proposed stage, record its type (isolated, shadow, canary, or wider), purpose, included population, data and capability boundary, entry evidence, signals, promotion criteria, stop criteria, deciding role, containment/disable route, and in-flight path. Treat shadow processing as potentially sensitive or effectful until its boundaries are shown. Use a control comparison for a canary when a canary is proposed.
Keep stages within the proposed authorized scope. Staging reduces exposure; it never replaces pre-release evidence, critical controls, required authorization, or a valid evaluation conclusion. Do not invent universal percentages, durations, thresholds, or staffing roles.
6. State a bounded recommendation
Record the Part 4 conclusion and the readiness recommendation in separate fields. Scope
any recommendation to the frozen candidate, stated users, purpose, capabilities, and
stage limits. Keep decision.authorized false: an accountable external decision-maker
records any actual approval and residual-risk acceptance outside this skill.
Recommend no_go when required evidence or a tested required control is missing,
invalid, inconclusive, or failed; a required authorization is unresolved; an applicable
hard gate/prohibited use fails; the candidate identity is not frozen; or an item remains
unmet. Do not call such a candidate production-ready.
Recommend conditional_go only if policy permits it, every pre-release evidence item
and control is complete, and each permitted post-release obligation has an owner, due
date, monitoring signal, and non-completion consequence. A test, review, authorization,
or control needed for the proposed exposure is pre-release and blocks this result.
Otherwise record a scoped go recommendation only when the ledger and rollout plan
support it; it remains a recommendation, not deployment permission.
Required output and verification
Produce one packet using assets/packet-template.json. Fill its frozen-candidate,
Part 4 handoff, readiness-ledger, exception, change-impact, support/disable-evidence,
staged-rollout, blocker, assumption, and recommendation fields with candidate-specific
facts or explicitly labelled draft gaps. Reference only workspace-confined observed
artifacts with their hashes; use planned/not-run evidence for future work.
Before handing off, verify that every met item has observed passing evidence; every
not_applicable item names an absent trigger; every required gap is visible in
blockers; exception proposals are not credited; no recommendation exceeds the stated
scope; and the packet contains no claim that documents, plans, or this skill itself
proved safety, authority, production readiness, or deployment.
Stop after producing the review packet and external-decision handoff. Do not sign, authorize, deploy, disable, run tests, alter a candidate, or execute a rollout.