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
design-concepts/prompts/vignette-design-prompts-2026-06-27.md	화면 시안 이미지 생성 프롬프트·공통 시각 방향

🛠 개발·운영 가이드

문서	역할
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/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 채택 판단 기준

🧪 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에 반영한다.