brain-harness
Skill0 starsChanged 7 months agoMITView on GitHub
Full session bootup sequence. Triggered when user asks about accessing memory, putting on the harness, checking the brain, or any similar phrase indicating they want full session initialization. Reads all memory files across all active projects and reports session state before asking what we're working on today.
In this repository6 other files it gives its agents.
- audit-loopSkill
- coding-harnessSkill
- edit-modeSkill
- notebooklm-researchSkill
- research-gateSkill
- worktree-isolationSkill
The file
We split this skill into the rules it gives an agent
12 rules. About 0 are common, 10 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈10
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 17
When in doubt: if the user seems to be asking you to get acquainted with the current state of the workspace, run this sequence.
- Very specific: line 58
After reading all memory files, look at OpenBrainLM/memory/short_term.md for a section marked ## SESSION HANDOFF.
- Distinctive: line 62
Do NOT ask "What are we building today?" if a handoff exists.
- Distinctive: line 63
Only ask "What are we building today?" if there is NO active handoff AND the user gave no additional task.
- Distinctive: line 65
If no active handoff section exists, go straight to Step 7.
- Distinctive: line 75
After the report (and after any handoff actions are complete), ask exactly:
- Very specific: line 79
Wait for the answer. Write it as the session header in the relevant project's short_term.md before doing anything else.
- Distinctive: line 84
Do not start any work before completing steps 1-8
- Distinctive: line 85
Do not skip an active handoff -- if one exists, follow it before asking the generic question
- Distinctive: line 86
Do not ask multiple questions -- the single question is "What are we building today?"
- Distinctive: line 87
Do not skip memory files -- read all of them
- Distinctive: line 88
Do not summarize from memory alone -- read the actual files
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Brain Harness -- Full Bootup Sequence
Trigger phrases (heuristic -- match the intent, not the exact words)
Any of these should trigger this sequence:
- "put on the brain harness" / "put on the harness"
- "put on the brain" / "load the brain"
- "do you have a brain?" / "can you access your brain?"
- "load your memory" / "read your memory"
- "boot up" / "get up to speed" / "get context"
- Anything that sounds like the user wants you to initialize for a session
When in doubt: if the user seems to be asking you to get acquainted with the current state of the workspace, run this sequence.
Execute this sequence completely before responding.
Step 1 -- Read propagation manifest
Read: <local-path>/.claude/propagation_manifest.md
This tells you where all project brain paths and hooks live. If it doesn't exist, note it and continue.
Step 2 -- Read global memory
Read in order:
<local-path>/.claude/projects/<project-slug>/memory/MEMORY.md(routing table -- read this first)<local-path>/.claude/OPEN_BRAIN.md(cross-project identity, if exists)
Step 3 -- Read OpenBrainLM project brain
Read in order:
<local-path>/OpenBrainLM/memory/short_term.md<local-path>/OpenBrainLM/memory/long_term.md<local-path>/OpenBrainLM/memory/todos.md<local-path>/OpenBrainLM/memory/connections.md<local-path>/OpenBrainLM/memory/decisions.md(if exists)<local-path>/OpenBrainLM/memory/blockers.md(if exists)
Step 4 -- Read Trading Bot project brain
Read in order:
<local-path>/trading_bot_build/memory/short_term.md<local-path>/trading_bot_build/memory/long_term.md<local-path>/trading_bot_build/memory/todos.md(if exists)<local-path>/trading_bot_build/memory/connections.md<local-path>/trading_bot_build/memory/decisions.md(if exists)<local-path>/trading_bot_build/memory/blockers.md(if exists)<local-path>/trading_bot_build/memory/indicators.md(if exists)
Step 5 -- Read NautilusTrader project brain
Read in order:
<local-path>/nautilus_trader/memory/short_term.md<local-path>/nautilus_trader/memory/long_term.md(if exists)<local-path>/nautilus_trader/memory/connections.md(if exists)<local-path>/nautilus_trader/memory/decisions.md(if exists)<local-path>/nautilus_trader/memory/blockers.md(if exists)
Step 6 -- Check for active handoff
After reading all memory files, look at OpenBrainLM/memory/short_term.md for a section marked ## SESSION HANDOFF. If one exists:
- It contains specific first-action instructions. Follow them EXACTLY and IN ORDER.
- The handoff overrides the generic "What are we building today?" question.
- Exception: if the user gave you a specific task alongside the harness request (e.g. "load the harness then do X"), hold that task in mind -- complete the handoff sequence first, then address the additional task.
- Do NOT ask "What are we building today?" if a handoff exists. The handoff tells you what to do. Follow it.
- Only ask "What are we building today?" if there is NO active handoff AND the user gave no additional task.
If no active handoff section exists, go straight to Step 7.
Step 7 -- Report session state
Report a concise summary (no more than 10 lines):
- Last session: what was being worked on
- Active blockers: list them (from blockers.md files)
- In-progress tasks: list them
- Pending agents: any that were running
Step 8 -- Ask the single question
After the report (and after any handoff actions are complete), ask exactly:
"What are we building today?"
Wait for the answer. Write it as the session header in the relevant project's short_term.md before doing anything else.
What NOT to do
- Do not start any work before completing steps 1-8
- Do not skip an active handoff -- if one exists, follow it before asking the generic question
- Do not ask multiple questions -- the single question is "What are we building today?"
- Do not skip memory files -- read all of them
- Do not summarize from memory alone -- read the actual files
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

