Project

프로젝트 단위 통합 인덱스

여러 카테고리에 흩어져 있는 프로젝트 관련 포스트를 프로젝트 단위로 묶어 흐름에 맞게 정리한 허브. 글 파일은 도메인 카테고리(Agent·Data_Science· Experimentation·Engineering 등)에 그대로 거주하며 본 인덱스는 cross-link만 제공한다.

Project
저자

Kwangmin Kim

공개

2026년 05월 07일

1 개요

이 카테고리는 프로젝트 단위 hub이자 프로젝트 메타 글의 거주지다. 도메인 카테고리에 분산되어 있는 자매 시리즈를 프로젝트 흐름에 맞춰 한 곳에서 네비게이션할 수 있도록 cross-link를 모아 두고, 동시에 어떤 도메인에도 깔끔히 속하지 않는 프로젝트 회고·의사결정 일지·마일스톤 정리·전체 아키텍처 메타 글은 본 폴더에 둘 수 있다.

원칙은 다음과 같다.

  • 단일 도메인 기술 글은 도메인 카테고리에 둔다 — 본 폴더로 옮기지 않는다
  • 본 폴더의 글은 프로젝트 전체를 가로지르는 메타 글에 한정한다 — Project/{프로젝트명}/ 서브폴더에 둔다
  • cross-link는 모두 상대경로다 — 도메인 카테고리의 정본 위치를 가리킨다
  • 신규 프로젝트가 생기면 본 인덱스에 ## ProjectName 섹션 한 블록을 추가한다

자세한 글 위치 결정 기준은 GUIDE.md 의 “글 위치 결정 트리” 를 참조한다.

2 MINERVA Platform

사내 SW연구소 AI Agent 기반 지식 시스템 — 암묵지를 AI Agent 기반 지식 체계로 전환하는 POC.

2.1 프로젝트 정의

  • MINERVA (Multi-agent INtElligence for oRganizational knowledge VAlue)
  • 3대 과제
    1. 지식 QnA Chatbot — 데이터 표준화 원칙 RAG
    2. 데이터 표준화 도우미 Agent — Rule + ML + RAG 하이브리드
    3. 인실리코 코드 분석 Agent — AST 메타데이터 + Graph RAG + Agentic RAG 2-Layer
  • 기술 스택 — Python 3.11+, LangChain/LangGraph, Azure OpenAI, Azure AI Search, FastAPI + React

2.2 카테고리 분포 (총 약 84편)

카테고리 폴더 편수 역할
Agent 25-MINERVA/ 47 메인 시리즈 (Phase A~C-10)
Data_Science minerva-domain-classifier/ 7 과제 2 ML 서브컴포넌트
Experimentation AB_test/40~50-project-agent-* 11 A/B 실험·Thompson·프로덕션 플랫폼
Engineering DevOps/·Python/·web/·Infra/Cloud/Azure/ 18 인프라·DevOps·선수지식·Azure 의사결정
Data_Science / Essay (Essay draft) 1 분류기 갭 방어 에세이

2.3 Phase A — 선수지식

2.3.1 Python 라이브러리 토대 (Engineering)

2.3.2 Web · Fullstack 토대 (Engineering)

2.3.3 LangGraph API reference (Agent)

자세한 33편 목록은 Agent/index.qmd 의 18-LangGraph 섹션을 참조한다.

2.3.4 MINERVA 시리즈 진입 가이드 (Agent)

  1. 선수지식 가이드 — 자가 진단 + 빠른 진입(3h) + 전체 학습 경로(12h)

2.4 Phase B — 구현과 배포

2.4.1 MINERVA 메인 시리즈 (Agent)

  1. MINERVA 아키텍처 개요 — React + FastAPI + Agent 3-Layer
  2. BaseAgent 계약 패턴 — ABC + Pydantic 스키마 설계 2-1. BaseAgent 계약 v2 — LangGraph 호환 인터페이스와 v1 어댑터
  3. RAG 파이프라인 설계 — Hybrid Search + Parent-Child Chunking
  4. FastAPI 서빙 레이어 — 라우터·캐싱·warmup
  5. React 프론트엔드 — 6개 페이지와 API 클라이언트
  6. A/B 실험 프레임워크 — YAML 정의와 sticky hash 7-0. 프로덕션 배포 — Docker 멀티스테이지·uvicorn·env 우선순위·Azure 7-1. CI/CD — GitHub Actions로 PR 검증·통합 테스트·이미지 빌드·배포

2.4.2 DevOps 인프라 (Engineering)

2.4.3 Azure 인프라 의사결정 (Engineering)

2.5 Phase C-1 — 현재 상태 분석 (Agent)

8-0. 데이터 흐름 추적 — 동기 호출 한 호흡 (HTTP→Response→HTTP) 8-1. 스트리밍·관측성 — SSE·timing·JSONL 메트릭·피드백·DS Supervisor 9. 상태 관리 해부 — React 로컬 상태·localStorage·Agent 캐시·JSONL 로그 10. 에러 전파 경로 분석 — try/except 경계·무음 실패·클라이언트 노출 범위 11-0. Config 의존성 추적 — .env → RAGConfig → 실험 override 정적 전파 11-1. Config 운영 패턴 — Hot Reload·시크릿 주입·컨테이너 고정 12-0. 테스트 전략 분석 — 현재 진단·검증된 영역·보강 우선순위 12-1. 고급 테스트 패턴 — Property·Snapshot·동시성·Contract·Mutation·CI 분리

