Skip to content

junghan0611/meta-config

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

Meta-Config: 계층적 에이전트 아키텍처

Meta-Config: 계층적 에이전트 아키텍처

**상태**: 🔬 CONCEPT - 미래 비전 **버전**: 0.1.0 **업데이트**: 2025-10-14 **저자**: Junghan Kim (junghanacs)

“Agents all the way down: From orchestration to specialization” “메타에서 도메인까지, 계층으로 조직된 지능”

🎯 핵심 개념

왜 계층적 에이전트인가?

현재 AI 에이전트의 한계:

  • ❌ 모든 도메인을 하나의 에이전트가 담당 → 컨텍스트 과부하
  • ❌ 메모리 혼재 (개인/가족/업무) → 프라이버시 위험
  • ❌ 템플릿 재사용 어려움 → 반복 작업
  • ❌ 도메인 지식 부족 → 일반론적 답변

계층적 에이전트의 이점:

  • ✅ 책임 분리: Meta Agent (조율) + Domain Agents (전문화)
  • ✅ 컨텍스트 격리: 도메인별 독립 메모리
  • ✅ 재사용성: 도메인 에이전트를 템플릿으로 배포
  • ✅ 확장성: 새 도메인 = 새 에이전트 추가
  • ✅ 병렬 실행: 여러 도메인 동시 처리

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

개인 시스템 (Personal):

  • **시간(Time)**: 재현 가능한 환경, Git 버전 관리
  • **정신(Mind)**: 인간지능 + AI 협업
  • **방(Room)**: AI Agent 워크스페이스

계층적 시스템 (Hierarchical):

  • **시간(Time)**: 도메인별 독립 히스토리 (~/org/{domain}/)
  • **정신(Mind)**: Meta Intelligence + Domain Intelligence
  • **방(Room)**: 계층적 에이전트 오케스트레이션

🏗️ 레이어 아키텍처

5-Layer Hierarchical Agent System

┌─────────────────────────────────────────────────┐
│  Layer 5: User Interface                        │
│  - Natural Language (대화)                      │
│  - Slash Commands (/family, /work, ...)        │
│  - Emacs/Org-mode Interface                    │
└─────────────────────────────────────────────────┘
                     ↓
┌─────────────────────────────────────────────────┐
│  Layer 4: Meta Agent (claude-config)            │
│  ┌───────────────────────────────────────────┐  │
│  │ 역할:                                     │  │
│  │ - 사용자 의도 파악 (Intent Recognition)  │  │
│  │ - 도메인 라우팅 (Domain Routing)         │  │
│  │ - 작업 위임 (Task Delegation)            │  │
│  │ - 결과 통합 (Result Aggregation)         │  │
│  │ - 전체 오케스트레이션                     │  │
│  └───────────────────────────────────────────┘  │
│                                                 │
│  메모리: ~/claude-memory/                       │
│  지침서: CLAUDE.md                              │
└─────────────────────────────────────────────────┘
                     ↓ delegate
┌─────────────────────────────────────────────────┐
│  Layer 3: Domain Agents                         │
│  ┌───────────────────────────────────────────┐  │
│  │ Family-Config Agent (가족 생활)          │  │
│  │ - 메모리: ~/org/family/                  │  │
│  │ - 지침서: FAMILY.md                       │  │
│  │ - 도메인: travel, finance, education...  │  │
│  └───────────────────────────────────────────┘  │
│  ┌───────────────────────────────────────────┐  │
│  │ Work-Config Agent (업무) [미래]          │  │
│  │ - 메모리: ~/org/work/                    │  │
│  │ - 지침서: WORK.md                         │  │
│  │ - 도메인: projects, clients, meetings... │  │
│  └───────────────────────────────────────────┘  │
│  ┌───────────────────────────────────────────┐  │
│  │ Health-Config Agent (건강) [미래]        │  │
│  │ - 메모리: ~/org/health/                  │  │
│  │ - 지침서: HEALTH.md                       │  │
│  │ - 도메인: fitness, diet, medical...      │  │
│  └───────────────────────────────────────────┘  │
└─────────────────────────────────────────────────┘
                     ↓ execute
┌─────────────────────────────────────────────────┐
│  Layer 2: MCP Tools                             │
│  - web_search (정보 검색)                       │
│  - n8n (워크플로우 자동화)                      │
│  - playwright (웹 자동화)                       │
│  - git (버전 관리)                              │
│  - calendar (일정 관리)                         │
│  - supabase (데이터 쿼리)                       │
└─────────────────────────────────────────────────┘
                     ↓
┌─────────────────────────────────────────────────┐
│  Layer 1: External Services                     │
│  - Google Calendar/Drive                        │
│  - Banking APIs                                 │
│  - Airlines, Hotels                             │
│  - Educational Platforms                        │
│  - Healthcare Systems                           │
└─────────────────────────────────────────────────┘

