product
Create or refine PRODUCT.md while separating evidence, aspiration, users, value, and non-goals. Triggers: "product", "create PRODUCT.md", "product boundary".
- 1,396
- installs
- 0 up / 0 down, score 0.00
- votes
- 450
- repo stars
- Updated
- less than a month ago
- In the catalog since
- 1 Oct 2026
- From
- boshu2/agentops
Skill instructions
Rendered from the published SKILL.md, 34 lines.
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. For
this repository's own product surfaces, start from the canonical category
in
docs/contracts/ubiquitous-language.md(AgentOps is the operations layer for agentic engineering) and preserve the small ownership boundary — never re-frame AgentOps as an execution orchestrator, factory, or loop. - 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.