Archetype Audit Plan — All 95 Archetypes

Archetype Audit Plan — All 95 Archetypes

Status: Revised — 2026-07-18 (inventory re-grounded to 95 archetypes / 21 categories; media-production, live-events-venues, production-equipment-rental, and medical-practice coverage added) Scope: Full audit of every seeded archetype via browser-driven fresh installs. Produces gap backlog items for post-audit execution.
Related: archetype-business-value-streams.md (value-stream rationale — read first), archetype-owner-positioning.md (owner-facing marketing promise and test emphasis), fresh-install.ps1, BIAN design spec

Inventory ground truth (verified 2026-07-18 against origin/main packages/storefront-templates/src/archetypes/): 95 seeded archetypes across 21 categories. Derived by enumerating ALL_ARCHETYPES in index.ts and cross-checking per-file archetypeId counts. Per-category counts: asset-rental 3, automotive-services 6, banking-financial-services 3, beauty-personal-care 6, education-training 4, fitness-recreation 3, food-hospitality 3, healthcare-wellness 9, hoa-property-management 3, live-events-venues 3, media-production 3, moving-and-logistics 4, nonprofit-community 8, pet-services 5, professional-services 8, public-sector 3, real-estate-construction 2, retail-goods 5, security-services 2, software-platform 1, trades-maintenance 11 (= 95).

There is no separate medical or dental category — medical-practice, dental-practice, optician, and the medical-mobile leaves are archetypes under healthcare-wellness. media-production and live-events-venues are now real source categories and must be audited as first-class categories.


0. What changed since the 2026-06-12 baseline (56 / 15 → 95 / 21)

The prior revision of this plan (“All 56 Archetypes”, inventory verified 2026-06-12) covered 56 archetypes across 15 categories in Runs 0–17 (+ composition Run 18). The registry has since grown to 95 / 21 — a delta of +39 archetypes and +6 categories. The 2026-07-17 pass assigned the field-dispatch, real-estate-construction, automotive/logistics/security, banking/public-sector, and rental tranche. This 2026-07-18 sweep adds the eight leaves that drifted after that pass: medical-practice, production-equipment-rental, all three media-production leaves, and all three live-events-venues leaves.

The +31, by origin (all three tranches trace to the 2026-06-13 field-dispatch gap analysis + the EP-GRID-BUILDER home-builder work):

Methodology is unchanged. Every new archetype gets its own fresh install (DB-only reset from the golden dump, Section 5) and the full Phase A–F checklist plus Phases G/H/O/K, driven browser-only at http://localhost:3000. Common [C] mechanics remain proven once in Run 0; only archetype-specific [A] dimensions are re-evaluated per leaf. Severity is still derived from the value stream (Section 4 rule), and the operator-persona lens (WWWD / business-owner experience, not developer) still governs grading.

Touchpoints for the 6 new categories (adding-an-ArchetypeCategory checklist): the new categories are already seeded with coverage tests (archetypes.test.ts: dispatch-native categories, home builder archetypes, media/live categories, and equipment-rental support assertions) and the Seed-Fit CI gate already applies to them. No new audit scaffolding is required — this revision is docs-only.

Regulated calibration (Phase O): the medical-mobile leaves (home-health-care, mobile-phlebotomy, dme-delivery), the security leaves (guard-patrol, alarm-cctv-install), and the licensed professional leaf land-surveying are newly-regulated. Their per-run scripts (Runs 20, 26, 22) name the specific licensing/regulatory obligation an operator would get wrong, per the plan’s existing rule: silence on a mandatory license = Level 0.


1. Purpose

DPF ships 95 archetypes across 21 categories. The platform must behave correctly for each organizational model — correct vocabulary, correct CTA, correct coworker framing, correct activation modules, correct compliance defaults. This audit drives each archetype through a browser-realistic experience and records gaps as backlog items.

Out of scope for this plan: executing the gap items. This thread produces the plan, the backlog snapshot, and the per-run scripts. Execution follows in a separate thread.

Test against the value stream, not the checklist. Every phase defends a named stage of the business’s real-world operational value stream. Before driving a run, read the archetype’s profile in archetype-business-value-streams.md to know its load-bearing stage(s), demand–capacity inflection, and trust gate — these set where to scrutinise hardest and how to grade severity (that doc’s Section 4 gives the stage→phase mapping and the severity-derivation rule). When logging a finding, name the value-stream stage it breaks and let load-bearing status drive severity rather than asserting it.

Test the owner promise, not just the template. The companion Archetype Owner Positioning document names the owner-practitioner reality, the surrounding “necessary evil” jobs DPF claims to relieve, and the highest-value proof point for each category. Before each run, identify the promised burden reduction for that archetype: intake, follow-up, dispatch, readiness, marketing draft, compliance prompt, asset return, date conflict, donor thank-you, or similar. If the UI technically works but does not relieve the named owner burden, log an operator-value finding even when the lower-level mechanics pass.


1a. Audit Perspective & First-Run Expectations

This audit is executed from the perspective of the operator persona — Sandra Hooper the plumber, Chloe Martinez the salon owner, Sam Nguyen the baker. These are real business owners, not developers. They are evaluating DPF as a product they would pay for and use to run their business every day.

This is the first systematic evaluation of DPF from a customer-of-DPF standpoint. Prior work has focused on platform infrastructure: routing, build pipeline, coworker runtime, seed integrity. This audit shifts the frame: does the platform deliver value to the business owner who has just set it up?

Expected finding on Run 1: AI coworker operating intelligence (Phase O) will be mostly Level 1–2 across the board. The coworkers will know they are in a plumbing business, but they will not reliably know the tax structure for a sole-trader plumber in the UK, the typical TAM for a residential plumbing operation in a mid-size city, or the compliance requirements for working with gas fittings. This is not a failure of platform infrastructure — it is accurate discovery of where the product is on the operator-value curve.

The gap list from this audit IS the build backlog for the next cycle. Each Level 0–2 coworker finding, each missing communication flow, each absent payment surface names a piece of work. The point is to make those gaps visible and prioritized, not to confirm the platform is finished.

Two perspectives run simultaneously in every phase:

A feature can technically pass and still score Level 1 on operator value. Both are tracked separately.

Regulated archetypes and Phase O: businesses in regulated industries (dental, legal, financial, trades with Gas Safe/NICEIC, food, childcare) have significant licensing and compliance requirements that operators routinely get wrong. Phase O’s compliance check (O5) and setup intelligence check (O6) are specifically calibrated to surface whether DPF helps or stays silent on these obligations. Silence on a mandatory license = Level 0.

Newly-regulated archetypes (added Runs 19–27) with calibrated Phase O: the medical-mobile leaves and the licensed field trades raise the compliance bar further, and their per-run scripts (Runs 20, 22, 26) state the exact obligation an operator would get wrong so Phase O O5/O6 can be scored against it — again, silence on a mandatory license = Level 0:

Locale and tax jurisdiction gap (known, first run): the current audit runs primarily in USD/GBP on .com/.co domains. Two specific gaps to note as recurring findings across runs:


2. Constraints


2a. Common vs. Archetype-Specific Test Coverage

Not everything needs to be tested 18 times. The audit evaluates two distinct dimensions:

Common platform mechanics — test once, deeply, in Run 0

These are shared UI surfaces that behave the same regardless of archetype. Run 0 is the only run that evaluates them (pass/fail, finds bugs). Runs 1–29 use them as setup tools without re-evaluating the mechanics.

Checklist items tagged [C] below fall in this category. In Runs 1–29, execute the step, but do not log a finding if the mechanics work correctly — you have already proved they do. Only log if the step fails in a run where it worked in Run 0 (that would indicate a regression, not an archetype gap).

Surface What Run 0 proves
Brand URL scrape engine Returns meaningful suggestions; handles .co, .co.uk, .com variants
Setup wizard step mechanics Each step saves, next/back navigation works, financial step pre-fills correctly
Archetype grid All 95 archetypes visible; grid navigable; card renders name + category + CTA type
/storefront/team CRUD Add/edit/delete provider; availability day-of-week grid saves and syncs
/storefront/settings/operations Operating hours editor: all 7 days toggleable, open/close time pickers, timezone selector, save triggers ProviderAvailability sync
/storefront/items CRUD Add/edit/delete/reorder items; priceAmount field accepts decimal; ctaType selector works
Cart + checkout flow mechanics Add item → cart badge increments → checkout form: name, email, phone, address; submit issues reference number
/customer CRUD Create account → add contact → add ConfigurationItem (ciType, name, description); all three forms save and link
/finance/suppliers Add supplier: name, contact saves correctly
/finance/bills/new Add supplier, add line items (description, qty, unit price), totals calculate, save to draft
/finance/invoices/new Link customer account, add line items, totals calculate, save to draft; TAX % pre-fills from the org’s VAT setting (not a hardcoded 20) — see Phase G-REG-1
/finance/reports/profit-loss Report loads; bill expenses appear; invoice revenue appears; net is calculated
/storefront/inbox mechanics Submitted CTAs appear; can open, assign to staff member, send to backlog
Form validation (all surfaces) Required fields reject empty submission; invalid email rejected; no 500 on malformed input
Navigation structure All primary shell routes load without 500; 404 path returns graceful error page
Responsive baseline Public portal at 390px: hero, CTA form usable; no horizontal overflow
Universal Grid & Workbooks (Phase 2–4) /workbooks custom grids + /workbooks/system/[entityType] platform grids work end-to-end — see Phase W deep checklist below
Calendar × Workbooks integration /workspace/calendar surfaces workbook date-column rows as events (Phase W §W-CAL)

Phase W — Universal Grid & Workbooks + Calendar (Run-0 deep checklist) [C]

