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.
1---
2name: product
3description: 'Create or refine PRODUCT.md while separating evidence, aspiration, users, value, and non-goals. Triggers: "product", "create PRODUCT.md", "product boundary".'
4practices: [lean-startup, ddd-bounded-context]
5hexagonal_role: domain
6consumes: []
7produces: [PRODUCT.md]
8context_rel:
9- kind: supplier-to
10 with: plan
11skill_api_version: 1
12user-invocable: true
13context:
14 window: inherit
15 intent:
16 mode: task
17metadata:
18 tier: product
19 dependencies: []
20 capabilities: [shape_product_boundary]
21 effects: [write_product_document]
22 canonical_status: canonical
23 disposition: keep_specialist
24output_contract: PRODUCT.md
25---
26
27# Product
28
29Create or refine a product contract with the user's authority.
30
31The contract works because it forces every claim into evidence or labeled
32aspiration; if a reader cannot tell which is which, the document has failed.
33
341. Inspect existing product, README, goals, release, and evidence sources.
352. Ask only for decisions that cannot be grounded safely from those sources.
363. State mission, users, pains, value, differentiation, and non-goals. For
37 this repository's own product surfaces, start from the canonical category
38 in `docs/contracts/ubiquitous-language.md` (AgentOps is the operations
39 layer for agentic engineering) and preserve the small ownership boundary —
40 never re-frame AgentOps as an execution orchestrator, factory, or loop.
414. Separate evidence from hope under two required headings. Put every grounded
42 claim under `## Proven`, each carrying a resolvable citation (a README,
43 release, test, or evidence source). Put unproven hopes, evidence gaps, and
44 not-yet-measured success signals under `## Assumptions`. A claim that cannot
45 cite a source belongs under `## Assumptions`, never `## Proven`.
465. Preserve an existing PRODUCT.md unless the user authorizes replacement.
476. Return the document to the caller; Plan may use it as intent context.
48
49Named failure mode — **aspiration laundering**: an unproven hope written in the
50`## Proven` section; once laundered, every downstream plan inherits a false
51premise. Detector: any `## Proven` claim without a resolvable citation is a
52laundered aspiration — move it to `## Assumptions` or cite it.
53
54Anti-pattern: rewriting a healthy PRODUCT.md wholesale because the session has
55fresh opinions. Corrective: refine only the sections the user asked to change
56and preserve the rest byte-for-byte.
57
58Product does not select work, invoke a loop, repair itself, validate itself, or
59choose delivery.
boshu2