- name
- faktum-android
- description
- Faktum News Android 앱 개발 세션. Google 공식 Android CLI(
~/bin/android) + 공식 Skills(android-cli, navigation-3, edge-to-edge)를 조합해 Kotlin + Jetpack Compose로 모바일 앱을 만든다. "안드로이드 앱 만들어", "팩툼 앱", "모바일 앱", "android 앱", "faktum 앱", "앱 만들자" 등 한국어 트리거로 발동. Faktum 웹(Next.js 16, 포트 3099)의 SQLite/FTS5 API를 백엔드로 재사용.
Faktum Android App 개발
1. 필독 컨텍스트 (작업 시작 시 순서대로 Read)
~/Documents/ntriq-vault/wiki/decisions/2026-04-19-android-cli-채택.md— 도입 결정/스택~/Documents/ntriq-vault/wiki/tools/android-cli.md— CLI 사용법·커맨드 레퍼런스~/Documents/ntriq-vault/wiki/decisions/2026-04-18-faktum-news-첫-사업-확정.md— Faktum 사업 컨텍스트~/Documents/ntriq-vault/wiki/system/faktum-news-current-state.md— 현재 웹 스택/DB/API 스냅샷~/.claude/projects/-Users-youareplan/memory/project-faktum-news.md— 프로젝트 메모리 + 모바일 섹션
2. 공식 스킬 체이닝
이 스킬 발동 시 아래 공식 스킬도 함께 활용:
android-cli—android create,android run,android sdk install등 CLI 오케스트레이션navigation-3— Jetpack Navigation 3 (딥링크, 리스트-디테일 scene)edge-to-edge— Compose edge-to-edge 적용
3. 앱 스택 (확정)
| 계층 | 선택 |
|---|---|
| 언어 | Kotlin |
| UI | Jetpack Compose |
| 내비게이션 | Navigation 3 (리스트-디테일 scene) |
| 디스플레이 | edge-to-edge |
| 백엔드 | Faktum 웹 API 재사용 (http://localhost:3099 → 배포 시 도메인 교체) |
| DB | 서버측 SQLite/FTS5 그대로, 클라이언트는 Retrofit/Ktor |
| 디자인 | Ground News 스타일 다크 테마 (웹과 일관성 유지) |
4. 핵심 커맨드
# 프로젝트 생성 (위치는 대표님 결정 필요)
android create --help # 옵션 먼저 확인
android create <project-path>
# SDK
android sdk install # 필요 컴포넌트만
android info # 현재 환경
# 실행
android emulator # 에뮬레이터
android run # 배포
# 문서/UI 지원
android docs <query>
android layout # 앱 UI 트리
android screen # 디바이스 화면
# 스킬 추가 (시점 도래 시)
android skills add --skill play-billing-library-version-upgrade # 구독
android skills add --skill r8-analyzer # 크기 최적화5. 작업 시작 워크플로우
- 위 1번 필독 컨텍스트 5개 Read
- 작업 분해 선언 (08-foundation, Stanford Pattern 1):
- 출력, 성공 기준, 필요 정보, 단계 수
- 프로젝트 경로 대표님께 확인 (모노레포 vs 별도 리포)
android create→android skills add순서로 뼈대- Faktum 웹 API 계약 Read (
~/Documents/Projects/faktum-news/app/api/) - Compose 화면 구현 →
android run으로 에뮬레이터 검증
6. 모든 AI 공유 확인
이 스킬은 Claude Code 전용이지만, 공식 Android CLI 스킬(android-cli/navigation-3/edge-to-edge)은 8개 AI 디렉토리 (.claude .codex .cursor .gemini .copilot .continue .agents .openclaw)에 자동 배포됨. Cursor/Codex/Gemini가 앱 코드 만질 때도 동일한 SKILL.md를 참조.
Obsidian vault(~/Documents/ntriq-vault/)는 5분 sync로 3개 시스템 공유 뇌 역할. 다른 AI도 vault의 wiki/tools/android-cli.md와 wiki/decisions/2026-04-19-android-cli-채택.md를 읽으면 동일 컨텍스트 획득.
7. 주의
- Google 공식 스킬(
android-cli등)은android skills add로 업데이트됨 → 수정 금지. 우리 보강사항은 이 래퍼 스킬에만 기록. - CLI는 preview(v0.7). 브레이킹 체인지 가능.
android update정기 실행. - Faktum 웹이 Next.js 16 (학습 데이터와 다름) → API 연동 시 웹 소스 Read 필수.