# First time visitors - AI Brief

## Identity

- Slug: `first-time-visitors`
- Status: folder-based reusable section.
- Source label: `Home V5`
- Source page: `design-pack/steam-live-photo-website-starter/demos/pages/home-v5.html`
- Source range: `409-430`
- Body class context: `steam-blueprint-page steam-photo-page steam-template-family steam-home-v2 steam-home-v3 steam-home-v4 steam-home-v5`

## Purpose

Exact Home V5 first-time visitor and checklist section.

## Thread History

- Last touched by Codex thread: `019f2674-5ed0-7391-9f19-d8643ef7cfba`
- Last touched date: `2026-07-03`
- Work note: Added per-section content.json files and made section.partial.html render from section content JSON at build time.
- Rule: every future chat that edits this section folder must add its thread id to `section.json`, `AI-BRIEF.md` and `CHANGELOG.md`.

## Multi-Section Worker Chat Policy

- Trigger: Any instruction that edits, updates, audits, variants or verifies multiple section folders.
- Coordinator rule: The receiving hub/coordinator must open worker chats on a one-chat-per-section basis, keep a maximum of 3 worker chats active at a time, name each chat after its assigned section task, pin each worker while active, and keep the work scoped to that one section.
- Active-worker limit: maximum 3 worker chats at a time.
- Worker rule: Each worker chat must edit only its assigned section, add its thread id and task note to that section's section.json, AI-BRIEF.md and CHANGELOG.md, then report back to the coordinator thread when complete.
- Completion rule: After Mark verifies the task is complete, the coordinator tells the worker chat to run task end/closeout for its section task and unpins that worker chat.
- Variant rule: Approved variants belong under the assigned section folder's variants/ directory and must have their own brief/changelog.

## Files In This Folder

- `index.html` - standalone review page for browser checks.
- `content.json` - source-backed section content JSON used by the generator.
- `section.partial.html` - reusable source-backed markup rendered from `content.json` at build time.
- `section.json` - machine-readable metadata for scripts and agents.
- `typography.md` - rendered desktop/mobile typography, colour and font-family facts.
- `AI-BRIEF.md` - this plain-English operating brief.
- `CHANGELOG.md` - section-specific update history.
- `assets/` - local copies of images directly referenced by the lifted markup.
- `variants/` - approved alternate versions of this section.

## Assets

- No direct image assets are referenced by this lifted section markup.

## Rules For AI Agents

- Treat the source page and source range above as the evidence anchor.
- Do not invent content, links, images, headings, forms, menu items or section structure.
- Do not redesign this section unless Mark explicitly asks for a variant or revision.
- Do not hand-edit `section.partial.html` for content changes. Edit `content.json`, regenerate with `scripts/build-home-v5-section-library.mjs`, then refresh typography.
- Record the current worker chat/thread id whenever touching this section folder.
- If instructions affect multiple sections, do not handle them all in one worker chat. The hub must split the work into one pinned worker chat per section.
- If changing the canonical section, update the source page or this generator, regenerate the library, and refresh `typography.md`.
- If creating an alternate version, put it under `variants/<variant-slug>/` and give that variant its own brief and changelog.
- Keep `section.json`, `AI-BRIEF.md`, `CHANGELOG.md` and `typography.md` aligned after changes.

## Current Known State

- This folder is part of the Design Pack Lab 2 section library.
- The reusable section HTML is `section.partial.html`.
- The section content source is `content.json`, and the partial is generated from it.
- The review surface is `index.html`.
- Latest measured typography lives in `typography.md`.
- Update history lives in `CHANGELOG.md`.