배경#
모든 Markdown 문서를 같은 2열 관리 화면으로 표시하면 홈의 링크와 전역 메뉴가 중복되고, 긴 리서치 본문 옆에서 탐색과 상태 정보가 계속 시선을 가져간다. 원본 source ID를 본문에 그대로 노출하면 근거 추적은 쉽지만 문장 읽기가 크게 느려진다.
결정#
정적 Wiki는 세 가지 표시 모드를 사용한다.
- 홈: 주요 결론, 프로젝트 개요와 리서치 큐로 이동하는 탐색 허브다. 문서 관리 도구를 노출하지 않는다.
- 리더: 리서치, 결정과 운영 문서를 위한 중앙 정렬 독서 화면이다. 목차와 메타데이터는 요청할 때만 펼친다.
- 출처: source card의 제목과 요약, 원문 이동을 우선한다. 내부 source 접두사는 화면 제목에서 제거한다.
전역 문서 탐색은 상시 사이드바가 아니라 문서 서랍으로 제공한다. 상태, 업데이트, 신뢰도, 근거 목록과 역링크는 하나의 문서 정보 패널 안에 둔다.
인용 규칙#
- Markdown과 raw에는 canonical source ID를 그대로 보존한다.
- HTML에서는 source ID를 문서 내 최초 등장 순서의 숫자 각주로 변환한다.
- 각주 번호는 해당 source card로 직접 연결한다.
문서 정보의 근거 목록도 같은 순서와 번호를 사용한다.- 인용되지 않은 frontmatter source는 인용된 근거 뒤에 추가한다.
검증 기준#
- 기본 화면에 상시 사이드바가 없어야 한다.
- 긴 리서치의 첫 섹션은 데스크톱 첫 화면 안에서 시작해야 한다.
- 생성된 HTML 본문에
<code>[SRC-...가 남지 않아야 한다. - 숫자 인용과 근거 목록의 번호·대상이 일치해야 한다.
- 390px 화면에서 가로 스크롤 없이 메뉴, 검색과 문서 정보를 사용할 수 있어야 한다.
관련 문서: ADR-0001: LLM Wiki 지식 시스템, ADR-0002: Pretendard 타이포그래피 시스템, ADR-0005: Wiki 디자인 시스템