{"description":"Important files and directories for agents traversing this website reference repo.","files":[{"group":"Agent orientation","files":[{"path":"AGENTS.md","purpose":"Non-negotiable repo rules for future agents."},{"path":"docs/system-purpose.md","purpose":"North-star definition of what this system is, is not, and must prove."},{"path":"docs/product-roadmap.md","purpose":"Priority-ordered product roadmap for executing every value multiplier."},{"path":"docs/site-expansion-execution-track.md","purpose":"Durable execution track for filling out the site with studies, fixtures, infrastructure, design, copy, simulations, stress tests, docs, and demo builds."},{"path":"docs/agent-playbook.md","purpose":"Full adaptation workflow and definition of done."},{"path":"docs/deployment-runbook.md","purpose":"Gated Cloudflare Pages deployment path: required decisions, deploy sequence, and post-deploy production evidence."},{"path":"deploy.sh","purpose":"Guarded deploy script; refuses to run without explicit confirmation, account ID, Pages project, and canonical URL."},{"path":"README.md","purpose":"Human-readable starter overview and command list."}]},{"group":"Site identity and routing","files":[{"path":"src/site.config.ts","purpose":"Site name, URL, contact data, address, social profiles, and AI policy."},{"path":"src/data/navigation.ts","purpose":"Primary navigation."},{"path":"src/data/agent-reference.ts","purpose":"Agent-facing pages, machine endpoints, examples, QA contract, workflows, and file map."},{"path":"astro.config.mjs","purpose":"Astro config, site URL, and trailing slash behavior."}]},{"group":"Machine-readable endpoints","files":[{"path":"src/pages/agent-manifest.json.ts","purpose":"Structured agent entry manifest."},{"path":"src/pages/file-map.json.ts","purpose":"Structured repo file map."},{"path":"src/pages/qa-contract.json.ts","purpose":"Structured quality contract."},{"path":"src/pages/examples.json.ts","purpose":"Structured examples catalog."},{"path":"src/pages/agent-tasks.json.ts","purpose":"Structured future-agent backlog."},{"path":"src/pages/product-roadmap.json.ts","purpose":"Structured product roadmap endpoint."},{"path":"src/pages/walkthroughs.json.ts","purpose":"Structured step-by-step walkthrough endpoint."},{"path":"src/pages/contract-registry.json.ts","purpose":"Formal JSON contract registry endpoint."},{"path":"src/pages/site-studies.json.ts","purpose":"Structured real-site study endpoint."},{"path":"src/pages/seo-aeo-evaluation.json.ts","purpose":"Structured SEO/AEO evaluation endpoint."},{"path":"src/pages/source-traceability.json.ts","purpose":"Structured source-to-site traceability endpoint."},{"path":"src/pages/site-type-playbooks.json.ts","purpose":"Structured site-type build playbook endpoint."},{"path":"src/pages/page-patterns.json.ts","purpose":"Structured reusable page-pattern endpoint."},{"path":"src/pages/page-pattern-fixtures.json.ts","purpose":"Structured inventory of concrete page-pattern fixture routes."},{"path":"src/pages/fixtures/design-system/","purpose":"Concrete design-system fixture routes for agent-operable UI patterns."},{"path":"src/pages/conversion-copy.json.ts","purpose":"Structured conversion copy system endpoint."},{"path":"src/pages/offer-ecosystem.json.ts","purpose":"Structured offer-ecosystem funnel endpoint."},{"path":"src/pages/infrastructure-decisions.json.ts","purpose":"Structured infrastructure decision system endpoint."},{"path":"src/pages/browser-visual-qa.json.ts","purpose":"Structured browser visual QA contract endpoint."},{"path":"src/pages/crawl-evidence.json.ts","purpose":"Structured crawl evidence contract endpoint."},{"path":"src/pages/design-system-contracts.json.ts","purpose":"Structured design-system contract endpoint."},{"path":"src/pages/aeo-geo-context.json.ts","purpose":"Structured AEO/GEO model context contract endpoint."},{"path":"src/pages/why-explanations.json.ts","purpose":"Structured why-explanations contract endpoint."},{"path":"src/pages/real-site-comparisons.json.ts","purpose":"Structured real-site comparison contract endpoint."},{"path":"src/pages/handoff-reports.json.ts","purpose":"Structured handoff report contract endpoint."},{"path":"src/pages/llms.txt.ts","purpose":"Concise LLM index."},{"path":"src/pages/llms-full.txt.ts","purpose":"Expanded LLM summary."},{"path":"src/pages/sitemap.xml.ts","purpose":"Sitemap generation."},{"path":"src/pages/schemamap.xml.ts","purpose":"Schema discovery map."},{"path":"src/pages/robots.txt.ts","purpose":"Crawler policy."}]},{"group":"Quality automation","files":[{"path":"scripts/spec-audit.mjs","purpose":"Static required-file audit."},{"path":"scripts/qa-routes.mjs","purpose":"Route, link, and sitemap checks."},{"path":"scripts/qa-seo.mjs","purpose":"Metadata, canonical, H1, OG, and JSON-LD checks."},{"path":"scripts/qa-aeo.mjs","purpose":"LLM endpoint, schema endpoint, and AEO contract checks."},{"path":"scripts/qa-browser.mjs","purpose":"Browser screenshot, viewport overflow, visible H1, accessibility heuristic, and visual report checks."},{"path":"scripts/qa-crawl.mjs","purpose":"Screaming Frog CSV export summarizer and crawl evidence report checks."},{"path":"scripts/qa-copy-stress.mjs","purpose":"Stress tests weak-to-stronger conversion copy transformations against the copy contract."},{"path":"scripts/qa-page-pattern-fixtures.mjs","purpose":"Stress tests concrete page-pattern fixture routes, section coverage, pattern mapping, and report evidence."},{"path":"scripts/qa-playbook-simulation.mjs","purpose":"Stress tests every site-type playbook with simulated builds and negative controls for inputs, patterns, schema, claims, QA gates, and risk honesty."},{"path":"scripts/qa-crawl-stress.mjs","purpose":"License-free static-export crawler enforcing link health, redirect budgets, sitemap reachability, and response budgets with synthetic negative controls."},{"path":"scripts/publish-evidence.mjs","purpose":"Publishes the latest accepted QA reports to public/evidence/ with workstation paths redacted."},{"path":"scripts/qa-performance.mjs","purpose":"Measures local LCP/CLS per route via Playwright and enforces asset budgets and page rules with negative controls."},{"path":"scripts/qa-demo-build.mjs","purpose":"Validates the canonical demo build against its playbook, simulation record, claim ledger, schema requirements, and blocked phrases with negative controls."},{"path":"scripts/qa-agent-simulation.mjs","purpose":"Simulates future-agent use from the main URL and saves scenario evidence."},{"path":"scripts/qa-contract-drift.mjs","purpose":"Runs live contract checks plus negative drift fixtures for endpoints, schemas, sources, and evidence."},{"path":"scripts/qa-domain.mjs","purpose":"Checks local static route readiness and optional production domain variants via QA_PRODUCTION_URL."},{"path":"scripts/qa-handoff.mjs","purpose":"Generates a current handoff report from QA, contract, crawl, browser, domain, and agent-simulation evidence."},{"path":"scripts/qa-nectiv-lessons.mjs","purpose":"Turns Nectiv-derived SEO/AEO lessons into dedicated local guardrail checks and production-evidence warnings."},{"path":"scripts/qa-common.mjs","purpose":"Shared static server and parsing helpers for QA scripts."}]},{"group":"Source retention","files":[{"path":"data/sources/raw/","purpose":"Immutable raw source archive."},{"path":"data/sources/manifests/","purpose":"Source manifests and provenance notes."},{"path":"data/working/","purpose":"Cleaned or transformed source material."},{"path":"data/derived/","purpose":"Generated briefs, summaries, copy, and QA outputs."},{"path":"data/sources/manifests/example-client-discovery.md","purpose":"Example source manifest for a fictional site build."},{"path":"data/working/example-client-facts.json","purpose":"Example cleaned public-safe fact set derived from raw inputs."},{"path":"data/derived/example-page-brief.json","purpose":"Example page brief connecting source facts to page, schema, SEO, and AEO requirements."},{"path":"data/derived/example-crawl-export/","purpose":"Example Screaming Frog-style crawl exports used by qa:crawl."},{"path":"data/derived/aeo-geo-context/","purpose":"Example prompt and answer-evidence fixtures for AEO/GEO model context checks."},{"path":"data/derived/copy-stress/copy-stress-fixtures.json","purpose":"Weak-to-stronger copy stress fixtures used by qa:copy."},{"path":"data/derived/playbook-simulations/playbook-simulation-fixtures.json","purpose":"Fictional simulated build fixtures for every site-type playbook used by qa:playbooks."},{"path":"data/sources/manifests/demo-brightline-gutter-discovery.md","purpose":"Fictional source manifest for the canonical demo build."},{"path":"data/working/demo-brightline-facts.json","purpose":"Cleaned fictional facts and blocked claims for the canonical demo build."},{"path":"data/derived/demo-brightline-page-brief.json","purpose":"Page brief connecting demo facts to routes, patterns, schema, claims, and QA gates."},{"path":"src/pages/demo/brightline/","purpose":"Canonical demo routes: a fictional local-service site executing the local service playbook end to end."},{"path":"src/pages/demo/logpilot/","purpose":"Second canonical demo: a fictional B2B SaaS site executing the B2B SaaS playbook with its own brand tokens."},{"path":"data/sources/manifests/demo-logpilot-discovery.md","purpose":"Fictional source manifest for the SaaS demo build."},{"path":"data/working/demo-logpilot-facts.json","purpose":"Cleaned fictional facts and blocked claims for the SaaS demo build."},{"path":"data/derived/demo-logpilot-page-brief.json","purpose":"Page brief for the SaaS demo build."},{"path":"reports/demo/","purpose":"Generated canonical demo build QA evidence."},{"path":"reports/performance/","purpose":"Generated performance budget and Core Web Vitals measurement evidence."},{"path":"data/sources/manifests/hormozi-conversion-copy-study-2026-06-06.md","purpose":"Public source-study manifest for conversion copy patterns inspired by Alex Hormozi and Acquisition.com."},{"path":"reports/browser/","purpose":"Generated browser QA screenshots, visual diff images, and layout/keyboard/accessibility report."},{"path":"tests/browser/baselines/","purpose":"Committed screenshot baselines for visual diff; update intentionally with QA_UPDATE_BASELINES=1 npm run qa:browser."},{"path":"reports/crawl/","purpose":"Generated crawl evidence reports and saved crawl summaries."},{"path":"reports/seo-aeo/","purpose":"Generated SEO/AEO guardrail reports, including Nectiv-derived lesson checks."},{"path":"reports/agent-simulation/","purpose":"Generated future-agent simulation evidence from main URL scenarios."},{"path":"reports/contracts/","purpose":"Generated contract drift and negative-fixture evidence."},{"path":"reports/copy-stress/","purpose":"Generated copy stress-test evidence."},{"path":"reports/page-pattern-fixtures/","purpose":"Generated page-pattern fixture route stress-test evidence."},{"path":"reports/playbooks/","purpose":"Generated site-type playbook simulated-build stress-test evidence."},{"path":"reports/domain/","purpose":"Generated static route and optional production domain evidence."},{"path":"reports/handoff/example-handoff-report.json","purpose":"Example handoff report fixture for final closeout evidence."},{"path":"reports/handoff/generated-handoff-report.json","purpose":"Generated current handoff report from the latest QA evidence."}]},{"group":"Contract schemas","files":[{"path":"public/schemas/agent-manifest.schema.json","purpose":"Validates the top-level agent manifest shape."},{"path":"public/schemas/file-map.schema.json","purpose":"Validates file-map groups and paths."},{"path":"public/schemas/qa-contract.schema.json","purpose":"Validates QA command contract."},{"path":"public/schemas/examples.schema.json","purpose":"Validates reusable example blueprints."},{"path":"public/schemas/agent-tasks.schema.json","purpose":"Validates future-agent backlog items."},{"path":"public/schemas/product-roadmap.schema.json","purpose":"Validates product roadmap items."},{"path":"public/schemas/walkthroughs.schema.json","purpose":"Validates roadmap walkthrough items."},{"path":"public/schemas/contract-registry.schema.json","purpose":"Validates the formal contract registry."},{"path":"public/schemas/site-studies.schema.json","purpose":"Validates real-site study items."},{"path":"public/schemas/seo-aeo-evaluation.schema.json","purpose":"Validates SEO/AEO evaluation checks."},{"path":"public/schemas/source-traceability.schema.json","purpose":"Validates source-to-site traceability records."},{"path":"public/schemas/site-type-playbooks.schema.json","purpose":"Validates site-type build playbooks."},{"path":"public/schemas/page-patterns.schema.json","purpose":"Validates reusable page patterns."},{"path":"public/schemas/page-pattern-fixtures.schema.json","purpose":"Validates concrete page-pattern route fixtures."},{"path":"public/schemas/conversion-copy.schema.json","purpose":"Validates conversion copy system."},{"path":"public/schemas/offer-ecosystem.schema.json","purpose":"Validates offer-ecosystem funnel system."},{"path":"public/schemas/infrastructure-decisions.schema.json","purpose":"Validates infrastructure decision system."},{"path":"public/schemas/browser-visual-qa.schema.json","purpose":"Validates browser visual QA contract."},{"path":"public/schemas/crawl-evidence.schema.json","purpose":"Validates crawl evidence contract."},{"path":"public/schemas/design-system-contracts.schema.json","purpose":"Validates design-system contract."},{"path":"public/schemas/aeo-geo-context.schema.json","purpose":"Validates AEO/GEO model context contract."},{"path":"public/schemas/why-explanations.schema.json","purpose":"Validates why-explanations contract."},{"path":"public/schemas/real-site-comparisons.schema.json","purpose":"Validates real-site comparison contract."},{"path":"public/schemas/handoff-reports.schema.json","purpose":"Validates handoff report contract."}]}],"source_retention_model":[{"stage":"raw","directory":"data/sources/raw/","purpose":"Immutable source material exactly as received or captured.","example":"data/sources/raw/specification-website-llms-2026-06-02.txt"},{"stage":"manifest","directory":"data/sources/manifests/","purpose":"Human-readable provenance notes describing source origin, date, permissions, and use constraints.","example":"data/sources/manifests/example-client-discovery.md"},{"stage":"working","directory":"data/working/","purpose":"Cleaned, normalized, or public-safe facts derived from raw sources.","example":"data/working/example-client-facts.json"},{"stage":"derived","directory":"data/derived/","purpose":"Generated briefs, content outlines, QA summaries, and implementation-ready artifacts.","example":"data/derived/example-page-brief.json"}]}