🧠 Second Brain

An AI-powered engineering operating system built on top of Obsidian, local code repositories, and Gemini.

Instead of treating notes, meetings, decisions, and codebases as separate sources of truth, Second Brain continuously synthesizes them into project memory, actionable tasks, and progress reports.

Think of it as a local AI project manager that lives inside your vault.

---

✨ Features

Dynamic Project Discovery

Projects are automatically discovered from the vault structure.

projects/
├── project-a/
├── project-b/
└── project-c/

No hardcoded project names.

---

Project Memory

Second Brain continuously builds a structured memory layer from:

• Raw ideas
• Meeting notes
• Architecture decisions
• Research documents
• Source code repositories

Example memory:

{
  "currentFocus": "Authentication",
  "blockers": ["SMTP timeout"],
  "openTasks": [
    "Implement JWT refresh tokens"
  ],
  "recentDecisions": [
    "Use Redis for session storage"
  ]
}

---

Automated Planning

Generates prioritized engineering tasks directly from project context.

Example output:

- [ ] HIGH Implement JWT refresh token rotation
- [ ] HIGH Fix SMTP timeout issue
- [ ] MEDIUM Add admin RBAC support

---

Daily Engineering Reports

Generate:

• Morning plans
• End-of-day summaries
• Weekly reviews
• Project health reports

---

Local-First Architecture

All project context remains under your control.

Sources include:

• Obsidian Vault
• Local repositories
• Markdown notes
• Git history

No vendor lock-in.

---

🏗 Architecture

Knowledge Sources
│
├── Raw Notes
├── Meetings
├── Decisions
├── Research
└── Source Code
         │
         ▼
   Ingest Worker
         │
         ▼
   Memory Worker
         │
         ▼
   Planning Worker
         │
         ▼
     Task Board
         │
         ▼
  Reports & Slack

---

📂 Project Structure

second-brain/
│
├── projects/
│
├── knowledge/
│   ├── raw/
│   ├── meetings/
│   ├── decisions/
│   └── research/
│
├── ai/
│   ├── prompts/
│   ├── generated/
│   └── memory/
│
├── dashboards/
│   ├── tasks.md
│   ├── roadmap.md
│   └── weekly-review.md
│
└── automation/
    ├── workers/
    ├── utils/
    ├── configs/
    └── logs/

---

⚙️ Workers

Ingest Worker

Collects and normalizes project context.

Sources:

• Notes
• Decisions
• Meetings
• Research

---

Memory Worker

Maintains long-term project memory.

Responsible for:

• Current focus
• Active blockers
• Open tasks
• Recent decisions

---

Planning Worker

Transforms memory into actionable work.

Outputs:

• Prioritized tasks
• Sprint goals
• Recommended next steps

---

Git Worker

Analyzes repository activity.

Tracks:

• Commits
• Diffs
• Project velocity

---

Review Worker

Creates:

• Daily reports
• Weekly reviews
• Progress summaries

---

Slack Worker

Delivers updates automatically.

Examples:

• Morning briefing
• Evening recap
• Weekly status report

---

🚀 Getting Started

Install dependencies:

npm install

Create environment variables:

GEMINI_API_KEY=your_key_here
SLACK_WEBHOOK=your_webhook_here

Run:

node index.js

---

📈 Future Roadmap

• Recursive vault indexing
• Multi-model support
• Semantic memory search
• Vector embeddings
• RAG-powered project recall
• GitHub integration
• Jira synchronization
• Automatic sprint planning
• Local LLM support
• Agent-based execution

---

Philosophy

Most productivity tools ask you to manage tasks.

Second Brain attempts to understand why those tasks exist.

The goal isn't another to-do list.

The goal is a continuously evolving representation of your projects, decisions, and engineering intent.