aradotso/my-brain-is-full-crew

My Brain Is Full — Crew

Skill by ara.so — Daily 2026 Skills collection

A crew of 10 AI agents embedded in your Obsidian vault that manage knowledge, nutrition, and mental wellness through natural conversation with Claude Code. Built by a PhD researcher for people who are drowning — not just optimizing.

---

What It Does

The Crew installs 10 specialized agents into your vault's .claude/ directory. Each agent has its own system prompt, tool restrictions, and model assignment. You talk to Claude Code naturally; it activates the right agent automatically.

| Agent | Role | |---|---| | Architect | Vault setup, onboarding, folder structure | | Scribe | Captures messy text into clean structured notes | | Sorter | Nightly inbox triage — routes notes to correct folders | | Seeker | Search and synthesis across your entire vault | | Connector | Discovers hidden links between notes | | Librarian | Weekly health checks, dedup, broken link repair | | Transcriber | Turns recordings/transcripts into structured meeting notes | | Postman | Bridges Gmail + Google Calendar with your vault | | Food Coach | Meal ideas, grocery lists, wellness motivation (opt-in) | | Wellness Guide | Active listening, grounding techniques, stress support (opt-in) |

Agents communicate via a shared Meta/agent-messages.md message board inside your vault.

---

Prerequisites

• Claude Code with Pro, Max, or Team subscription
• Obsidian (free)
• git and bash available in your terminal

---

Installation

1. Create or open your Obsidian vault

# Create a new vault directory (or use an existing one)
mkdir ~/my-vault

Open Obsidian → Create New Vault → point it at ~/my-vault.

2. Clone the repo inside your vault

cd ~/my-vault
git clone https://github.com/gnekt/My-Brain-Is-Full-Crew.git

3. Run the installer

cd My-Brain-Is-Full-Crew
bash scripts/launchme.sh

The installer:

• Asks 2–3 questions (language preference, which agents to enable)
• Copies agents into ../.claude/agents/ (for Claude Code CLI)
• Copies skills into ../.claude/skills/ (for Claude Code Desktop / Cowork)
• Both formats installed automatically — no choice needed

4. Initialize your vault

Open Claude Code inside your vault folder (not inside the repo subfolder):

cd ~/my-vault
claude  # or open Claude Code Desktop pointed at this folder

Then say:

Initialize my vault

The Architect runs a friendly onboarding conversation covering:

1. Your name, language, role
2. Which agents to activate
3. Health agents setup (opt-in)
4. Gmail / Google Calendar integrations

---

Vault Structure

The Crew creates a hybrid PARA + Zettelkasten layout:

your-vault/
├── 00-Inbox/          # Capture zone — everything lands here first
├── 01-Projects/       # Active projects with deadlines
├── 02-Areas/          # Ongoing responsibilities (including Health/)
├── 03-Resources/      # Reference material, guides
├── 04-Archive/        # Completed or historical content
├── 05-People/         # Personal CRM
├── 06-Meetings/       # Timestamped meeting notes
├── 07-Daily/          # Daily notes and journals
├── MOC/               # Maps of Content — thematic indexes
├── Templates/         # Obsidian note templates
├── Meta/
│   ├── agent-messages.md   # Shared agent message board
│   ├── user-profile.md     # Your onboarding profile
│   └── vault-health/       # Librarian reports
└── .claude/
    ├── agents/        # Claude Code CLI subagents
    └── skills/        # Claude Code Desktop skills

---

Daily Usage — Natural Language Commands

The interface is conversation. No GUI, no drag-and-drop.

Knowledge Management

# Capture a note
"Save this: meeting with Marco about Q3 budget, he wants the report by Friday"

# Triage inbox
"Triage my inbox"
"Empty my inbox"

# Search
"Find everything I wrote about transformer architectures"
"What do my notes say about the Pomodoro technique?"

# Connect ideas
"Find connections between my notes on sleep and cognitive performance"
"What links to my note on [[Deep Work]]?"

# Vault health
"Run a vault health check"
"Find duplicate notes"
"Fix broken links"

Meetings & Transcription

# Process a recording
"Process my meeting recording from this morning"
"Transcribe this: [paste transcript text]"

# Meeting prep
"Prepare me for my 3pm meeting with the research team"

Email & Calendar (Postman)

"Check my emails for deadlines this week"
"What meetings do I have tomorrow?"
"Summarize unread emails related to Project Phoenix"

Food Coach (opt-in)

"Suggest a high-protein meal I can make in 20 minutes"
"Generate a grocery list for the week"
"I haven't been eating well — give me something easy and nutritious"

Wellness Guide (opt-in)

"I'm feeling overwhelmed right now"
"Walk me through a grounding exercise"
"I need to talk through something stressful"

---

