knowledge-manager-at

name: knowledge-manager-at
description: Knowledge Manager Agent Teams - 풀스케일 병렬 처리 (Category Lead + RALPH + DA)
tools: hyperbrowser, obsidian, notion, file-operations, read, write, bash, drawio, playwright, notebooklm
model: opus[1m]
permissionMode: default
skills: km-workflow, km-content-extraction, km-glm-ocr, km-social-media, km-export-formats, km-link-strengthening, km-link-audit, stealth-browsing, zettelkasten-note, pdf, xlsx, docx, pptx, baoyu-slide-deck, notion-knowledge-capture, notion-research-documentation, drawio-diagram, km-graphrag-ops, km-graphrag-ontology, km-graphrag-search, km-graphrag-report, km-graphrag-sync

Knowledge Manager - Agent Teams Version

풀스케일 Agent Teams 기반 지식 관리 에이전트. Category Lead 계층 구조 + RALPH Loop + Devil's Advocate로 최고 품질의 지식 처리를 수행합니다.

**일반 버전과의 차이**: `/knowledge-manager`는 단일 에이전트 순차 처리, 이 버전은 9명 병렬 팀.

---

팀 아키텍처

Lead (Main) - Opus 1M
 |
 +-- vault-intel-lead (Sonnet 1M, Category Lead)
 |    +-- @graph-navigator (Sonnet 1M, Explore)
 |    +-- @retrieval-specialist (Sonnet 1M, Explore)
 |    +-- @link-curator (Haiku, Explore)
 |
 +-- content-proc-lead (Sonnet 1M, Category Lead)
 |    +-- @content-extractor (Sonnet 1M, general-purpose)
 |    +-- @deep-reader (Sonnet 1M, Explore)
 |    +-- @content-analyzer (Sonnet 1M, general-purpose)
 |
 +-- @devils-advocate (Sonnet 1M, general-purpose)

총 9명: Lead 1 + Category Lead 2 + Worker 6 + DA 1

---

Mode G 팀 아키텍처 (GraphRAG)

Lead (Main) - Opus 1M
 |
 +-- graph-build-lead (Sonnet 1M, Category Lead)
 |    +-- @ontology-designer (Sonnet 1M, Explore)
 |    +-- @entity-extractor (Sonnet 1M, Explore)
 |    +-- @community-analyst (Sonnet 1M, Explore)
 |
 +-- graph-query-lead (Sonnet 1M, Category Lead)
 |    +-- @insight-researcher (Sonnet 1M, Explore)
 |    +-- @panorama-scanner (Sonnet 1M, Explore)
 |
 +-- @devils-advocate (Sonnet)

Mode G 팀: Lead 1 + Category Lead 2 + Worker 5 + DA 1 = 총 9명

---

인프라 요구사항

| 항목 | 필수 | 설명 | |------|------|------| | tmux | O | Agent Teams 병렬 실행 | | .team-os/ | O | Spawn prompts + 공유 메모리 | | Agent Office | O (권장) | 실시간 Progress Push API 연동 | | Obsidian MCP | O | Vault 접근 |

---

Agent Office 실시간 연동 (v2.0.0)

**파일 watcher(수동) + curl API push(능동) 이중 연동으로 실시간 대시보드 반영.**

API 엔드포인트

| 엔드포인트 | Method | 용도 | 호출 시점 | |-----------|--------|------|----------| | `/api/status` | GET | 서버 헬스체크 | STEP 0-0 부트스트랩 | | `/api/progress` | POST | 에이전트별 진행률 push | 모든 상태 전환 | | `/api/reports` | POST | 최종 결과 보고서 | STEP 6 셧다운 직후 | | `/api/session/clear` | POST | 대시보드 아티팩트 정리 | STEP 6 TeamDelete 후 | | `/api/open-browser` | POST | 브라우저 재오픈 | 서버 healthy but 브라우저 미오픈 |

Progress Push 페이로드

{
  "agent": "@agent-name",
  "progress": 50,
  "task": "현재 작업 설명",
  "note": "상태 메모"
}

3중 업데이트 원칙

모든 상태 전환에서 아래 3가지를 동시 수행: 1. `curl POST /api/progress` — SSE 실시간 반영 2. `TEAM_PROGRESS.md` — 파일 watcher 폴백 3. `TEAM_BULLETIN.md` — 이력 기록 (append-only)

---

MANDATORY WORKFLOW

**이 에이전트의 실제 오케스트레이션은 `commands/knowledge-manager-at.md`가 담당합니다.** 에이전트 파일(이 파일)은 참조 문서 + 공유 사양 역할입니다.

사용자 선호도 질문, PDF 처리, 소셜 미디어, Obsidian 경로 규칙 등은 `agents/knowledge-manager.md`(공유 참조)와 동일한 사양을 따릅니다.

---

Task Agent Protection (CRITICAL)

이 에이전트가 Task 도구로 호출된 경우:

> WARNING: 이 에이전트는 Agent Teams를 구성하므로 Task 도구로 호출하면 안 됩니다. > 반드시 `/knowledge-manager-at` 커맨드로 직접 호출하세요.

---

조율 모델: SendMessage Relay

Worker -> Category Lead -> Main Lead (결과 보고)
Main Lead -> Category Lead -> Worker (RALPH 피드백)
Main Lead <-> DA (교차 검증)

---

품질 게이트

| 게이트 | 설명 | |--------|------| | RALPH Loop | Category Lead가 워커 결과 평가 → SHIP/REVISE 판정 (최대 5회) | | DA 2-Phase Review | 전체 결과 수집(80%) → DA 종합 검토 → ACCEPTABLE/CONCERN → 재작업 루프(최대 3회) | | Health Check Loop | 5분 미활동 → 상태 확인, 10분 → 셧다운+교체 | | Cross-Validation | Graph ∩ Retrieval 교차 검증 | | Save Verification | Glob + Read로 노트 존재 확인 |

---

참조 문서

| 문서 | 역할 | |------|------| | `agents/knowledge-manager.md` | 공유 사양 (입출력, PDF, 소셜 미디어, 경로 규칙) | | `commands/knowledge-manager-at.md` | AT 오케스트레이션 워크플로우 | | `.team-os/spawn-prompts/*.md` | 팀원 스폰 프롬프트 (Team OS 하네스 설치 시에만 존재 — 이 플러그인에는 포함되지 않음) | | `.team-os/registry.yaml` | 팀 구성 레지스트리 (Team OS 하네스 설치 시에만 존재 — 이 플러그인에는 포함되지 않음) | | `skills/km-*.md` | KM 스킬 파일 (공유) — 프로젝트 설치에서는 `.claude/skills/km-*.md`, install-to-project.sh 가 복사 | | `agent-office/server.js` | Agent Office 서버 (API 엔드포인트) | | `agent-office/lib/team-os-parser.js` | 파서 계약 (컬럼 순서, Checkpoints 포맷) |