Product Definition template¶
Emit the definition in this shape. Every section is filled from evidence or moved to Open
Questions. No placeholders, no TBD. Each section carries an evidence grade (L1 to L5) and a source.
When the definition lands in BluCity-Docs, split it across the AUTHORITY-MATRIX files
(Vision.md, Architecture.md, API.md or Spec.md, Deployment.md or Runtime.md,
Roadmap.md) and use the corpus frontmatter.
---
bluefly_document: true
status: candidate # candidate | approved | canonical | deprecated
owner: <one accountable owner>
authority: Product Authority Matrix
created_at: <ISO 8601 with offset>
updated_at: <ISO 8601 with offset>
evidence_floor: L5 # lowest grade any load-bearing claim rests on
hypothesis_document: true # true until evidence_floor is L3 or better
derived_from: []
verified_against: []
---
EXECUTIVE DECISION PRODUCT_NAME, PRODUCT_TYPE (classification enum), PRODUCT_FAMILY,
PRODUCT_OWNER, ONE_SENTENCE_DEFINITION, COMMERCIAL_CATEGORY,
CURRENT_MATURITY, PRIMARY DECISION ("X is the product; do not create Y")
PRODUCT NAME checked against taxonomy and brand list
PRODUCT TYPE Product | Offering | Pack | Capability | Standard | ... (Stage 0)
PORTFOLIO PLACEMENT Mountain / Product / Offering; existing product it belongs to
FACTORY MAPPING Product -> Factory -> Outputs -> Domains -> Systems (one line each)
ONE-SENTENCE DEFINITION
PROBLEM in the customer's words
WHY NOW the change in the world
TRIGGER EVENTS what happens right before they buy
CURRENT ALTERNATIVES direct / indirect / internal / do nothing
JOB TO BE DONE thing vs outcome vs experience vs identity
TARGET MARKET category type and sizing method
ICP table per customer-psychology.md
USERS / BUYERS / CHAMPIONS / BLOCKERS the persona map, one line each, plus top objection
VALUE PROPOSITION customer, problem, outcome, mechanism, differentiator, proof
POSITIONING FOR / WHO / IS A / THAT / UNLIKE / IT
DIFFERENTIATION evidenced claims only; struck words listed
COMPETITIVE LANDSCAPE table with sources and dates
PRODUCT EXPERIENCE what it feels like end to end; the activation event
CORE CAPABILITIES each composed from a named upstream
WHAT THIS PRODUCT IS NOT explicit exclusions and neighbors it must not absorb
CUSTOM JUSTIFICATIONS only where no upstream covers the gap; name the gap
MVP hypothesis, top risk, smallest test, success criteria, date
RISKS / ASSUMPTIONS eight risks ranked with mitigations
EVIDENCE ladder position for each load-bearing claim
BUSINESS MODEL who pays whom, for what, when, why
PRICING (DRAFT) basis, strategy, tiers, caps; operator approval pending
COGS including model/API usage, labor, support, compliance
UNIT ECONOMICS (DRAFT) revenue, gross margin, CAC, LTV, payback, sensitivity
OFFER package, price, terms, acceptance, guarantee, onboarding, proof
SERVICE-TO-PRODUCT POSITION which rung today, which rung next, what earns the move
GTM channels (two to start), first ten prospect types
SALES MOTION chosen from evidence
DISTRIBUTION including product-native loops
COMMERCIAL WORK GATE buyer, problem, offer, outcome, proof, reuse, horizon, next action
BRAND which existing brand; personality and promise
MESSAGING name, tagline, one-liner, headline, subheadline, 3 benefits + proof, CTA
VISUAL STORY the one image and its caption; narrative arc in six sentences
ACTIVATION the observable "I get it" event
RETENTION why return, what improves with use, what makes leaving costly, churn triggers
GROWTH LOOPS the native loop or the honest absence of one
MOAT evidenced, or "none yet"
METRICS North Star plus AARRR, cost, reliability
LIFECYCLE STAGE discovery ... retirement
ROADMAP outcomes and betting sequence, three horizons
PRODUCT OWNER one name
KILL CRITERIA number, threshold, date, exit options
OPEN SOURCE BOUNDARY if any part is open (conditional)
ECOSYSTEM what Bluefly owns vs enables
EVIDENCE STATE every load-bearing claim tagged CANONICAL_POLICY /
CURRENT_PRODUCT_DIRECTION / CURRENT_SOURCE /
HISTORICAL_SUPERSEDED / NOT_ESTABLISHED, plus explicit
non-dependencies ("X required for MVP: NO")
OPEN QUESTIONS every section that could not be graded above L5, with the
next action that would resolve it
Derived artifacts (emit only what evidence supports)¶
positioning statement; pitch ladder (headline, sentence, 30 seconds, 2 minutes); competitive
analysis; MVP test plan; pricing sheet (DRAFT); offer sheet; GTM plan; roadmap; kill criteria;
factories/<sku>/factory.yaml patch when the product is a Factory SKU; Portfolio-Registry
offerings: entry; Beads for the next commercial action.
Governance block (append to every landed document)¶
<!-- BLUEFLY-DOC-GOVERNANCE
This is a governed Bluefly document.
Agents and humans making substantive changes MUST:
1. update `updated_at` in the YAML front matter;
2. never alter `created_at`;
3. preserve this governance block;
4. preserve authoritative content and provenance.
-->