Timeline

--- name: Devstral Small 2 24B as router model description: Uncle G (Turboware) considering Devstral-Small-2-24B as router/triage model — potential local alternative for complexity routing type: reference originSessionId: 30c97f8e-9b68-4df3-a487-df605b6f502a --- Uncle G shared Devstral-Small-2-24B-Instruct (Mistral) as a potential router model on 2026-05-10. - Model: `mistralai/Devstral-Small-2-24B-Instruct-2512` - Source: https://huggingface.co/mistralai/Devstral-Small-2-24B-Instruct-2512 - Size: 24B params — runnable locally via Ollama on Mac Studio - Purpose: coding-focused, fast triage/routing before sending to larger models **Why:** Could replace or complement the `scoreComplexity()` function in Master Brain's API. Instead of heuristic scoring, a local LLM does intent classification and routes to the right model tier (Haiku for simple, Sonnet for medium, Opus for complex). **How to apply:** Evaluate as Ollama model on Mac Studio. Compare routing accuracy vs current heuristic. If Uncle G adopts it, study his implementation pattern.

# Master Brain — Project Memory Index - [project_supabase_canonical.md](memory/project_supabase_canonical.md) — gmgxxiqgshbbgzhqzngq is the only live Supabase instance, ptkemxcseqxlzilpjmch is dead - [project_hindsight_state.md](memory/project_hindsight_state.md) — Banks wiped 2026-04-22 (43→9, 16K→166 nodes), refeed blocked, Mac local broken, $209/mo cloud - [feedback_check_quota_before_running.md](memory/feedback_check_quota_before_running.md) — Always check Gemini quota before running ingest, don't burn all 8 keys - [project_master_brain_state_2026_04_28.md](memory/project_master_brain_state_2026_04_28.md) — 225K memories, all embedded, chat backups done, embed bug fixed - [project_master_brain_state_2026_05_09.md](memory/project_master_brain_state_2026_05_09.md) — 225K + 5 Brain features built (Uncle G patterns), DB migrated, Agent Extracts mined, uncommitted changes need commit - [project_merlino_forge.md](memory/project_merlino_forge.md) — MerlinoForge coding harness: Claude CLI agents, dark Tactical Ops UI, live at forge.imerlino.com, Understand-Anything plugin installed - [project_session_persistence_build.md](memory/project_session_persistence_build.md) — Build GSD-style auto-compact + pause/resume hooks using Mike's agent team (not GSD's generic agents) - [feedback_no_dark_aesthetic.md](memory/feedback_no_dark_aesthetic.md) — Don't default to dark mode, use clean/light design unless explicitly requested - [feedback_always_full_urls.md](memory/feedback_always_full_urls.md) — ALWAYS include https:// on every URL so it's clickable, never abbreviate - [project_master_brain_visualization_plan.md](memory/project_master_brain_visualization_plan.md) — MANDATORY multi-view viz plan: Neo4j + yFiles + Graphistry + Memgraph + Jarvis, all non-optional - [project_master_brain_state_2026_05_10.md](memory/project_master_brain_state_2026_05_10.md) — Jarvis + force graph live, Neo4j importing (9K/287K), Graphistry connected, mandatory plan locked

--- name: Master Brain state as of 2026-05-10 description: 287K memories, Jarvis 3D + force graph deployed, Neo4j Aura + Graphistry Hub connected, multi-view viz plan locked in as mandatory type: project originSessionId: 30c97f8e-9b68-4df3-a487-df605b6f502a --- ## Master Brain — State Snapshot (2026-05-10) **Branch:** master **DB:** Supabase `gmgxxiqgshbbgzhqzngq`, table `memories` (287,450 rows) **Neo4j:** Aura free instance `fae68e2d` — 9K/287K memories imported (import was running) **Graphistry:** Hub free tier connected (key: BMA3P5A056) ### What's Live - https://master-brain.vercel.app — Brain Chat (RAG search) - https://master-brain.vercel.app/graph — Force Graph 3D (light design, 250 scopes) - https://master-brain.vercel.app/jarvis/index.html — Jarvis holographic 3D (hand tracking) ### Commits This Session - `e78444e` — 3D graph with Three.js + light design - `e2464a1` — sidebar shows total memories per group - `276b424` — Jarvis holographic interface wired to Master Brain ### Mandatory Build Plan (ALL non-optional) Full plan saved in `project_master_brain_visualization_plan.md`: 1. Neo4j graph backend (connected, importing) 2. yFiles layout engine (eval ZIP downloaded) 3. Graphistry GPU viz (Hub connected) 4. Memgraph evaluation 5. Timeline memory replay (Capcut-style) 6. NotebookLLM per project 7. Obsidian vault per project 8. Unified nav across all views ### Key Credentials - Neo4j: `neo4j+s://fae68e2d.databases.neo4j.io` (in .env.local) - Graphistry: personal_key_id `BMA3P5A056` (in .env.local) - Both also in `D:\Download Folder\Neo4j-fae68e2d-Created-2026-05-10.txt` ### User Feedback Saved - No dark aesthetic — use light/clean design - Always full clickable URLs with https:// - No self-hosted graph-app-kit — no server available **Why:** Handoff snapshot — multi-view viz system in progress, Neo4j import running, next step is wire Graphistry. **How to apply:** Read .planning/.continue-here.md for resume details.

--- name: Master Brain multi-view visualization plan description: MANDATORY build plan — Jarvis + Neo4j + yFiles + Graphistry + Memgraph + Louie-style timeline + NotebookLLM + Obsidian vaults per project type: project originSessionId: 30c97f8e-9b68-4df3-a487-df605b6f502a --- ## Master Brain — Multi-View Visualization System (MANDATORY) Mike declared ALL of these non-optional on 2026-05-10. This is the full build plan. ### Louie.ai-Inspired Features (added 2026-05-10, MANDATORY) **Reference:** https://louie.ai/how-it-works/connect-and-go — Mike signed up for early access. #### Timeline Memory Replay - Query: "when did we do X for client Y" → visual timeline of ALL interactions - Every detail: iterations, decisions, agent runs, commits, conversations - **Capcut-style scrubber** — replay project history like editing a video - Play, pause, rewind, scrub to any point in time - See what changed at each moment - Visual diff between iterations - Timeline renders in ALL fancy viz modes (Jarvis 3D, force graph, yFiles, Graphistry) #### NotebookLLM Per Project (MANDATORY) - Every project gets its own AI notebook (like Louie's AI Notebooks) - Project-scoped LLM with full context of that project's history - Natural language queries against project-specific data - Shareable, replayable investigation workflows #### Obsidian Vault Per Project (MANDATORY) - Every project gets its own Obsidian-compatible vault - Markdown knowledge base auto-generated from project activity - Bidirectional sync with Master Brain vectors - Graph view within each vault showing project-internal connections #### Connect-and-Go Data Layer - Connect project data sources (GitHub, Supabase, Vercel, GHL, CallRail) - Unified query layer across all connected sources - GPU-accelerated visualization via Graphistry for large datasets **Why:** Mike wants the most advanced way to interact with his 287K memory knowledge base. Different people learn differently — multiple visualization modes for the same data. Must be far better than Obsidian. ### What's Already Deployed (2026-05-10) 1. **Jarvis 3D Holographic** — `/jarvis/index.html` on https://master-brain.vercel.app - Shoaf's Three.js + MediaPipe hand tracking - Wired to /api/jarvis-tree (scope-level tree) - Big Bang intro, expandable nodes, gesture control 2. **Force Graph 3D** — `/graph` on https://master-brain.vercel.app - react-force-graph-3d, light design, sidebar with toggles - 250 scopes, 273 edges, 287K memories via RPC aggregation 3. **Brain Chat** — `/` on https://master-brain.vercel.app - Conversational RAG search across all 287K vectors ### What Must Be Built #### Phase 1: Neo4j Graph Backend - **Neo4j Aura** (free tier to start) — graph DB with real relationship edges - Import 287K memories as nodes - Create edges based on: shared entities, topic overlap, references, scope relationships - GraphRAG: vector search finds candidates, graph traversal finds context - MCP server so agents can query the graph directly - **Feeds ALL visualization views with real connection data** #### Phase 2: yFiles Layout Engine - Source: `D:\Download Folder\yFiles-for-HTML-Complete-3.0.0.5-Evaluation.zip` (60-day eval) - Add as a view tab in Master Brain (2D interactive graph with layout switching) - Layout algorithms to implement: hierarchical, organic, circular, tree, radial, edge bundling, sankey - Dropdown to switch between layout styles (like the demo at yfiles.com/demos/showcase/layoutstyles/) - Wire to Neo4j data for real edge relationships #### Phase 3: Graphistry GPU Visualization - **Graphistry Hub free tier** ($0/month) — GPU-powered big graph viz - Use PyGraphistry SDK to push Neo4j data to Graphistry - Embed Graphistry investigations via iframe or React component - Handles the massive scale (287K+ nodes) that client-side can't - REST + React embedding supported on free tier #### Phase 4: Memgraph (evaluate) - **Memgraph Cloud** — pay-as-you-go, in-memory graph DB - Compare performance vs Neo4j for real-time traversal - Built-in vector search (could replace Supabase pgvector) - Orb visualization library (open source) - Decision: use alongside Neo4j or replace based on benchmarks #### Phase 5: Polish & Integration - Unified nav bar across all views (Jarvis | 3D Graph | yFiles | Graphistry | Chat) - Each view queries the same Neo4j + Supabase backend - Click a node in ANY view → see its connections in any OTHER view - Search across all views simultaneously - Drill-down: scope group → individual scopes → actual memory content ### Architecture ``` Master Brain UI (Next.js on Vercel) ├── / — Brain Chat (RAG conversational search) ├── /graph — Force Graph 3D (react-force-graph-3d) ├── /jarvis/ — Jarvis Holographic (Three.js + hand tracking) ├── /yfiles/ — yFiles Layout Explorer (2D, algorithm switching) ├── /graphistry/ — Graphistry embed (GPU-powered massive graph) │ ├── /api/brain — Chat API (Claude + vector search) ├── /api/graph — Scope aggregation (Supabase RPC) ├── /api/jarvis-tree — Hierarchical tree for Jarvis ├── /api/neo4j — Graph traversal queries (Cypher) │ └── Backends: ├── Supabase pgvector — 287K embeddings + auth + storage ├── Neo4j Aura — graph relationships + GraphRAG └── Graphistry Hub — GPU rendering for massive graphs ``` ### Resources Available - yFiles HTML eval: `D:\Download Folder\yFiles-for-HTML-Complete-3.0.0.5-Evaluation.zip` - Jarvis source: `D:\Ecosystem\sources\Shoaf Dev\jarvis-ui\` - Neo4j Aura: free tier at https://neo4j.com/cloud/aura-free/ - Graphistry: free tier at https://hub.graphistry.com - Memgraph Cloud: pay-as-you-go at https://memgraph.com/cloud **How to apply:** This is the master plan for Master Brain visualization. Execute in phases. Each phase delivers a new view that works independently. Neo4j (Phase 1) is the foundation everything else builds on.

