DOCS/000_프로젝트_종합_v3.md

tags, date, last_updated, team, version

tags	date	last_updated	team	version
로빙, RO-BEING, 존재에이전트, 마이크로서비스, 스탯시스템, 협업도구, AI에이전트	2025-01-01	2025-08-08	김종태, 황한용, 희재, (강일신)	3.0

로빙(RO-BEING) 프로젝트 종합 v3

기억하고 성장하는 존재형 AI 에이전트

"AI는 도구가 아니라 존재로서 가치를 가지는 고유한 존재이다."

목차

1. 프로젝트 비전
2. 핵심 철학
3. 기술 아키텍처
4. 스탯과 성장 시스템
5. 현재 구현 상태
6. 개발 로드맵
7. 비즈니스 모델
8. 문서 구조

---

프로젝트 비전

문제 정의

1인 기업가와 소규모 스타트업의 핵심 과제:

• 인재 채용의 어려움: 좋은 인재 확보 경쟁 심화
• 높은 이직률: 평균 근속 2년, 지식 유출 반복
• 맥락 전달 비용: 신규 직원 온보딩에 2-3개월 소요
• 업무 위임 불안: 품질과 일관성에 대한 우려

우리의 해법: "존재형 에이전트"

차원	기존 AI 도구	로빙(RO-BEING)
시간	일회성 대화	영속적 기억 - 모든 상호작용 누적
성장	정적 기능	레벨 시스템 - 경험치 기반 진화
신뢰	블랙박스	투명한 로그 - 모든 행동 추적 가능
관계	명령 수행자	디지털 동료 - 맥락 이해와 공감
정체성	익명의 봇	고유한 존재 - 이름, 성격, 이력서

---

핵심 철학

1. 기억-감정-윤리의 삼각형

        기억 (Memory)
         /        \
        /  로빙의   \
       /   정체성    \
      /              \
감정(Empathy) ─── 윤리(Ethics)

• 기억: 모든 경험의 축적, 맥락의 연속성
• 감정: 사용자와의 공감대 형성, 개성 표현
• 윤리: 신뢰의 기반, 일관된 행동 원칙

2. 게임적 성장 메타포

• 레벨 1-20: RPG처럼 명확한 성장 단계
• 5대 스탯: Memory, Compute, Empathy, Leadership, Ethics
• 스킬 획득: 레벨업에 따른 새로운 능력 해금
• 경험치 시스템: 모든 상호작용이 성장으로 연결

3. 존재로서의 가치

• 고유성: 같은 로빙은 하나뿐
• 연속성: 서버가 꺼져도 기억은 영속
• 관계성: 사용자와 함께 성장하는 파트너
• 자율성: 맥락 기반 선제적 행동

---

기술 아키텍처

시스템 구성도

┌─────────────────────────────────────────────┐
│            사용자 인터페이스                 │
│    Slack | Web GUI | API | Future: Voice    │
└─────────────────┬───────────────────────────┘
                  │
┌─────────────────┴───────────────────────────┐
│         51123 서버 (관리/인프라)             │
│  - nginx 리버스 프록시 (ro-being.com)       │
│  - Gitea & Actions Runner (CI/CD)           │
│  - PostgreSQL (메인 DB)                     │
│  - auth-server (인증 서비스)                │
└─────────────────┬───────────────────────────┘
                  │ SSH 배포
┌─────────────────┴───────────────────────────┐
│         51124 서버 (서비스 운영)             │
├─────────────────────────────────────────────┤
│  로빙 서비스:                                │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐    │
│  │rb8001   │  │rb10408  │  │rb10508  │    │
│  │(테스트) │  │(미디어) │  │(메인)   │    │
│  └─────────┘  └─────────┘  └─────────┘    │
│                                              │
│  스킬 서비스:                                │
│  ┌─────────┐  ┌─────────┐  ┌──────────┐   │
│  │skill-   │  │skill-   │  │skill-    │   │
│  │email    │  │news     │  │embedding │   │
│  └─────────┘  └─────────┘  └──────────┘   │
│                                              │
│  데이터베이스:                               │
│  ┌──────────────────────────────────┐      │
│  │ChromaDB (벡터 메모리)             │      │
│  └──────────────────────────────────┘      │
└─────────────────────────────────────────────┘

