{"description":"Structured site-type build playbooks with inputs, page models, build sequence, SEO/AEO requirements, traceability rules, QA gates, stress tests, and completion criteria.","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.","playbooks":[{"id":"local-service-build-playbook","exampleId":"local-service","title":"Local service website build playbook","objective":"Build a local service site that proves service scope, geography, trust, contact paths, and crawlable local relevance without unsupported claims.","bestFor":["Home services","Field services","Local professional operators","Service-area businesses"],"requiredInputs":["Verified business identity","Service list","Service area","Contact details","Licensing or qualification facts","Approved proof","Source manifest"],"pageModel":[{"routePattern":"/","purpose":"Entity summary, service-area fit, proof, and primary contact path.","requiredSchema":["LocalBusiness","WebSite","FAQPage"]},{"routePattern":"/services/","purpose":"Service category hub with links to detail pages.","requiredSchema":["Service","BreadcrumbList"]},{"routePattern":"/service-areas/","purpose":"Service-area proof and local relevance.","requiredSchema":["LocalBusiness","BreadcrumbList"]},{"routePattern":"/proof/","purpose":"Approved reviews, case studies, credentials, and source-backed trust.","requiredSchema":["Review","CreativeWork"]},{"routePattern":"/contact/","purpose":"Fast, crawlable contact route with location and service-fit context.","requiredSchema":["ContactPage","LocalBusiness"]}],"buildSequence":["Create or update source manifest and cleaned public-safe facts.","Configure identity, service area, contact data, and canonical site URL.","Build homepage, services, proof, resources/FAQ, and contact routes from allowed claims.","Add schema only for visible and source-backed facts.","Update sitemap, llms endpoints, manifest, examples, traceability, and QA contracts.","Run qa:all, then browser and crawl checks before launch."],"seoAeoRequirements":["Unique local-service metadata","One H1 per indexable page","Service-area facts visible in copy and schema","Direct answers for services offered, where served, and how to contact","llms-full.txt includes service scope and canonical routes"],"traceabilityRequirements":["Every service, area, credential, review, and comparative claim maps to source_traceability","Blocked claims cannot appear in metadata, schema, page copy, or LLM summaries"],"qaGates":["npm run qa:all","Source traceability audit","Mobile contact path check","Screaming Frog crawl before launch"],"stressTests":["Ask an agent to identify service area and services from only the main URL","Attempt to add an unproved fastest/best claim and confirm traceability blocks it","Remove a service page from sitemap and confirm route/sitemap QA catches it"],"completionCriteria":["All required pages exist or are explicitly waived","Service and local claims trace to allowed sources","Schema matches visible content","qa:all passes","Crawl/browser evidence is saved for launch work"],"objectiveAlignment":"Turns a common business-site type into a source-backed, crawlable, answer-ready build path."},{"id":"b2b-saas-build-playbook","exampleId":"b2b-saas","title":"B2B SaaS website build playbook","objective":"Build a SaaS site that makes category, product, use cases, integrations, comparisons, proof, and security facts inspectable.","bestFor":["B2B SaaS","AI products","Developer tools","Security/compliance platforms"],"requiredInputs":["Product positioning","Feature facts","Use cases","Integration list","Security/compliance notes","Customer proof","Comparison claim policy"],"pageModel":[{"routePattern":"/","purpose":"Category and product positioning with proof and primary conversion path.","requiredSchema":["Organization","SoftwareApplication","WebSite"]},{"routePattern":"/product/","purpose":"Product capabilities, use boundaries, and feature proof.","requiredSchema":["SoftwareApplication","Product"]},{"routePattern":"/use-cases/","purpose":"Buyer/problem mapping by role, industry, or workflow.","requiredSchema":["CollectionPage","BreadcrumbList"]},{"routePattern":"/integrations/","purpose":"Entity pages for integrations and ecosystem relevance.","requiredSchema":["SoftwareApplication","BreadcrumbList"]},{"routePattern":"/comparison/","purpose":"Sourced comparison pages with caveats and no unsupported competitor claims.","requiredSchema":["FAQPage","Article"]}],"buildSequence":["Validate product claims and feature boundaries before page copy.","Build product and use-case pages before comparison pages.","Create integration/entity pages only for verified integrations.","Add proof and security/compliance facts with source references.","Update schemas, llms endpoints, sitemap, traceability, and evaluation checks together.","Run qa:all plus claim/proof review."],"seoAeoRequirements":["Product/category title clarity","Use-case pages answer who it is for and when to use it","Comparison FAQs include caveats","Integration pages use stable entity names","AEO summaries avoid unsupported superiority claims"],"traceabilityRequirements":["Feature, integration, compliance, security, customer, and comparison claims require source IDs","Competitor claims require explicit approval and evidence"],"qaGates":["npm run qa:all","Claim/proof traceability review","Structured data review","Comparison claim review"],"stressTests":["Ask an agent to explain product fit without prior chat","Try to add an unverified integration and confirm source traceability blocks it","Remove a caveat from a comparison claim and confirm review criteria catches it"],"completionCriteria":["Product, use-case, integration, proof, and comparison paths are defined","Claims are source-backed","Schema matches visible product facts","qa:all passes","Remaining unsupported claims are documented as blocked"],"objectiveAlignment":"Gives agents a rigorous path for complex product sites where unsupported claims are high risk."},{"id":"professional-services-build-playbook","exampleId":"professional-services","title":"Professional services website build playbook","objective":"Build a trust-heavy services site with clear scope, qualification, process, industry fit, proof, and expert content.","bestFor":["Consultancies","Agencies","Law/accounting/advisory firms","Specialized practices"],"requiredInputs":["Service scope","Practitioner/team credentials","Engagement process","Industry experience","Approved proof","Author attribution policy"],"pageModel":[{"routePattern":"/","purpose":"Positioning, service fit, qualifications, proof, and contact path.","requiredSchema":["ProfessionalService","Organization","Person"]},{"routePattern":"/services/","purpose":"Service scope and engagement model.","requiredSchema":["Service","BreadcrumbList"]},{"routePattern":"/industries/","purpose":"Industry-specific fit and caveats.","requiredSchema":["CollectionPage","BreadcrumbList"]},{"routePattern":"/about/","purpose":"Practitioner/entity trust, credentials, and source-backed background.","requiredSchema":["Person","Organization"]},{"routePattern":"/insights/","purpose":"Expert content with attribution and source-safe recommendations.","requiredSchema":["Article","BreadcrumbList"]}],"buildSequence":["Separate service scope from credentials and proof.","Build service and industry pages with non-overlapping intent.","Add practitioner/team facts only when approved for public use.","Create proof and insight pages with attribution and source checks.","Update schema IDs, author facts, llms endpoints, and source traceability.","Run qa:all and proof/credential review."],"seoAeoRequirements":["Service and industry pages have distinct titles and H1s","Author/entity attribution is visible","FAQs answer scope, process, fit, and qualification questions","Schema does not imply credentials not visible on page"],"traceabilityRequirements":["Credentials, results, client names, testimonials, and industry experience require approved sources","Regulated claims require extra review before publication"],"qaGates":["npm run qa:all","Credential/source review","Accessibility review for dense content","Author/entity schema review"],"stressTests":["Ask an agent to distinguish service scope from industry fit","Try to add a credential without source proof and confirm it is blocked","Check that insight pages have visible attribution"],"completionCriteria":["Services, industries, about/trust, insights, proof, and contact paths are clear","Credentials and proof are source-backed","Schema mirrors visible facts","qa:all passes"],"objectiveAlignment":"Helps agents build trust-heavy sites without inventing credentials, proof, or regulated claims."},{"id":"proof-library-build-playbook","exampleId":"proof-page","title":"Proof library build playbook","objective":"Build a proof system where testimonials, case studies, metrics, screenshots, and before/after claims are permissioned and inspectable.","bestFor":["Case-study sections","Proof hubs","Portfolio pages","Results libraries"],"requiredInputs":["Approved testimonials","Case-study facts","Metrics with date ranges","Before/after artifacts","Permission notes","Privacy constraints"],"pageModel":[{"routePattern":"/proof/","purpose":"Proof index with filters and source-safe summaries.","requiredSchema":["CollectionPage","Review"]},{"routePattern":"/proof/[case-study]/","purpose":"Case detail with source-backed problem, action, result, and constraints.","requiredSchema":["Article","CreativeWork"]},{"routePattern":"/testimonials/","purpose":"Approved review/testimonial inventory.","requiredSchema":["Review"]}],"buildSequence":["Collect proof artifacts and permission notes before writing copy.","Classify each proof item by public/private/sanitized status.","Build proof index and detail pages from approved facts only.","Add metrics with dates, scope, and caveats near the claim.","Use Review schema only for eligible visible reviews.","Run qa:all plus privacy/permission review."],"seoAeoRequirements":["Case-study titles use approved outcome language","Metrics include conditions and dates","Proof pages link back to relevant service/product pages","AEO answers do not strip away caveats"],"traceabilityRequirements":["Every testimonial, metric, logo, client name, screenshot, and outcome claim must map to permissioned source evidence","Private proof can be summarized only when approved"],"qaGates":["npm run qa:all","Permission/privacy review","Claim/source audit","Schema eligibility review"],"stressTests":["Attempt to publish a metric without date/context and confirm it is blocked","Ask an agent to find proof for a service claim","Confirm private proof cannot leak into LLM summaries"],"completionCriteria":["Every proof item has permission status","Every public claim has source evidence","Review schema is eligible and visible","qa:all passes","Remaining proof risks are listed"],"objectiveAlignment":"Makes proof reusable without turning it into unsupported or privacy-risky marketing claims."},{"id":"answer-ready-resource-build-playbook","exampleId":"answer-ready-resource","title":"Answer-ready resource build playbook","objective":"Build resource pages that answer concrete questions, expose stable entities, preserve caveats, and support search plus answer-engine retrieval.","bestFor":["Guides","Glossaries","Comparison hubs","FAQ clusters","AEO/GEO resources"],"requiredInputs":["Topic definitions","Question set","Approved recommendations","Comparison criteria","Public source references","Entity glossary"],"pageModel":[{"routePattern":"/resources/","purpose":"Resource hub by topic, entity, and buyer question.","requiredSchema":["CollectionPage","BreadcrumbList"]},{"routePattern":"/resources/[guide]/","purpose":"Direct answer plus deeper explanation and source links.","requiredSchema":["Article","FAQPage"]},{"routePattern":"/glossary/[term]/","purpose":"Stable entity/definition page.","requiredSchema":["DefinedTerm","BreadcrumbList"]},{"routePattern":"/compare/[topic]/","purpose":"Comparison criteria, caveats, and decision guidance.","requiredSchema":["Article","FAQPage"]}],"buildSequence":["Define the question set and entity glossary first.","Build concise answer blocks before long-form explanation.","Add caveats near recommendations and comparisons.","Link guides to glossary/entity pages and related proof.","Add Article, FAQPage, DefinedTerm, and BreadcrumbList schema where visible.","Run qa:all and internal-link/schema review."],"seoAeoRequirements":["Direct answer appears before nuance","Definitions are stable and internally linked","Comparison criteria are explicit","Caveats stay near recommendations","llms endpoints summarize canonical answers"],"traceabilityRequirements":["Definitions, recommendations, comparisons, and source references require approved source links or internal proof","Speculative answers must be marked as caveated or excluded"],"qaGates":["npm run qa:all","Internal-link crawl","Schema review","Source/reference review"],"stressTests":["Ask an agent to answer a target question from the page","Remove a glossary link and confirm internal-link review catches the gap","Try to make an uncaveated recommendation and confirm traceability flags it"],"completionCriteria":["Question set, guide pages, glossary/entity pages, and comparison pages are mapped","Direct answers and caveats are visible","Schema matches content","qa:all passes"],"objectiveAlignment":"Turns content into a model-readable answer system instead of a generic blog."}]}