diegosouzapw 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
- Find related files: Search for class name across project
- Trace data flow: Follow imports from UI → ViewModel → Manager
- Find tests: Replace
Impl.ktwithImplTest.kt - Check DI: Look in
AppModule.ktfor 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
Use this skill to quickly locate files and understand relationships.