# Genesis Living Sitemap PRD
Execute via Gemini Flash 2.0 Ralph Wiggum Loop

## Context
Create an interactive living sitemap for Genesis - a visual map agents can click to navigate the system instantly.

### US-001: Mermaid Sitemap Source
**Goal:** Generate Mermaid flowchart source showing all Genesis components with click handlers

**Acceptance Criteria:**
- GIVEN component registry WHEN processed THEN valid Mermaid flowchart generated
- AND includes subgraphs for Core, Memory, AIVA, Skills, Infrastructure
- AND each node has click handler linking to VS Code
- AND renders without syntax errors

**Files to Create:**
- /mnt/e/genesis-system/SITEMAP.md

**Technical Hints:**
Use flowchart TB with subgraphs. Click handlers format: click nodeId "vscode://file/path". Include Genesis Kernel, Heartbeat, Memory Cortex, Blackboard, AIVA Daemon, Triple Gate, GHL Skill, Voice Skill.

**Dependencies:** None

---

### US-002: Info Desk Reference
**Goal:** Create quick-reference markdown document for instant answers

**Acceptance Criteria:**
- GIVEN Genesis components WHEN documented THEN Info Desk created
- AND includes Where do I start section
- AND includes component one-liners table
- AND includes Entry Points by Task section
- AND includes Common Questions FAQ

**Files to Create:**
- /mnt/e/genesis-system/docs/SITEMAP_INFO_DESK.md

**Technical Hints:**
Format as markdown with tables. Key entry points: HANDOFF.md (session state), CLAUDE.md (briefing), genesis_kernel.py (orchestrator). Include cognitive loop explanation.

**Dependencies:** None

---

### US-003: Sitemap Generator Script
**Goal:** Python script to auto-regenerate sitemap from codebase

**Acceptance Criteria:**
- GIVEN command python sitemap/generator.py WHEN run THEN sitemap regenerated
- AND scans core/ AIVA/ skills/ directories
- AND outputs SITEMAP.md with valid Mermaid
- AND logs component count

**Files to Create:**
- /mnt/e/genesis-system/sitemap/generator.py

**Technical Hints:**
Use os.walk to scan directories. Extract Python file names as components. Generate Mermaid flowchart syntax. Include timestamp in output.

**Dependencies:** US-001

---

### US-004: Refresh Command
**Goal:** CLI command to refresh sitemap with single command

**Acceptance Criteria:**
- GIVEN command python sitemap/refresh.py WHEN executed THEN full sitemap refresh
- AND runs generator
- AND updates SITEMAP.md
- AND prints success message with component count

**Files to Create:**
- /mnt/e/genesis-system/sitemap/refresh.py

**Technical Hints:**
Import generator module. Call main function. Print emoji success message. Include timestamp.

**Dependencies:** US-003

---

### US-005: CSS Stylesheet
**Goal:** Create stylesheet for sitemap visual styling

**Acceptance Criteria:**
- GIVEN SITEMAP.html WHEN styled THEN dark theme applied
- AND uses Genesis color scheme (green core, blue memory, purple AIVA)
- AND responsive layout
- AND smooth hover transitions

**Files to Create:**
- /mnt/e/genesis-system/sitemap/styles.css

**Technical Hints:**
Use CSS variables for colors. Dark background #1a1a2e. Card background #16213e. Core green #4CAF50. Memory blue #2196F3. AIVA purple #9C27B0.

**Dependencies:** None

---

### US-006: CLAUDE.md Sitemap Reference
**Goal:** Update CLAUDE.md to point agents to sitemap first

**Acceptance Criteria:**
- GIVEN CLAUDE.md WHEN opened THEN sitemap mentioned in first section
- AND includes tip box directing to SITEMAP.html
- AND mentions Info Desk document

**Files to Create:**
- /mnt/e/genesis-system/sitemap/claude_update.txt

**Technical Hints:**
Create text snippet to prepend to CLAUDE.md. Use markdown tip syntax. Include file paths for SITEMAP.html and SITEMAP_INFO_DESK.md.

**Dependencies:** US-002
