Skip to content

chore: deprecated 잔재 정리 + SSOT(PROJECT.md) + ARCHITECTURE.md#232

Merged
seyoung4503 merged 3 commits into
masterfrom
chore/cleanup-deprecated
May 30, 2026
Merged

chore: deprecated 잔재 정리 + SSOT(PROJECT.md) + ARCHITECTURE.md#232
seyoung4503 merged 3 commits into
masterfrom
chore/cleanup-deprecated

Conversation

@seyoung4503
Copy link
Copy Markdown
Collaborator

무엇

v4.1 rebuild 머지(#227~#230) 이후 master에 잔존하던 옛 v0.3 era 파일들을 일괄 정리하고, 프로젝트 단일 SSOT(docs/PROJECT.md)와 기여자용 한눈 가이드(docs/ARCHITECTURE.md)를 추가.

PR #231(ARCHITECTURE.md만)을 이 PR이 흡수하므로 #231은 닫을 예정.

v4.1로 방향이 완전히 바뀌었는데 master에 옛 LangGraph/Streamlit 시절 잔재가 그대로 있어 신규 컨트리뷰터 혼란. 한 번에 정리.

삭제

분류 항목
빌드 잔재 poetry.lock (uv 이전), pgvector.sh, guideline.md (옛 LangGraph 아키텍처 설명)
옛 인프라 docker/ 전체 (Streamlit Dockerfile + vector compose), scripts/ 전체 (v2 quickstart)
옛 vector 작업 dev/create_faiss.py, dev/create_pgvector.py
옛 아키텍처 docs BaseComponent_ko/BaseFlow_ko/Core_concept_ko/Hook_and_exception_ko.md, production_test_guide.md
옛 RAG 튜토리얼 docs/tutorials/01~05*.md
중간 초안 discord_first_redesign{,_v2,_v3_minimal,_v4}.md (v4_1/v4_2 final 유지)

추가

  • docs/PROJECT.md — 프로젝트 SSOT (정체성/문제/4기둥/현황/로드맵/빠른 시작/설계 결정/변천)
  • docs/ARCHITECTURE.md — 기여자용 한눈 가이드 (디렉토리·레이어 책임, 한 메시지 lifecycle, extension points, 코드 컨벤션)
  • README: SSOT/ARCHITECTURE 링크 prominent하게 위쪽 배치

유지

  • .pre-commit-config.yaml (black formatting)
  • docs/DEPLOY.md (v4.1 Discord 배포)
  • docs/discord_first_redesign_v4_1.md, v4_2.md (final 설계)
  • docs/pull_request_guidelines.md, branch_guidelines.md (프로세스)

확인

  • 삭제 파일 참조 잔존 0건 (README/PROJECT/ARCHITECTURE에 링크 깨짐 없음)
  • 정리 후 master는 v4.1 코드 + 핵심 문서 7개만 남음

🤖 Generated with Claude Code

삭제:
- poetry.lock (uv로 이전), pgvector.sh, guideline.md (옛 LangGraph 아키텍처)
- docker/ (Streamlit Dockerfile + vector compose), scripts/ (v2 quickstart)
- dev/create_faiss.py, dev/create_pgvector.py (옛 vector retrieval)
- docs/Base{Component,Flow}_ko.md, Core_concept_ko.md, Hook_and_exception_ko.md
- docs/production_test_guide.md
- docs/tutorials/01~05*.md (옛 RAG 튜토리얼)
- docs/discord_first_redesign{,_v2,_v3_minimal,_v4}.md (중간 초안, v4_1/v4_2 final 유지)

추가:
- docs/PROJECT.md — 프로젝트 단일 SSOT 문서
  (정체성 / 문제 / 4기둥 / 현황 / 로드맵 / 빠른 시작 /
   아키텍처 포인터 / 핵심 설계 결정 / 변천)

유지: .pre-commit-config.yaml, DEPLOY.md, v4_1/v4_2 final design docs,
process guidelines (PR/branch)

🤖 Generated with [Claude Code](https://claude.com/claude-code)
처음 보는 사람도 10분 안에 "어디 무엇이 있고 / 어디를 손대면 좋은지"
파악할 수 있는 단일 문서.

내용:
- 한 눈에 보는 아키텍처 (ASCII 다이어그램)
- 왜 이 구조인가 — 4기둥 매핑
- 디렉토리·레이어 가이드 (파일 경로 링크 다수)
- 한 메시지의 lifecycle (Discord 멘션 따라가기)
- Extension points — 새 LLM/DB/safety layer/recall/frontend/도구 추가법
- 빠른 기여 시작 + 코드 컨벤션

README의 "기여하기" 섹션에서 ARCHITECTURE.md를 가장 먼저 보도록 안내.

🤖 Generated with [Claude Code](https://claude.com/claude-code)
@seyoung4503 seyoung4503 merged commit c9c8304 into master May 30, 2026
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant