# Agent Website Reference

An agent-facing website operating system for learning, executing, and validating high-quality website builds.

This site is built for agents, not human marketing conversion.

## Key Pages

- [Home](https://agents.valyou.solutions/): An agent-facing website operating system for learning, executing, and validating high-quality website builds.
- [Agent Start](https://agents.valyou.solutions/agent-start/): Entry route for agents: what this repo is, how to inspect it, and the fastest path to competence.
- [Repo Map](https://agents.valyou.solutions/repo-map/): Human-readable and machine-oriented map of source files, generated endpoints, docs, data, and QA evidence.
- [Standards](https://agents.valyou.solutions/standards/): Website Specification category map translated into implementation responsibilities for this starter.
- [Workflows](https://agents.valyou.solutions/workflows/): Step-by-step workflows for adapting, validating, crawling, and handing off a serious website.
- [Examples](https://agents.valyou.solutions/examples/): Pattern examples agents can reuse for local service, B2B SaaS, professional services, proof, and FAQ pages.
- [Copy Lab](https://agents.valyou.solutions/copy-lab/): Conversion copy principles, good/bad examples, source boundaries, and agent workflow based on public offer/copy pattern study.
- [Page Pattern Fixtures](https://agents.valyou.solutions/fixtures/page-patterns/): Concrete route fixtures that turn page-pattern contracts into inspectable Astro pages with metadata, schema, traceability, and QA expectations.
- [Design System Fixtures](https://agents.valyou.solutions/fixtures/design-system/): Concrete design-system fixtures for endpoint rows, QA command blocks, evidence cards, pattern tables, and status badges.
- [QA Contract](https://agents.valyou.solutions/qa-contract/): Executable quality contract behind qa:routes, qa:seo, qa:aeo, and qa:all.

## Canonical Demo Build (Fictional)

Brightline Gutter Co. is fictional. Every identity, service, county, review, registration, and contact fact was invented for this demo and must never be reused as a real claim. LogPilot is fictional. Every product, feature, integration, security, customer, and comparison fact was invented for this demo and must never be reused as a real claim.

- [Brightline Gutter Co. Demo](https://agents.valyou.solutions/demo/brightline/): homepage-entity-summary implementation (fictional demo).
- [Demo Services](https://agents.valyou.solutions/demo/brightline/services/): service-offer-page implementation (fictional demo).
- [Demo Service Areas](https://agents.valyou.solutions/demo/brightline/service-areas/): schema-backed-detail-page implementation (fictional demo).
- [Demo Proof](https://agents.valyou.solutions/demo/brightline/proof/): proof-evidence-page implementation (fictional demo).
- [Demo Contact](https://agents.valyou.solutions/demo/brightline/contact/): contact-conversion-page implementation (fictional demo).
- [LogPilot Demo](https://agents.valyou.solutions/demo/logpilot/): homepage-entity-summary implementation (fictional demo).
- [LogPilot Demo Product](https://agents.valyou.solutions/demo/logpilot/product/): service-offer-page implementation (fictional demo).
- [LogPilot Demo Use Cases](https://agents.valyou.solutions/demo/logpilot/use-cases/): answer-ready-resource-page implementation (fictional demo).
- [LogPilot Demo Integrations](https://agents.valyou.solutions/demo/logpilot/integrations/): schema-backed-detail-page implementation (fictional demo).
- [LogPilot Demo Comparison](https://agents.valyou.solutions/demo/logpilot/comparison/): answer-ready-resource-page implementation (fictional demo).

## Cheapest Complete Index

- [/agent-index.json](https://agents.valyou.solutions/agent-index.json): reading order + full endpoint list in one small fetch; prefer this over the 400KB aggregate manifest when tokens matter.

## Machine Endpoints

- [/agent-manifest.json](https://agents.valyou.solutions/agent-manifest.json): Top-level machine-readable index of pages, files, standards, workflows, examples, and QA commands.
- [/file-map.json](https://agents.valyou.solutions/file-map.json): Structured map of important source files and generated endpoints.
- [/qa-contract.json](https://agents.valyou.solutions/qa-contract.json): Machine-readable definition of route, SEO, AEO, build, and crawl expectations.
- [/examples.json](https://agents.valyou.solutions/examples.json): Structured example pattern catalog.
- [/agent-tasks.json](https://agents.valyou.solutions/agent-tasks.json): Structured future-agent backlog for improving this reference before real implementation work.
- [/product-roadmap.json](https://agents.valyou.solutions/product-roadmap.json): Structured product roadmap for executing every value multiplier to completion.
- [/walkthroughs.json](https://agents.valyou.solutions/walkthroughs.json): Step-by-step execution walkthroughs for every roadmap value multiplier.
- [/contract-registry.json](https://agents.valyou.solutions/contract-registry.json): Formal registry of JSON contracts, schemas, source owners, validation evidence, and failure modes.
- [/site-studies.json](https://agents.valyou.solutions/site-studies.json): Structured good/bad real-site studies with audit evidence and agent checks.
- [/seo-aeo-evaluation.json](https://agents.valyou.solutions/seo-aeo-evaluation.json): Structured SEO/AEO evaluation checks, proof commands, evidence expectations, and automation status.
- [/source-traceability.json](https://agents.valyou.solutions/source-traceability.json): Structured source-to-site claim ledger, artifact chain, and proof policy.
- [/site-type-playbooks.json](https://agents.valyou.solutions/site-type-playbooks.json): Structured build playbooks for local service, SaaS, professional services, proof, and answer-ready resource sites.
- [/page-patterns.json](https://agents.valyou.solutions/page-patterns.json): Structured reusable page-pattern contracts for service, proof, resource, contact, home, and schema-backed pages.
- [/page-pattern-fixtures.json](https://agents.valyou.solutions/page-pattern-fixtures.json): Structured route fixture inventory proving each page-pattern contract can drive an actual Astro route.
- [/conversion-copy.json](https://agents.valyou.solutions/conversion-copy.json): Structured conversion copy system with principles, copy types, good/bad examples, source boundaries, workflow, and QA gates.
- [/offer-ecosystem.json](https://agents.valyou.solutions/offer-ecosystem.json): Structured offer-ecosystem funnel contract for AI tools, communities, workshops, playbooks, pricing tiers, qualification gates, referrals, and disclaimers.
- [/infrastructure-decisions.json](https://agents.valyou.solutions/infrastructure-decisions.json): Structured infrastructure decision system for hosting, rendering, CMS, data, auth, media, search, analytics, forms, payments, DNS/CDN, observability, and deployment tiers.
- [/browser-visual-qa.json](https://agents.valyou.solutions/browser-visual-qa.json): Structured browser visual QA contract for screenshots, viewports, layout checks, and report evidence.
- [/crawl-evidence.json](https://agents.valyou.solutions/crawl-evidence.json): Structured crawl evidence contract for Screaming Frog exports, summary reports, and readiness criteria.
- [/design-system-contracts.json](https://agents.valyou.solutions/design-system-contracts.json): Structured design-system contract for tokens, components, accessibility, anti-patterns, QA gates, and stress tests.
- [/aeo-geo-context.json](https://agents.valyou.solutions/aeo-geo-context.json): Structured AEO/GEO model context contract for answer-engine prompts, citations, source boundaries, and stress tests.
- [/why-explanations.json](https://agents.valyou.solutions/why-explanations.json): Structured rationale contract for where explanations, tradeoffs, evidence, and failure modes are required.
- [/real-site-comparisons.json](https://agents.valyou.solutions/real-site-comparisons.json): Structured real-site comparison contract for reference studies, scoring dimensions, evidence, and follow-up tasks.
- [/handoff-reports.json](https://agents.valyou.solutions/handoff-reports.json): Structured handoff report contract for final evidence, risks, next actions, and closeout records.
- [/agent-index.json](https://agents.valyou.solutions/agent-index.json): Lightweight orientation index (reading order plus endpoint list) for token-constrained agents; the cheapest complete index.
- [/evidence/index.json](https://agents.valyou.solutions/evidence/index.json): Published QA evidence index from the latest accepted run; every entry links a live report artifact.
- [/accessibility-contract.json](https://agents.valyou.solutions/accessibility-contract.json): WCAG 2.2 AA accessibility contract: value rules, enforcement method, manual checklist, anti-patterns.
- [/performance-budgets.json](https://agents.valyou.solutions/performance-budgets.json): Core Web Vitals targets, asset budgets, page rules, and measurement method enforced by qa:perf.
- [/demo-build.json](https://agents.valyou.solutions/demo-build.json): Canonical demo build record: fictional source chain, playbook execution, pages, claims, and QA gates.
- [/demo/brightline/schema.json](https://agents.valyou.solutions/demo/brightline/schema.json): Machine-readable schema facts for the fictional local-service demo with claim IDs.
- [/demo/logpilot/schema.json](https://agents.valyou.solutions/demo/logpilot/schema.json): Machine-readable schema facts for the fictional B2B SaaS demo with claim IDs.
- [/llms.txt](https://agents.valyou.solutions/llms.txt): Concise LLM entry point.
- [/llms-full.txt](https://agents.valyou.solutions/llms-full.txt): Longer LLM-readable repo and site summary.
- [/schemamap.xml](https://agents.valyou.solutions/schemamap.xml): Schema endpoint discovery map.
- [/sitemap.xml](https://agents.valyou.solutions/sitemap.xml): Indexable route discovery.
- [/robots.txt](https://agents.valyou.solutions/robots.txt): Crawler and AI-use policy hints.
- [/schemas/agent-manifest.schema.json](https://agents.valyou.solutions/schemas/agent-manifest.schema.json): JSON Schema for /agent-manifest.json.
- [/schemas/file-map.schema.json](https://agents.valyou.solutions/schemas/file-map.schema.json): JSON Schema for /file-map.json.
- [/schemas/qa-contract.schema.json](https://agents.valyou.solutions/schemas/qa-contract.schema.json): JSON Schema for /qa-contract.json.
- [/schemas/examples.schema.json](https://agents.valyou.solutions/schemas/examples.schema.json): JSON Schema for /examples.json.
- [/schemas/agent-tasks.schema.json](https://agents.valyou.solutions/schemas/agent-tasks.schema.json): JSON Schema for /agent-tasks.json.
- [/schemas/product-roadmap.schema.json](https://agents.valyou.solutions/schemas/product-roadmap.schema.json): JSON Schema for /product-roadmap.json.
- [/schemas/walkthroughs.schema.json](https://agents.valyou.solutions/schemas/walkthroughs.schema.json): JSON Schema for /walkthroughs.json.
- [/schemas/contract-registry.schema.json](https://agents.valyou.solutions/schemas/contract-registry.schema.json): JSON Schema for /contract-registry.json.
- [/schemas/site-studies.schema.json](https://agents.valyou.solutions/schemas/site-studies.schema.json): JSON Schema for /site-studies.json.
- [/schemas/seo-aeo-evaluation.schema.json](https://agents.valyou.solutions/schemas/seo-aeo-evaluation.schema.json): JSON Schema for /seo-aeo-evaluation.json.
- [/schemas/source-traceability.schema.json](https://agents.valyou.solutions/schemas/source-traceability.schema.json): JSON Schema for /source-traceability.json.
- [/schemas/site-type-playbooks.schema.json](https://agents.valyou.solutions/schemas/site-type-playbooks.schema.json): JSON Schema for /site-type-playbooks.json.
- [/schemas/page-patterns.schema.json](https://agents.valyou.solutions/schemas/page-patterns.schema.json): JSON Schema for /page-patterns.json.
- [/schemas/page-pattern-fixtures.schema.json](https://agents.valyou.solutions/schemas/page-pattern-fixtures.schema.json): JSON Schema for /page-pattern-fixtures.json.
- [/schemas/conversion-copy.schema.json](https://agents.valyou.solutions/schemas/conversion-copy.schema.json): JSON Schema for /conversion-copy.json.
- [/schemas/offer-ecosystem.schema.json](https://agents.valyou.solutions/schemas/offer-ecosystem.schema.json): JSON Schema for /offer-ecosystem.json.
- [/schemas/infrastructure-decisions.schema.json](https://agents.valyou.solutions/schemas/infrastructure-decisions.schema.json): JSON Schema for /infrastructure-decisions.json.
- [/schemas/browser-visual-qa.schema.json](https://agents.valyou.solutions/schemas/browser-visual-qa.schema.json): JSON Schema for /browser-visual-qa.json.
- [/schemas/crawl-evidence.schema.json](https://agents.valyou.solutions/schemas/crawl-evidence.schema.json): JSON Schema for /crawl-evidence.json.
- [/schemas/design-system-contracts.schema.json](https://agents.valyou.solutions/schemas/design-system-contracts.schema.json): JSON Schema for /design-system-contracts.json.
- [/schemas/aeo-geo-context.schema.json](https://agents.valyou.solutions/schemas/aeo-geo-context.schema.json): JSON Schema for /aeo-geo-context.json.
- [/schemas/why-explanations.schema.json](https://agents.valyou.solutions/schemas/why-explanations.schema.json): JSON Schema for /why-explanations.json.
- [/schemas/real-site-comparisons.schema.json](https://agents.valyou.solutions/schemas/real-site-comparisons.schema.json): JSON Schema for /real-site-comparisons.json.
- [/schemas/handoff-reports.schema.json](https://agents.valyou.solutions/schemas/handoff-reports.schema.json): JSON Schema for /handoff-reports.json.
- [/schemas/demo-build.schema.json](https://agents.valyou.solutions/schemas/demo-build.schema.json): JSON Schema for /demo-build.json.
- [/schemas/performance-budgets.schema.json](https://agents.valyou.solutions/schemas/performance-budgets.schema.json): JSON Schema for /performance-budgets.json.
- [/schemas/accessibility-contract.schema.json](https://agents.valyou.solutions/schemas/accessibility-contract.schema.json): JSON Schema for /accessibility-contract.json.
- [/schemas/evidence-index.schema.json](https://agents.valyou.solutions/schemas/evidence-index.schema.json): JSON Schema for /evidence/index.json.
- [/schemas/agent-index.schema.json](https://agents.valyou.solutions/schemas/agent-index.schema.json): JSON Schema for /agent-index.json.

## First File-System Reads

- AGENTS.md
- docs/agent-playbook.md
- src/data/agent-reference.ts
- scripts/qa-common.mjs

## AI Use Policy

Search: yes
Ingest: yes
Train: no