# About this project

## What it is

**Agent Ready POC** is a proof that a single autonomous agent can ship a complete, modern, secure, accessible, agent-ready static site on Cloudflare end-to-end, with a human operator's role limited to checkpoint approvals.

The brand is openly the build process. There is no fictional founder, no manufactured consultancy. The "firm" is the agent and the operator. The services this site describes are concrete patterns we would build for a real client, supported by real industry data, scaffolded with the same techniques used to build the site itself.

## What "agent-ready" means here

A site is agent-ready when an AI agent (an LLM acting as a user, a research assistant, an indexing crawler, a procurement assistant) can:

1. **Discover the site.** `/robots.txt`, `/sitemap.xml`, `/llms.txt`, `Link` response headers, and structured discovery files all present and consistent.
2. **Read it cleanly.** Semantic HTML5, JSON-LD entity graph with connected `@id` cross-references, content-negotiation alternatives, low render cost.
3. **Trust the access rules.** Non-blanket bot policies (training-only bots disallowed, inference bots welcomed), `content-signals` response header, robots.txt mirroring the same intent.

Cloudflare publishes a third-party scanner ([isitagentready.com](https://isitagentready.com)) that scores each of those dimensions. This site is built to be green on every category the scanner reports.

## How it was built

- **Tooling:** Docker (only host install), 11ty (static site generator), Cloudflare Pages (hosting + Pages Functions), Cloudflare Registrar (domain), Lighthouse + axe-core + W3C nu validator + gitleaks (verification gates).
- **Authoring agent:** [Claude](https://www.anthropic.com/claude), built by [Anthropic](https://www.anthropic.com) ([Wikipedia](https://en.wikipedia.org/wiki/Anthropic)). Running inside [Claude Code](https://claude.com/claude-code), Anthropic's coding-agent runtime, executing a detailed build plan.
- **Operator role:** checkpoint approvals only (domain selection, brand selection, dashboard configuration, publication). No code editing.
- **Time to all gates green:** logged in the iteration log; see [Case studies](/case-studies/).

## About the builder

The authoring agent for every file on this site is **Claude** ([anthropic.com/claude](https://www.anthropic.com/claude)), a large-language-model family developed by **[Anthropic](https://www.anthropic.com)**, a public AI safety company founded in 2021 by former OpenAI research executives. Anthropic publishes peer-reviewed research on Constitutional AI, mechanistic interpretability, and AI safety evaluations; the company's models power developer products (Claude API, Claude Code) and a consumer assistant ([claude.ai](https://claude.ai)).

The agent's verifiable cross-platform presence is part of the authority signal for this project:

- Anthropic: [anthropic.com](https://www.anthropic.com) · [Wikipedia](https://en.wikipedia.org/wiki/Anthropic) · [github.com/anthropics](https://github.com/anthropics) · [@AnthropicAI](https://x.com/AnthropicAI)
- Claude: [anthropic.com/claude](https://www.anthropic.com/claude) · [Wikipedia](https://en.wikipedia.org/wiki/Claude_(language_model)) · [claude.ai](https://claude.ai)
- Claude Code: [claude.com/claude-code](https://claude.com/claude-code)

These references are reflected as `sameAs` links on the `Person` and publishing `Organization` entities in this page's JSON-LD `@graph`, so structured-data consumers (and Gate 3 auditors) can verify the builder identity programmatically.

## Quality posture

- **Gate 2 (Lighthouse + axe + W3C):** Performance, Accessibility, and Best Practices score 100/100 on both desktop and mobile across every page. SEO scores 92/100, an intentional 8-point gap because the robots.txt Content-Signal directive Cloudflare requires for Gate 1 is flagged "Unknown" by Google's parser. axe-core reports zero violations. The W3C HTML validator reports zero errors.
- **Gate 1 (Cloudflare Agent Ready scan):** All categories the scanner reports green by design.
- **Gate 3 (Content audit):** Service pages structured for retrieval (passage coherence, section-level TL;DRs, FAQPage schema, citation density) per the published research on content optimization for AI surfaces [^pl].

## What this is not

- A real consultancy taking inbound work. The contact form points to a Cloudflare Email Routing alias that forwards to the operator. No active engagement pipeline.
- A fabricated case study generator. The pages describing "what we would build" are concrete patterns, but they are not promises of work delivered.
- A claim that agents replace operators. The build plan deliberately reserved eight checkpoints for human judgment; none of them were automated away. The operator was light on hands-on-keyboard but heavy on directional decisions.

## Source

The repository is published at **<https://github.com/agent-ready-ai/agent-ready-poc>** under the MIT license. Every commit is conventional-format; every iteration is annotated-tagged with the gate scores at that tag's state; the SDLC and security posture are documented in the README.

---

[^pl]: Plate Lunch Collective, *SEO Content Writing That Works in ChatGPT and Google AI: The Technical Implementation Guide*. <https://www.platelunchcollective.com/blog/seo-content-writing-that-works-in-chatgpt-and-google-ai-the-technical-implementation-guide>
