인수인계서 — 세션 48 (Android 개발 템플릿 저장소 초기 구축)
작성일: 2026-03-08 이전 세션: session47
작업 요약
F:\12_android_dev\에 Android/Kotlin/Compose 개발 템플릿 저장소 전체 구축. 00 general-pro의 5-레이어 모델을 Android 스택으로 적응하여 122개 파일 생성 + Git 초기 커밋 완료.
생성 파일 (122개 — 전부 F:\12_android_dev\ 하위)
| # | 카테고리 | 파일 수 | 설명 |
|---|---|---|---|
| 1 | 기반 | 12 | .gitignore, CLAUDE.md, docs/status+handover+logs |
| 2 | 01-android-dev-system/ | 26 | 개발 규칙 시스템 (아키텍처, 규칙, 템플릿, 8단계 가이드, 품질) |
| 3 | 02-reusable-code-android/ | 16 | 15카테고리 골격 README + 마스터 인덱스 |
| 4 | 02-reusable-design-android/ | 4 | Material 3 토큰, Compose 테마, 에셋 |
| 5 | 03-skills/ | 49 | 20개 스킬 (공유 9 + 적응 7 + 신규 4) |
| 6 | 04-agents/ | 7 | 7개 에이전트 (적응 5 + 신규 2) |
| 7 | docs/references/ | 5 | 아키텍처/Gradle/Compose/컴포넌트맵/ClaudeCode |
| 8 | docs/rules/ | 3 | 코딩 컨벤션, 스킬 컨벤션, 에이전트 컨벤션 |
상세 변경 사항
1. 5-레이어 모델 Android 적응
00 general-pro의 구조를 그대로 유지하되 기술 스택만 교체:
- TypeScript/React/Next.js → Kotlin/Compose/Jetpack
- npm/package.json → Gradle/build.gradle.kts
- Vitest/Playwright → JUnit 5/MockK/Turbine/Espresso
- Supabase → Room/Retrofit
- Zustand/React Query → ViewModel StateFlow/Hilt
2. 신규 Android 전용 스킬 (4개)
- kdygradle: Gradle 빌드 실패 진단, 버전 충돌 해결, Version Catalog 관리
- kdymanifest: AndroidManifest.xml 검증 (권한, exported, Intent Filter, 딥링크)
- kdyperf: 성능 프로파일링 (리컴포지션, 메모리, 시작 시간, 배터리)
- kdycompose: Compose 최적화 (@Stable/@Immutable, derivedStateOf, 람다 캡처)
3. 신규 Android 전용 에이전트 (2개)
- android-architect (sonnet): Clean Architecture + MVVM 레이어 검증
- compose-advisor (sonnet): Compose 리컴포지션 최적화, 상태관리, 성능
4. 동적 스택 감지
적응 스킬들의 Phase 0에서 build.gradle.kts 존재 여부로 Android 스택 감지. 하나의 스킬이 웹/Android 양쪽 모두 처리 가능.
검증 결과
- 파일 수: 122개 (목표 ~104 대비 초과 — 스킬 reference/phase 파일 풍부)
- Git 초기 커밋:
5475c79(122 files, 21,583 insertions) - CLAUDE.md: 20개 스킬 + 7개 에이전트 테이블 정합
터치하지 않은 영역
- 00 general-pro 전체: 이 프로젝트의 소스 파일은 일절 변경하지 않음
- 글로벌 스킬 동기화:
~/.claude/skills/에 12_android_dev 스킬 동기화 미수행 (향후/kdysync사용) - 실제 재사용 코드: 모든 카테고리가 골격(README)만 — 향후 프로젝트에서
/kdyextract로 축적
알려진 이슈
- 12_android_dev의 적응 스킬과 00 general-pro 원본 스킬이
~/.claude/skills/에서 동일 이름으로 충돌 가능 — Phase 0 동적 감지로 해결하나,/kdysync로 마지막 동기화된 버전이 글로벌에 반영됨 - 12_android_dev CLAUDE.md의
kdy스킬 이미지 경로가 안드로이드용이므로 글로벌 CLAUDE.md에서는 프로젝트별 분기 필요
다음 작업 제안
- 12_android_dev에서
/kdyupdate실행하여 CLAUDE.md 카탈로그 정합 검증 - 12_android_dev에서
/inception실행하여 _COMPONENT_MAP.md 의존성 맵 검증 - 실제 Android 프로젝트에서
/kdysetting실전 테스트 (01-android-dev-system 템플릿 적용) - 00 general-pro ↔ 12_android_dev 공유 스킬 동기화 전략 수립