android-clean-architecture

android-clean-architecture 스킬 개요

android-clean-architecture 스킬은 Android와 Kotlin Multiplatform 앱을 즉흥적인 기능 코드가 아니라 깔끔한 경계 중심으로 설계하도록 도와줍니다. 모듈 구성, 의존성 규칙, UseCase, Repository, 데이터 레이어 설계에 대한 실용적인 출발점이 필요한 엔지니어에게 특히 잘 맞습니다. 막연한 이론 강의가 아니라 실제로 구조를 잡아야 할 때 유용합니다.

이 스킬이 필요한 경우

android-clean-architecture는 로직을 어디에 둘지, 모듈이 서로 어떻게 의존해야 하는지, UI·도메인·데이터 관심사가 한 레이어로 무너지는 것을 어떻게 막을지 판단할 때 사용하세요. 새 코드베이스의 기준 구조를 세우거나, 성장한 앱을 리팩터링할 때 특히 효과적입니다.

가장 잘 맞는 사용자

이 android-clean-architecture 스킬은 Android 앱, KMP 공유 코드, 또는 Compose 기반 제품을 만들고 있는데 이미 결합도가 너무 높아진 팀에 잘 맞습니다. 기능별 모듈, 계층형 모듈, 또는 더 단순한 단일 모듈 구조를 두고도 경계를 깔끔하게 유지할지 고민할 때도 유용합니다.

핵심 차별점

막연한 아키텍처 프롬프트와 달리 android-clean-architecture는 모듈 레이아웃, 허용되는 의존성, Repository 배치, 그리고 Room, SQLDelight, Ktor, Koin, Hilt 연동 위치처럼 구체적인 구조에 초점을 맞춥니다. 그래서 과설계나 의도치 않은 레이어 누수를 피하려는 상황에서 훨씬 결정에 도움이 됩니다.

android-clean-architecture 스킬 사용 방법

설치하고 활성화하기

스킬 관리자에서 android-clean-architecture 설치 흐름을 실행한 뒤, 스킬 파일을 열어 아키텍처를 설계하거나 수정하는 동안 참조 범위 안에 두세요. 환경이 경로 로딩을 지원한다면 skills/android-clean-architecture/SKILL.md를 가리키면 작업 중 아키텍처 규칙을 모델이 따라가기 쉽습니다.

구체적인 아키텍처 작업을 맡기기

android-clean-architecture 사용은 모듈 분해, 의존성 매핑, 레이어 배치처럼 구체적인 결과를 요청할 때 가장 잘 작동합니다. 입력에는 플랫폼, 현재 스택, 제약 조건을 명확히 적는 것이 좋습니다.

예시 프롬프트 형태:

• “Compose + Hilt 앱에 오프라인 동기화가 있는 android-clean-architecture 모듈 레이아웃을 설계해줘.”
• “Android에서는 Room, 공유 코드에서는 SQLDelight를 사용해서 이 KMP 기능을 android-clean-architecture 레이어로 리팩터링해줘.”
• “이 모듈들을 검토하고 의존성 규칙 위반을 짚어줘.”

먼저 봐야 할 부분 읽기

SKILL.md부터 시작한 뒤, 활성화 기준, 권장 레이아웃, 의존성 규칙을 정의한 섹션에 집중하세요. 실제 구현 선택에 직접 영향을 주는 부분이기 때문입니다. 저장소에 이 파일 하나만 있다면 그 섹션들을 정답 기준으로 보고, 자신의 패키지명과 빌드 설정에 맞게 적용하세요.

결과 품질을 높이는 입력 주기

이미 존재하는 요소를 짧게 정리해서 알려주세요. 예를 들면 모듈, 영속성 도구, DI 프레임워크, 네트워크 스택, 그리고 앱이 Android 전용인지 KMP인지 같은 정보입니다. 또한 기존 기능 경계나 공개 API처럼 반드시 보존해야 하는 것도 함께 적으세요. 현재 상태를 구체적으로 줄수록 android-clean-architecture 가이드는 불필요한 레이어를 만들어낼 가능성이 낮아집니다.

