{"description":"Structured source-to-site traceability policy, artifact chain, claim ledger, page usage, and QA requirements.","objective":"Give a future agent enough structure to start from the main URL and understand how to inspect, plan, build, validate, and improve a serious website without needing prior chat context.","traceability":{"policy":{"objective":"Prevent unsupported public claims by connecting page, SEO, schema, and AEO decisions to source artifacts.","why":"Agents can generate polished copy faster than they can verify it. The system must make source support explicit before content is treated as publishable.","rule":"A claim may appear on a public page only when it is present in a raw source, cleaned working fact, approved derived brief, or explicitly marked as fictional/example content.","blockedRule":"Comparative, numeric, testimonial, credential, price, guarantee, legal, medical, financial, and performance claims stay blocked until a source explicitly approves them."},"artifactChain":[{"stage":"raw","path":"data/sources/manifests/example-client-discovery.md","purpose":"Human-readable provenance and permission record for the fictional discovery source.","required":true},{"stage":"working","path":"data/working/example-client-facts.json","purpose":"Cleaned public-safe facts and blocked claims derived from the discovery source.","required":true},{"stage":"derived","path":"data/derived/example-page-brief.json","purpose":"Implementation-ready page brief connecting facts to page purpose, SEO, AEO, schema, and QA.","required":true}],"claimLedger":[{"id":"example-service-area-claim","claim":"Serves Phoenix-area residential and commercial customers.","status":"allowed","sourcePath":"data/working/example-client-facts.json","publicUse":"Allowed because this is a fictional fixture fact marked public-safe.","allowedLocations":["/","/services/","/contact/","LocalBusiness schema","llms-full.txt"],"requiredQualifier":"Keep the claim framed as fixture/example content until adapting to a real site."},{"id":"example-service-list-claim","claim":"Offers preventive maintenance, emergency repair, and system inspection.","status":"allowed","sourcePath":"data/working/example-client-facts.json","publicUse":"Allowed because service categories are listed in the cleaned public-safe fact set.","allowedLocations":["/services/","Service schema","FAQPage schema","llms-full.txt"],"requiredQualifier":"Do not add service details beyond the approved categories without new source evidence."},{"id":"fastest-response-claim","claim":"Fastest response time in the market.","status":"blocked","sourcePath":"data/working/example-client-facts.json","publicUse":"Blocked because comparative performance requires documented proof.","allowedLocations":[],"requiredQualifier":"Requires approved benchmark, methodology, market definition, and date range."},{"id":"hundreds-five-star-reviews-claim","claim":"Hundreds of five-star reviews.","status":"blocked","sourcePath":"data/working/example-client-facts.json","publicUse":"Blocked because review count and rating require an approved live source.","allowedLocations":[],"requiredQualifier":"Requires approved review source, count, rating, capture date, and permission to publish."},{"id":"demo-brightline-service-area-claim","claim":"Serves Alder, Birchfield, and Carver counties with two full-time crews (fictional demo fact).","status":"allowed","sourcePath":"data/working/demo-brightline-facts.json","publicUse":"Allowed inside the canonical demo because the fictional fact set marks it public-safe with the fictional framing preserved.","allowedLocations":["/demo/brightline/","/demo/brightline/service-areas/","/demo/brightline/contact/","LocalBusiness schema","llms-full.txt"],"requiredQualifier":"Must stay framed as fictional demo content."},{"id":"demo-brightline-service-list-claim","claim":"Provides gutter cleaning, gutter repair, gutter guard installation, and downspout maintenance (fictional demo fact).","status":"allowed","sourcePath":"data/working/demo-brightline-facts.json","publicUse":"Allowed inside the canonical demo because service categories come from the cleaned fictional fact set.","allowedLocations":["/demo/brightline/","/demo/brightline/services/","Service schema","FAQPage schema","llms-full.txt"],"requiredQualifier":"No service details beyond the approved categories without new source facts."},{"id":"demo-brightline-license-claim","claim":"Registered and insured for exterior contracting work, fictional registration EX-204-118.","status":"allowed","sourcePath":"data/working/demo-brightline-facts.json","publicUse":"Allowed inside the canonical demo because the fictional registration and insurance facts are recorded in the source chain.","allowedLocations":["/demo/brightline/proof/","LocalBusiness schema"],"requiredQualifier":"Must stay framed as fictional demo content."},{"id":"demo-brightline-review-claim","claim":"Four customers provided written permission to publish their reviews (fictional demo proof).","status":"allowed","sourcePath":"data/working/demo-brightline-facts.json","publicUse":"Allowed inside the canonical demo because each review carries a fictional permission note in the working fact set.","allowedLocations":["/demo/brightline/proof/","Review schema"],"requiredQualifier":"Review count must match the permissioned set exactly."},{"id":"demo-brightline-fastest-claim","claim":"Fastest gutter service in the region.","status":"blocked","sourcePath":"data/working/demo-brightline-facts.json","publicUse":"Blocked because the comparative speed claim has no measurable evidence even inside the fictional fact set.","allowedLocations":[],"requiredQualifier":"Requires an approved benchmark, methodology, market definition, and date range."},{"id":"demo-brightline-review-volume-claim","claim":"Five-star rated by hundreds of customers.","status":"blocked","sourcePath":"data/working/demo-brightline-facts.json","publicUse":"Blocked because only four permissioned reviews exist in the demo source chain.","allowedLocations":[],"requiredQualifier":"Requires an approved review source whose count and rating match the claim."},{"id":"demo-logpilot-feature-claim","claim":"Retains logs for configurable 30/90/365-day windows with immutable retention locks and CSV/JSON export (fictional demo fact).","status":"allowed","sourcePath":"data/working/demo-logpilot-facts.json","publicUse":"Allowed inside the canonical demo because the fictional engineering-confirmed feature facts mark these boundaries public-safe.","allowedLocations":["/demo/logpilot/","/demo/logpilot/product/","/demo/logpilot/use-cases/","SoftwareApplication schema","llms-full.txt"],"requiredQualifier":"Must stay framed as fictional demo content; no capability beyond the confirmed feature facts."},{"id":"demo-logpilot-integration-claim","claim":"Integrates with the six verified platforms listed on the integrations page (fictional demo fact).","status":"allowed","sourcePath":"data/working/demo-logpilot-facts.json","publicUse":"Allowed inside the canonical demo because the six integrations carry fictional engineering verification; the two unverified ones are excluded everywhere.","allowedLocations":["/demo/logpilot/","/demo/logpilot/integrations/","SoftwareApplication schema"],"requiredQualifier":"Integration count must match the verified list exactly."},{"id":"demo-logpilot-comparison-claim","claim":"Comparison pages state dated factual feature differences with caveats (fictional demo policy).","status":"allowed","sourcePath":"data/working/demo-logpilot-facts.json","publicUse":"Allowed because the comparison policy itself is the fact being demonstrated; individual comparisons carry their as-of dates inline.","allowedLocations":["/demo/logpilot/comparison/","FAQPage schema"],"requiredQualifier":"Every comparison row needs an as-of date; superiority adjectives are banned."},{"id":"demo-logpilot-unverified-integrations-claim","claim":"Integrates with two additional platforms currently in development.","status":"blocked","sourcePath":"data/working/demo-logpilot-facts.json","publicUse":"Blocked because the integrations are unverified in the fictional engineering confirmation.","allowedLocations":[],"requiredQualifier":"Requires verification evidence before any public mention."},{"id":"demo-logpilot-superiority-claim","claim":"More secure than every legacy log vendor.","status":"blocked","sourcePath":"data/working/demo-logpilot-facts.json","publicUse":"Blocked as an unsupported competitor superiority claim; the comparison policy allows only dated factual differences.","allowedLocations":[],"requiredQualifier":"No superiority language regardless of evidence; restate as a dated factual difference."}],"pageUsage":[{"route":"/services/","sourceBrief":"data/derived/example-page-brief.json","visibleClaims":["example-service-area-claim","example-service-list-claim"],"blockedClaims":["fastest-response-claim","hundreds-five-star-reviews-claim"],"seoRequirements":["Use approved service categories","State service area without unsupported superiority claims","Use production canonical URL"],"schemaRequirements":["Service facts must be visible on page","FAQPage facts must come from visible FAQs","LocalBusiness facts must match cleaned source facts"],"aeoRequirements":["Answer service scope directly","Preserve caveats near any claims requiring proof"]},{"route":"/demo/brightline/","sourceBrief":"data/derived/demo-brightline-page-brief.json","visibleClaims":["demo-brightline-service-area-claim","demo-brightline-service-list-claim"],"blockedClaims":["demo-brightline-fastest-claim","demo-brightline-review-volume-claim"],"seoRequirements":["State the fictional boundary visibly","Answer who, where, and what directly","Use unique demo metadata"],"schemaRequirements":["LocalBusiness facts must match the demo working facts","FAQPage facts must come from visible FAQs"],"aeoRequirements":["Direct answers for services offered, where served, and how to contact","No blocked superiority or volume phrasing"]},{"route":"/demo/logpilot/","sourceBrief":"data/derived/demo-logpilot-page-brief.json","visibleClaims":["demo-logpilot-feature-claim","demo-logpilot-integration-claim"],"blockedClaims":["demo-logpilot-unverified-integrations-claim","demo-logpilot-superiority-claim"],"seoRequirements":["State the fictional boundary visibly","Category and buyer clarity in title and H1","Unique demo metadata"],"schemaRequirements":["SoftwareApplication facts must match the demo working facts","No integration beyond the verified six"],"aeoRequirements":["Direct answers for what it does, who it serves, and what it does not do","No superiority or in-development phrasing"]},{"route":"/demo/brightline/proof/","sourceBrief":"data/derived/demo-brightline-page-brief.json","visibleClaims":["demo-brightline-review-claim","demo-brightline-license-claim"],"blockedClaims":["demo-brightline-review-volume-claim"],"seoRequirements":["Proof titles use approved outcome language","Review count matches the permissioned set"],"schemaRequirements":["Review schema only for visible permissioned reviews","Registration facts match the working fact set"],"aeoRequirements":["Proof claims keep their permission and date context"]}],"claimInstrumentation":{"objective":"Attach claim IDs directly to rendered copy, schema endpoints, and LLM summaries so unsupported claim use is machine-checkable.","pageSectionClaims":[{"route":"/services/","selector":"[data-claim-id]","attribute":"data-claim-id","claimIds":["example-service-area-claim","example-service-list-claim"],"why":"The services page is the fixture page where visible service area and service scope claims must be source-backed."},{"route":"/demo/brightline/","selector":"[data-claim-id]","attribute":"data-claim-id","claimIds":["demo-brightline-service-area-claim","demo-brightline-service-list-claim"],"why":"The demo homepage carries the entity, area, and service claims that the rest of the demo depends on."},{"route":"/demo/logpilot/","selector":"[data-claim-id]","attribute":"data-claim-id","claimIds":["demo-logpilot-feature-claim","demo-logpilot-integration-claim"],"why":"The SaaS demo homepage carries the feature and integration claims that the rest of the demo depends on."},{"route":"/demo/brightline/proof/","selector":"[data-claim-id]","attribute":"data-claim-id","claimIds":["demo-brightline-review-claim","demo-brightline-license-claim"],"why":"Proof claims are the highest-risk demo claims and must stay attached to their permissioned sources."}],"schemaClaimIds":[{"route":"/services/","endpoint":"/services/schema.json","claimIds":["example-service-area-claim","example-service-list-claim"],"why":"Service and area facts in schema must map to the same allowed claim IDs visible on the page."},{"route":"/contact/","endpoint":"/contact/schema.json","claimIds":["example-service-area-claim"],"why":"LocalBusiness/contact facts must keep service-area claims source-backed."},{"route":"/demo/brightline/","endpoint":"/demo/brightline/schema.json","claimIds":["demo-brightline-service-area-claim","demo-brightline-service-list-claim","demo-brightline-review-claim"],"why":"Demo schema facts must map to the same allowed claim IDs visible on the demo pages."},{"route":"/demo/logpilot/","endpoint":"/demo/logpilot/schema.json","claimIds":["demo-logpilot-feature-claim","demo-logpilot-integration-claim"],"why":"SaaS demo schema facts must map to the same allowed claim IDs visible on the demo pages."}],"llmSummaryClaimIds":["example-service-area-claim","example-service-list-claim","demo-brightline-service-area-claim","demo-brightline-service-list-claim","demo-logpilot-feature-claim"],"blockedClaimIds":["fastest-response-claim","hundreds-five-star-reviews-claim","demo-brightline-fastest-claim","demo-brightline-review-volume-claim","demo-logpilot-unverified-integrations-claim","demo-logpilot-superiority-claim"],"qaGates":["npm run qa:aeo","npm run qa:all"]},"qaRequirements":["Every artifact path must exist.","Every allowed claim must name at least one allowed location.","Every blocked claim must have no allowed locations.","Every page usage item must reference known claim IDs.","Rendered claim-bearing sections must expose known data-claim-id values.","Schema endpoints must include only allowed claimId or claimIds values.","LLM summaries must list allowed claim IDs and avoid blocked claim IDs.","Schema, SEO, AEO, and page copy may not use blocked claims."]}}