Workspace Artifacts

Summary: Sam's workspace contains 48 files and directories across 8 categories: agent configuration (8 files), strategy & analysis documents (11 files), automation scripts (6 scripts), data files (9 data files/directories), Braze audit tooling (4 JS scripts), memory logs (18 daily files + 2 support files), credentials (2 env files), and Node.js config. The workspace is version-controlled via its own .git repository and spans marketing intelligence, funnel analytics, CRM audit tooling, and growth infrastructure for FuturHealth's GLP-1 weight-loss program.

---

Agent Configuration Files

These files constitute Sam's identity, operating instructions, and persistent memory system. Sam reads them at the start of every session to reconstruct context.

File	Size	Last Modified	Purpose	Key Contents
AGENTS.md	7.7 KB	Mar 3	Master operating manual — how Sam behaves in every context	Session startup checklist; memory system rules (daily notes vs. long-term MEMORY.md); heartbeat system; safety rules; group chat participation rules; platform formatting rules (Discord/WhatsApp)
SOUL.md	2.0 KB	Mar 3	Identity & personality spec	Sam is John's work buddy; direct/casual tone; no performative helpfulness; has opinions; sales-and-growth filter on all priorities; "earn trust through competence"
USER.md	526 B	Mar 3	Profile of John (the human)	John Levan, FuturHealth founder; PST timezone; focused on company growth through sales & marketing; prefers casual, direct communication
IDENTITY.md	224 B	Mar 3	Sam's self-descriptor	Name: Sam; Creature: AI work buddy; Vibe: casual/direct; Emoji: ⚡
MEMORY.md	24.2 KB	Mar 16	Long-term curated memory	Distilled events, decisions, lessons, and insights from all sessions to date. Main-session only (not shared in group contexts for security)
HEARTBEAT.md	1.5 KB	Mar 17	Heartbeat task schedule	3× daily check-in windows: 10am, 2pm, 6pm PT; tasks include monitoring Slack channels (sam-chat, funnel-squad), funnel CVR metrics (SEMA, MICRO, order bump, express pay, attribution), and GitHub funnel monitoring
BOOTSTRAP.md	1.9 KB	Mar 3	First-run initialization script	Guides a brand-new agent instance through identity formation; instructs it to discover name, vibe, emoji, and communication preferences with John; tells it to delete itself once complete (still exists — artifact)
TOOLS.md	3.8 KB	Mar 17	API service directory & credentials index	Documents all connected services: PostHog (project 98417, key insight IDs), Meta Ads (account act_2108575489887376), Braze (iad-02 endpoint, 6 app IDs), NorthBeam, Higgsfield (AI video), Shotstack (video compositing), Looker (~160 dashboards), GitHub (74 FuturHealth repos, futurhealth-automation account)
POSTHOG-RULES.md	805 B	Mar 8	Analytics governance rules	Single source of truth: insight uC2ZuA1y ("Wegovy Pillform $198 Funnel") maintained by Elias; path segmentation: WEGO-PILL / SEMA / MICRO / NUTRITION; explicit prohibitions on querying random events or making unverified claims

---

Strategy & Analysis Documents

Research, creative strategy, and operational plans produced by Sam for FuturHealth's growth function.

