brainoutside-template

This repo is a brain: one structured, git-versioned knowledge base that your AI agents read from for context, facts, and voice. Plain markdown, one idea per file, with a contract strict enough that agents can be trusted to retrieve from it — and to propose additions to it.

It is designed to be served by BrainOutside, which clones this repo and exposes it over REST + MCP with visibility tiers and a human-gated write path. It also works perfectly well on its own, read directly by Claude Code.

**CLAUDE.md is the contract.** Read it before anything else. Two skills in .claude/skills/ are the only interfaces: mind-feeder writes (gated), mind-reader reads.

Get the loop running (10 minutes)

• Use this template (the GitHub button) to create your copy —

and make it private. This repo will hold your unpublished thinking; private is not optional.

• Clone it and open the folder in VS Code (or any editor) with

Claude Code.

• Feed something: say "feed this into my brain" with a link, a

transcript, or just a raw thought. mind-feeder proposes 2–4 notes and stops — nothing is written until you approve.

• Ask something: "using my brain, what's my take on …".

mind-reader pulls the right handful of files through a lens and answers in your voice.