vignette/docs/README.md

# Vignette 문서 인덱스 (docs/ 통합 목차)

> **여기가 문서의 단일 진입점이다.** `docs/` 안의 모든 정보를 카테고리로 묶어 링크한다.
> 무엇을 찾든 여기서 시작하라. 상태·결정·로드맵의 권위 기준은 SSOT 대시보드, 남은 작업은 통합 TODO가 소유한다.

## 🎯 먼저 볼 것

| 문서 | 역할 |
|---|---|
| **[`dev_dashboard.html`](./dev_dashboard.html)** | **SSOT(단일 진실 공급원)** — 상태·검증 증거·결정·로드맵의 권위 기준 |
| **[`TODO.md`](./TODO.md)** | **열린 실행 항목** — ID별 다음 행동·완료 조건·차단 이유 인덱스 |
| **[`HANDOFF.md`](./HANDOFF.md)** | **현행 인수인계** — 2026-09-01 당시 NAS 배포 증거, 남은 운영·외부 게이트와 승인 경계 |
| **[`ops/backlog-2026-06-26.md`](./ops/backlog-2026-06-26.md)** | **열린 백로그** — ID별 실행 조건·차단 이유·검증 명령 |
| [`archive/project-cleanup-2026-09-07/handoff-goal-production-2026-08-29.md`](./archive/project-cleanup-2026-09-07/handoff-goal-production-2026-08-29.md) | 2026-08-29 배포 전 역사 스냅샷 — 현행 상태 근거로 사용하지 않음 |
| [`../AGENTS.md`](../AGENTS.md) | 에이전트 작업 지침 원본 — **B절 오케스트레이션 바이블(절대 규칙: 고급 모델은 설계·평가, 하위 모델은 조사·구현·검증 실행)**·OS 선파악·증거 정직성·SSOT 동기화·이미지/아바타 파이프라인 |

## 🧭 개발·검증·운영 시작점

| 문서 | 역할 |
|---|---|
| [`guides/local-development.md`](./guides/local-development.md) | Windows 로컬 개발 환경·dev 스택 실행 |
| [`guides/testing.md`](./guides/testing.md) | pytest·typecheck·Playwright 검증 명령 |
| [`guides/architecture.md`](./guides/architecture.md) | API·web·engine·데이터 흐름 |
| [`ops/deployment-pipeline.md`](./ops/deployment-pipeline.md) | production NAS 배포 절차·승인·rollback 경계 |

## 🗺 원천문서·갭 로드맵

| 문서 | 역할 |
|---|---|
| [`guides/source-docs-and-gaps.md`](./guides/source-docs-and-gaps.md) | 원천문서·갭 로드맵 요약(대시보드와 동기화) |
| [`ops/source-docs-gap-analysis-2026-06-26.md`](./ops/source-docs-gap-analysis-2026-06-26.md) | 원천문서 갭 분석 상세 근거(C1~L1) |
| [`ops/backlog-2026-06-26.md`](./ops/backlog-2026-06-26.md) | 운영 백로그 — 열린 항목만 얇게(B1~B4·Phase3 게이트) |

## 📐 근본 설계·비전 (reference — 완료 기록 아님)

