다크 모드
002. 사용자 가이드 Space 분리
상태
승인됨 (2026-03-11)
맥락
truloop-wiki는 하나의 GitBook Space에 내부 문서(common/ + tech/)가 모두 포함되어 있었습니다. GitBook이 자동 생성하는 llms.txt에 기술 아키텍처, DB 스키마, API 설계 등 내부 문서까지 포함되어, 이를 AI Knowledge Base로 활용하면 사용자에게 불필요한 내부 정보가 노출되는 문제가 있었습니다.
결정
GitBook Monorepo 기능을 활용하여, 하나의 Git 레포에서 두 개의 GitBook Space를 운영합니다.
| Space | Project Directory | 대상 독자 | 용도 |
|---|---|---|---|
| truloop Internal Wiki | / (루트) | 팀 내부 (PM, 개발자, QA) | 기존 내부 문서 |
| truloop User Guide | user-guide/ | 앱 사용자 | AI KB용 llms.txt 생성 |
구현 내용
user-guide/디렉토리에 별도.gitbook.yaml,SUMMARY.md,README.md생성- common/features/ 소스를 사용자 친화적 톤으로 재구성하여 user-guide/ 콘텐츠 작성
- 새로운 Skill (
user-guide-writing) 및 Agent (writer-user-guide) 추가 - wiki-sync 파이프라인에 user-guide/ 레이어 통합
대안
| 대안 | 기각 이유 |
|---|---|
| 레포 자체를 분리 | 동기화 복잡도 증가, wiki-sync 파이프라인 이중 관리 필요 |
| llms.txt 수동 관리 | GitBook 자동 생성 기능을 활용하지 못함, 유지보수 부담 |
| common/ 문서를 사용자 대상으로 톤 변경 | 내부 팀의 기능 스펙 문서 품질 저하 |