Plain-AyI
← All projects
Add-ons for AI coding tools

kotlin-footguns

A collection of known pitfalls in Kotlin app development, packaged so AI coding assistants can avoid them.

New this week

What it does

This project is a library of "footguns": common mistakes that cause bugs when building apps with Kotlin, Compose Multiplatform (a way to build one app for phones and computers) and desktop Java. Its maker says the lessons come from years of running a real music app, not from official documentation.

The mistakes are grouped into ten topic areas, such as databases, media playback, screen design, background tasks and app packaging. Each one is a short text file that explains what goes wrong, why, how to check your own code for it, and how to fix it. They use the open "agent skills" format, so AI coding assistants like Claude Code can open the right file when the work matches. People can read them too.

An extra skill called footgun-scan checks new code changes against known risky patterns. It flags spots for the AI assistant or a person to review.

Who it's for

Developers building Kotlin or Compose Multiplatform apps, especially those who use an AI coding assistant and want it to avoid known mistakes.

Can I use it without coding?

Developers only. The content is written for programmers and is meant to be used with coding tools during software development. New to this? Start here.

Can I run it?

Cost
FreeNothing to pay or sign up for.

Try it

  1. If you use Claude Code, add this project's plugin marketplace and install the kotlin-footguns plugin.
  2. Or use the skills command-line tool to copy the skill files into your own project so you can edit them.
  3. Ask your AI assistant in plain words to check your Kotlin changes for footguns.

Using Claude Code, Cursor or another AI coding assistant? Paste the prompt and it will walk you through the setup.New to this?

Before you install

  • Only download from the official GitHub page. Copies with similar names exist for many popular projects.
  • Plain-AyI is an independent guide and doesn't host or review the software it lists. Please check each project's official page before installing.
  • License (GPL-3.0): Free to use; if you share a changed version, you must share your source code too.
  • More on staying safe