Docs Plan
Overall Progress 0 / 0 tasks

Supergentic Docs Transfer Plan

Rebuild the supergentic documentation system to match the stitchwand standard. This plan walks you through analyzing the codebase, generating standardized docs with orange branding, consolidating strategy materials, and setting up automated nightly updates.

📱 Supergentic

AI-powered marketing operations platform for Salesforce Marketing Cloud.

  • React 19 SPA (Vite + Tailwind + React Router)
  • 15+ pages, 30+ components
  • 5 AI agents + Command console
  • Multi-step wizard system
  • Heavy Salesforce integration (simulated)
Orange Brand #FE9339

🎨 Design System

Supergentic-specific brand and design tokens.

  • Accent: #FE9339 (orange)
  • Dark variant: #E57C00
  • Background: #0A0A0A
  • Fonts: Inter + SF Mono / Fira Code
  • Secondary: green, purple, blue, cyan
Company: Dilshaus Ventures

📚 Existing Docs

Current documentation inventory (may be outdated or inconsistent).

  • 10+ self-contained HTML files
  • 3+ markdown planning docs
  • Portal with auth gate (sg-auth)
  • Varied design + no standardization
  • Some docs may be stale
Needs Cleanup

✨ Goals

What we're achieving with this plan.

  • Standardized design system (orange)
  • Consolidated strategy materials
  • Complete codebase documentation
  • Stealth marketing tab + warning modal
  • Nightly automated updates
Quality First

🔐 Authentication

Secure access to sensitive documentation.

  • sessionStorage key: sg-auth
  • Password: next
  • URL bypass: ?auth=next
  • Portal gates all sensitive docs
  • Stealth marketing behind modal gate
Password Protected

🚀 Process

5-step workflow from analysis to automation.

  • Install make-docs skill
  • Analyze codebase & existing docs
  • Generate + rebuild all docs
  • Validate + fix errors
  • Commit + schedule automation
5 Steps Total

Next Steps

Head to the Prompts tab to copy the exact commands to run in Claude Code / Cowork. Then use the Checklist to track your progress through each phase.

Copy-Paste Prompts

Each prompt below is ready to copy. Use these in Claude Code or Cowork to rebuild the supergentic docs. Start with Prompt 1.

Install the make-docs skill
Install the make-docs skill from ~/dev/stitchwand/docs/make-docs.skill
Full codebase analysis + doc plan
Use the make-docs skill in MAKE mode on this repo.

## Context
This is **supergentic** — an AI-powered marketing operations platform for Salesforce Marketing Cloud. It's a React 19 SPA (Vite + Tailwind + React Router) with no backend. The app has 15+ pages, 30+ components, 5 AI agents, a Console with command palette, and a multi-step wizard system. Heavy Salesforce integration planned but currently simulated.

## Brand / Design System
- **Accent color**: `#FE9339` (orange), dark variant `#E57C00`
- **Background**: `#0A0A0A`
- **Font**: Inter (sans), SF Mono / Fira Code (mono)
- **Auth**: sessionStorage with `sg-auth` key, URL param `?auth=next`, password "next"
- **Company**: Dilshaus Ventures / The Fieldhaus
- **Copyright**: 2026
- **Secondary colors**: green `#45C65A`, purple `#9050E9`, blue `#1B96FF`, cyan `#00BDD6`

## Existing Docs
There is already a `/docs` directory with 10+ self-contained HTML files:
- `index.html` (portal with auth gate)
- `pitch.html`, `demo.html`, `demo-script.html`
- `launch-plan.html`, `technical-architecture.html`
- `ai-strategy.html`, `go-to-market.html`
- `design-system.html`, `research-sfmc-flows.html`
- `paid-ads.html`

Plus markdown planning docs:
- `solidify.md` — feature audit and solidify sprint results
- `console-feature-spec.md` — Console feature specification
- `salesforce-cloud-integration.md` — Salesforce multi-cloud integration roadmap