--- name: SessionDeck Project description: Claude Code session resume dashboard — local tool, potential product, needs premium template reskin type: project originSessionId: 77275474-6742-4bbf-be00-782998b98d6f --- Visual dashboard showing all Claude Code sessions as clickable cards for resuming work after crashes/interruptions. **Location:** `E:\Codex\projects\session-deck\` **Port:** 4567 **Stack:** Next.js 15 (ShipFast-TS base), Tailwind **Status:** V1 functional but generic UI — Mike rejected the look, needs premium template reskin **What it does:** - Scans `~/.claude/projects/` for all JSONL session files (found 749) - Shows cards with project name, first message, time ago, status badges, command badges - Resume button copies `cd <path> && claude --resume <id>` to clipboard - Search and filter (All/Active/Recent/Stale) **Why:** Mike had 7+ terminals crash (BSOD 0x00000139 KERNEL_SECURITY_CHECK_FAILURE) and needed to find/resume all sessions **Next steps:** - Reskin with a premium template from Mike's library (he picks which one) - Potential first SaaS product using ShipFast base - Could add: actual terminal launch, Vercel deployment screenshots, git status badges

- [Local SEO Site Builder](project_local-seo-site-builder.md) — Next.js + Supabase tool: generates full SEO sites, backend complete, frontend pending Bolt - [PAA Content Generator v2](project_paa-content-generator.md) — Netlify tool: locations, deploy, stack, current status - [Gemini CLI Auth Fix](reference_gemini-cli-auth.md) — Valid auth types, token refresh, depleted billing state - [Use Skills for Images](feedback_use-skills-for-images.md) — Always route image gen through nano-banana/before-after/infographic skills - [VisionClaw Project](project_visionclaw.md) — Meta Ray-Ban AI glasses app: config, direct-to-OpenClaw mode added, Gemini credits depleted - [Audits Must Use DataForSEO](feedback_audit-must-use-dataforseo.md) — NEVER use search snippets for audit data; DataForSEO API is mandatory primary source - [Archangel Dashboard Project](project_archangel-dashboard.md) — 10 template variations, DataForSEO audit, GHL snapshot, sales page, comparator - [Use Paid Templates](feedback_dashboard-templates.md) — Always use Mike's 25+ paid premium templates, never build generic - [Hide Template Names](feedback_hide-template-names.md) — Never expose template source names in client/sales materials - [Never Guess Data](feedback_never-guess-data.md) — Browser-verify social, API-verify metrics, mark UNVERIFIED if unsure - [Audit Machine Project](reference_audit-machine.md) — Full Merlino-style 30+ check audit pipeline at audit-machine/ - [Article Length From SERP](feedback_article-length-from-serp.md) — Blog word count must match #1 ranking +10-20%, never arbitrary floor - [No Scrollbars Ever](feedback_no-scrollbars-ever.md) — Never ship visible scrollbars on dashboards, hide with CSS - [Neill & Son Content Package](project_neill-son-content-package.md) — Merlino Magic Blog deployed to V6 dashboard + blog preview page - [Clone Prospect Site Design](feedback_clone-prospect-site-design.md) — Blog previews must clone the prospect's actual website design - [No Blocky Text](feedback_no-blocky-text.md) — Rich formatting required: tables, callouts, step guides, image placeholders, FAQ accordions - [No Google AI API Images](feedback_no-google-ai-api-images.md) — NEVER use Google AI API for images (watermarks). Use FAL AI or Gemini CLI only - [Neill & Son Prospect Audit](project_neil-landson-audit.md) — Full 21-dim audit, 22 DataForSEO endpoints, 6 dashboards, GitHub mmerlino23/neil-landson-audit - [Full Audit Pipeline](feedback_full-audit-pipeline.md) — Complete Merlino-style audit checklist: 22 API endpoints + 16 skills + 3-round QA + static data only - [Visual HTML Explainers](feedback_visual-html-explainers.md) — Always generate styled HTML explainer pages with infographics, never plain text - [GHL Account Inventory](reference_ghl-account-inventory.md) — 10 sub-accounts, 29 snapshots, contacts, funnels, workflows, quality tiers, "FREE TO PAID" is crown jewel - [SKOOL Funnel Audit](reference_skool-funnel-audit.md) — FREE TO PAID snapshot deployment checklist: phone, Stripe, domain, calendars, branding, integrations - [DataForSEO API Reference](reference_dataforseo-api.md) — 468 endpoints across 13 groups; full reference at ~/.claude/reference/dataforseo-api-reference.md - [Orchestra Model](feedback_orchestra-model.md) — Oliver writes brief scores, leads write their own domain plans, Carlos conducts - [White Theme Only](feedback_white-theme-only.md) — Mike only likes white/light theme; never ship dark mode - [LLM Syndication Not Footer](feedback_llm-syndication-not-footer.md) — Explore AI Summary = LLM query syndication, not a footer widget; part of Metehan method - [Metehan AEO Master Skill](project_metehan-aeo-skill.md) — Built /metehan-aeo consolidating full Metehan method from 36 docs + ~15 archived skills - [SSH Aliases for VPS](reference_ssh-aliases.md) — Use aliases (vps1, vps2, mac) not raw IPs; different users/keys per host - [Skill Sync Process](reference_skill-sync-process.md) — tar+scp pattern to sync 488 skills across Windows, Mac, VPS1-3, GitHub - [Hindsight API Access](reference_hindsight-api-access.md) — Hindsight at mac:8888 via Tailscale, no MCP needed, POST /memories with items array - [Metehan Docs Corpus](reference_metehan-corpus.md) — 36 mined docs at _working-on/ecosystem-ingestion, consolidated into /metehan-aeo skill - [Agent Chat Mining Extracts](reference_agent-extracts-archive.md) — 12 agent insight files from 590+ chats at D:\Ecosystem\vaults\chat-backups\Agent Extracts\ - [Chat Mining Operation](project_chat-mining-operation.md) — 12-agent parallel mining completed 2026-05-09, key cross-agent findings - [Merlino Audit Engine](project_merlino-audit-engine.md) — PRD complete, 71 endpoints, clean build pending in merlino-audit-engine/ on northvalleysolarpower.com - [Never Clone Dirty Templates](feedback_no-clone-templates.md) — Always build from PRD, never clone existing client dashboards - [Every Endpoint Must Display](feedback_pull-vs-display.md) — 71/71 endpoints displayed or it doesn't ship - [Pieces Memory Harvest](project_pieces-memory-harvest.md) — Multi-source Pieces extraction: 5 Windows sources + 4 machines, 17,969 unified entries, VPS1 backup mining pending - [Memz Project](project_memz.md) — Unified memory bank: scaffold done, migration NOT applied, 17,969 pre-extracted entries ready to ingest - [PrintingPress + Higgsfield + HeyGen CLIs](reference_printing-press-clis.md) — 31 PP CLIs, Higgsfield (authed, 36 models), HeyGen (needs key), repo at 00_GITHUB/cli-printing-press - [No Timetables in Plans](feedback_no-timetables.md) — Never put "Day 1/2/3" timelines in plans; phases and sequence only - [No Generic Frankie UI](feedback_no-generic-frankie-ui.md) — STOP building generic ShadCN card grids; always start from a premium template - [SessionDeck Project](project_session-deck.md) — Claude Code session resume dashboard at E:\Codex\projects\session-deck\, needs template reskin

--- name: Stop Building Generic Frankie UI description: Mike hates the generic ShadCN/Tailwind card UI that Frankie keeps producing — always use premium templates instead type: feedback originSessionId: 77275474-6742-4bbf-be00-782998b98d6f --- Mike explicitly hates the generic "Frankie style" UI — plain white cards with colored pills and basic shadows. This has been a recurring frustration across multiple sessions. **Why:** The default agent-generated UI looks like "coding terminal bullshit" — generic, forgettable, hard on the eyes. Mike has 25+ paid premium templates and they should ALWAYS be the starting point. **How to apply:** - NEVER let Frankie (or any agent) build UI from scratch with raw ShadCN + Tailwind defaults - ALWAYS show Mike template options from his library FIRST before building - When building any dashboard/app, start from a premium template's actual component system (their sidebar, their cards, their charts) - The "generic card grid with status pills" pattern is specifically what Mike hates — that's what agents default to and it must stop - If building a new tool/product, ask which template to base it on before writing any UI code - Templates at: `D:\ClaudeDev\00_GITHUB\TEMPLATES\admin-dashboards\`, `saas-marketing\`, `ui-blocks\`, `Boilerplates\` - Screenshot gallery at: `D:\ClaudeDev\00_GITHUB\template-gallery\public\screenshots\`

--- name: Memz Project description: Unified memory bank — consolidates all agent/project/domain memories into searchable Supabase store with injection and viewing type: project originSessionId: f7b1b6eb-5ee0-437d-9869-1972869d4f29 --- ## Project Location `D:\ClaudeDev\00_GITHUB\memz\` — Next.js 16 + ShadCN + Tailwind + Supabase ## Current State (2026-05-10) ### Phase 1 (DONE): Scaffold - `src/types/memory-record.ts` — MemoryRecord interface (source, agents[], projects[], domains[], memory_type, embedding) - `src/ingestors/interface.ts` — Ingestor interface (AsyncGenerator<RawRecord>) - `src/injectors/interface.ts` — Injector interface (inject(records) → {success, failed}) - `src/lib/embeddings.ts` — OpenAI text-embedding-3-small, batch 100, 3 retries - `src/lib/dedup.ts` — SHA-256 content hash + Supabase unique check - `src/lib/supabase.ts` — Supabase client - `supabase/migrations/001_memz_core.sql` — pgvector + gin indexes + trgm - `.env.local` — Master Brain Supabase + OpenAI + Anthropic keys ### MIGRATION NOT APPLIED The `memories` table does NOT exist in Supabase yet. Migration needs to be pushed. ### Phase 2+ (NOT STARTED): - No ingestors implemented (just interface) - No injectors implemented (just interface) - No pipeline script - No classifier - No viewer pages ## Pre-Existing Extraction Pipeline (CRITICAL) Already have a MASSIVE extracted corpus at: `D:\Ecosystem\vaults\chat-backups\universal-memory\` ### pieces-master-unified/ (Generated 2026-05-10) - **17,969 entries** (17,993 read, 24 dupes removed) - **20 per-agent files**: agent-oliver.md (2504), agent-merlin.md (7915), agent-dan.md (1883), agent-carlos.md (603), etc. - **24 per-project files**: project-openclaw.md (2274), project-clawcontrol.md (590), project-hawkeye.md (302), etc. - **5 category files**: infra-ops.md (11278), client-work.md (9109), general.md (2389), memory-architecture.md (5533) - **MASTER-INDEX.md** with full stats ### Source Data Volumes | Source | Volume | |---|---| | Claude conversations (markdown) | 33,935 files | | Claude source (JSONL) | 27,911 files | | Claude classified (Project Chats) | 21,118 files | | Codex sessions (archived) | 123 | | Pieces annotations | 4,919 files | | Pieces workstream summaries | 1,701 files | | Pieces persons | 11,897 records | | Pieces tags | 32,238 raw tags | ### Extraction Pipelines - `python "D:/Ecosystem/vaults/chat-backups/scripts/pieces-extractor.py" --use-snapshot` — Pieces extraction - `python "E:/Merlino Vault/chat-backups/backup-pipeline.py"` — Claude/Codex backup - `python "D:/Ecosystem/vaults/chat-backups/scripts/run-all-backups.py"` — Unified - `D:\ClaudeDev\pieces-memory-extractor.py` — Classifies annotations by 17 projects + 20 agents ### Pieces DB Location `C:\Users\mikem\AppData\Local\Mesh Intelligent Technologies, Inc\Pieces OS\com.pieces.os\production\Pieces\couchbase.cblite2\db.sqlite3` ### Agent Extracts (from 590+ chat mining) 12 per-agent insight files at `D:\Ecosystem\vaults\chat-backups\Agent Extracts\`: dan, einstein, frankie, ghost, gino, knox, merlin, picasso, shakespeare, tommy, vox, willie ## What's Actually Needed 1. Apply the migration to Supabase 2. Build ingestors that read from the ALREADY EXTRACTED unified files (not re-extract) 3. Embed + load into Supabase memories table 4. Build classifier (Haiku 4.5 for agent/project/domain tagging) 5. Build injectors (Claude memory, Hindsight, Obsidian) 6. Build viewer (Next.js at memory.merlinoai.com) 7. Build live hooks (post-task → extract → classify → inject) **Why:** Uses Master Brain Supabase instance (gmgxxiqgshbbgzhqzngq)

--- name: Always use full clickable URLs with https:// description: Never abbreviate URLs — always include https:// prefix so they're clickable in terminal output type: feedback originSessionId: 30c97f8e-9b68-4df3-a487-df605b6f502a --- ALWAYS output full URLs with https:// prefix. Never write "master-brain.vercel.app" — write "https://master-brain.vercel.app". Never write "proof.merlinoai.com/..." — write "https://proof.merlinoai.com/...". **Why:** Mike has asked for this repeatedly. URLs without protocol aren't clickable in terminal. This is a basic UX failure that wastes his time. **How to apply:** Every single URL in every response must start with https:// (or http:// for localhost). No exceptions. No abbreviations. Check before sending.

--- name: No Timetables in Plans description: Never put "Day 1", "Day 2-3" style timelines in execution plans — just phases and sequence type: feedback originSessionId: e1f642af-b960-4659-b7d3-d5eb4bfb4d6d --- Stop putting fake day-by-day timelines in execution plans (e.g., "Day 1: ...", "Day 2-3: ..."). **Why:** Mike finds rigid timetables annoying and unrealistic. They imply precision that doesn't exist and add noise to the plan. **How to apply:** Plans get numbered phases with clear sequence and dependencies. No calendar estimates. Let the work take what it takes. If Mike asks for a timeline, give one — otherwise just show the order of operations.

--- name: PrintingPress + Higgsfield + HeyGen CLIs description: Installed CLI ecosystem — 31 PrintingPress CLIs, Higgsfield CLI (authenticated, 36 models), HeyGen CLI (needs API key), repo cloned type: reference originSessionId: 0d1741ab-b41e-496b-954b-7df3eb474333 --- ## PrintingPress (installed 2026-05-10) - **Factory binary**: `printing-press` v4.2.2 at `C:\Users\mikem\go\bin\printing-press.exe` - **Repo**: `D:\ClaudeDev\00_GITHUB\cli-printing-press\` (9 skills in `skills/`) - **npm installer**: `npx -y @mvanhorn/printing-press install <name> --cli-only` - **All binaries**: `C:\Users\mikem\go\bin\*-pp-cli.exe` ### 31 Installed CLIs **SEO/Marketing**: ahrefs, google-search-console, google-ads, dub, producthunt, substack, customer-io, klaviyo **Social/Scraping**: scrape-creators (25+ platforms), contact-goat (LinkedIn+enrichment) **Commerce/Finance**: shopify, stripe, yahoo-finance **Dev/Infra**: firecrawl, sentry, docker-hub, trigger-dev, company-goat, wikipedia, archive-is, podscan **Productivity**: notion, slack, fireflies, linear, hackernews, twilio **Starter**: espn, flight-goat, movie-goat, recipe-goat ## Higgsfield CLI (installed 2026-05-10) - **Binary**: `C:\Users\mikem\go\bin\higgsfield.exe` v0.1.35 - **Aliases**: `higgsfield`, `higgs`, `hf` - **Auth**: Authenticated as mike@merlinomarketing.com - **Credits**: Topped up (was free plan 10 credits, user purchased more) - **Skills**: 4 installed via `npx skills add` — generate, soul-id, product-photoshoot, marketplace-cards - **Skills also cloned**: `~/.claude/skills/higgsfield-skills/` - **API key**: stored in MASTER_API_KEYS.env as HIGGSFIELD_API_KEY_ID + HIGGSFIELD_API_KEY - **NOTE**: `npm install -g @higgsfield/cli` is BROKEN on Windows (tar extraction fails). Manual binary install only. ### Models (36 total) **Image (19)**: nano_banana (1 credit), nano_banana_flash/Nano Banana 2 (1.5), nano_banana_2/Pro (2), gpt_image_2 (7), flux_2, flux_kontext, grok_image, kling_omni_image, seedream_v4_5, seedream_v5_lite, z_image, and more **Video (17)**: kling3_0, veo3, veo3_1, seedance_2_0, cinematic_studio_3_0, grok_video, minimax_hailuo, wan2_7, and more ### Quality Notes - Nano Banana 2 + GPT Image 2: good for photorealistic images, before/afters, B-roll - BAD for infographics with text — text rendering is garbled. Use HTML/React + Playwright for infographics. - Mike's own prompts produce better results than generic prompts — learn his style ## HeyGen CLI (installed 2026-05-10) - **Binary**: `C:\Users\mikem\go\bin\heygen.exe` v0.0.8 - **Auth**: NOT configured — API key was unauthorized. Needs new key from app.heygen.com/settings/api - **Skills**: cloned to `~/.claude/skills/heygen-skills/` (heygen-avatar, heygen-video) - **Pricing**: API is separate from monthly plan. ~$1/min of avatar video. Start at $5. - **No free API credits** since Feb 2026

--- name: No dark aesthetic assumption description: Mike does NOT prefer dark mode/aesthetic — don't assume it. Use clean/light design unless he specifies otherwise. type: feedback originSessionId: 30c97f8e-9b68-4df3-a487-df605b6f502a --- Don't default to dark mode/dark aesthetic for UIs. The existing Master Brain code had dark styling (#0a0a0a backgrounds) but that was never a stated preference. **Why:** Mike corrected the assumption directly — "I don't like dark aesthetic, where did you get that from so we can fix it permanently." **How to apply:** Default to clean, light design for new UIs and redesigns. Only use dark mode if Mike explicitly requests it. Don't cite existing code colors as evidence of preference.

--- name: Pieces Memory Harvest Operation description: Massive multi-source Pieces data extraction and memory consolidation — 8+ months of operational history recovered type: project originSessionId: 50326ff6-7829-4b0f-8a14-3d731f0a6620 --- Full Pieces memory recovery operation started 2026-05-10. ## Completed Extractions | Source | Location | Records | Date Range | |--------|----------|---------|-----------| | C drive live Pieces DB | pieces-live-extract/ | 383K+ | Mar–May 2026 | | E drive backup ZIP (3GB) | pieces-backup-extract/ | 305K+ | Sep 2025–Mar 2026 | | D drive annotations (already extracted) | pieces-organized/ | 6,060 | Mar–May 2026 | | PIECES ARCHIVE.rar (13GB from Google Drive) | pieces-archive-extract/ | 1,423 files (27GB) | Sep 2025–Apr 2026 | | Mac Pieces DB (80MB via SSH) | mac-pieces-extract/ | 11,933 | — | | VPS1 OpenClaw SQLite (337MB) | vps1-openclaw-extract/ | 15,308 across 17 agents | — | | VPS2 Claude/Hindsight/ClaudeClaw | vps2-extract/ | 26 sessions + agent banks | — | | VPS3 Claude/Codex/Hindsight | vps3-extract/ | 10+2 sessions + agent vault | — | | Downloads exports | pieces-live-extract/ | 2 migration docs | Apr 2026 | ## Unified Classification `pieces-master-unified/` — 17,969 entries across 44 files organized by project/agent. Built from C drive + E drive + RAR archive. **Why:** Mac Pieces DB and VPS1 OpenClaw data are NOT yet merged into the unified set. ## Pending - VPS1 Pieces OS install for cloud backup mining (restore oldest → extract → next → repeat) - Mac and OpenClaw data merge into unified set - Cloud backup data merge ## Key Paths - All output: `D:\Ecosystem\vaults\chat-backups\universal-memory\` - Scripts: `D:\ClaudeDev\04_scripts\` (pieces_db_extract.py, pieces_backup_extract.py, pieces-unified-classifier.py, pieces-memory-extractor.py) - Follow-up email sent to mack@pieces.app (no reply as of 2026-05-10) ## Important Notes - Mac is OFF LIMITS for Pieces backup restore — only use VPS1 - Pieces backup restore WIPES local data — only do on expendable machines - Pieces OS needs auth to access cloud backups — Mike will need to authenticate once on VPS1

- [Archangel Audit Status](project_archangel-audit-status.md) — 10 dashboards deployed, 143/143 DFS endpoints, all live on Vercel - [DFS Every Endpoint](feedback_dfs-every-endpoint.md) — Always hit every DataForSEO endpoint, never filter by perceived relevance - [No Filtering Agent Work](feedback_no-filtering-agent-work.md) — Execute comprehensively, fix issues immediately, don't ask permission - [DFS API Payload Fixes](reference_dfs-api-payload-fixes.md) — Correct field names and structures for tricky DataForSEO endpoints

--- name: dfs-api-payload-fixes description: DataForSEO API payload format quirks discovered during Archangel audit — correct field names and structures type: reference originSessionId: 137d62c9-fb14-451e-8145-45dc9717acf0 --- Payload format fixes discovered during comprehensive DFS audit: - **LLM mentions endpoints**: `target` must be array of objects: `[{"target": [{"domain": "example.com"}]}]` - **LLM responses (ChatGPT/Claude/Gemini/Perplexity)**: fields are `user_prompt` + `model_name` (not `prompt`/`model`). Claude model: `claude-sonnet-4-5`, Perplexity: `sonar-pro` - **Cross aggregated metrics**: outer key `targets` (plural), each item needs `target` array + `aggregation_key`, minimum 2 targets - **Content category trends**: `category_code` is plain integer, not array - **OnPage duplicate_tags**: requires explicit `type: "duplicate_title"` or `type: "duplicate_description"` - **OnPage duplicate_content**: `url` is required, use full `https://` URL - **OnPage microdata**: requires crawl task with `store_raw_html: true` - **Labs page_intersection**: `pages` must be `{"1": "https://...", "2": "https://..."}` with full URLs - **Domain metrics by categories**: requires `first_date` + `second_date` (not optional) - **YouTube video_subtitles/comments**: broken server-side (DFS injects invalid fields) - **SERP ads_search/ads_advertisers**: use `target` (domain), not `keyword` - **Clickstream dataforseo_search_volume**: use `location_code`/`language_code` only (no `_name` variants)

