SARA

📌 새 대화방은 📦 SARA 통합 인수인계서 (최신·단일 시드) 하나만 읽으면 된다. 그 외 인수인계서/설계 페이지는 모두 이력 보존용. 이 페이지는 VS Code 패널형 SARA 에이전트 시스템 구축과 파일 작성 계획을 영속 기록하는 허브입니다. 해당 대화방에서 계속 갱신합니다.

목차 (하위 페이지)

• 🗂️ 세부 상의 — SARA 시스템 설계 (전체 개발 계획)
• 📦 SARA 통합 인수인계서 (최신·단일 시드)
• 🗄️ 인수인계서 이력 아카이브
• ✅ 작업 트래커 DB
• 🚨 멀티에이전트 통합 아키텍처 — 세부 상의 (§10 합의)
• 📄 협의 결과 — 멀티에이전트 통합 확정 (hub session #19)
• 🔍 EVALUATOR 웹페이지 실사용 평가 — 설계 제안

한 줄 요약

VS Code Webview 익스텐션으로 단독 SARA 채팅 패널을 claude-agent-sdk로 구축. 인증=구독 OAuth/setup-token(API 키 미사용). Phase 1·2b·2a·2a-ext 완료, 채티↔GPT 자동 협의 SW(agent-dialogue-hub) 완료. 현재=멀티에이전트 통합 합의 실행(Phase 3): SARA→코디 위임((다) CLI 러너) 완료·자동위임 ON.

핵심 결정 요약

• 접근 방식: claude.ai 채티는 VS Code에 임베드 불가 → VS Code 안에서 동일하게 동작하는 SARA 패널을 직접 구축(방안 B).
• 런타임: Python claude-agent-sdk (세션 resume·subagent·MCP·hooks 지원).
• 인증/비용: 구독 OAuth/setup-token 사용. 2026-06-15부터 Agent SDK 사용은 별도 월 크레딧(Pro $20 등)에서 차감. 본인 단독 사용은 적법, 타인에게 서비스로 제공 시 Console API 키 필요.
• 기존 자산: 요청한 4목표는 이미 설계한 CMDBOARD V2(SARA 하네스)와 동일. cmdboard는 조정 보드(DB+큐+bridge)이며 LLM 런타임이 없어 SARA 런타임만 신설하면 됨.

Phase 로드맵

• Phase 1 (완료): 단독 SARA 패널 + MCP/커스텀 도구 + 파일 업로드. 위치 C:\dev\SARA(:8770, 2026-05-29 독립 리포 분리).
• Phase 2b (완료): PreToolUse 훅 → cody-permission-broker(:7777) 텔레그램 게이트.
• Phase 2a (완료): cmdboard RDS 연동 → sara_continuation(017)로 자동 세션 인계(65%). G1·G5 완료. 저장소 RDS 단독.
• Phase 2a-ext (완료): ① Simple Browser → VS Code Webview 익스텐션 전환 ② 노션 갱신 비동기화(1차 RDS 즉시기록 → 백그라운드 워커가 notion-bulk로 반영) ③ Claude Desktop 수준 UI/기능(멈춤·MCP설정·업로드·모델셀렉터·프로젝트연결 등). G2~G6 완료(노션큐 018·Webview 골격·멈춤/인터럽·UI 이식). 프로젝트 연결=cmdboard projects.
• Phase 3 (진행 — 2026-06-02): 채티↔GPT 자동 협의(agent-dialogue-hub)로 4미결 확정. ROUTER(3분류)+EVALUATOR(task성만) 이식, PLANNER/CODI disabled adapter, 외부 응답 불변. 실행순서 ③노션캐시 전문화→②계측→①하네스. 진행: ③ 노션캐시 B-1 완료 · SARA→코디 위임((다) CLI 러너) 완료(코디 38dbb79, master FF) + 검증 2건 PASS + 자동위임 ON(SARA_CODI_CLI=1). 다음 = 자동위임 첫 실사용 관측 · EVALUATOR 웹 실사용 평가(결정 2건 대기). 상세=멀티에이전트 세부 상의 §10 및 인수인계서 최신 스냅샷.

  최신 착수 시드 = 📦 SARA 통합 인수인계서 최신 스냅샷(2026-06-02 #11). 과거 이력은 🗄️ 이력 아카이브.

• [page] 🗂️ 세부 상의 — SARA 시스템 설계
• [database] ✅ 작업 트래커 — SARA 구축
• [page] 📦 SARA 통합 인수인계서 (최신·단일 시드)
• [page] 🗄️ 인수인계서 이력 아카이브
• [page] 협의 결과 — 주제: SARA 취침 무인 작업 — 멀티에이전트 통합 실사용까지 + 보조 트랙(effort/persist/노션 자동갱신)의 코디 무인 실행 계획 확정.

[전제 — 사용자 결정 확정, 재논의 금지]

• 채티의 Read·Glob 모든 권한 승인

• vscode_sara는 cmdboard 파생. 백지설계 금지. 하네스 로직=vendored copy(직접 import 금지), 스키마=cmdboard 단일소유, contract=버전고정 vendoring(④ 합의).

• 진행 강도=최대. 커밋+master push 승인됨. 위험작업(force push·git reset --hard·DB DROP·SG/IAM 변경·rm -rf·운영배포)은 broker가 게이트/차단하므로 무인 큐에서 제외하거나 게이트 통과 전제. 코디는 각 단위 검증 후 상황에 맞춰 추천안으로 자율 진행.

• 멀티에이전트 합의 실행순서 고정: ③ 노션캐시 전문화(truncate 제거 + 자식페이지 전량 RDS 캐시 G2 비동기 큐, 저장≠주입=주입 기본 summary, 자식추적=page_id 집합 diff+tombstone soft-delete) → ② 계측 필드 추가(cache_bytes/estimated_tokens/load_ms/usage_ratio) → [선행 차단해제: cmdboard ROUTER/EVALUATOR/PLANNER/CODI 실파일 인터페이스·호출규약 대조] → ① ROUTER(chat/task/verify_required 3분류)+EVALUATOR(task성만 독립검증) 최소이식(외부 /chat 응답 불변, 계약은 activity_logs/HandoffArtifact 내부, PLANNER/CODI=disabled adapter) → ② 게이트로 RAG 여부 판정. 실사용까지 목표, 잔여 이슈는 추후 재진단·보완.

• effort 셀렉터 프런트=진행(완비 지시문 codi_effort_selector_frontend_2026-05-30.md, NUL sentinel 보존).

• persist 누락 버그(완료 턴인데 sara_continuation 행 미생성·고아 chain)=원인조사 포함 진행. 1순위 트랙 대비 우선순위도 정하라.

• 노션 자동갱신=ⓐ 확정. 단 SARA 권한 확대(enable_write_tools/Bash)가 아니라 notion_sync_queue+워커에 쓰기 op(update/중복제거/완료 아카이브 이동/트래커 동기화)를 추가해 '페이지 갱신 기본 규칙'을 자동화하는 방향(기존 큐·워커 재사용). 권한 플립은 위험작업이라 코드 준비만, 활성화는 사용자 승인.

• GPT는 깃허브·노션 읽기 도구 보유 → 추측 금지. 실제 repo(delix0731/SARA, cmdboard)·노션 문서를 읽어 근거로만 논하라.

[도출할 것 — 실행계획]

채티(PLANNER)는 위 작업들을 취침 무인 실행용 '코디 작업 큐'로 분해하라. 각 단위마다: 목적 / 현재기준(실파일 근거) / 작업범위 / 금지 / 검증기준(자동 확인 가능) / 되돌리기 / 무인적합성(무인OK vs 아침검토 필요)을 명시하고, 의존·선행(특히 ③의 선행 하네스 대조)을 반영한 실행 순서를 확정하라. 위험·되돌리기 어려운·설계분기가 큰 항목은 코드화 대신 .md 설계안으로 남겨 '아침 검토'로 분류하라.

GPT는 각 단위의 리스크·누락·순서 오류·검증 충분성·무인 적합성을 비판하고 대안을 제시하라. 특히 실파일을 읽어 cmdboard 하네스 ↔ claude-agent-sdk 런타임 인터페이스 정합성을 검증하라.

[진행 규칙]

항목마다 권고안+근거(실파일 인용)로 수렴. 모든 단위가 순서·검증·되돌리기·무인적합성까지 정리되면 최종 결론을 [합의]로 명시하고, 코디 작업 큐(순서 목록 + 각 단위 1줄 요약)를 합의문에 포함하라. (#22, 2026-05-30 05:04 KST) - [page] 🔍 EVALUATOR 웹페이지 실사용 평가 — 설계 제안