# Claude Code Communication - Design Pack Lab 2 Systems And Audit Role

Copy/paste this to Claude Code:

```markdown
You are being briefed on Mark's Design Pack Lab 2 workflow.

## Project Identity

- Project: Design Pack Lab 2
- Local root: `/Users/marknuttall/Documents/Codex/design-pack-lab-2`
- GitHub repository: `https://github.com/marcoartuk/design-pack-lab-2`
- Cloudflare Pages project: `design-pack-lab-2`
- Stable preview: `https://design-pack-lab-2.pages.dev/`
- Sitemap: `https://design-pack-lab-2.pages.dev/sitemap.xml`
- Deploy source: `.pages-upload`
- Do not deploy the repo root.
- This is an internal design-pack lab, not a live customer-facing production site.

## Current Design Pack Focus

- Active pack: `design-pack/steam-live-photo-website-starter/`
- Current visible section library:
  - `https://design-pack-lab-2.pages.dev/design-pack/steam-live-photo-website-starter/demos/sections/`
- Event-template review page:
  - `https://design-pack-lab-2.pages.dev/design-pack/steam-live-photo-website-starter/demos/pages/events-v4?v=20260702d`
- The task has been to turn reusable event/page sections into a proper section-folder library inside the design pack.

## Section Folder System

Each reusable section must live in its own folder:

```text
design-pack/steam-live-photo-website-starter/demos/sections/<section-slug>/
  index.html
  content.json
  section.partial.html
  section.json
  typography.md
  AI-BRIEF.md
  CHANGELOG.md
  assets/
  variants/
```

Rules:

- `index.html` is the standalone review page.
- `content.json` is the editable source-backed content JSON for that section.
- `section.partial.html` is reusable section-only markup generated from `content.json` at build time.
- `section.json` is machine-readable metadata for scripts and agents.
- `typography.md` records rendered desktop/mobile typography and colour facts.
- `AI-BRIEF.md` tells any AI what it needs to know before editing that section.
- `CHANGELOG.md` records that section's update history.
- `assets/` contains local section assets.
- `variants/` contains approved alternate versions.
- Do not create new flat-only section pages.
- Legacy flat pages may exist only as compatibility redirects.
- Do not hand-edit `section.partial.html` for content changes.

## Thread Tracking

Every chat/thread that touches a section folder must add its thread id and task note to:

- `section.json`
- `AI-BRIEF.md`
- `CHANGELOG.md`

This lets a future agent trace who changed a section and why.

## Multi-Section Worker Rule

If Mark gives one instruction that edits, updates, audits, variants or verifies multiple section folders:

- the hub/coordinator must open worker chats on a `one chat = one section` basis;
- maximum 3 worker chats may be active at a time;
- each worker chat must be named after its assigned section task;
- each worker chat must be pinned while active;
- each worker chat must work only on its assigned section;
- each worker chat must record its thread id and task note in that section's files;
- each worker chat must report back to the coordinator when complete;
- after Mark verifies completion, the coordinator tells the worker to run task end/closeout and unpins it.

## Claude Code Audit Role

Claude Code is the required auditor before any Design Pack Lab 2 site launch, promotion, or production handoff.

Before any launch/promotion:

1. Run the Design Pack QA Audit role.
2. Audit only; do not silently fix files.
3. Verify against the pack docs, section-folder rules, source-faithfulness rules, no-fabrication rule, desktop/mobile rendering, links, sitemap, and Cloudflare Pages readiness.
4. Confirm that `.pages-upload` matches the intended source state.
5. Confirm source is committed and pushed before deployment.
6. Save audit reports under the repo audit/docs area.
7. Return a concise Hub-ready block with:
   - PASS/FAIL;
   - issue totals;
   - critical/high findings or `none`;
   - preview URL;
   - sitemap URL;
   - report paths;
   - commit hash;
   - explicit note that audit-only work made no implementation changes.

No Design Pack Lab 2 site launch should be treated as ready until Claude Code's audit has passed or Mark explicitly overrides it.

## Key Project Files To Read

- `/Users/marknuttall/Documents/Codex/design-pack-lab-2/README.md`
- `/Users/marknuttall/Documents/Codex/design-pack-lab-2/docs/wiki/design-pack-rules.md`
- `/Users/marknuttall/Documents/Codex/design-pack-lab-2/agents/design-pack-qa-audit-claude-prompt.md`
- `/Users/marknuttall/Documents/Codex/design-pack-lab-2/.claude/agents/design-pack-qa-audit.md`
- `/Users/marknuttall/Documents/Codex/design-pack-lab-2/design-pack/steam-live-photo-website-starter/README.md`
- `/Users/marknuttall/Documents/Codex/design-pack-lab-2/design-pack/steam-live-photo-website-starter/FREQUENTLY-CHANGED-SECTIONS.md`
- `/Users/marknuttall/Documents/Codex/design-pack-lab-2/design-pack/steam-live-photo-website-starter/SECTION-CONTENT-JSON-HANDBACK.md`
- `/Users/marknuttall/Documents/Codex/design-pack-lab-2/design-pack/steam-live-photo-website-starter/APPROVED-CONTENT-PACK.md`
- `/Users/marknuttall/Documents/Codex/design-pack-lab-2/design-pack/steam-live-photo-website-starter/CONTENT-RULES.md`
- `/Users/marknuttall/Documents/Codex/design-pack-lab-2/design-pack/steam-live-photo-website-starter/demos/sections/README.md`
```