🔄 작업 흐름 (Workflow)

기본 흐름

사용자 요청
    ↓
Meta Agent (Layer 4)
    ↓
Intent Recognition (의도 파악)
    ↓
    ├─ Personal Domain? → Claude-Memory
    ├─ Family Domain? → Family-Config Agent
    ├─ Work Domain? → Work-Config Agent
    └─ Mixed? → Multiple Agents (병렬)
    ↓
Domain Agent(s) (Layer 3)
    ↓
    ├─ Load {DOMAIN}.md (지침서)
    ├─ Load ~/org/{domain}/ (메모리)
    ├─ Load templates/ (템플릿)
    └─ Execute with MCP tools
    ↓
MCP Tools (Layer 2)
    ↓
External Services (Layer 1)
    ↓
Results → Domain Agent
    ↓
Results → Meta Agent
    ↓
Unified Response → User

시나리오 1: 여행 계획 (단일 도메인)

사용자: "여름에 제주도 가족 여행 계획 좀 도와줘"

[Meta Agent]
1. Intent: "가족 여행" → family domain
2. Task Type: travel.plan
3. Delegate to: Family-Config Agent

[Family-Config Agent]
1. FAMILY.md 로드
2. ~/org/family/travel/ 확인
3. 과거 패턴 분석:
   - 2024년 부산 여행: 300만원, 4박 5일
   - 선호: 자연 체험, 가족 친화적 숙소
4. travel/templates/trip-planning.org 사용
5. MCP 도구 실행:
   - web_search: 제주도 항공권
   - web_search: 가족 숙소
   - web_search: 액티비티
6. 결과를 Org 파일로 생성:
   ~/org/family/travel/20250720-jeju.org
7. 예산 자동 계산 (Ledger)
8. Calendar 이벤트 생성

[Meta Agent]
결과 통합 및 사용자에게 보고:
"제주도 여행 계획이 완성되었습니다:
 - 파일: ~/org/family/travel/20250720-jeju.org
 - 예산: 285만원 (목표 300만원 이내)
 - 항공권 옵션: 5개 (가장 저렴: 68만원)
 - 숙박 옵션: 12개 (추천: 힐튼 리조트)
 - 다음 단계: 항공권 예약 (마감: 4월 30일)"

시나리오 2: 통합 작업 (다중 도메인)

사용자: "오늘 할 일 정리 좀 해줘"

[Meta Agent]
1. Multiple Domains 감지
2. 병렬 실행:
   ├─ Personal: claude-memory/
   ├─ Family: Family-Config Agent
   └─ Work: Work-Config Agent

[Personal Domain] (Meta Agent 직접 처리)
- ~/claude-memory/projects/ 스캔
- 활성 프로젝트: "family-config 구축"
- TODO: README.md 완성

[Family-Config Agent] (백그라운드)
- ~/org/family/events/ 스캔
  → "내일: 친구 결혼식" 발견
- ~/org/family/finance/ 확인
  → "이번 달 예산 90% 사용" 경고
- ~/org/family/education/ 확인
  → "아이1 시험: 다음 주 수요일"

[Work-Config Agent] (백그라운드)
- ~/org/work/projects/ 스캔
  → "프로젝트 A: 코드 리뷰 대기"
- ~/org/work/meetings/ 확인
  → "오후 3시: 팀 미팅"

[Meta Agent]
결과 통합:
"오늘 할 일 (우선순위순):

개인:
- [ ] family-config README.md 완성

가족:
- [ ] 결혼식 부조금 준비 (5만원)
- ⚠️  이번 달 예산 90% 사용 (주의)
- 📅 아이1 시험 준비 확인 (다음 주)

업무:
- [ ] 프로젝트 A 코드 리뷰
- [ ] 15:00 팀 미팅 준비"

시나리오 3: 능동적 알림 (백그라운드 에이전트)

[Family-Config Agent] (Cron: 매일 06:00)
1. events/ 디렉토리 스캔
2. 이번 주 경조사 발견:
   - 토요일: 외삼촌 생신
3. 과거 기록 조회:
   - 2024년: 5만원 (전화 + 선물)
   - 2023년: 5만원 (전화 + 식사)
4. Meta Agent에 알림 전송

[Meta Agent]
사용자에게 프롬프트:
"🎂 이번 주 토요일은 외삼촌 생신입니다.
 - 과거 패턴: 5만원 (전화 + 선물)
 - 제안: 전화 드리기 + 온라인 선물 배송
 - 예산: finance/gifts 카테고리
 - 일정: calendar에 추가할까요?"

🤝 에이전트 인터페이스

위임 프로토콜 (Delegation Protocol)

