← Back to Hub

Content Batch Refactor Workflow

Process for updating product pages at scale with proper review gates

Purpose

When Marketing discovers new SEO strategies, compliance requirements, or content improvements, we need a systematic way to update all product pages without breaking live content or skipping review gates.

Key principle: All refactored content goes to staging first, passes through CMedO and CLegalO review, then Chairman approval before going live.

Environments

a.wellwalla.com Staging — new/refactored content lives here for review
wellwalla.com Live — only Chairman-approved content reaches here

Workflow Steps

1

Discovery & Documentation

Marketing

Marketing identifies new SEO strategy or content improvement. Documents in Knowledge Base with rationale and expected impact. Creates batch refactor request.

2

Generate Updated Content

Engineering

Engineering applies changes to specified pages. Deploys all updated pages to a.wellwalla.com (staging). Creates review batch in Content Review Board.

3

Medical Review

CMedO

CMedO reviews each page for medical accuracy, appropriate claims, and clinical validity. Marks each page as: ✓ Approved Needs Revision Blocked

4

Legal Review

CLegalO

CLegalO reviews for FTC/FDA compliance, appropriate disclaimers, and legal risk. Uses same status system. Can run in parallel with CMedO review.

5

Revision Loop (if needed)

Engineering

If pages marked "Needs Revision" or "Blocked", Engineering addresses feedback and re-deploys to staging. Reviewers re-check until approved.

6

Chairman Approval

Chairman

Chairman receives summary: "12 pages reviewed, 10 approved by both CMedO & CLegalO, 2 need revision." Reviews approved pages. Gives final go/no-go for live deployment.

7

Deploy to Live

Engineering

Upon Chairman approval, Engineering promotes approved pages from staging to wellwalla.com. Update is logged with timestamp and approval chain.

Review Status Definitions

Pending Not yet reviewed
✓ Approved Passed review, ready for next gate
Needs Revision Changes requested, not blocked
Blocked Fundamental issue, requires discussion

Content Types

Product Relationship System

All products (lab tests, panels, supplements) are linked through a relationship manifest. This enables automatic cross-sell, upsell, and testing guidance sections on every page.

Relationship Types

Panel → Test "Includes" — Panel pages list all individual tests with links
Test → Panel "Included In" — Test pages show which panels contain them
Test ↔ Supplement "Related Supplements" — Bidirectional monitoring links
Supplement → Test "Testing Guidance" — Baseline and retest recommendations
Panel → Panel "Comparison" — e.g., CMP vs BMP + LFT differences

Manifest Location

/Sites/wellwalla-alpha/data/product-relationships.json

Validation

Run the validation script before building/modifying pages:

node validate-relationships.js --validate

Generate Link Sections

Generate HTML for relationship sections on a specific page:

node validate-relationships.js lab_test glucose-fasting
node validate-relationships.js lab_panel cmp
node validate-relationships.js supplement berberine

Ready to Review Content?

View all pending and approved pages in the Content Review Board

Open Content Review Board →