> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getporter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Known issues

# 알려진 이슈 스냅샷

리뷰 시 이 목록과 대조해 **신규 발생분만 보고**한다. 이슈가 해소되면 이 파일에서 제거하고, 새 이슈는 추가한다.

*최종 갱신: 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개

| 구분                | 수량 | 경로                                                                                       |
| ----------------- | -: | ---------------------------------------------------------------------------------------- |
| 운영 시스템 의도적 비공개    | 14 | `ko/backup/ops/*.mdx`                                                                    |
| 에이전트·봇 의도적 비공개    |  2 | `ko/backup/{agents,bots}.mdx`                                                            |
| 모델 연동 가이드         |  5 | `ko/backup/{anthropic,bedrock,deepseek,openrouter,flowise}.mdx`                          |
| 통합·정리 후보          |  8 | `ko/backup/{api,edit,folder,space,widget,prompt,agent-bot-use-cases,private-agents}.mdx` |
| Mintlify 템플릿 잔재   |  1 | `ko/backup/root/introduction.mdx`                                                        |
| 애플리케이션 플랫폼 이전 페이지 | 41 | `ko/backup/dev/*.mdx` 40개, `ko/backup/application-management.mdx`                        |
| AI 활용 이전 빠른 시작    |  1 | `ko/backup/quickstart.mdx`                                                               |

백업 페이지를 다시 공개하려면 현재 등록된 통합 페이지와의 중복을 검토하고, 페이지를 활성 경로로 복원한 뒤 `docs.json`에 함께 등록한다.

## 깨진 내부 링크 — 5건 / 4개 파일 / 고유 대상 3개

`npx mintlify broken-links` 기준(2026-07-29). `ko/backup` 이동으로 새로 깨진 활성 링크 15건은 현재 통합 페이지로 교체했으며, 아래는 기존에 남아 있던 링크다.

| 깨진 경로                              | 건수 | 참조 파일                                | 정정 경로(안)                 |
| ---------------------------------- | -: | ------------------------------------ | ------------------------ |
| `/ko/skills`                       |  2 | agents-and-bots, default-agent-setup | `/ko/harness-and-skills` |
| `/ko/application-natural-language` |  1 | application-platform                 | `/ko/deploy-by-agents`   |
| `/api-playground/demo`             |  2 | license/license.mdx                  | Mintlify 템플릿 잔재 — 링크 제거  |

## 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개)

| 파일                               | 줄 수 |
| -------------------------------- | --: |
| ko/enterprise/ip.mdx             |  19 |
| ko/enterprise/branding.mdx       |  24 |
| ko/enterprise/global-mcp.mdx     |  30 |
| ko/enterprise/global-rag.mdx     |  30 |
| ko/self-hosted-model.mdx         |  33 |
| ko/enterprise/global-harness.mdx |  37 |

## 리드 Card 없음

활성 MDX 48개에는 리드 Card 누락이 없다. 백업 페이지는 공개 복원 시 검증한다.

## 기타

* **활성 문서 중복 h2 4건**: `Porter AI 운영 시스템에 등록`, `다음 단계`, `적용 범위 설정`, `채팅에서 사용하기`. 현재는 서로 다른 기능 페이지에서 같은 절차명을 사용하는 구조적 중복이다.
* **표기 불일치**: `## 채팅에서 사용하기` ↔ `## 채팅창에서 사용하기`가 혼재한다.
* `snippets/snippet-intro.mdx`: Mintlify 기본 예제이며 어디서도 사용하지 않는다.
* 레거시 이미지 URL `storage.googleapis.com/files.cloudtype.io` 13건은 `ko/backup/dev/`에만 남아 있다.
* `logo/-logo-light.svg`, `logo/-logo-dark.svg`: 파일명에 선행 하이픈이 붙은 미참조 잔재
* 다국어: `ko/` 단일 구성. `en/` 확장 시 디렉토리와 네비게이션 구조 재설계가 필요하다.