요청 형식 (Request)

# Meta Agent → Domain Agent
delegation:
  version: 1.0.0
  agent: family-config
  task:
    type: family.travel.plan
    priority: high
    deadline: "2025-04-30"
  context:
    destination: "제주도"
    start_date: "2025-07-20"
    end_date: "2025-07-27"
    budget: 3000000
    participants:
      - role: dad
      - role: mom
      - role: child1
        age: 8
      - role: child2
        age: 5
  preferences:
    accommodation: "가족 친화적 리조트"
    activities: ["자연 체험", "문화 관광"]
  output:
    format: org_file
    location: ~/org/family/travel/
    filename_pattern: "{date}-{destination}.org"
    notify: true

응답 형식 (Response)

# Domain Agent → Meta Agent
result:
  status: success
  agent: family-config
  task_id: 20251014T130500
  execution_time: 45s
  
  output:
    file_path: ~/org/family/travel/20250720-jeju.org
    format: org
    
  summary:
    flights_found: 5
    flights_best_price: 680000
    accommodations_found: 12
    accommodations_recommended: "힐튼 제주"
    total_budget_estimated: 2850000
    days_planned: 7
    
  next_actions:
    - action: book_flight
      deadline: "2025-04-30"
      estimated_cost: 680000
    - action: book_accommodation
      deadline: "2025-05-15"
      estimated_cost: 1400000
    - action: book_rental_car
      deadline: "2025-06-01"
      estimated_cost: 420000
      
  metadata:
    mcp_calls: 8
    tokens_used: 1200
    templates_used: ["trip-planning.org"]
    patterns_matched: ["jeju", "family-4", "summer"]

작업 타입 (Task Types)

Family Domain

  • family.travel.plan: 여행 계획
  • family.travel.track: 여행 경비 추적
  • family.events.manage: 경조사 관리
  • family.events.remind: 경조사 알림
  • family.finance.budget: 예산 수립
  • family.finance.track: 지출 추적
  • family.finance.report: 재무 리포트
  • family.education.schedule: 교육 일정
  • family.education.track: 학습 추적
  • family.childcare.routine: 육아 루틴
  • family.childcare.health: 건강 관리
  • family.calendar.sync: 일정 동기화

Work Domain (미래)

  • work.project.plan: 프로젝트 계획
  • work.task.assign: 작업 할당
  • work.meeting.schedule: 회의 일정
  • work.report.generate: 리포트 생성

Health Domain (미래)

  • health.fitness.plan: 운동 계획
  • health.diet.track: 식단 추적
  • health.medical.schedule: 진료 예약

📂 디렉토리 구조

Meta-Config (이 프로젝트)

~/repos/gh/meta-config/
├── README.org                    # 이 문서
├── docs/
│   ├── delegation-protocol.org  # 위임 프로토콜 상세
│   ├── task-types.org           # 작업 타입 정의
│   └── examples/                # 시나리오 예시
└── schemas/
    ├── delegation-request.yaml  # 요청 스키마
    └── delegation-response.yaml # 응답 스키마

전체 시스템

~/.config/claude-code/           # Meta Agent 설정
~/claude-config/                 # Meta Agent 메모리
  ├── CLAUDE.md                  # Meta Agent 지침서
  └── memory/                    # 개인 메모리 (PARA)

~/repos/gh/family-config/        # Family Agent 템플릿
  ├── FAMILY.md                  # Family Agent 지침서
  ├── memory/                    # 패턴 축적
  └── {domain}/templates/        # 도메인별 템플릿

~/org/family/                    # Family 실제 데이터
  ├── travel/
  ├── finance/
  ├── education/
  └── ...

~/repos/gh/work-config/          # Work Agent 템플릿 (미래)
~/org/work/                      # Work 실제 데이터 (미래)

~/repos/gh/health-config/        # Health Agent 템플릿 (미래)
~/org/health/                    # Health 실제 데이터 (미래)

🎯 구현 로드맵

Phase 1: Proof of Concept (2025 Q4)

  • [X] Family-Config Agent 템플릿 구축
  • [ ] Meta Agent 위임 프로토콜 설계
  • [ ] 단일 도메인 위임 테스트
  • [ ] Travel 영역 검증

Phase 2: Multi-Domain (2026 Q1)

  • [ ] Work-Config Agent 추가
  • [ ] 다중 도메인 병렬 실행
  • [ ] 결과 통합 최적화
  • [ ] 백그라운드 에이전트 구현

Phase 3: Intelligence (2026 Q2)

  • [ ] 패턴 학습 및 추천
  • [ ] 도메인 간 인사이트 공유
  • [ ] 능동적 제안 시스템
  • [ ] 사용자 선호도 학습

