Water of Life

Architecture Report — March 2026

Owner: Joseph M. Castillo • Domain: wateroflife.supply • Platform: Cloudflare Pages

Dedicated to Our Lady of the Miraculous Medal

What Changed Since Last Approval

Guidance Updates (a-d-d-guidance/GLOBAL.md)

Architecture Review section — AI generates HTML report at every state transition. Includes what the user needs to provide (credentials, tokens) with step-by-step and links.
Memorializing Approval — On approval: save report snapshot to a-d-d/reviews/, record approval triples on board, commit and push immediately.
Never ask to proceed — Always show the review first. The human's response IS the approval. No "should we proceed?" before showing work.
Demo-Retro-Ship lifecycle — When board clears: demo local → retrospective → update guidance → ship → demo from prod. No shipping before demo.

Project Updates (a-d-d/)

Dedication added — Our Lady of the Miraculous Medal (in purpose spec and report)
Board lifecycle items — 5 post-build steps added: demo, retro, guidance-update, ship, demo-prod
Deploy simplified — Wrangler login for deploys, DNS token only for custom domain setup
Approval memorialized — Review snapshot saved at a-d-d/reviews/shaping-2026-03-21.html, triples recorded on board
Issues journal — a-d-d/issues.md created. AI logs issues as they happen during the build. Nothing is done with them until the retro.
Estimate reasoning — Every board item now shows WHY it got that size, plus total effort

Project Structure

a-d-d/ inform/ ← intent: WHY CLAUDE.md share/ ← purpose: WHAT FOR CLAUDE.md target/ cloudflare-pages/ ← target: WHERE CLAUDE.md board/ website.md ← kanban board user/ pantheon-0.md ← your preferences

Intent: inform

WHY

Get Joey's story and the water of life formula in front of people who need it. No product to sell, no ideology to push. One man's experience, one formula, given away free.

Purpose: share

WHAT FOR

A public website that tells Joey's story and gives away the water of life formula. No backend. No accounts. No commerce. Static HTML/CSS/JS on Cloudflare Pages.

Design Direction

Attribute	Value
Colors	Navy #1B3A5C Gold #D4A843
Typography	Georgia (body), Helvetica Neue (headings/nav)
Layout	Mobile-first, max-width 800px, clean and direct
Voice	Honest, personal, no-bullshit — not preachy, not anti-establishment
Tech	Vanilla HTML5, CSS3, JS — no frameworks, no build tools, no npm

Target: cloudflare-pages

WHERE

Cloudflare Pages, edge-deployed worldwide. Free tier. Static files only.

Config	Value
Domain	wateroflife.supply
DNS & SSL	Cloudflare (automatic)
Deploy (now)	Local: `wrangler pages deploy` — uses your wrangler login, no token needed
Deploy (later)	GitHub Actions automated deploy can be added when you want it — requires API token
Monitoring	Cloudflare dashboard + loads in browser = healthy

What You Need to Provide

One token to point your domain. The AI handles everything else.

Cloudflare API Token — Edit Zone DNS

What it is: An API token that lets the AI configure wateroflife.supply DNS records to point to your Cloudflare Pages site. Wrangler login handles deploys, but pointing the custom domain needs this token.

Permissions needed: Zone: DNS: Edit for wateroflife.supply (minimum scope).

How to get it:

Go to dash.cloudflare.com/profile/api-tokens
Click "Create Token"
Use the "Edit zone DNS" template
Under Zone Resources, select Specific zone → wateroflife.supply
Click "Continue to summary" → "Create Token"
Copy the token — you'll only see it once

How the AI will use it: The AI will use this token to add DNS records pointing wateroflife.supply to the Cloudflare Pages project. One-time use during setup.

Wrangler Login (the AI handles this)

The AI will run wrangler login which opens your browser for one-time Cloudflare authorization. This handles all deploys — no token needed for that part.

What the AI Will Do

For visibility — these are tools and services the AI will install and configure:

Tools & Services

Action	Details
Create GitHub repo	`joeycastilloUS/wateroflife.supply` — private repo, main branch
Install wrangler	Cloudflare CLI for Pages deployment (`npm install -g wrangler`)
Wrangler login	Opens browser for Cloudflare auth — one-time
Create Cloudflare Pages project	`wateroflife-supply` via wrangler CLI
Configure custom domain	Point wateroflife.supply → Cloudflare Pages via wrangler
Build site	5 HTML pages + 1 CSS file + PDFs — vanilla, no build step
Deploy	`wrangler pages deploy` from your machine — site is live at wateroflife.supply

Board: website

6 build items (all size 3 = 18 points total) + 5 lifecycle steps

Build

READY site/css Shared stylesheet — navy/gold theme, mobile-first, typography 3 One file, known palette, standard responsive patterns

READY site/home Home page — hero, before/after, formula at a glance, CTA 3 Content already written in PDFs — layout + formatting only

READY site/story Full Stop Everything essay adapted for web 3 8-page essay already written — convert to HTML sections

READY site/the-water Formula page — recipe, DO/DON'T rules, what to expect 3 Formula + rules from handout PDF — tables and lists

READY site/get-powder Get the Powder — coming soon + manual recipe 3 Short page — coming soon message + recipe restatement

READY site/about About Joey + full medical disclaimer + contact 3 Bio + disclaimer from PDF — straightforward content page

After Board Clears

BLOCKED demo Present finished site locally in browser — walk through every page after: all build items done

BLOCKED retro Retrospective — what went well, what could be better, what to change after: demo

BLOCKED guidance-update Update a-d-d-guidance and project a-d-d based on retro findings after: retro

BLOCKED ship Deploy to Cloudflare Pages via wrangler — site live at wateroflife.supply after: guidance-update

BLOCKED demo-prod Demo live from production — confirm DNS, SSL, assets, mobile all working after: ship

Water of Life

What Changed Since Last Approval

Project Structure

Intent: inform

Purpose: share

Pages

Home — index.html

My Story — story.html

The Water — the-water.html

Get the Powder — get-powder.html