vignette/docs

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

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

🎯 먼저 볼 것

문서	역할
dev_dashboard.html	SSOT(단일 진실 공급원) — 상태·검증 증거·결정·로드맵의 권위 기준
TODO.md	할 일(안된 것들) 통합 — 흩어진 열린 작업을 주제별로 모은 인덱스
../AGENTS.md	에이전트 작업 지침 원본(OS 선파악·증거 정직성·SSOT 동기화·이미지/아바타 파이프라인)

🗺 원천문서·갭 로드맵

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

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

문서	역할
MASTERPLAN.md	통합 기준 설계·비전·아키텍처·분류체계·Phase 로드맵
redteam/MASTERPLAN_REVISIONS.md	마스터플랜 재설계 패치·의사결정 정정(§9 열린 결정 포함) · 대상 결함 redteam/REDTEAM_FINDINGS.md
MEMORY_KNOWLEDGE_PERSONA_DESIGN.md	메모리·지식·페르소나·3-AI 정보비대칭 통합 아키텍처(스키마 DDL 포함)
taxonomy.md	상담 발화 라벨 분류체계 SoT(기법/내담자상태/슈퍼바이저논평)
DESIGN_CONCEPT.md	디자인 시스템·색토큰·아바타·세션UX·3역할 대시보드 SSOT
ops/video-c0schc1z71q-detailed-notes-2026-08-06.md	치료 동맹·성과 측정·균열 복구 영상의 타임스탬프별 상세 내용 기록과 연구 근거 분석
design-concepts/prompts/vignette-design-prompts-2026-06-27.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	G0 기존 지표 provenance 전수표 — 시뮬레이션·모델추론·자기보고·운영관측 경계와 legacy adapter 계약
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	G1 승격 기준 재보정 — 24/24 ready, 방향 9/9, 오류·재시도 0, evidence recall 94.4%·precision 73.9%
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	G2 실 5회기 통합 증거 — 세 축·누락·safety 분리, 멱등 체크인, role-safe 관계 기억·RLS 및 실제 DB 악화/단발성 noise control
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	G4 의도적 수련 통합 증거 — 5종 실행 처방, competency graph, 전이 mastery gate, 실제 API/DB·RLS·교수자 교정
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	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	학생 자기주도 전체 루프 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	G6 감독·연구 OS 통합 증거 — 3클릭 attention queue, metadata-only 불일치, version drift, Phase 3 네 도메인 provenance
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	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	G7 멀티모달 동맹 통합 증거 — 단일 오디오 시계, 독립 text/voice 측정과 보정 융합, 역할 경계, 동의 철회·tombstone 삭제
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	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	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	G7 실제 로컬 /voice/ws 전송 short soak — 철회·재연결·overflow 복구와 50분 실행 옵션, 물리 마이크/public WSS 경계 명시
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	G7/G8 데스크톱·모바일 시각 QA — G8 승인 차단 이유 상시 노출·키보드 제출, G7 타깃·포커스 수치 회귀
ops/outcome-os-deploy-preflight-evidence-2026-08-07.md	G0G8 배포 프리플라이트 — migration sentinel, G3G8 독립 토큰, Compose fail-closed 전달 증거
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	dirty worktree의 G0~G8 릴리스 분류 manifest — related/mixed/excluded 전건 분류와 hunk-review-required 차단
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	clean HEAD 적용 검사를 통과한 G0~G8 release-only patch — 공식 API 타입 재생성 포함, 공개 배포 증거는 아님

🛠 개발·운영 가이드

문서	역할
guides/collaboration-for-researchers.md	비개발자(연구팀·디자인 담당)용 GitHub 협업 가이드 — 브랜치·PR·문구 수정 흐름·금지 사항
guides/local-development.md	로컬 개발 환경 구축·실행 (1-커맨드 dev 스택)
guides/architecture.md	시스템 아키텍처(엔진/오케스트레이터/저항/마스킹/음성/평가/데이터)
guides/testing.md	테스트·검증(pytest, typecheck, Playwright E2E 게이트)
DEPLOYMENT.md	docker compose 배포·엔진 어댑터·환경변수·외부공개 운영
HANDOFF.md	최신 세션 인수인계 — 현재 상태·남은 외부 게이트·다음 우선순위

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

문서	역할
ops/public-runtime-watchdog.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	G8 실제 rollback/restore 기계 판독 증거 — helper 격리, 두 executed receipt, HMAC journal 체인, DB lifecycle 집계, 정리 상태
ops/public-db-recovery-rehearsal-2026-08-07.md	공개 DB 데이터 교체 사고의 RLS/volume 포렌식, 이중 dump, 격리 복구·최신 migration/API 리허설과 승인형 cutover/rollback 게이트
ops/server-migration-runbook-draft.md	서버 이관 런북 초안(자택→학교 정보처) — 이식성 이슈·DB dump/restore·엔진 모드 전환·검증 (초안)
ops/pilot-usage-guide-draft.md	파일럿 사용 지침 초안(대학원생 ~20명) — 접속·시간 기반 회기·라이브 코칭·유의사항 (초안)
ops/tailscale-vnet-runtime-2026-06-27.md	Tailnet 런타임 + 공개 vnet 외부 게이트 추적
ops/hanshin-data-governance-gate.md	한신대 데이터/SSO 외부 증거 게이트 체크리스트
ops/hanshin-feedback-improvement-plan-2026-07-03.md	한신대 실사용 오류분석 기반 개선 계획(P0~P4·레드팀 반영)
ops/hanshin-meeting-actions-2026-07-13.md	2026-07-13 한신대 회의 결정 → 구현 스펙(P1~P5, 불변 요구사항)
ops/session-progress-gauge-design-2026-07-14.md	P2 회기 누적 게이지·수치 상세 설계 1p
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	한신대 개선 계획 적대 검토(컨텍스트·privacy·fallback·임상 설명 위험)
redteam/hanshin-feedback-plan-counter-redteam-2026-07-03.md	한신대 개선 계획 대레드팀 검토(과잉 차단 완화·1차 MVP 재정렬)
ops/code-quality-research-2026-06-26.md	코드품질 분석 + 미실행 리팩터 로드맵
ops/refactor-governance-2026-07-15.md	전 저장소 구조 감사·P1~P8 리팩터·중복/번들/SSOT 게이트 실행 증거
ops/postgres-rls-audit-smoke.md	RLS·감사로그 격리 스모크 절차(재현 런북)
ops/engine-rss-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	페르소나 스튜디오·대시보드 레이아웃 원칙

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

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

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

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

🖼 아바타 파이프라인

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

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

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

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

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

---

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