executionpartner.ai redesign — session handoff

Last updated 2026-08-04 · delete this file before merging to main.

Where things stand

Repo: Execution-Partner-AI/egp-site, local clone ~/code/egp-site
Branch: redesign/ai-os — PR #8 (all work lives here; NEVER push main)
Preview: https://deploy-preview-8--executegp.netlify.app (Netlify deploy preview, rebuilds on every push; site name executegp)
Hosting: Netlify (NOT Vercel). Build = npx eleventy, publish _site, redirects in _redirects
Local dev: npx eleventy then cd _site && python3 -m http.server 8923 (or npm start for eleventy --serve)
Session memory also persists in Claude memory: egp-site-redesign-ai-os.md — a fresh chat auto-loads the index.

Stack & architecture

Eleventy 3 (Nunjucks), no framework. Everything data-driven:

Piece	File(s)
App catalog (24 apps, 4 categories, agent copy)	`_data/apps.js`
App one-pager extras (stats + 3 illustrated sections each)	`_data/appExtras.js`
Industries (14, 3 groups)	`_data/industries.js`
Industry extras (day-timeline + 2 sections each)	`_data/industryExtras.js`
Release notes (AHQ 1.1.N versioning)	`_data/releases.js`
App/industry/release page templates (paginated)	`app-pages.njk`, `industry-pages.njk`, `release-pages.njk`
Nav + mega-drawers (Atlas HQ carries the apps drawer)	`_includes/header.html`
Footer (+ socials)	`_includes/footer.html`, `_includes/socials.html`
EKG signal divider (dark hero → white body bridge)	`_includes/signal.html`
Viz component library (10 CSS product vignettes)	`_includes/viz.njk`
Post layout (insights + editorial system)	`_layouts/post.html`
All styling (~2000 lines, token system at top)	`assets/css/main.css`
All behavior (progressive enhancement, `html.js` gated)	`assets/js/main.js`
Generated artwork (40+ SVG covers, client logos)	`assets/images/art/`, `assets/images/clients/`

Design system: void #030B18 ground, EP Navy #0B1F3A, amber #F59E0B = action/money ONLY, teal #14B8A6 = live/data ONLY, paper #F6F8FB. Archivo variable (display = 900 weight + font-stretch:125%), JetBrains Mono strictly for data/labels. Headlines end with amber period. Page pattern everywhere: dark hero (+ orbit ornament) → signal divider → white sections → dark final CTA.

Site map

