The tools · July 2026

Collab Protocol

How Patrick and Angie ship the Garden — the repo, the branch flow, the preview loop, and the path a change takes to fieldbuilding-consciousness.pages.dev.

The loop

Edit a leaf

Pages are flat HTML in site/. No build step — open the file, edit, refresh.

Check locally

Open site/index.html from file://. Everything works offline by design.

Branch + PR

Short-lived branch, push, open a pull request on GitHub.

Preview deploy

CI deploys every PR to a unique *.fieldbuilding-consciousness.pages.dev preview URL — drop it in the PR for review.

Merge → live

Merge to main; CI deploys production. The hub is the deploy.

main is always the garden as the world sees it.

If it's on main, it's live; if it isn't ready to be live, it stays on a branch.

Repo shape

Path	What it is	Change discipline
site/	The deployable — hub + flat leaves, one folder, no bundler.	Free — this is the daily work surface.
site/garden.css	Design system, canonical. Tokens with dark + print values.	Shared layer — PR review by the other principal.
site/nav.js	Single source of IA: groups, titles, glyphs, sidebar shell.	Shared layer — PR review by the other principal.
AGENTS.md	Build conventions for humans and agents authoring pages.	Keep true — update when a convention actually changes.
.github/workflows/	The CI/CD: deploy on push to main, preview on PR.	Rarely touched once green.
wrangler.jsonc	Cloudflare Pages project binding (`fieldbuilding-consciousness`).	Rarely touched.

Adding an artifact

Three moves, in order — the site stays coherent because these are the only moves:

Write the leaf

Copy the skeleton from AGENTS.md, kebab-case noun-phrase filename, tokens only, self-contained.

One entry in GROUPS in nav.js with a custom 24×24 glyph, under the phase it belongs to.

Card the hub

One card on index.html: glyph, name, one sentence, a "go" verb.

Deploy mechanics

Cloudflare Pages, direct-upload via wrangler — the same command CI runs is the one either of us can run by hand:

# production (what CI does on merge to main)
npx wrangler pages deploy site --project-name=fieldbuilding-consciousness

# preview from any branch (what CI does on a PR)
npx wrangler pages deploy site --project-name=fieldbuilding-consciousness --branch=my-branch

CI authenticates with two repository secrets — CLOUDFLARE_API_TOKEN (a token scoped to Pages edit) and CLOUDFLARE_ACCOUNT_ID. Local deploys use whoever's wrangler login session. Rollback is a redeploy of any earlier commit, or one click in the Pages dashboard.

Working agreement

Both principals

Commit rights on everything. Content leaves may merge without review; changes to the shared layer (garden.css, nav.js, workflows) get a look from the other principal first.

Patrick

Repo, design system, deploy pipeline, technical tools. patrick@factorita.com · GitHub pastarita.

Angie

Programs, education, field content. angie@aintelope.net — onboarding: clone, open site/index.html, no toolchain needed.