| 문서 | 역할 |
|---|---|
| [`MASTERPLAN.md`](./MASTERPLAN.md) | 통합 기준 설계·비전·아키텍처·분류체계·Phase 로드맵 |
| [`redteam/MASTERPLAN_REVISIONS.md`](./redteam/MASTERPLAN_REVISIONS.md) | 마스터플랜 재설계 패치·의사결정 정정(§9 열린 결정 포함) · 대상 결함 [`redteam/REDTEAM_FINDINGS.md`](./redteam/REDTEAM_FINDINGS.md) |
| [`MEMORY_KNOWLEDGE_PERSONA_DESIGN.md`](./MEMORY_KNOWLEDGE_PERSONA_DESIGN.md) | 메모리·지식·페르소나·3-AI 정보비대칭 통합 아키텍처(스키마 DDL 포함) |
| [`taxonomy.md`](./taxonomy.md) | 상담 발화 라벨 분류체계 SoT(기법/내담자상태/슈퍼바이저논평) |
| [`DESIGN_CONCEPT.md`](./DESIGN_CONCEPT.md) | 디자인 시스템·색토큰·아바타·세션UX·3역할 대시보드 SSOT |
| [`ops/video-c0schc1z71q-detailed-notes-2026-08-06.md`](./ops/video-c0schc1z71q-detailed-notes-2026-08-06.md) | 치료 동맹·성과 측정·균열 복구 영상의 타임스탬프별 상세 내용 기록과 연구 근거 분석 |
| [`design-concepts/prompts/vignette-design-prompts-2026-06-27.md`](./design-concepts/prompts/vignette-design-prompts-2026-06-27.md) | 화면 시안 이미지 생성 프롬프트·공통 시각 방향 |

## 🚀 정식 전략 실행 로드맵

<details>
<summary>2026-08 Outcome & Alliance OS 설계·dated evidence 목록</summary>

> 이 목록은 설계와 당시 검증 근거다. 현행 상태와 열린 작업은 대시보드·TODO·backlog를 따른다.

