From f4430d31ccc3c062f35d8a1d696e039acd63ebf2 Mon Sep 17 00:00:00 2001 From: Claude-51124 Date: Mon, 17 Nov 2025 13:25:58 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=EB=88=84=EB=9D=BD=EB=90=9C=20=ED=8C=8C?= =?UTF-8?q?=EC=9D=BC=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 4 ++ research/memory/classification/README.md | 22 +++++++++++ troubleshooting/README.md | 48 ++++++++++++++++++++++++ 3 files changed, 74 insertions(+) create mode 100644 research/memory/classification/README.md create mode 100644 troubleshooting/README.md diff --git a/README.md b/README.md index d42f86d..f59419f 100644 --- a/README.md +++ b/README.md @@ -65,6 +65,8 @@ - [아이디어 노트](./ideas/) - [개발 계획](./plans/) - [아키텍처 문서](./300_architecture/) +- [연구 자료](./research/README.md) +- [IR 자료](./IR/) ### 번호 체계 - **첫 번째 자리**: Part 번호 @@ -84,6 +86,8 @@ ### 프로젝트 이해하기 1. [프로젝트 종합 v3](./000_프로젝트_종합_v3.md) 문서를 통해 전체 개요를 파악합니다. 2. 목차의 Part 1부터 순서대로 읽거나 관심 있는 주제를 선택하여 문서를 탐색합니다. +3. 심층 연구는 [연구 자료](./research/README.md)에서 분야별 논문/실험을 확인합니다. +4. 장애 기록이나 해결 패턴은 [트러블슈팅 개요](./troubleshooting/README.md)를 먼저 읽고 필요한 문서를 찾습니다. ### 개발 환경 구축하기 - `510_3개월_MVP_개발기` 문서의 기술 스택 및 설정 부분을 참고하여 환경을 구축할 수 있습니다. diff --git a/research/memory/classification/README.md b/research/memory/classification/README.md new file mode 100644 index 0000000..1be0e57 --- /dev/null +++ b/research/memory/classification/README.md @@ -0,0 +1,22 @@ +# Memory · Classification + +Ko-SRoBERTa 기반 의미 검색과 고전적인 ML 분류(나이브 베이즈 등)를 결합해 의도/메모리 분류 정확도를 높이기 위한 연구 노트 모음입니다. + +## 포함 문서 + +| 파일 | 요약 | +|------|------| +| `2024_bert_embedding_feature_selection.md` | BERT 임베딩에서 상위 특징을 선택해 메모리 검색 성능을 높이는 방법 | +| `2024_hybrid_llm_ml_threshold.md` | LLM Confidence + ML 임계값을 조합한 하이브리드 분류 전략 | + +## 어떻게 읽나 + +1. `2024_hybrid_llm_ml_threshold.md` → 현재 의도 분류기의 threshold 설계 근거 +2. `2024_bert_embedding_feature_selection.md` → 임베딩 후처리/축약 기법 +3. 의도 분류 흐름 전체는 `DOCS/research/intent_classification/README.md`와 연결 + +## TODO + +- PT4AL 기반 쿼리 전략 실험 결과 추가 +- 의도 재학습 배치 결과 공유 +- ko-SRoBERTa fine-tuning 실험 로그 업로드 diff --git a/troubleshooting/README.md b/troubleshooting/README.md new file mode 100644 index 0000000..4723b37 --- /dev/null +++ b/troubleshooting/README.md @@ -0,0 +1,48 @@ +# Troubleshooting Guide + +51124 서버 운용 중 발생한 모든 이슈는 날짜 기반 마크다운 파일(`yymmdd_작성자_주제.md`)로 저장됩니다. 이 README는 340개가 넘는 문서 중 필요한 정보를 빠르게 찾을 수 있도록 돕습니다. + +## 구조와 네이밍 + +- 경로: `DOCS/troubleshooting/` +- 파일명: `YYMMDD_author_topic.md` + - 예: `250723_happybell80_Slack_3초룰.md` +- 각 문서는 **상황 → 원인 → 해결 → 교훈** 순서를 기본으로 하며, 교훈 섹션의 규칙은 `AGENTS.md`에 반영됩니다. + +## 빠르게 찾는 방법 + +1. **최근 이슈 탐색**: `ls -t | head`로 최신 10건 확인 +2. **키워드 검색**: `rg "Slack 3초" DOCS/troubleshooting` 처럼 `rg` 사용 +3. **카테고리 패턴**: + - 네트워크/인프라: `*_docker_*`, `*_nginx_*` + - 인증/보안: `*_auth_*`, `*_JWT_*` + - 스킬별: `skill-*` 접두사의 문서 + +## 필수 참조 문서 + +| 주제 | 문서 | 비고 | +|------|------|------| +| Slack 3초 룰 | `250723_happybell80_Slack_3초룰.md` | FastAPI 비동기 패턴 | +| 배포 파이프라인 | `250716_rb8001_deployment_issues.md` | Actions + docker compose | +| Storage/용량 | `250716_SSD_용량_부족_및_Docker_정리.md` | 정리 스크립트 가이드 | +| Intent 리뷰 큐 | `251116_admin_intent_review_queue_api_implementation.md` | 최신 TDD 사례 | + +## 문서 작성 시 체크리스트 + +- [ ] 문제 원인/증상 구분 +- [ ] 명령어/로그는 fenced code block 사용 +- [ ] 교훈 섹션에 재발 방지 규칙 명시 +- [ ] 관련 문서/참고 링크를 하단에 추가 + +## 자주 쓰는 명령 + +```bash +rg "교훈" DOCS/troubleshooting -n # 교훈 섹션 검색 +rg "Docker" DOCS/troubleshooting -g "*.md" # 도커 관련 문서 검색 +``` + +## 다음 단계 + +- 월별 인덱스 문서 작성 (예: `2025-07.md`) +- Slack/Email/Calendar 등 서비스별 태그 파일 정리 +- 교훈 섹션 자동 추출 스크립트 추가 (plans/ 디렉토리 예정)