---
title: "family-config: AI 기반 가족 생활 관리 시스템"
url: "https://notes.junghanacs.com/notes/20251030T011107"
author: "Junghan Kim"
date: "2025-10-30T01:11:00+09:00"
lastmod: "2025-10-30T01:11:00+09:00"
tags: ["agent","family","mcp"]
description: "family-config를 AI 기반 가족 생활 관리 시스템으로 바라보는 노트이다."
---

> [!abstract] 이 노트에 대하여
> 
> 가족의 일정과 생활 문서를 단순 저장이 아닌 행동 가능한 텍스트로 다루는 family-config 개념을 설명한다. 에이전트가 이해하고 실행할 수 있는 가족 운영 시스템 구상이다.

## 히스토리

-   [2026-07-17 Fri 21:58] 이 노트는 수선이 필요하겠다. [§butlercli 집사 - 생활 운영 루프 수리 구입 자동차 세차 청소 캘린더 추적](https://notes.junghanacs.com/botlog/20260518T094818) 여기 쪽으로 옮겨야돼

## family-config: AI 기반 가족 생활 관리 시스템

### 프로젝트 목표

> "Text as Action. Every heading is executable." "Family is not just living together. It's a shared intelligent system."

**맞벌이 가정을 위한 AI 에이전트 기반 가족 생활 관리 시스템**.

### 핵심 개념: Actionable Intelligence

전통적 가족 관리 도구와의 차이:

```text
❌ Legacy System: "저장용 문서"
   - 사람이 양식 맞추기 → 재활용 불가
   - 정적 정보 → 행동 불가

✅ Agent System: "행동 가능한 텍스트"
   - 텍스트 일관성 → 에이전트 이해
   - Actionable Item → MCP 즉시 실행
   - Property 기반 → Sheet/Ledger/Calendar 연동
   - Git 버전 관리 → 가족 히스토리 영속화
```

### 시간과정신의방 (Time and Mind Room)

-   **시간(Time)**: 재현 가능한 환경, 버전 관리, 누적되는 지식
-   **정신(Mind)**: 인간지능(HI) + 인공지능(AI) 협업
-   **방(Room)**: AI Agent와 협업하는 워크스페이스

### 구성 요소

#### 영역별 관리 (6개)

```text
family-config/
├── finance/           # 재무 관리
├── education/         # 교육 관리
├── childcare/         # 육아 관리
├── travel/            # 여행/휴가 관리
├── events/            # 경조사 관리
└── calendar/          # 통합 일정 관리
```

각 영역:

-   \`templates/\`: 재사용 가능한 Org-mode 템플릿
-   \`schemas/\`: 데이터 구조 정의
-   \`README.md\`: 사용 가이드

#### AI 메모리 (PARA)

```text
memory/
├── projects/         # 활성 프로젝트 (기한 있음)
├── areas/            # 지속적 관심사
├── resources/        # 재사용 패턴
└── archives/         # 완료 항목
```

### Actionable Item 예시

```org
* 제주도 항공권 예약 :AGENT:ACTION:
:PROPERTIES:
:AGENT_ACTION: mcp_web_search
:SEARCH_QUERY: 서울-제주 항공권 2025-07-20 4인
:BUDGET: 800000
:STATUS: TODO
:END:

** Agent Instructions
#+begin_src yaml
action: web_search
query: "서울-제주 항공권 2025-07-20 왕복 4명"
output:
  - format: org_table
  - fields: [airline, departure, price]
```

,\*\* Search Results [Agent 실행 후 자동 추가] \#+end_src

### MCP 통합 워크플로우

```text
Emacs (Human Intelligence)
    ↓
Property 파싱
    ↓
MCP 도구 실행 (web_search, calendar, n8n...)
    ↓
결과를 Org table/Ledger/iCal로 기록
    ↓
~/org/family/ (Private Git)
```

### 5-Layer 아키텍처

```text
Layer 5: Family Dashboard (통합 뷰, KPI, 의사결정)
Layer 4: AI Family Agent (PARA 메모리, Denote, Git)
Layer 3: Domain Configs (finance, education, childcare...)
Layer 2: Tools & Integrations (MCP, Calendar API, Ledger)
Layer 1: Data Infrastructure (Git, Org-mode, Denote silo)
```

### -config 생태계

시간과정신의방 생태계의 일부:

#### 개인 시스템

-   \`claude-config\`: AI 협업 (개인 작업용)
-   \`nixos-config\`: 재현 가능한 OS
-   \`doomemacs-config\`: Emacs 환경

#### 가족 시스템

-   **\`family-config\`**: 가족 생활 관리 (이 프로젝트)
    -   동일한 철학 (CLAUDE.md 스타일)
    -   동일한 방법론 (Denote + PARA)
    -   독립된 데이터 (\`~/org/family/\`)

### 주요 기능

1.  **재무 관리**: 월별 예산, 지출 분석, Ledger 통합
2.  **교육 관리**: 학습 계획, 학원 일정, 성적 추적
3.  **육아 관리**: 예방접종, 성장 발달, 의료 기록
4.  **여행 관리**: 항공권/숙박 검색 (MCP), 일정 자동 생성
5.  **경조사 관리**: 가족 관계도, 알림, 부조금 가이드
6.  **통합 일정**: Google Calendar 동기화, 충돌 감지

### 문서 타임라인 (1개 docs/)

1.  related-projects.md (family-config 시절 참고 문서, 현재 butlercli 리네임 이후 repo 표면에서는 제거됨)
    -   관련 프로젝트 연결

### 파일명 규칙 (Denote)

```text
timestamp--한글-제목__family_영역_태그들.org

예시:
20251014T120000--여름휴가-제주도__family_travel_active.org
20251014T120100--월별-예산-2025-10__family_finance_tracking.org
```

### 프라이버시

#### 공개 (이 리포지토리)

✅ 템플릿, 스키마, 문서화, 예시 코드

#### 비공개 (개인 관리)

❌ 실제 가족 데이터 (\`~/org/family/\`) ❌ 금융 정보, 개인 식별 정보

### 기대 효과

#### 정량적

-   시간 절약: 주당 5-10시간 (자동화)
-   비용 절감: 월 10-20% (예산 최적화)
-   놓친 일정: 연간 0건

#### 정성적

-   스트레스 감소: 모든 것이 체계화
-   부부 협업: 공유된 투명한 시스템
-   가족 기록: Git으로 영구 보존
-   의사결정: 데이터 기반

### 메타정보

**포트폴리오 가치**:

-   **개인에서 가족으로 확장**: claude-config 철학을 family로
-   **Actionable Intelligence**: 텍스트 = 실행 가능한 데이터
-   **MCP 통합**: Property 기반 자동 실행
-   **Template Repository**: 다른 가족도 재사용 가능

라이선스: MIT 작성자: Jung Han (junghanacs)