android-clean-architecture 스킬 FAQ

android-clean-architecture는 새 프로젝트에만 적합한가요?

아닙니다. android-clean-architecture 스킬은 신규 구축과 리팩터링 모두에 유용합니다. 특히 이미 복잡해진 앱에 경계를 다시 세워야 할 때 강점이 큽니다. 한 번에 전부 다시 쓰지 않고도 무엇을 옮길지 판단하는 데 도움을 주기 때문입니다.

일반 프롬프트와 무엇이 다른가요?

일반 프롬프트로도 계층형 아키텍처를 요청할 수는 있지만, android-clean-architecture는 Android와 KMP 의사결정에 맞춘 집중된 구조를 제공합니다. 그만큼 의존성 방향, 모듈 명명, 데이터 소스와 Repository 코드 배치에 대해 더 실질적인 가이드를 얻을 수 있습니다.

초보자에게도 친화적인가요?

구체적인 모듈 맵을 기준으로 작업할 의향이 있다면 그렇습니다. 반대로 구현 디테일 없는 고수준의 Clean Architecture 설명만 원한다면 덜 적합합니다. 초보자일수록 복잡한 구조보다 단순하고 명시적인 구조를 검증하는 용도로 쓸 때 가장 큰 가치를 얻습니다.

언제 쓰지 않는 게 좋나요?

앱이 아주 작거나, 팀이 의도적으로 계층형 아키텍처를 피하고 있거나, 모듈 설계 없이 빠른 기능 구현만 필요하다면 android-clean-architecture를 쓰지 않는 편이 좋습니다. 그런 경우에는 이 스킬이 필요 이상의 구조를 더할 수 있습니다.

android-clean-architecture 스킬 개선 방법

필요한 아키텍처 결정을 하나로 좁혀 말하기

android-clean-architecture 결과를 가장 빠르게 개선하는 방법은 한 번에 하나의 결정을 요청하는 것입니다. 예를 들면 모듈 경계, 의존성 그래프, 데이터 흐름, DI 연결 방식처럼요. “최고의 아키텍처”를 묻는 것보다 “이 KMP 저장소 구성에서 캐싱은 어디에 두는 게 맞나?”처럼 묻는 편이 훨씬 유용한 결과로 이어집니다.

실제 제약 조건을 정확히 알려주기

중요한 스택과 제한을 함께 적으세요. Android 전용인지 KMP인지, Compose인지 XML인지, Room인지 SQLDelight인지, Ktor인지 Retrofit인지, Hilt인지 Koin인지, 그리고 오프라인 우선이 필요한지도 포함해야 합니다. 이런 정보가 있어야 추천 구조가 달라지고, android-clean-architecture 가이드가 잘못된 백엔드나 저장 방식에 맞춰 과적합되는 일을 막을 수 있습니다.

자주 생기는 실패 패턴을 주의하기

가장 흔한 실수는 각 기능이 저마다 작은 아키텍처를 따로 갖게 두고 공통 규칙은 두지 않는 것입니다. 또 하나는 그 순간 빠르다는 이유로 비즈니스 로직을 프레젠테이션 코드에 넣는 것입니다. 이 스킬로 경계를 초기에 점검한 다음, 실제 패키지 트리와 빌드 파일에 맞춰 결과를 다시 다듬으세요.

저장소 구조에 맞춘 후속 질문으로 반복하기

첫 결과를 받은 뒤에는 현재 트리를 기준으로 의존성 감사나 파일별 배치 계획을 요청하세요. 예를 들어: “이 기존 패키지들을 android-clean-architecture 레이아웃에 매핑하고, domain이나 data로 옮겨야 할 항목을 표시해줘.” 이런 후속 질문을 하면 스킬이 개념 설명을 넘어 마이그레이션 도구로 바뀝니다.