Phase 4: Ecosystem (2026 Q3+)

  • [ ] Health/Finance/… 도메인 추가
  • [ ] 커뮤니티 에이전트 템플릿 허브
  • [ ] 에이전트 마켓플레이스
  • [ ] 표준화 및 상호운용성

🔬 기술적 과제

1. 컨텍스트 관리

문제: 도메인별 컨텍스트를 어떻게 격리하면서도 필요시 공유할 것인가?

해결 방향:

  • 도메인별 독립 메모리 (~org/{domain}/)
  • 명시적 컨텍스트 전달 (delegation protocol)
  • 공유 컨텍스트는 Meta Agent가 중재

2. 에이전트 통신

문제: 에이전트 간 효율적 통신 프로토콜

해결 방향:

  • YAML 기반 구조화된 메시지
  • 비동기 실행 (백그라운드 에이전트)
  • 결과 캐싱 및 재사용

3. 일관성 보장

문제: 여러 도메인 에이전트의 결과를 어떻게 통합?

해결 방향:

  • 표준화된 출력 형식 (Org-mode)
  • Meta Agent의 결과 검증
  • 충돌 해결 규칙

4. 프라이버시

문제: 도메인별 민감도가 다른 데이터 보호

해결 방향:

  • 물리적 분리 (별도 Git 저장소)
  • 접근 제어 (도메인 에이전트만 접근)
  • 선택적 공유 (명시적 동의)

💡 핵심 통찰

“Config as Agent Contract”

{DOMAIN}.md 파일은:

  • 단순한 설정이 아님
  • 에이전트 계약서(Contract)
  • 도메인 언어 정의
  • 위임 인터페이스 명세

“Hierarchical Intelligence”

Meta Intelligence (조율)
    ↓
Domain Intelligence (전문화)
    ↓
Tool Intelligence (실행)
    ↓
Service Intelligence (외부)

각 레벨은:

  • 독립적 책임
  • 명확한 인터페이스
  • 재사용 가능한 컴포넌트

“Separation of Concerns”

  • **Meta Agent**: What (무엇을 할까?)
  • **Domain Agent**: How (어떻게 할까?)
  • **MCP Tools**: Execute (실행)
  • **Services**: Provide (제공)

🔗 관련 문서

📖 참고 자료

개념적 배경

  • **Hierarchical Task Networks (HTN)**: AI Planning 이론
  • **Microservices Architecture**: 서비스 분리 및 오케스트레이션
  • **Actor Model**: Erlang/Akka 메시지 기반 시스템
  • **Delegation Pattern**: OOP 설계 패턴

영감을 준 프로젝트

  • **AutoGPT**: 자율 에이전트
  • **LangChain Agents**: 도구 체인
  • **n8n**: 워크플로우 오케스트레이션
  • **Emacs Org-mode**: 구조화된 텍스트

🚀 시작하기

전제 조건

  • Emacs + Org-mode
  • Claude Code (Meta Agent)
  • MCP 도구 설정
  • Git

1단계: Family-Config 설치

git clone https://github.com/junghanacs/family-config.git ~/repos/gh/family-config
cd ~/repos/gh/family-config

2단계: 실제 데이터 폴더

mkdir -p ~/org/family
cd ~/org/family
git init

3단계: 첫 위임 테스트

사용자: “제주도 여행 계획 좀 도와줘”

Meta Agent가:

  1. “여행” 키워드 감지
  2. FAMILY.md 로드
  3. Family-Config Agent에 위임
  4. 결과 통합 및 보고

🤔 미래 질문들

기술적

  • [ ] 에이전트 간 분산 실행을 어떻게?
  • [ ] 에이전트 버전 관리는?
  • [ ] 에이전트 디버깅 도구는?
  • [ ] 에이전트 성능 측정은?

사용성

  • [ ] 사용자가 도메인을 어떻게 정의?
  • [ ] 에이전트 간 충돌 해결은?
  • [ ] 사용자 피드백 반영은?
  • [ ] 에이전트 신뢰도 평가는?

생태계

  • [ ] 커뮤니티 에이전트 공유는?
  • [ ] 표준화된 인터페이스는?
  • [ ] 에이전트 마켓플레이스는?
  • [ ] 상업적 에이전트는?

📝 라이선스

MIT License

👤 작성자

**Junghan Kim** (junghanacs)

🙏 영감

  • **시간과정신의방**: 개인 컴퓨팅 환경 통합 철학
  • **PARA Method**: 정보 조직 방법론
  • **Denote**: 타임스탬프 기반 파일 관리
  • **Org-mode**: 구조화된 텍스트의 힘

**”The future is hierarchical, specialized, and collaborative.”** **”미래는 계층적이고, 전문화되며, 협업한다.”**

About

Hierarchical agent orchestration system with JSON-RPC 2.0 unified architecture

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published