| 문서 | 역할 |
|---|---|
| [`ops/vignette-outcome-alliance-os-agentic-plan-2026-08-06.md`](./ops/vignette-outcome-alliance-os-agentic-plan-2026-08-06.md) | 제약에서 출발하지 않는 Outcome & Alliance OS 에이전틱 계획 — G0~G8 정식 승격, 상태는 대시보드·할 일은 TODO I절 |
| [`ops/measurement-provenance-inventory-2026-08-06.md`](./ops/measurement-provenance-inventory-2026-08-06.md) | G0 기존 지표 provenance 전수표 — 시뮬레이션·모델추론·자기보고·운영관측 경계와 legacy adapter 계약 |
| [`ops/alliance-calibration-report-prompt-1.2.0-2026-08-06.md`](./ops/alliance-calibration-report-prompt-1.2.0-2026-08-06.md) | G1 Alliance Core 합성 gold 보정 보고서 — 9/9 방향 판정, 최종 실패 0, 근거 recall 88.9% |
| [`ops/alliance-calibration-report-prompt-1.2.0-readskewfix-2026-08-07.md`](./ops/alliance-calibration-report-prompt-1.2.0-readskewfix-2026-08-07.md) | G1 승격 기준 재보정 — 24/24 ready, 방향 9/9, 오류·재시도 0, evidence recall 94.4%·precision 73.9% |
| [`ops/alliance-pulse-live-integration-evidence-2026-08-06.md`](./ops/alliance-pulse-live-integration-evidence-2026-08-06.md) | G1 실 DB/API 통합 증거 — 자기평가 선잠금, reveal 경계, 3관점×3축, 교수자 append-only supersession |
| [`ops/outcome-trajectory-live-integration-evidence-2026-08-06.md`](./ops/outcome-trajectory-live-integration-evidence-2026-08-06.md) | G2 실 5회기 통합 증거 — 세 축·누락·safety 분리, 멱등 체크인, role-safe 관계 기억·RLS 및 실제 DB 악화/단발성 noise control |
| [`ops/rupture-repair-live-integration-evidence-2026-08-06.md`](./ops/rupture-repair-live-integration-evidence-2026-08-06.md) | G3 파열·수선 통합 증거 — Scenario Director, 실제 learner-turn 자동 감지, fast/deep reconciliation, API/DB·RLS·교수자 정정 |
| [`ops/deliberate-practice-live-integration-evidence-2026-08-06.md`](./ops/deliberate-practice-live-integration-evidence-2026-08-06.md) | G4 의도적 수련 통합 증거 — 5종 실행 처방, competency graph, 전이 mastery gate, 실제 API/DB·RLS·교수자 교정 |
| [`ops/calibration-transfer-live-integration-evidence-2026-08-06.md`](./ops/calibration-transfer-live-integration-evidence-2026-08-06.md) | G5 자기보정·전이 통합 증거 — 불가역 prediction lock/reveal, calibration error 감소, unseen transfer, 합성 subgroup drift |
| [`ops/outcome-os-g4-g5-production-caller-evidence-2026-08-07.md`](./ops/outcome-os-g4-g5-production-caller-evidence-2026-08-07.md) | G4/G5 실제 production caller 증거 — ready 평가·durable turn에서 처방 생성, prediction lock 뒤 failed 독립 관찰, model-run provenance와 replay·비승격 |
| [`ops/outcome-os-self-directed-learning-loop-ui-evidence-2026-08-07.md`](./ops/outcome-os-self-directed-learning-loop-ui-evidence-2026-08-07.md) | 학생 자기주도 전체 루프 UI 증거 — 실제 `src` 홈 추천→회기→리뷰→G4 처방 재연습, desktop/mobile 2/2와 9장 시각 QA(390×844·320×568 포함); 로그인 없는 route fixture이며 실 DB 증거와 분리 |
| [`ops/supervision-research-live-integration-evidence-2026-08-06.md`](./ops/supervision-research-live-integration-evidence-2026-08-06.md) | G6 감독·연구 OS 통합 증거 — 3클릭 attention queue, metadata-only 불일치, version drift, Phase 3 네 도메인 provenance |
| [`ops/outcome-os-g6-ledger-producer-evidence-2026-08-07.md`](./ops/outcome-os-g6-ledger-producer-evidence-2026-08-07.md) | G6 scheduled 원장 파생 증거 — G0~G5 ledger에서 attention·curriculum gap·4-domain manifest를 직접 파생하고 호출자 계산을 제거 |
| [`ops/outcome-os-g6-version-comparison-producer-evidence-2026-08-07.md`](./ops/outcome-os-g6-version-comparison-producer-evidence-2026-08-07.md) | G6 자동 version evaluator 실 DB 증거 — repo-approved synthetic baseline/candidate, measurement anchor 12개, drift/subgroup provenance와 0-duplicate replay |
| [`ops/multimodal-alliance-live-integration-evidence-2026-08-06.md`](./ops/multimodal-alliance-live-integration-evidence-2026-08-06.md) | G7 멀티모달 동맹 통합 증거 — 단일 오디오 시계, 독립 text/voice 측정과 보정 융합, 역할 경계, 동의 철회·tombstone 삭제 |
| [`ops/continuous-improvement-live-integration-evidence-2026-08-06.md`](./ops/continuous-improvement-live-integration-evidence-2026-08-06.md) | G8 지속 개선 통합 증거 — source→독립 red-team→human gate, 4종 증거, append-only 승인·rollback·incident DAG |
| [`ops/outcome-os-g8-agentic-worker-evidence-2026-08-07.md`](./ops/outcome-os-g8-agentic-worker-evidence-2026-08-07.md) | G8 실제 agentic worker 코드 증거 — source hash·PII gate, generator, 독립 red-team 2개, variant judge 3개 이상, durable pending payload와 incident→adversarial 환류 |
| [`ops/evidence/continuous-improvement-agentic-producer-live-2026-08-07.json`](./ops/evidence/continuous-improvement-agentic-producer-live-2026-08-07.json) | G8 scheduled producer 실증 — 실제 Claude 7 calls, dev PostgreSQL pending human gate, provenance/hash와 0-call replay |
| [`ops/outcome-os-g7-wss-soak-evidence-2026-08-07.md`](./ops/outcome-os-g7-wss-soak-evidence-2026-08-07.md) | G7 실제 로컬 `/voice/ws` 전송 short soak — 철회·재연결·overflow 복구와 50분 실행 옵션, 물리 마이크/public WSS 경계 명시 |
| [`ops/outcome-os-g7-external-proof-readiness-2026-08-07.md`](./ops/outcome-os-g7-external-proof-readiness-2026-08-07.md) | G7 외부 종료 증거 준비 — 선행 동의 원장, public runner v4, worker/Uvicorn·Linux topology high-water, 독립 human voice-gain과 canonical checker |
| [`ops/outcome-os-g7-g8-visual-qa-2026-08-07.md`](./ops/outcome-os-g7-g8-visual-qa-2026-08-07.md) | G7/G8 데스크톱·모바일 시각 QA — G8 승인 차단 이유 상시 노출·키보드 제출, G7 타깃·포커스 수치 회귀 |
| [`ops/outcome-os-deploy-preflight-evidence-2026-08-07.md`](./ops/outcome-os-deploy-preflight-evidence-2026-08-07.md) | G0~G8 배포 프리플라이트 — migration sentinel, G3~G8 독립 토큰, Compose fail-closed 전달 증거 |
| [`ops/outcome-os-public-deployment-evidence-2026-08-07.md`](./ops/outcome-os-public-deployment-evidence-2026-08-07.md) | G8/AOS-011 공개 종료 증거 — clean release API·Pages 승격, 119-path OpenAPI, auth/OAuth, asset·브라우저·watchdog proof와 G7 잔여 경계 |
| [`ops/outcome-os-clean-release-manifest-2026-08-07.json`](./ops/outcome-os-clean-release-manifest-2026-08-07.json) | dirty worktree의 G0~G8 릴리스 분류 manifest — related/mixed/excluded 전건 분류와 hunk-review-required 차단 |
| [`ops/outcome-os-release-hunk-map-2026-08-07.json`](./ops/outcome-os-release-hunk-map-2026-08-07.json) | 혼합 파일 4개의 exact hunk SHA·포함/제외/split 결정과 생성형 API 계약 재생성 규칙 |
| [`ops/evidence/outcome-os-release-only-2026-08-07.patch`](./ops/evidence/outcome-os-release-only-2026-08-07.patch) | clean HEAD 적용 검사를 통과한 G0~G8 release-only patch — 공식 API 타입 재생성 포함, 공개 배포 증거는 아님 |