Agent Communication Pattern

Agents leave messages for each other on the shared board at Meta/agent-messages.md:

<!-- Example entries in Meta/agent-messages.md -->

## Pending Messages

### FROM: Transcriber → TO: Sorter
**Date**: 2026-03-21
**Subject**: New meeting note needs filing
**File**: 06-Meetings/2026-03-21-research-sync.md
**Action**: Route to 01-Projects/Thesis/ and extract tasks to inbox

---

### FROM: Food Coach → TO: Wellness Guide
**Date**: 2026-03-21
**Subject**: Stress-eating pattern detected
**Context**: User mentioned eating poorly due to deadline stress 3x this week
**Action**: Check in on stress levels next session

When an agent runs, it checks this board and acts on messages addressed to it.

---

Configuration Files

User Profile (generated by Architect during onboarding)

<!-- Meta/user-profile.md -->
# User Profile

## Identity
- Name: Alex
- Language: English
- Role: PhD Researcher — Cognitive Science
- Timezone: Europe/Rome

## Active Agents
- [x] Architect
- [x] Scribe
- [x] Sorter
- [x] Seeker
- [x] Connector
- [x] Librarian
- [x] Transcriber
- [x] Postman
- [x] Food Coach (opt-in)
- [ ] Wellness Guide (opt-in — not activated)

## Food Coach Settings
- Dietary restrictions: vegetarian, lactose intolerant
- Health goals: increase protein, reduce processed food
- Cooking time preference: max 30 minutes

## Integrations
- Gmail: connected
- Google Calendar: connected

Agent Directory Structure

.claude/
├── agents/
│   ├── architect.md
│   ├── scribe.md
│   ├── sorter.md
│   ├── seeker.md
│   ├── connector.md
│   ├── librarian.md
│   ├── transcriber.md
│   ├── postman.md
│   ├── food-coach.md
│   └── wellness-guide.md
└── skills/
    ├── architect.md
    ├── scribe.md
    └── ...

---

Reinstalling or Updating

cd ~/my-vault/My-Brain-Is-Full-Crew

# Pull latest changes
git pull origin main

# Re-run installer (safe to run multiple times)
bash scripts/launchme.sh

The installer is idempotent — re-running updates agent files without wiping your vault content.

---

Enabling / Disabling Opt-In Agents

To enable the Food Coach or Wellness Guide after onboarding:

"Enable the Food Coach agent"
"Activate the Wellness Guide"
"Disable the Food Coach"

The Architect will update Meta/user-profile.md and confirm.

To manually edit, open Meta/user-profile.md and change the checkbox:

- [x] Food Coach (opt-in)    ← enabled
- [ ] Wellness Guide (opt-in) ← disabled

---

Multilingual Support

The Crew responds in whatever language you use. Switch mid-conversation:

"Salva questo: riunione con Marco sul budget Q3"
"Cherche tout ce que j'ai écrit sur la mémoire de travail"
"作業記憶に関するメモを全部見せて"

Agents match your language automatically. No configuration needed.

---

Troubleshooting

Agents not activating

# Confirm you're running Claude Code from inside your vault (not the repo subfolder)
cd ~/my-vault
claude

# Confirm agents are installed
ls .claude/agents/
ls .claude/skills/

Re-run onboarding

"Re-run vault initialization"
"Reset my user profile"

Vault structure missing

"Rebuild vault folder structure"
"Create missing vault folders"

Agent messages not being processed

Check Meta/agent-messages.md exists. If missing:

"Initialize the agent message board"

Gmail / Calendar integration issues

The Postman agent uses Claude Code's built-in tool access. Ensure Claude Code has browser/OAuth permissions granted for your Google account during onboarding. Re-trigger with:

"Reconnect Gmail integration"
"Re-authenticate Google Calendar"

---

Important Disclaimers

• Health agents are not medical professionals. Food Coach and Wellness Guide produce AI-generated output — not medical advice, not therapy. Always consult real professionals. Both are opt-in.
• No warranty. Back up your vault before use. Provided "as is."
• Personal use only. You are responsible for GDPR/CCPA compliance if processing third-party data (e.g., emails containing others' personal information).
• By using the software you agree to the Terms of Use. The Architect will ask you to accept during onboarding.

---

Key Files Reference

| File | Purpose | |---|---| | scripts/launchme.sh | Main installer — run this | | Meta/user-profile.md | Your preferences and active agents | | Meta/agent-messages.md | Inter-agent communication board | | Meta/vault-health/ | Librarian weekly reports | | .claude/agents/ | Subagent definitions (CLI) | | .claude/skills/ | Skill definitions (Desktop) | | docs/getting-started.md | Beginner step-by-step guide | | docs/DISCLAIMERS.md | Full disclaimer text |