> ## 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.

# Templates

# 페이지 유형별 템플릿

실제 저장소 페이지(ko/introduction, ko/harness-and-skills, ko/quickstart)의 구조를 골격화한 템플릿.
`{{ }}` 자리는 채우고, `{/* */}` 주석은 작성 후 삭제한다.

## 1. 마케팅형 (도입 판단 그룹)

`ko/introduction.mdx` / `ko/security.mdx` 골격. 주 독자: 도입 의사결정자.
(루트의 동명 `introduction.mdx` 는 Mintlify 템플릿 잔재이므로 참고하지 않는다.)

```mdx theme={null}
---
title: '{{제품 관점의 제목}}'
description: '{{독자가 얻는 가치를 한 문장으로}}'
icon: '{{아이콘}}'
---

<Card title="{{개념}}이란?">
  {{Porter AI 관점에서 이 주제를 한두 문장으로 정의. 핵심 차별점과 연결.}}
</Card>

## {{독자의 문제}}

{/* 개인용 AI 도구·기존 방식의 한계를 독자의 언어로 서술. 과장 금지, 구체적 상황 */}

<Steps>
  <Step title="{{문제 상황 1}}">
    {{왜 이것이 기업에서 문제가 되는지 2~3문장}}
  </Step>
  <Step title="{{문제 상황 2}}">
    {{...}}
  </Step>
</Steps>

## Porter AI가 해결하는 방식

{{해결 접근을 한 문단으로. 사용자/관리자 관점 구분}}

<CardGroup cols={2}>
  <Card title="{{기능명}}" icon="{{아이콘}}" href="/ko/{{페이지}}">
    {{이 기능이 위 문제를 어떻게 푸는지 2~3문장}}
  </Card>
  {/* 기능 카드 반복 — 반드시 상세 페이지로 href 연결 */}
</CardGroup>

<Note>
{{엔터프라이즈 관련 안내가 있으면 여기에 + 관련 페이지 링크}}
</Note>

## 다음 단계

<Steps>
  <Step title="{{여정의 다음 단계}}">
    [{{페이지명}}](/ko/{{경로}})를 확인해 {{무엇을 검토/확인}}합니다.
  </Step>
</Steps>
```

## 2. 기능 가이드형 (대부분의 페이지)

`ko/harness-and-skills.mdx` / `ko/mcp.mdx` 골격. 주 독자: 일반 사용자 또는 개발자 (1명 정해서 유지).

```mdx theme={null}
---
title: '{{기능명 + 목적}}'          # 예: 'Skills로 업무 자동화'
description: '{{무엇을 안내하는지}}를 안내합니다.'
icon: '{{아이콘}}'
---

<Card>
  {{기능을 한두 문장으로 정의. 무엇이고, 언제 쓰는가}}
</Card>

<AccordionGroup>
  <Accordion title="{{이 기능의 조직 차원 가치를 한 문장으로}}" defaultOpen={true}>
    {/* 핵심 차별점과 연결되는 부가 설명. 필요 시 내부에 AccordionGroup 1단 더 (최대 2단) */}
    {{...}}
  </Accordion>
</AccordionGroup>

## {{동작 1: ~하기}}

<Frame>
  <img className="block rounded-md" src="{{files.cloudtype.io URL}}" />
</Frame>

> `{{메뉴 > 경로}}` 페이지에서 {{동작을 한 문장으로}}.

<Tip>
{{대안 방법이나 알아두면 좋은 것}}
</Tip>

## {{동작 2: ~하기}}

{/* 동작 단위로 h2 반복. 각 h2 는 스크린샷(Frame) + 인용구 캡션 구성 */}

<Info>
{{엔터프라이즈 전용 확장이 있으면 안내 + [관련 페이지](/ko/{{경로}}) 링크}}
</Info>
```

## 3. 튜토리얼형 (quickstart 류, 배포 예제)

`ko/quickstart.mdx` 골격. 주 독자: 처음 써보는 사용자/개발자.

```mdx theme={null}
---
title: '{{시나리오 제목}}'           # 예: '빠른 시작'
description: '{{어떤 시나리오를 안내하는지}}를 안내합니다.'
icon: 'circle-play'
---

<Card>
  {{이 튜토리얼에서 무엇을 해보는지 + 완료하면 무엇이 되는지 한두 문장}}
</Card>

{/* 전제 조건이 있으면 여기에 Note 로 명시 */}

## {{시나리오 1}}

<Steps>
  <Step title="{{단계명 (명사형: ~하기, ~진입)}}">
  <Frame>
    <img className="block rounded-md" src="{{스크린샷 URL}}" />
  </Frame>
  `{{메뉴 > 경로}}` 페이지에서 {{동작}}합니다.
  <Note>
  {{한도·제약이 있으면 여기에}}
  </Note>
  </Step>

  <Step title="{{다음 단계}}">
  {/* 모든 Step 에 스크린샷 또는 video 필수 */}
  {{...}}
  </Step>

  <Step title="{{결과 확인 단계 — 반드시 포함}}">
  {{완료 후 무엇이 보이는지/무엇을 할 수 있는지}}
  </Step>
</Steps>

<Tip>
{{다음으로 확장할 수 있는 것 + 관련 페이지 링크}}
</Tip>
```

## 4. 레퍼런스형 (모델 연동, CLI, 옵션 나열)

주 독자: 개발자/AI 전문가.

```mdx theme={null}
---
title: '{{대상 이름}}'               # 예: 'AWS Bedrock'
description: '{{무엇을 등록/설정하는 방법}}을 안내합니다.'
icon: '{{아이콘}}'
---

<Card>
  {{이 대상이 무엇이고 Porter AI 에서 어떤 역할인지 한 문장}}
</Card>

## {{설정 항목/옵션}}

<table>
  <thead>
    <tr><th>항목</th><th>설명</th><th>필수 여부</th></tr>
  </thead>
  <tbody>
    <tr><td>{{항목}}</td><td>{{설명}}</td><td>{{필수/선택}}</td></tr>
  </tbody>
</table>

## {{절차가 필요하면: ~하기}}

<Steps>
  <Step title="{{단계}}">
  {{...}}
  </Step>
</Steps>

<Note>
{{규격·호환성 제약 (예: Chat Completions 규격 지원)}}
</Note>
```