kora-project-setup-javalisted
Install: claude install-skill kora-projects/kora-skills
# Kora Project Setup — Java
> **Kora sub-skill — obey the [kora-v1 meta rules](../../SKILL.md) on every task:** **R0** ensure `.kora-agent/` docs+examples are cloned · **R1** read this sub-skill before writing code · **R2** Kora APIs only — no Spring/Micronaut/Quarkus, no invented annotations or config keys · **R3** journal any incorrect Kora usage. Add comments/Javadoc only if asked.
Scaffold a minimal, compilable Kora service in Java. Kora is a compile-time
framework: its annotation processor generates `ApplicationGraph`, controllers,
JSON readers/writers and aspects during `compileJava`. If the processor is not
wired into the Gradle build, **nothing is generated and nothing works**. This
skill gets that wiring right the first time.
**BOM version:** `ru.tinkoff.kora:kora-parent:1.2.19` (declared once; every
`ru.tinkoff.kora:*` artifact inherits it — never version them individually).
**JDK:** 17 minimum, 25 recommended. **Gradle:** 9+ (wrapper pins 9.5.1).
---
## Quick Start
Smallest build that compiles and runs an HTTP endpoint. Mirrors
`.kora-agent/kora-examples/guides/java/kora-java-guide-getting-started-app`.
`build.gradle`:
```groovy
import org.gradle.jvm.toolchain.JavaLanguageVersion
import org.gradle.jvm.toolchain.JvmVendorSpec
plugins {
id "java"
id "application"
}
java {
toolchain {
languageVersion = JavaLanguageVersion.of(25)
vendor = JvmVendorSpec.ADOPTIUM
}
}
repositories {
mavenCentral()
}
configurations {
kora