File	Size	Date	Purpose	Key Data Points
futurhealth-creative-brief.md	3.2 KB	Mar 6	Brand foundation brief	Brand mission (medication + nutrition + coaching = sustainable weight loss); 3 growth pillars; brand positioning between telehealth/digital health/preventative health; target customer profile; creative guardrails (never position as prescription-only)
futurhealth-intelligence-report-1.md	8.6 KB	Mar 6	Market intelligence scan #1	Trustpilot analysis: FuturHealth fulfillment complaints (medication delays, billing issues, powerless CS); competitor weaknesses: Ro (bait-and-switch pricing, $149→$300+), Hims (3.0 stars, hard to cancel); top 5 market objections with ad concept responses; real customer language for copy; 5 recommended creative concepts (The GLP-1 Exit Plan, Nutrition Gap, $1,102 Difference, Real Doctors, Beyond the Pill)
futurhealth-creative-briefs-sean.md	5.0 KB	Mar 6	Video production briefs for Sean Duran	5 fully-specified briefs: (1) GLP-1 Exit Plan — weight regain fear angle; (2) Nutrition Gap — GLP-1 diet guidance; (3) $1,102 Difference — value comparison; (4) Real Doctors, Not Algorithms — trust/provider angle; (5) Beyond the Pill — complete program / 58.5% stat. Each includes hook, key message, format, variant count, and CTA
futurhealth-post-copy-variants.md	4.1 KB	Mar 6	5 Meta ad post copy variants	Angle-specific ad copy to replace generic messaging: Variant 1 (Exit Plan), Variant 2 (Nutrition Gap), Variant 3 ($1,102 Difference), Variant 4 (Real Doctors), Variant 5 (Complete Program / 58.5%). Each includes headline + body copy optimized for thumb-stop
futurhealth-meta-campaign-structure.md	5.3 KB	Mar 6	Meta Ads campaign blueprint	Fresh account (efunnel #7, act_2108575489887376); Phase 1 budget $500–1,000/day; 3-campaign structure: (1) Prospecting / Creative Testing — broad women/men + 1% lookalike; (2) Retargeting — funnel visitors 7d/quiz starters 14d/page engagers 30d; (3) Creative Lab — weekly rotation of Sean's new concepts; geo exclusions (LA, AL, VA, MS); target CPA $250; launch checklist
futurhealth-micro-bucket-map-v1.md	35.0 KB	Mar 10	30+ micro-niche audience segments × 5 angles = 150+ hook concepts	Tier 1 (survey-validated): Metabolism Betrayal (Women 45-65, ~30% of base), Camera Hider (Women 45-70, 45% hide from photos), Dieting Veteran (40-70), Empty Nester, High Achiever; Tier 2 (high-potential): Men's Health, Disease Prevention, Budget-Conscious; each bucket includes segment definition, core belief, 5 sub-angles with hook copy, format recommendation, and concept formula
futurhealth-micro-bucket-hooks-150.csv	41.5 KB	Mar 10	Master hook library (CSV format)	150+ rows; columns: Bucket #, Bucket Name, Sub-Angle Code, Sub-Angle Name, Hook Copy, Target Demo, Format Recommendation, Priority Tier, Concept Formula, Deploy Week. Example row: MBM-01 / The Metabolism Betrayal / 1C / Doing Everything Right / "I walk 10,000 steps. I eat salads. I still can't lose weight."
futurhealth-top5-creative-briefs.md	15.5 KB	Mar 10	Top 5 production-ready creative briefs	For Sean Duran, ready for AI tools → storyboard → Meta launch. Brief 1: MBM-21B "Pill vs Shot" (no injections, $114 CPA proven); Brief 2: MBM-01C "Doing Everything Right" (metabolism betrayal, largest female segment); Briefs 3–5 cover additional high-conviction angles. Each includes full storyboard (timestamp-by-timestamp for video), static layout spec, Meta ad copy, target audience, compliance notes
futurhealth-lead-scoring-model.md	4.0 KB	Mar 17	Lead scoring model v1	Based on 5,513 purchases × 2,996 zip codes (30-day window). Scoring: Zip income (40%), Funnel stage (30%), Gender (15%), Age (15%). Key findings: $80K+ zip CVR 9.1% vs 6.7% under $80K; Women 55-64 = 31% of purchases at $339 CPA; Men cheapest CPA ($340). Tier definitions: T1 HOT (70-100 pts), T2 WARM (50-69), T3 COOL (30-49), T4 NURTURE (0-29). Implementation: swap state → zip in quiz
braze-deep-dive.md	6.3 KB	Mar 11	Braze CRM audit & angle-matched messaging plan	Inventory: 149 canvases (100 active); 8 cart abandon flows; 2 broken post-purchase journeys (0 entries each). Critical findings: (1) NO UTM/ad source data in Braze — all messaging one-size-fits-all; (2) gender is the only personalization variable; (3) post-purchase retention flows are dead; (4) SMS links to plus.fh.co (different domain than acquisition funnel). Proposed: 5 segment-specific cart abandon sequences tied to landing page angle; engineering ask to pass landing_page_slug + utm_campaign as Braze custom attributes
order-bump-test-tracking.md	7.5 KB	Mar 17	Order bump A/B test — daily log	Test launched ~Mar 10; Wegovy Pill checkout only; $49 Concierge Premium add-on. Pre-test baseline: AOV ~$270-290, ATC→Purchase 24.8%. 7+ days of intraday data logged. Key findings: bump attach rate 5-11%; AOV impact mixed (baseline often slightly negative vs control due to MICRO route mix); upsell rate climbed to 36.5% by Day 6 (2x baseline); checkout CVR stable — no friction detected

---

Automation Scripts

Executable scripts in scripts/ — automation tooling for funnel monitoring and API integrations.

scripts/funnel-watch-cron.sh

• Purpose: Continuous GitHub commit monitor with PostHog cross-reference alerting
• Trigger: cron job, every 30 minutes
• What it does: Polls latest commits on funnel, funnel-cms, landing-pages, checkout repos via GitHub API; compares against a state file (memory/github-watch-state.json) to detect new commits; formats a change summary; writes an alert to memory/pending-funnel-alert.md for Sam to pick up on next heartbeat; logs all changes to memory/funnel-changes.md
• API/Services: GitHub API (FuturHealth org), reads PostHog context on next heartbeat
• Note: Contains a hardcoded PAT (legacy, superseded by github-funnel-monitor.sh which reads from .env.credentials)

scripts/github-funnel-monitor.sh

• Purpose: Primary GitHub funnel change monitor — cleaner version of funnel-watch-cron.sh
• Trigger: Called by Sam during 3× daily heartbeat windows
• What it does: Same repos as above; reads GITHUB_PAT_TAGIATELLE from env or .env.credentials; detects new commits per repo; appends timestamped change entries to memory/funnel-changes.md; outputs NEW_CHANGES_DETECTED or NO_CHANGES for Sam to act on
• API/Services: GitHub API (FuturHealth org, 4 repos: funnel-cms, funnel, landing-pages, checkout)
• Output: memory/funnel-changes.md, stdout summary

scripts/google-auth.js

• Purpose: Google OAuth2 token management utility
• Trigger: Run manually when setting up or refreshing Google API credentials
• What it does: Supports 3 modes — auth-url (generate OAuth consent URL for Gmail + Calendar scopes), exchange <code> (swap authorization code for access + refresh tokens, saves to config/google/token.json), refresh (use stored refresh token to get new access token)
• API/Services: Google OAuth2 (oauth2.googleapis.com); scopes: Gmail (read/send/modify) + Calendar (read/events)
• Config files: config/google/credentials.json, config/google/token.json

scripts/posthog_sankey.py

• Purpose: PostHog funnel query tool — generates Sankey-style flow data per conversion path
• Trigger: Run manually when analyzing funnel performance
• What it does: Queries PostHog FunnelsQuery API for the Wegovy Pillform $198 funnel (7-day window); runs once overall and once per path (WEGO-PILL, SEMA, MICRO, NUTRITION) with URL filters; prints step-by-step counts, drop rates, and an ASCII Sankey tree showing flow from landing page → quiz → lead → results → ATC → order → purchase
• API/Services: PostHog API (us.posthog.com, project 98417, personal API key)
• Key events tracked: conv_landing_page_view, achieve_screen_loaded, conv_lead, Results Page (URL-filtered), conv_add_to_cart, conv_order_page_viewed, conv_purchase

---

Braze Audit Tooling

Four Node.js scripts created March 13 to audit Braze user profiles — investigating whether leads were receiving the correct onboarding sequences post-purchase.

braze-audit.js

• Purpose: Initial Braze user profile field explorer
• What it does: Reads user_ids.txt; calls Braze /users/export/ids API for first user; prints all available fields and their types; checks canvas_variant_history and campaigns_received structure. Used to understand what data Braze exposes before writing the full audit
• Target canvases: [SMD] Welcome (RX) - Async Eligible, [SMD] Welcome (RX) - Async Ineligible, Account Completion Nudge
• API: Braze REST API (rest.iad-02.braze.com)

braze-audit-full.js

• Purpose: Full batch audit of user comms receipt
• What it does: Processes all users in user_ids.txt in batches of 50 (Braze API limit); exports canvas and campaign receipt history; checks which of the 3 target canvases each user received; generates summary: users found vs. not found in Braze, per-canvas receipt rates, zero/one/multiple match breakdown, full frequency table of all canvases seen by the cohort; saves results to comms-audit-results.json
• API: Braze REST API; fields: external_id, canvases_received, campaigns_received, email, first_name, last_name
• Output: comms-audit-results.json

braze-check-fields.js

• Purpose: Broad field discovery — export user with no field filter
• What it does: Calls Braze export API with no fields_to_export to see everything returned by default; prints each field name, type, and a sample value. Diagnostic script for understanding Braze's default export schema

braze-check-fields2.js

• Purpose: Comprehensive field check with explicit list
• What it does: Same as braze-check-fields.js but requests an explicit set of fields: external_id, braze_id, email, first_name, last_name, campaigns_received, canvases_received, canvas_variant_history, custom_attributes, custom_events, devices, total_revenue, purchases. Prints each returned field with type and sample

---

Data Files

Audience lists, audit results, and ad performance data. Contents not read.

File / Directory	Type	Purpose	Size
data/meta-audiences/all-wegovy-pill-leads.csv	CSV	All Wegovy Pill leads (for Meta Custom Audience upload)	372 KB
data/meta-audiences/leads-no-purchase.csv	CSV	Leads who did not convert to purchase (retargeting audience)	368 KB
data/meta-audiences/purchasers-jan1-onward.csv	CSV	All purchasers since Jan 1 (Lookalike Audience source)	377 KB
data/meta-audiences/pill-purchasers-jan1-onward.csv	CSV	Wegovy Pill-specific purchasers since Jan 1	78 KB
data/meta-audiences/purchasers-lookalike-source.csv	CSV	Smaller curated list for 1% Lookalike seeding	4.7 KB
braze_leads_50_march15.csv	CSV	50-user Braze lead sample from March 15 (spot-check data)	3.6 KB
comms-audit-mar12.csv	CSV	Raw comms audit input data from March 12 (96 records)	5.5 KB
comms-audit-results.json	JSON	Full Braze comms audit output from braze-audit-full.js	59.2 KB
user_ids.txt	TXT	List of 95 user IDs used as input for Braze audit scripts	2.7 KB
futurhealth-micro-bucket-hooks-150.csv	CSV	Complete 150-hook library (see Strategy section above)	41.5 KB

---

Media & Document Assets

Non-text files — ad creative assets and a research document.

File	Type	Purpose	Size
ad-data-fhvi754.png	PNG	Performance data screenshot for ad creative FHVI-754	135 KB
ad-data-fhvi764.png	PNG	Performance data screenshot for ad creative FHVI-764	115 KB
spritesheet-fhvi754.jpg	JPG	Spritesheet of frames from ad FHVI-754 (for creative analysis)	155 KB
spritesheet-fhvi764.jpg	JPG	Spritesheet of frames from ad FHVI-764 (for creative analysis)	204 KB
glp1-high-velocity-creative-engine.pages	Pages	Apple Pages document — GLP-1 high velocity creative engine (likely framework/process doc)	703 KB
round-one-survey-learnings.pdf	PDF	Customer survey learnings — Round 1 (July 2025 survey, referenced throughout strategy docs)	1.4 MB
comms-audit-mar12-raw.html	HTML	Raw HTML stub from comms audit (38 bytes — empty/stub)	38 B

---

Auth & Credentials

.env.credentials (2.7 KB, Mar 17) — Primary credentials store. Contains API keys and tokens for all connected services. DO NOT read, log, or transmit contents. Based on TOOLS.md, the following services have credentials stored here:

• PostHog: POSTHOG_API_KEY (phc_ project key) + POSTHOG_PERSONAL_API_KEY (phx_ — used for all API queries)
• Meta Ads: META_ACCESS_TOKEN
• Braze: BRAZE_API_KEY
• NorthBeam: NORTHBEAM_API_KEY
• Higgsfield (AI video): API Key + API Secret
• Shotstack (video compositing): API Key + Owner ID
• Looker: LOOKER_CLIENT_ID + LOOKER_CLIENT_SECRET
• GitHub: Multiple PATs including GITHUB_PAT_TAGIATELLE (broadest access, 74 repos) + recovery codes

.env.northbeam (112 B, Mar 9) — Separate credentials file for NorthBeam attribution API. Smaller/isolated from main credentials file.

---

Memory System

Sam's session continuity lives in the memory/ directory. All files are in Markdown except the state JSON.

File	Size	Purpose
memory/2026-03-03.md	609 B	Day 1 session notes
memory/2026-03-05.md	2.3 KB	Session notes
memory/2026-03-06.md	8.6 KB	Detailed session notes — creative strategy day
memory/2026-03-07.md	3.9 KB	Session notes
memory/2026-03-08.md	2.3 KB	Session notes
memory/2026-03-09.md	2.2 KB	Session notes
memory/2026-03-10.md	12.4 KB	Detailed session notes — micro-bucket map creation day
memory/2026-03-11.md	8.1 KB	Detailed notes — Braze deep dive + order bump launch
memory/2026-03-12.md	11.6 KB	Detailed notes — comms audit + SEMA→MICRO reroute
memory/2026-03-13.md	1.3 KB	Session notes
memory/2026-03-14.md	1.7 KB	Session notes
memory/2026-03-15.md	4.4 KB	Session notes
memory/2026-03-16.md	2.5 KB	Session notes — lead scoring model
memory/2026-03-17.md	9.6 KB	Detailed notes — checkout/funnel releases, coupon banner
memory/2026-03-18.md	1.7 KB	Session notes
memory/funnel-changes.md	13.7 KB	Funnel change log — auto-appended by github-funnel-monitor.sh; tracks commits to funnel-cms, funnel, landing-pages, checkout with impact assessments. Covers Mar 9–18: 20+ significant commits logged including SEMA→MICRO reroute, LP revert, declination modal, coupon banner, express pay feature flag
memory/github-watch-state.json	107 B	State file tracking last-seen SHA for each monitored repo

---

Node.js Config

File	Contents
package.json	Two dependencies: googleapis ^171.4.0 (for Google API access), xlsx ^0.18.5 (for spreadsheet parsing). Minimal config — no scripts defined
package-lock.json	41.8 KB — locked dependency tree

---

Workspace Git Repository

The workspace at /Users/fireharp/Prog/FH/fh-claw/.openclaw/workspace/ contains its own .git directory, making it an independent version-controlled repository. This is separate from any parent repo. Sam commits its own work products here, maintaining a historical record of all strategy documents, scripts, and memory files. Last commit activity: March 12, 2026 (per .git directory modification date).

---

Summary Table

Category	Files	Total Size (approx.)
Agent configuration	9 files	~44 KB
Strategy & analysis documents	11 files	~172 KB
Automation scripts	4 scripts in scripts/	~15 KB
Braze audit tooling	4 JS files	~18 KB
Data files	10 files / 1 directory	~1.3 MB
Media & document assets	7 files	~2.7 MB
Memory system	17 daily notes + 2 support files	~103 KB
Credentials	2 env files	~2.8 KB
Node config	2 files	~42 KB
Total	~67 items	~4.4 MB

Services Sam Has Active Access To

Service	Purpose	Status
PostHog	Funnel analytics (project 98417)	Active
Meta Ads	Paid acquisition (efunnel #7)	Active
Braze	Email + SMS CRM (iad-02)	Active
GitHub	FuturHealth codebase monitoring (74 repos)	Active
Google (Gmail + Calendar)	Email/calendar access for John	Active
NorthBeam	Multi-touch attribution	Partial (spend/orders work; attribution endpoints 403)
Looker	Business intelligence (~160 dashboards)	Active (read-only)
Higgsfield	AI talking-head video generation	Active
Shotstack	Video compositing/editing	Active
TikTok Ads	Paid acquisition	Not yet connected