알려진 이슈 스냅샷
리뷰 시 이 목록과 대조해 신규 발생분만 보고한다. 이슈가 해소되면 이 파일에서 제거하고, 새 이슈는 추가한다. 최종 갱신: 2026-07-30 (활성 48개 .mdx 모두 docs.json 등록,ko/backup 72개)
활성 영역 고아 파일 0개
navigation 스킬의 검사 범위(ko/ + 루트)에서 ko/backup/**를 제외하면 활성 MDX 48개가 모두 docs.json에 등록되어 있고, 등록됐지만 파일이 없는 경로도 없다.
ko/backup/**는 2026-07-30 기준으로 네비게이션에 등록되지 않은 72개 페이지를 원래 하위 구조대로 보관한다. 루트의 Mintlify 템플릿 잔재 introduction.mdx는 ko/backup/root/introduction.mdx로, 이전 빠른 시작 페이지는 ko/backup/quickstart.mdx로 이동했다. Mintlify가 백업 문서를 빌드하거나 링크 검사하지 않도록 루트 .mintignore에서 ko/backup/을 제외한다.
백업 페이지 구성 — 72개
백업 페이지를 다시 공개하려면 현재 등록된 통합 페이지와의 중복을 검토하고, 페이지를 활성 경로로 복원한 뒤
docs.json에 함께 등록한다.
깨진 내부 링크 — 5건 / 4개 파일 / 고유 대상 3개
npx mintlify broken-links 기준(2026-07-29). ko/backup 이동으로 새로 깨진 활성 링크 15건은 현재 통합 페이지로 교체했으며, 아래는 기존에 남아 있던 링크다.
frontmatter 위반
- 활성 문서 실제 결함 1건:
ko/introduction.mdx—description누락. ko/backup의 frontmatter 결함은 공개 복원 시 점검한다.
내용 중복
ko/model.mdx↔ko/enterprise/global-model.mdx: 모델 추가 프로세스 중복 설명ko/backup의 모델 연동 가이드 5개와 등록된ko/self-hosted-model.mdx가 유사한 구조를 사용한다. 복원 시 통합 페이지와 프로바이더별 비교표 형태를 우선 검토한다.ko/backup/space.mdx↔ko/agents-and-bots.mdx: 스페이스 정의 문단 중복
활성 스텁 페이지 (40줄 미만 · 6개)
리드 Card 없음
활성 MDX 48개에는 리드 Card 누락이 없다. 백업 페이지는 공개 복원 시 검증한다.기타
- 활성 문서 중복 h2 4건:
Porter AI 운영 시스템에 등록,다음 단계,적용 범위 설정,채팅에서 사용하기. 현재는 서로 다른 기능 페이지에서 같은 절차명을 사용하는 구조적 중복이다. - 표기 불일치:
## 채팅에서 사용하기↔## 채팅창에서 사용하기가 혼재한다. snippets/snippet-intro.mdx: Mintlify 기본 예제이며 어디서도 사용하지 않는다.- 레거시 이미지 URL
storage.googleapis.com/files.cloudtype.io13건은ko/backup/dev/에만 남아 있다. logo/-logo-light.svg,logo/-logo-dark.svg: 파일명에 선행 하이픈이 붙은 미참조 잔재- 다국어:
ko/단일 구성.en/확장 시 디렉토리와 네비게이션 구조 재설계가 필요하다.