# Genesis Sitemap Research PRD
*Deep Research: Best-in-Class Instant Orientation Systems - January 2026*

**Mission:** Find and analyze the most excellent examples of visual sitemap / instant orientation / codebase navigation systems. Extract learnings to enhance Genesis Living Sitemap.

---

### US-001: CodeSee Deep Dive
**Goal:** Research CodeSee.io - analyze their codebase visualization approach

**Acceptance Criteria:**
- Document CodeSee key features for codebase mapping
- Identify their interactive tour functionality
- Extract their code ownership visualization approach
- Note pricing and open-source alternatives
- Output learnings for Genesis

**Files to Create:**
- /mnt/e/genesis-system/logs/sitemap_research/codesee_analysis.md

**Technical Hints:**
Research CodeSee Maps, Code Tours, Reviews features. Focus on how they auto-generate codebase visualizations. Note any APIs or embedding capabilities. Document onboarding acceleration claims.

**Dependencies:** None

---

### US-002: Eraser.io Analysis
**Goal:** Research Eraser.io - AI-generated diagrams for technical documentation

**Acceptance Criteria:**
- Document Eraser AI diagram generation capabilities
- Analyze their self-updating codebase diagram feature
- Note their diagramming API for automation
- Extract markdown integration approach
- Output learnings for Genesis

**Files to Create:**
- /mnt/e/genesis-system/logs/sitemap_research/eraser_analysis.md

**Technical Hints:**
Focus on Eraser DiagramGPT, GitHub integration, how diagrams stay current with code. Document their VS Code extension. Note Confluence/Notion integrations.

**Dependencies:** None

---

### US-003: D2 Language Research
**Goal:** Research D2 diagramming language - modern Mermaid alternative

**Acceptance Criteria:**
- Compare D2 vs Mermaid syntax and capabilities
- Document D2 layout engines including TALA
- Analyze D2 CLI workflow
- Note D2 watch mode for live updates
- Extract benefits over Mermaid for Genesis

**Files to Create:**
- /mnt/e/genesis-system/logs/sitemap_research/d2_analysis.md

**Technical Hints:**
D2 at d2lang.com. Focus on unified syntax, Go-based CLI, multiple layout engines. Compare to Mermaid complexity. Note TerraStruct commercial backing.

**Dependencies:** None

---

### US-004: Swimm Documentation Platform
**Goal:** Research Swimm - AI-powered code documentation for onboarding

**Acceptance Criteria:**
- Document Swimm auto-sync documentation feature
- Analyze their interactive code walkthrough system
- Note how docs stay current with code changes
- Extract their IDE integration approach
- Output learnings for Genesis agent onboarding

**Files to Create:**
- /mnt/e/genesis-system/logs/sitemap_research/swimm_analysis.md

**Technical Hints:**
Focus on Swimm's ability to keep docs synchronized with code. Document their snippet tracking. Note enterprise adoption patterns. Analyze onboarding time reduction claims.

**Dependencies:** None

---

### US-005: tldraw Canvas Platform
**Goal:** Research tldraw - open-source infinite canvas for developers

**Acceptance Criteria:**
- Document tldraw embedding capabilities
- Analyze their real-time collaboration features
- Note self-hosting and customization options
- Extract their shape/component library approach
- Assess fit for Genesis interactive sitemap

**Files to Create:**
- /mnt/e/genesis-system/logs/sitemap_research/tldraw_analysis.md

**Technical Hints:**
tldraw is fully open source. Focus on SDK for embedding, React integration, multiplayer capabilities. Note their v2 rewrite benefits.

**Dependencies:** None

---

### US-006: FalkorDB Code Graph
**Goal:** Research FalkorDB Code Graph - knowledge graph for codebase visualization

**Acceptance Criteria:**
- Document Code Graph's LLM-powered analysis
- Analyze natural language querying of codebase
- Note integration with existing knowledge graphs
- Extract dynamic visualization capabilities
- Assess fit for Genesis GraphRAG integration

**Files to Create:**
- /mnt/e/genesis-system/logs/sitemap_research/falkordb_analysis.md

**Technical Hints:**
FalkorDB uses knowledge graphs plus LLMs. Focus on their code structure visualization, dependency analysis, and query interface. Note open-source availability.

**Dependencies:** None

---

### US-007: Emerging AI Codebase Tools 2026
**Goal:** Survey latest AI-powered codebase understanding tools released in 2025-2026

**Acceptance Criteria:**
- Identify top 5 new tools for AI codebase navigation
- Document any agent-specific orientation tools
- Note tools with MCP or Claude integration
- Extract innovative UX patterns
- Compile feature comparison table

**Files to Create:**
- /mnt/e/genesis-system/logs/sitemap_research/emerging_tools_2026.md

**Technical Hints:**
Search for Cursor features, Zed editor capabilities, Windsurf, Augment Code, Continue.dev. Focus on how modern AI IDEs handle codebase understanding. Note any visual mapping innovations.

**Dependencies:** None

---

### US-008: Synthesis Report
**Goal:** Synthesize all research into actionable recommendations for Genesis Sitemap

**Acceptance Criteria:**
- Compile top 10 features to incorporate
- Prioritize by implementation effort vs value
- Create upgrade roadmap for Genesis Sitemap
- Document tool integrations to consider
- Output final recommendations

**Files to Create:**
- /mnt/e/genesis-system/logs/sitemap_research/SYNTHESIS_REPORT.md

**Technical Hints:**
Combine learnings from all previous stories. Focus on: auto-updating diagrams, AI generation, interactive tours, knowledge graph integration, embedding options. Prioritize features that accelerate agent orientation.

**Dependencies:** US-001 through US-007
