ADR-0004: Wiki 정보 구조와 시각 자료

배경#

리서치 문서가 늘면서 research/ 아래의 계획, 경쟁 분석, persona, 안전 문서가 하나의 평면 목록으로 보이기 시작했다. 사용자는 현재 단계, 핵심 결과, 다음 행동보다 파일명을 먼저 해석해야 했다. 참고 이미지가 없어서 제품이 다루는 상황과 경쟁사 관찰 범위를 빠르게 파악하기도 어려웠다.

결정#

Wiki의 정보 구조를 다음 역할로 구분한다.

시작: 프로젝트 개요와 전역 진입점
리서치: 검증, 시장·경쟁, 사용자, 수익, 안전과 사업 도구
분석 결과: 특정 질문에 대한 재사용 가능한 답
의사결정: 근거, 대안, 반증 조건이 있는 결정 기록
근거 자료: 원본 패키지와 1:1로 연결된 출처 카드

브랜드, 마케팅, 제품, 개발은 실제 문서가 생길 때 추가한다. 빈 분류를 미리 만들지 않는다.

탐색 규칙#

wiki/research/index.md를 현재 연구 단계의 시작점으로 사용한다.
일반 탐색에는 현재 판단과 실행에 필요한 문서만 노출한다.
홈의 핵심 문서 지도는 일반 탐색과 같은 기준을 사용해 공개 문서를 모두 연결한다.
출처 카드와 결정 기록은 인용·관련 링크로 접근하며 사이드바와 전체 검색에서 제외한다.
같은 상위 폴더의 문서는 nav_section으로 하위 트랙을 지정한다.
nav_order는 같은 트랙 안의 읽기 순서에만 사용한다.
삭제된 경로는 기준 문서의 aliases로 연결해 과거 로그와 출처 카드 링크를 보존한다.

시각 자료 규칙#

게시 이미지 원본은 raw/sources/<source-id>/assets/에 보존한다.
Wiki 문서는 frontmatter의 visuals 배열로 이미지를 연결한다.
각 항목은 source_id, file, kind, alt, caption을 포함한다.
kind는 concept, screenshot, photo, chart, document 중 하나다.
생성 이미지는 항상 컨셉으로 표시하며 사용자 증거나 제품 요구사항으로 인용하지 않는다.
빌더는 연결된 raw asset만 공개 HTML의 reference asset으로 복사한다.

결과#

사용자는 홈의 핵심 문서 지도에서 공개 문서를 주제별로 모두 찾고, 비즈니스 모델 캔버스에서 사업 가설별 세부 근거로 이동한다. 149개 출처 카드와 결정 기록은 근거 추적용으로 보존하지만 일반 탐색 수를 늘리지 않는다.

ADR-0004: Wiki 정보 구조와 시각 자료

근거 2

연결된 문서 4

배경#

결정#

탐색 규칙#

시각 자료 규칙#

결과#