Thanks for your interest in contributing.
These are two different things — make sure you're doing the one you mean to:
- Building an app with KMPilot? Don't clone this repo. Use the installer in the README — it clones the right release, renames the project, and gives you a clean git history to build on.
- Contributing to KMPilot itself (fixing a skill, agent, or template bug)? Cloning is correct — that's what the rest of this document covers.
Open an issue with:
- Clear description of the problem
- Steps to reproduce
- Expected vs actual behavior
- Environment details (OS, JDK version, Android Studio version)
Open an issue describing:
- The problem you're trying to solve
- Your proposed solution
- Any alternatives you've considered
- Fork the repository
- Create a branch from
main - Make your changes
- Run
./gradlew buildto ensure everything compiles - Run
./gradlew ktlintFormatto format code - Submit a PR with a clear description of changes
- Follow existing patterns in the codebase
- Use Ktlint for formatting (
./gradlew ktlintFormat) - Maintain Clean Architecture boundaries
- Keep feature modules isolated (no cross-feature dependencies)
When modifying AI agents or skills in .claude/:
- Test changes with actual feature generation
- Update relevant documentation in the Wiki
- Ensure specs are generated correctly
Open an issue for questions or ideas.