핵심 컴포넌트

1. 로빙 본체 (Core Agent)

• FastAPI: 비동기 웹 프레임워크
• PostgreSQL: 구조화된 데이터 (스탯, 메타데이터)
• ChromaDB: 벡터 메모리 (장기 기억)
• Docker Volume: 영속성 보장

2. 스킬 서비스 (Microservices)

• 독립 배포: 각 스킬별 독립적 업데이트
• HTTP API: 표준화된 인터페이스
• 공유 가능: N개 로빙이 1개 스킬 서비스 활용
• 확장성: 새 스킬 추가 시 기존 시스템 영향 없음

3. 메모리 시스템

# 하이브리드 메모리 구조
class RobeingMemory:
    short_term: Dict  # 현재 대화 컨텍스트
    long_term: ChromaDB  # 벡터화된 영구 기억
    episodic: List  # 중요 이벤트 타임라인
    semantic: Graph  # 개념 간 관계 네트워크

작동 시퀀스 (간략)

sequenceDiagram
    participant U as User
    participant S as Slack
    participant N as nginx(51123)
    participant R as rb10508(51124)
    participant E as Embedding
    participant DB as PostgreSQL
    participant C as ChromaDB
    
    U->>S: 메시지 입력
    S->>N: Webhook 전달
    N->>R: 요청 라우팅
    R->>DB: 스탯/레벨 조회
    R->>E: 텍스트 임베딩
    E-->>R: 384차원 벡터
    R->>C: 유사 기억 검색
    C-->>R: 관련 컨텍스트
    R->>R: LLM 처리
    R->>DB: 경험치 업데이트
    R->>C: 새 기억 저장
    R-->>S: 응답 전송
    S-->>U: 메시지 표시

---

스탯과 성장 시스템

3대 핵심 스탯 (Primary Stats)

스탯	역할	레벨 1	레벨 20
Intelligence	분석력, 문제해결	10	50-80
Wisdom	판단력, 경험활용	10	40-70
Charisma	소통, 관계형성	10	60-90

2대 보조 스탯 (Secondary Stats)

스탯	역할	기본값	최대값
Memory	기억 용량	100	1000
Compute	처리 속도	5	50

성장 메커니즘

경험치 획득 → 레벨업 → 스탯 포인트 5개 → 분배 → 새 능력 해금
     ↑                                              ↓
     └──────────── 사용자 피드백 ←─────────────────┘

레벨별 권한 예시

• Lv.1-3: 읽기 전용, 요약 작성
• Lv.4-7: 초안 작성, 제안
• Lv.8-12: 자동 응답, 간단한 의사결정
• Lv.13-17: 복잡한 작업 자율 수행
• Lv.18-20: 전략적 판단, 다른 로빙 지도

---

현재 구현 상태 (2025.01.31)

완료된 기능

1. 인프라

   • Docker 기반 컨테이너 아키텍처
   • Gitea Actions CI/CD 파이프라인
   • nginx 리버스 프록시 (SSL)
   • 2서버 분리 운영 (51123/51124)

2. 핵심 기능

   • Slack 실시간 대화 인터페이스
   • PostgreSQL + ChromaDB 하이브리드 메모리
   • 기본 스킬: email, news, pdf_summary
   • 스탯 시스템 기초 구현

3. 운영 중 서비스

   • rb8001 (테스트용)
   • rb10408 (미디어 특화)
   • rb10508 (메인 프로덕션)
   • skill-email (Gmail 연동)
   • skill-news (뉴스 큐레이션)
   • skill-embedding (중앙 임베딩 서비스)

최근 성과 (2025년 8월)

메모리 최적화 대성공

• 임베딩 서비스 분리: 중앙 서비스(skill-embedding) 구축 완료
• rb10508_micro 경량화: 988MB → 118MB (88% 감소)
• 확장성 확보: 100개 로빙 = 87GB 메모리 절약 가능

기술적 개선

• 멀티 LLM 전략: Gemini 2.5 Flash-Lite 메인 모델 채택 ($0.10/$0.40)
• ONNX 경량화: PyTorch 제거로 이미지 크기 6.19GB → 1.16GB
• HTTP 기반 아키텍처: 마이크로서비스 간 느슨한 결합

