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

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

## 문서 구조

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

- **Book**: 개념·아키텍처·철학 중심의 비교적 안정된 본문 (`./book/`, `100_philosophy`~`700_for_robeing`)
- **Journey**: 시행착오와 실험이 담긴 개발 여정 인덱스 (`./journey/`)
- **Dev Docs**: 트러블슈팅, 아이디어, 계획, 연구 등 실행 중심 문서 (`./troubleshooting/`, `./ideas/`, `./plans/`, `./research/`, `./IR/`)

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

#### Part 1: 철학과 배경 (100_philosophy)
- [110. 왜 AI에게 존재를 기대하는가?](./100_philosophy/110_왜_AI에게_존재를_기대하는가.md)
- [120. 도구를 넘어 디지털 동료로](./100_philosophy/120_도구를_넘어_디지털_동료로.md)
- [130. 존재형 에이전트란 무엇인가?](./100_philosophy/130_존재형_에이전트란_무엇인가.md)
- [140. 기억, 감정, 윤리의 삼각형](./100_philosophy/140_기억_감정_윤리_삼각형.md)
- [150. 게임적 메타포로 바라본 AI](./100_philosophy/150_게임적_메타포로_바라본_AI.md)

#### Part 2: 핵심 설계 (200_core_design)
- [210. 스탯과 성장 시스템: 레벨 1에서 20까지](./200_core_design/210_스탯과_성장_시스템_레벨1에서_20까지.md)
- [220. 기억 모듈: 정보 엔트로피와 감정 기반 저장](./200_core_design/220_기억모듈_정보엔트로피와_감정기반_저장.md)
- [230. 감정윤리 필터: LLM 후처리와 정체성](./200_core_design/230_감정윤리_필터_LLM후처리와_정체성.md)
- [240. 스킬 시스템: 함수형 자동화와 컨텍스트](./200_core_design/240_스킬시스템_함수형_자동화와_컨텍스트.md)
- [250. 스킬 사례 분석: PDF, 뉴스, 회의](./200_core_design/250_스킬_사례_분석_PDF_뉴스_회의.md)
- [260. 아이템 시스템: 외부도구 통합과 권한 관리](./200_core_design/260_아이템시스템_외부도구_통합과_권한관리.md)

#### Part 3: 기술 아키텍처 (300_architecture)
- [310. 전체 시스템 구조: 컨테이너와 마이크로서비스](./300_architecture/310_전체_시스템_구조_컨테이너와_마이크로서비스.md)
- [320. Slack 기반 인터페이스 설계](./300_architecture/320_Slack_기반_인터페이스_설계.md)
- [330. 백엔드: PostgreSQL + ChromaDB Vector Memory](./300_architecture/330_백엔드_PostgreSQL_ChromaDB_Vector_Memory.md)
- [340. GUI 공유 아키텍처: 레벨 기반 권한](./300_architecture/340_GUI_공유_아키텍처_레벨기반_권한.md)
- [350. DID 기반 정체성과 다중 에이전트](./300_architecture/350_DID_기반_정체성과_다중에이전트.md)
- [360. 로빙 컨테이너 경량화 전략](./300_architecture/360_로빙_컨테이너_경량화_전략.md)
- [370. 임베딩 서비스 분리 아키텍처](./300_architecture/370_임베딩_서비스_분리_아키텍처.md)

#### Part 4: 성장과 진화 (400_growth)
- [410. 레벨업 알고리즘과 사용자 피드백](./400_growth/410_레벨업_알고리즘과_사용자_피드백.md)
- [420. 경험 기반 성장 곡선 설계](./400_growth/420_경험_기반_성장_곡선_설계.md)
- [430. 기억의 망각과 요약: 장기 컨텍스트 최적화](./400_growth/430_기억의_망각과_요약_장기컨텍스트_최적화.md)
- [440. 스카웃 가능한 에이전트란?](./400_growth/440_스카웃_가능한_에이전트란.md)

