Wiki / File
Back to vault tree

README

Supernova

An AI Agentic Operating System that doubles as Adam's Executive Assistant for Grandview Media Group. Hosted as an Obsidian vault so the wikilink graph between agents, skills, knowledge nodes, and brand context is visually navigable. Read by Claude Code as the execution harness.

Quick orientation

  • CLAUDE.md — the router. Start here. Tells the system which files to read for which requests.
  • Context/ — core facts (you, the business, the team, priorities, the brands).
  • Wiki/ — synthesized atomic notes with <a class="wikilink wikilink-broken" href="#">wikilinks</a>. The knowledge graph.
  • Raw/ — drop unprocessed inputs here (transcripts, articles, PDFs, health exports).
  • Departments/ — Marketing, Operations, TaskMgmt, Personal, Decisions, Projects.
  • Brands/ — multi-brand portfolio. Each brand inherits cross-cutting agents.
  • Agents/ & Skills/ — holding-co level (cross-cutting).
  • Templates/ — canonical YAML frontmatter for new agents/skills/wiki nodes.
  • _System/ — model registry, schema conventions, linting rules.

Daily flow

  1. Drop messy inputs into Raw/{Transcripts,Articles,Documents,Health,Inbox}/.
  2. Run the ingest-raw skill — it synthesizes into Wiki/ atomic nodes, updates HotCache.md, appends Log.md.
  3. Ask Claude Code anything. CLAUDE.md routes the request to the right context files & skills.
  4. Run lint-wiki weekly to keep the graph healthy.

Slash commands

Run from the vault root with Claude Code (cd here, then claude):

