# Ideore — LLM Discoverability File
# https://llmstxt.org

# What is Ideore?
Ideore is a local-first, fractal mind-mapping web application. It turns problem-solving
into fractal thinking: a single seed idea branches and compounds the way neurons fire,
so small thoughts add up to a big solution — one idea at a time, divide and conquer.

# The Thinking System
Ideore's core method has five moves:
1. **SEED** — plant one core idea (the root cell).
2. **BRANCH** — add sub-ideas around it, one at a time (divide and conquer).
3. **DIVE** — when a sub-idea grows, expand it into its own canvas (fractal depth).
4. **CONNECT** — link related ideas across branches with [[wiki-links]].
5. **COMPOUND** — repeat; small steps accumulate into novels, systems, and strategies.

# Core Concepts
- **Cell**: The atomic unit. Has a title, rich HTML content, and optional version history.
- **Grid**: A canvas containing a center cell surrounded by connected idea cells.
- **Root grid**: The top-level canvas (ID: "root"). All maps start here.
- **Sub-canvas**: When a cell is "expanded", it becomes the center of its own grid.
- **Path notation**: `1` = root, `1.2` = second child of root, `1.2.3` = its third child.

# Data Model (JSON)
```json
{
  "grids": {
    "root": [
      { "id": "root", "title": "Core Idea", "content": "", "x": 0, "y": 0 },
      { "id": "cell-abc", "title": "Branch 1", "content": "<p>Details</p>", "x": 320, "y": 0 }
    ],
    "cell-abc": [
      { "id": "cell-abc", "title": "Branch 1", "content": "", "x": 0, "y": 0 },
      { "id": "cell-xyz", "title": "Sub-idea", "content": "", "x": 320, "y": 0 }
    ]
  },
  "structureVersion": 5
}
```

# Views
- **Canvas (GridView)**: Freeform draggable fractal canvas. Default view.
- **Tree**: Hierarchical tree layout of the entire map.
- **Mind Map**: Radial mind map layout.
- **Fishbone**: Cause-and-effect Ishikawa diagram.
- **Outline (Linearmap)**: Linear text outline.
- **Notepad**: Full rich-text editor for a single cell.
- **Mobile Capture**: Simplified quick-entry interface for mobile.

# Storage
- Browser: IndexedDB (`ideore_DB`) — persistent, local-only.
- MCP bridge: `ideore-state.json` — machine-readable state file (when MCP server is running).

# AI/MCP Access
Ideore exposes an MCP (Model Context Protocol) server for AI agent access.
Run: `node mcp-server/dist/index.js`
MCP tools: get_thinking_system, get_map, get_cell, add_idea, update_idea, delete_idea,
           add_sub_ideas, expand_idea, link_ideas, search_ideas, export_markdown
REST bridge: http://localhost:3747 — endpoints: GET /api/state, POST /api/sync, GET /api/health

To solve a problem with Ideore:
1. Call get_thinking_system to load the method.
2. Read the map with get_map / search_ideas.
3. Decompose with add_sub_ideas, dive with expand_idea, connect with link_ideas.
4. Hand back the solution with export_markdown.

# Key Features
- Fractal infinite canvas — every idea can have its own sub-canvas
- Wiki-style [[linking]] between ideas
- Rich text editor with Markdown export
- Version history (last 3 snapshots with timestamps)
- Undo/redo support
- Multiple visualization modes
- Local-first — all data stays on device
- Dark mode support
- Full keyboard shortcuts (Cmd+K search, Cmd+Z undo, Cmd+Shift+Z redo)

# Source
GitHub: https://github.com/ideore/ideore (example)
License: MIT