# AI-Optimized Website Build Spec

Use this document as the evidence record for a new website, redesign, replatform, or major release. Duplicate it per project. Replace examples and blank fields; do not report a checkbox as passed without a linked or reproducible proof.

## 1. Project record

| Field | Value |
|---|---|
| Project / release | |
| Production domain | |
| Project owner | |
| Technical owner | |
| Editorial owner | |
| Analytics owner | |
| Privacy / legal owner | |
| Security owner | |
| Markets and languages | |
| Planned launch date | |
| Rollback owner | |
| Last review | |

### Objective

Business decision(s) this site must support:

-

Primary conversion:

-

Explicit non-goals:

-

### Outcome definitions

| Outcome | Definition | System of record | Baseline window | Owner |
|---|---|---|---|---|
| Organic search visibility | | | | |
| Google generative AI visibility | | | | |
| AI-platform mention | | | | |
| Owned citation | | | | |
| AI referral visit | | | | |
| Qualified conversion | | | | |
| Pipeline / revenue | | | | |

## 2. Gate register

Use one line per material requirement. “Done” is not evidence.

| Gate | Requirement | Pass condition | Proof link / capture | Owner | Status | Retest |
|---|---|---|---|---|---|---|
| 1 Strategy | | | | | Not started | |
| 2 Architecture | | | | | Not started | |
| 3 Access | | | | | Not started | |
| 4 Source content | | | | | Not started | |
| 5 Entity data | | | | | Not started | |
| 6 Experience | | | | | Not started | |
| 7 Measurement | | | | | Not started | |

Allowed status values: `Not started`, `In progress`, `Blocked`, `Passed`, `Accepted risk`.

## 3. Buyer-question and page map

| Priority | Buyer question / prompt family | Market | Language | Buying stage | Canonical destination | Supporting pages | Conversion |
|---|---|---|---|---|---|---|---|
| P0 | | | | | | | |

### Route rules

| Rule | Decision | Test case | Owner |
|---|---|---|---|
| Lowercase | | | |
| Trailing slash | | | |
| Query parameters | | | |
| Redirect limit | | | |
| Pagination | | | |
| Discontinued content | | | |
| Locale routing | | | |

## 4. Source-of-truth registry

| Entity / fact group | Canonical source | Required fields | Public outputs | Freshness rule | Owner |
|---|---|---|---|---|---|
| Organization | | | Page / JSON-LD / profiles | | |
| Authors | | | Bio / article / JSON-LD | | |
| Products | | | Page / JSON-LD / feed / checkout | | |
| Services | | | Page / navigation / profiles | | |
| Offers and prices | | | Page / JSON-LD / feed / checkout | | |
| Locations | | | Page / JSON-LD / profiles | | |
| Policies | | | Page / checkout / agent files | | |

### Conflict register

| Fact | Surface A | Surface B | Expected value | Severity | Owner | Fix / evidence |
|---|---|---|---|---|---|---|
| | | | | | | |

## 5. Access and delivery matrix

Test the production route through the real CDN and WAF. Record both raw and rendered outcomes.

| URL / template | User agent / purpose | Robots policy | Edge result | HTTP | Canonical | Main answer in raw HTML | Main answer rendered | Log evidence | Result |
|---|---|---|---|---|---|---|---|---|---|
| | Browser / customer | | | | | | | | |
| | Googlebot / Search | | | | | | | | |
| | OAI-SearchBot / ChatGPT Search | | | | | | | | |
| | PerplexityBot / Perplexity Search | | | | | | | | |

### Bot-policy decisions

| Platform / agent | Search discovery | User-triggered fetch | Model training | Decision source | Approved by | Date | Retest trigger |
|---|---|---|---|---|---|---|---|
| Google | | | | | | | |
| OpenAI | | | | | | | |
| Perplexity | | | | | | | |
| Other | | | | | | | |

### Rendering checks

- [ ] H1 and primary answer appear without interaction.
- [ ] Meaningful links are ordinary anchors with destinations.
- [ ] Canonical, author, dates, and structured data survive hydration.
- [ ] Critical content does not require consent acceptance, login, filter, or search.
- [ ] Error and removed states return the intended HTTP status.
- [ ] JavaScript and API failures do not remove the main information.

## 6. Claim ledger

| Page | Exact claim | Claim type | Primary source | Date checked | Scope / limitation | Review action | Owner | Next review |
|---|---|---|---|---|---|---|---|---|
| | | Observed / modeled / estimated / opinion | | | | Keep / revise / test / remove | | |

### Original source assets

| Topic cluster | Asset | Method published? | Limitations published? | Stable URL | Update owner |
|---|---|---|---|---|---|
| | Benchmark / case / calculator / template / dataset | | | | |

## 7. Structured-data and feed parity