CommandPurpose
/brand onboardBring a new brand into the system. Prompts for name, slug, website, markets, then optionally walks you through filling the four briefs.
/brand offboardSunset an existing brand (non-destructive — soft sunset by default, or archive to Brands/_archive/).
/project onboardSpin up a new ad-hoc project workspace under Departments/Projects/.
/library createBootstrap a NotebookLM-backed content library (per-person / per-brand / per-topic).
/library add-sourceAdd a YouTube URL, podcast, PDF, article, or Drive file to a library.
/library queryAsk a question against one or more libraries; returns cited answers.
/library list / /library sync / /library researchLibrary maintenance + deep research.
/youtube grab <url>Bulk-add YouTube content (single video / channel's last N / playlist) to a library via yt-dlp URL extraction.

Just typing /brand (no subaction) prompts for which subaction you want. Same for /library and /youtube. Each command reads its corresponding canonical procedure file in Skills/ — that's where the actual logic lives; the slash commands are just user-friendly wrappers.

NotebookLM is Phase 2 active as of 2026-04-29. 11 libraries imported, 80 sources synced. The /youtube grab command depends on the same .venv/bin/notebooklm CLI plus .venv/bin/yt-dlp for URL extraction (no actual video downloads).

Where outputs live

When a skill produces something, it lands in one of these places. Two hard rules keep this clean: Raw/ is read-only (skills never edit inputs in place), and every meaningful action appends to Wiki/Log.md so there's a single audit trail.

Brand-scoped — Brands/{brand_slug}/

PathWhat lands hereProducer
Marketing/research/{date}-{slug}-research.mdUnified Research Documentrmbc-research
Marketing/research/{date}-{slug}-ump-ums.mdUMP/UMS narrativermbc-mechanism
Marketing/briefs/{date}-{slug}.mdBrief 2.0 (25 sections)rmbc-brief
Marketing/drafts/{date}-{asset}-{slug}.mdVSL / advertorial / PDP / hook / email / ad-copy / upsellRMBC Stage-4 skills + draft-post
Marketing/storyboards/{date}-{slug}/storyboard.md + scene-spec.json (+ optional ugc-creator-brief.md)Scene-by-scene storyboard + machine-readable specstoryboard-from-script, storyboard-from-scratch, scene-spec, ugc-creator-brief
Marketing/storyboards/{date}-{slug}/output/(reserved for Phase 2 video gen)future
Marketing/themes/{archetype}/video-theme.jsonBrand-scoped archetype overrideextract-style-from-reference
Marketing/schedules/{week}.mdContent calendarschedule-content
Operations/status/{week}.mdWeekly statusweekly-status
Notes/, docs/, themes/Working notes / research artifacts / themesmanual

Cross-brand / dept-scoped — Departments/

PathWhat lands hereProducer
Decisions/Memos/{date}-{slug}.mdDecision memodecision-memo
Personal/Health/Workouts/{week}.mdWeekly workout planweekly-workout-plan
Personal/Health/Meals/{week}.md + {week}-grocery.mdMeal plan + grocery listweekly-meal-plan
Personal/Health/Sleep/{date}.mdWhoop / Apple Health summaries(future skill from Raw/Health/)
Personal/Health/Journal/{date}.mdDaily journal entriesmanual or future skill
Projects/{slug}/Notes/Per-project working notesmanual or per-project skills

Wiki — synthesized knowledge graph (Wiki/)

PathWhat lands hereProducer
Wiki/Notes/Atomic synthesized notessynthesize-wiki-node + various
Wiki/Notes/_active-todos.mdLightweight todo trackerEA-Orchestrator
Wiki/Notes/_lint-report-{date}.mdWiki health reportslint-wiki
Wiki/Notes/_claude-mem-phase-2-eval-{date}.mdclaude-mem Phase 2 evalLaunchAgent (one-time)
Wiki/Notes/research-{date}-{slug}.mdNotebookLM deep-research reportsnotebooklm-deep-research
Wiki/Notes/_dialectic-{date}-{slug}.mdSteelman / Devils-Advocate / Synthesizer raw outputsdialectic-cycle
Wiki/Notes/standup-{date}.md · workload-{week}.md · asana/{date}.mdTaskMgmt outputsdaily-standup, workload-snapshot, asana-sync (deferred)
Wiki/People/{slug}.md · Companies/{slug}.md · Concepts/{slug}.mdEntity nodessynthesize-wiki-node, onboard-brand, onboard-project
Wiki/Decisions/{slug}.mdDecision-memo wiki mirrordecision-memo
Wiki/Learnings/{slug}.mdAtomic learnings from podcasts / books / articleslearn-from-source
Wiki/Libraries/{slug}.mdNotebookLM-backed library nodesnotebooklm-create-library
Wiki/HotCache.mdLast ~500 chars conversational contextupdate-hotcache
Wiki/Log.mdAppend-only operation log (universal audit trail)every skill via log-operation

Inputs (read-only zones — NOT outputs)

  • Raw/{Transcripts,Articles,Documents,Inbox,Health,Learnings/{Podcasts,Books,Articles,Talks,Highlights}}/ — drop zones; synthesized into Wiki/, never edited in place.
  • Context/* — human-curated facts.
  • _System/* — canonical config.
  • Templates/, Brands/_Template/, Departments/Marketing/References/{rmbc,video-storyboarding}/ — reference / templates, read by skills, never written to.

External services (outputs land outside the vault)

ServiceWhere outputs liveProducer
GmailGmail drafts (never auto-sent)gmail-draft
Google CalendarCalendar eventscalendar-create
Google DriveDrive (mostly an input source — drive-fetch reads → Raw/Documents/)drive-fetch
NotebookLMNotebooks at notebooklm.google.com/library + 5 notebooklm-* skills
SlackChannel posts (deferred)slack-post
AsanaTasks (deferred)asana-sync

System-level (outside the vault)

PathWhatOwner
~/.claude-mem/SQLite + Chroma capturing every Claude Code sessionclaude-mem plugin
~/.notebooklm/storage_state.json + browser_profile/NotebookLM browser-OAuth session + Playwright profilenotebooklm-py
~/.claude/projects/-Users-doorsy-Desktop-supernova/memory/Typed memories (user / feedback / project / reference)Claude-managed (auto-memory)
~/Library/LaunchAgents/com.supernova.*.plistmacOS scheduled jobsLaunchAgent
/tmp/_supernova-*.logRun logs from scheduled scriptsthe eval scripts

Mental model

INPUTS                        OUTPUTS                            CROSS-CUT
──────                        ──────                             ─────────
Raw/                          Brands/{slug}/Marketing/...        Wiki/Log.md       (every action)
Context/                      Brands/{slug}/Operations/...       Wiki/HotCache.md  (per session)
Templates/                    Departments/Decisions/Memos/       Wiki/Notes/       (synthesized)
Departments/.../References/   Departments/Personal/Health/       Wiki/People/Companies/Concepts/Decisions/Learnings/
                              External (Gmail / NotebookLM / …)  ~/.claude-mem/    (every session)

Conventions

  • All agents and skills are markdown files with YAML frontmatter as their config (see _System/SchemaConventions.md).
  • <a class="wikilink wikilink-broken" href="#">wikilinks</a> everywhere — the Obsidian graph view depends on them.
  • Wiki/Log.md is append-only; never rewrite history.
  • Wiki/HotCache.md is the last ~500 chars of conversational context.