agentleFS
0SxD0SxD/agent-skills-plugin-v01/skills/brain-harness/SKILL.md

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.

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
  1. Distinctive:

    When in doubt: if the user seems to be asking you to get acquainted with the current state of the workspace, run this sequence.

    line 17
  2. Very specific:

    After reading all memory files, look at OpenBrainLM/memory/short_term.md for a section marked ## SESSION HANDOFF.

    line 58
  3. Distinctive:

    Do NOT ask "What are we building today?" if a handoff exists.

    line 62
  4. Distinctive:

    Only ask "What are we building today?" if there is NO active handoff AND the user gave no additional task.

    line 63
  5. Distinctive:

    If no active handoff section exists, go straight to Step 7.

    line 65
  6. Distinctive:

    After the report (and after any handoff actions are complete), ask exactly:

    line 75
  7. Very specific:

    Wait for the answer. Write it as the session header in the relevant project's short_term.md before doing anything else.

    line 79
  8. Distinctive:

    Do not start any work before completing steps 1-8

    line 84
  9. Distinctive:

    Do not skip an active handoff -- if one exists, follow it before asking the generic question

    line 85
  10. Distinctive:

    Do not ask multiple questions -- the single question is "What are we building today?"

    line 86
  11. Distinctive:

    Do not skip memory files -- read all of them

    line 87
  12. Distinctive:

    Do not summarize from memory alone -- read the actual files

    line 88

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.