# Digital Brain

> A personal operating system for founders, creators, and builders. Part of the [Agent Skills for Context Engineering](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) collection.

## Overview

Digital Brain is a structured knowledge management system designed for AI-assisted personal productivity. It provides a complete folder-based architecture for managing:

- **Personal Brand** - Voice, positioning, values
- **Content Creation** - Ideas, drafts, publishing pipeline
- **Knowledge Base** - Bookmarks, research, learning
- **Network** - Contacts, relationships, introductions
- **Operations** - Goals, tasks, meetings, metrics

The system follows context engineering principles: progressive disclosure, append-only data, and module separation to optimize for AI agent interactions.

## Architecture

```
digital-brain/
├── SKILL.md                 # Main skill definition (Claude Code compatible)
├── SKILLS-MAPPING.md        # How context engineering skills apply
│
├── identity/                # Personal brand & voice
│   ├── IDENTITY.md          # Module instructions
│   ├── voice.md             # Tone, style, patterns
│   ├── brand.md             # Positioning, audience
│   ├── values.yaml          # Core principles
│   ├── bio-variants.md      # Platform bios
│   └── prompts/             # Generation templates
│
├── content/                 # Content creation hub
│   ├── CONTENT.md           # Module instructions
│   ├── ideas.jsonl          # Content ideas (append-only)
│   ├── posts.jsonl          # Published content log
│   ├── calendar.md          # Content schedule
│   ├── engagement.jsonl     # Saved inspiration
│   ├── drafts/              # Work in progress
│   └── templates/           # Thread, newsletter, post templates
│
├── knowledge/               # Personal knowledge base
│   ├── KNOWLEDGE.md         # Module instructions
│   ├── bookmarks.jsonl      # Saved resources
│   ├── learning.yaml        # Skills & goals
│   ├── competitors.md       # Market landscape
│   ├── research/            # Deep-dive notes
│   └── notes/               # Quick captures
│
├── network/                 # Relationship management
│   ├── NETWORK.md           # Module instructions
│   ├── contacts.jsonl       # People database
│   ├── interactions.jsonl   # Meeting log
│   ├── circles.yaml         # Relationship tiers
│   └── intros.md            # Introduction tracker
│
├── operations/              # Productivity system
│   ├── OPERATIONS.md        # Module instructions
│   ├── todos.md             # Task list (P0-P3)
│   ├── goals.yaml           # OKRs
│   ├── meetings.jsonl       # Meeting notes
│   ├── metrics.jsonl        # Key metrics
│   └── reviews/             # Weekly reviews
│
├── agents/                  # Automation
│   ├── AGENTS.md            # Script documentation
│   └── scripts/
│       ├── weekly_review.py
│       ├── content_ideas.py
│       ├── stale_contacts.py
│       └── idea_to_draft.py
│
├── references/              # Detailed documentation
│   └── file-formats.md
│
└── examples/                # Usage workflows
    ├── content-workflow.md
    └── meeting-prep.md
```

## Skills Integration

This example demonstrates these context engineering skills:

| Skill | Application |
|-------|-------------|
| `context-fundamentals` | Progressive disclosure, attention budget |
| `memory-systems` | JSONL append-only logs, structured recall |
| `tool-design` | Self-contained automation scripts |
| `context-optimization` | Module separation, just-in-time loading |

See [SKILLS-MAPPING.md](./SKILLS-MAPPING.md) for detailed mapping of how each skill informs the design.

## Installation

### As a Claude Code Skill

```bash
# User-wide installation
git clone https://github.com/muratcankoylan/digital-brain-skill.git \
  ~/.claude/skills/digital-brain

# Or project-specific
git clone https://github.com/muratcankoylan/digital-brain-skill.git \
  .claude/skills/digital-brain
```

### As a Standalone Template

```bash
git clone https://github.com/muratcankoylan/digital-brain-skill.git ~/digital-brain
cd ~/digital-brain
```

## Quick Start

1. **Define your voice** - Fill out `identity/voice.md` with your tone and style
2. **Set your positioning** - Complete `identity/brand.md` with audience and pillars
3. **Add contacts** - Populate `network/contacts.jsonl` with key relationships
4. **Set goals** - Define OKRs in `operations/goals.yaml`
5. **Start creating** - Ask AI to "write a post" and watch it use your voice

## File Format Conventions

| Format | Use Case | Why |
|--------|----------|-----|
| `.jsonl` | Append-only logs | Agent-friendly, preserves history |
| `.yaml` | Structured config | Human-readable hierarchies |
| `.md` | Narrative content | Editable, rich formatting |
| `.xml` | Complex prompts | Clear structure for agents |

## Usage Examples

### Content Creation
```
User: "Help me write a X thread about AI agents"

Agent Process:
1. Reads identity/voice.md for tone patterns
2. Checks identity/brand.md - confirms "ai_agents" is a pillar
3. References content/posts.jsonl for successful formats
4. Drafts thread matching voice attributes
```

### Meeting Preparation
```
User: "Prepare me for my call with Sarah"

Agent Process:
1. Searches network/contacts.jsonl for Sarah
2. Gets history from network/interactions.jsonl
3. Checks operations/todos.md for pending items
4. Generates pre-meeting brief
```

### Weekly Review
```
User: "Run my weekly review"

Agent Process:
1. Executes agents/scripts/weekly_review.py
2. Compiles metrics from operations/metrics.jsonl
3. Runs agents/scripts/stale_contacts.py
4. Presents summary with action items
```

## Automation Scripts

| Script | Purpose | Run Frequency |
|--------|---------|---------------|
| `weekly_review.py` | Generate review from data | Weekly |
| `content_ideas.py` | Suggest content from knowledge | On-demand |
| `stale_contacts.py` | Find neglected relationships | Weekly |
| `idea_to_draft.py` | Expand idea to draft scaffold | On-demand |

```bash
# Run directly
python agents/scripts/weekly_review.py

# Or with arguments
python agents/scripts/content_ideas.py --pillar ai_agents --count 5
```

## Design Principles

1. **Progressive Disclosure** - Load only what's needed for the current task
2. **Append-Only Data** - Never delete, preserve history for pattern analysis
3. **Module Separation** - Each domain is independent, no cross-contamination
4. **Voice First** - Always read voice.md before any content generation
5. **Platform Agnostic** - Works with Claude Code, Cursor, any AI assistant

## Contributing

This is part of the [Agent Skills for Context Engineering](https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering) collection.

Contributions welcome:
- New content templates
- Additional automation scripts
- Module enhancements
- Documentation improvements

## License

MIT - Use freely, attribution appreciated.

---

**Author**: Muratcan Koylan
**Version**: 1.0.0
**Last Updated**: 2025-12-29