2.6 Phase C-2 — LangGraph 전환 (Agent)

  1. LangGraph 기초 — StateGraph·Node·Edge·Conditional Edge
  2. RAG Chain 분해 — _prepare() 를 7개 LangGraph 노드로
  3. State 설계 — TypedDict와 reducer 4 패턴
  4. Checkpointing과 Human-in-the-Loop — State 영속화로 중단·재개·사람 개입

Phase C-2의 결과를 묶는 BaseAgent 계약 v2는 v1과 인접 배치를 위해 Phase B의 2-1번으로 이동했다.

2.7 Phase C-3 — Agentic Mode (Agent)

  1. Tool Binding — 정적 파이프라인에서 동적 도구 선택으로
  2. ReAct 루프 — Reasoning과 Acting의 반복으로 풀어내기
  3. 멀티스텝 플래닝 — Plan-and-Execute와 자기 수정
  4. 에이전트 위임 — Supervisor가 sub_agent를 호출하는 패턴

2.8 Phase C-4 — 실험과 최적화

2.8.1 MINERVA 메인 시리즈 (Agent)

  1. A/B 테스트 심화 — 실험 설계·통계 검정·CUPED·Sequential Testing
  2. 지능형 라우팅 — Thompson Sampling·Contextual Bandit (LinUCB)
  3. 사용자 세그멘테이션 — 명시적·행동·토픽·시간 4가지 차원과 코호트 운영
  4. 개인화 전략 — 콘텐츠·표현·범위 3축과 Override 우선순위
  5. 실험 파이프라인 자동화 — 가설→실험→분석→배포 9단계 루프

2.8.2 A/B 실험 자매 시리즈 (Experimentation)

2.8.3 도메인 분류기 자매 시리즈 (Data_Science) — 과제 2 ML 서브컴포넌트

2.9 Phase C-5 — 발화 데이터 분석 (Agent)

  1. 대화 로깅 설계 — raw·structured·feature 3계층 + hot·warm·cold 저장
  2. 의도 분류와 토픽 클러스터링 — supervised vs unsupervised 두 흐름의 보완
  3. 응답 품질 자동 평가 — Explicit·Implicit·Heuristic·LLM-as-Judge 4계층 융합
  4. 피드백 루프 — 약점 탐지·가설·처치·학습 닫힌 루프

2.10 Phase C-6 — 하네싱 시스템 (Agent)

  1. 하네싱 아키텍처 — Supervisor·Guard Rail·Resource Quota 3대 컴포넌트
  2. 실행 제어 — Timeout·Retry·Circuit Breaker·Bulkhead·Kill Switch 5대 패턴
  3. 에이전트 생명주기 — draft·canary·staged·active·deprecated·retired 6단계 게이트

2.11 Phase C-7 — 스킬 생태계 (Agent)

  1. 스킬 정의 — 4 컴포넌트와 SKILL.md 표준
  2. 스킬 레지스트리 — 등록·검색·버전 resolve·의존성 그래프·CI/CD 통합
  3. 스킬 조합과 동적 선택 — Composition 4패턴 + Router 4패턴
  4. 스킬 테스트와 품질 게이트 — 5계층 테스트 + lifecycle 게이트

2.12 Phase C-8 — 지식 기반 관리 (Agent)

  1. 지식 문서 생명주기 — 6단계 + delta indexing
  2. 청킹 전략 고도화 — 5축 + 문서 유형별 패턴 + Parent-Child·Hypothetical query
  3. 지식 품질 모니터링 — 5종 신호 + 자동 재인덱싱

2.13 Phase C-9 — 관측성과 비용 (Agent)

  1. 관측성 설계 — OpenTelemetry 3 pillar + LLM 특화 신호 + SLO·burn rate
  2. 비용 최적화 — 5축 분해 + 6가지 기법
  3. 보안과 접근 제어 — 5계층 + LLM 특화 4 위협

2.14 Phase C-10 — 플랫폼 스케일링 (Agent)

  1. 개발 조직 설계 — Conway’s Law + Team Topologies + MINERVA 4팀
  2. 운영 인프라 — SRE 5축 + Chaos Engineering + 24/7 on-call
  3. 바이브 코딩에서 설계 기반 개발로 — 시리즈 finale

2.15 Essay (Data_Science / Essay)

3 신규 프로젝트 hub 추가

새 프로젝트 hub가 필요해지면 본 인덱스에 ## ProjectName 섹션 한 블록을 추가하고, 동일 패턴(프로젝트 정의 → 카테고리 분포 표 → 흐름 단위 cross-link)으로 채운다. 도메인 카테고리의 글 위치와 인덱스는 변경하지 않는다.

프로젝트 단위 메타 글(회고·결정 일지·마일스톤 등)을 작성하는 절차는 GUIDE.md 의 “프로젝트 단위 글 작성 절차” 를 참조한다.

Subscribe

Enjoy this blog? Get notified of new posts by email: