Android Project Skill

Navigate and analyze Android project structure, modules, and dependencies.

When to Use

• Exploring project structure
• Finding related files
• Analyzing module dependencies
• Understanding package organization
• Locating specific code patterns

Standard Android Project Structure

android-app/
├── app/src/
│   ├── main/java/com/example/app/
│   │   ├── biz/                    # Business logic layer
│   │   │   ├── manage/             # Managers (GameManager, UserManager)
│   │   │   ├── service/            # Services (AuthService, SyncService)
│   │   │   ├── repo/               # Repositories
│   │   │   └── util/               # Utilities
│   │   ├── di/                     # Dependency injection (Koin/Hilt)
│   │   └── ui/                     # Presentation layer
│   │       ├── launcher/           # Screens by feature
│   │       ├── component/          # Reusable components
│   │       ├── navigation/         # NavRoutes, NavHost
│   │       ├── viewmodel/          # ViewModels
│   │       └── theme/              # Theme definitions
│   └── test/                       # Unit tests
├── docs/                           # Documentation
├── gradle/                         # Gradle config
└── CLAUDE.md                       # AI dev guide

File Patterns

By Layer

biz/manage/**/*Manager*.kt

biz/service/**/*Service*.kt

biz/repo/**/*Repository*.kt

ui/viewmodel/*ViewModel.kt

ui/launcher/**/*Route.kt

ui/component/**/*.kt

test/**/*Test.kt

Common Search Commands

# Find all ViewModels
find . -name "*ViewModel.kt" -type f

# Find all Route composables
grep -r "@Composable.*fun.*Route" --include="*.kt"

# Find class definition
grep -rn "class GameManager" --include="*.kt"

# Find class usages
grep -rn "GameManager" --include="*.kt" | grep -v "class GameManager"

# Find test file
find . -name "*GameManagerImplTest.kt" -type f

Architecture Navigation

MVVM Layer Flow

UI (Route) → ViewModel → Manager/UseCase → Repository → DataSource

Key File Types

LauncherActivity.kt

App.kt

AppModule.kt

*Module.kt

NavRoutes.kt

AppNavHost.kt

*Phase.kt

*State.kt

Current*Session.kt

Dependency Analysis

# Show full dependency tree
./gradlew dependencies

# Show specific module dependencies
./gradlew :app:dependencies --configuration implementation

# Check for version conflicts
./gradlew dependencies | grep -E "^\+---|^\\\\---" | grep "->"

Quick Navigation Tips

1. Find related files: Search for class name across project
2. Trace data flow: Follow imports from UI → ViewModel → Manager
3. Find tests: Replace

   Impl.kt

   with

   ImplTest.kt

4. Check DI: Look in

   AppModule.kt

   for registration

Troubleshooting

Command Workflows

# Full codebase exploration
find . -name "*.kt" -type f | head -20  # List Kotlin files
grep -rn "class.*Manager" --include="*.kt"  # Find managers
grep -rn "koinViewModel" --include="*.kt"  # Find ViewModel injections

# Feature impact analysis
grep -rn "GameManager" --include="*.kt" | wc -l  # Count usages
git log --oneline --follow -- "**/GameManager*.kt"  # File history

References

• Android App Architecture
• Koin Documentation
• Navigation Component

Use this skill to quickly locate files and understand relationships.