Java Stage
03 June 2026 · 14:35 — 15:20 · Bucharest
These patterns come from maintaining several Java and open source projects with AI-assisted workflows.
They worked in my context. Your codebase, team, and constraints may differ.
Age is not the problem. Unsafe change is.
// AI makes unsafe change compound sooner.“Start with bounded readiness work that makes the repository easier to change.”
README.md tells a person how to use it.
AGENTS.md tells an agent how to change it.
# fast validation — used by AGENTS.md, used by the agent
quick-build:
mvn -T 1C -DskipTests \
-pl '!doc-projects/...' \
install
// same intent, different dialect
tasks.register("quickBuild") {
group = "verification"
dependsOn(":kubernetes-client:install")
// parallel build, skip tests
}
quick-build. just runs it.
AGENTS.md was the map.
SKILL.md is the ritual.
make generate-model← canonical command (~15 min)refToJavaTypeMappings in pom.xmlapi/core/v1beta1refToJavaTypeMappingsclusterapi.v1beta1 → clusterapi.core.v1beta1But text doesn't push back.
kubernetes.default.svc.// why my tests survived the AI era
They amplify them. The shape of your project is the contract the agent reads from — and writes back into.
AI is only as good as the structure, clarity, and test harness of the project it works within.
87%
When the black-box suite carries the spec, code review collapses to intent + edge cases. The mechanical part — does it still work? — is already answered before a human opens the diff.
Fabric8 Kubernetes Client · JDK 17 → 21 migration, driven entirely by the existing black-box suite as the spec.
Spec- and test-driven workflows for letting coding agents safely refactor, upgrade, and ship features in real Java projects.