Content
# Family-Config: Actionable Intelligence for Family Life
> "Text as Action. Every heading is executable."
**Family-Config** is an AI agent-based family life management system designed for dual-income families.
## 🎯 Core Concepts
### Actionable Intelligence
Differences from traditional family management tools:
```
❌ Legacy System: "Documents for Storage"
- Manual form filling → Not reusable
- Static information → No actionable insights
- Distributed data → Difficult to integrate
✅ Agent System: "Actionable Text"
- Text consistency → Understandable by agents
- Actionable Item → Executed immediately via MCP
- Property-based → Integrated with Sheet/Ledger/Calendar
- Git version control → Preserves family history
```
### Time and Mind Room
- **Time**: Reproducible environment, version control, accumulated knowledge
- **Mind**: Extension of Human Intelligence
- **Room**: A workspace for collaboration with AI Agents
## 📦 Components
### Domain-Specific Management Modules
```
family-config/
├── finance/ # Financial Management
├── education/ # Educational Management
├── childcare/ # Childcare Management
├── travel/ # Travel/Vacation Management
├── events/ # Event Management
└── calendar/ # Integrated Schedule Management
```
Each domain includes:
- **templates/**: Reusable Org-mode templates
- **schemas/**: Data structure definitions
- **README.md**: Domain-specific usage guides
### AI Memory System (PARA)
```
memory/
├── projects/ # Active projects (with deadlines)
├── areas/ # Ongoing interests (no deadlines)
├── resources/ # Reusable patterns
└── archives/ # Completed items
```
## 🚀 Quick Start
### 1. Clone the Repository
```bash
git clone https://github.com/junghanacs/family-config.git ~/repos/gh/family-config
cd ~/repos/gh/family-config
```
### 2. Create Actual Data Folders
```bash
mkdir -p ~/org/family/{finance,education,childcare,travel,events,calendar}
cd ~/org/family
git init
```
### 3. Use the First Template
```bash
# Copy travel planning template
cp ~/repos/gh/family-config/travel/templates/trip-planning.org \
~/org/family/travel/20251014T120000--Summer-Vacation-Jeju__family_travel_active.org
```
### 4. Edit in Emacs
```bash
emacs ~/org/family/travel/20251014T120000--Summer-Vacation-Jeju__family_travel_active.org
```
## 📋 Example of Actionable Item
### Property-Based Execution
```org
* Book Flight Tickets to Jeju :AGENT:ACTION:
:PROPERTIES:
:AGENT_ACTION: mcp_web_search
:SEARCH_QUERY: Seoul-Jeju flight tickets 2025-07-20 for 4 people
:BUDGET: 800000
:DEADLINE: [2025-04-30 Sun]
:STATUS: TODO
:END:
** Agent Instructions
#+begin_src yaml
action: web_search
query: "Seoul-Jeju flight tickets 2025-07-20 round trip for 4 people"
budget_max: 800000
preferences:
- adjacent seating
- morning departure (09:00-11:00)
output:
- format: org_table
- fields: [airline, departure, price]
#+end_src
** Search Results
[Automatically added after agent execution]
```
### MCP Tool Integration
The AI Agent (like Claude) automatically:
1. Parses properties
2. Executes MCP tools (`web_search`)
3. Records results in Org table
4. Suggests next actions
## 🛠️ Key Features
### 1. Financial Management
- Monthly budget tracking
- Expense category analysis
- Ledger integration
- Budget overrun alerts
### 2. Educational Management
- Individual learning plans for children
- Academy schedule management
- Grade tracking
- Educational material recommendations
### 3. Childcare Management
- Vaccination schedules
- Growth and development records
- Daily routine management
- Medical records
### 4. Travel Management
- Flight/accommodation searches (MCP)
- Automatic itinerary generation
- Packing checklists
- Budget tracking
### 5. Event Management
- Family relationship chart
- Event reminders
- Monetary gift guidelines
- Historical records
### 6. Integrated Calendar
- Consolidation of all domains
- Google Calendar synchronization
- Views by family members
- Conflict detection
## 🤖 Utilizing AI Agents
### Daily Routine
- **06:00**: Briefing on today's schedule
- **12:00**: Check urgent alerts
- **18:00**: Dinner preparations
- **22:00**: Daily wrap-up
### Weekly/Monthly Reports
- Budget usage analysis
- Educational progress checks
- Goal achievement rates
- Pattern discovery and suggestions
## 📁 File Naming Convention (Denote)
```
timestamp--title_in_korean__family_domain_tags.org
Example:
20251014T120000--Summer-Vacation-Jeju__family_travel_active.org
20251014T120100--Monthly-Budget-2025-10__family_finance_tracking.org
20251014T120200--Child1-Academy-Schedule__family_education_child1.org
```
### Tag System
```bash
# Projects (time-sensitive tasks)
__active # Currently in progress
__urgent # Urgent
__blocked # Blocked
# Resources
__template # Template
__pattern # Pattern
# Archives
__done # Completed
```
## 🏗️ Time and Mind Room: Layer Architecture
### Core Philosophy
> "Config is not just settings. It's a philosophy."
> "Family is not just living together. It's a shared intelligent system."
**Time and Mind Room** concept:
- **Time**: Reproducible environment, version control, accumulated family history
- **Mind**: Collaboration between Human Intelligence (HI) and Artificial Intelligence (AI)
- **Room**: Family operational space managed with AI Agents
### Layer Structure
```
┌─────────────────────────────────────────────────┐
│ Layer 5: Family Dashboard │
│ - Integrated view based on Org-mode │
│ - Real-time KPIs (budget, schedule, goal achievement) │
│ - Family decision support system │
└─────────────────────────────────────────────────┘
↑
┌─────────────────────────────────────────────────┐
│ Layer 4: AI Family Agent (family-config) │
│ - PARA memory system │
│ · projects/ (active projects) │
│ · areas/ (ongoing interests) │
│ · resources/ (reusable patterns) │
│ · archives/ (completed items) │
│ - Denote naming convention │
│ - Git versioning (preserves family history) │
│ - PM Agent (proactive management) │
└─────────────────────────────────────────────────┘
↑
┌─────────────────────────────────────────────────┐
│ Layer 3: Domain Configs │
│ - finance/ (financial management) │
│ - education/ (educational management) │
│ - childcare/ (childcare management) │
│ - travel/ (travel management) ← Starts here! │
│ - events/ (event management) │
│ - calendar/ (integrated schedule) │
│ │
│ Each domain: templates/ + schemas/ │
└─────────────────────────────────────────────────┘
↑
┌─────────────────────────────────────────────────┐
│ Layer 2: Tools & Integrations │
│ - MCP tools (web_search, calendar, n8n) │
│ - Google Calendar/Drive API │
│ - Emacs/Org-mode (Human Intelligence) │
│ - Ledger CLI (financial tracking) │
│ - ACP/MCP hybrid │
└─────────────────────────────────────────────────┘
↑
┌─────────────────────────────────────────────────┐
│ Layer 1: Data Infrastructure │
│ - Git repositories (version control) │
│ - Org-mode files (~/org/family/) │
│ - Denote silo system (consistent file naming) │
│ - Backup systems (automatic backups) │
└─────────────────────────────────────────────────┘
```
### Data Flow
```
Family Life
↓
Emacs/Org-mode + AI Agent
↓
Property Parsing (AGENT:ACTION tags)
↓
MCP Tool Execution (web_search, calendar, n8n, ...)
↓
Record results in Org table/Ledger/iCal
↓
~/org/family/ (actual data, Private Git)
↓
Pattern discovery and templating
↓
~/repos/gh/family-config/memory/
↓
Pattern accumulation (resources/)
↓
Template improvement (templates/)
↓
Share with next family (GitHub Public)
```
### ACP/MCP Integration Strategy
```
Emacs (Human Intelligence)
↓
ACP (Agent Client Protocol)
↓
┌─────────────────────────────────┐
│ AI Agents (Claude, Gemini, …) │
└─────────────────────────────────┘
↓
MCP (Model Context Protocol)
↓
┌──────────────────────────────────────────┐
│ MCP Tools │
│ - mcp__web_search (information search) │
│ - mcp__n8n (workflow automation) │
│ - mcp__playwright (web automation) │
│ - mcp__git (version control) │
│ - mcp__supabase (data querying) │
└──────────────────────────────────────────┘
↓
Execute actual tasks (searching for flights, booking, recording, ...)
↓
Save results to Org-mode Property/Table
```
### -config Ecosystem Connection
This project is part of the **Time and Mind Room** ecosystem:
#### Personal System
- **claude-config**: AI collaboration command center (for personal tasks)
- **nixos-config**: Reproducible OS environment
- **doomemacs-config**: Terminal-optimized Emacs
- **emacs-fulllab-config**: Laboratory (Laboratory → Production)
- **zotero-config**: AI-queryable bibliography system
#### Family System
- **family-config**: Family life management (this project)
- Same philosophy (CLAUDE.md style)
- Same methodology (Denote + PARA)
- Same tools (Emacs + MCP)
- Independent data (~/org/family/)
### System Integration
```
~/claude-config/ (personal AI collaboration)
├── CLAUDE.md (personal Agent guidelines)
└── memory/ (personal memory)
~/repos/gh/family-config/ (family operations)
├── FAMILY.md (family Agent guidelines)
└── memory/ (family memory)
~/org/ (Denote Silo)
├── notes/ (personal notes)
└── family/ (family data)
~/repos/gh/nixos-config/ (OS environment)
~/repos/gh/doomemacs-config/ (Emacs environment)
→ All version-controlled with Git
→ All comply with Denote rules
→ All AI Agent friendly
→ Personal/Family data separated
```
## 📊 Expected Benefits
### Quantitative
- **Time Savings**: 5-10 hours per week (automation)
- **Cost Reduction**: 10-20% monthly (budget optimization)
- **Missed Appointments**: 0 annually (AI reminders)
### Qualitative
- **Stress Reduction**: Everything is organized
- **Couple Collaboration**: A shared transparent system
- **Family Records**: Preserved forever with Git
- **Decision Making**: Data-driven judgments
## 🔐 Privacy
### Public (This Repository)
✅ Template files
✅ Schema definitions
✅ Documentation
✅ Example code
### Private (Personal Management)
❌ Actual family data (`~/org/family/`)
❌ Financial information
❌ Personal identifiable information
❌ Sensitive schedules
## 📖 Documentation
- **[FAMILY.md](./FAMILY.md)**: AI Agent guidelines
- **[docs/getting-started.md](./docs/getting-started.md)**: Detailed getting started guide
- **[docs/agent-guide.md](./docs/agent-guide.md)**: How to utilize Agents
- **[docs/mcp-integration.md](./docs/mcp-integration.md)**: MCP tool integration
## 🤝 Contribution
This project is a template repository. Suggestions for improvements are welcome:
1. Fork
2. Create a feature branch
3. Commit changes
4. Submit a Pull Request
## 📝 License
MIT License
## 👤 Author
**Junghan Kim** (junghanacs)
- Website: [힣's Digital Garden](https://notes.junghanacs.com)
- GitHub: [@junghanacs](https://github.com/junghan0611)
## 🙏 Inspiration
- **PARA Method**: Tiago Forte
- **Denote**: Protesilaos Stavrou
- **Org-mode**: Carsten Dominik
- **Getting Things Done**: David Allen
- **Time and Mind Room**: Philosophy of integrated personal computing environments
---
**"Family is not just living together. It's a shared intelligent system."**
