Cloudflare control plane

Platform Architecture.

The live infrastructure that receives Asana events, queues work, stores state, stores artifacts, and routes model calls.

Plain-Language View

Worker

Receives events, checks tasks, queues work, runs Jessie logic, and exposes internal APIs.

Queues

Keep webhook intake fast and make task processing retryable.

D1

Stores run state, task state, artifact records, context metadata, and audit traces.

R2

Stores larger context, evidence, crawl, and generated artifact packages.

Pages

Hosts internal architecture documentation and staff web interfaces.

AI Gateway

Routes all live Jessie model calls and records model-call metadata.

System Map

One Asana task, end to end: Asana triggers the Worker, the Worker leans on Queues, D1, R2, the AI Gateway, and read-only source APIs, then posts a review-ready draft back to Asana.

Technical Stack

Asana tasks, comments, boards, webhooks

Cloudflare Worker: intake, queue consumers, skills, runtime policy

D1 state + R2 artifacts + Context Lake + Report Artifact Registry

Read-only source APIs: GA4, Search Console, Google Ads, Meta, Browser Run, Box

Cloudflare AI Gateway: provider-routed LLM synthesis with bounded metadata

Asana review output and internal Pages documentation

Live Resource Names

Layer	Live name or binding	Use
Architecture Pages project	agency-os-architecture-site	Internal architecture and training site.
Client dashboard Pages project	agency-os-web-interface	Client-facing performance dashboard (live for the first client, IP-restricted); separate from this internal site.
Worker	agency-os-dev-platform-build-control-plane	Hosted Jessie and Platform Build control plane.
Jessie Intake Asana project	1214884895166080	Watched Team Agent intake project.
Platform Build Asana project	1214798884267191	Improvement-task board.
D1	agency-os-dev-platform-build-runs	Build runs, Team Agent runs, context, artifacts, and runtime state.
Queue	agency-os-dev-team-agent-runs	Jessie task execution queue.
Queue	agency-os-dev-platform-build-runs	Platform Build run queue.
R2	agency-os-dev-client-context	R2-backed client context lake cache.
R2	agency-os-dev-client-data-plane	Raw source snapshots and prepared client data.
R2	agency-os-dev-technical-seo-audits	Technical SEO audit packages.
Durable Object	TEAM_AGENT_TASK_AGENT	Agents SDK production-shadow Team Agent object.
Cron	/5 * * *	Scheduled reconciliation/monitoring trigger.
AI Gateway config	AI_GATEWAY_PROVIDER=openai, AI_GATEWAY_MODEL=gpt-5.5	Model-call route configuration; technical SEO synthesis uses low reasoning effort and a larger completion budget.

Publishing Rule

Architecture site changes should be published to the live Cloudflare Pages domain after successful build and verification whenever deployment credentials are available.

Pages project: agency-os-architecture-site.
Deploy command: npm run deploy --prefix apps/agency-os-architecture-site.
If the Pages deploy cannot run, the final handoff should say that the live domain was not updated.

Relevant Cloudflare Updates

2026-06-02 Agents SDK v0.14: accepted for a staged production-shadow upgrade (now pinned at 0.14.5); Think, Agent Skills, and scheduled tasks need synthetic proof before live Jessie execution adoption.
2026-06-02 Workflow scheduled bindings: accepted as a future clock for split-out scheduled reconciliation Workflows while Asana remains the recurring-work source of truth.
2026-05-21 AI Gateway REST API: supports the current central AI Gateway model-call route for Jessie insight synthesis.
2026-06-03 Workers bulk secrets API: useful future operational improvement for rotating Worker secret bindings, not required for the current deployment path.
2026-05-19 Artifacts lifecycle events: relevant future direction for repo/build automation, not live Platform Build behavior yet.
2026-05-15 R2 SQL JOIN/subquery support: relevant later for larger historical reporting analytics over R2 data.