ONEDEV

SwiftAgents

twostraws파일 2개

★ 1,458주당 +9조회 4

무엇인가

SwiftAgents는 Swift 및 SwiftUI 코드베이스에서 LLM을 쓰는 개발자를 위해 작성된 AGENTS.md 규칙 파일이다. 규율하는 문제 영역은 AI가 생성한 Swift 코드의 품질이다. 코드가 컴파일되는지 여부가 아니라, 관용적이지 않은 API 선택과 반복적으로 나타나는 실수를 사전에 차단하는 데 초점을 둔다.

어떻게 동작하나

형식은 단일 AGENTS.md 파일이다. 별도의 훅이나 슬래시 명령이 아니라, 에이전트가 프로젝트 규칙 파일을 읽는 통상 경로를 통해 자동으로 로드된다. 규칙 내용은 새 API 사용을 강하게 전제하며, iOS 26 이상을 타깃으로 삼는다. 저장소 설명과 README 모두 이 파일 하나를 배포 단위로 삼는다.

무엇과 다른가

프롬프트를 매번 직접 작성하는 방식과 다르다. 규칙이 대화 턴이 아니라 저장소 안에 상주하므로, 같은 지시를 반복해서 붙여 넣을 필요가 없고 프로젝트 단위로 버전 관리된다. CLAUDE.md처럼 특정 도구 전용 규칙 파일에 묶이지 않고 AGENTS.md 형식을 쓰기 때문에, 이 형식을 읽는 여러 코딩 에이전트가 같은 규칙을 공유한다.

어떻게 쓰나

사용은 저장소의 AGENTS.md를 자신의 Swift·SwiftUI 프로젝트에 두는 것으로 시작한다. README는 별도의 설치 명령이나 패키지 매니저 절차를 제시하지 않는다. 파일을 배치한 뒤 에이전트에게 Swift 코드 작업을 맡기면 규칙이 적용된다. 프로젝트에 맞게 규칙을 고쳐 쓰는 것이 전제로 깔려 있으며, 저장소는 PR을 통한 기여를 받는다.

전제와 한계

전제와 한계가 명확하다. 규칙이 iOS 26 이상의 신규 API를 강하게 전제하므로, 그보다 낮은 iOS 버전이나 다른 Apple 플랫폼을 지원해야 하는 프로젝트에서는 규칙을 조정해야 한다. README는 이 조정이 필요하다고 명시하며, 구버전 호환을 위한 별도 규칙 세트를 제공하지 않는다. AGENTS.md를 규칙 파일로 읽지 않는 에이전트에서는 이 파일이 자동 적용되지 않는다.

관련 논문 1

유사 스킬