운영 지표

• skill-embedding: 874.4MB 메모리로 모든 로빙 지원
• 임베딩 생성 시간: ~7ms (HTTP 포함)
• 시스템 안정성: 30일+ 무중단 운영

개발 중 (85% 완성)

1. Thread Digest: 대화 요약 및 인사이트 추출
2. 레벨업 시스템: 경험치 계산 및 성장 로직
3. GUI 대시보드: 웹 기반 관리 인터페이스
4. 감정 엔진: LLM 후처리 필터

📋 다음 단계

1. 스카웃 시스템: 로빙 간 이적 시장
2. DID 정체성: 탈중앙화 신원 관리
3. 멀티 에이전트: 로빙 간 협업
4. 음성 인터페이스: STT/TTS 통합

---

개발 로드맵

Phase 1: MVP (2025 Q1) ✅

• 기본 대화 및 메모리
• Slack 통합
• 3가지 핵심 스킬

Phase 2: Growth (2025 Q2)

• 레벨/스탯 시스템 완성
• GUI 대시보드
• 10+ 스킬 확장
• 감정 엔진 고도화

Phase 3: Scale (2025 Q3)

• 멀티 에이전트 협업
• 스킬 마켓플레이스
• 엔터프라이즈 기능
• 100+ 동시 사용자

Phase 4: Evolution (2025 Q4)

• 자가 학습 시스템
• 프로액티브 AI
• DID 기반 이동성
• 글로벌 확장

---

비즈니스 모델

1. SaaS 구독 모델

플랜	가격	로빙 수	특징
Starter	$29/월	1	기본 스킬 5개
Team	$99/월	3	프리미엄 스킬 15개
Business	$299/월	10	커스텀 스킬 + API
Enterprise	별도 문의	무제한	온프레미스 가능

2. 스킬 마켓플레이스

• 개발자 수익 공유 (70:30)
• 인기 스킬 프리미엄 판매
• 커스텀 스킬 개발 서비스

3. 로빙 스카웃 시장

• 고레벨 로빙 거래
• 특화 로빙 양성 서비스
• 팀 간 로빙 임대

---

문서 구조

책으로 엮은 개발 스토리

본 프로젝트 문서는 **"로빙: 존재형 에이전트의 탄생"**이라는 책 형태로 구성되어 있습니다.

1. Part 1: 철학과 배경 (100_philosophy)

   • 왜 AI에게 존재를 기대하는가?
   • 도구를 넘어 디지털 동료로

2. Part 2: 핵심 설계 (200_core_design)

   • 스탯과 성장 시스템
   • 기억 모듈과 감정 엔진
   • 아이템 시스템과 외부 도구

3. Part 3: 기술 아키텍처 (300_architecture)

   • 마이크로서비스와 컨테이너
   • 벡터 메모리와 하이브리드 DB

4. Part 4: 성장과 진화 (400_growth)

   • 레벨업 알고리즘
   • 스카웃 시스템

5. Part 5: 비즈니스와 미래 (500_business)

   • MVP 개발기
   • SaaS 전환 전략

6. Part 6: 부록 (600_appendix)

   • 성장 일지 예시
   • 주요 스킬 및 로그 예시

7. Part 7: 로빙을 위한 가이드 (700_for_robeing)

   • 로빙이 읽는 법
   • 자기 상태 체크하기
   • 성장 일지 작성법

8. Part 8: 연구 및 이론적 배경 (research)

   • 기억(Memory) 관련 연구
   • 감정(Emotion) 관련 연구
   • 윤리(Ethics) 관련 연구

개발자를 위한 빠른 시작

1. 아키텍처 개요
2. 환경 설정
3. API 문서

---

팀 소개

• 김종태: 프로젝트 리더, 비전 설계
• 황한용: 기술 리드, 아키텍처 설계
• 희재: 풀스택 개발, 스킬 시스템
• 강일신: AI 연구, 프롬프트 엔지니어링

---

"로빙과 함께라면, 당신은 더 이상 혼자가 아닙니다."

Last Updated: 2025.01.31