🧠 Brain-OS

Brain-OS is a personal, local-first system designed to capture, incubate, and transform ideas into concrete projects over time.

Built for developers who:

• constantly generate ideas
• want a single source of truth
• dislike fragmented tools (notes, docs, spreadsheets, etc.)
• need a system that still makes sense months or years later

---

Table of Contents

• Workflow Overview
• How to Use
  • 1. Capture a New Idea (Inbox)
  • 2. Weekly Idea Review (Inbox → Incubator)
  • 3. Incubation Review (Incubator → Project)
  • 4. Project Execution
• Why This System Exists
• Philosophy
• Setup & Installation

---

Architecture

Brain-OS is structured as a production pipeline, not just a notebook.

/brain-os
├── 00_Inbox/          # Raw capture (no friction, no judgment)
├── 10_Incubator/      # Ideas being filtered and matured (the “Maybe” zone)
├── 20_Projects/       # Active development (Specs, MVP, Roadmaps)
├── 30_Archive/        # Abandoned or completed ideas (Post-mortems)
├── 99_Templates/      # Markdown templates for each stage
└── assets/            # Images and diagrams

---

Workflow Overview

flowchart TD
    A[Inbox] -->|Weekly Review| B[Incubator]

    B -->|No-Go| D[Archive]
    B -->|Keep Thinking| B
    B -->|Go| C[Project]

    C -->|Abandoned| D
    C -->|Completed| D

Loading

---

How to Use

1. Capture a New Idea (Inbox)

Used for fast, low-friction capture whenever an idea appears (commuting, shower thought, random insight).

Steps:

1. Open Obsidian
2. Create a new note (Ctrl + N)
3. Give it a short, descriptive title
4. Apply the Tpl_Inbox template (Alt + T)
5. Write just enough to avoid forgetting the idea

📌 Rule: No judgment. No structuring. Just capture.

---

2. Weekly Idea Review (Inbox → Incubator)

Usually done once a week.

Steps:

1. Open the 00_Inbox folder
2. Review each idea
3. Move relevant ones to 10_Incubator
4. Open each moved note
5. Apply the Tpl_Incubator template (Alt + N)
6. Fill in the sanity check honestly

Outcome:

• ❌ Weak or irrelevant ideas → 30_Archive
• 🌱 Promising ideas → remain in 10_Incubator

📌 Goal: Decide which ideas deserve time.

---

3. Incubation Review (Incubator → Project)

Ideas in the incubator are revisited over time (days or weeks).

Steps:

1. Open 10_Incubator

2. Re-read the concept and its evolution

3. Update the journal and sanity check

4. Decide to:

   • Archive the idea
   • Keep incubating
   • Promote it to a project

Promoted ideas are moved to 20_Projects and switched to the Tpl_Project template.

📌 Rule: Only ideas that survive time become projects.

---

4. Project Execution

Projects represent commitment, not experiments.

Steps:

1. Define a strict MVP
2. Create a GitHub repository
3. Link the repository in the project note
4. Track decisions and progress in the dev journal

If a project is abandoned, move it to 30_Archive with a short post-mortem.

---

Why This System Exists

• Ideas are never lost
• Decisions are explicit and documented
• Each idea has history and context
• Returning after 6 months still makes sense
• Git provides a timeline of your thinking

Brain-OS is not about doing more projects. It is about choosing better ones.

---

Philosophy

• Local-first
• Text over tools
• Simplicity over automation
• Time is a filter

---

Setup & Installation

Brain-OS is fully local and requires no backend. Only Git and Obsidian are needed.

1. Initialize your Repository

Which method should I choose?

• Method A (Template): Easiest. Use this if you want a simple, private vault and don't care about syncing future Brain-OS updates.
• Method B (Mirror): Advanced. Use this only if you are comfortable with Git and want to merge future updates (new templates, structure changes) into your private vault.

---

🟢 Method A: The "Template" (Recommended)

Best if you want a clean start and don't plan to sync structural updates often.

1. Click the "Use this template" button at the top of this page.
2. Select "Create a new repository".
3. Set it to Private and name it (e.g., My-Brain-OS).
4. Clone your new repository to your computer.

---

🟠 Method B: The "Mirror" (Advanced Users Only)

Best if you want to keep your data private but strictly follow Brain-OS updates via Git (Shared History).

Since GitHub does not reliably support private forks of public repositories in all contexts, the recommended approach is to use the Mirroring method.

1. Create a blank private repository on GitHub (do not initialize with README).

2. Open your terminal and run the following commands to duplicate the Brain-OS history:

   # 1. Download a bare copy of the public Brain-OS
   git clone --bare https://github.com/StenguyzCSGO/Brain-OS.git
   
   # 2. Push the mirror to your new PRIVATE repository
   cd Brain-OS.git
   git push --mirror https://github.com/YOUR_USERNAME/My-Brain-OS.git
   
   # 3. Clean up
   cd .. && rm -rf Brain-OS.git

3. Clone your new private repository locally:

   git clone git@github.com:YOUR_USERNAME/My-Brain-OS.git
   cd My-Brain-OS

4. Link the upstream to receive future updates:

   git remote add upstream https://github.com/StenguyzCSGO/Brain-OS.git
   git remote set-url --push upstream DISABLE

How to update later: When new features or templates are released, simply run:

git pull upstream main
git push origin main

2. Open as an Obsidian Vault

• Open Obsidian
• Select “Open folder as vault”
• Choose the My-Brain-OS directory

3. Required Obsidian Configuration

Enable the following core plugin:

• Templates

Settings:

• Files & Links

  • Default location for new notes: 00_Inbox
  • Attachment folder path: assets

• Templates

  • Template folder location: 99_Templates
  • Date format: YYYY-MM-DD

4. Recommended Hotkeys (for speed)

• Alt + T → Insert Template
• Alt + M → Move file to another folder

5. Git sync (cross-platform)

To keep Brain-OS portable across desktop and mobile, prefer Obsidian-compatible Git sync.

• Desktop: Obsidian Git plugin
• Mobile: any Git-based Obsidian-compatible workflow you already trust

References:

• Obsidian community plugins: https://obsidian.md/plugins
• Obsidian Git plugin (community): https://github.com/denolehov/obsidian-git