write-docs

아래 주제에 대한 VitePress 문서 페이지를 작성한다: $ARGUMENTS

사전 준비

작성 전 아래 파일을 반드시 읽는다:

• docs/AGENTS.md — VitePress 코드블럭 규칙, CSS 주의사항
• docs/.vitepress/config.ts — 현재 사이드바 구조 파악

---

작성 규칙

언어

KO가 소스 언어다. 항상 KO를 먼저 작성하고, EN은 KO에서 번역한다. 두 버전의 내용·구조·섹션이 일치해야 한다. 한쪽에만 있는 섹션을 만들지 않는다.

한국어 작성 원칙

• 완전한 문장으로 쓴다. "수동 업로드 없이."처럼 조각 문장을 독립 문장으로 쓰지 않는다. 앞 문장에 이어 쓰거나 부사절로 처리한다.
• 자연스러운 어순: 주어 → 부사어 → 서술어 순서를 따른다. "CI에서 빌드를 올리면 팀원 전체가 App Center에서 바로 확인할 수 있습니다." ✅ "팀원 전체가 별도 설치 없이 확인할 수 있습니다. Xcode 없이." ❌
• 독자는 이미 tapflow 사용자다. tapflow가 무엇인지, 왜 쓰는지 다시 설명하지 않는다. 이 페이지에서 달라지는 것만 말한다.
• "QA팀" 대신 "팀원", "팀 전체"를 쓴다. tapflow는 QA만이 아니라 PO, PM, 디자이너, 백엔드 모두가 사용한다.

영어 작성 원칙

• Em dash 뒤 단문 처리(— no manual uploads)는 영어에서 자연스럽다. 허용.
• 한국어에서 조각 문장으로 쓰면 안 되는 표현도 영어 em dash 패턴으로는 쓸 수 있다.
• 독자 컨텍스트는 KO와 동일 — 이미 tapflow를 아는 사용자.

플랫폼 중립 언어

iOS/Android 양쪽 지원 기능을 다룰 때 특정 플랫폼 도구명을 쓰지 않는다.

❌	✅
Xcode, Xcode 설치, no Xcode	IDE, 별도 도구 설치, no IDE
Android Studio	개발 환경, IDE
xcodebuild	(iOS 전용 섹션에서만 허용)

예외: 해당 섹션이 실제로 iOS 전용 또는 Android 전용인 경우 플랫폼명 명시 가능.

tapflow 두 가지 테스트 모드

문서가 수동 테스트를 다룰 때, AI Agent 경로를 별도 기능으로 명확히 구분한다.

::: info Two testing paths
This guide covers the **manual review path**: CI delivers the build; people do the testing.

For automated testing where an LLM agent controls the simulator, see [MCP in CI/CD](/guide/mcp-ci). That is a separate, experimental feature.
:::

KO:

::: info 두 가지 테스트 경로
이 가이드는 **수동 리뷰 경로**를 다룹니다. CI가 빌드를 전달하고, 팀원이 직접 테스트하는 방식입니다.

LLM 에이전트가 시뮬레이터를 자동으로 조작하는 방식은 [CI/CD에서 MCP 활용](/ko/guide/mcp-ci)을 참고하세요. 이는 별도의 실험적 기능입니다.
:::

빌드 상태 표현

Status	EN	KO
Done	Stakeholders approved	이해관계자 승인 완료
Rejected	Issues found, needs fixes	문제 발견, 수정 필요
In Progress	Ready for review	리뷰 준비 완료
Backlog	Not yet ready	준비 전

VitePress 코드블럭 규칙 (docs/AGENTS.md 요약)

• sh/bash 블럭에 <placeholder> 쓰지 않는다 — shiki가 HTML 태그로 파싱해 색이 깨진다. 플레이스홀더는 테이블 셀 인라인 코드로만 표기한다.
• 섹션 구분에 --- 쓰지 않는다 — h2 border-top이 이미 구분선 역할을 한다.