# Readiness Report

> Delivers a structured production-readiness handoff — numbered items needing operator input, each classified pre-existing vs introduced and tagged with repo issue IDs, plus exact verification commands. Use when a multi-task build is ready for operator review, before a deploy gate, or when decisions are the operator's to make.

- Skill: `jcdavis131/readiness-report` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add jcdavis131/readiness-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jcdavis131/readiness-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: jcdavis131 (https://skillmd.com/u/jcdavis131)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/jcdavis131/readiness-report

---


# Readiness Report

The handoff is the most-read part of a long session. Structure beats prose; the operator acts item-by-item without re-deriving state.

## The shape

```
Needs your input to go to production

1. <Item> — <pre-existing|introduced> — <issue ID>.
2. ...

Ready for review: <seed command>, <serve command>, open <feature> on :<port>.
```

## Required elements

1. **Numbered list** — only items genuinely the operator's call (credentials, brand, spec sign-off, prod provisioning).
2. **Classify** pre-existing vs introduced this session.
3. **Tag with repo issue IDs** (SEC-003, BLK-PROD) — grep-able, not prose.
4. **Deliberate non-actions** — what was skipped and why (`document-non-action`).
5. **Exact kick-the-tires commands** — seed, serve, port; no "how do I see it?" step.

## What belongs in the list

Credentials, pricing/brand decisions, prod infra (Operator lane), spec sign-off, pre-existing security deferred without sign-off, evidence/claims that are product calls.

## What does NOT belong

Recap of what was built (`recap-on-long-session`), internal TODOs yours to finish, vague "review the code".

## Extended patterns

Open items with forward offers, release-gated prioritization, designed states, curated review tour, tool-gap alternatives: [reference.md](reference.md)

## Pair with

- `recap-on-long-session` · `document-non-action` · `validate-gate` · `respect-the-guard`