5
Spec Documents
17
Architecture Decisions
5
Execution Phases
~150
Tasks Defined
9+
Verticals Supported
Platform Spec (Ops App)
ContentForge (Content Sites)
Trust Framework (Accounts)
Execution Plan (Timeline)
Operator Runbook (Daily Ops)
1 System Architecture — 4 Layers
Edge → Application → Data → External. Each box is color-coded to the spec document that defines it.
Edge Layer — Cloudflare (User-Facing)
🌐

Content Sites (Cloudflare Pages)

degreesources.com + future verticals. Astro + Svelte islands. Static HTML, zero JS on articles, ~5 KB per tool. Auto-deploys from GitHub.

ContentForge Spec
📊

Zaraz (Server-Side Tracking)

Event taxonomy: tool_view → tool_start → tool_complete → cta_click. 100% fire rate, no ad blockers. Feeds Meta CAPI + Google.

Platform Spec §2.2

Workers (CAPI Relay)

Cloudflare Worker relays conversion events to Meta CAPI, Google Enhanced Conversions, TikTok Events API. Server-side, edge-fast.

Platform Spec §2.2
📦

R2 (Asset Storage)

Creative assets, generated images, video renders. S3-compatible, zero egress fees. CDN-served via Cloudflare.

Platform Spec §2.2
Application Layer — DigitalOcean Droplet via Coolify
🏭

CampaignForge Platform (SvelteKit)

Campaign workflow, agent executor, creative pipeline, lead intelligence, ad platform integration. shadcn-svelte UI. Internal tool for 1-5 users.

Platform Spec §2.1–2.5
🤖

Agent Executor (Claude Agent SDK)

Pipeline stages 1-7 via query() calls. SSE streaming. Cost tracking. Session persistence. Human-in-the-loop at Stage 2 + Stage 3B.

Platform Spec §2.4
🛡

Platform Health Module

Meta HiVA score tracking, Google optimization score, TikTok verification, Bing partner status, social brand health. Automated alerts.

Trust Framework §7
Data Layer — Postgres + Existing Services
🗄

Platform Postgres (Drizzle + Kysely)

Campaigns, pipeline stages, agent sessions, approvals, ad metrics, lead routing. Drizzle for CRUD, Kysely for analytics CTEs.

Platform Spec §2.3
📝

Directus (CMS + Ops DB)

19 collections. Articles, creative assets, partnerships, leads (443K), platform accounts, social logs, intelligence. Content source for Phase 2+.

Platform Spec §2.2
📈

Metabase (BI)

7 dashboards, 35 saved questions. Lead intelligence, platform trust progress, account warm-up, brand social health. Embedded at /analytics.

Platform Spec §2.2
📋

Plane (Project Mgmt)

5 projects, 22+ tasks. MCP-connected. Tracks BUILD + OPERATE tasks across all 5 phases.

Execution Plan
External Services — APIs & Ad Platforms
📘

Meta Ads

HiVA Bronze→Platinum. Warm-up: $0→$5→$25→$50+/day over 4 weeks. 94-98% mobile. CAPI + Pixel. EDU compliant creative.

Trust §2, §5
🔍

Google Ads

Quality Score. EDU = sensitive category (no remarketing!). AI Max + RSA. Partner at $10K/90d. Enhanced Conversions.

Trust §2, §5
🎵

TikTok Ads

UGC-first. Spark Ads +30-40% CTR. Strict EDU compliance. Verified Business → Managed Account progression.

Trust §2, §5
📰

Native (Taboola/Outbrain)

Content recommendations. Editorial headline + thumbnail. Pre-lander strategy. Publisher quality = content site depth.

Trust §2, §5
🧠

Anthropic (Agent SDK)

Claude powers all 7 pipeline stages. Streaming via SSE. Cost tracking per session. Subagents for parallel generation.

Platform Spec §2.2
2 Revenue Flow
How money moves through the system: ad spend → content site → tool engagement → offer conversion → revenue.
1

Ad Click

Meta / Google / TikTok ad → user clicks → lands on content site tool page

2

Tool Engagement

User uses EFC Calculator / Quiz / Finder → genuine value delivered

3

CTA Click

User clicks "Explore Programs" → routed via offer URL with tracking params

4

Lead Submit

User fills form on partner portal → lead captured → Everflow attributes

5

Revenue

$35 CPL per qualified lead → Winners Vault updated → next campaign informed

The Tool IS the Compliance Solution

Instead of "get your grant money" (one angle, compliance risk), you have 10 distinct hooks that deliver genuine value: "Calculate your EFC in 2 minutes," "See what your employer covers," "Decode your aid letter." Each tool becomes its own ad angle. The compliance restriction list becomes the angle generation cheat sheet.

3 Execution Timeline — 5 Phases, 2 Parallel Tracks
BUILD (Claude builds) + OPERATE (Operator executes) run simultaneously. GATE milestones block the next phase until criteria are met.

Phase 0

This Week
22

Spec review, social profiles, Meta Verified, entity resolution, pre-warming future verticals

Phase 1

Weeks 1-3
35

Tracking live, platform MVP, ad accounts created, organic posting daily, campaign structures ready

Phase 2

Weeks 4-6
26

Full workflow UI, account warm-up, first live campaign, Winners Vault seeded

Phase 3

Weeks 7-9
28

Lead intelligence, email capture, social automation, competitive intel, platform health

Phase 4-5

Weeks 10+
15+

Ad platform APIs live, CAPI firing, retro automated, ping/post routing, multi-vertical expansion

3 Parallel Tracks

BUILD-CF: CampaignForge platform (SvelteKit + Postgres + Agent SDK) on DigitalOcean via Coolify.
BUILD-CT: ContentForge content sites (Astro + Svelte islands) on Cloudflare Pages.
OPERATE: Operator actions — social profiles, ad accounts, warm-up, domain verification, daily posting. Runs independently of both build tracks.

4 Spec Document Index
Each document defines a specific system concern. Click to drill into the full visual breakdown.