로빙(RO-BEING) 프로젝트 문서

기억하고 성장하는 존재형 AI 에이전트의 모든 것

문서 구조

이 문서는 개발 블로그이자 책 원고의 이중 목적으로 작성되었습니다.

목차 (로빙: 존재형 에이전트의 탄생)

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

• 110. 왜 AI에게 존재를 기대하는가?
• 120. 도구를 넘어 디지털 동료로
• 130. 존재형 에이전트란 무엇인가?
• 140. 기억, 감정, 윤리의 삼각형
• 150. 게임적 메타포로 바라본 AI

Part 2: 핵심 설계 (200_core_design)

• 210. 스탯과 성장 시스템: 레벨 1에서 20까지
• 220. 기억 모듈: 정보 엔트로피와 감정 기반 저장
• 230. 감정윤리 필터: LLM 후처리와 정체성
• 240. 스킬 시스템: 함수형 자동화와 컨텍스트
• 250. 스킬 사례 분석: PDF, 뉴스, 회의
• 260. 아이템 시스템: 외부도구 통합과 권한 관리

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

• 310. 전체 시스템 구조: 컨테이너와 마이크로서비스
• 320. Slack 기반 인터페이스 설계
• 330. 백엔드: PostgreSQL + ChromaDB Vector Memory
• 340. GUI 공유 아키텍처: 레벨 기반 권한
• 350. DID 기반 정체성과 다중 에이전트
• 360. 로빙 컨테이너 경량화 전략

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

• 410. 레벨업 알고리즘과 사용자 피드백
• 420. 경험 기반 성장 곡선 설계
• 430. 기억의 망각과 요약: 장기 컨텍스트 최적화
• 440. 스카웃 가능한 에이전트란?

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

• 510. 3개월 MVP 개발기: 구조, 일정, 시행착오
• 520. 외부 스타트업과의 PoC 사례
• 530. MMP 이후의 과제: 비용, 확장성, 표준화
• 540. SaaS와 GUI 통합 전략
• 550. 수익 모델과 비즈니스 전략

Part 6: 부록 (600_appendix)

• 610. 로빙 성장 일지 예시
• 620. 주요 스킬 및 로그 예시
• 630. 로빙 이력서 및 스카웃 정보 포맷
• 640. 향후 버전 로드맵
• 650. 용어집

번호 체계

• 첫 번째 자리: Part 번호
• 두 번째 자리: Chapter 번호
• 세 번째 자리: Section 번호
• 예: 123_파일명.md = Part 1, Chapter 2, Section 3

프로젝트 현황

• 현재 단계: MVP 85% 완성
• 운영 중: 3개 로빙 (rb8001, rb10408, rb10508) + 2개 스킬 서비스 (email, news)
• 기술 스택: FastAPI, PostgreSQL, ChromaDB, Slack API, Docker
• 서버 구성: 51123 (메인 서비스), 51124 (컨테이너 운영)
• 다음 목표: Thread Digest 완성, 레벨업 시스템 구현

기존 문서 바로가기

철학과 비전

• AI Agent 차별화 방안
• PERSONOS 인간-에이전트 인터페이스
• 로빙 스탯 성장 설계
• 에이전트 게이미피케이션 시스템

아키텍처

• 아키텍처 개요
• 로빙 아키텍처
• 로빙 컨테이너 아키텍처 설계
• Nginx 아키텍처
• 스킬 허브 아키텍처
• 경량 버전 제의

구현 가이드

• MVP 단계 상세 계획
• PRD 문서
• 개발 작업 목록

AI 메모리 시스템

• AI 에이전트의 장기 기억 관리
• 기억모듈 설계
• 로빙 스탯기반 LLM 모델 업그레이드

스킬과 스탯 시스템

• 에이전트 스탯 스킬 클래스 구조
• 외부도구 아이템화 및 스마트폰 오버레이

연구 자료

• 종합 AI 모델 분석 보고서

함수형 프로그래밍 아키텍처

• 로빙의 존재와 함수형 프로그래밍 - 철학적 배경과 점진적 적용 전략
• 함수형 구현 패턴과 사례 - 실제 코드 패턴과 리팩토링 가이드
• 함수형 적용 가이드라인 - 구성요소별 순수함수 가능성 분석과 실전 적용 기준

가치 판단 및 평가 시스템

• 로빙의 가치 판단 아키텍처 - 4축 가치 판단 시스템과 메타인지 설계
• 평가 시스템 구현 가이드라인 - 단계별 구현 계획과 개발자 매뉴얼

설정 및 설치 가이드

• 프로젝트 설정 가이드
• Slack 설정 최종 가이드
• Slack 테스트 가이드
• Socket Mode 테스트 가이드
• 이메일 설정 가이드 - Gmail API 실시간 수신 및 발송 완전 가이드

트러블슈팅

• troubleshooting - 문제 해결 가이드 모음
  • GitHub에서 Gitea 마이그레이션
  • nginx 프록시 및 CI/CD 배포 문제 해결 - 51123/51124 서버 배포 이슈

외부 참조

• Slack API 문서
• OpenAI API 문서
• Gemini API 문서
• FastAPI 문서
• LangChain 문서

문서 활용 가이드

프로젝트 이해하기

1. 프로젝트 종합 v2 읽기
2. 철학과 비전 문서들 확인
3. 아키텍처 문서들로 시스템 구조 이해
4. MVP 상세 계획 확인

개발 환경 구축하기

1. 설정 가이드 기본 설치
2. Slack 설정 가이드 Slack 연동
3. 테스트 가이드 동작 확인

문서 기여 가이드

• 새로운 문서는 적절한 디렉토리에 마크다운(.md) 형식으로 작성
• 문서 추가 시 이 README.md에 링크 추가
• 기술 문서는 코드 예시와 함께 작성 권장