ready-product-leader.
What the skill pack does
The skill pack is an orchestration layer. The entrypoint (skills/ready-skill.md) acts as a router: it reads the situation, decides which specialist work is needed, and loads the right modules. Each module handles a focused domain — evidence, access, design, coding handoff, or perspective review — so agents load only what the task actually requires.
The skill does not prescribe internal code structure. Its job is to ensure coding agents know exactly what product outcome to build and have the evidence, access, designs, and proof policy to do it without avoidable blockers.
Package structure
| File | Role |
|---|---|
skills/ready-skill.md | Entrypoint — routes work, owns product-leadership stance |
skills/modules/*.md | Specialist modules — load on demand for focused task procedure |
skills/manifest.yaml | Package manifest — lists all portable files, load order, module ids |
How to use the skill pack
Load the skill pack in the correct order. Theload_order in manifest.yaml specifies:
ready/governance/product-orchestrator-charter.md— load your project’s orchestrator charter first so the agent has authority context before doing any work.skills/ready-skill.md— load the skill entrypoint second; from here the agent routes to specialist modules as gaps appear.
How to copy the skill pack into a project
Copy the files listed underportable_files in manifest.yaml as source text into the receiving project. Then:
- Register the copied files in the project’s standard-resource manifest.
- Record loaded file hashes in agent context manifests when running product agents.
- Treat the copied files as reviewable, versionable product resources — not locked binaries.
Package manifest reference
Input modes
The entrypoint supports three starting points for building a Ready tree.Human Documentation Only
Human Documentation Only
Use this mode when the project has planning docs, specs, strategy prose, design docs, or issue lists but no reliable codebase signal.The agent inventories the docs, extracts premise and intent candidates, identifies missing evidence and resources, preserves conflicts rather than averaging them, and creates draft primitives with evidence confidence markers. Facts are labelled as user-stated, doc-stated, inferred, stale, generated, or unresolved.
Codebase Only
Codebase Only
Use this mode when the project has code but little or no reliable product documentation.The agent inspects visible product surfaces (routes, APIs, schemas, tests, fixtures, configuration), infers current behavior, and separates that from approved direction. User problems and product motivations remain lower confidence until confirmed. Codebase-only trees are conservative by design.
From Scratch Discussion
From Scratch Discussion
Use this mode when the product is being discovered in conversation.The agent asks product-leader questions — starting broad, becoming concrete — to identify the user, problem, solution candidates, and next stage. It shapes the smallest useful stage, then builds the Ready tree and reviews it with you.
Product-leadership stance
The skill embodies a specific product-leadership philosophy baked intoready-skill.md:
- Start with the user’s problem. Premises before solutions, problems before technology choices.
- Separate evidence from truth. Docs, code, chat, and generated output are evidence. They become approved product truth only when committed to the tree.
- Preserve uncertainty. Use question cards, draft fields, low-confidence flags, and blocked states rather than guessing.
- Prefer a smaller next stage. Cut nice-to-have work until it clearly supports the next stage’s core promise.
- Keep implementation details out of primitives unless they are genuine product constraints, interfaces, standards, artifacts, services, or proof expectations.
Worker output contract
Every module and subagent returns the same set of fields so orchestration is predictable.| Field | What it contains |
|---|---|
findings | What the agent discovered about the current state |
evidence_refs | Sources, artifacts, or primitives that support the findings |
proposed_primitive_or_flag_edits | Specific edits to make to the tree |
uncertainty | What remains unresolved or low-confidence |
user_only_asks | Information only the user can provide |
safe_agent_gatherable_resources | What the agent can gather safely without user involvement |
readiness_recommendation | ready, draft, blocked, or cut |
Skill modules
Each module covers a specialist domain. Load them based on gaps, not ceremony.Evidence & Resource Review
Verify evidence, evaluate sample data, gather public resources, and create precise user-only asks when private data is needed.
Access Readiness
Identify every service, account, and credential needed; record safe references; create blocked flags when access is missing.
Design Artifact Readiness
Ensure mockups, flows, copy, states, assets, and component contracts exist before implementation begins.
Coding Handoff Readiness
Convert product truth into coding-agent-ready work packages with scope, proof, services, and blocker policy.
Perspective Review
Challenge the tree from psychological, physical, logical, evidence, design, and access perspectives before handoff.