Swift 개발 단계에 맞춰 적응하는 Claude 워크플로

핵심 요약

1. SwiftFlow는 개발 단계에 따라 Claude에 필요한 지침, 도구, skill을 자동으로 제공하는 상태 머신 기반 도구다.
2. 세션마다 반복되는 지침 입력과 skill 호출을 줄이고, 새 세션에서도 작업 흐름을 다시 설정해야 하는 문제를 해결하려 한다.
3. 작성자는 SwiftFlow의 구성 방식을 공유하기 위해 워크숍을 열고, 참가자가 직접 시스템을 만들 수 있도록 starter kit을 제공한다.

도입

Swift 앱을 코딩 에이전트와 개발할 때는 기능 계획, 코드 작성, 테스트, 변경 사항 커밋 등 단계마다 필요한 도구와 지침이 달라진다. 작성자는 에이전트가 현재 따르는 규칙과 사용 가능한 도구를 파악하고, 세션이 바뀔 때마다 지침을 되풀이하는 문제를 경험했다. 이를 줄이기 위해 Claude 설정을 정리하고 SwiftFlow를 만들었다.

상세 요약

세션마다 반복되는 설정

작성자는 지난 몇 달 동안 소프트웨어 개발용 Claude 모델을 사용하며 Swift 개발 워크플로를 조금씩 바꿨다. 각 세션에서 얻은 결과가 다음 세션에 다시 필요하지 않도록 Swift 개발 도구, 앱, skill을 만들었다. Claude를 당분간 주력 harness로 선택한 뒤에는 자신의 흐름에 맞게 설정을 정리했다. 필요한 규칙과 skill을 검토하고, Claude가 생성한 불필요한 파일을 관리하는 방식도 고민했다.

작성자는 시뮬레이터를 MacBook Pro에서 실행하지 않도록 가상 Mac mini를 임대했다. Claude mods를 직접 만드는 방법도 익혔다. 이 설정 개선 경험이 SwiftFlow를 구축하는 바탕이 됐다.

SwiftFlow의 단계별 구성

Swift 개발에서 코딩 에이전트는 기능 계획부터 코드 작성, 테스트, 커밋까지 각 단계에 맞는 도구와 지침을 필요로 한다. 하지만 에이전트가 어떤 규칙을 적용하고 있는지, 컨텍스트에 무엇이 남아 있는지, 어떤 도구를 쓰는지 확인하기 어렵다. 사용자는 skill을 반복 호출하고 지침을 다시 전달하며 작업을 추적하게 된다. 새 세션을 시작하면 이 과정을 다시 해야 한다.

SwiftFlow는 이 문제를 상태 머신 방식으로 다룬다. 모든 내용을 처음부터 컨텍스트에 넣고 에이전트가 기억하기를 기대하는 대신, 개발 단계에 맞는 지침·도구·skill을 Claude에 자동으로 제공한다. 작성자는 SwiftFlow를 단순한 도구라기보다 시스템을 구성하는 방식으로 설명한다. 블로그 글이나 기본 도구만으로 전체 설정 과정을 전달하기에는 복잡하다고 판단해 워크숍을 선택했다.

Claude의 skill과 플러그인 구성을 정리하는 사례는 Claude Skills와 플러그인 구성을 정리하는 방법에서도 다룬다. 시뮬레이터 대신 다른 방식으로 SwiftUI 결과를 확인하는 사례는 Claude Code에서 시뮬레이터 실행 없이 Xcode Preview로 SwiftUI 개발하기에서 확인할 수 있다.

워크숍과 제공 자료

작성자는 첫 워크숍을 11월 2일 금요일 오전 11시(EST)에 진행한다고 안내한다. 목표는 참가자가 자신에게 맞는 에이전트 개발 시스템을 직접 구성하도록 돕는 것이다. 참가자는 SwiftFlow starter kit을 받아 처음부터 모든 요소를 만들지 않고 설정을 시작할 수 있다.

워크숍은 완성된 SwiftFlow를 그대로 배포하는 자리가 아니라, 시스템을 설계하고 설정하는 각 단계를 설명하고 함께 살펴보는 방식으로 소개됐다. 원문은 참가 신청을 안내하지만, 신청 링크의 주소나 추가 워크숍 정보는 본문에 포함되어 있지 않다.

결론

SwiftFlow의 핵심은 모든 지침과 도구를 한꺼번에 제공하는 대신, 개발 단계에 맞춰 Claude가 사용할 지침·도구·skill을 전환하는 것이다. 작성자는 이를 완성된 도구로 공개하는 대신, 참가자가 자신의 작업 방식에 맞는 시스템을 구성하는 워크숍을 진행한다. 참가자에게는 처음부터 시작하지 않도록 SwiftFlow starter kit을 제공한다.