marketing: make Marginal obvious in five seconds

docs/superpowers/plans/2026-08-18-marketing-refactor.md

@@ -0,0 +1,47 @@
+# MARGINAL Marketing Refactor Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Make MARGINAL obvious in five seconds, visually demonstrable at €0 inference cost, SEO-complete and claim-safe.
+
+**Architecture:** Message-first static site, dedicated deterministic demo, marketing-first README, local SVG/PNG assets and lightweight vanilla JS.
+
+**Tech Stack:** HTML5, CSS3, vanilla JavaScript, SVG, PNG, Markdown, GitHub Pages.
+
+**Spec:** `docs/superpowers/specs/2026-08-18-marketing-refactor-design.md`
+
+## Global Constraints
+- Preserve evidence-first claim discipline.
+- No causal token-savings claim from the historical smoke.
+- Codex = Tool Enforcement; Claude Code/OpenCode/PrivacyCode = Observe-only.
+- No new site runtime dependencies.
+- Respect `prefers-reduced-motion`.
+
+---
+
+### Task 1: Acceptance tests
+- [x] Add structural SEO/copy/truthfulness/asset/accessibility tests.
+- [x] Verify RED before implementation.
+
+### Task 2: Homepage
+- [x] Build Hero → Demo → How it works → Integrations → Proof → Research → FAQ → CTA.
+- [x] Add accessible nav, copy CTA and deterministic trace replay.
+
+### Task 3: Visual assets
+- [x] Add 1280×640 README hero SVG.
+- [x] Add 1200×630 OG/Twitter PNG.
+- [x] Add shareable `/demo/` page.
+
+### Task 4: README
+- [x] Put concrete problem, visual explanation and install above technical detail.
+- [x] Keep exact enforcement/privacy/research boundaries.
+
+### Task 5: SEO + deploy pack
+- [x] Update robots/sitemap.
+- [x] Add apply, verify and deploy instructions.
+
+### Task 6: Verification
+- [x] Marketing acceptance tests pass.
+- [x] JS syntax passes.
+- [x] Static link/JSON-LD checks pass.
+- [x] ZIP integrity checked.

docs/superpowers/specs/2026-08-18-marketing-refactor-design.md

@@ -0,0 +1,28 @@
+# MARGINAL Marketing Refactor — Design Specification
+
+## Goal
+Make MARGINAL understandable in five seconds and compelling enough to earn GitHub stars without overstating unproven performance claims.
+
+## Positioning
+Primary category: **runtime governor for AI coding agents**. Primary problem: **AI agents can repeat work without making progress**. Primary promise: **MARGINAL detects no-progress repetition**. Primary differentiator: **MARGINAL starts by observing and must earn limited enforcement authority from evidence.**
+
+Canonical message stack:
+1. **AI agents repeat work that changed nothing.**
+2. **MARGINAL catches it.**
+3. **Observe first. Prove waste. Earn enforcement.**
+
+## Experience hierarchy
+Hero → deterministic mechanism demo → How it works → Integrations → Proof → Research → FAQ → Install CTA.
+
+## Claim discipline
+- Never claim the historical 24.93% token delta was caused by MARGINAL.
+- State the smoke was 0/3 vs 0/3 and no deny was applied.
+- Label the deterministic visual demo as not a production benchmark.
+- Codex is Tool Enforcement, never Full Compute Enforcement.
+- Claude Code, OpenCode and PrivacyCode are Observe-only.
+
+## SEO
+One H1; canonical `https://signallayerlabs.github.io/Marginal/`; intent-focused title/description; OG/Twitter 1200×630 image; SoftwareApplication + FAQPage JSON-LD; semantic sections; robots.txt and sitemap.xml.
+
+## Visual language
+Dark technical canvas, acid-green action accent, red only for waste, mono trace labels, strong contrast, responsive panels, no external font dependency, motion disabled under prefers-reduced-motion.