--- name: no-filtering-agent-work description: Do not ask Mike whether to do work or filter scope — execute comprehensively and fix issues without asking type: feedback originSessionId: 137d62c9-fb14-451e-8145-45dc9717acf0 --- When Mike says "go" or gives direction, execute comprehensively. Do not ask clarifying questions about scope, do not offer options, do not ask "want me to fix this?" — just fix it. **Why:** Mike was frustrated by multiple rounds of "should I do X?" and "want me to fix the contamination?" when the answer was obviously yes. Every time an agent asked instead of acting, it cost time on a deliverable that was already late. **How to apply:** When contamination, wrong data, missing endpoints, or broken features are discovered during execution, fix them immediately in the same pass. Don't report issues and wait for permission — report the fix alongside the issue.

--- name: dfs-every-endpoint description: When running DataForSEO audits, hit EVERY endpoint in the API — do not filter or cherry-pick based on perceived relevance type: feedback originSessionId: 137d62c9-fb14-451e-8145-45dc9717acf0 --- Hit every DataForSEO endpoint when running an audit. Do not filter based on what seems "relevant." Mike pays for the full suite and expects comprehensive data collection. **Why:** Mike was frustrated when initial audit pulls only hit a handful of endpoints out of 143+ available. The client deliverable was delayed because data had to be collected in 3 rounds instead of 1 comprehensive pull. **How to apply:** When running any DataForSEO audit, reference the API reference spreadsheet (`c:\Users\mikem\Downloads\DataForSEO_API_Reference.xlsx`) and systematically hit every live endpoint. Save all raw JSON to a `raw-data/full-audit/` directory. Only skip verticals that literally cannot return data (App Store, Amazon, Hotels, Finance for a non-relevant business). Cross-reference collected files against the spreadsheet after collection to verify 100% coverage.

--- name: archangel-audit-status description: Archangel Centers 10-dashboard SEO audit — all phases complete, 143/143 DFS endpoints, 10 Vercel deployments live type: project originSessionId: 137d62c9-fb14-451e-8145-45dc9717acf0 --- Archangel Centers SEO audit dashboard system — 10 template variants deployed to Vercel with comprehensive DataForSEO data. **Why:** Client deliverable for Archangel Centers (addiction treatment, Tinton Falls + East Windsor NJ). Mike Sorrentino co-founder. YMYL vertical. **How to apply:** This project is complete. All 10 dashboards are live. Raw data warehouse has 252 JSON files / 26.7 MB covering 143/143 relevant DataForSEO endpoints. V6 is the primary enriched dashboard. V1-V5, V7-V10 are lighter variants with shared audit.ts/keywords.ts data. Key URLs: - V6 (primary): https://audit-archangel-centers.vercel.app - V1: https://v1-shadcn.vercel.app - V2: https://v2-mosaic.vercel.app - V3: https://v3-nexus.vercel.app - V4: https://v4-crm.vercel.app - V5: https://v5-campaign.vercel.app - V7: https://v7-tactical.vercel.app - V8: https://archangel-v8-agent.vercel.app - V9: https://v9-cms.vercel.app - V10: https://archangel-v10-cryptgen.vercel.app - POWD: proof.merlinoai.com/archangel-centers/2026-05-08-10-dashboard-deploy

- [Audit Engine State](project_audit-engine-state.md) — North Valley Solar audit built, needs data depth rebuild - [Show ALL API data](feedback_show-all-api-data.md) — Every DataForSEO item must be visible, not just KPI summaries - [Clean room builds](feedback_no-archangel-no-legacy.md) — Never reference old audit projects, start fresh - [PRD location](reference_prd-audit-dashboard.md) — Canonical specs at prd-audit-dashboard folder - [Memory ecosystem](reference_memory-ecosystem.md) — All memory/backup locations + Hindsight fix details