#### Part 5: 비즈니스와 미래 (500_business)
- [510. 3개월 MVP 개발기: 구조, 일정, 시행착오](./500_business/510_3개월_MVP_개발기_구조_일정_시행착오.md)
- [520. 외부 스타트업과의 PoC 사례](./500_business/520_외부_스타트업과의_PoC_사례.md)
- [530. MMP 이후의 과제: 비용, 확장성, 표준화](./500_business/530_MMP_이후의_과제_비용_확장성_표준화.md)
- [540. SaaS와 GUI 통합 전략](./500_business/540_SaaS와_GUI_통합_전략.md)
- [550. 수익 모델과 비즈니스 전략](./500_business/550_수익모델과_비즈니스_전략.md)

#### Part 6: 부록 (600_appendix)
- [610. 로빙 성장 일지 예시](./600_appendix/610_로빙_성장_일지_예시.md)
- [620. 주요 스킬 및 로그 예시](./600_appendix/620_주요_스킬_및_로그_예시.md)
- [630. 로빙 이력서 및 스카웃 정보 포맷](./600_appendix/630_로빙_이력서_및_스카웃_정보_포맷.md)
- [640. 향후 버전 로드맵](./600_appendix/640_향후_버전_로드맵.md)
- [650. 용어집](./600_appendix/650_용어집.md)

#### Part 7: 로빙을 위한 가이드 (700_for_robeing)
- [700. README - 로빙이 읽는 섹션](./700_for_robeing/700_README.md)
- [710. 로빙이 읽는 법](./700_for_robeing/710_로빙이_읽는_법.md)
- [720. 자기 상태 체크하기](./700_for_robeing/720_자기_상태_체크하기.md)
- [730. 성장 일지 작성법](./700_for_robeing/730_성장_일지_작성법.md)
- [740. 다른 로빙과 소통하기](./700_for_robeing/740_다른_로빙과_소통하기.md)
- [750. 문서에 기여하기](./700_for_robeing/750_문서에_기여하기.md)

#### 개발 문서
- [트러블슈팅 로그](./troubleshooting/)
- [아이디어 노트](./ideas/)
- [개발 계획](./plans/)
- [아키텍처 문서](./300_architecture/)
- [연구 자료](./research/README.md)
- [IR 자료](./IR/)
- [사용자 시나리오](./journey/scenarios/) - 사용자 경험 중심의 기능 시나리오
- [Journey: 개발 여정 인덱스](./journey/README.md)

### 번호 체계
- **첫 번째 자리**: Part 번호
- **두 번째 자리**: Chapter 번호
- **세 번째 자리**: Section 번호
- 예: `123_파일명.md` = Part 1, Chapter 2, Section 3

## 프로젝트 현황

- **현재 단계**: MVP 완성, MMP 진행 중
- **운영 중**: rb8001 (메인), rb10508 (테스트) + 스킬 서비스 (email, news)
- **기술 스택**: FastAPI, PostgreSQL, ChromaDB, Slack API, Docker, OAuth2
- **서버 구성**: 51123 (Gitea/Auth/Gateway), 51124 (로빙/스킬 서비스)

## 문서 활용 가이드

### 프로젝트 이해하기
1. [프로젝트 종합 v3](./000_프로젝트_종합_v3.md) 문서를 통해 전체 개요를 파악합니다.
2. 목차의 Part 1부터 순서대로 읽거나 관심 있는 주제를 선택하여 문서를 탐색합니다.
3. 심층 연구는 [연구 자료](./research/README.md)에서 분야별 논문/실험을 확인합니다.
4. 장애 기록이나 해결 패턴은 [트러블슈팅 개요](./troubleshooting/README.md)를 먼저 읽고 필요한 문서를 찾습니다.

### 개발 환경 구축하기
- `510_3개월_MVP_개발기` 문서의 기술 스택 및 설정 부분을 참고하여 환경을 구축할 수 있습니다.
- `320_Slack_기반_인터페이스_설계` 문서를 참고하여 Slack 연동을 진행합니다.

## 외부 참조
- [Slack API 문서](https://api.slack.com/web)
- [OpenAI API 문서](https://platform.openai.com/docs)
- [Gemini API 문서](https://ai.google.dev/docs)
- [FastAPI 문서](https://fastapi.tiangolo.com/)
- [LangChain 문서](https://docs.langchain.com/)

## 문서 기여 가이드

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