Architecture documentation for Mathieu Hénault's Second Brain setup on macOS.
Framework: PARA + CODE · AI tooling: Claude + GitHub Copilot · Notes: Obsidian · Editor: VS Code
This repo is the meta-map of the system — it documents how the repos, vaults, and tooling fit together. No personal notes or work data live here.
second-brain-mac (this repo)
│ Architecture & documentation of the whole setup
│
├── obsidian-mac → Knowledge vault (Obsidian / PARA+CODE)
│ github.com/KayakMat/obsidian-mac
│ local: ~/second-brain/vault/
│ sync: OneDrive Perso
│
├── second-brain-meta → Shared tooling & config
│ github.com/KayakMat/second-brain-meta
│ local: ~/second-brain/meta/
│
└── ~/Documents/Claude/Projects/
└── Various standalone Claude projects (SL-API, starlink-mcp, etc.)
graph TD
subgraph mac["MacBook Air — second-brain"]
vault["obsidian-mac\n~/second-brain/vault/\n(Obsidian vault)"]
meta["second-brain-meta\n~/second-brain/meta/\n(Config & tooling)"]
projects["~/Documents/Claude/Projects/\n(Standalone projects)"]
end
subgraph storage["Storage & Sync"]
onedrive["OneDrive Perso\n(vault notes sync)"]
github["GitHub — KayakMat\n(config, tooling, scripts)"]
end
subgraph ai["AI Layer"]
claude["Claude Code\n(.claude/ agents + skills)"]
copilot["GitHub Copilot\n(.github/ instructions)"]
end
vault -->|git push| github
meta -->|git push| github
vault <-->|sync| onedrive
claude -->|reads| vault
claude -->|reads| meta
copilot -->|reads| vault
meta -->|instructions & templates| vault
meta -->|setup scripts| vault
| Repo | KayakMat/obsidian-mac |
| Local path | ~/second-brain/vault/ |
| Sync | OneDrive Perso (primary) + GitHub (backup/config) |
| Editor | Obsidian (daily use) + VS Code (bulk edits) |
Vault structure (PARA + CODE):
00-Inbox/ ← single entry point — everything lands here first
01-CODE/ ← CODE workflow stages (Capture / Organize / Distill / Export)
10-Projects/ ← active time-bounded projects
├── art/ ← ART (Architecture du Réseau de Télécommunication) — pro
├── homelab/ ← personal infrastructure (Proxmox, Radxa, network)
└── second-brain/ ← evolution of the system itself
20-AREAS/ ← ongoing responsibilities (no end date)
├── HQ/ ← Hydro-Québec — client, domain, tech watch
├── HOMELAB/ ← day-to-day homelab ops
└── PERSO/ ← personal life, finances, health
30-resources/ ← stable references (books, tech, templates)
40-Archives/ ← closed projects, archived by year
90-Meta/ ← vault infrastructure
└── journal/ ← unified daily log (YYYYMMDD—daily-log.md)
AI tooling in vault:
.claude/
agents/brain.md ← Claude agent — vault operations
skills/ ← Domain skills (organize, distill, archive, review…)
├── archive/
├── auto-chunking/
├── distill/
├── organize/
├── pattern/
├── review/
└── rollup/
.github/
copilot-instructions.md ← Copilot workspace instructions
instructions/ ← Scoped instruction files (.instructions.md)
├── context-engineering
├── qa-engineering-best-practices
├── shell
├── powershell
├── containerization-docker-best-practices
└── prompt
skill/
├── add-educational-comments/
└── secrets-scanner/
| Repo | KayakMat/second-brain-meta |
| Local path | ~/second-brain/meta/ |
| Purpose | Config & tooling only — zero personal/work data |
Structure:
claude/
agents/weekly-review.md ← Claude agent for weekly review
instructions/
├── base.md ← Base Claude instructions
├── perso-context.md ← Personal context
└── pro-context.md ← Professional context
skills/
├── obsidian-para.md ← PARA methodology skill
└── pve3-*/ ← Proxmox VE3 skills (connect, manage, update)
obsidian/
templates/ ← Obsidian note templates
├── area-note.md
├── capture-note.md
├── project-index.md
└── weekly-review.md
dataview-queries/ ← Dataview queries for dashboards
├── inbox-dashboard.md
└── projets-actifs.md
plugins-recommended.md ← Curated plugin list
vscode/
brain-perso.code-workspace ← VS Code workspace config
settings.json ← Editor settings
extensions.json ← Recommended extensions
snippets/markdown.json ← Markdown snippets
scripts/
setup-brain-perso.sh ← First-time setup (personal Mac)
setup-brain-pro.sh ← First-time setup (work PC)
agents/ ← Automation agent scripts
scripts/
├── log-router.py ← Log routing automation
├── project-ops.py ← Project operations
└── uptime-kuma-pve3.py ← Uptime Kuma / Proxmox monitoring
templates/ ← Agent output templates
Standalone Claude Code projects, not part of the vault or meta repos.
| Project | Description |
|---|---|
SL-API/ |
Starlink API — Docker-based REST API |
SL-API-Tech/ |
Starlink API — technical deep-dive |
Starlink MCP Connect/ |
MCP server for Starlink integration |
starlink-enterprise-mcp-server/ |
Enterprise Starlink MCP (→ ry-ops/starlink-enterprise-mcp-server) |
File Organizer/ |
Scripts for file cleanup & archiving |
NAS Organizer/ |
NAS organization tooling |
- GitHub = tooling only. Notes and data stay in OneDrive.
- Single source of truth per tool. OneDrive for notes, GitHub for config.
- Strict perso/pro isolation. Vaults never cross-contaminate.
- Minimal friction perso ↔ pro. Same structure, same tools,
git pullis enough. - AI-native workflow. Claude and Copilot are first-class tools, not add-ons.
# Clone tooling
git clone https://github.com/KayakMat/second-brain-meta.git ~/second-brain/meta
cd ~/second-brain/meta
# Initial setup (personal Mac)
bash scripts/setup-brain-perso.shFor the vault, sync via OneDrive and then open with Obsidian.
| Repo | Purpose |
|---|---|
| KayakMat/obsidian-mac | Obsidian vault |
| KayakMat/second-brain-meta | Config & tooling |
| ry-ops/starlink-enterprise-mcp-server | Starlink MCP server |