mirror of
https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering.git
synced 2026-09-14 20:36:54 +08:00
Muratcan Koylan
210 lines
7.2 KiB
Markdown
210 lines
7.2 KiB
Markdown
# 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
|