Skill v1.0.3
currentLLM-judged scan95/100~3 modified, -2 removed
version: "1.0.3" name: product description: 'Create or refine PRODUCT.md while separating evidence, aspiration, users, value, and non-goals. Triggers: "product", "create PRODUCT.md", "product boundary".' practices: [lean-startup, ddd-bounded-context] hexagonal_role: domain consumes: [] produces: [PRODUCT.md] context_rel:
- kind: supplier-to
with: plan skill_api_version: 1 user-invocable: true context: window: inherit intent: mode: task intel_scope: topic metadata: tier: product dependencies: [] capabilities: [shape_product_boundary] effects: [write_product_document] canonical_status: canonical disposition: keep_specialist output_contract: PRODUCT.md
Product
Create or refine a product contract with the user's authority.
The contract works because it forces every claim into evidence or labeled aspiration; if a reader cannot tell which is which, the document has failed.
- Inspect existing product, README, goals, release, and evidence sources.
- Ask only for decisions that cannot be grounded safely from those sources.
- State mission, users, pains, value, differentiation, and non-goals.
- Separate evidence from hope under two required headings. Put every grounded
claim under ## Proven, each carrying a resolvable citation (a README, release, test, or evidence source). Put unproven hopes, evidence gaps, and not-yet-measured success signals under ## Assumptions. A claim that cannot cite a source belongs under ## Assumptions, never ## Proven.
- Preserve an existing PRODUCT.md unless the user authorizes replacement.
- Return the document to the caller; Plan may use it as intent context.
Named failure mode — aspiration laundering: an unproven hope written in the ## Proven section; once laundered, every downstream plan inherits a false premise. Detector: any ## Proven claim without a resolvable citation is a laundered aspiration — move it to ## Assumptions or cite it.
Anti-pattern: rewriting a healthy PRODUCT.md wholesale because the session has fresh opinions. Corrective: refine only the sections the user asked to change and preserve the rest byte-for-byte.
Product does not select work, invoke a loop, repair itself, validate itself, or choose delivery.