kotlin-agents

Claude Code Agents

Specialized AI agents for Claude Code — organized by domain.

Repository Structure

agents/
├── coding/
│   └── kotlin/          # Kotlin / Spring Boot / Compose Multiplatform agents
└── education/           # Educational agents (coming soon)

Installation

Option 1: Install from GitHub (Recommended)

# Add the marketplace
/plugin marketplace add https://github.com/AlexGladkov/claude-code-agents

# Install the plugin
/plugin install kotlin-agents

Option 2: Install from Local Clone

# Clone the repository
git clone https://github.com/AlexGladkov/claude-code-agents.git

# Add the local marketplace
/plugin marketplace add ./claude-code-agents

# Install the plugin
/plugin install kotlin-agents

Available Agents

Coding / Kotlin

Located in agents/coding/kotlin/

Agent	Description
init-kotlin	Repository bootstrap for clean Kotlin Spring Boot or full-stack (Spring + Compose) projects
builder-spring-feature	Feature generation for Spring Boot with strict architecture (feature-slice, layering, dependency validation)
builder-compose-feature	Feature generation for Compose Multiplatform with Screen/View/Component separation and MVVM
test-spring	High-quality test automation following SDET/AQA practices, AAA pattern, Testcontainers integration
kotlin-diagnostics	Bug detection and diagnosis for Kotlin/Compose/Android/Spring with automatic runtime analysis
refactor-spring	Architectural refactoring of Spring applications enforcing SOLID, layering, file structure
refactor-mobile	Architectural refactoring of Android code (Clean Architecture, Compose, Decompose, Kodein)
security-kotlin	OWASP security auditing for Spring Boot with comprehensive vulnerability scanning
devops-orchestrator	Docker environment setup, multi-env configs, CI/CD pipelines, automated deployments
system-analytics	Technical specification generation from user requests, saved as structured Markdown
kotlin-multiplatform-developer	Full KMP feature slice generator (domain + data + presentation) with feature-sliced architecture

Education

Located in agents/education/ — coming soon.

Development Workflow (Kotlin)

These agents cover the complete development lifecycle:

1. init-kotlin           --> scaffold new projects
        |
        v
2. builder-spring        --> generate backend features
   builder-compose       --> generate mobile features
        |
        v
3. test-spring           --> write comprehensive tests
        |
        v
4. diagnostics-kotlin    --> find and fix bugs
        |
        v
5. refactor-spring       --> clean up backend architecture
   refactor-mobile       --> clean up mobile architecture
        |
        v
6. security-kotlin       --> OWASP audit
        |
        v
7. devops-orchestrator   --> containerization and CI/CD

Architecture Patterns Enforced

Spring Boot (Backend)

• Feature-slice organization: feature/<name>/api/service/persistence/domain/
• Layered architecture: Controller -> Service -> Repository (no shortcuts)
• One type per file, max 1000 lines per file, max 100 lines per method

Compose Multiplatform (Frontend)

• Feature-slice: feature/<name>/screen/view/component/domain/data/di/
• MVVM with Decompose: Component holds state, View is pure UI
• Use cases always return Result<T>
• No remember() in Views, max 600 lines ideal per file

Common Rules

• Unidirectional data flow, no cyclic dependencies
• SOLID principles strictly enforced
• Tests follow AAA pattern with Testcontainers for external deps

Contributing

To suggest a new subagent, open a Pull Request with a markdown file in the appropriate category folder under agents/.

License

MIT