| Template / entity | Visible page | JSON-LD type | Stable @id | Feed / profile | Validation proof | Conflict? | Owner |
|---|---|---|---|---|---|---|---|
| Organization | | | | | | | |
| Author | | | | | | | |
| Article | | | | | | | |
| Product / offer | | | | | | | |
| Service | | | | | | | |
| Location | | | | | | | |
| Breadcrumb | | | | | | | |

Do not invent ratings, reviews, prices, availability, awards, credentials, or unsupported properties.

## 8. International parity

| Canonical topic | EN URL | DE URL | Other locale | Reciprocal hreflang | Fact parity | Source parity | Human review | Result |
|---|---|---|---|---|---|---|---|---|
| | | | | | | | | |

- [ ] Every locale has a stable URL and self-canonical.
- [ ] Language switches are crawlable links.
- [ ] No forced IP redirect blocks access.
- [ ] Currency, units, examples, sources, proof, and limitations are localized.
- [ ] Routing, sitemap, content availability, and analytics use the same locale registry.

## 9. Experience release sheet

### Field and lab performance

| Page group | Device | LCP p75 | INP p75 | CLS p75 | Field window | Lab evidence | Owner | Result |
|---|---|---|---|---|---|---|---|---|
| | Mobile | | | | | | | |

### Delivery budgets

| Page group | JS | Images | Fonts | Third parties | Exception owner |
|---|---|---|---|---|---|
| | | | | | |

### Accessibility, security, and task completion

- [ ] Keyboard path works for the primary task.
- [ ] Landmarks, headings, labels, errors, focus, contrast, zoom, and reduced motion were checked.
- [ ] Images have appropriate alt behavior and reserved dimensions.
- [ ] Consent and promotional UI do not hide the main answer.
- [ ] HTTPS, security headers, dependency review, abuse controls, and form handling passed.
- [ ] Optional-script failure leaves important information usable.

Evidence links:

-

## 10. Measurement specification

### Prompt cohort

| ID | Exact prompt | Platform / mode | Market | Language | Session state | Repetitions | Target page / entity |
|---|---|---|---|---|---|---|---|
| P-001 | | | | | | | |

### Observation log

| Date | Prompt ID | Run | Mention | Owned citation | Third-party sources | Accuracy | Prominence | Sentiment | Capture |
|---|---|---|---|---|---|---|---|---|---|
| | | | | | | | | | |

### Analytics validation

| Event / report | Test URL | Expected result | Production evidence | Owner | Result |
|---|---|---|---|---|---|
| Primary conversion | | | | | |
| Referral preservation | | | | | |
| UTM preservation | | | | | |
| Google generative AI report | | | | | |
| CRM qualification | | | | | |

## 11. Launch blocker and risk register

| ID | Gate | Observation | Evidence | Business consequence | Priority | Owner | Resolution / accepted risk | Retest |
|---|---|---|---|---|---|---|---|---|
| B-001 | | | | | P0 / P1 / P2 | | | |

P0 examples: unintended `noindex`, wrong canonical, approved crawler blocked at the edge, missing main content, unsupported consequential claim, fabricated rating, price mismatch, broken conversion, missing rollback.

## 12. Final sign-off

| Sign-off | Name | Decision | Date | Conditions |
|---|---|---|---|---|
| Business | | Approve / block | | |
| Technical | | Approve / block | | |
| Editorial | | Approve / block | | |
| Analytics | | Approve / block | | |
| Privacy / legal | | Approve / block | | |
| Security | | Approve / block | | |
| Localization | | Approve / block | | |

Rollback trigger:

-

Rollback procedure:

-

## 13. Release and 30/60/90-day reviews

### Release record

| Field | Value |
|---|---|
| Release timestamp | |
| Deployed revision | |
| Changed URLs / templates | |
| Hypothesis | |
| Monitoring link | |
| Rollback window | |

### Day 0–30: confirm delivery

- [ ] Production access, rendering, logs, analytics, and forms confirmed.
- [ ] Indexing and canonical selection reviewed.
- [ ] Source, structured-data, and feed conflicts reviewed.
- [ ] Initial complete observation window marked.

Decision and evidence:

-

### Day 31–60: compare separate signals

- [ ] Search visibility reviewed.
- [ ] Google generative AI visibility reviewed where data exists.
- [ ] Prompt cohort rerun under the original conditions.
- [ ] Citations, mentions, visits, conversions, and factual errors reviewed separately.

Decision and evidence:

-

### Day 61–90: choose the next controlled release

- [ ] One next hypothesis selected.
- [ ] Owner, changed pages, pass condition, observation window, and stop rule defined.
- [ ] Unsupported assumptions moved to the risk register.
- [ ] Scale / revise / retain / stop decision recorded.

Decision and evidence:

-

## 14. Change log

| Date | Change | Reason | Affected gates | Owner | Evidence |
|---|---|---|---|---|---|
| | | | | | |

---

This fieldbook is an implementation aid, not a third-party ranking or citation guarantee. Keep platform-specific requirements tied to current first-party documentation and revalidate them after material product changes.