## What I Want
1. **Analyze the full codebase** — read every source file, component, page, data model, config. Understand what's real vs. simulated.
2. **Analyze existing docs** — read each HTML doc, understand its structure, assess if it's current or stale.
3. **Identify gaps** — what docs are missing? I expect at minimum: Onboarding guide, Strategy consolidation (merge ai-strategy + go-to-market + paid-ads into tabbed strategy.html), Stealth marketing + organic social proof tab, Updated architecture doc.
4. **Present a doc plan** — show me what you'll generate and what you'll update before doing it.

Do NOT generate anything yet. Just analyze and present the plan.
Proceed with the doc plan
Proceed with the doc plan. Generate and rebuild all docs using the orange `#FE9339` design system.

Every doc must:
- Use the standardized two-level sticky nav with glass-morphism (global nav + section nav)
- Include the global nav with brand badge (use orange instead of purple for supergentic)
- Standard nav links: Pitch, Demo, Architecture, Strategy, Vision, Launch Plan, Open App
- Use `sg-auth` password gate (password: "next", sessionStorage key: `sg-auth`, URL bypass: `?auth=next`)
- Use `#FE9339` accent throughout
- Be accurate to the actual codebase
- Include screenshots if the app is running (check localhost:5173)

For strategy.html — consolidate into tabs: AI Strategy, GTM, Growth, Paid Ads, Stealth Marketing. Include the stealth marketing warning modal gated by sessionStorage.

For launch-plan.html — use the task checkbox system with sidebar, expandable sections, auto-collapse, export/import, and sidebar detail panel with Claude Code prompts.
Run validation on all docs
Run validation on all docs in /docs:

1. HTML validity — well-formed tags
2. Link integrity — all internal href targets exist
3. Image references — all img src files exist
4. No placeholder text — no {{MARKERS}}, TODO, FIXME, SCREENSHOT NEEDED
5. Design system compliance — Google Fonts loaded, dark theme, viewport meta
6. Portal consistency — all docs linked from index.html
7. Nav consistency — every doc has the same global nav links
8. Auth gate — portal and sensitive docs use sg-auth sessionStorage

Fix any errors found. Report warnings.
Commit all docs changes
Commit all docs changes:

1. Create branch: docs/make-docs-rebuild-$(date +%Y%m%d)
2. Stage all changes in docs/
3. Commit: "docs: rebuild all documentation with make-docs skill — orange design system, consolidated strategy, stealth marketing, standardized nav"
4. Push and create PR with summary of what changed
Set up nightly 3am scheduled task
Set up a nightly 3am scheduled task for supergentic docs:

- Task ID: supergentic-docs-update
- Schedule: 0 3 * * * (daily at 3am)
- Use make-docs skill in UPDATE mode
- Repo: ~/dev/supergentic
- Brand: orange #FE9339, auth sg-auth/next
- If changes detected: update affected docs, recapture screenshots, validate, commit + PR
- If no changes: log "supergentic docs are current" and exit
New Cowork session context
I'm Brian from Dilshaus Ventures. I need to rebuild the documentation for my project **supergentic** using the make-docs skill.

## What is supergentic
AI-powered marketing operations platform for Salesforce Marketing Cloud. React 19 SPA (Vite + Tailwind + React Router), no backend. 15+ pages, 30+ components, 5 AI agents, Console with command palette, multi-step wizard. Repo at ~/dev/supergentic.

## What I need
1. Select folder ~/dev/supergentic
2. Install the make-docs skill from ~/dev/stitchwand/docs/make-docs.skill (or it may already be installed)
3. Run make-docs in MAKE mode — analyze the codebase, detect gaps, present a plan
4. After I approve, generate all docs with orange #FE9339 branding
5. Consolidate strategy docs into tabbed strategy.html (AI Strategy, GTM, Growth, Paid Ads, Stealth Marketing)
6. Add stealth marketing with warning modal
7. Validate everything
8. Commit + PR
9. Set up nightly 3am update schedule

## Brand details
- Accent: #FE9339 (orange), dark variant #E57C00
- Background: #0A0A0A
- Fonts: Inter + SF Mono/Fira Code
- Auth: sessionStorage sg-auth, password "next", URL bypass ?auth=next
- Company: Dilshaus Ventures / The Fieldhaus
- Secondary: green #45C65A, purple #9050E9, blue #1B96FF, cyan #00BDD6

## Reference
The stitchwand docs at ~/dev/stitchwand/docs/ are the gold standard. Match that quality and design system but with orange branding. Key files to reference: strategy.html (8-tab consolidated), launch-plan.html (task system with sidebar), demo.html (5-tab with filter pills).

Start by selecting the supergentic folder and running the analysis.

Task Checklist

Track your progress through each phase. Tasks are saved automatically to localStorage.

Setup

0/3 done

Analysis

0/3 done

Generation

0/6 done

Validation

0/3 done

Automation

0/3 done

Supergentic Design System

Quick reference for colors, fonts, and branding standards. Use these tokens throughout all regenerated docs.

Color Palette

Accent
Accent (Primary)
#FE9339
Dark
Accent Dark
#E57C00
Background
Background
#0A0A0A
Success
Success / Green
#45C65A
Purple
Secondary Purple
#9050E9
Blue
Secondary Blue
#1B96FF
Cyan
Secondary Cyan
#00BDD6

Typography

  • Sans-serif: Inter (all weights 400–800)
  • Monospace: SF Mono / Fira Code (for code blocks)
  • Font import: Google Fonts (Inter)
  • Line height: 1.6 (body text), 1.2 (headings)
  • Letter spacing: 0.06em (uppercase labels)

Authentication

  • sessionStorage key: sg-auth
  • Password: next
  • URL bypass: ?auth=next
  • Gate strategy: Portal + sensitive docs require auth
  • Stealth marketing: Additional modal confirmation

CSS Variables Reference

Variable Stitchwand Value Supergentic Value
--accent #6366F1 (indigo) #FE9339 (orange)
--accent-hover #7C3AED #E57C00
--orange #F97316 #FE9339 (primary)
--bg-* Same dark theme Same dark theme

The main difference from stitchwand: change --accent from indigo #6366F1 to orange #FE9339. All other CSS variables remain the same.

Reference & Resources

Links, docs, and architectural reference for the supergentic docs rebuild.

📂 File Locations

~/dev/stitchwand/docs/ — Stitchwand docs (reference)

~/dev/supergentic/ — Supergentic repo

~/dev/supergentic/docs/ — Supergentic docs (target)

🛠 Make-Docs Skill

~/dev/stitchwand/docs/make-docs.skill

Install in Claude Code. Supports MAKE, UPDATE, and VALIDATE modes.

📚 Key Stitchwand Docs

strategy.html — 8-tab consolidated strategy launch-plan.html — Task system with sidebar demo.html — 5-tab demo with filter pills

📖 Architectural Docs

DOCS-ARCHITECTURE.md — How stitchwand docs are structured LAUNCH-PLAN-ARCHITECTURE.md — Launch plan design patterns

🔗 Existing Supergentic Docs

index.html — Portal pitch.html — Product pitch demo.html — Live demo technical-architecture.html — Tech stack ai-strategy.html — AI agent strategy go-to-market.html — GTM strategy paid-ads.html — Ad spend strategy design-system.html — Design tokens

📋 Markdown Docs

solidify.md — Feature audit results console-feature-spec.md — Console spec salesforce-cloud-integration.md — SFMC roadmap

🎯 Key Dates

Plan created: April 9, 2026

Target completion: TBD

Nightly schedule: 3:00 AM UTC

👤 Owner

Brian Dilshaus

Dilshaus Ventures / The Fieldhaus

💡 Tips for Success

  • Reference stitchwand: The stitchwand docs directory is your gold standard. Match its design patterns, component structure, and quality.
  • Orange branding: Search-and-replace all indigo (#6366F1) with orange (#FE9339) from stitchwand templates.
  • Screenshot the app: If supergentic is running locally (localhost:5173), capture screenshots of key pages and embed them in docs.
  • Test auth gates: Verify sg-auth password gate and ?auth=next URL bypass work correctly.
  • Validate links: After generation, test all internal nav links and external references.
  • Stealth marketing: Add a warning modal for sensitive growth / paid ads strategy (gate by sessionStorage).