second-brain-starter  by coleam00

AI second brain PRD generator for proactive, persistent assistants

Created 1 week ago

New!

349 stars

Top 79.7% on SourcePulse

GitHubView on GitHub
Project Summary

This project provides a skill for Claude Code that generates a personalized Product Requirements Document (PRD) for building an AI Second Brain. It targets developers, researchers, and power users seeking to create a proactive, persistent AI assistant that understands user context and remembers across sessions. The benefit lies in receiving a tailored, phased blueprint for constructing a custom AI agent with memory, integrations, and proactive capabilities.

How It Works

The core approach leverages Claude Code and the Claude Agent SDK, with the AI's architecture primarily defined by markdown files, Python scripts, and an Obsidian vault. Users complete a requirements template detailing their tools, workflow, and preferences. Claude Code then processes this input, researches necessary APIs, and generates a detailed, phased PRD. This PRD outlines the construction of a second brain featuring session-aware memory storage (using markdown files like SOUL.md, USER.md, MEMORY.md, and daily logs), platform integrations via Python CLI wrappers, and extensible skills. Memory recall is powered by a hybrid Retrieval Augmented Generation (RAG) system combining 70% vector search (using FastEmbed with local ONNX models) and 30% keyword search, backed by SQLite or PostgreSQL.

Quick Start & Requirements

  1. Install: Copy the .claude/skills/create-second-brain-prd/ directory into your project or clone the repository and copy the .claude/ folder.
  2. Configure: Fill out the my-second-brain-requirements.md template with your specific needs.
  3. Generate: Run the /create-second-brain-prd ./my-second-brain-requirements.md command within Claude Code.
  • Prerequisites: Claude Code, Claude Agent SDK, Python. An Obsidian vault is recommended for memory management.
  • Deployment: Supports local or VPS deployment.
  • Resources: Links to an overview video, the Claude Agent SDK documentation, and Obsidian are mentioned but not directly provided in the text. A "Dynamous community" is also referenced for workshops.

Highlighted Details

  • Generates a personalized, 9-phase PRD for building an AI Second Brain.
  • Features a hybrid RAG memory search (FastEmbed + SQLite/Postgres, 70% vector / 30% keyword).
  • Supports configurable proactivity levels: Observer, Advisor, Assistant, or Partner.
  • Proactive monitoring is estimated to cost approximately $0.05 per run.

Maintenance & Community

The project points to the "Dynamous community" for support and mentions a full hands-on workshop. Documentation for the Claude Agent SDK is also referenced.

Licensing & Compatibility

The specific open-source license is not explicitly stated in the provided README. Compatibility is focused on the Claude Code and Claude Agent SDK ecosystem.

Limitations & Caveats

This repository serves as a starter kit and requires significant user effort to define requirements and implement the generated PRD. Building a fully functional, proactive AI assistant can be a complex undertaking, even with the provided blueprint. The core functionality relies on the user having access to and familiarity with Claude Code and its associated SDK.

Health Check
Last Commit

1 week ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
1
Star History
355 stars in the last 13 days

Explore Similar Projects

Feedback? Help us improve.