# Journey: 개발 여정 인덱스

이 폴더는 로빙 프로젝트의 **개발 여정**을 모아서 보는 인덱스입니다.  
원본 문서는 그대로 `troubleshooting/`, `ideas/`, `plans/`, `research/`, `worklog/`에 두고, 여기서는 "어떤 여정에서 어떤 문서를 참고해야 하는지"만 정리합니다.

## 문제 상태

### 열린 문제

- workspace-team-project 계층 재정의 문제
  - ssot: `../book/300_architecture/390_workspace_team_project_도메인_모델.md`
  - ideas: `ideas/260316_workspace_team_project_계층_재정의_아이디어.md`
  - research: `research/260316_workspace_team_project_계층_재정의_영향범위_리서치.md`
  - plans: `plans/260316_workspace_team_project_계층_재정의_전환계획.md`

### 닫힌 문제

- 프롬프트DB·자기개선루프 기본구현 검증 및 계획 종결
  - worklog: `worklog/260310_프롬프트DB_자기개선루프_기본구현_검증및계획종결.md`
- LLM 모델 SSOT와 workspace-config 분산 문제
  - troubleshooting: `troubleshooting/260316_workspace_config_루트기준_SSOT와_하드코딩_분산_문제오픈.md`
  - research: `research/260315_모델SSOT_하드코딩_분산과_workspace_config_로컬이식_통합리서치.md`
  - plans: `plans/260316_llm_model_ssot_transition_계획.md`
  - worklog: `worklog/260316_llm_model_ssot_1차구현_및_로컬검증.md`
  - worklog: `worklog/260316_gpt5_mini_전환과_skill_news_provider_agnostic_정리.md`

## Troubleshooting Journey

트러블슈팅 문서는 그대로 `troubleshooting/`에 두고, 여기서는 "여정" 관점에서 중요한 사건들만 묶어서 봅니다.

### 인프라/배포 이슈

- SSD 용량 부족 및 Docker 정리 – `troubleshooting/250716_SSD_용량_부족_및_Docker_정리.md`
- rb8001 배포 이슈 – `troubleshooting/250716_rb8001_deployment_issues.md`
- OpenSearch 설치 및 헬스체크 문제 – `troubleshooting/250914_admin_opensearch_installation.md`

### Slack / 인터페이스

- Slack 3초 타임아웃 룰 – `troubleshooting/250723_happybell80_Slack_3초룰.md`
- Slack 응답 및 스킬 호출 문제 – `troubleshooting/250723_happybell80_Slack응답및스킬호출문제.md`
- 프론트엔드 로빙 연결 및 UX 개선 – `troubleshooting/250730_happybell80_프론트엔드로빙연결.md`

### 운영 / 브리핑

- 네이버 이메일 분석 미전송과 실패 은닉 해결 – `troubleshooting/260309_9시_네이버이메일분석_미전송_실패은닉_해결.md`
- 네이버 이메일 분석 실패 은닉 리서치 – `research/260309_9시_네이버이메일분석_미전송_실패은닉_리서치.md`
- Calendar Skill 자동휴일감지 원인확정 리서치 – `research/260310_calendar_skill_자동휴일감지_행동제어_원인확정_리서치.md`
- 아침 뉴스 슬랙 포맷 SSOT 분산 및 표시 혼선 – `troubleshooting/260310_아침뉴스슬랙포맷_SSOT_분산_및_표시혼선.md`

### Intent / 리뷰 큐

- Intent 리뷰 큐 API 구현 – `troubleshooting/251116_admin_intent_review_queue_api_implementation.md`

## Ideas & Plans Journey

아이디어와 계획, 그리고 실제 실행까지의 흐름을 모아서 보는 여정입니다.  
원본 문서는 `ideas/`, `plans/`, 일부 `troubleshooting/`에 있습니다.

### CI/CD · 배포 최적화

- CI 빌드 시간 단축 계획 – `troubleshooting/250723_happybell80_CI빌드시간단축.md`

### 에이전트 구조 / Gateway 정리

- OpenClaw 기반 로빙 개선 아이디어 – `ideas/260309_openclaw_기반_로빙_개선_아이디어.md`
- 로빙 에이전트 루프와 스킬 훅 구조 아이디어 – `ideas/260312_로빙_에이전트루프와_스킬훅_구조_아이디어.md`
- workspace-team-project 계층 재정의 아이디어 – `ideas/260316_workspace_team_project_계층_재정의_아이디어.md`
- workspace-team-project 계층 재정의 전환계획 – `plans/260316_workspace_team_project_계층_재정의_전환계획.md`

