{"version":"dtc-1.0","name":"DTC discovery playbook","scope":"Evidence-led content planning. Not a visibility score or proof of agent checkout.","categories":[{"id":"home","label":"Home & lighting","category":"Home","questions":[{"id":"warm-bedroom","prompt":"I need a warm lamp for a small bedroom.","title":"How to choose a bedside lamp for a small bedroom","path":"/guides/bedside-lighting-small-bedroom","answer":"Explain how dimensions, light temperature and dimming affect a bedside setup. Recommend a named variant only after verifying these facts.","facts":["Dimensions and required bedside clearance","Color temperature in kelvin, by bulb or variant","Dimming and switch compatibility","Included bulb, socket and plug region"],"avoid":"Do not infer warm light from a styled photograph. State when a bulb must be bought separately.","comparison":"Warm vs neutral light for bedtime reading","comparison_path":"/compare/warm-vs-neutral-reading-light"},{"id":"renter","prompt":"Can I install a wall light without drilling?","title":"Wall lighting for renters: what needs drilling?","path":"/guides/wall-lighting-without-drilling","answer":"Separate plug-in power from mounting requirements. Describe the actual mounting method, surface limitations and removal instructions.","facts":["Mounting method and fasteners","Supported wall surfaces and load limits","Cable length and socket requirements","Removal instructions and possible damage"],"avoid":"Plug-in does not mean drill-free. Never promise damage-free removal without evidence.","comparison":"Plug-in sconces vs portable table lamps","comparison_path":"/compare/plug-in-sconce-vs-table-lamp"},{"id":"table","prompt":"Will this dining table fit four people in my apartment?","title":"Measure a small dining space before choosing a table","path":"/guides/four-person-table-small-apartment","answer":"Give exact table dimensions, recommended chair clearance and the assumptions behind any seating claim.","facts":["Table dimensions and extensions","Chair and walking clearance assumptions","Delivery package size","Assembly and doorway requirements"],"avoid":"Show a worked measurement example, labeled as illustrative. Do not call every four-seat table suitable for a small room.","comparison":"Round vs rectangular tables in small spaces","comparison_path":"/compare/round-vs-rectangular-small-space"},{"id":"fabric","prompt":"Which sofa fabric is easiest to clean with a dog?","title":"Compare sofa fabrics for cleaning and everyday wear","path":"/guides/sofa-fabric-cleaning-pets","answer":"Explain the documented care method and fabric construction. Identify any tested durability claim and its source.","facts":["Fabric composition and weave","Published cleaning instructions","Removable cover and wash limits","Documented abrasion or stain-test results"],"avoid":"Do not turn easy-clean marketing into a pet-proof guarantee.","comparison":"Removable covers vs fixed upholstery","comparison_path":"/compare/removable-vs-fixed-sofa-covers"}]},{"id":"fashion","label":"Fashion & accessories","category":"Fashion","questions":[{"id":"commute","prompt":"I need a bag for cycling to work in the rain.","title":"Choose a commuting bag for wet-weather cycling","path":"/guides/rainy-cycle-commute-bag","answer":"Compare laptop fit, carried weight, closure and documented water resistance. Separate fabric resistance from assembled-bag protection.","facts":["Laptop compartment internal dimensions","Capacity and empty weight","Closure, seams and water-resistance evidence","Straps, fastening and visibility features"],"avoid":"Water-resistant is not waterproof. Do not invent a rain test or cycling endorsement.","comparison":"Backpack vs tote for a cycling commute","comparison_path":"/compare/backpack-vs-tote-cycle-commute"},{"id":"fit","prompt":"Which size should I choose between two sizes?","title":"Choose a size using garment measurements","path":"/guides/between-sizes-garment-fit","answer":"Show body and garment measurements separately. Explain fit preference and the return conditions for an uncertain choice.","facts":["Body size chart and garment dimensions","Fabric stretch and intended fit","Measurement method and tolerance","Size-exchange and return conditions"],"avoid":"Do not infer a customer's body or promise a perfect fit.","comparison":"Relaxed vs fitted cuts: how to measure","comparison_path":"/compare/relaxed-vs-fitted-cut"},{"id":"heat","prompt":"I want a shirt for humid summer weather.","title":"Compare shirt materials for humid weather","path":"/guides/shirt-materials-humid-weather","answer":"Publish composition, fabric weight where known, construction and care. Distinguish the physical specification from a comfort claim.","facts":["Fiber percentages","Fabric weight and weave","Cut and ventilation details","Care and shrinkage information"],"avoid":"Do not claim cooling performance without a substantiated test.","comparison":"Linen vs cotton: fabric facts and care","comparison_path":"/compare/linen-vs-cotton-shirts"},{"id":"gift","prompt":"I need a gift that will arrive before Friday.","title":"Check gift delivery before choosing an accessory","path":"/guides/accessory-gift-delivery-deadline","answer":"Use destination, live stock and processing time to explain the estimate. Show where the final delivery estimate is verified.","facts":["Exact variant stock","Destination coverage","Processing time and cutoff timezone","Carrier estimate and return eligibility"],"avoid":"Dispatch date is not arrival date. Do not promise a deadline from an undated policy.","comparison":"Ready-to-ship vs made-to-order gifts","comparison_path":"/compare/ready-to-ship-vs-made-to-order"}]},{"id":"beauty","label":"Beauty & personal care","category":"Beauty","questions":[{"id":"ingredients","prompt":"Where can I verify whether this gloss contains fragrance?","title":"Read the current ingredient list for a lip gloss","path":"/guides/lip-gloss-ingredient-verification","answer":"Link the complete ingredient list for the exact variant and identify its update date. Explain any unresolved formulation difference.","facts":["Complete current ingredient list","Exact product and variant identity","Fragrance wording and formulation source","Update date and relevant market"],"avoid":"Do not infer safety, allergy suitability or ingredient absence from marketing copy.","comparison":"Compare two gloss formulations using their ingredient lists","comparison_path":"/compare/lip-gloss-formulations"},{"id":"shade","prompt":"Which shade is closest to the one I already use?","title":"Compare shades with consistent swatches","path":"/guides/compare-lip-shades-swatches","answer":"Show swatches under documented lighting, shade identifiers and finish. Describe where the comparison remains subjective.","facts":["Shade name and stable variant ID","Swatch lighting and capture conditions","Finish and opacity","Comparison source and limitations"],"avoid":"Screens and lighting change color. Do not guarantee an exact match from a photograph.","comparison":"Sheer vs opaque finishes","comparison_path":"/compare/sheer-vs-opaque-lip-finish"},{"id":"refill","prompt":"Can I refill this bottle instead of replacing it?","title":"Check refill compatibility before buying","path":"/guides/refill-bottle-compatibility","answer":"Identify the matching refill and bottle versions. Give the documented refill instructions and limitations.","facts":["Bottle version and refill SKU","Compatibility statement","Refill volume and instructions","Packaging and disposal information"],"avoid":"Do not turn a refill option into an unsupported environmental-impact claim.","comparison":"Refill pouch vs replacement bottle: compatibility and quantities","comparison_path":"/compare/refill-vs-replacement-bottle"},{"id":"returns","prompt":"Can I return a shade if it looks different at home?","title":"Understand cosmetic return conditions before ordering","path":"/guides/cosmetic-shade-return-conditions","answer":"Explain opened and unopened product rules, market restrictions, time limits and the documented process.","facts":["Opened-product eligibility","Return window and start date","Country-specific conditions","Fees and refund or exchange process"],"avoid":"Do not imply trial eligibility unless the policy expressly provides it.","comparison":"Shade samples vs full-size purchases","comparison_path":"/compare/shade-sample-vs-full-size"}]}],"launch_pages":[{"type":"Use-case guides","count":4,"purpose":"One useful answer for each of the four selected shopping tasks. Link the exact qualifying variants and the original evidence."},{"type":"Honest comparisons","count":3,"purpose":"Compare measurable attributes and exclusions. Begin with product types or your own variants; use competitors only with dated primary evidence."},{"type":"Fit and compatibility guides","count":2,"purpose":"Resolve sizing, installation or formulation identity with a worked example and an acceptance check."},{"type":"Product facts index","count":1,"purpose":"A canonical index of product and variant facts that points to the source of truth. Reuse existing product pages instead of duplicating them."},{"type":"Purchase conditions","count":1,"purpose":"Connect delivery, returns and availability to their existing current policies. Do not create duplicate policies."},{"type":"Material product updates","count":1,"purpose":"Record real changes to formulation, compatibility, availability or documentation. Never manufacture weekly news."}],"rollout":[{"stage":"Week 1","title":"Choose the questions","deliverable":"Collect actual support questions and search queries. Prioritize four repeated tasks. Save a benchmark baseline and verify the required product facts."},{"stage":"Week 2","title":"Publish the answers","deliverable":"Ship the first four guides, linked from products and relevant collections. Publish HTML and plain-text versions from the same content source."},{"stage":"Week 3","title":"Connect the catalog","deliverable":"Keep variant IDs, prices, currency, inventory and policies consistent. Review supported Shopify agentic channels in Admin; eligibility and checkout routes vary."},{"stage":"Week 4","title":"Test and improve","deliverable":"Rerun the same shopping tasks, record evidence and unknowns, then remeasure the site. Expand content only where a real unanswered question remains."}],"measurement":[{"name":"Answer coverage","method":"Answered required facts / required facts, with source links. Unverified statements count as unknown."},{"name":"Variant accuracy","method":"Correct variant selections / test tasks requiring a variant. Confirm identity against the canonical catalog."},{"name":"Unsupported claims","method":"Count recommendations containing claims not supported by published evidence; inspect each one."},{"name":"Outcome","method":"Track qualified product visits and consented conversion events separately from the HTML benchmark. Do not infer sales from a score."}],"sources":[{"title":"Railway agent tooling","url":"https://docs.railway.com/agents"},{"title":"Shopify product discovery","url":"https://help.shopify.com/en/manual/online-sales-channels/agentic-storefronts/products"},{"title":"Shopify catalog interfaces","url":"https://shopify.dev/docs/agents/catalog"},{"title":"Google product variants","url":"https://developers.google.com/search/docs/appearance/structured-data/product-variants"}],"guardrails":["No guaranteed model recommendations, search rankings or revenue outcomes.","No published product fact without an identified source. Unknown values remain unknown.","No competitor claim without dated, comparable evidence.","No live cart, purchase, account or payment action without explicit authorization.","Agent discovery files are a convenience, not proof of integration with a model or commerce platform.","Preserve human usability, original brand voice and the existing checkout."]}