apple-craft

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

1. 작업을 implement / explore / troubleshoot로 구분한다.
2. 프로젝트 구조와 현재 문제 범위를 먼저 확인한다.
3. 필요한 Apple 문서와 reference를 최소량만 읽는다.
4. 수정 후 가능하면 빌드·프리뷰·diagnostics로 검증한다.

Knowledge priority

1. DocumentationSearch 같은 공식 도구 결과
2. references/에 있는 번들 Apple 문서
3. 현재 프로젝트 코드와 빌드 로그
4. 일반 모델 기억

Use references

• references/_index.md
• references/common-mistakes.md
• references/code-style.md
• 필요한 프레임워크별 문서 한두 개만 추가 로드

Workflow

1. 작업 유형을 구분한다: implement, explore, troubleshoot.
2. Xcode 프로젝트/패키지 구조와 현재 문제 범위를 먼저 확인한다.
3. 관련 reference doc과 공식 검색 결과를 최소한만 읽는다.
4. 구현·설명·수정 작업을 수행한다.
5. 가능하면 XcodeRefreshCodeIssuesInFile, BuildProject, GetBuildLog, RenderPreview로 검증한다.
6. 리뷰 중심 작업은 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 문서
• 적용/수정 내용
• 빌드·프리뷰·진단 결과