</details>

## 🛠 개발·운영 가이드

| 문서 | 역할 |
|---|---|
| [`guides/collaboration-for-researchers.md`](./guides/collaboration-for-researchers.md) | 비개발자(연구팀·디자인 담당)용 GitHub 협업 가이드 — 브랜치·PR·문구 수정 흐름·금지 사항 |
| [`guides/local-development.md`](./guides/local-development.md) | 로컬 개발 환경 구축·실행 (1-커맨드 dev 스택) |
| [`guides/architecture.md`](./guides/architecture.md) | 시스템 아키텍처(엔진/오케스트레이터/저항/마스킹/음성/평가/데이터) |
| [`guides/testing.md`](./guides/testing.md) | 테스트·검증(pytest, typecheck, Playwright E2E 게이트) |
| [`ops/agent-work-packet-template.md`](./ops/agent-work-packet-template.md) | 에이전트 작업 패킷·판정 기록 양식 — `AGENTS.md` B절(오케스트레이션 바이블) B.5·B.6 실행 양식, 병렬 스폰 체크리스트 |
| [`ops/codex-agents/README.md`](./ops/codex-agents/README.md) | Codex 워커 정의(explorer/researcher/worker/verifier) 참조 사본·설치법 — 런타임은 `~/.codex/agents/`, 프로젝트 스코프 미사용 이유(#26408) |
| [`DEPLOYMENT.md`](./DEPLOYMENT.md) | docker compose 배포·엔진 어댑터·환경변수·외부공개 운영 |
| [`HANDOFF.md`](./HANDOFF.md) | 일반 세션 인수인계 진입점 — 현행 실행 순서·승인 경계 |

## ⚙️ 운영 런북·게이트 트래커 (`ops/`)

| 문서 | 역할 |
|---|---|
| [`ops/public-runtime-watchdog.md`](./ops/public-runtime-watchdog.md) | 공개 런타임 워치독 설치·복구 절차(런북) |
| [`ops/nas-preview-g8-rollback-proof-runbook.md`](./ops/nas-preview-g8-rollback-proof-runbook.md) | G8 실제 receipt-bound image rollback 런북 — Gate6 helper 격리 계약 정정(소속 기준), 실행 순서, 금지 사항, 실패 복구 |
| [`ops/evidence/nas-preview-g8-actual-rollback-2026-08-07.json`](./ops/evidence/nas-preview-g8-actual-rollback-2026-08-07.json) | G8 실제 rollback/restore 기계 판독 증거 — helper 격리, 두 executed receipt, HMAC journal 체인, DB lifecycle 집계, 정리 상태 |
| [`ops/evidence/google-account-data-recovery-2026-08-29.json`](./ops/evidence/google-account-data-recovery-2026-08-29.json) | Google identity alias 기반 관리자 데이터 복구의 백업·가드 트랜잭션·운영 DB·공개 런타임·Pages 승격 증거(실제 Gmail callback 미완료) |
| [`ops/evidence/google-account-live-browser-proof-2026-08-29.json`](./ops/evidence/google-account-live-browser-proof-2026-08-29.json) | 기존 실서비스 인증 세션의 `yunchan8804@gmail.com`·관리자 권한·온보딩 비전환·복구 데이터 가시성 및 현행 단일 Google CTA 검증 증거 |
| [`ops/evidence/workbook-runtime-sync-2026-08-29.json`](./ops/evidence/workbook-runtime-sync-2026-08-29.json) | 개선관리 완료본의 현행 API·Pages 증거 동기화, 전 시트 수식·시각 검증과 완료 8·검토 3 유지 기록 |
| [`ops/evidence/workbook-req001-completion-sync-2026-08-29.json`](./ops/evidence/workbook-req001-completion-sync-2026-08-29.json) | REQ-001 완료 승격 뒤 개선관리 완료본 6시트·11요구·38수식·수식 오류 0·완료 9/검토 2와 C-001 `pending-valid` 재생성 증거 |
| [`ops/evidence/avatar-decode-audit-2026-08-29.json`](./ops/evidence/avatar-decode-audit-2026-08-29.json) | 아바타 source union 93개·52,973 bytes·inventory SHA와 실제 decode 3 정상/90 실패, 현 DB 참조 2 정상/6 실패를 비식별 집계로 고정한 증거 |
| [`ops/evidence/avatar-image-resilience-recovery-2026-08-29.json`](./ops/evidence/avatar-image-resilience-recovery-2026-08-29.json) | 공개 아바타 404 원인·시점 복구·인증 브라우저 DOM과 공통 이미지 fallback 후보의 privacy-safe 증거 |
| [`ops/evidence/req008-reboot-preflight-2026-08-29.json`](./ops/evidence/req008-reboot-preflight-2026-08-29.json) | REQ-008 실제 재부팅 전 read-only task/runtime 사전점검 스냅샷 — 현재 public outage와 실제 reboot smoke가 이를 대체·완료하지 않음 |
| [`ops/spreadsheet-implementation-audit-2026-09-09.md`](./ops/spreadsheet-implementation-audit-2026-09-09.md) | 최신 개선관리 원본 14개 항목의 완료 13·검토 1(C-001)과 로컬 재검증·미배포 경계 |
| [`qa/production-computer-use-report-2026-09-09.md`](./qa/production-computer-use-report-2026-09-09.md) | 실제 배포 CUA 128 카탈로그·ledger, SHA `1306c524` H09 PASS와 T18 역할 재검증 경계 |
| [`ops/evidence/professor-summary-gap-deploy-2026-08-29.json`](./ops/evidence/professor-summary-gap-deploy-2026-08-29.json) | 교수자 검토 큐·요약 카드 12px 분리의 RED→GREEN·7폭/전체 시각 게이트·clean Pages 배포·실서비스 DOM 증거 |
| [`ops/public-db-recovery-rehearsal-2026-08-07.md`](./ops/public-db-recovery-rehearsal-2026-08-07.md) | 공개 DB 데이터 교체 사고의 RLS/volume 포렌식, 이중 dump, 격리 복구·최신 migration/API 리허설과 승인형 cutover/rollback 게이트 |
| [`ops/server-migration-runbook-draft.md`](./ops/server-migration-runbook-draft.md) | 서버 이관 런북 초안(자택→학교 정보처) — 이식성 이슈·DB dump/restore·엔진 모드 전환·검증 (초안) |
| [`ops/pilot-usage-guide-draft.md`](./ops/pilot-usage-guide-draft.md) | 파일럿 사용 지침 초안(대학원생 ~20명) — 접속·시간 기반 회기·라이브 코칭·유의사항 (초안) |
| [`ops/tailscale-vnet-runtime-2026-06-27.md`](./ops/tailscale-vnet-runtime-2026-06-27.md) | Tailnet 런타임 + 공개 vnet 외부 게이트 추적 |
| [`ops/hanshin-data-governance-gate.md`](./ops/hanshin-data-governance-gate.md) | 한신대 데이터/SSO 외부 증거 게이트 체크리스트 |
| [`ops/hanshin-feedback-improvement-plan-2026-07-03.md`](./ops/hanshin-feedback-improvement-plan-2026-07-03.md) | 한신대 실사용 오류분석 기반 개선 계획(P0~P4·레드팀 반영) |
| [`ops/hanshin-meeting-actions-2026-07-13.md`](./ops/hanshin-meeting-actions-2026-07-13.md) | 2026-07-13 한신대 회의 결정 → 구현 스펙(P1~P5, 불변 요구사항) |
| [`ops/session-progress-gauge-design-2026-07-14.md`](./ops/session-progress-gauge-design-2026-07-14.md) | P2 회기 누적 게이지·수치 상세 설계 1p |
| [`ops/tagged-data-utilization-2026-07-15.md`](./ops/tagged-data-utilization-2026-07-15.md) | 연구팀 태깅 축어록 4종 활용 — KB 등록·taxonomy 1.1.0·P8~P11 초안 실행 기록 + 임상팀 게이트 후속 계획 |
| [`redteam/hanshin-feedback-plan-redteam-2026-07-03.md`](./redteam/hanshin-feedback-plan-redteam-2026-07-03.md) | 한신대 개선 계획 적대 검토(컨텍스트·privacy·fallback·임상 설명 위험) |
| [`redteam/hanshin-feedback-plan-counter-redteam-2026-07-03.md`](./redteam/hanshin-feedback-plan-counter-redteam-2026-07-03.md) | 한신대 개선 계획 대레드팀 검토(과잉 차단 완화·1차 MVP 재정렬) |
| [`ops/code-quality-research-2026-06-26.md`](./ops/code-quality-research-2026-06-26.md) | 코드품질 분석 + 미실행 리팩터 로드맵 |
| [`archive/project-cleanup-2026-09-07/refactor-governance-2026-07-15.md`](./archive/project-cleanup-2026-09-07/refactor-governance-2026-07-15.md) | 전 저장소 구조 감사·P1~P8 리팩터·중복/번들/SSOT 게이트 실행 증거 |
| [`ops/postgres-rls-audit-smoke.md`](./ops/postgres-rls-audit-smoke.md) | RLS·감사로그 격리 스모크 절차(재현 런북) |
| [`ops/engine-rss-smoke-2026-06-28.md`](./ops/engine-rss-smoke-2026-06-28.md) · [`ops/resistance-openness-db-smoke-2026-06-28.md`](./ops/resistance-openness-db-smoke-2026-06-28.md) | 대시보드가 인용하는 live 실측 증거 |
| [`ops/layout-research-2026-06-27/persona-dashboard-layout-guideline.md`](./ops/layout-research-2026-06-27/persona-dashboard-layout-guideline.md) | 페르소나 스튜디오·대시보드 레이아웃 원칙 |

## 🧩 의사결정 기록 (ADR — `decisions/`)

| 문서 | 역할 |
|---|---|
| [`decisions/backend-node-transition.md`](./decisions/backend-node-transition.md) | 백엔드 언어 방향(FastAPI 유지·Node 계약 우선 전환) |
| [`decisions/voice-s2s-poc.md`](./decisions/voice-s2s-poc.md) | 음성 s2s 2차 PoC 채택 판단 기준 |
| [`decisions/local-voice-stack.md`](./decisions/local-voice-stack.md) | 노트북 로컬 음성 스택 결정 — faster-whisper STT + MeloTTS TTS(둘 다 MIT), 설치 함정·cuDNN 제약, G7 게이트 provider 계약 |
| [`decisions/outcome-alliance-measurement-ledger.md`](./decisions/outcome-alliance-measurement-ledger.md) | Outcome & Alliance append-only 측정 원장, source/perspective 경계, 전진 복구·롤백 결정 |

## 🧪 Phase 3 파일럿 (forward — 아직 미실행)

| 문서 | 역할 |
|---|---|
| [`phase3/README.md`](./phase3/README.md) | Phase3 파일럿 게이트 인덱스·증거 루트 |
| [`phase3/pilot-runbook.md`](./phase3/pilot-runbook.md) | 20명 파일럿 진입/완료 게이트·운영 절차 |
| [`phase3/kpi-measurement-plan.md`](./phase3/kpi-measurement-plan.md) | KPI 정의·리포트 형식·측정 방법 |
| [`phase3/dataset-export-manifest.md`](./phase3/dataset-export-manifest.md) | 재귀학습 데이터셋 export 매니페스트·승인 게이트 계약 |
| [`phase3/privacy-consent-audit.md`](./phase3/privacy-consent-audit.md) | 동의·철회·프라이버시 감사 체크리스트 |

## 🖼 아바타 파이프라인

| 문서 | 역할 |
|---|---|
| [`ops/handoff-avatar-seoyeon-2026-06-27.md`](./ops/handoff-avatar-seoyeon-2026-06-27.md) | 서연(P1) 래스터 아바타 보류 상태·보존 파이프라인 핸드오프 |
| [`avatar-art/personas/README.md`](./avatar-art/personas/README.md) | P4~P7 Live2D 파츠 생성 규칙 |
| `avatar-art/` | 페르소나별 파츠·재현 스크립트·QA 자산(활성 파이프라인) |

## 🗄 아카이브 (읽지 않는다)

| 문서 | 역할 |
|---|---|
| [`archive/README.md`](./archive/README.md) | **냉동 보관소** — 완료 기록·실행된 계획·일회성 스냅샷. 현재 상태 근거로 삼지 않는다 |

## 📦 그 외 자산 (문서가 아니라 참조 자산)

`design-verification/`(실제 렌더 검증 캡처) · `mockups/`(디자인 목업) · `design-concepts/generated/`(시안 PNG) ·
`voice-art/`(음성 PoC 샘플·스크립트) · `golden_schema.jsonl`(평가 골든셋 스키마). 각 문서가 필요 시 참조하며,
단독으로 읽는 계획 정보는 아니다.

---

> 유지 원칙: 완료된 작업 기록이 다시 쌓이면 `archive/`로 옮겨 이 인덱스와 활성 문서를 얇게 유지한다. `archive/`는 현재 상태 근거가 아니다.
> 상태·결정 변경은 별도 문서로만 남기지 말고 **SSOT 대시보드**에 반영·동기화한다.
> 새 문서를 만들면 이 인덱스에 한 줄 추가하고, 새 열린 작업은 [`TODO.md`](./TODO.md)에 반영한다.