/ — hero (Execution Feed terminal + circuit canvas), metric band, Our Clients logo wheel, apps marquee, 3-product architecture, 4 flow narratives w/ vignettes, pillars, pricing, integrations, community teaser, final CTA
/atlas-hq/ — flagship: hero → AIOS learning-loop diagram → split row (copy + agency-mode diagram) → Odoo-style 17-tile clickable Nexus feature grid → centered CTA. (Apps tab was MERGED into Atlas HQ; /apps/ 301s to /atlas-hq/#apps; one-pagers keep /apps/<slug>/)
/industries/ + 14 one-pagers (/industries/carpet-cleaning/ etc.)
/community/ — Learn (insights posts, tutorials-coming, in-platform) + Collaborate (GitHub/Forum/Events/Partner cards w/ art) + socials row + white centered join form
/community/insights/<slug>/ — 2 restored posts, editorial treatment (white body, drop cap, TOC scrollspy, progress bar, signal divider)
/community/releases/ahq-1-1-1/ — versioned release notes w/ category filter chips + NEW/IMPROVED/FIXED badges
/partners/ (footer-only link), /pricing/, /implementation/, /contact-us/ (Netlify form), legal pages, 404

Load-bearing gotchas (violate at your peril)

Asset cache-busting: netlify.toml serves CSS/JS as immutable, 1yr. assetVersion global (.eleventy.js) appends ?v= in base.html. Never remove — returning visitors get stale CSS otherwise.
Pagination templates need addAllPagesToCollections: true or sitemap only gets page 1.
eleventyComputed titles double-escape entities — use `` inside computed front matter strings.
_redirects order matters — specific /blog/<slug>/ rules sit ABOVE the /blog/* wildcard.
Progressive enhancement contract: nothing may gate visibility on JS or animation end-states. Hide/reveal states live behind html.js classes; prefers-reduced-motion restores any animation-gated opacity (see the reduced-motion block in main.css).
.aios-wrap auto-margins shrink grid items to the SVG's intrinsic 300px — .aios-compact fixes it for the split-row instance. Beware when reusing.
Automation-browser screenshots freeze CSS transitions — reveals look stuck at ~3% opacity in captures. It's a capture artifact, NOT a site bug. Verify via computed styles, or inject html.js .rv{opacity:1!important;transition:none!important} before screenshotting.
Orbit ornament is JS-injected into .page-hero and .post-header.with-orbit (main.js). Homepage hero has its own canvas instead.
Nunjucks supports ===, is odd, groupby. Data files are CJS (module.exports).

Pending / owner flags (also in PR #8 body)

Pricing now follows GTM-2026-001 (the 8/5 playbook, PENDING Friday founder sign-off): two-track toggle — business (Atlas Core $199 / Pro $399 popular / Command $699 + DFY rail) and agency (Agency Launch $499 / Growth $999 popular / Partner let's-talk). Trial = card on file, 14 days, usage at cost (every "no credit card" claim removed sitewide). Setup rule: self-serve $0, DFY from $1,500. Atlas Intelligence = Command/Partner-only add-on rail, NO public prices (indicative ranges are internal). Toggle is PE-safe: no-JS renders both tracks stacked; /pricing/#agency deep-links.
Security claims on the home "Built different" band are deliberately modest — playbook says Glenn Dardick reviews before harder claims ship
site.signupUrl = https://app.executionpartner.ai/sign-up — route never verified against Clerk
Legal pages need counsel review (internal VERIFY notes stripped, effective date set Aug 2026)
Release-notes live feed: _data/releases.js fetches from atlas-hq prod release_notes (PostgREST) when RELEASE_NOTES_SUPABASE_URL + RELEASE_NOTES_SERVICE_KEY are set in Netlify env + a build hook fires on publish — not configured yet; bundled fallback carries AHQ 1.1.1. Next release = pin in VERSIONS map or let auto-increment name it 1.1.2.
Socials: site.socials in .eleventy.js — GitHub real, X/LinkedIn/YouTube/Instagram/Facebook are # placeholders
Tutorials on Community are honest "coming soon" cards — swap in real links when published
Client logos: McDonald's + Chem-Dry are trademarks used to name client relationships — owner confirms permission at merge. Hardesty uses reverse-white logo on navy tile; Obsidian Labs monolith is an original SVG per their brand kit (assets/images/clients/)
Old blog posts 301 from /blog/<slug>/; hq-table + nexus-frame CSS are dormant (experiments rolled back) — safe to delete or reuse

Recipes

App catalog PARITY RULE: exactly one app per feature tab on the Nexus side rail (atlas-hq src/lib/nexus/feature-catalog.ts — 17 tabs as of 2026-08-04). Features living INSIDE a tab (missed-call text-back → Automations; funnels/forms/SEO/brand kit → Websites) are sold on the parent app's page, never as standalone apps. When atlas-hq adds/retires a rail tab, mirror it here (+ a 301 in _redirects for removals).
Add an app: extend _data/apps.js + _data/appExtras.js (stats + 3 sections + viz specs). Drawer, catalogs, sitemap, one-pager all generate. Add its tile to the Atlas HQ grid, then npm run og.
Add an industry: _data/industries.js + _data/industryExtras.js + drawer updates itself. Give long names a short field (feed titlebar + flow eyebrows use it); optional proof field renders a mono proof line. Then npm run og.
OG cards: npm run og (satori+sharp, scripts/generate-og.mjs, fonts vendored in scripts/fonts/) regenerates the 45 committed PNGs in assets/images/og/ — they are NOT built on deploy, so re-run after adding pages or changing tag lines. Per-page wiring = ogImage front matter / computed key; everything else falls back to og-default.png.
Add a release note: append to BUNDLED in _data/releases.js (entries take cat + type: NEW|IMPROVED|FIXED), push. Or wire the env vars for auto.
Swap a client logo: drop file in assets/images/clients/, edit the tile <img> in index.html (.client-tile, .dark variant for white logos).
Ship: commit to redesign/ai-os, push, Netlify auto-builds the PR preview (~45s). Verify with curl against the preview URL.

Owner taste notes (learned the hard way)

Explanatory diagrams for concepts (AIOS loop, agency mode) — clean icon grids for feature lists (tried an interactive workspace-frame diagram for Nexus features; owner rolled it back to icons). Rejected a GHL-style comparison table. Hero stays navy; content sections white ("the Insights pages are literally perfect" — that's the canonical look). No emojis as icons anywhere. Everything centered means everything centered (watch lede blocks pinned left inside centered heads — fixed globally via .sec-head.center .lede{margin-inline:auto}).