Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 

Repository files navigation

second-brain-mac

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.


System Overview

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.)

Architecture Diagram

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
Loading

Repositories

obsidian-mac — Knowledge 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/

second-brain-meta — Shared Tooling & Config

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

Claude Projects — ~/Documents/Claude/Projects/

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

Design Principles

  1. GitHub = tooling only. Notes and data stay in OneDrive.
  2. Single source of truth per tool. OneDrive for notes, GitHub for config.
  3. Strict perso/pro isolation. Vaults never cross-contaminate.
  4. Minimal friction perso ↔ pro. Same structure, same tools, git pull is enough.
  5. AI-native workflow. Claude and Copilot are first-class tools, not add-ons.

Quick Start

# 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.sh

For the vault, sync via OneDrive and then open with Obsidian.


Related Repos

Repo Purpose
KayakMat/obsidian-mac Obsidian vault
KayakMat/second-brain-meta Config & tooling
ry-ops/starlink-enterprise-mcp-server Starlink MCP server

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors