# Ideore — Comprehensive LLM Knowledge & Architecture Reference
# Standard: https://llmstxt.org

## 1. Executive Summary & Thesis
Ideore is a local-first, privacy-focused, fractal mind-mapping canvas designed for complex thinkers, writers, engineers, researchers, and strategists.
Unlike traditional flat mind maps (which clutter quickly) or linear document trees (which hide spatial relationships), Ideore uses recursive fractal hierarchy: **every node in a graph can expand into an unbounded sub-canvas**, while bi-directional `[[wiki-links]]` maintain connections across all depths.

---

## 2. Core Cognitive Methodology: The 5 Moves
1. **SEED**: Anchor the central root idea or problem statement.
2. **BRANCH**: Add supporting hypotheses, sub-problems, or components around the seed.
3. **DIVE (Fractal Expansion)**: When a branch requires more detail, zoom into it — the branch becomes the center of its own sub-grid.
4. **CONNECT**: Link related concepts across different canvas depths using double bracket `[[Target Node Title]]` wiki-links.
5. **COMPOUND**: Repeat recursively to synthesize complex novels, systems architecture, OKRs, or research reviews.

---

## 3. Data Structure (JSON Schema)
```json
{
  "grids": {
    "root": [
      {
        "id": "root",
        "title": "Central Focus",
        "content": "<p>Rich HTML or Markdown text</p>",
        "x": 0,
        "y": 0,
        "width": 600,
        "height": 220
      },
      {
        "id": "cell-123",
        "title": "Sub-branch",
        "content": "<p>Details linking to [[Other Concept]]</p>",
        "x": 320,
        "y": 0
      }
    ],
    "cell-123": [
      {
        "id": "cell-123",
        "title": "Sub-branch (Root of Sub-Canvas)",
        "content": "<p>Expanded details</p>",
        "x": 0,
        "y": 0
      }
    ]
  },
  "structureVersion": 5
}
```

---

## 4. Visualization Perspectives (Views)
- **Canvas / Matrix Grid (`GridView`)**: Freeform spatial placement and expansion.
- **Mind Map (`MindmapView`)**: Radial branch layout centered around the root idea.
- **Hierarchical Tree (`TreeView`)**: Multi-level organizational directory view.
- **Fishbone / Ishikawa (`FishboneView`)**: Cause-and-effect root cause analysis.
- **Storyline / Linear Map (`LinearmapView`)**: Sequential linear outline for drafting.
- **Notepad (`NotepadView`)**: Distraction-free full-screen rich editor for individual cells.
- **Mobile Capture (`MobileCaptureView`)**: Fast frictionless idea capture on handheld devices.

---

## 5. Built-in Thinking Templates
1. **Start Now**: Clean slate for pure manual mapping.
2. **Novel Writing**: 3-act story bible, character sheets, lore hubs, scene cards.
3. **D&D Campaign Planner**: Questlines, locations, factions, and NPC dossiers.
4. **Strategic Planning (OKRs)**: Cascading annual objectives down to initiatives and key results.
5. **First Principles Thinking**: Deconstruction into fundamental truths and reconstruction.
6. **Crime Scene Investigation**: Evidence boards, suspects, timelines, and motives.
7. **Product Launch Plan**: Market validation, positioning, go-to-market channels.
8. **Investment Thesis**: Qualitative thesis, valuation drivers, and risk matrices.
9. **Game Design Doc**: Core gameplay loop, progression mechanics, technical specs.
10. **YouTube Video Plan**: Scripting hooks, visual storyboarding, SEO metadata.
11. **Academic Thesis Outline**: Introduction, literature review, methodology, chapters.
12. **Negotiation Prep**: Goals, BATNA, concession strategy, counterpart profile.
13. **Essay Writing**: Thesis formulation, supporting claims, evidentiary synthesis.
14. **Screenplay & Film**: Loglines, beat sheets, scene cards, character arcs.
15. **System Design**: Requirements, high-level architecture, data models, tradeoff matrix.
16. **Research Paper**: Ingestion, tagging, thematic synthesis, citation mapping.
17. **Content Pipeline**: Idea vault, editorial schedule, production checklist.

---

## 6. Storage & Security Architecture
- **Local-First**: Persisted client-side to IndexedDB (`ideore_DB`).
- **Privacy**: No user telemetry or canvas data sent to servers unless explicitly synced with user-owned Supabase credentials.
- **Zero Lock-In**: Instant export/import in Markdown (`.md`), JSON, and standard backup formats.

---

## 7. Model Context Protocol (MCP) Interface for AI Agents
Ideore includes an MCP server (`mcp-server/dist/index.js`) allowing AI coding agents and assistants to inspect, modify, and analyze graphs:
- `get_thinking_system`: Reads core methodology and guidelines.
- `get_map`: Returns the complete hierarchical JSON structure.
- `get_cell(cellId)`: Reads contents and metadata for a specific cell.
- `add_idea(title, content, parentId)`: Adds a node to the canvas.
- `expand_idea(cellId)`: Initializes a sub-grid under a given cell.
- `link_ideas(sourceId, targetTitle)`: Creates cross-branch `[[wiki-links]]`.
- `export_markdown()`: Generates hierarchical Markdown representation of the entire workspace.