MindBridge

Bridge the gap between AI output and human understanding.

AI generates information at superhuman speed and density. Human brains are biological — they can only absorb information through specific cognitive patterns. MindBridge solves this mismatch.

The Problem

When AI explains something complex, it often dumps a wall of text that's technically correct but cognitively overwhelming. The bottleneck is not the AI — it's the human brain.

The Solution

MindBridge is a collection of markdown files that teach AI agents how to communicate in ways that align with how human brains actually learn. It's built on 4 research-backed learning science frameworks:

Framework	Researcher	Core Idea
Cognitive Load Theory	John Sweller	Working memory holds ~4 chunks. Don't overload it.
Feynman Technique	Richard Feynman	If you can't explain it simply, you don't understand it.
Multimedia Learning	Richard Mayer	Words + visuals > words alone (with rules).
Progressive Disclosure	Nielsen Norman Group	Show essentials first, details on demand.

How It Works

MindBridge is zero-code, zero-dependency, zero-install. It's just markdown files that any AI agent can read.

You + AI Agent
      │
      │  Feed these markdown files to your agent:
      │
      ├── SPEC.md              → How to structure content for human brains
      ├── domains/general/     → Universal learning methods
      ├── templates/default.md → Output style guide
      └── skills.md            → Commands: /learn, /html, /md

Quick Start

1. Copy SPEC.md and skills.md into your AI agent's context
2. Use the commands:

Command	What it does
/learn	AI teaches you using the best format for the content
/html	Generate a rich HTML preview and open in browser
/md	Generate a Markdown document

Works with any AI agent — GitHub Copilot CLI, Claude Code, Cursor, ChatGPT, or anything that reads text.

Project Structure

mindbridge/
├── README.md                    # You are here
├── SPEC.md                      # Core specification (4 frameworks)
├── skills.md                    # Command router (/learn, /html, /md)
├── domains/
│   ├── general/METHOD.md        # Universal learning methods
│   └── _template/METHOD.md      # Template for contributors
├── templates/
│   ├── default.md               # Default output style
│   └── _template.md             # Template for contributors
└── examples/                    # Before/after demos

Contributing

MindBridge is 100% markdown. Anyone can contribute — no coding required.

Add a Learning Domain

1. Copy domains/_template/METHOD.md
2. Fill in the research basis and learning principles for your domain
3. Submit a PR

Add an Output Template

1. Copy templates/_template.md
2. Describe the visual style and layout rules
3. Submit a PR

Philosophy

• Human brain is the bottleneck, not AI. Design for the reader.
• Research-backed, not opinion-based. Every principle cites a framework.
• Zero dependencies. Just markdown. Any AI can read it.
• Community-driven domains. Experts contribute how their field is best learned.

License

MIT