### 컨텍스트 / 메모리 (OpenClaw 벤치마킹)

- OpenClaw 스타일 컨텍스트·compaction 아이디어 – `ideas/260317_OpenClaw_스타일_컨텍스트_compaction_아이디어.md`
- OpenClaw 컨텍스트·메모리 리서치 – `research/260317_OpenClaw_컨텍스트_메모리_리서치.md`

### Intent 리뷰 / 의도 학습

- Intent 리뷰 큐 설계 및 API 계획 – `../300_architecture/390_human_in_the_loop_intent_learning.md`

## Research Journey

의도 분류, 메모리, HITL(Human-in-the-Loop) 관련 연구와 실제 구현이 어떻게 연결되고 있는지 정리한 여정입니다.  
원본 연구 문서는 `research/`와 `rb8001/experiment_results/` 아래에 있습니다.

### 의도 분류 연구 → 구현

- 의도 분류 이론/논문 정리 – `research/intent_classification/README.md`
- Memory · Classification 하이브리드 분류 연구 – `research/memory/classification/README.md`
- E2E Intent 개선 실험 보고서 – `rb8001/experiment_results/e2e_final_experiment_report.md`

### 에이전트 루프 / 오케스트레이션

- 로빙 에이전트 루프·스킬 훅·LLM 실행 구조 리서치 – `research/orchestration_tools/260312_로빙_에이전트루프_스킬훅_LLM실행구조_리서치.md`
- 로빙 LLM API·Agent API·모델 선정·비용 비교 리서치 – `research/orchestration_tools/260312_로빙_LLM_API_Agent_API_모델선정_비용비교_리서치.md`

### LLM 출력 계약 / 안정화

- Pydantic AI 도입 기반 LLM 출력 안정화 방향확정 리서치 – `research/260313_pydantic_ai_도입_기반_llm_출력_안정화_방향확정_리서치.md`
- 모델 SSOT 하드코딩 분산과 workspace-config 로컬 이식 통합 리서치 – `research/260315_모델SSOT_하드코딩_분산과_workspace_config_로컬이식_통합리서치.md`

### 컨텍스트 / 메모리

- OpenClaw 컨텍스트·메모리 리서치 – `research/260317_OpenClaw_컨텍스트_메모리_리서치.md`

### HITL / 리뷰 큐

- Human-in-the-Loop Intent Learning 아키텍처 – `../300_architecture/390_human_in_the_loop_intent_learning.md`

## Debug

- [디버그 인덱스](./debug/README.md) – 구현 직전 단계에서 문제 지점과 상태 차이를 고정하는 보조 문서 계층
- [콜드메일 IR 분석이 첫 번째 PDF를 잘못 선택하는 상태](./debug/260313_coldmail_ir_분석대상_오선택_디버그.md)
- [콜드메일 IR 분석 로딩 메시지가 완료 후 갱신되지 않는 상태](./debug/260313_coldmail_ir_로딩메시지_미갱신_디버그.md)
- [스케줄러 재기동 후 브리핑 실패 디버그](./debug/260318_스케줄러_재기동후_브리핑실패_디버그.md)

## Worklog Journey

- 프롬프트DB·자기개선루프 기본구현 검증 및 계획 종결 – `worklog/260310_프롬프트DB_자기개선루프_기본구현_검증및계획종결.md`
- Calendar Skill 자동휴일감지 행동제어 구현 및 검증 – `worklog/260310_calendar_skill_자동휴일감지_행동제어_구현및검증.md`
- 브리핑 조회 윈도우 직전 영업일 기준 확장 – `worklog/260310_briefing_window_직전영업일기준_확장.md`
- Company X 내부문서 RAG 근거응답 구현 및 시나리오 검증 – `worklog/260312_companyx_내부문서_rag_근거응답_구현및시나리오검증.md`
- LLM 모델 SSOT 1차구현 및 로컬검증 – `worklog/260316_llm_model_ssot_1차구현_및_로컬검증.md`
- gpt-5-mini 전환과 skill-news provider-agnostic 정리 – `worklog/260316_gpt5_mini_전환과_skill_news_provider_agnostic_정리.md`
- 브리핑 스케줄 런타임 정합화 및 강제실행 검증 – `worklog/260318_브리핑스케줄_런타임정합화_및_강제실행검증.md`

## Scenarios

- [로빙 UX 기능 시나리오 인덱스](./scenarios/README.md) – 사용자 경험 중심의 기능 시나리오 (UX)

---

> 새로운 문서가 생기면 관련 섹션에 링크만 추가합니다. 상세 내용은 원본 문서를 참조하세요.
