| name | apple-craft |
| description | Apple 플랫폼 개발을 돕습니다. Swift, SwiftUI, UIKit, AppKit, Xcode 빌드/프리뷰/디버깅, 최신 Apple API 참조가 필요할 때 사용하고 장기 오케스트레이션은 apple-harness로 넘깁니다. |
Apple Craft
원본 apple-craft 플러그인의 Codex 버전입니다. Xcode 도구와 번들 reference docs를 함께 사용합니다.
When to use
- Swift/SwiftUI/UIKit/AppKit의 소규모~중간 규모 구현·수정·트러블슈팅이 필요할 때
- Xcode 빌드/프리뷰/진단과 Apple API 참조를 함께 봐야 할 때
- 장기 오케스트레이션 없이 한 세션 또는 짧은 루프로 해결할 수 있을 때
Do not use when
- 처음부터 끝까지 여러 라운드로 기능을 밀어야 하는 장기 작업 →
apple-harness
- 구현보다 코드/PR 리뷰가 주목적인 작업 →
apple-review
- Apple 플랫폼과 무관한 일반 개발 작업
Quick start
- 작업을
implement / explore / troubleshoot로 구분한다.
- 프로젝트 구조와 현재 문제 범위를 먼저 확인한다.
- 필요한 Apple 문서와 reference를 최소량만 읽는다.
- 수정 후 가능하면 빌드·프리뷰·diagnostics로 검증한다.
Knowledge priority
DocumentationSearch 같은 공식 도구 결과references/에 있는 번들 Apple 문서- 현재 프로젝트 코드와 빌드 로그
- 일반 모델 기억
Use references
references/_index.mdreferences/common-mistakes.mdreferences/code-style.md- 필요한 프레임워크별 문서 한두 개만 추가 로드
Workflow
- 작업 유형을 구분한다:
implement, explore, troubleshoot.
- Xcode 프로젝트/패키지 구조와 현재 문제 범위를 먼저 확인한다.
- 관련 reference doc과 공식 검색 결과를 최소한만 읽는다.
- 구현·설명·수정 작업을 수행한다.
- 가능하면
XcodeRefreshCodeIssuesInFile, BuildProject, GetBuildLog, RenderPreview로 검증한다.
- 리뷰 중심 작업은
apple-review, 장기 루프는 apple-harness를 사용한다.
Scripts
scripts/preflight.sh — 참조 문서 존재 확인scripts/sync-docs.sh — Xcode 번들 문서를 로컬 reference로 동기화
Review Harness
- mode: optional
- 공통 기준:
../../../docs/review-harness.md
- generator: 구현·수정·설명 작업을 수행한다
- evaluator:
apple-review와 BuildProject / RenderPreview / diagnostics 결과로 skeptical pass를 수행한다
- 평가축: buildability, API 사용 정확성, lifecycle/concurrency 안정성, UI 검증 가능성
- artifacts/evidence: build log, preview screenshot, issue navigator, 수정 파일 목록
- pass condition: 관련 Apple API/수명주기/동시성 리스크가 설명 가능하고, 가능하면 빌드·프리뷰 증거가 확보돼야 한다
- 자동 다음 행동:
pass면 종료, refine이면 최소 수정 후 재빌드, pivot이면 구현 전략 변경, escalate면 apple-review 또는 장기 작업이면 apple-harness로 넘긴다
Output expectation
- 읽은 reference 문서
- 적용/수정 내용
- 빌드·프리뷰·진단 결과
