agestra 4.7.0 → 4.8.0

package/README.ko.md

@@ -1,14 +1,14 @@
-# Agestra
-
-[![npm version](https://img.shields.io/npm/v/agestra.svg)](https://www.npmjs.com/package/agestra)
-[![license](https://img.shields.io/npm/l/agestra.svg)](LICENSE)
-
+# Agestra
+
+[![npm version](https://img.shields.io/npm/v/agestra.svg)](https://www.npmjs.com/package/agestra)
+[![license](https://img.shields.io/npm/l/agestra.svg)](LICENSE)
+
 **Agent + Orchestra** — Claude Code, Codex CLI, Gemini CLI에서 공통으로 쓰는 멀티 호스트 오케스트레이션 툴킷.
-
+
 [English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [中文](README.zh.md)
-
-Agestra는 Claude 호스트, Ollama(로컬), Gemini CLI, Codex CLI를 플러그형 공급자로 연결합니다. 독립 취합, 합의 토론, 자율 CLI 워커, 병렬 작업 분배, 교차 검증, 품질 기반 공급자 라우팅, 지속적 GraphRAG 메모리 시스템을 31개 MCP 도구로 제공합니다.
-
+
+Agestra는 Claude 호스트, Ollama(로컬), Gemini CLI, Codex CLI를 플러그형 공급자로 연결합니다. 독립 취합, 합의 토론, 자율 CLI 워커, 병렬 작업 분배, 교차 검증, 품질 기반 공급자 라우팅을 25개 MCP 도구로 제공합니다.
+
 ## 빠른 시작
 
 ### Claude Code
@@ -74,17 +74,17 @@ Gemini는 저장소 루트의 [GEMINI.md](GEMINI.md)와 [`.gemini/commands/agest
 - `/agestra:design`
 - `/agestra:idea`
 - `/agestra:implement`
-
-### 사전 요구사항
-
-최소 하나의 AI 공급자가 설치되어야 합니다:
-
-| 공급자 | 설치 | 유형 |
-|--------|------|------|
-| [Ollama](https://ollama.com/) | `curl -fsSL https://ollama.com/install.sh \| sh` | 로컬 LLM |
-| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `npm install -g @google/gemini-cli` | 클라우드 |
-| [Codex CLI](https://github.com/openai/codex) | `npm install -g @openai/codex` | 클라우드 |
-
+
+### 사전 요구사항
+
+최소 하나의 AI 공급자가 설치되어야 합니다:
+
+| 공급자 | 설치 | 유형 |
+|--------|------|------|
+| [Ollama](https://ollama.com/) | `curl -fsSL https://ollama.com/install.sh \| sh` | 로컬 LLM |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `npm install -g @google/gemini-cli` | 클라우드 |
+| [Codex CLI](https://github.com/openai/codex) | `npm install -g @openai/codex` | 클라우드 |
+
 선택 사항이지만 권장:
 - **tmux** — 자율 실행 중 CLI 워커 패인을 시각적으로 확인 가능
 - **Windows의 ripgrep (`rg`)** — Codex가 Store 앱 번들 경로의 `rg`를 잡아서 `Access is denied` 오류가 나면, 별도 ripgrep를 설치해 정상 `rg.exe`가 `PATH`에서 먼저 잡히게 하세요:
@@ -100,11 +100,11 @@ winget install BurntSushi.ripgrep.MSVC
 ```
 
 ---
-
-## 철학
-
-**멀티 AI는 검증을 위한 것이지, 토큰 절약을 위한 것이 아닙니다.** 리뷰, 설계 탐색, 아이디어 발굴 워크플로우는 검증 프로세스로 설계되었습니다 — 속도를 위한 병렬화가 아니라, 사각지대를 잡기 위해 여러 AI 공급자로부터 독립적인 의견을 얻는 것입니다.
-
+
+## 철학
+
+**멀티 AI는 검증을 위한 것이지, 토큰 절약을 위한 것이 아닙니다.** 리뷰, 설계 탐색, 아이디어 발굴 워크플로우는 검증 프로세스로 설계되었습니다 — 속도를 위한 병렬화가 아니라, 사각지대를 잡기 위해 여러 AI 공급자로부터 독립적인 의견을 얻는 것입니다.
+
 ## 호스트별 진입 방식
 
 | 호스트 | 자연스러운 진입 방식 |
@@ -116,127 +116,121 @@ winget install BurntSushi.ripgrep.MSVC
 세 호스트 모두 같은 MCP 서버와 `commands/*.md` 공유 워크플로우를 사용합니다.
 
 ## 커맨드
-
-| 커맨드 | 설명 |
-|--------|------|
+
+| 커맨드 | 설명 |
+|--------|------|
 | `/agestra review [대상]` | 코드 품질, 보안, 통합 완성도 검증 |
 | `/agestra idea [주제]` | 유사 프로젝트 비교를 통한 개선점 발굴 |
 | `/agestra design [주제]` | 구현 전 아키텍처 및 설계 트레이드오프 탐색 |
+| `/agestra setup` | 초기 AI 공급자 선택 및 설정 |
 | `/agestra implement [작업]` | Claude only 또는 Multi-AI 모드로 실제 구현 진행 |
-
-각 커맨드는 선택지를 제시합니다:
-
-| 모드 | 설명 |
-|------|------|
-| **Claude only** | 플러그인 전문 에이전트가 단독 작업 |
-| **각자 독립** | 각 AI가 독립 작업 후 진행자가 취합하여 통합 문서 작성 |
-| **끝장토론** | 각자 독립 + 문서를 돌아가며 분석/피드백, 모든 AI가 동의할 때까지 |
-
-## 에이전트
-
-| 에이전트 | 모델 | 역할 |
-|----------|------|------|
-| `agestra-team-lead` | Sonnet | 풀 오케스트레이터 — 환경 체크, 품질 기반 공급자 라우팅, 작업 모드 선택, CLI 워커 감독, QA 루프 |
-| `agestra-reviewer` | Opus | 엄격한 품질 검증 — 보안, 고아 시스템, 스펙 이탈, 테스트 공백 |
-| `agestra-designer` | Opus | 아키텍처 탐색 — 소크라테스식 질문, 트레이드오프 분석 |
-| `agestra-ideator` | Sonnet | 개선점 발굴 — 웹 리서치, 경쟁 분석 |
-| `agestra-moderator` | Sonnet | 다목적 진행자 — 합의 검출 토론, 독립 취합, 문서 라운드 리뷰, 충돌 해결 |
-| `agestra-qa` | Opus | QA 검증 — 설계 준수, PASS/FAIL 판정 |
-
-## 스킬
-
-| 스킬 | 설명 |
-|------|------|
-| `provider-guide` | 공급자 라우팅, 모드 참조, 오케스트레이션 파이프라인 |
-| `worker-manage` | CLI 워커 목록, 상태 확인, 결과 수집, 중지 |
-| `cancel` | 워커, 토론, 체인, 작업의 정상 종료 |
-| `build-fix` | 빌드/타입체크/린트 에러 자동 진단 및 수정 |
-| `trace` | 에이전트 실행 타임라인 및 흐름 다이어그램 조회 |
-| `design` | 멀티 AI 모드 선택이 포함된 아키텍처 탐색 워크플로우 |
-| `idea` | 멀티 AI 모드 선택이 포함된 개선점 발굴 워크플로우 |
-
----
-
-## 아키텍처
-
-Turborepo 모노레포, 9개 패키지:
-
-| 패키지 | 설명 |
-|--------|------|
-| `@agestra/core` | `AIProvider` 인터페이스, 난이도 기반 라우팅 레지스트리, 설정 로더, CLI 러너, 원자적 쓰기, 작업 큐, 시크릿 스캐너, 워크트리 관리자, 태스크 매니페스트, CLI 워커 관리자 |
-| `@agestra/provider-ollama` | Ollama HTTP 어댑터 (모델 자동 감지) |
-| `@agestra/provider-gemini` | Google Gemini CLI 어댑터 |
-| `@agestra/provider-codex` | OpenAI Codex CLI 어댑터 |
-| `@agestra/agents` | 합의 검출 토론 엔진, 턴 품질 평가기, 작업 분배기, 교차 검증기, 작업 체인, 자동 QA, 파일 변경 추적기, 세션 관리자 |
+
+외부 공급자가 있으면 텍스트 커맨드(review, design, idea)는 곧바로 끝장토론 모드로 진입하여 멀티 AI 교차 검증을 수행합니다. 공급자가 없으면 자동으로 Claude 단독 모드로 작동합니다.
+
+## 에이전트
+
+| 에이전트 | 모델 | 역할 |
+|----------|------|------|
+| `agestra-team-lead` | Sonnet | 풀 오케스트레이터 — 환경 체크, 품질 기반 공급자 라우팅, 작업 모드 선택, CLI 워커 감독, QA 루프 |
+| `agestra-reviewer` | Opus | 엄격한 품질 검증 — 보안, 고아 시스템, 스펙 이탈, 테스트 공백 |
+| `agestra-designer` | Opus | 아키텍처 탐색 — 소크라테스식 질문, 트레이드오프 분석 |
+| `agestra-ideator` | Sonnet | 개선점 발굴 — 웹 리서치, 경쟁 분석 |
+| `agestra-moderator` | Sonnet | 다목적 진행자 — 합의 검출 토론, 독립 취합, 문서 라운드 리뷰, 충돌 해결 |
+| `agestra-qa` | Opus | QA 검증 — 설계 준수, PASS/FAIL 판정 |
+
+## 스킬
+
+| 스킬 | 설명 |
+|------|------|
+| `provider-guide` | 공급자 라우팅, 모드 참조, 오케스트레이션 파이프라인 |
+| `worker-manage` | CLI 워커 목록, 상태 확인, 결과 수집, 중지 |
+| `cancel` | 워커, 토론, 체인, 작업의 정상 종료 |
+| `build-fix` | 빌드/타입체크/린트 에러 자동 진단 및 수정 |
+| `trace` | 에이전트 실행 타임라인 및 흐름 다이어그램 조회 |
+| `design` | 멀티 AI 모드 선택이 포함된 아키텍처 탐색 워크플로우 |
+| `idea` | 멀티 AI 모드 선택이 포함된 개선점 발굴 워크플로우 |
+
+---
+
+## 아키텍처
+
+Turborepo 모노레포, 9개 패키지:
+
+| 패키지 | 설명 |
+|--------|------|
+| `@agestra/core` | `AIProvider` 인터페이스, 난이도 기반 라우팅 레지스트리, 설정 로더, CLI 러너, 원자적 쓰기, 작업 큐, 시크릿 스캐너, 워크트리 관리자, 태스크 매니페스트, CLI 워커 관리자 |
+| `@agestra/provider-ollama` | Ollama HTTP 어댑터 (모델 자동 감지) |
+| `@agestra/provider-gemini` | Google Gemini CLI 어댑터 |
+| `@agestra/provider-codex` | OpenAI Codex CLI 어댑터 |
+| `@agestra/agents` | 합의 검출 토론 엔진, 턴 품질 평가기, 작업 분배기, 교차 검증기, 작업 체인, 자동 QA, 파일 변경 추적기, 세션 관리자 |
 | `@agestra/workspace` | 리뷰, 분석 메모, 통합 보고서를 위한 워크스페이스 문서 관리자 |
-| `@agestra/memory` | GraphRAG — FTS5 + 벡터 + 지식 그래프 하이브리드 검색, 실패 추적 |
-| `@agestra/mcp-server` | MCP 프로토콜 레이어, 31개 도구, 환경별 도구 필터링, 디스패치 |
-
-### 설계 원칙
-
+| `@agestra/mcp-server` | MCP 프로토콜 레이어, 25개 도구, 환경별 도구 필터링, 디스패치 |
+
+### 설계 원칙
+
 - **공급자 추상화** — 모든 백엔드가 `AIProvider`(`chat`, `healthCheck`, `getCapabilities`)를 구현. 새 공급자 추가는 전용 패키지 구현과 팩토리 등록으로 분리됩니다.
-- **제로 설정** — 시작 시 공급자를 자동 감지. 수동 설정 불필요.
+- **제로 설정** — 시작 시 공급자를 자동 감지. 수동 설정 불필요.
 - **호스트 네이티브** — Claude는 플러그인 번들을, Codex는 `AGENTS.md`를, Gemini는 `GEMINI.md`와 프로젝트 커맨드를 사용하지만 내부 MCP 서버와 워크플로우 코어는 공통으로 공유합니다.
-- **모듈형 디스패치** — 각 도구 카테고리가 `getTools()` + `handleTool()`을 내보내는 독립 모듈. 서버가 동적으로 수집·디스패치.
-- **원자적 쓰기** — 모든 파일 연산이 임시 파일 → rename 방식. 크래시 시 손상 방지.
-- **실패 추적** — 실패한 접근법이 GraphRAG에 자동 기록, 이후 프롬프트에 주입.
-- **사전 보안 검증** — CLI 워커 스폰 시 시크릿 스캔 + 배열 기반 프로세스 인자로 인젝션 방지.
-
-### 작업 모드
-
-**텍스트 작업** (리뷰, 설계, 아이디어): Claude only → 각자 독립 → 끝장토론
-
-**구현 작업** (team-lead 오케스트레이션):
-- **Claude만으로** — Claude가 프로젝트/전역 에이전트를 활용해 직접 구현.
-- **다른 AI도 함께** — CLI 워커(Codex/Gemini)가 격리된 git worktree에서 자율 코딩, Ollama가 단순 작업 처리, Claude가 감독 및 병합.
-
----
-
-## 도구 (31개)
-
-### AI 채팅 (3개)
-
-| 도구 | 설명 |
-|------|------|
+- **모듈형 디스패치** — 각 도구 카테고리가 `getTools()` + `handleTool()`을 내보내는 독립 모듈. 서버가 동적으로 수집·디스패치.
+- **원자적 쓰기** — 모든 파일 연산이 임시 파일 → rename 방식. 크래시 시 손상 방지.
+- **실패 추적** — 실패한 접근법이 자동 기록, 이후 프롬프트에 주입.
+- **사전 보안 검증** — CLI 워커 스폰 시 시크릿 스캔 + 배열 기반 프로세스 인자로 인젝션 방지.
+
+### 작업 모드
+
+**텍스트 작업** (리뷰, 설계, 아이디어): 공급자 있으면 → 끝장토론; 없으면 → Claude only
+
+**구현 작업** (team-lead 오케스트레이션):
+- **Claude만으로** — Claude가 프로젝트/전역 에이전트를 활용해 직접 구현.
+- **다른 AI도 함께** — CLI 워커(Codex/Gemini)가 격리된 git worktree에서 자율 코딩, Ollama가 단순 작업 처리, Claude가 감독 및 병합.
+
+---
+
+## 도구 (25개)
+
+### AI 채팅 (3개)
+
+| 도구 | 설명 |
+|------|------|
 | `ai_chat` | 특정 공급자와 채팅 (품질 기반 자동 라우팅: `"auto"`); 필요하면 `save_as_document`로 응답을 문서로 저장 |
-| `ai_analyze_files` | 파일을 디스크에서 읽어 공급자에게 질문과 함께 전송 |
-| `ai_compare` | 같은 프롬프트를 여러 공급자에 보내 응답 비교 |
-
-### 에이전트 오케스트레이션 (0개)
-
-| 도구 | 설명 |
-|------|------|
-| `agent_debate_start` | 다중 공급자 토론 시작 (논블로킹, 품질 루프 + 검증자 옵션) |
-| `agent_debate_status` | 토론 상태 및 트랜스크립트 확인 |
-| `agent_debate_create` | 턴 기반 토론 세션 생성 (토론 ID 반환) |
-| `agent_debate_turn` | 공급자 1턴 실행; `provider: "claude"`로 Claude 독립 참여 지원 |
-| `agent_debate_conclude` | 토론 종료 및 최종 트랜스크립트 생성 |
+| `ai_analyze_files` | 파일을 디스크에서 읽어 공급자에게 질문과 함께 전송 |
+| `ai_compare` | 같은 프롬프트를 여러 공급자에 보내 응답 비교 |
+
+### 에이전트 오케스트레이션 (0개)
+
+| 도구 | 설명 |
+|------|------|
+| `agent_debate_start` | 다중 공급자 토론 시작 (논블로킹, 품질 루프 + 검증자 옵션) |
+| `agent_debate_status` | 토론 상태 및 트랜스크립트 확인 |
+| `agent_debate_create` | 턴 기반 토론 세션 생성 (토론 ID 반환) |
+| `agent_debate_turn` | 공급자 1턴 실행; `provider: "claude"`로 Claude 독립 참여 지원 |
+| `agent_debate_conclude` | 토론 종료 및 최종 트랜스크립트 생성 |
 | `agent_debate_moderate` | 완전 자동화 토론 — 세션 생성, provider 라운드 실행, Specialist 선택 기록, 가능할 때 Claude host-backed 턴에 반영, 합의 검출, 요약만 반환 |
-| `agent_debate_review` | 문서를 여러 공급자에게 독립적으로 리뷰 요청 |
-| `agent_cross_validate` | 출력 교차 검증 (에이전트 등급 검증자만 가능) |
-| `agent_changes_review` | 격리된 작업의 파일 변경 리뷰 |
-| `agent_changes_accept` | 격리된 작업의 변경 수락 및 병합 |
-| `agent_changes_reject` | 변경 거부 및 격리 워크트리 정리 |
-
-### CLI 워커 (4개)
-
-| 도구 | 설명 |
-|------|------|
-| `cli_worker_spawn` | CLI AI(Codex/Gemini)를 자율 모드로 스폰 — git worktree 격리 + 사전 보안 검증 |
-| `cli_worker_status` | 워커 FSM 상태, 하트비트, 출력 미리보기 확인 |
-| `cli_worker_collect` | 완료된 워커 결과 수집 (git diff, 출력, 종료 코드) |
-| `cli_worker_stop` | 실행 중인 워커 중지 (SIGTERM → SIGKILL) + 워크트리 정리 |
-
-### 환경 (1개)
-
-| 도구 | 설명 |
-|------|------|
-| `environment_check` | CLI 도구, Ollama 모델 티어, tmux, git worktree 지원 여부, 사용 가능 모드 탐지 |
-
+| `agent_debate_review` | 문서를 여러 공급자에게 독립적으로 리뷰 요청 |
+| `agent_cross_validate` | 출력 교차 검증 (에이전트 등급 검증자만 가능) |
+| `agent_changes_review` | 격리된 작업의 파일 변경 리뷰 |
+| `agent_changes_accept` | 격리된 작업의 변경 수락 및 병합 |
+| `agent_changes_reject` | 변경 거부 및 격리 워크트리 정리 |
+
+### CLI 워커 (4개)
+
+| 도구 | 설명 |
+|------|------|
+| `cli_worker_spawn` | CLI AI(Codex/Gemini)를 자율 모드로 스폰 — git worktree 격리 + 사전 보안 검증 |
+| `cli_worker_status` | 워커 FSM 상태, 하트비트, 출력 미리보기 확인 |
+| `cli_worker_collect` | 완료된 워커 결과 수집 (git diff, 출력, 종료 코드) |
+| `cli_worker_stop` | 실행 중인 워커 중지 (SIGTERM → SIGKILL) + 워크트리 정리 |
+
+### 환경 (1개)
+
+| 도구 | 설명 |
+|------|------|
+| `environment_check` | CLI 도구, Ollama 모델 티어, tmux, git worktree 지원 여부, 사용 가능 모드 탐지 |
+
 ### 워크스페이스 (7개)
-
-| 도구 | 설명 |
-|------|------|
+
+| 도구 | 설명 |
+|------|------|
 | `workspace_create_review` | 파일과 규칙이 포함된 코드 리뷰 문서 생성 |
 | `workspace_request_review` | 공급자에게 문서 리뷰 요청 |
 | `workspace_review_status` | 리뷰 완료 상태 확인 |
@@ -244,36 +238,25 @@ Turborepo 모노레포, 9개 패키지:
 | `workspace_create_document` | 제목, 마크다운 본문, 선택 메타데이터를 가진 범용 워크스페이스 문서 생성 |
 | `workspace_read` | 문서 내용 읽기 |
 | `workspace_list` | 워크스페이스의 모든 문서 목록 조회 |
-
-### 공급자 관리 (2개)
-
-| 도구 | 설명 |
-|------|------|
-| `provider_list` | 공급자 목록 (상태, 능력 포함) |
-| `provider_health` | 공급자 상태 체크 |
-
-### Ollama (2개)
-
-| 도구 | 설명 |
-|------|------|
-| `ollama_models` | 설치된 모델 및 크기, 티어 분류 목록 |
-| `ollama_pull` | 모델 다운로드 |
-
-### 메모리 (6개)
-
-| 도구 | 설명 |
-|------|------|
-| `memory_search` | 하이브리드 검색 (FTS5 + 벡터 + 그래프) |
-| `memory_index` | 파일/디렉토리를 메모리에 인덱싱 |
-| `memory_store` | 지식 노드 저장 (fact, decision, dead_end, finding) |
-| `memory_dead_ends` | 이전 실패 접근법 검색 (반복 방지) |
-| `memory_context` | 토큰 예산 내 관련 컨텍스트 조립 |
-| `memory_add_edge` | 지식 노드 간 관계 엣지 생성 |
-
-### 작업 (2개)
-
-| 도구 | 설명 |
-|------|------|
+
+### 공급자 관리 (2개)
+
+| 도구 | 설명 |
+|------|------|
+| `provider_list` | 공급자 목록 (상태, 능력 포함) |
+| `provider_health` | 공급자 상태 체크 |
+
+### Ollama (2개)
+
+| 도구 | 설명 |
+|------|------|
+| `ollama_models` | 설치된 모델 및 크기, 티어 분류 목록 |
+| `ollama_pull` | 모델 다운로드 |
+
+### 작업 (2개)
+
+| 도구 | 설명 |
+|------|------|
 | `cli_job_submit` | 장시간 CLI 작업을 백그라운드에 제출 |
 | `cli_job_status` | 작업 상태 확인 및 출력 조회 |
 
@@ -282,62 +265,61 @@ Turborepo 모노레포, 9개 패키지:
 | 도구 | 설명 |
 |------|------|
 | `qa_run` | 자동 QA 실행: 빌드/테스트 감지 및 PASS/FAIL 요약 |
-
-### 추적 / 관측성 (3개)
-
-| 도구 | 설명 |
-|------|------|
-| `trace_query` | 조건별 추적 레코드 조회 (공급자, 작업, 기간) |
-| `trace_summary` | 공급자별 품질 통계, 성능 지표, 난이도 자격 확인 |
-| `trace_visualize` | 추적된 작업 흐름의 Mermaid 다이어그램 생성 |
-
----
-
-## 설정
-
-### providers.config.json (선택)
-
-Agestra는 시작 시 공급자를 자동 감지합니다. 수동 제어가 필요하면 프로젝트 루트에 `providers.config.json`을 생성하세요:
-
-| 필드 | 설명 |
-|------|------|
-| `defaultProvider` | 미지정 시 사용할 공급자 ID |
-| `providers[].id` | 고유 식별자 |
-| `providers[].type` | `ollama`, `gemini-cli`, `codex-cli` |
-| `providers[].enabled` | 시작 시 로드 여부 |
-| `providers[].config` | 타입별 설정 (host, timeout 등) |
-
-### 런타임 데이터
-
-`.agestra/` 아래 저장 (gitignore 대상):
-
-| 경로 | 용도 |
-|------|------|
-| `.agestra/sessions/` | 토론 및 작업 세션 상태 |
+
+### 추적 / 관측성 (3개)
+
+| 도구 | 설명 |
+|------|------|
+| `trace_query` | 조건별 추적 레코드 조회 (공급자, 작업, 기간) |
+| `trace_summary` | 공급자별 품질 통계, 성능 지표, 난이도 자격 확인 |
+| `trace_visualize` | 추적된 작업 흐름의 Mermaid 다이어그램 생성 |
+
+---
+
+## 설정
+
+### providers.config.json (선택)
+
+Agestra는 시작 시 공급자를 자동 감지합니다. 수동 제어가 필요하면 프로젝트 루트에 `providers.config.json`을 생성하세요:
+
+| 필드 | 설명 |
+|------|------|
+| `defaultProvider` | 미지정 시 사용할 공급자 ID |
+| `providers[].id` | 고유 식별자 |
+| `providers[].type` | `ollama`, `gemini-cli`, `codex-cli` |
+| `providers[].enabled` | 시작 시 로드 여부 |
+| `providers[].config` | 타입별 설정 (host, timeout 등) |
+
+### 런타임 데이터
+
+`.agestra/` 아래 저장 (gitignore 대상):
+
+| 경로 | 용도 |
+|------|------|
+| `.agestra/sessions/` | 토론 및 작업 세션 상태 |
 | `.agestra/workspace/` | 워크스페이스 문서 (리뷰, 메모, 보고서) |
-| `.agestra/memory.db` | GraphRAG SQLite 데이터베이스 |
-| `.agestra/.jobs/` | 백그라운드 작업 큐 |
-| `.agestra/.workers/` | CLI 워커 상태, 매니페스트, 출력 로그 |
-| `.agestra/worktrees/` | CLI 워커 격리 실행용 git worktree |
-| `.agestra/traces/` | 공급자 추적 JSONL (30일 후 자동 정리) |
-
----
-
-## 개발
-
-```bash
-npm install        # 의존성 설치
-npm run build      # 전체 빌드 (Turborepo)
-npm test           # 전체 테스트 (Vitest)
-npm run bundle     # 단일 파일 플러그인 번들 (esbuild)
-npm run dev        # 워치 모드
-npm run lint       # 린트 (ESLint)
-npm run clean      # dist/ 삭제
-```
-
-### 프로젝트 구조
-
-```
+| `.agestra/.jobs/` | 백그라운드 작업 큐 |
+| `.agestra/.workers/` | CLI 워커 상태, 매니페스트, 출력 로그 |
+| `.agestra/worktrees/` | CLI 워커 격리 실행용 git worktree |
+| `.agestra/traces/` | 공급자 추적 JSONL (30일 후 자동 정리) |
+
+---
+
+## 개발
+
+```bash
+npm install        # 의존성 설치
+npm run build      # 전체 빌드 (Turborepo)
+npm test           # 전체 테스트 (Vitest)
+npm run bundle     # 단일 파일 플러그인 번들 (esbuild)
+npm run dev        # 워치 모드
+npm run lint       # 린트 (ESLint)
+npm run clean      # dist/ 삭제
+```
+
+### 프로젝트 구조
+
+```
 agestra/
 ├── AGENTS.md               # Codex 호스트용 지침
 ├── GEMINI.md               # Gemini 호스트용 지침
@@ -356,48 +338,47 @@ agestra/
 │   ├── idea.md              # /agestra idea — 개선점 발굴
 │   ├── design.md            # /agestra design — 아키텍처 탐색
 │   └── implement.md         # /agestra implement — 실제 구현 진행
-├── agents/
-│   ├── agestra-reviewer.md  # 엄격한 품질 검증자 (Opus)
-│   ├── agestra-designer.md  # 아키텍처 탐색자 (Opus)
-│   ├── agestra-ideator.md   # 개선점 발굴자 (Sonnet)
-│   ├── agestra-moderator.md # 다목적 진행자 (Sonnet)
-│   ├── agestra-qa.md        # QA 검증자 (Opus, 코드 쓰기 불가)
-│   └── agestra-team-lead.md # 풀 오케스트레이터 (Sonnet, 코드 쓰기 불가)
-├── skills/
-│   ├── provider-guide.md    # 공급자 라우팅 및 모드 참조
-│   ├── worker-manage.md     # CLI 워커 관리
-│   ├── cancel.md            # 정상 작업 취소
-│   ├── build-fix.md         # 빌드 에러 자동 수정
-│   └── trace.md             # 실행 타임라인 조회
-├── hooks/
-│   └── user-prompt-submit.md  # 도구 추천 hook
-├── dist/
-│   └── bundle.js            # 단일 파일 MCP 서버 번들
+├── agents/
+│   ├── agestra-reviewer.md  # 엄격한 품질 검증자 (Opus)
+│   ├── agestra-designer.md  # 아키텍처 탐색자 (Opus)
+│   ├── agestra-ideator.md   # 개선점 발굴자 (Sonnet)
+│   ├── agestra-moderator.md # 다목적 진행자 (Sonnet)
+│   ├── agestra-qa.md        # QA 검증자 (Opus, 코드 쓰기 불가)
+│   └── agestra-team-lead.md # 풀 오케스트레이터 (Sonnet, 코드 쓰기 불가)
+├── skills/
+│   ├── provider-guide.md    # 공급자 라우팅 및 모드 참조
+│   ├── worker-manage.md     # CLI 워커 관리
+│   ├── cancel.md            # 정상 작업 취소
+│   ├── build-fix.md         # 빌드 에러 자동 수정
+│   └── trace.md             # 실행 타임라인 조회
+├── hooks/
+│   └── user-prompt-submit.md  # 도구 추천 hook
+├── dist/
+│   └── bundle.js            # 단일 파일 MCP 서버 번들
 ├── scripts/
 │   ├── bundle.mjs           # esbuild 번들 스크립트
 │   ├── install-host-mcp.mjs # Codex/Gemini에 Agestra 등록
 │   └── uninstall-host-mcp.mjs # Codex/Gemini에서 Agestra 제거
 ├── packages/
-│   ├── core/                # AIProvider 인터페이스, 레지스트리, 보안, 워커
-│   ├── provider-ollama/     # Ollama HTTP 어댑터
-│   ├── provider-gemini/     # Gemini CLI 어댑터
-│   ├── provider-codex/      # Codex CLI 어댑터
-│   ├── agents/              # 토론 엔진, 분배기, 교차 검증기
+│   ├── core/                # AIProvider 인터페이스, 레지스트리, 보안, 워커
+│   ├── provider-ollama/     # Ollama HTTP 어댑터
+│   ├── provider-gemini/     # Gemini CLI 어댑터
+│   ├── provider-codex/      # Codex CLI 어댑터
+│   ├── agents/              # 토론 엔진, 분배기, 교차 검증기
 │   ├── workspace/           # 워크스페이스 문서 관리자
-│   ├── memory/              # GraphRAG: 하이브리드 검색, 실패 추적
-│   └── mcp-server/          # MCP 서버, 31개 도구, 환경별 필터링, 디스패치
-├── package.json             # 워크스페이스 루트
-└── turbo.json               # Turborepo 파이프라인
-```
-
-### 새 공급자 추가
-
-1. `packages/provider-<이름>/`에 `AIProvider` 구현.
-2. `packages/mcp-server/src/index.ts`에 팩토리 추가.
-3. `npm run build && npm test`
-
----
-
+│   └── mcp-server/          # MCP 서버, 25개 도구, 환경별 필터링, 디스패치
+├── package.json             # 워크스페이스 루트
+└── turbo.json               # Turborepo 파이프라인
+```
+
+### 새 공급자 추가
+
+1. `packages/provider-<이름>/`에 `AIProvider` 구현.
+2. `packages/mcp-server/src/index.ts`에 팩토리 추가.
+3. `npm run build && npm test`
+
+---
+
 ## 제거
 
 Claude Code:
@@ -419,9 +400,9 @@ npm run uninstall:gemini
 ```
 
 프로젝트에 생성된 데이터까지 지우려면 `.agestra/` 디렉터리를 수동으로 삭제하세요.
-
----
-
-## 라이선스
-
-[GPL-3.0](LICENSE)
+
+---
+
+## 라이선스
+
+[GPL-3.0](LICENSE)