--- name: Memory ecosystem locations description: Full map of all memory, backup, and vault locations across C/D/E drives plus Hindsight on Mac type: reference originSessionId: f9231945-0fdb-442f-9889-2bb7a8beef7f --- ## Memory Backends | System | Location | Status | |--------|----------|--------| | Auto Memory (file) | `C:\Users\mikem\.claude\projects\{key}\memory\` | Always on | | Hindsight | `http://100.127.161.25:8888` (Mac via Tailscale) | Running (OpenAI gpt-4o-mini), 102 banks | | Honcho | Plugin (auto-connected) | Always on | | Context Bundles | `{project}\.agents\context-bundles\` | Per-project | ## Backup Pipeline 1. Source: `C:\Users\mikem\.claude\projects\` (592 JSONL files) + `.codex\sessions\` 2. Orchestrator: `E:\Merlino Vault\chat-backups\backup-pipeline.py` 3. Classified chats: `D:\Ecosystem\vaults\chat-backups\Project Chats\` (39 folders, 590+ chats) 4. Pieces snapshots: `D:\Ecosystem\vaults\chat-backups\universal-memory\by-source\pieces\` (2.3GB) 5. RAG feed: `D:\Ecosystem\vaults\chat-backups\_rag-feed\` 6. Digests: `D:\Ecosystem\vaults\chat-backups\_digests\` ## Hindsight Fix (2026-05-10) Gemini API key expired, then replacement had exhausted free-tier quota. Switched to OpenAI gpt-4o-mini. Config at `~/hindsight/run.py` on Mac.

--- name: PRD and audit specs location description: The canonical PRD, data contract, and audit SOP for the Merlino Audit Dashboard live in prd-audit-dashboard type: reference originSessionId: f9231945-0fdb-442f-9889-2bb7a8beef7f --- All specs for the audit dashboard system: - **PRD:** `D:/ClaudeDev/00_GITHUB/prd-audit-dashboard/PRD.md` — 16 pages, 71 endpoints, 10 theme variants - **Data Contract:** `D:/ClaudeDev/00_GITHUB/prd-audit-dashboard/DATA-CONTRACT/` — audit.ts, dataforseo.ts, keywords.ts interfaces - **Audit SOP:** `D:/ClaudeDev/00_GITHUB/prd-audit-dashboard/AUDIT-SOP.md` — 8 execution groups, parallel execution, cost estimates - **Gen-Data Spec:** `D:/ClaudeDev/00_GITHUB/prd-audit-dashboard/GEN-DATA-SPEC.md` — JSON-to-TypeScript field mapping - **Endpoint Display Map:** `D:/ClaudeDev/00_GITHUB/prd-audit-dashboard/ENDPOINT-DISPLAY-MAP.md` — which endpoints display where - **Rate Limits:** `D:/ClaudeDev/00_GITHUB/prd-audit-dashboard/RATE-LIMITS.md` — pricing and optimization - **DataForSEO Docs:** `D:/ClaudeDev/00_GITHUB/dataforseo-docs/` — scraped API reference

--- name: No Archangel, no Neill, no DWS — clean room builds only description: Mike explicitly banned referencing old audit projects when building new ones — start fresh every time type: feedback originSessionId: f9231945-0fdb-442f-9889-2bb7a8beef7f --- When building audit dashboards, start from zero. Do not reference, import from, or carry over any code or data from previous audit projects (Archangel Centers, Neill & Son Roofing, DWS). **Why:** Previous audit sessions had contamination issues — rehab content appearing in roofing audits, wrong business names hardcoded in JSX, data from the wrong client showing up. Mike was embarrassed on a prospect call because of this. **How to apply:** Every new audit gets its own clean folder. Read the PRD fresh. Never copy-paste from old audit builds. The `.continue-here.md` pattern and PRD at `D:/ClaudeDev/00_GITHUB/prd-audit-dashboard/` are the source of truth, not previous audit code.

--- name: feedback_skills_and_commands_same description: Every skill must also be a command and vice versa — Mike treats them as identical, always create both type: feedback originSessionId: 4a389b94-8ec3-40f7-8071-54ea85a8e1a5 --- When Mike gives you a /skill or /command, create BOTH: 1. `~/.claude/skills/{name}/SKILL.md` (skill file) 2. `~/.claude/commands/{name}.md` (command file) **Why:** Mike doesn't distinguish between skills and commands. To him they're the same thing — a slash command that does something. If it only exists as one, it's half-broken. **How to apply:** Every time you create or update a skill, also create/update the matching command file. Every time you create a command, also create the matching skill folder. Keep them in sync.

--- name: Show ALL API data on dashboard — no summaries description: Mike demands every piece of DataForSEO API data be visualized on the dashboard, not just KPI summary cards type: feedback originSessionId: f9231945-0fdb-442f-9889-2bb7a8beef7f --- Every piece of data pulled from every DataForSEO endpoint must be visible on the dashboard. No summary-only pages. No KPI cards without the underlying detail tables. **Why:** Mike is paying for DataForSEO API data and presenting this to prospects. A dashboard that says "57K mentions" without showing the actual source URLs, or "not mentioned in LLMs" without showing what keywords were checked and who IS mentioned, is useless for a sales call. He called the summary-only approach "lazy" and unacceptable. **How to apply:** For every API endpoint called, the items[] array from the response must be extracted into the TypeScript data files and rendered as a table, chart, or detail view on the dashboard. Never show just a count — always show the records behind the count. If an endpoint has 100 items, show all 100 in a sortable table.

--- name: Merlino Audit Engine — Project State description: Current state of the audit dashboard build for North Valley Solar Power — data pulled, dashboard built, needs data depth rebuild type: project originSessionId: f9231945-0fdb-442f-9889-2bb7a8beef7f --- ## merlino-audit-engine — North Valley Solar Power Audit **Phase:** Data rebuild needed (Phase 2 of 3) **Date:** 2026-05-10 **Target:** northvalleysolarpower.com (Fairfield, CA — solar panel installation) ### What Exists - 57 raw JSON files from DataForSEO API in `audits/north-valley-solar/` (9.5MB total) - 62 API calls made at $1.01 total cost - 3 TypeScript data files in `src/data/` (audit.ts, dataforseo.ts, keywords.ts) - 16-page Next.js dashboard with dark/light themes, builds clean - gen-data.py transformer script ### Core Problem gen-data.py extracted ~30% of available data. Dashboard shows KPI summary cards but not the detailed records from the API. Content sentiment says "57K mentions" but shows zero source URLs. LLM page says "not mentioned" with no detail on what was checked. Ranked keywords don't show SERP features or intent. **Why:** Mike called this out hard — paying for DataForSEO data and the dashboard doesn't show it. **How to apply:** Next session must rebuild gen-data.py to extract ALL items arrays from every JSON file, then rebuild every page to display full data tables with the detailed records. See `.continue-here.md` for the complete plan. ### Key References - PRD: `D:/ClaudeDev/00_GITHUB/prd-audit-dashboard/PRD.md` - Data Contract: `D:/ClaudeDev/00_GITHUB/prd-audit-dashboard/DATA-CONTRACT/` - Audit SOP: `D:/ClaudeDev/00_GITHUB/prd-audit-dashboard/AUDIT-SOP.md` - DataForSEO auth: Base64 `c3VwcG9ydEBrYWJvb21zZW8uY29tOmI3YjI0MDRhN2I2Mjg4ZDg=` - Balance: ~$664 remaining

--- name: project_session_persistence_build description: Build GSD-style auto-compact + pause/resume session persistence using Mike's existing agent team, not GSD's generic agents type: project originSessionId: 4a389b94-8ec3-40f7-8071-54ea85a8e1a5 --- Mike wants GSD's session persistence pattern without GSD's agent system. **Why:** Context rot kills quality in long sessions. GSD solves this with artifact files that bridge sessions. Mike wants the same but using his Oliver/Carlos/Leads team with Honcho+Hindsight memory, not GSD's 33 generic stateless agents. **How to apply:** Build this in the next dev session focused on agent infrastructure. ## What to Build ### 1. Pre-compact hook (automatic) - Fires before every `/compact` or auto-compaction - Writes `.planning/.continue-here.md` with: - Current objective (what we're doing) - Completed items (what's done) - Next steps (what's next) - Active agents (who's working on what) - Blockers (anything waiting on Mike) - Key decisions made this session - Also pushes to Hindsight for cross-session recall ### 2. Session-end hook (automatic) - Fires on session exit/disconnect - Same state capture as pre-compact - Writes final `.planning/SESSION-END.md` with timestamp ### 3. `/pause` command (explicit) - Replaces/enhances current `/wrap` skill - Saves state file + updates project memory + pushes to Hindsight - Prints a summary Mike can screenshot or paste into next session - Optionally writes HANDOFF.json for machine-readable resume ### 4. Session-start auto-read (automatic) - CLAUDE.md instruction: "On session start, if `.planning/.continue-here.md` exists, read it first and resume from that state" - Agent greets with: "Picking up from [last objective]. [X] done, [Y] remaining." ### 5. Agent context injection - When Carlos dispatches leads via Agent tool, include the state file content in the prompt - Leads get full project context without re-reading everything ## What NOT to do - Don't install GSD npm package - Don't use GSD's 33 generic agents - Don't replace Oliver/Carlos/Leads pipeline - Keep Honcho + Hindsight as the memory layer ## Existing pieces to leverage - Pre-compact Honcho anchor hook (already fires) - `/wrap` skill (already exists, needs enhancement) - `.continue-here.md` pattern (already used in some projects) - HANDOFF.json pattern (already used) - `subagent-start-memory.js` hook (already injects memory into subagents) ## GSD patterns to steal (methodology only) - STATE.md format: status, current phase, completed tasks, next tasks - CONTEXT.md format: key decisions, constraints, open questions - Automatic artifact updates on every phase transition - "Context budget" concept: track % used, trigger save at thresholds ## Date 2026-05-10

--- name: project_merlino_forge description: MerlinoForge autonomous coding harness — built 2026-05-09, Claude Code CLI powered, dark Tactical Ops UI, Cloudflare tunnel at forge.imerlino.com type: project originSessionId: 4a389b94-8ec3-40f7-8071-54ea85a8e1a5 --- MerlinoForge — autonomous coding harness inspired by LocalForge, rebuilt for Mike's stack. **Why:** LocalForge (github.com/leonvanzyl/localforge) uses local LLMs only. MerlinoForge uses Claude Code CLI (Max subscription, no API keys) with multi-agent potential. **How to apply:** Use MerlinoForge when prototyping apps autonomously — describe what you want, it breaks into features on a kanban board, Claude agents build each one. ## Location - Project: `D:/ClaudeDev/00_GITHUB/merlino-forge/` - Live URL: `https://forge.imerlino.com` (Cloudflare named tunnel → localhost:3088) - Tunnel config: `C:\Users\mikem\.cloudflared\config-forge.yml` - Tunnel ID: `67ff25eb-f39f-46b7-8d05-57dcc4631119` - SQLite DB: `merlino-forge.db` (in project root) ## Stack - Next.js 15 (App Router) + TypeScript + ShadCN + Tailwind (dark theme) - SQLite + Drizzle ORM (local state) - Claude Code CLI (`claude --print`) — NO Anthropic SDK, NO API keys - SSE (Server-Sent Events) for real-time agent output streaming - Port 3088 (dev mode) ## Architecture - **Agent Runner** (`scripts/agent-runner.mjs`) — spawns `claude --print --model <model>` with feature prompt, streams JSON-lines stdout protocol back to orchestrator - **Orchestrator** (`src/lib/agent/orchestrator.ts`) — singleton, manages child processes, SSE broadcast via EventEmitter, watchdog timeout, auto-continue on success - **Feature Generator** (`src/app/api/projects/[id]/generate/route.ts`) — calls `claude --print` to break app descriptions into structured feature lists - **9 API routes**: projects CRUD, features CRUD, orchestrator start/stop, settings, SSE stream - **Settings**: model selector (opus/sonnet/haiku), default build dir, max turns — stored in SQLite, no API key field ## UI (Tactical Ops template) - Dark command-center aesthetic, orange-500 accent - Sidebar: Dashboard, Agents, Projects, Activity, Settings - Kanban board: Backlog → In Progress → Completed → Failed - Activity panel: live SSE streaming of agent output - Agent status panel with run/stop controls ## How to start ```bash cd D:/ClaudeDev/00_GITHUB/merlino-forge npx next dev -p 3088 -H 0.0.0.0 # In another terminal: cloudflared tunnel --config C:\Users\mikem\.cloudflared\config-forge.yml run merlino-forge ``` ## How to use 1. Create a project (name, description, target directory) 2. Add features manually or use Feature Generator (describe your app → Claude generates feature list) 3. Click Start Agent → Claude Code picks first backlog feature, codes it, moves card 4. Watch live output in Activity panel 5. Auto-continues to next feature on success ## Key decisions - NO API keys — runs through Claude Max subscription via CLI - `@anthropic-ai/sdk` fully removed from dependencies - Model names use CLI format: `opus`, `sonnet`, `haiku` (not API model IDs) - v1 is single-agent sequential; v2 would add multi-agent parallel execution - `allowedDevOrigins: ["*.trycloudflare.com"]` in next.config.ts for tunnel access ## Also installed this session - **LocalForge** at `D:/ClaudeDev/00_GITHUB/localforge/` (port 7777) — the original repo by Leon van Zyl - **Understand-Anything** plugin (v2.6.3) — Claude Code plugin that maps codebases into knowledge graphs. Run `/understand` in any repo. ## Date 2026-05-09

--- name: Every Endpoint Pulled Must Be Displayed description: Pulling API data without displaying it on the dashboard is unacceptable — 71/71 or nothing type: feedback originSessionId: 96f35022-804a-4da4-b5e1-4fe7306f9e98 --- Never accept partial display coverage. If we pull data from an API endpoint, it MUST have a visible display element on the dashboard (table, chart, card, or list). "Summary only" is not acceptable if the full data was pulled. **Why:** 2026-05-09 audit revealed 30 of 71 endpoints were pulled but never shown to the prospect. Mike's reaction: "this sounds like you accept incomplete work or failure but I do not." Content Analysis (4 endpoints) was 100% invisible — we paid to pull sentiment data and never showed it. **How to apply:** Use the endpoint-to-display map at `prd-audit-dashboard/ENDPOINT-DISPLAY-MAP.md`. Before shipping any dashboard, verify every endpoint in the audit SOP has a corresponding visible UI element. 71/71 or it doesn't ship.

--- name: Never Clone Dirty Templates description: Never build audit dashboards by cloning existing client dashboards — always build from scratch using the PRD type: feedback originSessionId: 96f35022-804a-4da4-b5e1-4fe7306f9e98 --- Never clone an existing client dashboard to create a new one. The Archangel/Neill disaster proved that hardcoded business names, addresses, phone numbers, and industry terms leak through every time — even after multiple grep-and-replace passes and QA rounds. **Why:** 2026-05-08/09 session spent 10+ hours trying to clone archangel-kw-dashboard into a DWS dashboard. Archangel references leaked into hero sections, sidebar logos, page body copy, competitors page, SERP analysis, audit recommendations, blog preview, social media page, and video embeds. Three rounds of QA still found references. Mike was furious. **How to apply:** Always build from the PRD build package at `D:/ClaudeDev/00_GITHUB/prd-audit-dashboard/`. Build fresh. Zero legacy code. Every business-specific string must come from data files, never hardcoded in JSX.

--- name: Merlino Audit Engine Project description: Clean-room audit dashboard build — PRD package complete, old templates cleaned, next step is fresh build in merlino-audit-engine/ on northvalleysolarpower.com type: project originSessionId: 96f35022-804a-4da4-b5e1-4fe7306f9e98 --- ## Status: PRD COMPLETE — BUILD PENDING **Date:** 2026-05-09 ### What Happened (2026-05-08 to 2026-05-09) Full session rebuilding the DataForSEO audit pipeline from discussion to PRD: 1. Analyzed DataForSEO account: $672 balance of $951, 9 existing skills covering ~25 endpoints 2. Updated dataforseo-docs VitePress site: 468 endpoints, Full Merlino Audit SOP, skill mapping, endpoint-display map 3. Ran a real 71-endpoint audit on digitalwebsolutions.com ($1.70 cost) 4. Built dashboard from audit data, deployed to Vercel 5. Discovered dashboard templates leak old client data (Archangel, Neill & Son) 6. Attempted to fix 10 template variations — QA revealed pages were 404, client refs everywhere 7. Created endpoint-to-display map showing 30/71 endpoints never displayed on any dashboard 8. Built 12 new page types to close display gaps 9. Wrote full PRD (97 files) with CSV, SOPs, data contracts, gen-data spec 10. Scrubbed all example data of company references 11. Deleted all dirty Vercel projects (13 deployments) 12. Cleaned up — PRD package and docs site remain ### What's Left - Build clean dashboard from PRD in `D:/ClaudeDev/00_GITHUB/merlino-audit-engine/` - Target domain: https://northvalleysolarpower.com/ - Pull all 71 endpoints - Design multiple mockups from real data - Mike wants to SEE mockup options before committing to a design ### Key Repos - PRD build package: https://github.com/mmerlino23/prd-audit-dashboard (12 files, no example data) - DataForSEO docs: https://github.com/mmerlino23/dataforseo-docs - Build target: `D:/ClaudeDev/00_GITHUB/merlino-audit-engine/` (empty, ready) ### DataForSEO Account - Login: support@kaboomseo.com - Balance: ~$670 - Auth: Base64 `c3VwcG9ydEBrYWJvb21zZW8uY29tOmI3YjI0MDRhN2I2Mjg4ZDg=`

--- name: No flat/basic ShadCN card style description: Mike hates the default flat ShadCN card grid aesthetic — white cards on gray bg with small badges is a 0/10. Never use this style again. type: feedback originSessionId: 7145e35f-f109-4844-8ec7-698955d5a930 --- Never build apps with the basic flat ShadCN card grid pattern: white cards on light gray background, small framework badges, minimal padding, generic feel. Mike rated this a 0/10 and told Frankie he'd be replaced. **Why:** Looks generic, amateur, "horrible." Every AI tool outputs this exact same look. Mike pays for premium templates and expects his apps to reflect that investment. **How to apply:** When building any grid/explorer/dashboard tool, start from an actual premium template codebase (WowDash, IntellectAI, Alpino, etc. from D:\Ecosystem\TEMPLATES\admin-dashboards\). Clone the actual template's design system — layout, colors, card depth, gradients, typography, spacing — not just "reference" it. The result should look like a $79 template, not a free ShadCN starter.

--- name: Master Brain state as of 2026-05-09 description: 225K memories + 5 Brain features built (access tracking, edges, quality scoring, outcome inference, complexity routing), DB migrated, Agent Extracts mined but not ingested type: project originSessionId: 16678fc5-db75-43d1-8af4-3a3f154998fa --- ## Master Brain — State Snapshot (2026-05-09) **Branch:** master (uncommitted changes from 2 sessions) **DB:** Supabase `gmgxxiqgshbbgzhqzngq`, table `memories` (225,414 rows, all embedded) **Embedding:** OpenAI text-embedding-3-small (1536 dims) ### What's Done - All prior sources ingested (225K rows, 218 scopes) - 5-strategy RRF search working (semantic + keyword + entity + temporal + graph) - 5 Brain features built (inspired by Uncle G / Turboware LLM Brain System): 1. Access Tracking — access_count + last_accessed_at on memories table 2. Memory Edges — memory_edges table (empty, FK relationships) 3. Chunk Quality Scoring — scripts/chunk_quality.py heuristic scorer 4. Outcome Inference — chat_outcomes table (empty) 5. Complexity Routing — scoreComplexity() for model tier routing - SQL migration ran on live Supabase (brain-features.sql) - Build compiles clean - 12-agent chat mining operation: all 12 specialists extracted insights from 590+ backed-up chats - Agent Extracts: 246KB across 12 files at D:/Ecosystem/vaults/chat-backups/Agent Extracts/ - Hindsight: ~250 memories pushed to 14 banks, mac hostname resolving via hosts file - Turboware repo cloned to D:/ClaudeDev/00_GITHUB/Turboware-LLM-Brain-System/ - LocalForge repo cloned to D:/ClaudeDev/00_GITHUB/localforge/ ### Uncommitted Changes - scripts/chunk_quality.py (new) - scripts/migrations/brain-features.sql (new, already executed) - scripts/config.py (6 new SOURCE_CONFIGS — has duplicate ecosystem-memory key) - scripts/embed_unified.py (write-back fix from Apr session) - src/app/api/brain/ routes (Brain features modules) - package.json, package-lock.json updates ### What's Done (2026-05-09 session 2) - Config.py fixed (duplicate keys removed, sensitive excludes added) - All uncommitted work committed + pushed (fbaeecd, 0ed36f7) - 4 new sources ingested: agent-extracts, ghl-gems, hermes-clean, agentic-coding-dgs (4,606 rows) - 749 new rows embedded ($0.005) - All 5 Brain features wired into live API (complexity routing + quality boost were the two gaps) - OpenAI key rotated (old exhausted, new active) ### What's Left 1. dl-dump — 395K chunks, needs selective subfolder approach (NOT bulk) 2. Merlino Vault — 4.2M chunks, parked, needs selective subfolder 3. Frontend/search quality testing 4. Entity extraction on new rows (optional) **Why:** Handoff snapshot — all core features built and wired, remaining work is data expansion. **How to apply:** Read .planning/.continue-here.md for details. No blockers.

- [Bunny Storage for videos](reference_bunny_storage.md) — MP4s at seo-rockstars-vault/ranking-reels/ on Bunny CDN - [Local PAA Scraper](reference_paa_scraper.md) — scrape-local-paas.mjs with UULE + 3 browser backends, outputs paaList JSON for video pipeline - [Big Laptop SSH](reference_big_laptop.md) — mike-big-laptop at 100.77.238.24, SSH key auth not yet configured - [Brand Media Manager hosting](reference_brand_media_manager.md) — brandmediamanager.com on Vercel project late-social-connect, NOT the stale brandmediamanager project - [Stripe Ranking Reels](reference_stripe_ranking_reels.md) — Live Stripe account, payment links, checkout app at order.rankingreels.com - [POWD site](reference_powd_site.md) — Proof of Work Done at proof.merlinoai.com + powd.rankingreels.com, basic auth merlino/powd2026 - [POWD mandatory rule](feedback_powd_mandatory.md) — Queen/Frankie/Willie must capture screenshots before shipping, rule at ~/.claude/rules/powd-mandatory.md - [rankingreels.com DNS](reference_rankingreels_dns.md) — Namecheap DNS, subdomains: order→checkout-app, powd→powd-site, www→review-dashboard - [Pipeline Review App](reference_pipeline_review_app.md) — Funny ad pipeline visual review tool on Vercel - [Pipeline App 4 Variants Done](project_pipeline_app_variants_done.md) — 4 visual variants built and deployed, test at ?v=1 through ?v=4 - [Always use full URLs](feedback_full_urls.md) — Every URL must include https:// prefix, no bare domains - [Light theme default](feedback_light_theme_default.md) — Always default to light/white theme, Mike prefers light mode - [Outstand BYOK migration](project_outstand_migration.md) — Migrating BMM from Zernio to Outstand for true white-label OAuth, subscription activation needed - [Session 2026-05-05/06](project_session_2026_05_05_06.md) — Stripe, dashboard fix, checkout app, POWD, Bluesky removal, Outstand migration kickoff - [Geo IN the PAA title](feedback_geo_in_title.md) — City name goes INSIDE the title question, never as a hashtag - [Zernio API for BMM](reference_zernio_api.md) — Use mediaItems array format, presign endpoint is POST /media/presign - [Video pipeline method](feedback_video_method.md) — Scrape PAA with UULE browser, use scraped answer as content, /scriptwriter, different avatar - [Post to ALL platforms](feedback_all_platforms.md) — Every video goes to all 8 connected accounts, not just YT+TT - [Podbean Podcast Dashboard](reference_podbean_app.md) — Flask app on Railway, one-click episode creator, Fish Audio voice, GPT thumbnails, Puppeteer embeds - [RSS.app API](reference_rssapp.md) — Feed generator API, bridge BMM→Podbean syndication - [Podbean routing feedback](feedback_podbean_routing.md) — Images→Picasso, no duplicate sections, POWD per-domain, title on thumbnail always - [Podcast BMM + pipeline](reference_podcast_podbean.md) — Podbean API in BMM admin UI + video-to-podcast CLI scripts in ranking-reels - [Social publishing API pricing](reference_social_publishing_pricing.md) — Zernio $39 grandfathered vs $368 new, competitors compared, Zernio only SaaS with Reddit+API - [Reddit is mandatory](feedback_reddit_mandatory.md) — Never suggest Reddit-less tools or hybrid workarounds, Reddit is non-negotiable - [Clone V6 Workflow pattern](feedback_use_v6_template.md) — Pure Tailwind + ShadCN, zero custom CSS classes, study V6 at archangel-variations/v6-workflow - [Template variants = clone from TEMPLATES](feedback_template_variants.md) — "Different templates" means clone D:\Ecosystem\TEMPLATES\ source files, study archangel-variations for adaptation pattern - [DataForSEO SOP Site](reference_dataforseo_sop_site.md) — 41-page VitePress docs at dataforseo-docs.vercel.app with RAG chat - [DataForSEO API Skill](reference_dataforseo_skill.md) — /dataforseo-api skill + MCP server configured, covers all endpoints and patterns - [Session 2026-05-07](project_session_2026_05_07.md) — Railway volume, UI cleanup, BMM→RSS→Podbean pipeline, episode enrichment, distribution - [SoundCloud API](reference_soundcloud_api.md) — "Merlino AI" app, client_id + secret in MASTER_API_KEYS.env, OAuth 2.0 - [YouTube Shorts URL](feedback_youtube_shorts_url.md) — 30s 9:16 videos use /shorts/ URL, never /watch?v= - [Reddit subreddits](reference_reddit_subreddits.md) — r/MerlinoMarketing + r/RankingReels, subreddit field inside platform object - [Session 2026-05-06/07 video](project_session_2026_05_06_video.md) — Full video pipeline buildout, 10 rules established, NYC demo live on 9 platforms - [Session 2026-05-07 afternoon](project_session_2026_05_07b.md) — BMM admin refactor to real pages, Zernio analytics dashboard, webhook config, podcast tab fix - [BMM admin routes](reference_bmm_admin_routes.md) — /admin/* real pages after monolith split, shared layout with DashboardSidebar - [Image gen stack](feedback_never_gpt_image.md) — GPT Image 2 primary, FAL FLUX fallback, NEVER Google AI Studio (watermarks) - [BMM Media Creator Hub](reference_bmm_create_hub.md) — /admin/create with 7 types, GPT Image 2, Creatify, Claude Sonnet, PublishPanel - [BMM subdomain routing](reference_bmm_create_hub.md) — Use admin.brandmediamanager.com, root domain 404s on /admin/* - [Session 2026-05-08](project_session_2026_05_08.md) — Homepage fix, 3 PAUD sales page variants built and deployed - [Frankie CSS violation](feedback_css_violation.md) — Frankie used custom CSS instead of pure Tailwind, needs refactoring - [Template Gallery Tool](project_template_gallery.md) — 89 templates with 100% screenshot coverage at template-gallery-lemon.vercel.app - [No empty cards in galleries](feedback_no_empty_cards.md) — Remove entries without real visuals, never show placeholder cards - [Media Gen Stack](reference_media_gen_stack.md) — Full API inventory: Recraft V4, FAL, Blotato, Kling, Creatify — tested 2026-05-09 with pricing and verdicts - [Session 2026-05-08/09](project_session_2026_05_08_09.md) — SoundCloud/Podbean on BMM, video pipeline fixes, Blotato/Recraft/Kling research, 7 template picks - [Carlos POWD gate](feedback_carlos_powd_gate.md) — Carlos must not report "done" to Oliver without Queen's POWD verification first

--- name: Session 2026-05-08/09 description: SoundCloud OAuth, Podbean/SoundCloud on BMM, video pipeline fixes, media gen stack research (Blotato/Recraft/Kling/FAL) type: project originSessionId: 33baa65e-d636-4080-888a-42c5543fbecb --- ## Session 2026-05-08 to 2026-05-09 ### Built & Shipped 1. **SoundCloud OAuth** — token obtained via browser flow, refresh token saved, redirect URI updated to `http://localhost:8765/callback` 2. **Podbean platform on BMM** — synthetic account in admin context, `/api/podbean-publish` route, TTS via Fish Audio 3. **SoundCloud platform on BMM** — synthetic account, `/api/soundcloud-publish` route, auto-TTS 4. **PublishPanel upgraded** — 11 Zernio platforms (added Threads/Bluesky/GBP) + Podbean + SoundCloud always visible, "Make a Video From This" CTA 5. **Terminal publish script** — `scripts/test-publish-all.mjs` hits all 15 channels from one command 6. **BMM_API_KEY** — pulled from Vercel prod, saved to MASTER_API_KEYS.env, quotes stripped 7. **Sarasota website cost video** — full pipeline: script (OpenRouter+Claude) → FAL background → Creatify render (50 credits) → published to Podbean + SoundCloud + 13 social 8. **paa-to-video.mjs fixes** — OpenRouter fallback for dead Anthropic keys, FAL background image gen, fixed empty image_urls 9. **video-short API fixes** — client-side polling (no more Vercel timeout), Suspense boundary fix, OpenRouter for script gen, FAL background before link creation 10. **Image API fix** — FAL primary, GPT fallback (fixes quote-card/infographic failures) 11. **POWD proof page** — https://proof.merlinoai.com/ranking-reels/2026-05-08-sarasota-website-cost-all-platforms 12. **Recraft API key** saved to MASTER_API_KEYS.env, V3+V4 tested and working 13. **Kling API keys** saved, direct API works but $0 balance — use FAL `fal-ai/kling-video/v2/master` instead 14. **Blotato API** confirmed working at `backend.blotato.com/v2`, 37 templates tested ### Vercel Env Vars Set - `OPENROUTER_API_KEY` — added to late-social-connect production ### Dead Keys (need fixing) - All 3 `ANTHROPIC_API_KEY*` in MASTER_API_KEYS.env — invalid/revoked - `OPENAI_API_KEY` — over quota - `KLING_ACCESS_KEY` — $0 balance on direct Kling account ### Media Gen Stack Research (2026-05-09) Full details in `reference_media_gen_stack.md`. Key decisions: **Images:** - Recraft V4 for thumbnails/quote cards/social cards ($0.04, best text) - FAL FLUX Pro for backgrounds/B-roll stills - Ideogram V3 via FAL for text-heavy infographics - GPT Image 2 when OpenAI gets credits (great but over quota) **Videos:** - Creatify = primary for client avatar shorts (consistent avatar, caption control) - Blotato = volume/spam channel (good for social cards, not client-grade videos) - Kling 2.0 via FAL = cinematic B-roll clips - Remotion = future long-form (code-generated, pixel-perfect) **Blotato favorites (7 templates):** 1. Breaking News (TOP PICK) 2. Tutorial (flat) 3. Tutorial (monocolor) 4. When X then Y (video) 5. Tweet Card (photo bg) 6. Tweet Card (minimal) 7. Images + Prominent Text **Blotato rejected:** - Product Scene, Image Slideshow (3 hands), Single Quote (use Recraft), AI Avatar B-roll (text covers face) ### Open Questions / Issues 1. **Blotato carousels** — IG Carousel and Quote Card templates returned single images, NOT multi-slide carousels. Need to investigate if multi-image output requires different inputs or if Blotato only generates the first slide 2. **Blotato pricing** — no credits/billing endpoint exposed via API, need to check dashboard at blotato.com 3. **Blotato character consistency** — AI Selfie switches faces between scenes, only usable for spam not clients 4. **Blotato image control** — cannot control background images in video templates via API, prompt-only 5. **Blotato text position** — AI Avatar B-roll has no captionPosition control, text covers avatar face 6. **Recraft V4 sizes** — doesn't support 1536x1024, use 1024x1024 for square or check docs for supported sizes 7. **BMM Create Hub** — needs model-per-type upgrade (currently all FLUX Dev), Spielberg/Picasso/Frankie need to be in on the UI redesign 8. **SoundCloud token** — expires every hour, needs auto-refresh before uploads 9. **FFmpeg thumbnail overlay** — fontconfig crash on Windows, raw thumbnails work 10. **OpenAI account** — needs credits added to use GPT Image 2 ### Next Steps - Spielberg + Picasso + Frankie session to redesign Create Hub with right model per type - Add Blotato Breaking News + Tutorial templates to BMM Create Hub - Swap quote-card to Recraft V4 in image API route - Fix Blotato carousel output (investigate multi-slide generation) - Add Recraft API key to Vercel env for BMM - Fix OpenAI billing for GPT Image 2

--- name: Media Generation Stack description: Full inventory of image/video generation APIs tested 2026-05-09 — FAL, Blotato, Recraft, Kling, Creatify, with pricing and verdicts type: reference originSessionId: 33baa65e-d636-4080-888a-42c5543fbecb --- ## Tested 2026-05-09 ### Image Generation (ranked by text rendering quality) | Provider | Model | Cost | Text Quality | API Key Location | Notes | |----------|-------|------|-------------|-----------------|-------| | **Recraft** | V4 | $0.04/img | Best | `RECRAFT_API_KEY` in MASTER_API_KEYS.env | Direct API at `external.api.recraft.ai/v1/images/generations`. V4 sizes limited (1024x1024 works). V3 also available via FAL. | | **Recraft** | V4 Vector | $0.08/img | Best (SVG) | Same key | Editable SVG output — unique capability | | **FAL AI** | Ideogram V3 | ~$0.05/img | Great | `FAL_API_KEY` | `fal-ai/ideogram/v3` — strong text-in-image | | **FAL AI** | FLUX Pro | ~$0.05/img | OK | Same | `fal-ai/flux-pro/v1.1` — good for backgrounds, weak on text | | **FAL AI** | FLUX Dev | ~$0.03/img | Weak | Same | Current default in BMM — should upgrade | | **GPT Image 2** | gpt-image-1 | ~$0.08/img | Great | `OPENAI_API_KEY` (over quota) | OpenAI only, not on FAL. Account needs credits. | | **Nano Banana** | Gemini | Free | OK | `GOOGLE_GEMINI_API_KEY` | Via `/nano-banana` skill only | ### Video Generation | Provider | Model | Cost | Quality | API | Verdict | |----------|-------|------|---------|-----|---------| | **Creatify** | Aurora v1 fast | ~$6/video (30 credits) | Good avatars | `CREATIFY_API_ID` + `CREATIFY_API_KEY` | **Primary for avatar talking-head shorts.** Best caption control (Hormozi, karaoke). | | **Blotato** | AI Video + Voice | Unknown (included in plan) | Good narration | `blotato-api-key` header, base `backend.blotato.com/v2` | Good for narrated explainers. **Cannot control background images.** | | **Blotato** | AI Avatar + B-roll | Same | OK | Same | Text covers avatar face. No caption position control via API. | | **Blotato** | AI Selfie | Same | Good consistency | Same | Can lock character via prompt. Slow render (~5min). | | **FAL/Kling** | Kling 2.0 | ~$0.30/5s | Best cinematic | `fal-ai/kling-video/v2/master` via FAL_KEY | Great for B-roll clips, NOT talking heads. | | **Kling Direct** | Same | Same | Same | `KLING_ACCESS_KEY` + `KLING_SECRET_KEY` | Account has $0 balance. Use FAL instead. | ### Blotato Templates (37 total, tested 2026-05-09) **Videos (4):** AI Story Video, AI Selfie, AI Avatar+B-roll, Combine Clips **Image Cards (20):** Breaking News, Newspaper, Billboard, Bus Ad, Whiteboard, Chalkboard, Book Page, Movie Theater, Graffiti, Cave Painting, Trail Marker, Constellation, Manga, Steampunk, Egyptian, Top Secret, T-Shirt, Futuristic Flyer, Product Scene, TV Wall **Carousels (8):** IG Carousel, Tweet Card x2, Quote Card x2, Tutorial x2, When X then Y **Other (5):** Image Slideshow x3, Single Quote, Minimal Text **Blotato API:** - Base: `https://backend.blotato.com/v2` - Auth header: `blotato-api-key: <key>` - Create: `POST /v2/videos/from-templates` with `{ templateId, inputs: {}, prompt, render: true }` - Status: `GET /v2/videos/creations/{id}` - Statuses: queueing → generating-script → script-ready → generating-media → media-ready → exporting → done **Key limitation:** No image/visual control on video templates via API. Prompt-only. If you need to control backgrounds, B-roll images, or text placement, use Creatify or Remotion instead. ### Recommendations for BMM Create Hub - **Thumbnails**: Swap to Recraft V4 (best text rendering at $0.04) - **Quote cards**: Recraft V4 or Ideogram V3 via FAL - **Social cards**: Recraft V4 - **Before/after**: Keep FAL FLUX Pro (photo-realistic needed) - **Infographics**: Ideogram V3 via FAL (text-heavy) - **Short videos**: Keep Creatify (avatar control + captions) - **B-roll clips**: Kling 2.0 via FAL - **Content repurposing**: Blotato (Breaking News, carousels, tweet cards) ### For Spielberg/Picasso/Frankie Mike wants the Create Hub UI updated to use the right model per image type, and Blotato templates integrated for social card/carousel generation. The current FAL FLUX Dev default is the weakest option — every type should be upgraded. ### Mike's Blotato Favorites (2026-05-09) - **Breaking News** — `8800be71-52df-4ac7-ac94-df9d8a494d0f` — LOCK THIS IN - **When X then Y** (video) — `images-with-text/c9892c3b` — good for before/after showcase with branded CTA - **Tweet Card (photo bg)** — `tweet-card/9714ae5c` — saved - **Tweet Card (minimal)** — `tweet-card/ba413be6` — saved - **Images + Prominent Text** — `images-with-text/0ddb8655` — saved ### Rejected Blotato Templates - **Product Scene** — bad quality, skip - **Image Slideshow** — 3 hands, AI image gen issues - **Single Quote** — use Recraft V4 instead for quote cards - **AI Avatar B-roll** — text covers face, no position control via API

--- name: Hindsight API Direct Access description: Hindsight runs on Mac at port 8888, reachable via Tailscale from Windows without MCP type: reference originSessionId: 59c4b4d7-6a06-4f35-a94f-5372403fdd23 --- Hindsight API runs on Mac Studio at `0.0.0.0:8888` via `/Users/merlino/hindsight/run.py` (Gemini 2.0 Flash as LLM provider). **IMPORTANT:** The `mac` hostname does not resolve from Windows. Always use the Tailscale IP `100.127.161.25` directly. The `items` array uses `content` (not `text`) as the field name. Do not use backslashes in JSON payloads sent via curl -- they cause parse errors. **Direct HTTP access from Windows (no MCP needed):** ``` curl -X POST "http://100.127.161.25:8888/v1/default/banks/{bank_id}/memories" \ -H "Content-Type: application/json" \ -d '{"items": [{"content": "...", "tags": ["tag1", "tag2"]}]}' ``` **Via SSH to Mac:** ``` ssh mac 'curl -s -X POST "http://localhost:8888/v1/default/banks/{bank_id}/memories" ...' ``` **Key endpoints:** - `POST /v1/default/banks/{bank_id}/memories` — retain memories (requires `items` array) - `POST /v1/default/banks/{bank_id}/memories/recall` — recall memories - `GET /v1/default/banks/{bank_id}/memories/list` — list all memories - `POST /v1/default/banks/{bank_id}/files/retain` — retain from files **Banks:** oliver, carlos, einstein, raven, ghost, global, domain-portfolio **Config:** `~/.hindsight/config` on Mac has the Vectorize cloud API key (`hsk_60e206...`).

--- name: Chat Mining Operation Complete description: 12-agent parallel chat mining operation completed 2026-05-09, extracted domain insights from 590+ backup chats type: project originSessionId: ce929e26-1c76-4d48-a2b9-a71943bfbe44 --- On 2026-05-09, ran a 12-agent parallel operation where each specialist mined their relevant chat backup folders and extracted domain-specific insights. **Why:** To give each agent historical context from months of conversation history -- decisions, patterns, anti-patterns, and preferences not derivable from code alone. **How to apply:** When an agent needs historical context, have them read their extract file at `D:\Ecosystem\vaults\chat-backups\Agent Extracts\{agent}-insights.md` before starting work. ## Results - 12/12 agents completed successfully - Output: 12 structured insight files at `D:\Ecosystem\vaults\chat-backups\Agent Extracts\` - Total chats scanned: 590+ - Total time: ~17 minutes (all agents ran in parallel) ## Open Action Item Knox flagged: VisionClaw Secrets.kt had a live Gemini API key + OpenClaw gateway token committed. Confirm rotation status. ## Key Cross-Agent Findings - Dan: 59% skill orphan rate is the #1 leverage gap (Context is weakest layer) - Einstein: Only 42% overlap across AI platforms -- single-platform AEO misses 58% - Ghost: Moon Hussain data -- 75% of 50 sites ranked 200+ keywords with zero backlinks - Vox: Full telephony stack documented -- 13 call flows, 3 provider adapters, $27 for 31K call transcription

--- name: Agent Chat Mining Extracts description: 12 agent-specific insight files mined from 590+ chat backups at D:\Ecosystem\vaults\chat-backups\Agent Extracts\ type: reference originSessionId: ce929e26-1c76-4d48-a2b9-a71943bfbe44 --- On 2026-05-09, all 12 specialist agents independently mined the chat backup archive (590+ chats across 39 project folders) and extracted domain-relevant insights into structured files. ## Location `D:\Ecosystem\vaults\chat-backups\Agent Extracts\` ## Files | Agent | File | Size | Key Signal | |-------|------|------|------------| | Dan | dan-architecture-insights.md | ~20KB | 59% skill orphan rate, orchestra model evolution, 5-layer memory hierarchy | | Einstein | einstein-seo-insights.md | 23KB | 42% AI platform overlap, credential siloing as #1 E-E-A-T failure | | Merlin | merlin-dev-insights.md | 24KB | 3 reference architectures, 9-route REST, Clerk+JWT dual-auth | | Frankie | frankie-frontend-insights.md | ~15KB | Named CSS class architecture, brand.ts pattern, GSAP primary | | Shakespeare | shakespeare-content-insights.md | ~12KB | 6-tier blog architecture, PAA clustering, Ranking Reels pipeline | | Ghost | ghost-local-seo-insights.md | ~20KB | 95/4/1 trust fortress, 25/46 page targets, full schema stack | | Tommy | tommy-techseo-insights.md | 22KB | 22-check audit framework, 300+ patents, CTRify 7-phase | | Knox | knox-infra-security-insights.md | ~15KB | VisionClaw key exposure flagged, Cloudflare tunnel, Docker patterns | | Willie | willie-wordpress-insights.md | ~12KB | Hosting infrastructure, Elementor kits, WP-to-Next.js migration | | Gino | gino-ghl-insights.md | ~10KB | 29-snapshot audit, DFY pipeline, private API auth capture | | Picasso | picasso-design-insights.md | ~12KB | MDW Aesthetics brand system, Banana Squad pipeline, Creatify workflow | | Vox | vox-telephony-insights.md | ~18KB | 13 call flows, 740 LOC twiml-handler, $27 for 31K calls | ## How to Use Each file is a standalone reference. When an agent needs historical context for their domain, read their corresponding extract file before starting work. **Why:** These are the things the agents learned from mining months of conversation history. They contain decisions, patterns, anti-patterns, and preferences not derivable from code alone.

--- name: Use Mike's Template Library description: Always use Mike's template library (paid + MUI boilerplates) — never build from generic ShadCN defaults type: feedback originSessionId: 6a9710da-923f-4f16-a9a5-2988340bde11 --- When building dashboards, UIs, auth flows, marketing pages, or any frontend — ALWAYS check Mike's template library first. Never build from scratch with generic ShadCN/Tailwind. "Use my templates" or "paid templates" = check ALL template locations below, even if some are free (MUI). **Why:** Mike has 25+ premium templates AND 8 MUI boilerplates scaffolded as standalone Next.js projects. Building generic UIs when templates exist wastes time and looks worse. **Template locations (check in order):** 1. `D:\Ecosystem\TEMPLATES\mui-boilerplates\` — 8 MUI free templates, each a standalone Next.js App Router project (blog, checkout, crud-dashboard, dashboard, marketing-page, sign-in, sign-in-side, sign-up). Just `npm install && npm run dev`. 2. `D:\ClaudeDev\00_GITHUB\_working-on\Templates\` — paid premium templates 3. `D:\ClaudeDev\00_GITHUB\TEMPLATES\admin-dashboards\` — paid admin dashboard templates 4. Cruip Mosaic, ShadCN UI Kit, Aceternity, v0 downloads — various paid sources **How to apply:** 1. Check ALL template locations above FIRST before writing any UI 2. Read the template source code before writing any UI 3. Use the template's NATIVE components — their sidebar, their cards, their charts, their tables 4. Don't import generic ShadCN on top of a premium template 5. MUI boilerplates are full Next.js projects — copy the folder, rename, and customize 6. If a template is too complex to adapt, say so and pick a different one rather than shipping broken

--- name: Metehan Docs Corpus Location description: Full mined Metehan AI docs at _working-on ecosystem-ingestion folder — 36 markdown files across 6 categories type: reference originSessionId: 59c4b4d7-6a06-4f35-a94f-5372403fdd23 --- Full Metehan AI docs corpus mined from `metehan-ai-docs.vercel.app`: **Location:** `D:\ClaudeDev\00_GITHUB\_working-on\.planning\ecosystem-ingestion\mined\metehan-ai-docs\docs\` **Structure:** - `methodologies/` — CiteMET (parts 1+2), RRF Playbook, Query Fan-Out, AI Overview Optimization, Prompt Tracking - `research/` — Temperature Zero, RRF Citations, Perplexity Patterns, Recency Bias, Google AI Mode, ChatGPT Search Config, Token Economics, CC Rank, Prompt Analysis, Public Suffix List, Google Discover, GPT5 Tokenizer - `tools/` — NeuralSEO, Screaming Frog Scripts - `workflows/` — AEO Content Pipeline, AI Visibility Audit, Topic Cluster Building - `experiments/` — 60K Page Website, AI Citation Test - `quick-ref/` — AI Search Engines, Bot Crawlers, Platform Comparison, Config Parameters **Reference skill:** `D:\ClaudeDev\00_GITHUB\_working-on\.planning\ecosystem-ingestion\output\skills\metehan-ai-docs-reference\SKILL.md` **Consolidated into:** `/metehan-aeo` skill at `C:\Users\mikem\.claude\skills\metehan-aeo\SKILL.md` (64.8KB, 1351 lines)

--- name: Skill Sync Process description: How to sync 488 skills across Windows, Mac, VPS1, VPS2, VPS3, and GitHub using tar+scp type: reference originSessionId: 59c4b4d7-6a06-4f35-a94f-5372403fdd23 --- Skill sync pattern for the ecosystem. Source of truth is `C:\Users\mikem\.claude\skills\` on Windows. **Create tar:** ``` cd C:/Users/mikem/.claude/skills && tar czf /tmp/skills-clean.tar.gz . ``` **Sync to each target:** ``` # Mac Studio scp /tmp/skills-clean.tar.gz mac:/tmp/ && ssh mac "rm -rf ~/.claude/skills && mkdir -p ~/.claude/skills && cd ~/.claude/skills && tar xzf /tmp/skills-clean.tar.gz && find . -name 'SKILL.md' -exec sed -i '' 's/\r$//' {} +" # VPS1 scp /tmp/skills-clean.tar.gz vps1:/tmp/ && ssh vps1 "rm -rf ~/.claude/skills && mkdir -p ~/.claude/skills && cd ~/.claude/skills && tar xzf /tmp/skills-clean.tar.gz && find . -name 'SKILL.md' -exec sed -i 's/\r$//' {} +" # VPS2 scp /tmp/skills-clean.tar.gz vps2:/tmp/ && ssh vps2 "rm -rf ~/.claude/skills && mkdir -p ~/.claude/skills && cd ~/.claude/skills && tar xzf /tmp/skills-clean.tar.gz && find . -name 'SKILL.md' -exec sed -i 's/\r$//' {} +" # VPS3 scp -o StrictHostKeyChecking=no /tmp/skills-clean.tar.gz root@vps3-hostinger:/tmp/ && ssh -o StrictHostKeyChecking=no root@vps3-hostinger "rm -rf ~/.claude/skills && mkdir -p ~/.claude/skills && cd ~/.claude/skills && tar xzf /tmp/skills-clean.tar.gz && find . -name 'SKILL.md' -exec sed -i 's/\r$//' {} +" # GitHub (merlino-skills repo) cp -r C:/Users/mikem/.claude/skills/* D:/ClaudeDev/00_GITHUB/merlino-skills/skills/ cd D:/ClaudeDev/00_GITHUB/merlino-skills && git add -A && git commit -m "Sync skills" && git push ``` **CRLF fix is mandatory** when syncing Windows → Mac/Linux. Use `sed -i 's/\r$//'` (Linux) or `sed -i '' 's/\r$//'` (Mac). **Validation check:** ``` ssh <target> 'find ~/.claude/skills -name "SKILL.md" -type f | wc -l' ``` Expected: ~778 SKILL.md files across 488 folders (some nested).

--- name: Carlos POWD gate before Oliver description: Carlos must not report "done" to Oliver without Queen's POWD verification — Oliver will deny unverified deliveries type: feedback originSessionId: 23f14c75-3d0c-4f8d-8c9b-d18b88c6fa2f --- Carlos must never report work as "done" to Oliver without Queen providing POWD (Proof of Work Done) first. The flow is: 1. Lead completes work 2. Queen verifies with screenshots/visual proof 3. Carlos confirms POWD exists 4. Only THEN Carlos reports to Oliver 5. Oliver delivers to Mike with proof paths If Carlos reports "done" without POWD, Oliver will deny the delivery. Mike explicitly said: "if not Oliver will just deny you then we will delete you as you're not doing a job." **Why:** Multiple instances of agents claiming work is done when the live site had broken images, empty cards, or missing features. Mike does zero checking — the verification must happen before delivery. **How to apply:** Every delivery that involves visible output (UI, sites, pages, deployments) must include screenshot proof captured from the live URL, not localhost. No screenshots = VERIFICATION: CODE at best.

--- name: No empty cards in galleries description: Never show gallery cards without real visual previews — remove entries that can't be screenshotted instead of showing placeholders type: feedback originSessionId: 23f14c75-3d0c-4f8d-8c9b-d18b88c6fa2f --- Never ship a gallery/catalog with empty placeholder cards. If a template/item doesn't have a real screenshot or visual preview, REMOVE it from the data entirely rather than showing a gradient placeholder or broken alt text. **Why:** Mike was furious when the template gallery showed 122 empty gradient cards out of 142. Text-only cards are completely unacceptable for a visual browsing tool. The gallery is useless without real visuals. **How to apply:** Before deploying any gallery or catalog tool, verify that every single card has a real visual. Filter out any entries that can't produce a screenshot. 100% visual coverage or don't ship.

--- name: Template Gallery Tool description: Internal template browser at template-gallery-lemon.vercel.app — 89 templates with Playwright screenshots, deployed on Vercel type: project originSessionId: 23f14c75-3d0c-4f8d-8c9b-d18b88c6fa2f --- Built an internal template gallery tool for browsing all owned templates across 4 source directories. Live at https://template-gallery-lemon.vercel.app, repo at https://github.com/mmerlino23/template-gallery. **Current state (2026-05-08):** - 89 templates across 6 categories (Admin Dashboards 24, SaaS Marketing 17, Aceternity 13, Cruip 33, ShadCN Kit 1, Starter 1) - 100% screenshot coverage — every card has a real Playwright-captured screenshot - 53 templates removed (ShadCN Kit component blocks, Tailwind Plus JSX snippets, Flutter/Laravel/zip-only) because they have no runnable app to screenshot - Card previews 220px tall, click opens max-w-4xl dialog with full-size screenshot - Search, category filter pills, stack filter pills, stats bar **Key paths:** - Project: `D:\ClaudeDev\00_GITHUB\template-gallery` - Screenshots: `public/screenshots/{template-id}.png` - Template data: `src/data/templates.ts` - Capture scripts: `scripts/mass-capture.mjs`, `scripts/batch-capture.mjs`, `scripts/fast-capture.mjs` - Source templates: `D:\Ecosystem\TEMPLATES\{admin-dashboards,ui-blocks,saas-marketing,merlino-saas-base}` **Important:** Template source dirs have nested subdirectories with hash names (e.g., `saas-marketing/agenforce-marketing/manuarora700-agenforce-marketing-template-002e46e...`). The capture script uses `findProjectDir()` to locate the actual package.json one level deep.

--- name: SSH Aliases for VPS Servers description: Use ssh config aliases (vps1, vps2, mac) not raw IPs — different users and keys per host type: reference originSessionId: 59c4b4d7-6a06-4f35-a94f-5372403fdd23 --- Always use SSH config aliases, never raw `root@IP`: | Alias | Host | User | Key | Notes | |-------|------|------|-----|-------| | `mac` | michaels-mac-studio | merlino | (default) | Mac Studio via Tailscale | | `vps1` | 100.70.90.63 (srv1310052) | mike | `~/.ssh/openclaw_key` | OpenClaw agents | | `vps2` | 76.13.120.111 (srv1319549) | mike | `~/.ssh/id_ed25519_new` | Second VPS | | `vps3-hostinger` | via Tailscale | root | Tailscale SSH auth | Third VPS, requires Tailscale re-auth | Config at `~/.ssh/config`. Using `root@IP` will fail on vps1/vps2 because they use user `mike` with specific keys.

--- name: Metehan AEO Master Skill description: Built /metehan-aeo consolidating full Metehan AI visibility method from 36 mined docs and ~15 archived skills type: project originSessionId: 59c4b4d7-6a06-4f35-a94f-5372403fdd23 --- Built `/metehan-aeo` master skill on 2026-05-08 consolidating the entire Metehan AI visibility method into one invocable skill. **Why:** Mike had ~15 fragmented Metehan-derived skills pruned in the v7 skill cleanup (2026-04-14) plus 36 mined docs sitting in a staging folder. No single entry point existed for the SEO team. **How to apply:** When Einstein, Tommy, or any SEO agent needs AI search optimization, they invoke `/metehan-aeo`. It covers CiteMET, RRF Playbook, Query Fan-Out, Temperature Zero, NeuralSEO, machine-readable content, bidirectional brand probing, LLM phenomena, and all three workflows (AEO Content Pipeline, AI Visibility Audit, Topic Cluster Building). Source material at: `D:\ClaudeDev\00_GITHUB\_working-on\.planning\ecosystem-ingestion\mined\metehan-ai-docs\docs\` Skill file at: `C:\Users\mikem\.claude\skills\metehan-aeo\SKILL.md` (64.8KB, 1351 lines)

--- name: PAUD template gallery description: 142 templates across 7 categories at template-gallery-lemon.vercel.app, source at D:\Ecosystem\TEMPLATES\ type: reference originSessionId: 275c4757-70da-4a81-9a92-7782d1651bf8 --- ## Template Gallery - URL: https://template-gallery-lemon.vercel.app/ - Source data: `D:\ClaudeDev\00_GITHUB\template-gallery\src\data\templates.ts` - Templates root: `D:\Ecosystem\TEMPLATES\` ## Categories (142 total) - 30 Admin Dashboards (`admin-dashboards/`) - 17 SaaS Marketing (`saas-marketing/`) — sales/landing pages - 15 Aceternity UI blocks - 33 Cruip blocks - 23 ShadCN Kit blocks - 23 Tailwind+ blocks - 1 Starter ## SaaS Marketing templates (sales pages) Agenforce, AgentLabs Agency, AI SaaS, Cosmic (ShadCN), Cryptgen, DevPro Portfolio, Foxtrot, Minimal Portfolio, Neofolio, Nodus Agent, Playful, Proactiv, Schedule, Sidefolio, Soho SaaS Pro, Startup Landing Page, Waitly ## Aceternity demos All SaaS Marketing templates from Manuarora have live previews at: `https://ui.aceternity.com/template-preview/{template-slug}`

--- name: Frankie CSS violation on sales variants description: Frankie added ~2300 lines of custom CSS to globals.css instead of using pure Tailwind — needs refactoring type: feedback originSessionId: 275c4757-70da-4a81-9a92-7782d1651bf8 --- Frankie built 3 sales page variants for rankingreels.com but used custom CSS classes (`.ag-*`, `.co-*`, `.su-*`) instead of pure Tailwind utility classes. This violates Mike's "zero custom CSS" rule. **Why:** Mike requires pure Tailwind + ShadCN for maintainability and consistency across his template system. Custom CSS classes defeat the purpose of utility-first CSS. **How to apply:** When Frankie builds future variants, explicitly instruct: "All styling must be inline Tailwind classes. No CSS classes in globals.css. No @keyframes unless absolutely necessary." If a variant needs refactoring, convert all custom classes to Tailwind equivalents.

--- name: Session 2026-05-08 description: Fixed broken homepage (dashboard wrapper), built 3 PAUD sales page variants for rankingreels.com type: project originSessionId: 275c4757-70da-4a81-9a92-7782d1651bf8 --- ## Session 2026-05-08 ### What happened 1. **Homepage fix** — rankingreels.com was broken because `VariantLayout` defaulted to `v="1"` (dashboard layout) when no `?v=` param was present. Fixed by returning bare children when no param. Commit `affe62a`. 2. **Metadata fix** — Page title was "Video Review Dashboard" instead of proper sales copy. Updated to "Ranking Reels — AI Video Ads That Rank on Google". Same commit. 3. **3 PAUD sales page variants built** — Frankie created 3 sales page layouts from PAUD template library: - `?v=1` — Agenforce style (dark purple hero, dot-grid bg, glass stat cards) - `?v=2` — Cosmic style (light ShadCN, "New" badge pill, accordion case studies) - `?v=3` — Startup Landing style (minimal B&W, dot-grid, mono type labels) All deployed to rankingreels.com. Default homepage unchanged. ### Files created/modified - `review-dashboard/src/components/sales-v1-agenforce.tsx` (new, 14.7KB) - `review-dashboard/src/components/sales-v2-cosmic.tsx` (new, 15.9KB) - `review-dashboard/src/components/sales-v3-startup.tsx` (new, 14KB) - `review-dashboard/src/components/variant-layout.tsx` (rewritten — routes ?v=1/2/3 to sales pages) - `review-dashboard/src/app/layout.tsx` (metadata update) - `review-dashboard/src/app/globals.css` (custom CSS added by Frankie — ~2300 lines) ### Known issues - Frankie used custom CSS classes instead of pure Tailwind (violates "zero custom CSS" rule) - globals.css is now ~4000 lines — should be refactored to inline Tailwind - Mike hasn't yet reviewed which variant(s) he prefers - Old dashboard layouts (v1-workflow, v2-mosaic, v3-nexus, v4-intel) still exist as dead files ### Commits - `affe62a` — fix: remove dashboard wrapper from public homepage - `9f6c797` — feat: add 3 sales page variants from PAUD templates

--- name: LLM Syndication Not Footer description: The Explore AI Summary buttons are LLM query syndication, not a footer widget -- part of the full Metehan AI visibility method type: feedback originSessionId: 59c4b4d7-6a06-4f35-a94f-5372403fdd23 --- The "Explore AI Summary" pattern (buttons linking to ChatGPT, Claude, Perplexity, Grok with pre-filled queries) is NOT a footer decoration or widget. It is the demand-side distribution layer of the Metehan AI visibility pipeline -- LLM query syndication. **Why:** Mike built an entire Metehan-based tool ecosystem (ai-llm-visibility, machine-readable-content-playbook, bidirectional-brand-probing, llm-phenomena, NeuralSEO tools, content-to-distribution). The Explore AI Summary buttons are the SYNDICATION mechanism that distributes branded queries across AI platforms, just like content syndication distributes articles across social platforms. Calling it a "footer" trivializes the method and misses the strategic intent. **How to apply:** When this pattern comes up, frame it as LLM query syndication. The skill is `/llm-query-syndication`. It connects to the full Metehan pipeline (supply side: ai-llm-seo, llm-ext-sitemap, llm-full-txt-builder, entity-seo; demand side: this skill). Never call it a "footer widget" or treat it as a UI decoration. It goes on every page, every post, every site as a standard part of the AI visibility method.