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

| Layer | Pattern | Example | |-------|---------|---------| | Manager | biz/manage/**/*Manager*.kt | GameManagerImpl.kt | | Service | biz/service/**/*Service*.kt | AuthService.kt | | Repository | biz/repo/**/*Repository*.kt | QuestionRepository.kt | | ViewModel | ui/viewmodel/*ViewModel.kt | GameViewModel.kt | | Screen | ui/launcher/**/*Route.kt | GameRoute.kt | | Component | ui/component/**/*.kt | QzdsGameButton.kt | | Test | test/**/*Test.kt | GameManagerImplTest.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

| Purpose | Naming Convention | |---------|------------------| | Entry point | LauncherActivity.kt, App.kt | | DI setup | AppModule.kt, *Module.kt | | Navigation | NavRoutes.kt, AppNavHost.kt | | State machine | *Phase.kt, *State.kt | | Session | 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

| Issue | Solution | |-------|----------| | Can't find class | Check import statements, package name | | Missing dependency | Verify DI module registration | | Test not found | Ensure test in correct source set | | Circular dependency | Review DI graph in AppModule |

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.