배경#
리서치 문서가 늘면서 research/ 아래의 계획, 경쟁 분석, persona, 안전 문서가 하나의
평면 목록으로 보이기 시작했다. 사용자는 현재 단계, 핵심 결과, 다음 행동보다 파일명을
먼저 해석해야 했다. 참고 이미지가 없어서 제품이 다루는 상황과 경쟁사 관찰 범위를
빠르게 파악하기도 어려웠다.
결정#
Wiki의 정보 구조를 다음 역할로 구분한다.
- 시작: 프로젝트 개요와 전역 진입점
- 리서치: 연구 허브와 연구 운영, 경쟁 환경, 사용자, 안전과 신뢰 트랙
- 분석 결과: 특정 질문에 대한 재사용 가능한 답
- 의사결정: 근거, 대안, 반증 조건이 있는 결정 기록
- 근거 자료: 원본 패키지와 1:1로 연결된 출처 카드
브랜드, 마케팅, 제품, 개발은 실제 문서가 생길 때 추가한다. 빈 분류를 미리 만들지 않는다.
탐색 규칙#
wiki/research/index.md를 현재 연구 단계의 시작점으로 사용한다.- 같은 상위 폴더의 문서는
nav_section으로 하위 트랙을 지정한다. nav_order는 같은 트랙 안의 읽기 순서에만 사용한다.- 출처 카드는 성격에 따라 경쟁 및 대체재, 법률과 안전, 시장과 연구, 프로젝트와 운영으로 자동 분류한다.
시각 자료 규칙#
- 게시 이미지 원본은
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으로 복사한다.
결과#
사용자는 홈에서 연구 허브로 이동한 뒤 현재 단계, 결과, 다음 행동을 순서대로 확인할 수 있다. 시각 자료는 이해를 돕지만 출처 유형과 한계를 숨기지 않는다.
관련 문서: ADR-0001: LLM Wiki 지식 시스템, ADR-0003: Wiki 읽기 인터페이스, ADR-0005: Wiki 디자인 시스템