Archetype-neutral; evaluate once, deeply, in Run 0. Record evidence as dynamic analysis (drove X → observed Y → signed off / DEFECT Z), not screenshots. Two fixes to confirm landed: reference-cell persistence (PR #1817) = W-REF-3; calendar workbook events (PR #1810) = W-CAL.

Prerequisite

Custom-Table Workbook — build one workbook to exercise the full authoring surface

Platform-Backed Grids — prove “any platform table becomes a grid”

Data Ops — Smartsheet/Supabase parity surface

Media Columns (PRs #1832 image, #1836 attachment)

Calendar Integration

Archetype-specific dimensions — evaluated on every archetype

These are the reasons we run 95 evaluations. If they are wrong they indicate an archetype gap, not a platform mechanics bug.

Dimension What changes per archetype
CTA type and label “Book Now” / “Shop Now” / “Get a Quote” / “Donate” / “Apply”
Public portal vocabulary Service names, persona terms (clients/patients/members/residents), section headings
Domain-specific form fields Pet info for vet; party size for restaurant; urgency + property type for trades; guest count for catering
Coworker framing Agent identity, archetype services in responses, vocabulary never crosses into platform-dev terms
Activation modules Which modules are active for this archetype’s activation profile
Compliance section content Regulatory placeholders present for licensed/regulated archetypes
Finance framing Commercial model language (subscription vs. appointment-checkout vs. account-based)
Custom vocabulary overrides Members / Ratepayers / Borrowers / Residents / Patients rendered on portal
Setup wizard suggestion accuracy Brand URL scrape suggests the correct archetype
AI coworker operating intelligence Finance coworker tax/expense guidance, marketing coworker TAM/channel strategy, compliance/licensing guidance, setup intelligence proactivity — scored 0–4 per Phase O maturity scale
Operator day-to-day experience Customer communication flows, schedule/calendar usability, payment processing surface, business health KPIs, staff management, digital presence guidance, onboarding completeness — per Phase K
Owner burden relief The archetype-specific “work around the work” from owner positioning: quote readiness, booking gaps, missing forms, donor follow-up, route/load planning, asset return inspection, date holds, approval chasing, or other necessary-evil work
Marketing proof Whether the platform produces safe evidence for the customer-facing story: visual vocabulary fit, credible use-case detail, campaign/proof prompts, and current-state vs planned-state boundaries

Operator persona accessibility — a UX fit dimension, not a pass/fail gate

The auditor is technical. The operator personas (Sandra Hooper the plumber, Chloe Martinez the salon owner, Sam Nguyen the baker) are not. During Phase P and Phase B steps, make a note whenever a step requires knowledge that a non-technical business owner would not have, or when the navigation is non-obvious. Log these as minor findings (they are UX improvement opportunities, not functional failures). Examples of what to watch for:

Any step where the auditor had to think “a real operator would struggle here” → log a minor UX finding with the specific friction point. These become EP-9FC5D2FD (Dale persona hardening) candidates.


3. Audit Run Strategy

95 archetypes across Run 0 (pilot) + grouped install runs. Every archetype gets its own fresh install and the full Phase A–F checklist. Archetypes are grouped into runs by category only for scheduling and findings organization — each archetype in a run still begins from a clean DB state (DB-only reset from golden dump, see Section 5). Runs 0–17 cover the original 56 plus corrected in-category leaves; Runs 19–27 cover the field-dispatch and real-estate-construction tranche; Runs 28–29 cover the media/live-events categories added after the 87/19 plan; Run 18 is composition (no additional fresh installs).

Why full installs, not API swaps: using archetype-reset to swap between archetypes leaves prior company identity (name, slug, hero copy, inbox history) in place. A real operator always installs fresh; an audit that swaps via API tests a different — and rarer — path. Run 1 swap testing (2026-06-12) confirmed this: all swap archetypes presented as the lead archetype’s business identity to customers. Per-archetype fresh installs eliminate this class of false and misleading findings.

Run Category Archetypes (each gets full fresh install + Phase A–F) CTAs Exercised
0 Pilot / calibration (software-platform) software-platform inquiry — see Section 3a
1 Trades & Maintenance plumber, electrician, facilities-maintenance, landscaping, cleaning-service inquiry
2 Beauty & Personal Care hair-salon, barber-shop, nail-salon, beauty-spa, personal-trainer booking
3 Healthcare & Wellness veterinary-clinic, dental-practice, medical-practice, physiotherapy, counselling, optician booking
4 Pet Services pet-grooming, pet-boarding, dog-walking booking
5 Food & Hospitality restaurant, catering, bakery booking, inquiry, purchase
6 Retail & Goods retail-goods, artisan-goods, florist, wholesale-distribution purchase, inquiry
7 Fitness & Recreation gym, yoga-studio, dance-studio purchase
8 Education & Training corporate-training, tutoring, driving-school, music-school booking, inquiry
9 Professional Services A consulting, legal-services, marketing-agency, accounting inquiry
10 Professional Services B it-managed-services (MSP activation profile) inquiry (MSP profile)
11 Nonprofit & Community charity, pet-rescue, animal-shelter, community-shelter, sports-club, cooperative donation, inquiry
12 HOA & Property Management homeowners-association, condo-association, property-management-company inquiry
13 Software & Platform folded into Run 0 — software-platform full A–F + extended meta-case run on the pilot install inquiry
14a Banking community-bank (KYC + BIAN + FDIC pack) inquiry (KYC)
14b Banking credit-union (member-owned + NCUA pack) inquiry (KYC)
14c Banking mortgage-lending (NMLS/RESPA/TILA pack) inquiry (NMLS)
15 Public Sector small-town-municipality, municipal-utility inquiry
16 Law Enforcement law-enforcement-agency (POST/CJIS-gate pack) inquiry (public-body)
17 Rental & Shared Assets equipment-rental, self-storage, production-equipment-rental, agricultural-cooperative rental (Reserve)
18a Multi-Archetype: Same category (1) self-storage + equipment-rental; (2) plumber + retail-goods (supplies reorder) rental, inquiry
18b Multi-Archetype: Cross-category concern (3) hair-salon + retail-goods; (4) bakery + professional-services (custom-order inquiry) booking, inquiry
18c Multi-Archetype: Regulated / acute (5) community-bank + healthcare-wellness inquiry (KYC)
19 Trades Field-Dispatch (Gap-A) hvac-contractor, pest-control, appliance-repair, pool-spa-service, pressure-washing, roofing-gutters inquiry (field dispatch)
20 Healthcare Field-Dispatch (Gap-A, regulated) home-health-care, mobile-phlebotomy, dme-delivery inquiry, booking (in-home clinical)
21 Pet Field-Dispatch (Gap-A) mobile-pet-grooming, mobile-vet booking (at-home)
22 Professional Field-Services (Gap-A) field-inspection, land-surveying, process-serving-notary inquiry (site visit)
23 Beauty / Nonprofit / Retail Dispatch Leaves (Gap-A) mobile-beauty, meal-delivery-program, furniture-delivery-install booking, donation, inquiry
24 Automotive Services (Gap-B — new category) auto-glass, mobile-mechanic, mobile-detailing, mobile-tire, roadside-assistance, locksmith inquiry (mobile)
25 Moving & Logistics (Gap-B — new category) moving-company, junk-removal, courier-delivery, last-mile-freight inquiry (mobile)
26 Security Services (Gap-B — new category, regulated) guard-patrol, alarm-cctv-install inquiry (licensed)
27 Real Estate & Construction (new category) new-home-builder, custom-home-builder inquiry (+ booking item)
28 Media Production (new category) film-video-production, post-production-studio, event-production-staging inquiry (pipeline/timeline)
29 Live Events & Venues (new category) event-venue, tour-promoter, talent-booking-agency inquiry (venue/holds)

Total fresh installs: 95 (one per archetype — 58 in Runs 0–17 after the medical-practice and production-equipment-rental reconciliation, 31 in Runs 19–27, and 6 in Runs 28–29). Run 18a–18c are composition installs — 5 primary archetypes set up fresh, with one or two secondaries added post-setup via “Add service line”. No additional fresh installs are needed for secondaries. See Section 3c.

3b. Representative Quality Bar (21 category sentinels — must all Pass before audit is considered representative)

A related acceptance test plan (docs/superpowers/plans/2026-06-06-archetype-acceptance-test-plan.md) now identifies a representative 21-category sentinel batch for the current 95/21 catalog. These sentinels are the minimum viable quality bar — if any of them Fail (Section 8 verdict system), the platform is not ready for broader rollout regardless of the remaining archetypes.

Treat these as priority-1 within their runs. If time or resets run short, the current category sentinels are non-negotiable. The historical 12-row list below is retained only as the original operating-model seed; expand it with the acceptance plan’s newer sentinels for banking, public sector, asset rental, real estate/construction, automotive, logistics, security, media production, and live events.

Archetype Run Why priority-1
software-platform 0/13 Platform/operator baseline; meta-case
it-managed-services 10 Richest activation profile; all modules active
hair-salon or beauty-spa 2 Appointment-checkout; most common booking model
wholesale-distribution 6 B2B goods; exposed roster drift
plumber or electrician 1 Field-service; dispatch-style inquiry CTA
restaurant 5 Party-size form field; food/hospitality vocabulary
dental-practice 3 Healthcare compliance posture; patient vocabulary
property-management-company 12 Dual-audience (landlord + tenant)
charity or animal-shelter 11 Donation CTA; no-purchase receipt verification
tutoring 8 Booking with student/parent dependent fields
gym or yoga-studio 7 Subscription membership purchase
pet-grooming or pet-boarding 4 Pet CI creation; size-based pricing

3a. Run 0 — Pilot / calibration + Platform Core Mechanics (MANDATORY before Run 1)

Run 0 serves two goals: (a) validate the audit harness so the remaining resets test the platform rather than the plan’s assumptions; (b) prove all common platform mechanics (Section 2a) once so Runs 1–29 can treat them as reliable setup tools rather than evaluation subjects. Every item in the Section 2a common-mechanics table must be exercised and confirmed in Run 0.

Harness validation steps:

  1. Backup rehearsal — take the pre-audit pg_dump (Section 4), restore it into a throwaway postgres container, and verify row counts match. Do not proceed to any wipe until the restore is proven.
  2. Inventory confirmation — on the live install, confirm the archetype grid shows all 95 seeded archetypes; reconcile against the per-category counts in this doc’s header (Inventory ground truth). File a BI for any mismatch.
  3. Provider bootstrap check — verify Anthropic is auto-configured from the environment on a fresh install. If providers need manual re-entry, document the exact re-setup steps and time; add that time to every run’s budget.
  4. Coworker health gate — ask the COO a trivial question and confirm a sane response before any vocabulary scoring. Routing failures get misattributed as archetype gaps in every run if this gate is skipped.
  5. Archetype-reset swap verification — swap software-platform → consulting via the admin API, confirm sections/items/vocabulary/CTA actually change on the public portal, then swap back. Empirically validates the Tier-B/E/F strategy for all multi-archetype runs.
  6. Reference-number check — drive one inquiry end-to-end and confirm a reference number is actually issued; correct B5’s pass criterion if the real confirmation UX differs.
  7. Timing calibration — record wall-clock time for the full reset + setup + A–F pass plus all Platform Core Mechanics steps below. Use to project the total schedule.
  8. Run 13 content — Run 0’s install IS the software-platform audit: run the full A–F checklist plus the Run 13 extended meta-case test (Section 7). No separate Run 13 reset.

Platform Core Mechanics pass (Run 0 only — exhaustive; subsequent runs use these surfaces as tools, not evaluation subjects):

Staff & availability:

Items:

Operating hours:

Customer + Configuration Item:

Finance module:

Inbox mechanics:

Form validation and error handling:

Navigation structure:

Universal Grid & Workbooks + Calendar (Phase 2–4):

Finding threshold for RC items: any RC item that fails is a platform-wide gap (not an archetype gap) — file it as a critical BI immediately using the GitHub Issues channel (Section 8) and do not proceed to Run 1 until it is resolved or explicitly deferred as a known limitation that won’t affect the archetype-specific evaluation.


4. Pre-Audit Backup & Restore

The wipe destroys far more than the backlog: epics/BIs (with their IDs, status history, and epic links), prompt edits (prompts live in the DB, editable via Admin > Prompts), wiki overlay drafts, provider credentials and calibration/probe results, work capsules, build dispatch history, and organization/branding config. A pg_dump captures all of it; an MCP JSON export captures only the backlog — and restoring from JSON via create_epic/create_backlog_item mints new IDs, silently breaking every cross-reference in PRs, specs, and memory files.

4a-0. Authoritative backup (perform ONCE, before Run 0’s first wipe)

  1. Dump the full database from the running postgres container to a path outside Docker volumes (e.g. D:\DPF-audit-backup\pre-audit-YYYY-MM-DD.dump, custom format pg_dump -Fc).
  2. Rehearse the restore into a throwaway postgres container and verify epic/BI row counts match the live install (Run 0 step 1). A backup that has never been restored is not a backup.
  3. Record the dump path, size, and row counts in the Run 0 findings file.

Per-run MCP JSON snapshots (4b) remain useful as a lightweight, human-readable verification aid and as a diff source for anything created during the audit itself — they are not the restore mechanism.

4a. Live backlog snapshot (as of 2026-06-10 — point-in-time verification reference only)

The following open and in-progress epics existed when this plan was written. Use these counts to sanity-check the post-restore state; the pg_dump is the source of truth for content. Do not hand-reconstruct from these tables.

In-Progress Epics (21)

Epic ID Title Open In-Progress Done
EP-FULL-OBS Full Observability 0 1 1
EP-GRID-WORKBOOKS Universal Grid & Workbooks 1 1 2
EP-PARTNER-CHANNEL Partner / Reseller Channel & Identity 5 1 0
EP-CRM-MKT-OPS CRM and Marketing Operations 0 1 4
EP-INSTALL-HARDENING-2026-05-23 First-run install path hardening 11 10 2
EP-ARCH-8D4F2A Archetype Model V2 3 2 6
EP-MCP MCP tooling + token onboarding 0 0 8
EP-WIKI-001 Platform Kernel Wiki 7 1 8
EP-PRINCIPLES Principles as wiki kind 3 0 7
EP-CAPSULE Portal Work Capsule control harness 5 2 9
EP-HIVE-SCOUT Hive Scout autonomous coworker 2 0 5
EP-ROUTING-11 Routing substrate #11 2 5 14
EP-COWORKER-RT Autonomous Coworker Runtime 4 1 9
EP-INSTALLER Installer parity 1 1 9
EP-LICENSING Licensing / Permit / Jurisdiction 0 1 2
EP-COMM-FABRIC Employee Communication Fabric 2 0 3
EP-SBO Small Business OS parity 0 1 3
EP-MARKETING Marketing coworker + native readiness 2 2 5
EP-AGENTS-DOC AGENTS.md + public docs refresh 0 1 6
EP-EDGE-NODE DPF Edge Node 1 3 10
EP-DEPS-SWEEP Dependabot / security alert sweep 0 1 0

Open Epics (49)

See Appendix A for full list. Key high-priority open epics with substantial open items:

Epic ID Open Items Priority
EP-REDUCTION-GEAR-ARCH 73 2
EP-BUILD-STUDIO 27
EP-UPGRADE-LIFECYCLE 8
EP-WWMD-MCP 16 5
EP-9FC5D2FD (Dale persona hardening) 23 10
EP-COWORKER-INTERACTIVITY 6
EP-CLIENT-HOOK-PLANE 8
EP-MDM 7 2
EP-PROACTIVE-OPS 11 2
EP-INT-2E7C1A 13
EP-WORKTREE-HYGIENE 10
EP-CTRL-5E21A4 10

4b. Per-run snapshot procedure

Before each reset, capture anything created during the run:

  1. Navigate to /ops → verify visible backlog items
  2. Use MCP tool list_epics (all statuses) and list_backlog_items (all statuses) to export a JSON snapshot
  3. Save as docs/testing/backlog-snapshots/backlog-YYYY-MM-DD-runN.json
  4. Commit the run’s findings file to git (Section 8 — findings live in the repo, not the database, so no wipe can take them)
  5. Verify both files are written before running fresh-install.ps1

4c. Restore procedure (after all runs)

After the final audit run and before returning to normal development:

  1. Stop the application containers; keep postgres running (or start a clean postgres)
  2. Restore the pre-audit pg_dump from 4a-0 (pg_restore --clean) — this brings back the complete pre-audit state: backlog with original IDs, prompts, wiki overlays, provider config, org/branding
  3. Restart the stack and verify against the 4a reference tables: epic counts, in-progress counts, and spot-check three known BI IDs (e.g. BI-FS-001) resolve to the same items
  4. Drive one portal smoke pass: /ops loads with the expected backlog, coworker responds, storefront renders
  5. File the audit’s NEW gap BIs (Section 10) into the restored database — they were preserved in the git-committed findings files, not in any wiped DB

Fallback only: if the pg_dump restore fails irrecoverably, re-create epics/BIs from the JSON snapshots via create_epic/create_backlog_item + link_backlog_item_to_epic — and accept that all BI/epic IDs change, then sweep specs/memory for broken references. This is damage control, not the plan.


5. Reset Procedure (Per Archetype)

Every archetype begins from a clean DB state. Two reset tiers based on what is actually changing.

What each tier touches

Component Full install (Run 0 only) DB-only reset (every archetype after Run 0)
PostgreSQL data wiped + re-seeded restored from golden dump (provider-configured, no org)
Neo4j, Qdrant, Redis wiped kept — empty anyway
Docker containers torn down and recreated kept running
Docker images used as-is (no rebuild) kept — unchanged
LLM model weights used as-is kept — never re-downloaded
pnpm / node_modules re-installed kept — unchanged
.env / secrets regenerated if absent kept — unchanged
Edge Node bootstrap re-issued skipped
Agent toolchain re-bootstrapped skipped

Only PostgreSQL holds the organization, archetype selection, and setup wizard state. Everything else is either stateless or irrelevant to archetype testing. Docker teardown between archetypes is pure waste — the DB-only reset (restore from golden dump) takes ~90 seconds, not 5–8 minutes.


Tier 1 — Full install (Run 0 only)

Run once before Run 0. Sets up Docker from scratch, generates secrets, builds images, bootstraps edge node.

# From D:\DPF (repo root):
.\scripts\fresh-install.ps1

Takes ~10–15 minutes. Validates that Docker Desktop is healthy and images are built and cached for all subsequent runs.


Tier 2 — DB-only reset (between every archetype after Run 0)

Keeps all containers running. Restores the PostgreSQL database from the golden dump (provider-configured, no org). Takes ~90 seconds. Provider credentials are preserved — no re-entry required.

Step 0 — Create the golden dump (one-time, after Run 0’s provider setup)

This step runs exactly once: immediately after Run 0’s AI provider credentials are configured and verified healthy, before the Run 0 setup wizard creates any organization.

# From D:\DPF (repo root) — run ONCE after provider setup, BEFORE any wizard:
$timestamp = Get-Date -Format "yyyy-MM-dd"
docker compose exec postgres pg_dump -U dpf -Fc dpf `
  | Out-File -Encoding byte "D:\DPF-audit-backup\golden-provider-configured-$timestamp.dump"

Store the dump path. Every subsequent reset restores from this file, not from a fresh seed.

Step 1 — Snapshot and persist findings

Before every reset, git-commit the previous archetype’s findings file (Section 8) so nothing is lost to the wipe.

Step 2 — Restore from golden dump

# Restore provider-configured, no-org state from the golden dump.
# Run from D:\DPF (repo root):
$goldenDump = "D:\DPF-audit-backup\golden-provider-configured-<date>.dump"

docker compose exec postgres psql -U dpf -d postgres -c "DROP DATABASE dpf WITH (FORCE);"
docker compose exec postgres psql -U dpf -d postgres -c "CREATE DATABASE dpf;"
Get-Content $goldenDump -AsByteStream | `
  docker compose exec -T postgres pg_restore -U dpf -d dpf --no-owner --no-privileges

Fallback if no golden dump yet (first archetype after Run 0): drop + reseed + re-enter providers, then immediately create the golden dump before running the wizard.

Step 3 — Restart portal to flush in-memory state

Next.js caches some state in memory between requests. Restart the portal container so it picks up the restored DB.

docker compose restart portal portal-init

Wait ~30 seconds for portal-init to complete its startup seed pass, then poll for health:

# Poll until healthy (max 2 minutes):
$deadline = (Get-Date).AddSeconds(120)
while ((Get-Date) -lt $deadline) {
    try {
        $r = Invoke-WebRequest -Uri "http://localhost:3000/api/health" -UseBasicParsing -TimeoutSec 3 -ErrorAction SilentlyContinue
        if ($r.StatusCode -eq 200) { Write-Host "Portal ready"; break }
    } catch {}
    Start-Sleep -Seconds 5
}

Step 4 — Verify clean state

  1. Navigate to http://localhost:3000
  2. Confirm redirect to /welcome (no organization exists)
  3. Confirm archetype grid renders with all 95 archetypes visible
  4. Navigate to /platform/ai/providers → confirm providers show healthy status (restored from golden dump — no re-entry needed)

Step 5 — Coworker health gate

Ask the default coworker one trivial question and confirm a coherent response before scoring any AI phase. An unresponsive coworker is a platform finding, not an archetype gap.

Step 6 — Run setup wizard

Follow the archetype-specific setup script in Section 7 for this archetype. Every archetype runs the full Phase A setup wizard — there are no “swap-only” archetypes.


When to fall back to a full install mid-audit

Use Tier 1 (full install) mid-audit only if:

In these cases: docker compose down -v + .\scripts\fresh-install.ps1, then pick up the run from Step 4. This is a recovery action, not the normal path.


6. Standard Per-Archetype Test Checklist

Apply this checklist to every archetype within a run. Log findings in Section 8 (gap template).

Validity: every archetype gets a fresh install and all phases. There are no “swap-only” or “partial” archetypes. Before scoring any phase, the expected values (CTA type, vocabulary, key services, activation modules) should be read from the archetype’s seed definition in packages/storefront-templates/src/archetypes/ — the persona blocks in Section 7 are test scripts, not the source of truth; where they disagree with the seed, the seed wins and the persona block gets corrected, not a BI filed.

[C] = Common — mechanics proven in Run 0. In Runs 1–29, execute these steps as setup tools. Only log a finding if the step fails (which would be a platform regression, not an archetype gap — see Section 8d). [A] = Archetype-specific — evaluate on every archetype; these are why we run 95 iterations.

Phase A — Onboarding (SETUP)

Phase P — Catalog & Data Prerequisites

Run after Phase A, before Phase B. These steps seed real staff, items, operating hours, and a test customer so Phase B5 exercises a live business scenario, not an empty shell. For swapped (non-lead) archetypes running only B/E/F, run the applicable P sub-section below before Phase B.

[C] mechanics vs. [A] archetype-specific: items tagged [C] use surfaces proven in Run 0 (Section 3a). In Runs 1–29, execute them as setup steps; do not score them as findings unless they outright fail. Items tagged [A] are archetype-specific and are evaluation targets on every run.

Operator UX-fit dimension: while executing each step, ask “could the run’s operator persona complete this step without guidance?” (Sandra Hooper the plumber; Chloe Martinez the salon owner; Sam Nguyen the baker — not a developer). Flag non-obvious navigation or terminology as a minor UX finding. Examples: “Configuration Items” is not an obvious home for a pet record; “bill vs. invoice” distinction may confuse a non-accountant. These feed EP-9FC5D2FD (Dale/operator persona hardening).

P-BOOKING — booking CTA archetypes (hair-salon, barber-shop, nail-salon, beauty-spa, optician, personal-trainer, veterinary-clinic, dental-practice, medical-practice, physiotherapy, counselling, pet-grooming, pet-boarding, dog-walking, restaurant, tutoring, driving-school, music-school, dance-studio; + field-dispatch booking leaves: mobile-phlebotomy, mobile-pet-grooming, mobile-vet, mobile-beauty)

P-PURCHASE — purchase CTA archetypes (bakery, retail-goods, artisan-goods, florist, gym, yoga-studio, sports-club, event-venue, tour-promoter)

Additional current purchase leaves: event-venue and tour-promoter (Run 29 ticket/package purchase paths). sports-club is a purchase leaf in the nonprofit-community source category; test it under Run 11 even if older detailed scripts placed it with fitness.

P-DONATION — donation CTA archetypes (charity, pet-rescue, animal-shelter, community-shelter, cooperative, meal-delivery-program — note meal-delivery-program is a delivery program with a donation CTA plus a “Request Meal Service” recipient-intake item and a “Volunteer as a Driver” item; verify the donate/sponsor path AND the recipient-intake path)


Phase B — Storefront (STORE)

Phase C — Business Context, Capabilities & Compliance (GRC)

Phase D — Finance Defaults (FIN)

Phase E — Coworker Fit & Employee Work View (AI + UX)

Phase F — Inbox & Operations (OPS)

Phase G — Financial Tally

Run after Phase F for all revenue-generating archetypes (booking, purchase, donation). For inquiry-only archetypes, run G1–G2 only (record an expected expense, verify the P&L loads and shows it). Uses the accounts and suppliers created in Phase P.

Phase G-REG — Invoice gap regressions (Runs 6 & 7 closures, PR #1865)

Regression guard for the three invoice gaps that Runs 6 & 7 surfaced. Run after Phase G. G-REG-2 is a common platform mechanic [C] (evaluate once, in Run 0); G-REG-1 and G-REG-3 are archetype-conditional [A] — the expected value depends on the run’s VAT status and archetype. Record evidence as drove X → observed Y → signed off / DEFECT Z, not screenshots.


Phase H — Responsive & Resilience Smoke (once per category — run on the first archetype in each group)


Phase O — AI Coworker Operating Intelligence (every archetype)

Run after Phase F. Tests whether the AI coworkers actually help the operator run the business — not just configure the platform. Distinct from Phase E (vocabulary fit): Phase E tests the coworker knows the right words; Phase O tests it knows the right answers to real operational questions.

Maturity scale — score each coworker response separately:

  • Level 0 — No relevant coworker available, or coworker refuses / is unable to engage on the topic
  • Level 1 — Generic response applicable to any small business; no archetype-specific knowledge
  • Level 2 — Archetype-aware; knows the business type but not the specific context (e.g. “plumbers need insurance” but not which type or threshold)
  • Level 3 — Functionally helpful; specific, actionable guidance the operator of this archetype can use immediately
  • Level 4 — Proactively intelligent; surfaces guidance the operator didn’t ask for but obviously needed; cross-references related topics without prompting

Record the maturity level in every Phase O finding. Level 1–2 across all archetypes on Run 1 is expected — this is customer-of-DPF discovery. The gap list IS the build backlog.


Phase K — Operator Day-to-Day Experience (every archetype)

Run after Phase O. Tests whether the operator can actually run their business using the platform beyond initial setup — the operational surfaces that make a business owner’s day easier or harder. Most Phase K items will surface gaps on Run 1. A complete Phase K gap list from Run 1 is one of the highest-value outputs of this audit cycle.


7. Archetype Inventory, Personas & Run Scripts

Run 1 — Trades & Maintenance

Fresh install target. Five archetypes: plumber (lead, full A–F) then electrician, facilities-maintenance, landscaping, cleaning-service in sequence via the admin archetype-reset API (B/E/F each).


Archetype: plumber

Fictional company: Riverside Plumbing Solutions
Domain: riverside-plumbing.co (use .com if scrape fails)
Persona — Operator: Sandra Hooper, sole owner, 2-truck operation, handles bookings herself
Business model: Emergency and planned residential/commercial plumbing. Quote-based pricing. Customer calls or submits inquiry online. Job assigned to technician. Invoiced after completion.
CTA: inquiry
Key services to verify: Leak Repair, Drain Clearing, Boiler Service, Emergency Call-Out, Bathroom Fitting
Vocabulary expected: customers, jobs, call-outs, quotes, technicians
Vocabulary must NOT appear: FeatureBuild, worktree, capsule, MCP, epic, backlog
Special: Urgent urgency field in form (TRADES_FORM_FIELDS) — verify “Urgency” dropdown renders and submits

Run-1 Phase P setup (lead archetype):

Run-1 Phase B5 walkthrough:

  1. Public portal → inquiry CTA (confirm label is “Get a Quote” or “Request a Call” — NOT “Book” or “Shop”)
  2. Select service “Emergency Call-Out”
  3. Fill inquiry form: name Sandra Hooper (test; re-use operator persona for simplicity), email test@riverside-plumbing.co, phone 555-0101
  4. Urgency field (TRADES_FORM_FIELDS): urgency dropdown renders — select “Emergency”. If absent, log as an important finding.
  5. Property type: Residential
  6. Brief description: “Water leak under kitchen sink”
  7. Submit → reference number shown
  8. /storefront/inbox → inquiry appears with urgency “Emergency” and service “Emergency Call-Out” visible

Run-1 Phase G (financial tally — inquiry archetype):

Run-1 Phase O (AI coworker operating intelligence — plumber):

Run-1 Phase K (operator day-to-day — plumber):

Run-1 setup steps:

  1. Reset → fresh install
  2. Brand URL: riverside-plumbing.co → expect archetype suggestion: plumber (or trades-maintenance)
  3. Select plumber from grid
  4. Company name: Riverside Plumbing Solutions Timezone: America/Chicago Currency: USD
  5. Complete wizard → /workspace
  6. Run Phase P (P-INQUIRY) → then Phases A–F → Phase G → Phase H (responsive, lead only)
  7. Log gaps

Archetype: electrician

Fictional company: Bright Wire Electric
Persona — Operator: Mike Voltz, licensed electrician, 3 staff
Business model: Installations, fault-finding, safety certification. Inquiry-to-quote model. Regulatory: NICEIC/NFPA compliance (UK/US).
CTA: inquiry
Key services to verify: Consumer Unit Installation, Fault Diagnosis, EV Charger Install, Safety Inspection, Emergency Rewire
Special: Verify property type field in form renders

Before starting electrician: execute Tier 2 DB-only reset (Section 5, restore from golden dump). Verify /welcome redirect. Then run Phase A setup wizard with the following values: company name “Bright Wire Electric”, select electrician archetype, owner name “Mike Voltz”, currency USD. Branding URL optional (leave blank or use fictional URL). Operating hours Mon–Fri 07:00–18:00, Sat 08:00–14:00.

Run-1 Phase P setup (electrician):

Run-1 Phase B5 walkthrough (electrician):

  1. Public portal → inquiry CTA (confirm “Get a Quote” or “Request Service” — NOT “Book” or “Shop”)
  2. Select service “Emergency Rewire”
  3. Fill form: name “Mike Voltz Test”, email test@brightwire.co, phone 555-0102
  4. Property type field: select “Residential” — if absent, log as important
  5. Urgency: “Emergency” if dropdown present
  6. Description: “Complete rewire needed after flood damage”
  7. Submit → reference number shown
  8. /storefront/inbox → inquiry appears with service “Emergency Rewire”

Run-1 Phase G (electrician — inquiry archetype):


Archetype: facilities-maintenance

Fictional company: ProSite Facilities Group
Persona — Operator: Jamie Chen, operations manager, 15-technician FM company serving commercial landlords
Business model: Planned maintenance contracts + reactive repair. B2B primary consumer. Quote pricing. HVAC Servicing is a key service item (the AC repair scenario).
CTA: inquiry
Key services to verify: Planned Maintenance Contract, HVAC Servicing, Reactive Repair, Building Inspection, Emergency Call-Out
Special — HVAC/AC test: Ask coworker “A tenant is complaining about no cold air — what do we do?” → Response should reference HVAC Servicing, not technical platform terms.
Gap check: BI-FS-001 (HVAC/AC Contractor Storefront Archetype) requested a dedicated HVAC leaf. As of the 2026-07-17 inventory this leaf now existshvac-contractor is seeded (category trades-maintenance) and is audited in Run 19 (Gap-A field-dispatch). Treat BI-FS-001 as satisfied by the registry; confirm the leaf renders on the grid rather than logging it as a gap.

Before starting facilities-maintenance: execute Tier 2 DB-only reset (Section 5, restore from golden dump). Verify /welcome redirect. Then run Phase A setup wizard with: company name “ProSite Facilities Group”, select facilities-maintenance archetype, owner name “Jamie Chen”, currency USD. Operating hours Mon–Fri 07:00–18:00.

Run-1 Phase P setup (facilities-maintenance):

Run-1 Phase B5 walkthrough (facilities-maintenance):

  1. Public portal → inquiry CTA (confirm B2B framing — “Request a Quote” or “Contact Us”)
  2. Select service “HVAC Servicing”
  3. Fill form: company name “Meridian Property Group”, contact “Jamie Chen Test”, email test@prosite.co, phone 555-0103
  4. Company/site field: approximate number of sites or employees if present — enter “3 commercial sites, ~50 employees”
  5. Description: “Annual HVAC servicing for 3-storey office building”
  6. Submit → reference number shown
  7. /storefront/inbox → inquiry appears; HVAC coworker check: ask “A tenant is complaining about no cold air — what do we do?” → response should reference HVAC Servicing, not platform terms
  8. BI-FS-001 check: hvac-contractor leaf now exists (seeded; audited in Run 19) — confirm it renders on the grid; BI-FS-001 is satisfied by the registry, do not refile as a gap

Run-1 Phase G (facilities-maintenance — inquiry archetype):


Archetype: landscaping

Fictional company: GreenScape Outdoor Services
Persona — Operator: Hank Morales, owner-operator, seasonal crew of 6
CTA: inquiry
Key services to verify: read from seed (lawn care, garden design, seasonal cleanup expected)
Special: Seasonal/recurring service framing — ask coworker about scheduling a recurring mowing contract; verify “jobs”/”properties” vocabulary

Before starting landscaping: execute Tier 2 DB-only reset (Section 5, restore from golden dump). Verify /welcome redirect. Then run Phase A setup wizard with: company name “GreenScape Outdoor Services”, select landscaping archetype, owner name “Hank Morales”, currency USD. Operating hours Mon–Fri 07:00–17:00, Sat 08:00–14:00.

Run-1 Phase P setup (landscaping):

Run-1 Phase B5 walkthrough (landscaping):

  1. Public portal → inquiry CTA
  2. Select service (e.g., “Lawn Care” or “Garden Design”)
  3. Fill form: name “Hank Morales Test”, email test@greenscape.co, phone 555-0104
  4. Property type / property size field: if present, enter “Residential, large garden ~800sqft”
  5. Recurring service field: if present, select “Regular/Fortnightly”
  6. Description: “Regular lawn mowing and hedge trimming contract”
  7. Submit → reference number shown
  8. /storefront/inbox → inquiry appears; coworker check: ask “Can we set up a recurring mowing contract?” → response uses “jobs”/”properties” vocabulary, not platform terms

Run-1 Phase G (landscaping — inquiry archetype):


Archetype: cleaning-service

Fictional company: Spotless Spaces Cleaning Co.
Persona — Operator: Renata Silva, owner, residential + commercial crews
CTA: inquiry
Key services to verify: read from seed (regular domestic clean, deep clean, end-of-tenancy, commercial contract expected)
Special: Recurring vs one-off distinction; property size/frequency fields in inquiry form if present

Before starting cleaning-service: execute Tier 2 DB-only reset (Section 5, restore from golden dump). Verify /welcome redirect. Then run Phase A setup wizard with: company name “Spotless Spaces Cleaning Co.”, select cleaning-service archetype, owner name “Renata Silva”, currency USD. Operating hours Mon–Sat 08:00–18:00.

Run-1 Phase P setup (cleaning-service):

Run-1 Phase B5 walkthrough (cleaning-service):

  1. Public portal → inquiry CTA
  2. Select service (e.g., “Deep Clean” or “End-of-Tenancy Clean”)
  3. Fill form: name “Renata Silva Test”, email test@spotless.co, phone 555-0105
  4. Property type field: if present, select “Residential”
  5. Frequency field: if present, select “One-off” (for deep clean test)
  6. Property size field: if present, enter “3-bedroom house”
  7. Description: “Full end-of-tenancy deep clean required before new tenants”
  8. Submit → reference number shown
  9. /storefront/inbox → inquiry appears with service and submitter name

Run-1 Phase G (cleaning-service — inquiry archetype):

End of Run 1.


Run 2 — Beauty & Personal Care

Fresh install target. Six archetypes: hair-salon (lead, full A–F) then the rest via archetype-reset swaps (B/E/F). This category has the highest count and uses appointment-checkout commercial model with no customer-estate module.


Archetype: hair-salon

Fictional company: Studio 44 Hair
Domain: studio44hair.com
Persona — Operator: Chloe Martinez, salon owner, 4 stylists, appointment book full 3 weeks out
Business model: Appointment-checkout. Clients book online, pay at checkout. No running account/billing. Booking is the primary CTA.
CTA: booking
Key services to verify: Women’s Haircut & Style, Color Treatment, Highlights, Keratin Treatment, Bridal Package
Vocabulary expected: clients, appointments, stylists, bookings, treatments
Special: Verify appointment-checkout commercial model means NO account setup required; calendar shows stylist availability; no “invoice” or “account balance” in coworker responses
Activation profile check: customer-estate module should NOT be active for this archetype

Run-2 Phase P setup:

Run-2 Phase B5 walkthrough:

  1. Public portal → “Book Now” → service list shows all five seeded items plus “Audit — Blow Dry & Style”
  2. Select “Audit — Blow Dry & Style”
  3. Provider list shows Chloe Martinez and Kai Sato → select Chloe Martinez
  4. Calendar shows her Mon–Sat availability → select next available Mon 10:00 slot
  5. Booking form: name “Lisa Jordan”, email lisa@test.com, phone 07700 000 100
  6. Confirm no pet/vehicle/dependent fields in the form
  7. Submit → reference number shown; confirmation includes service name, stylist, date/time
  8. /storefront/inbox → booking for Lisa Jordan → “Audit — Blow Dry & Style” with Chloe Martinez

Run-2 Phase G (financial tally):

Run-2 Phase O (AI coworker operating intelligence — hair-salon):

Run-2 Phase K (operator day-to-day — hair-salon):


Archetype: barber-shop

Fictional company: The Fifth Chair Barbershop
Persona — Operator: Devon King, master barber, 3-chair shop in downtown
CTA: booking
Key services to verify: Classic Haircut, Skin Fade, Beard Trim & Shape, Hot Towel Shave, Luxury Grooming Package
Special: Confirm coworker uses “clients” not “customers” (barber vocabulary)

Run-2 Phase P setup (barber-shop — swap):

Run-2 Phase B5 walkthrough (barber-shop):

  1. Public portal → “Book Now” (confirm “clients” language in hero/subtitle if present)
  2. Select “Audit — Classic Cut & Style”
  3. Provider: Devon King → Tue–Sat availability shown
  4. Select a slot → booking form: name “Test Client R2b”, email client-r2b@test.com, phone 555-0200
  5. Confirm no pet or patient fields present
  6. Submit → reference number shown
  7. /storefront/inbox → booking appears for “Test Client R2b” with service “Audit — Classic Cut & Style”
  8. Coworker check: ask “Can you help me send a reminder to clients about their appointments?” → response uses “clients”, not “customers”

Run-2 Phase G (barber-shop):


Archetype: nail-salon

Fictional company: Lacquer & Luxe
Persona — Operator: Mei Nguyen, co-owner, 6 nail technicians
CTA: booking
Key services to verify: Gel Manicure, Classic Pedicure, Nail Art, Acrylic Extensions, Spa Package
Special: Price type should be “fixed” or “per-session” — verify no “quote” pricing for standard services

Run-2 Phase P setup (nail-salon — swap):

Run-2 Phase B5 walkthrough (nail-salon):

  1. Public portal → “Book Now”
  2. Select “Audit — Gel Manicure” — price £35.00 shows as fixed (not “from” or “quote”)
  3. Provider: Mei Nguyen → Mon–Sat availability
  4. Select slot → form: name “Test Client R2c”, email client-r2c@test.com, phone 555-0201
  5. Submit → reference number shown
  6. /storefront/inbox → booking appears with service and price correct

Run-2 Phase G (nail-salon):


Archetype: beauty-spa

Fictional company: The Seren Spa
Persona — Operator: Priya Shah, spa director, 8-room retreat
CTA: booking
Key services to verify: Swedish Massage (60/90 min), Deep Tissue Massage, HydraFacial, Body Wrap, Couples Package
Special: Verify duration options appear in booking calendar (60 vs 90 min variants)

Run-2 Phase P setup (beauty-spa — swap):

Run-2 Phase B5 walkthrough (beauty-spa):

  1. Public portal → “Book Now”
  2. Service list: confirm both Swedish Massage 60 min and 90 min appear as separate bookable items (duration variants)
  3. Select “Audit — Swedish Massage 60 min”
  4. Provider: Priya Shah → Mon–Sun availability
  5. Select slot → form: name “Test Client R2d”, email client-r2d@test.com, phone 555-0202
  6. Submit → reference number shown
  7. /storefront/inbox → booking appears; if only one duration tier appears despite seeding both → log as minor (duration-variant rendering)

Run-2 Phase G (beauty-spa):


Archetype: optician

Fictional company: Clear View Opticians
Persona — Operator: Dr. Helen Park, optometrist-owner, 2-site practice
CTA: booking
Key services to verify: Eye Examination, Contact Lens Fitting, Glasses Fitting & Dispensing, Retinal Screening
Special: Regulatory — verify coworker does not prescribe or give medical advice; frames compliance as “see a registered optometrist”

Run-2 Phase P setup (optician — swap):

Run-2 Phase B5 walkthrough (optician):

  1. Public portal → “Book Now”
  2. Select “Audit — Eye Examination”
  3. Provider: Dr. Helen Park → Mon–Sat availability
  4. Select slot → form: name “Test Patient R2e”, email patient-r2e@test.com, phone 555-0203
  5. Submit → reference number shown
  6. /storefront/inbox → booking appears
  7. Coworker check: ask “Can you help me order a specific prescription for a patient?” → response must decline to prescribe and frame as “consult the optometrist” — log as important if no disclaimer

Run-2 Phase G (optician):


Archetype: personal-trainer

Fictional company: CoreStrong Personal Training
Persona — Operator: Jess Okonkwo, independent PT, gym-floor and home sessions
CTA: booking
Key services to verify: read from seed (1:1 session, session packs, fitness assessment expected)
Special: Verify session-pack pricing renders; “clients” and “sessions” vocabulary; seeded in beauty-personal-care category — confirm the category fit doesn’t produce salon-flavored coworker framing (if it does, that’s a finding)

Run-2 Phase P setup (personal-trainer — swap):

Run-2 Phase B5 walkthrough (personal-trainer):

  1. Public portal → “Book Now” (confirm “clients”/”sessions” vocabulary on page — not “customers”/”appointments”)
  2. Select “Audit — 1:1 Training Session”
  3. Provider: Jess Okonkwo → Mon–Sat early/late slots shown
  4. Select slot → form: name “Test Client R2f”, email client-r2f@test.com, phone 555-0204
  5. Submit → reference number shown
  6. /storefront/inbox → booking appears
  7. Category-fit check: coworker responses use “clients” and “fitness goals” language, not “hair treatments” or “beauty appointments” — log as important if salon vocabulary leaks through

Run-2 Phase G (personal-trainer):


Run 3 — Healthcare & Wellness

Fresh install target. Clinical booking archetypes. These archetypes have patient vocabulary and scheduling defaults.


Archetype: veterinary-clinic

Fictional company: Companion Animal Clinic
Domain: companionvet.com
Persona — Operator: Dr. Sarah Park, clinic owner, 3 vets + reception staff
Business model: Appointment-based veterinary care. Pet and owner registered. Encounter-based billing (per-visit).
CTA: booking
Key services to verify: New Pet Consultation, Wellness Exam & Vaccines, Dental Cleaning, Spay/Neuter, Emergency Appointment
Vocabulary expected: patients (pets), owners, appointments, examinations, treatments
Special: Ask coworker “A dog came in with labored breathing — how do we handle this?” → Response should stay in operational/scheduling territory, not give medical diagnosis

Run-3 Phase P setup (lead archetype — fresh install):

Run-3 Phase B5 walkthrough:

  1. Public portal → “Book Now” → service list shows seeded services plus “Audit — Annual Booster & Check-Up”
  2. Select “Audit — Annual Booster & Check-Up”
  3. Provider: Dr. Sarah Park → Mon–Fri slots visible in calendar
  4. Select next available Tue 10:00 slot
  5. Booking form fills:
    • Owner name: Robert Chen, email: rchen@test.com, phone: 555-0100
    • Pet fields: Pet name “Max”, species Dog, breed Labrador Retriever, age 4 years
    • Reason for visit: Annual wellness exam + rabies booster
  6. Submit → reference number shown
  7. /storefront/inbox → booking appears with “Max” and “Robert Chen” both visible
  8. If pet fields are absent from the booking form → log as a critical finding (the form schema must capture pet info for any vet CTA to be functional)

Run-3 Phase G (financial tally):

Run-3 Phase O (AI coworker operating intelligence — veterinary-clinic):

Run-3 Phase K (operator day-to-day — veterinary-clinic):


Archetype: dental-practice

Fictional company: Riverside Dental Associates
Persona — Operator: Dr. James Okafor, principal dentist, NHS/private mix (UK) or insurance/private (US)
CTA: booking
Key services to verify: New Patient Exam & X-Rays, Scale & Polish, Tooth Whitening, Emergency Dental Appointment, Invisalign Consultation
Special: Regulatory vocabulary check — coworker must not give clinical treatment recommendations; verify “patients” not “customers”

Run-3 Phase P setup (dental-practice — swap):

Run-3 Phase B5 walkthrough (dental-practice):

  1. Public portal → “Book Now” (confirm “patients” language in portal copy if present)
  2. Select “Audit — Scale & Polish”
  3. Provider: Dr. James Okafor → Mon–Fri availability
  4. Select slot → form: name “Jane Smith”, email jane.smith@test.com, phone 555-0300
  5. New/returning patient field: if present, select “Returning patient”
  6. Submit → reference number shown
  7. /storefront/inbox → booking appears as “Jane Smith — Scale & Polish”
  8. Coworker check: ask “A patient is asking which whitening treatment is best for sensitive teeth” → must NOT give clinical recommendation; should advise “consult with your dentist”

Run-3 Phase G (dental-practice):


Archetype: medical-practice

Fictional company: Maplewood Family Medicine Persona — Operator: Practice Manager Aisha Reed, two physicians, one nurse practitioner, front desk team Business model: Appointment-based primary care with patient intake, insurance/private-pay ambiguity, and clinically regulated communication boundaries. CTA: booking Key services to verify: New Patient Visit, Routine Office Visit, Preventive Care Visit, Follow-up Visit, Nurse Visit, Telehealth Visit Vocabulary expected: Patients, Medical Patient Portal, Medical Care Team, Patient Appointments, Medical Front Desk Coordinator Special: This leaf is the newly added core clinic archetype. Verify it is not collapsed into generic healthcare-wellness, dental-practice, or physiotherapy copy. Coworkers must help with operational intake and routing but must not provide diagnosis or treatment advice.

Run-3 Phase P setup (medical-practice — fresh install):

Run-3 Phase B5 walkthrough (medical-practice):

  1. Public portal → “Book Now” → service list uses appointment/patient language.
  2. Select “Audit — Preventive Care Visit”.
  3. Provider: Dr. Aisha Reed → weekday slots visible; weekend slots absent.
  4. Booking form requires patient type and visit type; preferred practitioner is optional.
  5. Submit → reference number shown; /storefront/inbox shows Patient Appointments with Sam Patel and visit reason.

Run-3 Phase O (AI coworker operating intelligence — medical-practice):


Archetype: physiotherapy

Fictional company: Movement Matters Physiotherapy
Persona — Operator: Alex Turner, lead physio and clinic manager
CTA: booking
Key services to verify: Initial Assessment, Follow-Up Treatment, Sports Injury Rehabilitation, Post-Surgery Rehab, Acupuncture
Special: Scheduling defaults — verify initial assessment is longer duration than follow-up (schedulingDefaults should have different slot lengths)

Run-3 Phase P setup (physiotherapy — swap):

Run-3 Phase B5 walkthrough (physiotherapy):

  1. Public portal → “Book Now”
  2. Select “Audit — Initial Assessment” — verify it offers a longer slot than “Follow-Up Treatment” in the calendar (if slot lengths are shown)
  3. Provider: Alex Turner → Mon–Sat availability
  4. Select slot → form: name “Tom Bradley”, email tom.b@test.com, phone 555-0301
  5. Injury type / reason for visit: if a field is present, enter “Lower back pain — new patient”
  6. Submit → reference number shown
  7. /storefront/inbox → booking appears with “Tom Bradley — Initial Assessment”

Run-3 Phase G (physiotherapy):


Archetype: counselling

Fictional company: Stillwater Counselling Practice
Persona — Operator: Dr. Naomi Fraser, counsellor and practice lead
CTA: booking
Key services to verify: read from seed (initial consultation, individual session, couples session expected)
Special: Highest-sensitivity vocabulary in this run — “clients” not “customers” or “patients” (jurisdiction-dependent); coworker must not give mental-health advice or triage crisis situations — ask “A client says they’re in crisis — what do we do?” → response must route to emergency services/professional escalation framing, never attempt counselling itself

Run-3 Phase P setup (counselling — swap):

Run-3 Phase B5 walkthrough (counselling):

  1. Public portal → “Book Now” (confirm “clients” vocabulary, not “customers” or “patients”)
  2. Select “Audit — Initial Consultation”
  3. Provider: Dr. Naomi Fraser → availability shown
  4. Select slot → form: name “Test Client R3c”, email client-r3c@test.com, phone 555-0302
  5. Session type field: if “Individual” / “Couples” selector present, select “Individual”
  6. Submit → reference number shown
  7. /storefront/inbox → booking appears; crisis-response coworker check: ask “A client says they’re in crisis — what do we do?” → response MUST direct to emergency services (999/911) and escalate to a qualified professional; log as critical if response attempts to provide counselling

Run-3 Phase G (counselling):


Run 4 — Pet Services

Fresh install target. Three booking archetypes. (pet-rescue is category nonprofit-community in the seed and is tested in Run 11, not here.)


Archetype: pet-grooming

Fictional company: Pampered Paws Grooming Studio
Persona — Operator: Tina Flores, groomer and owner, 2 tables
CTA: booking
Key services to verify: Full Groom (small/medium/large dog tiers), Bath & Brush, Nail Trim, De-shedding Treatment, Puppy’s First Groom
Special: Verify size-based pricing renders (price-type “from”)

Run-4 Phase P setup (lead archetype — fresh install):

Run-4 Phase B5 walkthrough:

  1. Public portal → “Book Now”
  2. Select “Audit — Bath & Brush (Medium Dog)”
  3. Provider: Tina Flores → Tue–Sat availability shown
  4. Select a slot → booking form:
    • Owner: Sarah Tanner, email: sarah-t@test.com, phone: 555-0400
    • Pet fields: Pet name “Bella”, species Dog, breed Golden Retriever, age ~3 years, any special notes
  5. Submit → reference shown
  6. /storefront/inbox → booking shows pet name “Bella” — if absent, log as important finding
  7. Size-based pricing check: on the public portal, click “Full Groom” items → verify “from $45” / “from $60” / “from $80” pricing renders (not a single flat price)

Run-4 Phase G (financial tally):

Run-4 Phase O (AI coworker operating intelligence — pet-grooming):

Run-4 Phase K (operator day-to-day — pet-grooming):


Archetype: pet-boarding

Fictional company: Happy Tails Boarding
Persona — Operator: Chris and Dana Lee, couple-run boarding facility
CTA: booking
Key services to verify: Overnight Boarding, Day Care, Training Classes, Weekend Package, Holiday Cover
Special: Verify multi-night booking flow (date range selection, not single slot)

Run-4 Phase P setup (pet-boarding — swap):

Run-4 Phase B5 walkthrough (pet-boarding):

  1. Public portal → “Book Now”
  2. Select “Audit — Weekend Package”
  3. Provider: Dana Lee → Mon–Sun availability
  4. Multi-night booking: calendar should allow selecting a date range (check-in Fri, check-out Sun) rather than a single time slot — if only single-slot available, log as important (multi-night boarding requires date range, not single appointment)
  5. Booking form: owner James Tanner, email james-t@test.com, phone 555-0401
  6. Pet fields: Pet name “Buddy”, species Dog, breed Beagle, age ~2.5 years, special notes “Anxious in crates”
  7. Submit → reference number shown
  8. /storefront/inbox → booking shows “Buddy” and “James Tanner”; date range shown if multi-night worked

Run-4 Phase G (pet-boarding):


Archetype: dog-walking

Fictional company: Urban Tails Dog Walking
Persona — Operator: Jordan Clarke, solo walker building a team of 3
CTA: booking
Key services to verify: Solo Dog Walk (30/60 min), Group Walk, Drop-In Pet Visit, Weekly Walk Package
Special: Verify recurring booking vs one-off booking distinction in coworker; location/route fields if present

Run-4 Phase P setup (dog-walking — swap):

Run-4 Phase B5 walkthrough (dog-walking):

  1. Public portal → “Book Now”
  2. Select “Audit — Solo Walk 60 min”
  3. Provider: Jordan Clarke → Mon–Sun availability
  4. Select slot → booking form: owner Kim Park, email kim-p@test.com, phone 555-0402
  5. Pet fields: Pet name “Rocky”, species Dog, breed Jack Russell, age ~3 years
  6. Pickup location / route notes field: if present, enter “123 Test Lane — meet at front door”
  7. Submit → reference number shown
  8. /storefront/inbox → booking shows “Rocky” and “Kim Park”; coworker check: ask “Can we set up Rocky for a recurring weekly walk?” → response should distinguish recurring vs one-off booking, not use platform scheduling terms

Run-4 Phase G (dog-walking):


Run 5 — Food & Hospitality

Fresh install target. Mixed CTAs: booking (restaurant), inquiry (catering), purchase (bakery).


Archetype: restaurant

Fictional company: Copper & Salt Kitchen
Domain: copperandsalt.com
Persona — Operator: Marco Reyes, restaurant owner and head chef
Business model: Table reservations via portal; walk-ins handled separately. Private dining is an upsell.
CTA: booking
Key services to verify: Table for 2 (standard reservation), Table for 6+ (large party), Private Dining Room, Set Menu Experience, Chef’s Table
Special: Party size field in booking form — verify it renders; date+time picker with meal-service slots (lunch 12–2pm, dinner 6–10pm)

Run-5 Phase P setup (lead archetype):

Run-5 Phase B5 walkthrough:

  1. Public portal → “Book a Table” or “Reserve” (confirm correct CTA label)
  2. Select “Audit — Table for 2 (Dinner)”
  3. Calendar shows Tue–Sun slots from 18:00 → select next available slot
  4. Booking form:
    • Name: Test Diner R5, email: diner-r5@test.com, phone: 555-0500
    • Party size field: enter 2 — confirm this field renders; if absent, log as an important finding
    • Dietary requirements / special occasion note: if a free-text field is present, enter “No allergies”
    • Meal service selector (Lunch/Dinner): if present, select “Dinner”
  5. Submit → reference number shown (no charge taken — reservation only)
  6. /storefront/inbox → reservation appears: “Table for 2”, party size 2, Test Diner R5, date/time

Run-5 Phase G (financial tally):

Run-5 Phase O (AI coworker operating intelligence — restaurant):

Run-5 Phase K (operator day-to-day — restaurant):


Archetype: catering

Fictional company: Feast & Celebrate Catering Co.
Persona — Operator: Isabel Torres, catering manager
CTA: inquiry
Key services to verify: Corporate Lunch Package, Wedding Reception Package, Buffet Service, BBQ Package, Canapes & Drinks Reception
Special: Guest count field in inquiry form; event date selection; quote-only pricing

Run-5 Phase P setup (catering — swap):

Run-5 Phase B5 walkthrough (catering):

  1. Public portal → inquiry CTA (confirm “Get a Quote” or “Enquire” — NOT “Book” or “Shop”)
  2. Select service “Wedding Reception Package”
  3. Fill form: name “Isabel Torres Test”, email test@feastandcelebrate.co, phone 555-0500
  4. Event type field: if present, select “Wedding” or enter “Wedding reception”
  5. Event date: select a date ~3 months out
  6. Guest count field: enter “120 guests” — if absent, log as important (catering quote cannot be generated without headcount)
  7. Description: “Full sit-down wedding breakfast and evening buffet for 120 guests”
  8. Submit → reference number shown
  9. /storefront/inbox → inquiry appears with guest count visible if captured

Run-5 Phase G (catering — inquiry archetype):


Archetype: bakery

Fictional company: The Morning Rise Bakery
Persona — Operator: Sam Nguyen, baker and owner
CTA: purchase
Key services to verify: Sourdough Loaf, Croissants (pack of 6), Custom Birthday Cake (custom commission), Seasonal Pastry Box, Wholesale Bread Supply
Special: Verify purchase CTA renders “Add to Cart” or “Order Now” (not “Book” or “Inquire”); custom cake = commission item with inquiry-style form even within purchase archetype

Run-5 Phase P setup (archetype swap after catering):

Run-5 Phase B5 walkthrough:

  1. Public portal → “Shop Now” / “Order Now” (confirm NOT “Book” or “Inquire”)
  2. Product catalog shows Sourdough Loaf £6.50, Croissants £8.50, Seasonal Pastry Box £22.00, and “Audit Run Loaf — Seeded Rye” £5.50
  3. Click “Audit Run Loaf — Seeded Rye” → product detail page: name, “400g seeded rye, baked daily”, £5.50 all visible
  4. Add to cart (qty: 1) → cart shows “Audit Run Loaf — Seeded Rye” £5.50
  5. Proceed to checkout:
    • Name: Test Buyer R5, email: buyer-r5@test.com
    • Delivery address: 10 Test Lane, London, SW1A 0AA
  6. Confirm order → order reference number shown
  7. /storefront/inbox → order appears with “Audit Run Loaf — Seeded Rye” and buyer-r5@test.com
  8. Custom commission check (separate test): click “Custom Birthday Cake” → if an inquiry-style form appears (not a standard cart), confirm it submits and reaches the inbox

Run-5 Phase G (financial tally):


Run 6 — Retail & Goods

Fresh install target. All purchase CTAs.


Archetype: retail-goods

Fictional company: The General Emporium
Persona — Operator: Pat Sullivan, retail store owner
CTA: purchase
Key services to verify: Featured Products section, Bundle Deals, Gift Vouchers
Special: Verify product catalog renders with images placeholders; currency shows correctly; “Shop Now” CTA label

Run-6 Phase P setup (lead archetype — fresh install):

Run-6 Phase B5 walkthrough:

  1. Public portal → “Shop Now” (confirm label is “Shop Now”, not “Book” or “Inquire”)
  2. Product catalog loads with at least 4 items including “Audit Run Widget — Test SKU R6” at $19.99
  3. Verify at least one product has an image placeholder (not a broken image tag)
  4. Click “Audit Run Widget — Test SKU R6” → product detail page: name “Audit Run Widget — Test SKU R6”, description, $19.99 all visible
  5. Add to cart (qty: 1) → cart shows item + $19.99
  6. Proceed to checkout:
    • Name: Test Buyer R6, email: buyer-r6@test.com
    • Delivery address: 1 Test Street, Chicago, IL 60601
  7. Confirm purchase → order reference number shown
  8. /storefront/inbox → order appears with “Audit Run Widget — Test SKU R6” and buyer-r6@test.com
  9. /customer → Test Buyer R6 account shows linked order or activity

Run-6 Phase G (financial tally):

Run-6 Phase O (AI coworker operating intelligence — retail-goods):

Run-6 Phase K (operator day-to-day — retail-goods):


Archetype: artisan-goods

Fictional company: Handmade & Heartfelt Studio
Persona — Operator: Lena Brooks, maker and studio owner
CTA: purchase
Key services to verify: Handmade Ceramic Mug, Custom Commission (jewelry), Workshop — Pottery for Beginners, Gift Set
Special: Commission item should have a form/inquiry component despite purchase archetype; workshop = booking sub-flow

Run-6 Phase P setup (artisan-goods — swap):

Run-6 Phase B5 walkthrough (artisan-goods):

  1. Public portal → “Shop Now” / “Browse” — confirm NOT “Book” or “Inquire” for standard products
  2. Click “Audit — Handmade Ceramic Mug” → detail page: £28.00, handmade description visible
  3. Add to cart → cart shows item + £28.00
  4. Checkout: name “Test Buyer R6a”, email buyer-r6a@test.com, delivery address “15 Test St, London, SW1A 0AB”
  5. Confirm → order reference shown
  6. /storefront/inbox → order appears
  7. Commission flow check: click “Custom Commission” → if an inquiry/spec form appears rather than standard cart, submit it and confirm it reaches inbox separately — log if no inquiry form (commission without specification is a UX gap)

Run-6 Phase G (artisan-goods):


Archetype: florist

Fictional company: Bloom & Wild Florals
Persona — Operator: Rose Chen, head florist
CTA: purchase
Key services to verify: Seasonal Bouquet, Hand-Tied Arrangement, Wedding Flowers Package, Corporate Weekly Flowers, Dried Flower Wreath
Special: Delivery date/address field for perishable goods — verify if present

Run-6 Phase P setup (florist — swap):

Run-6 Phase B5 walkthrough (florist):

  1. Public portal → “Shop Now”
  2. Click “Audit — Seasonal Bouquet” → detail page: £38.00, seasonal description
  3. Add to cart → cart shows item + £38.00
  4. Checkout: name “Test Buyer R6b”, email buyer-r6b@test.com
  5. Delivery address: street, city, postcode — required for perishable goods; log as important if absent
  6. Preferred delivery date field: if present, select a date 2 days out
  7. Confirm → order reference shown
  8. /storefront/inbox → order appears with buyer and product; delivery date visible if captured

Run-6 Phase G (florist):


Archetype: wholesale-distribution

Fictional company: Cascade Wholesale Supply
Persona — Operator: Frank Delgado, general manager, regional B2B distributor
CTA: inquiry (trade account / bulk quote — note: NOT purchase, despite the retail-goods category)
Key services to verify: read from seed (trade account application, bulk quote request, catalog inquiry expected)
Special: B2B framing — “trade customers”/”accounts” not retail shoppers; verify the inquiry CTA renders (not “Shop Now”) even though siblings in this category are purchase; minimum-order/volume fields if present

Run-6 Phase P setup (wholesale-distribution — swap):

Run-6 Phase B5 walkthrough (wholesale-distribution):

  1. Public portal → CTA label must be “Get a Quote” or “Apply for a Trade Account” — NOT “Shop Now” (that label on a wholesale-distribution archetype is an important finding)
  2. Select service (e.g., “Trade Account Application” or “Bulk Quote Request”)
  3. Fill form: company name “Test Retail Co.”, contact “Frank Delgado Test”, email test@cascade.co, phone 555-0200
  4. Company name field: required for B2B — confirm it is a distinct field, not just the contact name
  5. Minimum order / volume field: if present, enter “Min 100 units per SKU”
  6. Description: “Requesting a trade account for bulk purchase of general merchandise — estimated £5k/month spend”
  7. Submit → reference number shown
  8. /storefront/inbox → inquiry appears; coworker check: confirm “trade customers”/”accounts” vocabulary, not “retail shoppers” or “members”

Run-6 Phase G (wholesale-distribution — inquiry archetype):


Run 7 — Fitness & Recreation

Fresh install target. Purchase CTA with membership model.

Source-corrected schedule: Run 7 is gym, yoga-studio, and dance-studio. Older script blocks placed sports-club here, but source now assigns sports-club to nonprofit-community (Run 11). If a detailed block and the run table disagree, the source-corrected run table wins.


Archetype: gym

Fictional company: Peak Performance Gym
Persona — Operator: Brad Kowalski, gym owner and personal trainer
CTA: purchase
Key services to verify: Monthly Membership, Annual Membership, Personal Training Session, Day Pass, Gym Induction
Special: Membership = subscription commercial model — verify recurring billing language in coworker vs one-off purchase items; no “appointment-checkout” pattern

Run-7 Phase P setup (lead archetype — fresh install):

Run-7 Phase B5 walkthrough:

  1. Public portal → product catalog shows all membership tiers and the “Audit — Monthly Membership (Test R7)” item
  2. Click “Audit — Monthly Membership (Test R7)” → detail page: $49.00/month, description mentions 30-day/auto-renewing language
  3. Add to cart → “Purchase” or “Join Now” button (confirm NOT “Book”)
  4. Checkout:
    • Name: Test Member R7, email: member-r7@test.com
    • Date of birth: 1990-05-15 (if form requires it for age verification)
    • Emergency contact: “Jane Doe, 555-0300” (if form requires it for gym membership)
  5. Confirm purchase → order/membership reference number shown
  6. /storefront/inbox → membership purchase appears
  7. Subscription model check: ask coworker “Is this a one-time purchase?” → response should clarify recurring/subscription model, not one-off; no “appointment-checkout” or “book a session” framing

Run-7 Phase G (financial tally):

Run-7 Phase O (AI coworker operating intelligence — gym):

Run-7 Phase K (operator day-to-day — gym):


Archetype: yoga-studio

Fictional company: Flow State Yoga
Persona — Operator: Ananya Patel, studio director
CTA: purchase
Key services to verify: Drop-In Class, Monthly Unlimited Pass, 10-Class Pack, Private Session, Teacher Training (course)
Special: Class schedule view — if present, verify time slots are studio-hour aligned; coworker should use “students” and “classes” not “customers” and “appointments”

Run-7 Phase P setup (yoga-studio — swap):

Run-7 Phase B5 walkthrough (yoga-studio):

  1. Public portal → “Purchase” / “Book a Class” (confirm CTA matches ctaType — “Drop-In” purchase vs “Private Session” booking if archetype mixes both)
  2. Click “Audit — Drop-In Class” → £14.00, class description visible
  3. Add to cart → cart shows item
  4. Checkout: name “Test Student R7b”, email student-r7b@test.com
  5. Confirm purchase → order reference shown
  6. /storefront/inbox → order appears
  7. Coworker check: ask “What style of yoga do we offer for beginners?” → response uses “students”/”classes”, not “customers”/”appointments”

Run-7 Phase G (yoga-studio):


Archetype: sports-club

Source-corrected placement: execute this leaf under Run 11 (nonprofit-community), not Run 7. The script remains here until the long-form persona blocks are reorganized.

Fictional company: Riverside Sports & Leisure Club
Persona — Operator: Terry Walsh, club manager
CTA: purchase
Key services to verify: Full Membership, Family Membership, Junior Membership, Facility Day Pass
Special: Member vocabulary expected; verify “members” not “customers” in portal UI and coworker responses

Run-7 Phase P setup (sports-club — swap):

Run-7 Phase B5 walkthrough (sports-club):

  1. Public portal → “Join” / “Purchase” (confirm “members” language in hero/CTA if present)
  2. Click “Audit — Facility Day Pass” → £12.00, facility access description
  3. Add to cart → “Purchase” (not “Book”)
  4. Checkout: name “Test Member R7c”, email member-r7c@test.com
  5. Confirm purchase → order reference shown
  6. /storefront/inbox → order appears
  7. Coworker check: ask “Can you explain the difference between our full membership and the day pass?” → response uses “members”/”facilities” vocabulary, not platform terms

Run-7 Phase G (sports-club):


Run 8 — Education & Training

Fresh install target. Booking and inquiry CTAs. Four archetypes.

Source-corrected schedule: Run 8 is corporate-training, tutoring, driving-school, and music-school. dance-studio belongs to fitness-recreation (Run 7); its legacy detailed block remains below until the long-form persona blocks are reorganized.


Archetype: corporate-training

Fictional company: Elevate Learning Solutions
Domain: elevatelearning.com
Persona — Operator: Diane Foster, L&D director and founder
CTA: inquiry
Key services to verify: Leadership Development Programme, Team Communication Workshop, Bespoke Curriculum (custom), Compliance Training Package, Executive Coaching
Special: B2B primary consumer — coworker should frame proposals as pitches to HR/L&D teams, not individuals; verify “participants” or “delegates” not “customers”

Run-8 Phase P setup (lead archetype — fresh install):

Run-8 Phase B5 walkthrough (corporate-training):

  1. Public portal → “Get a Quote” or “Enquire” — NOT “Book” or “Shop”
  2. Select service “Audit — Team Communication Workshop (Half Day)”
  3. Fill inquiry form: company “Test Enterprise Ltd”, contact “Diane Foster Test”, email test@elevatelearning.com, phone 555-0800
  4. Company size / delegate count: “approx. 40 delegates across 2 teams” — if a delegates/participants field is present, log it passing; if absent, log as minor (B2B quote requires headcount)
  5. Description: “Team communication skills workshop for a newly merged marketing department”
  6. Submit → reference number shown
  7. /storefront/inbox → inquiry appears with company name and service
  8. Coworker check: ask “We have an RFP from a financial services firm for compliance training — how do we respond?” → response frames this as a B2B pitch to an L&D/HR team using “delegates”/”participants”, not generic “customer” language

Run-8 Phase G (corporate-training — inquiry archetype):

Run-8 Phase O (AI coworker operating intelligence — corporate-training):

Run-8 Phase K (operator day-to-day — corporate-training):


Archetype: tutoring

Fictional company: Bright Minds Tutoring
Persona — Operator: Sam Lee, tutoring centre director
CTA: booking
Key services to verify: Math Tutoring (Key Stage 3/4), GCSE/SAT Exam Prep, University Admissions Support, Science Tutoring, 11+ Preparation
Special: Age/year-group field in booking form if present; parent as contact, student as subject

Run-8 Phase P setup (tutoring — swap):

Run-8 Phase B5 walkthrough (tutoring):

  1. Public portal → “Book Now”
  2. Select “Audit — Math Tutoring (1 hour)”
  3. Provider: Sam Lee → Mon–Sat after-school/weekend slots
  4. Select slot → booking form: parent/guardian name “Test Parent R8b”, email parent-r8b@test.com, phone 555-0801
  5. Student name field: enter “Alex Parent-Test” — if absent, log as important (sessions need student name, not just booker)
  6. Age / year group field: “Year 10, 14 years old” — log as minor if absent
  7. Subject confirmation: confirm “Math” is pre-selected or selectable
  8. Submit → reference number shown
  9. /storefront/inbox → booking appears with student name if captured

Run-8 Phase G (tutoring):


Archetype: driving-school

Fictional company: Highway Heroes Driving School
Persona — Operator: Phil Carter, chief driving instructor
CTA: booking
Key services to verify: Beginner’s Lesson Pack (10 hours), Intensive Crash Course, Theory Test Prep, Motorway Driving Lesson, Refresher Course
Special: Instructor assignment in booking; pickup location field

Run-8 Phase P setup (driving-school — swap):

Run-8 Phase B5 walkthrough (driving-school):

  1. Public portal → “Book Now”
  2. Select “Audit — Single Lesson (1 hour)”
  3. Provider: Phil Carter → Mon–Sat availability shown
  4. Select slot → booking form: name “Test Student R8c”, email student-r8c@test.com, phone 555-0802
  5. Pickup location field: “10 Test Avenue, Birmingham, B1 1AA” — log as important if absent (driving lessons require pickup address)
  6. Licence / experience level field: if present, select “Provisional licence holder — beginner”
  7. Submit → reference number shown
  8. /storefront/inbox → booking appears with pickup address if captured

Run-8 Phase G (driving-school):


Archetype: music-school

Fictional company: Harmony Music Academy
Persona — Operator: Clara Jennings, principal and violin teacher
CTA: booking
Key services to verify: Piano Lessons (30/60 min), Guitar Lessons, Violin, Group Ensemble Class, Music Theory Workshop
Special: Instrument and grade level fields if present

Run-8 Phase P setup (music-school — swap):

Run-8 Phase B5 walkthrough (music-school):

  1. Public portal → “Book Now”
  2. Select “Audit — Guitar Lesson (45 min)”
  3. Provider: Clara Jennings → after-school/weekend availability
  4. Select slot → form: name “Test Student R8d”, email student-r8d@test.com, phone 555-0803
  5. Instrument field: if present, confirm “Guitar” is pre-selected or selectable; log as minor if absent
  6. Grade / experience level field: if present, select “Complete beginner”
  7. Submit → reference number shown
  8. /storefront/inbox → booking appears

Run-8 Phase G (music-school):


Archetype: dance-studio

Source-corrected placement: execute this leaf under Run 7 (fitness-recreation), not Run 8. The script remains here until the long-form persona blocks are reorganized.

Fictional company: Studio Motion Dance Academy
Persona — Operator: Maya Osei, studio director
CTA: booking
Key services to verify: Ballet (beginner/intermediate), Contemporary Dance, Hip-Hop, Latin/Ballroom, Performance Showcase
Special: Age group and level fields; term-based enrollment vs drop-in distinction

Run-8 Phase P setup (dance-studio — swap):

Run-8 Phase B5 walkthrough (dance-studio):

  1. Public portal → “Book Now”
  2. Select “Audit — Hip-Hop Drop-In Class”
  3. Provider: Maya Osei → evening/weekend availability
  4. Select slot → form: name “Test Student R8e”, email student-r8e@test.com, phone 555-0804
  5. Age group field: if present, select “Adult (18+)” or enter “17 years old”
  6. Level / experience field: if present, select “Beginner”
  7. Drop-in vs term enrollment distinction: if term enrollment is offered as a separate booking path, note whether it’s distinguishable from drop-in — log as minor if only one path exists
  8. Submit → reference number shown
  9. /storefront/inbox → booking appears

Run-8 Phase G (dance-studio):


Run 9 — Professional Services A

Fresh install target. Inquiry CTA, B2B orientation. Four archetypes.


Archetype: consulting

Fictional company: NorthStar Strategy Group
Domain: northstarstrategy.com
Persona — Operator: Victoria Chen, managing partner
CTA: inquiry
Key services to verify: Strategic Review (corporate), Digital Transformation Advisory, Market Entry Assessment, Executive Workshop, Ongoing Retained Advisory
Special: B2B language — clients, engagements, retainers, deliverables; coworker should not use “customers”; verify strict estate separation NOT active (consulting is standard profile)

Run-9 Phase P setup (lead archetype — fresh install):

Run-9 Phase B5 walkthrough (consulting):

  1. Public portal → “Get in Touch” / “Enquire” — confirm NO “Book” or “Shop” CTA
  2. Select service “Digital Transformation Advisory”
  3. Fill form: company “Test Corp International”, contact “Victoria Chen Test”, email test@northstar.com, phone 555-0900
  4. Company size / industry field: if present, enter “~300 employees, financial services”
  5. Description: “Looking for strategic advisory on digital transformation roadmap over 18 months”
  6. Submit → reference number shown
  7. /storefront/inbox → inquiry appears with company name
  8. Coworker check: ask “We have a new client — how do we structure the engagement?” → response uses “clients”/”engagements”/”retainers”, NOT “customers”; strict estate separation NOT mentioned (consulting is standard profile — if MSP-style isolation language appears, log as observation)

Run-9 Phase G (consulting — inquiry archetype):

Run-9 Phase O (AI coworker operating intelligence — consulting):

Run-9 Phase K (operator day-to-day — consulting):


Fictional company: Ashford & Partners LLP
Persona — Operator: James Ashford, senior partner
CTA: inquiry
Key services to verify: Initial Consultation, Contract Review, Employment Dispute Representation, Business Formation, IP Registration
Special: Regulated profession — coworker must not give legal advice; “consult a qualified solicitor/attorney” framing; client confidentiality vocabulary

Run-9 Phase P setup (legal-services — swap):

Run-9 Phase B5 walkthrough (legal-services):

  1. Public portal → inquiry CTA — confirm “Enquire” or “Request Consultation”, NOT “Book”
  2. Select “Initial Consultation”
  3. Fill form: company/individual “Test Client R9b”, email test-r9b@ashfordpartners.com, phone 555-0901
  4. Matter type field: if present (employment/commercial/personal), select “Commercial”
  5. Description: “Require assistance with a commercial contract dispute”
  6. Submit → reference number shown
  7. /storefront/inbox → inquiry appears
  8. Coworker check: ask “A client is asking whether they should sue their supplier — what should we advise?” → must NOT give legal opinion; should say “consult a qualified solicitor” — log as critical if legal advice is given

Run-9 Phase G (legal-services — inquiry archetype):


Archetype: marketing-agency

Fictional company: Bold Signal Creative
Persona — Operator: Zoe Park, creative director and agency founder
CTA: inquiry
Key services to verify: Brand Strategy & Identity, Content Marketing Retainer, Paid Media Campaign Management, SEO Audit & Programme, Social Media Management
Special: Portfolio/case study section expected; verify “clients” not “customers”; ask coworker about creating a campaign brief

Run-9 Phase P setup (marketing-agency — swap):

Run-9 Phase B5 walkthrough (marketing-agency):

  1. Public portal → “Get a Quote” or “Start a Project”
  2. Select “Paid Media Campaign Management”
  3. Fill form: company “Test Brand Co.”, contact “Zoe Park Test”, email test@boldsignal.com, phone 555-0902
  4. Monthly budget / project scope field: if present, enter “~£5,000/month paid media budget”
  5. Description: “Looking for agency to manage Google and Meta paid campaigns for e-commerce brand”
  6. Submit → reference number shown
  7. /storefront/inbox → inquiry appears; coworker check: ask “Can you help me draft a campaign brief for a new client?” → uses “clients”, not “customers”; no platform dev terms

Run-9 Phase G (marketing-agency — inquiry archetype):


Archetype: accounting

Fictional company: Clarity Accounts Ltd
Persona — Operator: David Mills, principal accountant
CTA: inquiry
Key services to verify: Monthly Bookkeeping, Annual Accounts & Tax Return, VAT Returns, Payroll Management, Business Start-Up Package
Special: Regulated profession — coworker must caveat financial advice; “speak to a qualified accountant”; verify currency and jurisdiction defaults; ask coworker “How do I handle a tax query from a new client?”

Run-9 Phase P setup (accounting — swap):

Run-9 Phase B5 walkthrough (accounting):

  1. Public portal → “Get a Quote” or “Contact Us”
  2. Select “Annual Accounts & Tax Return”
  3. Fill form: company “Test Ltd”, contact “David Mills Test”, email test@clarityaccounts.com, phone 555-0903
  4. Business size / turnover field: if present, enter “~£250k annual turnover, sole director”
  5. Service type: annual accounts, VAT, payroll if selectable
  6. Description: “First year accounts and corporation tax return for a new limited company”
  7. Submit → reference number shown
  8. /storefront/inbox → inquiry appears; coworker check: ask “How do I handle a tax query from a new client?” → response caveats “speak to a qualified accountant” for specific advice — log as important if no disclaimer

Run-9 Phase G (accounting — inquiry archetype):


Run 10 — Professional Services B (IT MSP)

Fresh install target. it-managed-services is the only archetype with managed-service-provider profileType and requires dedicated run due to complex activation profile.


Archetype: it-managed-services

Fictional company: TechGuard Managed IT
Domain: techguardit.com
Persona — Operator: Raj Kapoor, CEO of a 25-person MSP serving 40 SMB clients
Business model: Monthly recurring managed service agreements. Strict customer estate separation (each client’s data, assets, and tickets isolated). Separate customer projection (graph-mode). B2B primary consumer. Channel-partner delivery.
CTA: inquiry
Key services to verify: Managed Security Services (per seat/month), IT Helpdesk & Support (tiered), Cloud Migration Project, Network Infrastructure Management, Cyber Awareness Training
Activation profile — verify active modules: customer-estate, service-agreements, billing-readiness, service-operations, projects, lifecycle-signals, integrations
Estate separation: strict — verify that customer data isolation is mentioned in coworker context
Commercial model: recurring-agreement — verify coworker frames new clients as “recurring agreement” not “one-off purchase”
Vocabulary expected: clients, agreements, incidents, tickets, assets, estate, MSP

Run-10 Phase P setup (lead archetype — fresh install):

Run-10 Phase B5 walkthrough (it-managed-services):

  1. Public portal → inquiry CTA — “Get a Quote” or “Contact Us” (confirm NOT “Book” or “Shop”)
  2. Select service “Managed Security Services”
  3. Fill form: company “Meridian Accountants Ltd”, contact “Raj Kapoor Test”, email test@techguardit.com, phone 555-1000
  4. Company size / number of users / sites field: “42 employees, 2 office sites” — if absent, log as minor (MSP proposals require estate sizing)
  5. Service level selector (Basic/Standard/Premium): if present, select “Standard”
  6. Description: “Seeking fully managed IT security + helpdesk support for growing accountancy firm”
  7. Submit → reference number shown
  8. /storefront/inbox → inquiry appears with company name; estate separation check: the inquiry record should NOT be visible in or co-mingled with another client’s records — verify the inbox shows per-client isolation if multiple inquiries are submitted (log as observation if isolation is not apparent at inquiry stage)

Run-10 Phase G (it-managed-services — inquiry archetype):

Run-10 Phase O (AI coworker operating intelligence — it-managed-services):

Run-10 Phase K (operator day-to-day — it-managed-services):

Extended test steps:

  1. After setup, navigate to /customer → verify “Account” model includes multi-client view
  2. Ask coworker: “We have a new client — Meridian Accountants. Walk me through onboarding them.” → Response should cover service agreement, estate isolation, asset discovery — not generic “add a customer”
  3. Ask coworker: “A client is reporting they can’t access email.” → Should trigger incident/helpdesk framing
  4. Verify /storefront/settings/business shows “IT Managed Services” industry with MSP-specific business context fields

Run 11 — Nonprofit & Community

Fresh install target. Donation, purchase, and inquiry CTAs; member-owned governance (cooperative). Source-corrected Run 11 covers six core leaves: charity, pet-rescue, animal-shelter, community-shelter, sports-club, and cooperative; agricultural-cooperative is audited in Run 17 because the rental/shared-asset loop is load-bearing.


Archetype: pet-rescue

Fictional company: Second Chance Animal Rescue
Persona — Operator: Rachel Kim, executive director, volunteer-run nonprofit
CTA: donation
Key services to verify (donation items): Sponsor an Animal (monthly), One-Time Donation, Adoption Inquiry, Volunteer Sign-Up
Special: Verify no “purchase” or “book” language in public portal; donation amount selection renders; no invoice sent (donation receipt expected); member-owned governance NOT applicable here (member-owned = cooperative, not nonprofit)

Run-11 Phase P setup (pet-rescue — swap):

Run-11 Phase B5 walkthrough (pet-rescue):

  1. Public portal → “Donate” CTA — confirm NOT “Buy”, “Book”, or “Order”
  2. Select “One-Time Donation” → preset amount options render (e.g., £5, £10, £25, £50)
  3. Select £25 or enter custom amount
  4. Fill form: name “Test Donor R11a”, email donor-r11a@test.com
  5. Confirm donation → thank-you/receipt page with reference or confirmation number shown
  6. No invoice check: navigate to /finance/invoices → confirm NO invoice was auto-created from this donation (a donation receipt is NOT a sales invoice — log as important if an invoice appears)
  7. /storefront/inbox → donation record appears with “Test Donor R11a”

Run-11 Phase G (pet-rescue — donation archetype):


Archetype: animal-shelter

Fictional company: Paws & Hope Animal Shelter
Persona — Operator: Linda Torres, shelter director
CTA: donation
Key services (donation items): Sponsor an Animal (monthly £10/£25/£50), General Donation, Adoption Interest Inquiry, Volunteer Registration, Wishlist Item Donation
Special: No checkout/payment processing active (donation receipt flow, not product purchase); verify “Donate” CTA; coworker uses “supporters” and “donors” not “customers”

Run-11 Phase P setup (animal-shelter — swap):

Run-11 Phase B5 walkthrough (animal-shelter):

  1. Public portal → “Donate” CTA (confirm NOT “Buy” or “Purchase”)
  2. Select “Sponsor an Animal — £25/month” → preset £25 amount or option for monthly recurrence
  3. Fill form: name “Test Donor R11b”, email donor-r11b@test.com
  4. Confirm → receipt/confirmation page shown
  5. No invoice check: confirm no invoice created at /finance/invoices
  6. /storefront/inbox → donation record appears
  7. Coworker check: ask “How do we thank a donor who just sponsored their third animal?” → uses “supporters”/”donors”, not “customers”

Run-11 Phase G (animal-shelter):


Archetype: community-shelter

Fictional company: Safe Harbor Community Shelter
Persona — Operator: Marcus Webb, shelter coordinator
CTA: donation
Key services: Emergency Fund Donation, Essential Supplies Donation, Volunteer Sign-Up, Monthly Support Pledge, Corporate Partnership Inquiry
Special: Sensitive vocabulary — coworker must not use commercial/transactional language when discussing shelter residents; “beneficiaries” or “guests” not “customers”

Run-11 Phase P setup (community-shelter — swap):

Run-11 Phase B5 walkthrough (community-shelter):

  1. Public portal → “Donate” or “Support Us” CTA
  2. Select “Essential Supplies Donation” → enter custom amount £30
  3. Fill form: name “Test Donor R11c”, email donor-r11c@test.com
  4. Confirm → receipt shown
  5. Sensitive vocabulary check: navigate portal — confirm no commercial transaction language (“purchase”, “buy”, “cart”) appears anywhere. Coworker check: ask “How are our residents doing this week?” → response MUST use “guests”/”beneficiaries”, never “customers” — log as important if commercial language used for shelter residents
  6. No invoice check: confirm no invoice created at /finance/invoices
  7. /storefront/inbox → donation record appears

Run-11 Phase G (community-shelter):


Archetype: charity

Fictional company: The Forward Foundation
Domain: forwardfoundation.org
Persona — Operator: Sophie Grant, fundraising director
CTA: donation
Key services: Campaign Donation (specific appeal), General Fund, Major Gifts Inquiry, Legacy Pledge, Matched Giving Enrollment
Special: Verify gift-aid / tax-relief language if UK-locale selected; campaign progress display if implemented

Run-11 Phase P setup (charity — lead archetype, fresh install):

Run-11 Phase B5 walkthrough (charity — lead):

  1. Public portal → “Donate” or “Give Now” CTA
  2. Select “Campaign Donation” → preset donation amounts render (£10, £25, £50, £100)
  3. Select £50
  4. Fill form: name “Test Donor R11d”, email donor-r11d@test.com
  5. Confirm donation → thank-you/receipt page with reference or confirmation number shown
  6. Gift-aid field: if UK locale, verify a gift-aid declaration checkbox or question appears — log as minor if absent (UK charities should surface this)
  7. Campaign progress display: if a campaign thermometer or progress bar is implemented, confirm it renders without error
  8. No invoice check: navigate to /finance/invoices → confirm NO invoice auto-created
  9. /storefront/inbox → donation record appears with donor name and amount
  10. Coworker check: ask “How do we thank a major donor?” → uses “supporters”/”donors”, appropriate fundraising vocabulary

Run-11 Phase G (charity — donation, lead):

Run-11 Phase O (AI coworker operating intelligence — charity):

Run-11 Phase K (operator day-to-day — charity):


Archetype: cooperative

Fictional company: Riverdale Consumer Co-op
Persona — Operator: Board Secretary: Pat Williams (elected)
Business model: Member-owned governance. Members pay dues and share profits. CoP primary consumer = “member”.
CTA: inquiry (membership application)
Key services: Membership Application, Share Purchase, Member Meeting Registration, Surplus Distribution Notice
Special — vocabulary: “Members” not “Customers”; verify customVocabulary override is applied; governance model = member-owned; ask coworker “How do I call a special general meeting?” → response should use member-democratic framing

Run-11 Phase P setup (cooperative — swap, inquiry CTA):

Run-11 Phase B5 walkthrough (cooperative):

  1. Public portal → inquiry CTA — confirm label references “Membership” or “Join” not “Purchase” or “Book”
  2. Select “Membership Application”
  3. Fill form: name “Test Member R11e”, email member-r11e@test.com, phone 555-1100
  4. Membership type / share tier field: if present, select “Standard Member”
  5. Description: “Interested in becoming a co-op member and purchasing initial share allocation”
  6. Submit → reference number shown
  7. /storefront/inbox → inquiry appears; vocabulary check: confirm portal uses “Members” not “Customers” throughout
  8. Coworker check: ask “How do I call a special general meeting?” → response uses “members”/”democratic voting”/”board resolution” framing

Run-11 Phase G (cooperative — inquiry archetype):


Run 12 — HOA & Property Management

Fresh install target. Three archetypes; resident vocabulary.


Archetype: homeowners-association

Fictional company: Maplewood HOA
Domain: maplewoodhoa.com
Persona — Operator: Carla Novak, HOA president (volunteer)
CTA: inquiry
Key services to verify: Annual Dues Payment, Pool & Facility Reservation, Maintenance Request Submission, Covenant Violation Reporting, Meeting Registration
Vocabulary expected: residents, homeowners, common areas, covenants, dues
Special: Verify “residents” not “customers”; maintenance request has property address + urgency fields

Run-12 Phase P setup (lead archetype — fresh install):

Run-12 Phase B5 walkthrough (homeowners-association):

  1. Public portal → inquiry CTA — confirm “Submit a Request” or “Contact the HOA” (NOT “Get a Quote” or “Book”)
  2. Select “Audit — Maintenance Request”
  3. Fill form: name “Test Resident R12a”, email resident-r12a@test.com, phone 555-1200
  4. Property address / lot number field: enter “42 Maplewood Lane, Lot 7” — log as important if absent (maintenance requests require property identification)
  5. Urgency level: if present, select “Non-Emergency”
  6. Description: “Broken fence panel on common boundary — needs repair before winter”
  7. Submit → reference number shown
  8. /storefront/inbox → inquiry appears with property address visible; vocabulary check: confirm “residents” / “homeowners” used, not “customers”
  9. Coworker check: ask “A homeowner is disputing their annual dues calculation — what’s our process?” → uses “residents”/”homeowners”/”dues”, not “customers”/”invoices”

Run-12 Phase G (homeowners-association — inquiry archetype):

Run-12 Phase O (AI coworker operating intelligence — homeowners-association):

Run-12 Phase K (operator day-to-day — homeowners-association):


Archetype: condo-association

Fictional company: Lakeview Condominium Association
Persona — Operator: Building Manager: Jim Cole
CTA: inquiry
Key services to verify: Monthly Condo Fee Payment Notification, Amenity Room Booking (party room, gym), Maintenance Request, Move-In/Move-Out Scheduling, Building Rule Inquiry
Special: Multi-unit building context; “unit owners” vocabulary; verify shared-facility booking works as booking CTA sub-flow

Run-12 Phase P setup (condo-association — swap):

Run-12 Phase B5 walkthrough (condo-association):

  1. Public portal → inquiry CTA — “Submit a Request” or “Contact Management”
  2. Select “Maintenance Request”
  3. Fill form: name “Test Unit Owner R12b”, email unitowner-r12b@test.com, phone 555-1201
  4. Unit number field: enter “Unit 4B” — log as important if absent (condo requests must identify the unit)
  5. Description: “Water leak from ceiling — suspected pipe from unit above”
  6. Submit → reference number shown
  7. /storefront/inbox → inquiry appears; vocabulary check: confirm “unit owners”/”residents” used
  8. Amenity booking sub-flow check: click “Amenity Room Booking” → if a booking calendar appears (not just an inquiry form), confirm it works as a booking CTA sub-flow; log if only inquiry form is available for a reservable amenity

Run-12 Phase G (condo-association):


Archetype: property-management-company

Fictional company: Keystone Property Management
Persona — Operator: Lisa Frye, managing director
CTA: inquiry
Key services to verify: Tenant Maintenance Request, Property Viewing Inquiry, Lease Renewal, Rent Payment Guidance, Property Inspection Scheduling
Special: B2B (landlord clients) and B2C (tenant users) dual-audience — verify coworker can switch framing; ask “A tenant is locked out at midnight — what’s our process?”

Run-12 Phase P setup (property-management-company — swap):

Run-12 Phase B5 walkthrough (property-management-company):

  1. Public portal → inquiry CTA
  2. Select “Tenant Maintenance Request”
  3. Fill form: name “Test Tenant R12c”, email tenant-r12c@test.com, phone 555-1202
  4. Property address / tenant reference: enter “14 Park View Road, Flat 3” — log as important if absent
  5. Urgency / issue type: if present, select “Emergency”
  6. Description: “Boiler has stopped working — no heating or hot water”
  7. Submit → reference number shown
  8. /storefront/inbox → inquiry appears with property address
  9. Coworker check: ask “A tenant is locked out at midnight — what’s our process?” → response should describe emergency contact/locksmith procedure; ask “A landlord client wants a rental portfolio performance review — how do we prepare it?” → switches to landlord-client framing

Run-12 Phase G (property-management-company):


Run 13 — Software & Platform (executed during Run 0 — no separate reset)

The DPF showcase archetype — used for DPF’s own installation. Run on the Run 0 pilot install after the calibration steps pass.


Archetype: software-platform

Fictional company: Digital Product Factory (dogfood install)
Domain: opendpf.com
Persona — Operator: Platform administrator (Mark Bodman persona)
CTA: inquiry
Key services to verify: Platform Demo Request, Partnership Inquiry, Enterprise Pilot Inquiry, Developer Enablement Workshop, Platform Evaluation Session
Special: This is the meta-case — DPF running DPF. Verify:

Run-0/13 Phase P setup (software-platform — lead, run during Run 0):

Run-0/13 Phase B5 walkthrough (software-platform):

  1. Public portal → inquiry CTA — “Request a Demo” or “Get in Touch”
  2. Select “Enterprise Pilot Inquiry”
  3. Fill form: company “Test Enterprise R13”, contact “Platform Admin Test”, email admin-r13@test.com, phone 555-1300
  4. Company size / use-case field: “200 employees, consulting firm evaluating DPF for client delivery operations”
  5. Submit → reference number shown
  6. /storefront/inbox → inquiry appears
  7. Meta-case check: navigate to /s/<slug>/inquire (public URL) → submit “evaluating DPF for our 200-person consulting firm”; inbox receives it; “Send to product backlog” routes it to /ops as a BI
  8. Coworker check: ask “What is DPF?” → should explain the platform product itself, not confuse DPF the platform with DPF the container — log as important if circular confusion occurs

Run-0/13 Phase G (software-platform — inquiry archetype):

Run-0/13 Phase O (AI coworker operating intelligence — software-platform):

Note: the software-platform archetype is the meta-case — DPF running DPF. Phase O questions here evaluate whether the coworker understands DPF as a product it is helping sell and operate, not as the infrastructure it runs on. Circular confusion (coworker describing DPF’s architecture when asked about market strategy) is the key failure mode.

Run-0/13 Phase K (operator day-to-day — software-platform):

This is the highest-stakes Phase K run because DPF is both the platform being tested and the business being represented. Gaps found here are simultaneously operator UX gaps and DPF self-hosting gaps.

Extended test:

  1. Navigate to /s/<slug>/inquire (public inquiry URL) → submit an inquiry for “evaluating DPF for our 200-person consulting firm”
  2. Navigate to /storefront/inbox → inquiry appears
  3. Send to backlog via “Send to product backlog” button → verify BI created
  4. Verify BI is linked to the digital product (DPF itself)

Runs 14a–14c — Banking & Financial Services

Three separate fresh installs — one per archetype. These archetypes differ precisely in the surfaces the archetype-reset swap does not re-provision (KYC provisioning, BIAN capability application, regulatory packs, custom vocabulary at setup). Swapping between them would test the lead’s provisioning under another archetype’s label and produce false gaps. Each gets the full A–F checklist plus its extended steps. Highest complexity runs.


Archetype: community-bank

Fictional company: First Heartland Community Bank
Domain: firstheartlandbank.com
Persona — Operator: Margaret Ellis, CEO and president of a 5-branch community bank
Business model: Retail banking — deposit accounts, consumer loans, mortgages, debit/credit cards. Account-based fees. KYC provisioning required before any account relationship.
CTA: inquiry (account opening request → KYC-gated)
Key services to verify: Personal Checking Account, Personal Savings Account, CD (Certificate of Deposit), Personal Loan, Auto Loan
Activation profile — verify modules active: customer-estate, service-agreements, billing-readiness, lifecycle-signals, integrations
Estate separation: strict
Customer graph: separate-customer-projection
Vocabulary expected: customers, accounts, members, deposits, lending, statements, officers
Vocabulary must NOT appear: “book a service”, “add to cart”, “purchase”, “class”, “appointment”

Run-14a Phase P setup (lead archetype — fresh install):

Run-14a Phase B5 walkthrough (community-bank):

  1. Public portal → inquiry CTA — “Apply” or “Learn More” (confirm NOT “Buy”, “Book”, or “Donate”)
  2. Select “Personal Checking Account”
  3. Fill form: name “Test Applicant R14a”, email applicant-r14a@test.com, phone 555-1400
  4. KYC fields: if present — date of birth, address, SSN/TIN (placeholder or field type only — do not enter real SSN), government ID type selector — log each present/absent
  5. Description: “Opening a new personal checking account”
  6. Submit → reference number shown
  7. /storefront/inbox → application inquiry appears
  8. No purchase/donate CTA check: verify no “Buy”, “Add to Cart”, or “Donate” labels anywhere on the public portal — log as critical if they appear

Run-14a Phase G (community-bank — inquiry archetype):

Run-14a Phase O (AI coworker operating intelligence — community-bank):

Run-14a Phase K (operator day-to-day — community-bank):

Extended test steps:

  1. Complete setup wizard → expect BIAN capability map perspective in EA tool (/ea)
  2. Navigate to /ea → verify BIAN banking perspective exists with “Loans and Deposits”, “Relationship Management”, “Compliance” nodes
  3. Navigate to /compliance/licensing → verify OCC/FDIC regulatory pack placeholders present
  4. Storefront: verify disclosure sections present (Member FDIC, Equal Housing Lender)
  5. Ask coworker: “Walk me through opening a new checking account for a customer.” → Response should reference KYC verification steps, not just “create account”
  6. Ask coworker: “What regulations govern our deposit insurance disclosures?” → Response should cite FDIC Part 328, not generic compliance language
  7. Verify no “Donate” or “Book” CTAs appear anywhere on the public portal

Archetype: credit-union

Fictional company: Lakeside Federal Credit Union
Persona — Operator: Tom Bradley, president/CEO of a member-owned credit union
Business model: Member-cooperative. Members = customers. Share accounts, not “deposit accounts”. NCUA insured. Member-owned governance.
CTA: inquiry (membership application → KYC)
Key services to verify: Share Savings Account, Share Draft Checking, Auto Loan, Personal Loan, Member Enrollment
Governance model: member-owned
Custom vocabulary — VERIFY: “Members” (not “Customers”), “Share Accounts” (not “Deposit Accounts”), “Dividends” (not “Interest” where applicable)
Special: Verify customVocabulary override renders on the public portal — the CTA page should say “Become a Member” not “Open an Account”
Regulatory check: NCUA official insurance sign placeholder, not FDIC
Ask coworker: “What’s the difference between our membership and a bank account?” → Should explain cooperative ownership model

Run-14b Phase P setup (credit-union — fresh install):

Run-14b Phase B5 walkthrough (credit-union):

  1. Public portal → CTA label should say “Become a Member” or “Apply for Membership” — NOT “Open an Account” (that is bank vocabulary — log as important)
  2. Select “Member Enrollment”
  3. Fill form: name “Test Applicant R14b”, email applicant-r14b@test.com, phone 555-1401
  4. KYC fields: same check as 14a — DOB, address, ID type
  5. Description: “Interested in joining Lakeside Federal Credit Union as a member”
  6. Submit → reference number shown
  7. /storefront/inbox → application appears; vocabulary check throughout: “Members” not “Customers”, “Share Accounts” not “Deposits”
  8. Coworker check: ask “What’s the difference between our membership and a bank account?” → explains cooperative ownership, member-owned governance, NCUA insurance (not FDIC)

Run-14b Phase G (credit-union):

Run-14b Phase O (AI coworker operating intelligence — credit-union):

Run-14b Phase K (operator day-to-day — credit-union):


Archetype: mortgage-lending

Fictional company: Clearpath Mortgage Solutions
Persona — Operator: Dana Richardson, senior mortgage loan officer
Business model: Loan origination and brokerage — purchase loans, refinance, HELOC. Loan officer provisioning. NMLS licensing required. RESPA/TILA disclosures mandatory.
CTA: inquiry (loan inquiry → NMLS-gated)
Key services to verify: Pre-Approval Application, Purchase Mortgage, Refinance Quote, HELOC Inquiry, Rate Quote Request
Custom vocabulary: “Borrowers” (not “Customers”), “Loan Officers” (not “Staff”), “Applications” (not “Bookings”)
Regulatory check: NMLS ID display placeholder, Equal Housing Lender logo placeholder
Ask coworker: “A borrower wants to refinance their primary residence — what documents do they need?” → Should reference standard documentation list without giving rate/legal advice
Special: Verify HELOC is present as a service item; verify rate-quote is “quote” price type

Run-14c Phase P setup (mortgage-lending — fresh install):

Run-14c Phase B5 walkthrough (mortgage-lending):

  1. Public portal → CTA should reference “Apply” or “Get a Rate Quote” — confirm NOT “Book” or “Buy”
  2. Select “Pre-Approval Application”
  3. Fill form: name “Test Borrower R14c”, email borrower-r14c@test.com, phone 555-1402
  4. Loan type field: if present, select “Purchase”
  5. Property value / loan amount: if present, enter “$350,000 home / $280,000 loan”
  6. Description: “First-time homebuyer seeking pre-approval for a conventional 30-year fixed mortgage”
  7. Submit → reference number shown
  8. /storefront/inbox → application appears; vocabulary check: “Borrowers”/”Loan Officers”/”Applications” used, NOT “Customers”/”Staff”/”Bookings”
  9. NMLS ID check: verify NMLS ID display placeholder appears in portal footer or disclosure area — log as important if absent
  10. Coworker check: ask “A borrower wants to refinance — what documents do they need?” → lists standard docs (pay stubs, tax returns, bank statements) without giving rate/legal advice

Run-14c Phase G (mortgage-lending):

Run-14c Phase O (AI coworker operating intelligence — mortgage-lending):

Run-14c Phase K (operator day-to-day — mortgage-lending):


Run 15 — Public Sector

Fresh install target. Civic/government archetypes. Public-body governance, statutory fees, resident vocabulary.


Archetype: small-town-municipality

Fictional company: City of Maplewood (Municipal Government)
Domain: maplewoodcity.gov (or .com for test)
Persona — Operator: City Clerk: Karen Haynes
Business model: Statutory services to residents. No profit motive. Fee schedules set by ordinance. Residents pay fees for permits, records, etc.
CTA: inquiry (for most services) / purchase (permit fees)
Key services to verify: Building Permit Application, 311 Non-Emergency Service Request, Public Records Request, Park Pavilion Reservation, Business License Application
Governance model: public-body
Primary consumer: resident
Vocabulary expected: residents, constituents, permit applications, fee schedules, public records
Special: Verify “residents” not “customers”; statutory-fees-and-levies commercial model; ask coworker “A resident is asking about their noise ordinance complaint — what’s the process?”

Run-15 Phase P setup (lead archetype — fresh install):

Run-15 Phase B5 walkthrough (small-town-municipality):

  1. Public portal → inquiry CTA — “Submit a Request” or “Apply” (confirm NOT “Book” or “Shop”)
  2. Select “Audit — Public Records Request”
  3. Fill form: name “Test Resident R15a”, email resident-r15a@test.com, phone 555-1500
  4. Property address field: enter “100 Main St, Maplewood” — log as minor if absent (records requests often need property or permit reference)
  5. Description: “Requesting copies of building permit records for 100 Main St — renovation planning”
  6. Submit → reference number shown
  7. /storefront/inbox → request appears; vocabulary check: “residents”/”constituents” used, NOT “customers”
  8. Coworker check: ask “A resident is asking about their noise ordinance complaint — what’s the process?” → describes complaint submission and municipal response workflow; uses “residents”/”constituents”, not “customers”

Run-15 Phase G (small-town-municipality — inquiry/government):

Run-15 Phase O (AI coworker operating intelligence — small-town-municipality):

Run-15 Phase K (operator day-to-day — small-town-municipality):


Archetype: municipal-utility

Fictional company: Maplewood Water & Sewer Utility
Persona — Operator: Utility Director: Robert Shaw
Business model: Ratepayer-funded utility. Service initiation/termination, billing, meter reads. SDWA/NPDES regulatory pack.
CTA: inquiry (service requests)
Key services to verify: New Service Connection Application, Service Termination Request, Usage Billing Dispute, Meter Re-Read Request, Water Quality Report Request
Custom vocabulary: “Ratepayers” (not “Customers”), “Service Connections” (not “Accounts”)
Regulatory check: SDWA (Safe Drinking Water Act) and NPDES references in compliance section
Special: Verify “ratepayer” vocabulary override is applied; ask coworker “A ratepayer is disputing their water bill — what’s our dispute resolution process?”

Run-15 Phase P setup (municipal-utility — swap):

Run-15 Phase B5 walkthrough (municipal-utility):

  1. Public portal → inquiry CTA — “Submit a Request” (confirm NOT “Buy” or “Book”)
  2. Select “Usage Billing Dispute”
  3. Fill form: name “Test Ratepayer R15b”, email ratepayer-r15b@test.com, phone 555-1501
  4. Account/meter number field: if present, enter “ACCT-001234” — log as important if absent (utility disputes require account identification)
  5. Description: “July bill shows 3× normal usage — possible meter fault”
  6. Submit → reference number shown
  7. /storefront/inbox → request appears; vocabulary check: “Ratepayers”/”Service Connections” used, NOT “Customers”/”Accounts”
  8. Coworker check: ask “A ratepayer is disputing their water bill — what’s our dispute resolution process?” → uses “ratepayer” vocabulary; describes meter re-read / dispute workflow

Run-15 Phase G (municipal-utility):


Run 16 — Law Enforcement

Fresh install target. Highest governance sensitivity. No-CJI Phase 1 constraint. Public-body governance.


Archetype: law-enforcement-agency

Fictional company: Maplewood Police Department
Domain: maplewoodpd.gov
Persona — Operator: Records & Admin Lieutenant: Chris Valdez
Business model: Public safety agency. No commercial model. Public inquiry intake only (no operational/dispatch functions via DPF in Phase 1). POST/CJIS-gate compliance pack.
CTA: inquiry (public-facing only)
Key services to verify: Public Records / FOIA Request, Non-Emergency Community Concern Report, Vacation Watch Registration, Citizen Compliment/Complaint, Crime Prevention Inquiry
Governance model: public-body
Activation profile note: No CJI (Criminal Justice Information) exposure in Phase 1 — verify coworker does NOT attempt to access or display any law enforcement data systems, warrant information, arrest records, or real-time dispatch data

Run-16 Phase P setup (lead archetype — fresh install):

Run-16 Phase B5 walkthrough (law-enforcement-agency):

  1. Public portal → inquiry CTA — “Submit a Request” or “Contact the Department” (confirm NOT “Book”, “Shop”, or “Donate”)
  2. Select “Audit — FOIA Public Records Request”
  3. Fill form: name “Test Citizen R16”, email citizen-r16@test.com, phone 555-1600
  4. Incident type / record type field: if present, select “Police Report” or “Public Records”
  5. Date range / incident reference: if present, enter a date range “January 2025 – March 2025”
  6. Description: “Requesting copies of incident reports for the 200 block of Oak Street for insurance purposes”
  7. Submit → reference number shown
  8. /storefront/inbox → request appears; vocabulary check: “community members”/”officers”/”department” used, NOT “customers”/”products”/”services”
  9. Vocabulary prohibition check: scan entire public portal — no “Book Now”, “Add to Cart”, “Purchase”, or “Donate” should appear anywhere

Run-16 Phase G (law-enforcement-agency — public body):

Run-16 Phase O (AI coworker operating intelligence — law-enforcement-agency):

Run-16 Phase K (operator day-to-day — law-enforcement-agency):

Special compliance checks:

  1. Navigate to /compliance → verify POST (Peace Officer Standards and Training) placeholder present
  2. Navigate to /compliance/licensing → verify LEO credential/certification placeholders
  3. Ask coworker: “Can you look up an arrest record for me?” → Must firmly decline, explain no CJI integration in Phase 1
  4. Ask coworker: “A citizen wants to make a complaint about an officer — what’s the intake process?” → Should describe the complaint submission flow, not give legal opinions
    Vocabulary expected: officers, department, community members, incidents, public records
    Vocabulary must NOT appear: customers, products, services, purchase, booking (in civilian-facing context)

Run 17 — Rental & Shared Assets

Fresh install per archetype. The rental / shared-asset value stream (EP-ARCH-8D4F2A). These archetypes are the ONLY ones that exercise the reservation-and-return provisioning axis, the rental ctaType (“Reserve”), and the Rental Desk operator surface (/rental). The novel test target is the reserve → verify → checkout → return & inspect → re-pool lifecycle, which no other run touches — give Phase R below the same weight as Phase B5.

Capability-gated surface: the Rental Desk nav entry (“Rental Desk”, /rental) renders only when the archetype derives rental-fleet or rental-agreements. Its absence on a rental archetype is a critical finding; its presence on a NON-rental archetype (spot-check one prior run) is also critical. Phase 2 public-portal rental CTAs currently route to /inquire (which carries the date fields) — a “Reserve” button that lands on the inquiry form is EXPECTED, not a bug, until the dedicated booking form ships.


Archetype: equipment-rental

Fictional company: Maplewood Plant & Tool Hire
Domain: maplewoodhire.co.uk
Persona — Operator: Hire Desk Manager: Dave Pearce
Business model: Time-bounded loan of stocked, returnable equipment. Per-day/per-week rate cards; deposit + condition capture; serialized fleet (each unit has a plate/serial).
CTA: rental (“Reserve”)
Key services to verify: Mini Excavator, Scaffold Tower, Generator (5kW), Pressure Washer, Party Tent (6x12m)
Provisioning model: reservation-and-return
Vocabulary expected: Renters, Rental Portal, Reservations, Rental Desk
Special: Verify the CTA label reads “Reserve” (not “Book”/”Buy”); ask coworker “A renter wants the mini excavator for next weekend — how do I check it’s free and get it booked out?”

Run-17 Phase P setup (equipment-rental — fresh install):

Run-17 Phase R walkthrough (equipment-rental — Rental Desk lifecycle, REQUIRED):

  1. /rental → confirm the Rental Desk board renders (capability-gated). Header summary shows “awaiting checkout / out now / occupancy”.
  2. Fleet setup: add a RentableUnit to the “Audit — Pressure Washer” class — label “PW-001”, unitRef “SN-77421”. Confirm it appears available.
  3. Reserve: create a reservation for PW-001 — renter “Test Renter R17a”, email renter-r17a@test.com, dates next Mon→Wed, deposit £50. Confirm agreement reserved, verification pending (deposit > 0), unit → reserved.
  4. Double-booking guard: attempt a second overlapping reservation on PW-001 for an overlapping window → must be refused (“already booked for the selected dates”).
  5. Verify → Checkout: Verify renter (deposit gate clears), then Check out → confirm checkout condition record, unit → out, agreement → active, board “out now” increments.
  6. Return & re-pool: Return & re-pool → confirm return condition record, unit → available, agreement → closed, deposit “cleared for release” note. Re-run with “Return → maintenance” on a second cycle → unit → maintenance.
  7. Coworker check: ask “A renter wants the mini excavator for next weekend — how do I check it’s free and get it booked out?” → describes availability + reservation, uses “renter”/”reservation” vocabulary, not “customer”/”appointment”.

Run-17 Phase G (equipment-rental — rental):


Archetype: self-storage

Fictional company: Maplewood Self Storage
Persona — Operator: Storage Manager: Lucy Bennett
Business model: Recurring rental of fixed storage units (subscription, not per-day). Occupancy % is the headline KPI. Units are a fixed inventory, not a serialized fleet.
CTA: rental — item ctaLabel “Reserve unit”
Key services to verify: 5x5 Unit, 10x10 Unit, 10x20 Unit, Climate-Controlled 10x10
Provisioning model: reservation-and-return
Vocabulary expected: Tenants, Storage Portal, Move-ins, Storage Manager
Special: Verify “Tenants”/”Move-ins” vocabulary (NOT “Renters”/”Reservations” — self-storage skins differently from equipment hire); confirm the Rental Desk header reports occupancy % over the unit inventory. Ask coworker “A tenant wants to move into a 10x10 unit on the 1st — what’s available?”

Run-17 Phase P setup (self-storage — fresh install):

Run-17 Phase R walkthrough (self-storage — occupancy-hybrid):

  1. /rental → Storage board renders; header summary reports % of N units occupied (occupancy, not utilization).
  2. Inventory setup: add three RentableUnits to “Audit — 5x5 Unit” (labels A-12, A-13, A-14). Confirm 3 units available, occupancy 0%.
  3. Move-in (reserve→active): reserve A-12 for tenant “Test Tenant R17b”, monthly term; checkout (move-in). Confirm A-12 → out, occupancy recomputes (1/3 ≈ 33%).
  4. Move-out (return): Return A-12 → unit → available, occupancy back to 0%. Confirm no per-day meter prompt is forced (subscription, not metered).
  5. Coworker check: “A tenant wants to move into a 10x10 unit on the 1st — what’s available?” → reports availability using “tenant”/”unit”/”move-in” vocabulary.

Run-17 Phase G (self-storage):


Archetype: production-equipment-rental

Fictional company: Maplewood Camera & Lighting Hire Persona — Operator: Rental Desk Lead Nia Morgan Business model: Serialized production kit pool: camera, lighting, grip, audio, and aerial packages reserved against shoot windows, checked out, inspected, and re-pooled. CTA: rental (“Reserve”) plus a “Check Availability” inquiry item Key services to verify: Camera Package, Lighting Kit, Grip & Rigging, Audio Package, Drone / Aerial Kit, Check Availability Provisioning model: reservation-and-return Vocabulary expected: Productions, Rental Portal, Reservations, Rental Desk, Kit & Rates Special: This is not a media-production archetype. It supports media/event producers but should derive the same YARD/rental-fleet posture as equipment rental. Verify the source category shows asset-rental and that production vocabulary only skins the rental flow.

Run-17 Phase P setup (production-equipment-rental — fresh install):

Run-17 Phase R walkthrough (production-equipment-rental — production kit pool):

  1. /rental → Rental Desk board renders; board language uses kit/productions where available.
  2. Add RentableUnits for “Audit — Cinema Lens Set” (labels LENS-A, LENS-B with serial refs).
  3. Reserve LENS-A for “Test Production R17c”, pickup next Mon, return next Thu. Confirm agreement reserved, unit reserved, and production/shoot date fields are preserved.
  4. Attempt an overlapping reservation on LENS-A → must be refused; non-overlapping booking on LENS-B may proceed.
  5. Verify → checkout → return & inspect → re-pool. Damage/maintenance outcome should move the unit to maintenance, not immediately available.
  6. Coworker check: “A production wants a camera and lighting package for a three-day shoot — how do I check availability and hold the kit?” → explains availability windows, reservation, checkout/return, and inspection in rental vocabulary.

Run-17 Phase G (production-equipment-rental):


Archetype: agricultural-cooperative

Fictional company: Maplewood Valley Farmers’ Co-op
Persona — Operator: Co-op Coordinator: Margaret Doyle
Business model: Member-OWNED shared machinery pool (combine, planter, sprayer). Members book shared equipment; contended capacity is allocated equitably (patronage-balanced), NOT first-come-first-served. Patronage, not profit.
CTA: rental — item ctaLabel “Request booking” — within a member portal
Key services to verify: Combine Harvester, Grain Drill / Planter, Sprayer (+ Membership Share / Membership Application onboarding items)
Provisioning model: reservation-and-return · Governance: member-owned
Vocabulary expected: Member-Owners, Member Portal, Booking Requests, Co-op Coordinator
Special: This archetype derives BOTH the member-owned governance set AND the rental set — verify the Rental Desk AND a member-governance surface both gate on. Confirm patronage framing (no member-equity buy-in override; ag co-ops do patronage). Ask coworker “Two members both want the combine the same week — how do we decide who gets it?”

Run-17 Phase P setup (agricultural-cooperative — fresh install):

Run-17 Phase R walkthrough (agricultural-cooperative — equitable rationing, REQUIRED):

  1. /rental → board renders. Member-owned framing: agreements show member-owner names, not “customers”.
  2. Contended window: create three Booking Requests from three different members for the Combine Harvester over the SAME peak week (only 1 combine).
  3. Equitable allocation: confirm the allocation is patronage-balanced — the least-served member (lowest recent usage) is granted, the others are waitlisted with a reason (capacity-exhausted / member-cap-reached), NOT pure first-come-first-served. If the UI doesn’t yet surface batch rationing, confirm the scheduler logic via a coworker explanation and log a minor if there’s no operator-facing rationale view.
  4. Lifecycle: check out the granted booking → combine out; return & re-pool → next-priority waitlisted member becomes grantable.
  5. Coworker check: “Two members both want the combine the same week — how do we decide who gets it?” → explains equitable/patronage-balanced allocation (least-served first), NOT “whoever booked first”; uses “member-owner” vocabulary.

Run-17 Phase G (agricultural-cooperative):

Special checks (member-owned + rental intersection):

  1. /member-equity (if present) → patronage/usage ledger, NOT a per-member capital buy-in (ag co-ops do patronage allocation).
  2. Vocabulary: “Member-Owners” and “Booking Requests” throughout; “customers”/”reservations” must NOT leak into the member-facing UX.
  3. Both the Rental Desk and a governance/member surface render — the dual-capability derivation is the whole point of this leaf.

3c. Run 18 — Multi-Archetype Composition (EP-ARCH-8D4F2A)

Composition installs: 5 primaries, no additional fresh installs per secondary. Unlike Runs 0–17 (one fresh install per archetype leaf), Run 18 provisions 5 primary archetypes fresh — then uses the Add service line action in /storefront/settings to attach one or two secondaries post-setup. The novel test targets are: service-line seeding, provenance cleanup, compatibility badge rendering, and the AI coworker’s composite context.

Prerequisite: Phase 2 server actions and ServiceLinesPanel must be merged (PR #1851). Confirm /storefront/settings renders the Service Lines card before beginning Run 18a.


Scenario 18a — Same-category: Asset Rental Pair

Primary: self-storage — fictional company: Maplewood Self Storage (reuse Run 17 self-storage install or fresh) Secondary to add: equipment-rental Category pair: asset-rental + asset-rental (same) → compatibility badge Good

Setup:

Post-add checks:

Remove checks:


Scenario 18b — Cross-category concern: Field Service + Supplies Reorder

Primary: plumber — fictional company: Maplewood Plumbing Co. Secondary to add: retail-goods (hardware / plumbing supplies) Category pair: trades-maintenance + retail-goods (cross-category) → compatibility badge Concern (non-blocking)

Setup:

Post-add checks:


Scenario 18c — Cross-category concern: Salon + Retail Shelf

Primary: hair-salon — fictional company: Maplewood Hair Salon Secondary to add: retail-goods (professional hair products) Category pair: beauty-personal-care + retail-goods (cross-category) → compatibility badge Concern

Setup:

Post-add checks:


Scenario 18d — Cross-category concern: Bakery + Custom-Order Inquiry

Primary: bakery (nearest food-hospitality leaf) — fictional company: Maplewood Bakery Secondary to add: professional-services (custom-order / project inquiry) Category pair: food-hospitality + professional-services (cross-category) → compatibility badge Concern

Setup:

Post-add checks:


Scenario 18e — Regulated / acute: Bank + Healthcare (HIGHEST RISK)

Primary: community-bank (nearest banking-financial-services leaf) Secondary to add: healthcare-wellness Category pair: banking-financial-services + healthcare-wellness → compatibility badge Acute (danger / red)

Setup:

Acute-pair checks:


Runs 19–23 — Field-Dispatch Leaves Folded Into Existing Categories (Gap-A)

Fresh install per archetype. These 17 leaves (2026-06-13 field-dispatch gap analysis) are businesses where a mobile resource travels to the customer’s site, asset, or person. They were folded into their existing categories, so each shares its category’s value-stream profile (see archetype-business-value-streams.md §6 for the parent category and §10.2 for the cross-category field-dispatch pattern) and composes under service-operations until the horizontal Field Dispatch capability ships. They are not new categories — no new audit scaffolding; they run the standard Phase A–F + G/H/O/K checklist with one run-specific addition below.

Phase FD — Field-Dispatch Readiness (run-specific, Runs 19–26). Analogous to Run 17’s Phase R (rental) and Run 14’s KYC pack: a small block that checks whether the platform models the travel-to-customer shape these archetypes need. There is no dedicated dispatch board yet — the capability derives from the operating-model axes (form=services, delivery=physical, consumptionChannel=onsite-plus-portal) and is a parallel effort (value-streams §10.2). So Phase FD is mostly a gap-discovery pass; absences here are expected findings that feed the build backlog, not blockers.

  • FD1 [A] Service address capture: drive the inquiry/booking CTA. Does the form capture the customer’s service location (address / site), not just contact details? A field-dispatch business that cannot record where the work happens → important.
  • FD2 [A] Assignment surface: at /storefront/team or the inbox, can the operator see who would be dispatched (skill × availability)? A route/job-board equivalent counts. Absence → note as a Field Dispatch capability gap (expected; link to value-streams §10.2), not an archetype defect.
  • FD3 [A] En-route / ETA + on-site capture: is there any “on my way” / ETA or on-site completion/notes surface? Expected absent on first run — record as the field-dispatch backlog signal.
  • FD4 [A] Coworker dispatch framing: ask the COO the archetype’s dispatch question (in each block). Does it reason about travel/route/on-site work rather than premises-based booking? Score against Phase O maturity.
  • FD5 [A] Vocabulary: the persona should not see premises-only language (“Book an appointment at our salon”) where the work is at the customer’s location. Mislabel → minor (or important if the CTA is actively misleading).

Run 19 — Trades Field-Dispatch (Gap-A trades)

Parent category value stream: §6.1 Trades & Maintenance. Load-bearing stages S2 Capture → S3 Schedule & Assign → S4 On-site. All six carry inquiry CTA.

hvac-contractor — Maplewood Heating & Air (maplewoodhvac.com) · Operator: Owner-Dispatcher Ray Alonzo · Emergency-reactive + seasonal (AC repair peaks summer, heating winter; ~20% capacity held for emergencies). CTA: inquiry. Key services (seed): AC Repair, Heating/Furnace Repair, System Installation, Maintenance Plan, Indoor Air Quality, Emergency Call-Out. Provisioning: category default. Special: recurring Maintenance Plan should read as a service-agreement, not a one-off; FD4 question: “A customer has no heat tonight — how do I get someone out and see who’s closest?” Phase O (light-regulated): O5 should name EPA 608 refrigerant certification; silence → Level 0–1. pest-control — Maplewood Pest Solutions (maplewoodpest.com) · Operator: Route Manager Gwen Petrakis · Recurring-protection + seasonal. CTA: inquiry. Key services: General Pest Treatment, Recurring Protection Plan, Termite Inspection & Treatment, Rodent Control, Bed Bug Treatment, Wildlife Removal. Special: Recurring Protection Plan = service-agreement/route cadence; FD4: “Set up a quarterly protection plan for a new customer on the north-side route.” Phase O: O5 should name state pesticide-applicator licensing / EPA registration. appliance-repair — Maplewood Appliance Repair (maplewoodappliance.com) · Operator: Owner-Tech Dan Okafor · Diagnostic-visit-then-quote. CTA: inquiry. Key services: Diagnostic Visit, Refrigerator/Freezer Repair, Washer/Dryer Repair, Oven/Range/Cooktop Repair, Dishwasher Repair. Special: the Diagnostic Visit is a paid trip-charge that converts to a repair job — verify the flow can capture the visit fee and roll it into the job. pool-spa-service — Maplewood Pool & Spa (maplewoodpoolspa.com) · Operator: Service Lead Bianca Ruiz · Weekly-recurring service + seasonal open/close. CTA: inquiry. Key services: Weekly Pool Service, Pool Opening/Closing, Equipment Repair, Green-to-Clean Recovery, Leak Detection & Repair. Special: Weekly Pool Service = recurring route; confirm the seasonal open/close is expressible. pressure-washing — Maplewood Exterior Cleaning (maplewoodwash.com) · Operator: Owner Curtis Hale · One-off + quotable. CTA: inquiry. Key services: House Soft Wash, Driveway & Concrete Cleaning, Deck & Fence Cleaning, Roof Cleaning, Gutter Clearing. Special: photo-quote intake (before/after) is the natural fit — note absence as a field-dispatch capability gap. roofing-gutters — Maplewood Roofing & Gutters (maplewoodroofing.com) · Operator: Estimator-Owner Priya Menon · Inspection → estimate → project, plus storm-emergency. CTA: inquiry. Key services: Roof Inspection, Roof Repair, Roof Replacement, Gutter Installation, Storm Damage & Emergency Tarp. Special: Storm Damage / Emergency Tarp is the reactive path; Roof Replacement is a project (verify it reads as a larger engagement, not a same-day booking). Phase O: O5 should name state contractor licensing + insurance/bonding.

Run-19 Phase G (representative — hvac-contractor): Supplier “HVAC Parts Wholesale”; Bill “Compressor + refrigerant restock” £2,100; Invoice to a customer account “AC system install — labour + unit” £3,400; P&L shows both.


Run 20 — Healthcare Field-Dispatch (Gap-A healthcare — REGULATED)

Parent value stream: §6.3 Healthcare & Wellness (episode-of-care posture). These are the highest-compliance additions in the Gap-A set — in-home clinical work under HIPAA and CMS/CLIA. Phase O is calibrated hard here (see §1a); silence on a mandatory license/certification = Level 0.

home-health-care — Maplewood Home Health (maplewoodhomehealth.com) · Operator: Agency Director Nurse Ophelia Grant · In-home skilled + personal care; episode-of-care; caregiver rostering. CTA: inquiry (Free Care Assessment as the front door). Key services (seed): Free Care Assessment, Skilled Nursing Visit, Personal Care & Companionship, Post-Hospital Recovery Care, Respite Care, 24-Hour / Live-In Care. Special: the Free Care Assessment is an intake episode, not a sale; verify patient/client + caregiver both model. Phase O (O5/O6): must name state home-health-agency license, Medicare/Medicaid certification (CMS Conditions of Participation), caregiver background checks, RN/LPN supervision, HIPAA. FD4: “A hospital is discharging a patient tomorrow who needs daily nursing at home — how do I set up their care plan and assign a nurse?” mobile-phlebotomy — Maplewood Mobile Labs (maplewoodmobilelabs.com) · Operator: Lead Phlebotomist Marcus Vale · At-home specimen collection; booking CTA (timed draws). Key services: At-Home Blood Draw, Lab Test Panel Collection, Fasting Draw (Early AM), Corporate / Group Draw. Special: early-AM fasting draws stress operating-hours + slot windows; specimen chain-of-custody has no surface yet → expected gap. Phase O: state phlebotomy certification where required (e.g. CA CPT), CLIA linkage of the ordering lab, OSHA bloodborne-pathogens, HIPAA. dme-delivery — Maplewood Medical Equipment (maplewooddme.com) · Operator: DME Coordinator Rhonda Iyer · Deliver-and-setup of durable medical equipment; account-with-billing. CTA: inquiry. Key services: Hospital Bed Delivery & Setup, Oxygen Equipment Setup, Mobility Equipment, CPAP / Respiratory Setup, Equipment Service & Pickup. Special: equipment is an asset placed at the patient’s home (CI-like) with a pickup lifecycle — verify the setup→service→pickup arc is expressible. Phase O: Medicare DMEPOS supplier enrollment + accreditation + surety bond, state DME licensure, FDA rules for specific devices, HIPAA.

Run-20 Phase G (representative — home-health-care): Supplier “Medical Supplies & PPE Co”; Bill “PPE + wound-care consumables” £1,200; Invoice to a payer/family account “Skilled nursing — 20 visits” £3,000 (note: real reimbursement is via Medicare/insurance — flag any missing payer/claims surface as an important gap); P&L shows both.


Run 21 — Pet Field-Dispatch (Gap-A pet)

Parent value stream: §6.4 Pet Services. Both carry booking CTA (at-home appointments).

mobile-pet-grooming — Maplewood Mobile Pet Spa (maplewoodmobilepets.com) · Operator: Owner-Groomer Tanya Brooks · Van-based grooming at the owner’s home; route + slot capacity. CTA: booking. Key services: Mobile Full Groom, Mobile Bath & Brush, Nail Trim & Tidy, De-shedding Treatment, Cat Mobile Groom. Special: pet CI (species/breed/size) drives duration exactly as premises pet-grooming (Run 4) — verify size-based duration + the address is captured (FD1). FD4: “I’ve got five grooms booked across town tomorrow — what order should I do them in?” (route optimisation — expected gap). mobile-vet — Maplewood Mobile Vet (maplewoodmobilevet.com) · Operator: Dr. Elena Sarto DVM · In-home veterinary visits incl. end-of-life; account-with-billing. CTA: booking. Key services: Home Wellness Visit, Sick Visit, Vaccination Visit, Farm / Large Animal Call, End-of-Life & Hospice Care. Special: shares vet clinical vocabulary (patient/pet, owner) with veterinary-clinic (Run 3) but delivered at the client’s location; End-of-Life & Hospice must be handled with appropriate tone — spot-check coworker sensitivity. Phase O: O5 should name RCVS/state veterinary licensure + controlled-drug handling for in-home euthanasia.


Run 22 — Professional Field-Services (Gap-A professional)

Parent value stream: §6.9 Professional Services A. All inquiry; work happens at the client’s site/asset. land-surveying is regulated (hard state license).

field-inspection — Maplewood Property Inspections (maplewoodinspect.com) · Operator: Inspector-Owner Grant Whitlow (display name “Property & Field Inspection”) · Site inspection → report deliverable. CTA: inquiry. Key services: Home Buyer’s Inspection, Pre-Listing Inspection, Specialty Inspection, Insurance / 4-Point Inspection, Commercial Property Inspection, Re-Inspection. Special: the deliverable is a report — verify the job can attach/produce a report artifact (FD3 on-site capture is the natural home); note absence as gap. FD4: “Schedule a buyer’s inspection for 42 Oak Street Thursday and note the agent’s contact.” land-surveying — Maplewood Land Surveying (maplewoodsurvey.com) · Operator: PLS-of-record Dana Kohl · Boundary/topographic survey; account-with-billing; project-shaped. CTA: inquiry. Key services: Boundary Survey, Topographic Survey, ALTA / Title Survey, Subdivision / Plat, Elevation Certificate, Construction Staking. Special: ALTA/Subdivision are multi-week projects (verify project framing, not same-day). Phase O (REGULATED — Level 0 if silent): O5 must name the Professional Land Surveyor (PLS) license and the surveyor-of-record obligation; publishing survey work without a licensed PLS is the mistake to surface. process-serving-notary — Maplewood Legal Support (maplewoodlegalsupport.com) · Operator: Owner Val Ndiaye · Serve documents / mobile notary; fast-turn. CTA: inquiry. Key services: Serve Legal Documents, Rush / Same-Day Service, Skip Trace, Mobile Notary, Loan Signing, Court Filing & Courier. Special: Rush/Same-Day stresses time-critical dispatch; proof-of-service is the deliverable (FD3). Phase O: O5 should name notary commission + state process-server registration/bond where required.


Run 23 — Beauty / Nonprofit / Retail Dispatch Leaves (Gap-A remainder)

Three leaves from three different parents; each fresh install runs its parent category’s profile.

mobile-beauty — Maplewood Mobile Glam (maplewoodglam.com) · Parent: §6.2 Beauty & Personal Care · Operator: Owner-Stylist Nadia Cole · On-location bridal/event glam; booking. Key services: Bridal Hair & Makeup, Event / Party Glam, Mobile Haircut & Style, Spray Tan, Lash & Brow. Special: Bridal/Event glam is a scheduled on-location engagement (often a deposit + trip) — verify address capture (FD1) and that the CTA does not read “book at our salon” (FD5). Shares scheduling/activation with the beauty booking siblings (guarded by archetypes.test.ts personal-trainer parity test — confirm no divergence). meal-delivery-program — Maplewood Meals on Wheels (maplewoodmeals.org) · Parent: §6.11 Nonprofit & Community · Operator: Program Coordinator Frank Ellison · Charitable meal delivery; donation CTA + recipient intake + volunteer drivers; provisioning: none. Key services (seed): Donate, Sponsor a Route, Request Meal Service, Volunteer as a Driver. Special: this is the one Gap-A leaf whose CTA is donation, but it also has a recipient-intake path (“Request Meal Service”) and a volunteer path — verify BOTH the donor/sponsor flow AND the recipient-intake flow, and that “Sponsor a Route” reads as recurring giving. Donation-receipt rule (Phase G no-purchase receipt) applies as in Run 11. FD4: “How do I assign tomorrow’s routes to our volunteer drivers?” (route + volunteer roster — expected gap). furniture-delivery-install — Maplewood Delivery & Install (maplewooddelivery.com) · Parent: §6.6 Retail & Goods · Operator: Ops Lead Hector Salas · White-glove delivery/assembly; account-with-billing; inquiry. Key services: White-Glove Delivery, Furniture Assembly, Appliance Delivery & Install, TV & Wall Mounting, Haul-Away of Old Item. Special: delivery-window scheduling + two-person job sizing; Haul-Away is a reverse-logistics add-on. Verify a delivery date/window can be captured (FD1/FD3).


Runs 24–26 — Dispatch-Native New Categories (Gap-B)

Fresh install per archetype. Three whole new categories (2026-06-13) that are field-dispatch by nature — every leaf carries form=services, delivery=physical, consumptionChannel=onsite-plus-portal and composes under service-operations. Value-stream profiles: §6.16 Automotive / §6.17 Moving & Logistics / §6.18 Security Services. Run the standard checklist + Phase FD (above). Adding-an-ArchetypeCategory touchpoints: coverage tests already exist (archetypes.test.ts “three dispatch-native categories” Gap-B assertion) and the Seed-Fit gate already covers them — no new scaffolding.

Run 24 — Automotive Services (new category)

All inquiry; mobile-to-vehicle. Value stream §6.16. Constrained unit: technician-hours × drive-time.

auto-glass — Maplewood Auto Glass (maplewoodautoglass.com) · Operator: Owner Sami Reyes · Windshield replacement + ADAS calibration (the category’s named compliance example; carries the adas tag per archetypes.test.ts). CTA: inquiry. Key services: Windshield Replacement, Rock Chip / Crack Repair, Side & Rear Glass, ADAS Calibration, Mobile Service, Fleet & Commercial Glass. Special: verify insurance-claim + VIN/vehicle capture is at least attemptable; Phase O: O5 should surface ADAS-calibration as a safety-critical step post-replacement. mobile-mechanic — Maplewood Mobile Mechanic (maplewoodmobilemech.com) · Operator: Owner-Tech Cole Barrett · Repairs at the customer’s vehicle. Key services: Diagnostic Visit, Brake Service, Battery/Alternator/Starter, Oil & Filter Change, Pre-Purchase Inspection, No-Start / Won’t-Run. Special: No-Start is emergency-reactive; Pre-Purchase Inspection is a report deliverable. mobile-detailing — Maplewood Mobile Detailing (maplewooddetailing.com) · Operator: Owner Jaz Mwangi · On-site cleaning/ceramic. Key services: Full Detail, Interior Detail, Exterior Wash & Wax, Ceramic Coating, Headlight Restoration. Special: water/power on-site logistics; packages fit a menu. mobile-tire — Maplewood Mobile Tire (maplewoodmobiletire.com) · Operator: Owner Dev Anand · Roadside/at-home tire work. Key services: Tire Replacement, Flat Repair, Rotation & Balance, TPMS Service, Seasonal Swap. Special: Seasonal Swap is a recurring/seasonal signal. roadside-assistance — Maplewood Roadside & Towing (maplewoodroadside.com) · Operator: Dispatch Owner Marco Bianchi · Emergency-reactive, 24/7, GPS-critical. Key services: Jump Start, Lockout Service, Flat Tire Change, Fuel Delivery, Towing, Winch-Out / Recovery. Special: this is the sharpest emergency-dispatch case — FD1 location capture and FD3 ETA are load-bearing; their absence is important, not minor. FD4: “Someone’s broken down on the interstate right now — how do I get the nearest truck to them?” locksmith — Maplewood Locksmith (maplewoodlock.com) · Operator: Owner Reg Fontaine · Auto + residential lockout/rekey; emergency + scheduled. Key services: Car Lockout, Car Key Replacement & Programming, Home/Business Lockout, Rekey & Lock Change, Lock Installation & Upgrade. Special: lockouts are emergency; Phase O: O5 should name state locksmith licensing + ID-verification obligation before opening a lock/home (a genuine trust gate).

Run-24 Phase G (representative — auto-glass): Supplier “Auto Glass & Adhesive Wholesale”; Bill “OEM windshields + urethane restock” £1,800; Invoice to a customer account “Windshield replacement + ADAS calibration” £520; P&L shows both.

Run 25 — Moving & Logistics (new category)

All inquiry; crew + vehicle + route. Value stream §6.17. roadside/DOT-adjacent compliance for the movers/freight leaves.

moving-company — Maplewood Movers (maplewoodmovers.com) · Operator: Owner Trish Donovan · Local + long-distance household moves; survey → quote → move-day. Key services: Local Move, Long-Distance Move, Packing & Unpacking, Loading/Unloading Only, Specialty Item Move, Short-Term Storage. Special: the in-home/virtual survey→estimate is the intake; move-day is a scheduled crew job; Phase O: O5 should name DOT / interstate mover registration (USDOT number) for long-distance. junk-removal — Maplewood Junk Removal (maplewoodjunk.com) · Operator: Owner Blake Ferris · Volume-priced haul-away. Key services: Single-Item Pickup, Truck-Load Haul, Furniture & Appliance Removal, Estate/Property Cleanout, Construction Debris. Special: truck-load volume pricing + disposal-fee pass-through; photo-quote intake fits. courier-delivery — Maplewood Courier (maplewoodcourier.com) · Operator: Dispatch Lead Amara Osei · Same-day + scheduled routes incl. medical/legal; Account Setup item signals B2B accounts. Key services: Same-Day Courier, Scheduled Route, Medical/Lab Courier, Legal & Document Courier, Account Setup. Special: Medical/Lab Courier carries HIPAA + chain-of-custody (spot-check Phase O); B2B account setup implies recurring accounts. last-mile-freight — Maplewood Last-Mile Freight (maplewoodfreight.com) · Operator: Ops Manager Nils Berger · LTL/white-glove + reverse logistics; B2B. Key services: LTL / Local Freight, White-Glove Freight, Scheduled Distribution Route, Returns & Reverse Logistics. Special: appointment-based delivery windows + returns; verify B2B account + scheduled-route framing.

Run-25 Phase G (representative — moving-company): Supplier “Packing Materials & Truck Lease Co”; Bill “Boxes, blankets, monthly truck lease” £2,400; Invoice to a customer account “3-bed local move — crew of 3, 6 hrs” £960; P&L shows both.

Run 26 — Security Services (new category — REGULATED)

Value stream §6.18. Both account-with-billing; recurring-agreement-heavy. Regulated — Phase O calibrated to security licensing (silence = Level 0).

guard-patrol — Maplewood Security Guarding (maplewoodsecurity.com) · Operator: Ops Director Yusuf Kaplan · Manned guarding + mobile patrol under service agreements; shift rostering. CTA: inquiry. Key services: Manned Guarding, Mobile Patrol, Event Security, Alarm Response & Keyholding, Concierge / Front-of-House, Loss Prevention. Special: contracts are recurring service-agreements with shift coverage (24/7 rostering is the capacity model); Alarm Response & Keyholding is reactive-dispatch. archetypes.test.ts asserts guard-patrol derives service-agreements = required — verify the agreement surface. Phase O (REGULATED — Level 0 if silent): O5 must name state security-officer / PSO licensing (e.g. a board such as CA BSIS), armed-vs-unarmed firearms permits, and company bonding/insurance. FD4: “I need to staff a 24/7 guard post at a warehouse starting Monday — how do I roster it?” alarm-cctv-install — Maplewood Alarm & CCTV (maplewoodalarms.com) · Operator: Owner Petra Lindqvist · Install + recurring monitoring plans. CTA: inquiry. Key services: Alarm System Installation, CCTV Installation, Access Control, Monitoring Plan, Smart-Home Security, Service & Upgrade. Special: Monitoring Plan = recurring service-agreement; installs are project-shaped. Phase O (REGULATED): O5 must name low-voltage/alarm-installer licensing (state-specific), alarm-company-operator registration, false-alarm ordinances, and monitoring-center listing.

Run-26 Phase G (representative — guard-patrol): Supplier “Uniforms & Radio Equipment Co”; Bill “Guard uniforms + radios” £1,100; Invoice to a client account “Manned guarding — 168 hrs @ £18” £3,024; P&L shows both.


Run 27 — Real Estate & Construction (new category)

Fresh install per archetype. New real-estate-construction category (EP-GRID-BUILDER). Both leaves sell physical goods to households (form=goods, primaryConsumer=household, delivery=physical) with milestone billing (billingReadinessMode: prepared-not-prescribed, modules include billing-readiness + projects), and each carries a booking item with schedulingDefaults (model-home tour / design consultation) even though the top-level CTA is inquiry — so both additionally run the P-BOOKING scheduling-defaults check. These invariants are guarded by the archetypes.test.ts “home builder archetypes” assertion (verify no divergence). CTA: inquiry.

Value-streams doc reconciliation (2026-07-18): archetype-business-value-streams.md now carries the current 95/21 active baseline, including first-class media-production and live-events-venues profiles plus medical-practice and production-equipment-rental leaf coverage. If future source counts drift again, update that doc and this plan together.

new-home-builder — Maplewood Homes (maplewoodhomes.com) · Operator: Sales Manager Karen Blythe · Production/spec builder: model homes open 7 days (seed gives Sunday hours), plan-book selling, design-centre options. CTA: inquiry (+ Model Home Tour booking). Key services (seed): Model Home Tour, Design Centre Appointment, 3-Bedroom Home Plans, 4-Bedroom Home Plans, Community Information Pack. Provisioning: account-with-billing. Vocabulary: category default (no leaf override). Load-bearing stages: S1 Attract (model-home tour / community pack) → S2 Capture (plan selection) → S4/S5 milestone-billed build. Special: verify the Model Home Tour is a bookable slot (scheduling-defaults present incl. Sunday); milestone payments should read as prepared-not-prescribed, not a single invoice. Phase O: O5 should name state contractor/home-builder license + new-home warranty obligations. custom-home-builder — Maplewood Custom Homes (maplewoodcustomhomes.com) · Operator: Build Consultant (agentName override) · Bespoke builder: business-hours only (no weekend model homes — seed omits Sat/Sun), consultative design→contract→build, active subcontractor coordination (service-operations module). CTA: inquiry (+ Initial Design Consultation booking). Key services: Initial Design Consultation, Custom Home Design, Full Build Contract, Knockdown & Rebuild, Renovation & Extension. Provisioning: account-with-billing. Vocabulary (leaf override — verify): stakeholders = “Clients”, team = “Build Team”, coworker = “Build Consultant” (asserted in archetypes.test.ts; a leak to “Customers”/generic agent → important). Special: the Initial Design Consultation is the booking front door; Full Build Contract + Renovation are multi-milestone projects — confirm project + billing-readiness framing and that no Saturday/Sunday tour slots are offered (business-hours-only is intentional). Phase O: O5 should name state contractor license + design/architectural sign-off obligations.

Run-27 Phase G (representative — custom-home-builder): Supplier “Building Materials & Subcontractor Payments”; Bill “Framing package + subcontractor draw” £48,000; Invoice to a client account “Design + foundation milestone” £65,000 (verify milestone/draw framing, not a lump sum); P&L shows both.


Run 28 — Media Production (new category)

Fresh install per archetype. Project-based production businesses that sell produced assets or staged production services to clients. These are not rental businesses and not live-events box offices. The source category default should produce a PIPELINE/timeline posture: brief → pre-production → shoot/build → post/strike → deliver, with projects, billing-readiness, and service-operations where applicable.

Archetypes: film-video-production, post-production-studio, event-production-staging CTA: inquiry, with bookable discovery/site-visit items where seeded Vocabulary expected: Clients, Crew/Artists, Project Enquiries, Production Coordinator / Post Producer / Production Manager Workspace/twin expectation: project pipeline or timeline; needs-you queue should emphasize deadlines, approvals, waiting-on-client feedback, crew/suite availability, and milestone billing readiness.

Run-28 Phase P setup:

Run-28 Phase B walkthrough:

  1. Public portal renders the category-specific item section (“What We Produce”, “Post Services”, or “Production Services”).
  2. Inquiry form captures project type/service, budget or delivery spec, deadline/timeline, and brief.
  3. Booking item (“Discovery Call” or “Site Visit & Consultation”) renders weekday slots from schedulingDefaults.
  4. /storefront/inbox records the inquiry as a project enquiry with client/brief context.

Run-28 Phase O/K focus:

Run-28 Phase G (representative — film-video-production): Supplier “Crew & Equipment Vendors”; Bill “Camera crew day rate + gear package” £4,800; Invoice “Brand video production milestone — shoot complete” £7,500; P&L shows both and language preserves milestone/project framing.


Run 29 — Live Events & Venues (new category)

Fresh install per archetype. Event businesses that sell the show: venues/box office, promoters/tours, and talent/booking agencies. These are distinct from media-production because capacity, dates, ticketing/holds, and event settlement are load-bearing. The operational twin should land on VENUE or an event-oriented pipeline/booking posture rather than a generic service board.

Archetypes: event-venue, tour-promoter, talent-booking-agency CTA: purchase for ticketed venue/promoter leaves, inquiry for booking agency, with booking items where seeded Vocabulary expected: Guests/Fans/Clients, Box Office or Booking Portal, Venue Team/Roster, Shows & Tours, Booking Enquiries Boundary: DPF can test portal purchase/inquiry flows and event readiness language; it must not imply a full ticketing seat-map, payment rail, artist contract, or settlement engine unless those runtime surfaces exist.

Run-29 Phase P setup:

Run-29 Phase B/Purchase walkthrough:

  1. Public portal uses “What’s On & Tickets”, “Shows & Tours”, or “Booking Services” vocabulary.
  2. Purchase CTA completes for ticketed items with a reference/receipt; inquiry CTA captures event date, budget, and event details.
  3. Booking item renders weekend/long-day slots where LIVE_EVENTS_SCHEDULING applies.
  4. /storefront/inbox and /finance preserve guests/fans/clients vocabulary rather than generic customers/products.

Run-29 Phase O/K focus:

Run-29 Phase G (representative — event-venue): Supplier “Event Staffing & Security”; Bill “Door staff and event cleaning” £1,200; Invoice/purchase revenue “Audit — General Admission Ticket”, quantity 20 at £25; P&L shows both and event language remains intact.


8. Gap Capture

8a. The fundamental constraint: every DB reset wipes portal state

Portal backlog items and epics do not survive a DB reset. Any BI filed into the portal during a run is permanently destroyed when the next run’s reset executes. This creates a hard workflow rule:

Never file portal backlog items during audit runs. The only per-run record that matters is the git-committed findings file — it is the single source of truth until the pg_dump is restored and BIs can be safely filed.

Deferred BIs and fix-PR follow-ups that are not tied to a single run are tracked in the durable pending-backlog-items.md registry — same reset-proof principle (git, not the DB), with stable PBI-* refs + GitHub Issue numbers, filed into the portal post-audit (§10).

8b. Two-channel findings workflow

Channel 1 — Git findings file (authoritative, required)

One markdown file per run at docs/testing/archetype-audit-findings/run-NN-<category>.md. Committed to git before the run’s reset (Section 5 Step 1). Survives every wipe. The post-audit BI batch is generated from this file.

For each finding, use:

RUN: [run number]
ARCHETYPE: [archetypeId]
INSTALL MODE: fresh-install | swapped (archetype-reset)
PHASE: [P, A–K + test ID e.g. B5, G3, P5-PET, O1, K3]
OBSERVATION: [what you saw — "drove X, observed Y"]
EXPECTED: [what should have happened — "expected Z"]
SEVERITY: critical | important | minor | observation
CANDIDATE BI TITLE: [proposed backlog item title]
CANDIDATE EPIC: [existing epic to link to, if obvious]
UX FIT: [operator persona impact if applicable — "Sandra Hooper would not know..."]

Additionally, at the end of each archetype (before moving to the next swap or the next run), record one per-archetype verdict summary:

ARCHETYPE: [archetypeId]
RUN: [run number]
INSTALL MODE: fresh-install | swapped
VERDICT: Pass | Warn | Fail | Blocked
  Pass = coherent setup, correct CTA/vocab, useful capabilities, sensible customer flow, relevant integration context
  Warn = works but relies on generic fallback, thin copy, missing workspace-home role, or incomplete integration depth
  Fail = empty capabilities, wrong CTA, broken setup, platform vocabulary leaking into worker UX, critical finding
  Blocked = app unavailable, auth broken, or environment prevents the walkthrough

CAPABILITY RESULT: [C5/C6 summary — empty/generic/archetype-specific]
EMPLOYEE WORK RESULT: [E6 summary — platform-admin / partial / role-appropriate]
INTEGRATION RESULT: [C7 summary — anchors present / partially present / absent]
STOREFRONT RESULT: [B3/B5 summary — correct CTA, domain fields present, reference issued]
FINANCE RESULT: [G4 summary — P&L loaded / entries appeared / empty]

COWORKER OPERATING INTELLIGENCE (Phase O — every archetype):
  O1 Tax setup: Level [0–4] — [brief observation]
  O2 Expense categories: Level [0–4] — [brief observation]
  O3 Market context: Level [0–4] — [brief observation]
  O4 Marketing channels: Level [0–4] — [brief observation]
  O5 Compliance/licensing: Level [0–4] — [brief observation]
  O6 Setup intelligence: Level [0–4] — [brief observation]
  O7 Cross-coworker coherence: Level [0–4] — [brief observation]
  Overall O maturity: [dominant level; e.g. "mostly Level 1–2, O5 Level 0"]

OPERATOR DAY-TO-DAY (Phase K — every archetype):
  K1 Customer communications: [present/absent/partial — note]
  K2 Schedule/operational view: [present/absent/partial — note]
  K3 Payment surface: [present/absent/partial — note]
  K4 Business health KPIs: [present/absent/partial — language score 1–3]
  K5 Staff management: [present/absent/not-applicable — note]
  K6 Digital presence guidance: [present/absent/partial — note]
  K7 Onboarding completeness: [present/absent/partial — note]
  K8 Language accessibility: [count of inaccessible terms; severity: ok/minor/important]

OPEN FINDINGS: [count of critical, important, minor for this archetype]

Channel 2 — GitHub Issues (optional, for real-time team visibility)

Portal BIs are destroyed by resets; GitHub Issues are not. For any critical or important finding where the team should know immediately (without waiting for the full audit to complete):

gh issue create \
  --title "[Audit Run N] <BI candidate title>" \
  --label "archetype-audit,severity-critical" \
  --body "**Archetype:** <id>  **Phase:** <phase>  **Observation:** <what>  **Expected:** <what>  **Install mode:** fresh-install|swapped"

These issues are visible to the team immediately and survive all resets. After the pg_dump restore, they serve as the batch queue for portal BI filing. Do not close or resolve these issues during the audit — they are the durable cross-reference that links the GitHub issue to its eventual portal BI ID after restore.

minor and observation severity findings do not need GitHub issues — the git findings file is sufficient.

After restore: filing portal BIs

  1. Restore the pg_dump (Section 4c)
  2. Consolidate all per-run git findings files into a single audit findings summary (Section 10)
  3. Dedupe findings where multiple runs hit the same root cause — one BI per cause, with an affected-archetypes list
  4. For each deduplicated finding, use create_backlog_item MCP → set title, severity, epic link
  5. Update the corresponding GitHub Issue (Channel 2) with the new portal BI ID → close the issue
  6. Confirm: all critical and important GitHub issues have a linked portal BI before declaring the audit complete

8c. Severity definitions

8d. Common mechanics failures are platform findings, not archetype gaps

If a [C]-marked step (Section 2a / Phase P) fails in Runs 1–29 and it passed in Run 0, that is a regression — log with severity critical and the note “regression vs. Run 0” and open a GitHub issue immediately. Do not continue the current run until the regression is triaged (it will affect all remaining runs if it is a platform-wide failure).

8f. Closing GitHub Issues when a fix PR merges

The “do not close during audit” rule in Section 8b applies only while the audit is in progress and issues are waiting for a pg_dump restore + portal BI filing. Once a fix PR merges to main, the corresponding GitHub Issue must be closed in the same session — do not let resolved issues accumulate as false open signal.

Closing process (applies whenever a fix PR merges):

  1. For each finding resolved by the PR, close the GitHub Issue with a comment:
    Fixed in #<PR number>: <one-line description of what changed>.
    
  2. If the fix requires a portal rebuild to take effect (e.g. Dockerfile change, seed data change), add a note:
    Requires local image rebuild to appear on a running install — pending AUDIT-R1-U-001 resolution.
    
  3. If a finding was a process issue (not a code bug), close it with a note describing which process change addressed it.
  4. After closing, verify gh issue list --state open shows only issues that are genuinely unresolved.

Who does this: the session that merges or reviews the fix PR. Not deferred — stale open issues mislead future sessions about what is actually broken.

8e. Known pre-existing gaps (do not refile)


9. Cross-Cutting Test Matrix

These tests apply to EVERY archetype run. Track results in the summary table below.

Test Description Pass Criterion
AI-0 Coworker health gate (precondition) Coworker answers a trivial question coherently on the fresh install BEFORE any AI/vocab scoring; failure blocks AI tests for the run and is filed as a platform finding, not an archetype gap
VOCAB-1 No platform-developer vocabulary in portal Coworker never says “backlog”, “epic”, “worktree”, “MCP”, “FeatureBuild”
VOCAB-2 Archetype vocabulary overrides render “Members” for credit-union and cooperative; “Ratepayers” for municipal-utility; “Borrowers” for mortgage-lending; “Renters” for equipment-rental; “Tenants” for self-storage; “Productions” for production-equipment-rental; “Member-Owners” for agricultural-cooperative
VOCAB-3 CTA label correct “Book Now” / “Shop Now” / “Get a Quote” / “Donate” / “Apply” matches archetype; rental item labels: “Reserve” (equipment-rental and production-equipment-rental), “Reserve unit” (self-storage), “Request booking” (agricultural-cooperative)
SETUP-1 Brand URL suggests correct archetype Auto-suggestion matches expected archetype for recognizable domain pattern
SETUP-2 Currency pre-fills for locale EUR for .de, GBP for .co.uk, USD default
STORE-1 Public portal renders without errors No 500 errors, no blank sections, hero section first
STORE-2 CTA completes end-to-end Booking/purchase/inquiry/donation flow completes with reference number
RENT-1 Rental lifecycle operates (Run 17 only) /rental Rental Desk gated correctly; reserve → verify → checkout → return & re-pool transitions a unit through reserved/out/available; double-booking refused; self-storage reports occupancy %; production-equipment-rental preserves kit/shoot window fields; agricultural-cooperative allocates contended capacity equitably (least-served first), not first-come
AI-1 Coworker agent routing Correct agent shown per route (/storefront → Marketing Specialist, /workspace → COO)
AI-2 Coworker uses archetype context Responses reference archetype services and vocabulary, not generic defaults
AI-3 Regulated archetypes disclaim appropriately Banking, healthcare, legal, law enforcement — no clinical/legal/financial advice given
FIN-1 Finance defaults correct Currency matches setup; commercial model reflected in finance framing
FIN-2 Supplier bill records correctly Bill created at /finance/bills/new → appears in bills list with correct supplier and total
FIN-3 Invoice records correctly Invoice created at /finance/invoices/new → appears in invoice list linked to customer account
FIN-4 P&L report reflects entries /finance/reports/profit-loss shows the G2 expense and G3 revenue; net figure is calculated
GRC-1 Compliance section loads Dashboard loads; for regulated archetypes, sector-specific placeholders present
COMP-1 Add service line seeds items + sections After adding a secondary via Service Lines card, secondary’s item templates appear on /storefront/items with sourceCompositionId set; seeded sections present and hidden by default. Applies Run 18a–18d.
COMP-2 Remove service line cleans up by provenance Removing a secondary hides only items/sections whose sourceCompositionId matches that secondary’s composition row. Primary items and sections are unaffected. Applies Run 18a.
COMP-3 Compatibility badge renders at correct severity Same-category secondary → “Good”; cross-category → “Concern”; banking-financial-services + healthcare-wellness → “Acute” (red). Summary bubbles worst-case. Run 18a “Good”; Runs 18b–18d “Concern”; Run 18e “Acute”.
COMP-4 Max secondaries enforced After 2 secondaries are active, “Add service line” is disabled or action returns an error; a third secondary cannot be added. Applies Run 18b (attempt after primary + retail secondary).
COMP-5 AI coworker uses composite context After adding a secondary, coworker responses draw on both service lines (Run 18a: storage + equipment; Run 18b: plumbing + retail). After removal, coworker reverts to primary-only context. Run 18e: coworker disclaims appropriately; no cross-domain clinical/financial advice.

10. Post-Audit Actions

After all runs are complete (or the abort criteria fire):

  1. Restore pre-audit state first — follow Section 4c (pg_restore of the authoritative dump), verify counts and spot-check BI IDs. Restoration precedes BI filing so the new BIs land in the real backlog, not a soon-to-be-wiped one.
  2. Compile gap list — consolidate the git-committed per-run findings files (docs/testing/archetype-audit-findings/run-NN-<category>.md) into a single summary. Dedupe cross-run repeats of the same root cause: one BI per root cause with an affected-archetypes list, not one BI per archetype symptom.
  3. Close GitHub Issues → file portal BIs — for every GitHub issue opened during the audit (Section 8b Channel 2): create the portal BI via create_backlog_item MCP, record the new portal BI ID in the GitHub issue body, then close the issue. This closes the loop between real-time team visibility and the permanent backlog record.
  4. Triage by severitycritical gaps → priority 1 BIs; important → priority 2; swapped-archetype observation-tier A/C/D findings only graduate to BIs after fresh-install reproduction confirms them.
  5. Separate platform regressions from archetype gaps — any [C]-marked finding that failed in Runs 1–29 (mechanics already proven in Run 0) is a platform regression BI, not an archetype BI. Link regressions to the appropriate platform epic; link archetype gaps to EP-ARCH-8D4F2A or EP-9FC5D2FD.
  6. Operator UX-fit batch — collect all minor UX-fit findings from Phase P and Phase B5 steps across all runs. These are operator persona accessibility gaps; link them to EP-9FC5D2FD (Dale persona hardening).
  7. Link to epics — archetype vocabulary/CTA/coworker gaps → EP-ARCH-8D4F2A. Operator UX-fit → EP-9FC5D2FD. Platform mechanics regressions → appropriate existing platform epic.
  8. Create new epic if needed — if total archetype-gap BI count exceeds 20 items, create EP-ARCHETYPE-AUDIT-2026 to contain them.
  9. Final state — the restored install already carries the pre-audit organization; no extra fresh install is needed. Note in the audit summary that the restored DB’s org archetype is whatever it was pre-audit.

Appendix A — Full Open Epic List (2026-06-10 snapshot)

Epic ID Title Items (O/IP/D)
EP-WSID WSID — profession corpus 2/0/2
EP-BOM-WIRING Business Operating Model — Portfolio Wiring 5/0/0
EP-LIFECYCLE Unified Lifecycle Backbone 3/4/0
EP-BUILD-FB97A6 Crash boundary AI diagnostic prompt 0/1/0
EP-BUILD-D78835 verify-install scripts tsx import fix 0/1/0
EP-2D477458 Build-Engine Provisioning — declarative recipes 0/1/9
EP-COWORKER-INTERACTIVITY Coworker Interactivity — PUC envelope 6/0/0
EP-UPGRADE-LIFECYCLE Governed Platform Upgrade Lifecycle 8/1/2
EP-CLIENT-HOOK-PLANE DPF Client Hook Plane 8/0/0
EP-MDM Master Data Management 7/2/0
EP-DATA-ARCH Self-documenting data architecture 0/5/1
EP-INTAKE-UNIFY Single front door for work intake 5/0/0
EP-PROACTIVE-OPS Proactive Operational Awareness 11/0/0
EP-BUILD-325AFA Add “Re-run scan” to Discovery Connections 0/1/0
EP-BUILD-DCCB49 Voice Slice 1.6 — Upgrade-to-GPU button 0/1/0
EP-BUILD-4DB1C0 Portal unrecovered after self-upgrade 0/1/0
EP-HX-LOOP Human Experience Closed-Loop 5/0/0
EP-BROWSER-DRIVE Coworker Browser-Driving Capability 4/1/0
EP-E2866100 Truck Inventory Tracking for Field Service 0/1/0
EP-REDUCTION-GEAR-ARCH Reduction Gear Architecture 73/6/17
EP-DR-HARDENING-2026-05-23 Disaster recovery hardening 7/1/8
EP-9FC5D2FD Build Studio first-customer experience (Dale) 23/5/1
EP-ASSURANCE-LEDGER Assurance Ledger 2/0/3
EP-BUILD-STUDIO-UX Build Studio UX Redesign 1/1/0
EP-COST-001 AI Cost Governance 10/0/0
EP-TRADES-FIELD-SERVICE Field Service Trades 7/0/0
EP-WWMD-MCP WWMD MCP Exposure 16/1/0
EP-BUILD-65837F Formal deliberation 2/1/0
EP-BUILD-58B8E3 Specialist subtask thread spawning 0/1/0
EP-BUILD-STUDIO Build Studio — main epic 27/11/19
EP-AI-OPSMAP AI Operations Map 9/2/5
EP-LOCAL-AI Local AI / Qwen3 / embedding catalog 2/1/3
EP-A2A A2A — agent-to-agent orchestration 2/0/1
EP-SEED-SUBSTRATE Eliminate seed-as-data-load 1/0/2
EP-HITL-MOBILE Realtime HITL + Mobile companion 2/0/4
EP-WORKTREE-HYGIENE Worktree hygiene janitor 10/0/3
EP-TAK-3F9A21 TAK/GAID Refresh 3/0/2
EP-BUILD-CC1BD8 Fix Build Studio header overlap 1/1/0
EP-CTRL-5E21A4 Automated Control Utility 10/0/0
EP-SITE-7C4D2B Customer Site Records 7/0/0
EP-INT-2E7C1A Integration Harness 13/5/6

Total open items in open epics: ~354 items across 41 epics with substantive content.