Duology: iPhone Duo 폴더블 앱 개발을 위한 Claude Code skills

누구에게 적합한가

• Mac(Apple silicon)에서 Claude Code로 iPhone Duo 폴더블 앱을 개발하는 개발자. 공식은 Duology를 "iPhone Duo에서 앱을 설계·빌드·테스트·출시하기 위한" Claude Code skills 모음으로 위치시키며, duology 플러그인 형태로 배포합니다. 내용은 네 영역을 다룹니다: layout patterns(폴더블 레이아웃 패턴), app recipes(앱 레시피), fold linter, pose checks(포즈 검사). 이는 공식이 말하는 설계·빌드·테스트·출시 흐름을 지원합니다. UI를 iPhone Duo의 폴더블 폼팩터에 맞추는 일이 당신의 작업이라면, 이 skills가 겨냥하는 것이 바로 그 작업입니다. 앱 개발 프로세스용 도구 모음이지 범용 문장 검사기나 글쓰기 도우미가 아닙니다.
• 환경 전제는 세 가지입니다: Apple silicon Mac, Xcode 27.1(27A9275 이상), Claude Code. 공식이 나열한 요건은 이 세 항목뿐이며, 하나라도 빠졌을 때 사용 가능한지는 설명이 없으므로 미확인으로 취급해야 합니다.
• Cursor, Codex, Copilot, Gemini CLI 등을 주 클라이언트로 쓰는 사용자: 공식은 이런 환경을 skills only로 표기합니다. 즉 skills 자체만 설치되며, 슬래시 명령과 lint hook은 Claude Code 기능이고 설치 경로도 다릅니다. 이런 클라이언트에서 skills가 어떤 작업을 수행할 수 있는지는 공식 설명이 없고, 클라이언트에서 해당 검사를 실행하지 못할 때의 대안도 제시되어 있지 않습니다.
• iPhone Duo 외 기기에 적용되는지, 자연어나 주석 언어 지원 범위가 어디까지인지 공식은 모두 밝히지 않았습니다. 이 두 가지를 임의로 가정하지 마세요.

3분 만에 첫 실행 해보기

주 경로는 하나뿐입니다. Claude Code의 플러그인 마켓플레이스(공식이 명시한 기본 설치 경로)에서 duology를 설치한 뒤, 앱에 대해 폴더블 디자인 검사를 한 번 실행하는 것입니다.

전제: Apple silicon Mac에 Xcode 27.1(27A9275 이상)과 Claude Code를 설치하고, 검사할 iPhone Duo 앱 프로젝트를 준비해 둡니다.

1. Claude Code 세션에서 공식 명령 두 개를 순서대로 실행합니다: /plugin marketplace add Kimeur/duology로 마켓플레이스를 추가하고, /plugin install duology@duology로 duology 플러그인을 설치합니다. duology는 공식이 가장 먼저 설치하길 권하는 플러그인입니다.
2. 설치가 끝나면 같은 세션에서 agent에게 앱의 폴더블 디자인 검사를 요청합니다. 공식 설명에 따르면 이 검사는 duo-lint와 15포인트 체크리스트(15-point checklist)를 실행합니다.
3. 성공 신호를 확인합니다: agent가 수정이 필요한 항목 목록을 돌려주며, 공식 표현대로 "고쳐야 할 내용을 가장 심각한 것부터 나열"합니다. 설치 확인만 돌아오고 항목 목록이 없다면 검사가 실제로 실행되지 않은 것이므로 작업을 다시 시작하세요.

실행 전 유의: 공식의 설명은 duo-lint와 15포인트 체크리스트를 실행하고 수정 항목을 나열하는 것까지입니다. 파일을 읽고 쓰는지, 명령을 실행하는지, 네트워크에 접근하는지는 밝혀져 있지 않습니다. 첫 실행에서는 agent의 실제 동작을 지켜보고, 출력이 예상과 맞는지 확인한 뒤 진행하세요.

사용 사례

사례 1: 대규모 변경 후 폴더블 레이아웃 점검. 상황: 앱의 iPhone Duo 대응 작업을 한 차례 마쳤고, 지금 가장 심각한 문제가 무엇이고 무엇부터 고칠지 알고 싶습니다. 시작: Claude Code에서 agent에게 앱의 폴더블 디자인 검사를 요청합니다. 공식 설명상 검사 대상은 당신의 앱입니다. 실제 워크플로: 검사는 duo-lint와 15포인트 체크리스트를 실행합니다. 기대 결과: 심각도가 높은 순으로 정렬된 수정 항목 목록이 나오므로 순서대로 하나씩 처리할 수 있습니다. 항목 수, 구체적인 형식, 수정 코드 동반 여부는 공식 설명이 없고, 목록을 받은 뒤 항목별로 수정을 진행하는 공식 절차도 없습니다. 사례 2: Claude Code가 아닌 클라이언트에 도입. 상황: 평소 Cursor, Codex, Copilot, Gemini CLI 중 하나로 작업하며 이 skills를 곁에 두고 쓰고 싶습니다. 시작: 해당 환경에서 npx skills add Kimeur/duology를 실행합니다. 실제 워크플로: 공식이 skills only라고 표기한 설치 방식, 즉 skills 자체만 설치됩니다. 기대 결과: 공식 설명대로 CLI는 agent가 찾는 위치에 skills를 배치합니다. 확인할 수 있는 것은 설치까지이며, 이후 어떤 작업을 실행할 수 있는지, 결과가 Claude Code와 같은지는 자신의 클라이언트에서 검증해야 합니다. skills가 기대대로 동작하지 않으면 먼저 Claude Code 주 경로로 돌아가 기능 자체가 정상인지 확인하세요.

사용 범위와 한계

• 플랫폼 차이는 분리해서 다뤄야 합니다: 플러그인 마켓플레이스는 Claude Code의 설치 접점이고, 위 두 명령은 슬래시 명령으로 Claude Code 안에서 실행됩니다. Cursor, Codex, Copilot, Gemini CLI 등은 npx skills add Kimeur/duology를 사용하며 skills only입니다. 후자를 마켓플레이스 설치로 여기거나, 두 경로의 능력이 같다고 가정하지 마세요.
• 부작용과 확인 지점: 검사가 파일을 수정하는지, 명령을 실행하는지, 네트워크에 접근하는지 공식은 밝히지 않았고, 확인 지점에 대한 공식 설명도 없습니다. 둘 다 미확인 정보이므로 실행 전에는 첫 실행 유의사항을 따르세요.
• 의존 관계: duology-recipes와 duology-ship은 duology에 의존하며, duology가 /duo-doctor를 제공합니다. duology-design과 duology-features는 단독 설치가 가능하지만 그 skills가 duology의 skills(duo-layout, duo-continuity, duo-scenes)를 가리키므로, 공식 권고대로 duology를 먼저 설치하세요.
• 실행 환경: skills는 iPhone Duo 폴더블 위의 앱 개발을 대상으로 합니다. 시뮬레이터와 실제 기기의 차이, 특정 Xcode 프로젝트 구조에 대한 요건은 공식 설명이 없습니다.
• 버전: 공식은 Xcode 27.1(27A9275 or later)이라고 명시했습니다. 즉 27A9275가 최소 요건이며, 이후 변경은 공식 페이지를 확인하세요.
• 아직 미확인인 핵심 정보: /duo-doctor의 구체적 기능, 각 skill과 확장 플러그인의 용도·실행 방식, iPhone Duo 외 기기 지원 여부, 검사 출력의 상세 형식은 공식 페이지에 모두 없습니다. 공식이 보완하기 전까지는 어느 항목도 지원되는 것으로 취급하지 마세요.