adam bien's blog

• floci.io live demo: an AWS cloud emulator written in Java with Quarkus and GraalVM
• floci vs. LocalStack: smaller, faster, many AWS services implemented in Java
• what hexagonal architecture adds to a BCE eBank application
• migrating legacy J2EE projects to Quarkus with LLMs works better than expected
• are outbound integrations boundaries in a BCE Quarkus application?
• zsmith on GitHub and its "concerns" skill from airails.dev
• BCE as agentic architecture
• better code quality keeps agents fast in complex applications - with bad code you hit the wall earlier than humans do
• zagentcapsule (zack): a zero-dependency single executable Java 25 file, about 700 lines, wrapping Apple's container technology on macOS
• zjev: a zero-dependency Java SDK for the jev model, soon to be published
• jev is a fast, cheap classifier rather than a text generator
• time machine to a 2018 gist: the questions have not changed much
• web apps without external dependencies: web components are strong with LLMs, because LLMs are trained on standards
• JFR for business logging: a Kafka-like experience with business events, in-memory logging and streaming at almost no cost
• WebAssembly after eight years: coming and going, it did not overtake JavaScript
• agentic testing: a skill generating at most three tests per method with strong assertions instead of assertTrue
• assertion coverage that catches mutations, fewer meaningful tests with the same structure are easier to review
• skills get shorter as LLMs get more powerful
• the JavaOne talk How to write great Java apps with LLMs and agents is online
• free BCE online course at BCE: The Screaming Architecture For Humans and LLMs with about 15 lessons and more coming

Ask questions during the show via twitter mentioning me: https://twitter.com/AdamBien (@AdamBien),using the hashtag: #airhacks or built-in chat at: airhacks.tv. You can join the Q&A session live each first Monday of month, 8 P.M at airhacks.tv

1. The homework / challenge: "How could hexagonal architecture improve the BCE eBank application?"
2. Experience with Floci (the Quarkus-based AWS emulator) for local CDK deployments and testing minimal Quarkus serverless projects--integrated into CDK pipelines, or still testing against real AWS accounts?
3. In a BCE-based Quarkus application: are outbound integrations Boundaries as well? REST endpoint, external clients and repository all in boundary, orchestration in control, domain model in entity?
4. Boundary interfaces used by the control hiding the Quarkus REST Clients behind their implementations--or unnecessary abstraction in BCE?
5. Thoughts/update on the JavaOne 2026 presentation: "How to Write Great Java Apps with LLMs and Agents"
6. "What Hexagonal Architecture Adds to a Boundary-Control-Entity (BCE) Project"
7. The state of "Architect-Grade Java with LLMs"
8. Why I'm using VSC?
9. Time machine: 100 episodes back (51st episode):

   Release versioning and git tagging strategies, branching for production vs. testing, build/release workflow automation and auto-deploy, portable multipart file upload with plain JAX-RS, MVC 1.0 future and alternatives for server-side templates with vanilla JS and Web Components, PrimeFaces as a WildFly module instead of WAR packaging, @Stateless vs. @Singleton for JAX-RS resources and thread safety, real-world CI with Jenkins, Maven and Git, structured JSON logging with java.util.logging vs. Log4j 2, separate vs. unified stacks for logs and metrics (Elasticsearch/Kibana vs. Prometheus/Grafana), push-based metrics emission vs. REST metrics endpoints, WebAssembly as the future of the web

Any questions left? Ask now: gist.github.com/AdamBien/c76cf8b4eefeb8239b578c4a1d0009b7 and get the answers at the next airhacks.tv. Some questions are also answered with a short video: 60 seconds or less with Java

Ask questions during the show via twitter mentioning me: https://twitter.com/AdamBien (@AdamBien),using the hashtag: #airhacks or built-in chat at: airhacks.tv. You can join the Q&A session live each first Monday of month, 8 P.M at airhacks.tv

1. VibeKode Netherlands 2026: How To Write Great Code with LLMs #vibeless
   conference talk VibeKode Netherlands 2026 Utrecht, Netherlands 7 October 2026
   https://vibekode.it/agentic-engineering/java-llm-clean-code/
2. Fewer Tokens, Better Java: Spec-Driven Development at LLM Speed[online event]
   online conference talk 13 October 2026
   https://java.bettercode.eu/veranstaltung-89660-se-0-fewer-tokens-better-java-spec-driven-development-at-llm-speed.html
3. JUGtoberfest 2026, JUG Poznań: Java-First Spec-Driven Development with LLMs
   java user group talk JUGtoberfest 2026, JUG Poznań Teatr Ósmego Dnia, Ratajczaka 44, Poznań, Poland 14 October 2026
   https://crossweb.pl/wydarzenia/jugtoberfest-2026/
4. Silesia JUG #111: Java-First Spec-Driven Agentic Development on Steroids
   java user group talk Silesia JUG #111 Katowice, Poland 21 October 2026
   https://www.meetup.com/silesia-jug/events/316764402/
5. W-JAX 2026: LLM-Assisted Migrations and Modernizations: from Museum to Mainstream
   conference talk W-JAX 2026 Munich, Germany 3 November 2026
   https://jax.de/big-data-machine-learning/llm-assisted-migration-modernization/
6. W-JAX 2026: Disciplined LLM-Assisted Java: Patterns, Architectures and the Process
   conference talk W-JAX 2026 Munich, Germany 3 November 2026
   https://jax.de/ai-development/llm-assisted-java-patterns-architectures/
7. W-JAX 2026: AI Coding war gestern. Jetzt kommen die Agenten!
   conference keynote W-JAX 2026 Munich, Germany 4 November 2026
   https://jax.de/big-data-machine-learning/ai-coding-agentic-engineering-patterns/
8. J-Fall 2026: Java over Markdown: Specs That Compile
   conference talk J-Fall 2026 Pathé Ede, Netherlands 12 November 2026
   https://jfall.nl/timetable-2026/
9. airhacks.university: Architect-Grade Java with LLMs
   in-person workshop airhacks.university Munich Airport, Germany 10 December 2026
   https://airhacks.university
10. Building Local and Serverless LLM Agents[online event]
    online workshop 15 December 2026
    https://workshops.adam-bien.com/building-local-and-serverless-llm-agents.htm
11. LLM-Assisted Legacy System Migration to Modern Java[online event]
    online workshop 17 December 2026
    https://workshops.adam-bien.com/llm-assisted-legacy-system-migration-to-modern-java.htm
12. airhacks.tv Questions and Answers #livestream[online event]
    live streaming show first monday of the month, 8pm CET
    https://www.meetup.com/airhacks/

All of the above announcements are based on my JavaOne 2026 talk, in which I explained why LLMs love Java:

In a recent project (eBank: accounting, customers, transactions, reporting) I checked what Hexagonal Architecture would add to an application organized with Boundary-Control-Entity (BCE). The answer: more classes and little else.

In BCE the unit of organization is the business component (BC), a package named after a responsibility. Each BC has up to three layers: the boundary adapts external protocols (JAX-RS, MCP), the control holds stateless business logic, the entity carries state and behavior. The same capability in both styles:

# BCE
airhacks.ebank.accounting.boundary.AccountsResource
airhacks.ebank.accounting.boundary.AccountsTool
airhacks.ebank.accounting.control.AccountCreator
airhacks.ebank.accounting.entity.Account

# Hexagonal
airhacks.ebank.adapters.in.web.AccountsController
airhacks.ebank.adapters.in.mcp.AccountsTool
airhacks.ebank.application.port.in.CreateAccountUseCase
airhacks.ebank.application.port.out.SaveAccountPort
airhacks.ebank.application.service.CreateAccountService
airhacks.ebank.domain.Account
airhacks.ebank.adapters.out.persistence.AccountJpaEntity
airhacks.ebank.adapters.out.persistence.AccountMapper

1. The boundary is already an adapter. AccountsResource (HTTP) and AccountsTool (MCP) call the same control. Two delivery mechanisms share one control, without an interface between them. An inbound port would formalize a contract with one caller and one implementation.
2. The platform is not an external system. JPA, JAX-RS and CDI are the runtime. A port in front of EntityManager protects against a database swap nobody plans. If Hibernate or PostgreSQL changed, the SQL, the annotations and the test setup would change anyway.
3. One entity instead of three. Account carries JPA, JSON-B and OpenAPI annotations and has behavior like isBalancePositive(). Hexagonal splits it into a domain object, a persistence model and a transport DTO, plus mappers in both directions. For five BCs that is roughly three times the classes.
4. Constraints by construction. The reporting BC must not write. Hexagonal would express this as a query-only port. In eBank AccountQuery uses plain JDBC and never touches the persistence context. A package-info.java documents the reason.
5. Tests over the real protocol. The system test module calls the HTTP and MCP endpoints of the running application. These tests cover more than adapter tests against a mocked port. Business rules on the entity are unit tested without a container.
6. Readability. Open AccountsResource, follow one injection, reach the persistence call. With ports the path is interface, implementation, mapper.

The same properties matter for coding agents. An agent reads the package tree first. The BCE tree names the business (accounting, customers); the Hexagonal tree names the pattern (ports, adapters). Adding a field in eBank touches the entity and the boundary. In Hexagonal it touches the domain object, the JPA entity, the DTO and two mappers. Every additional file is a file the agent can forget, and every mapper is code the agent has to keep in sync. The requirements are placed next to the code: EARS statements (Easy Approach to Requirements Syntax) in package-info.java and a project annotation @Requirement on the boundary methods. The agent implements against the boundary contract and verifies with the system tests. The BCE rules are available as agent skills at airails.dev.

With CDI, a second implementation does not require Hexagonal either. Turning a control into an interface is an IDE refactoring: the injection points stay unchanged, and a qualifier, @Alternative, or a plain if statement selects the implementation. A second persistence technology affects only the controls that use it. Business rules on the entity are already tested without a database, and teams can own business components instead of layers.

See also: Alistair Cockburn's original description and the buckpal Hexagonal reference implementation. Both buckpal and eBank manage bank accounts, which makes the two package trees easy to compare.

Subscribe to airhacks.fm podcast via: spotify| iTunes

Java's open ecosystem—specifications, source code, JSRs, JEPs, mailing lists, MicroProfile, and Jakarta EE—made it an ideal training ground for LLMs. These models learned more than syntax: they absorbed Java's patterns, idioms, and design philosophy. In this live-coding session, we'll explore how to put that knowledge to work with short prompts and rapid iterations. (...)

Presented at JavaOne 2026 (CA, March 2026):

• Spec-Driven BCE (SBCE) in two phases: clarification questions until the requirements are clear, then package-info JavaDoc, then code
• New airails.dev skills: AWS CDK, web sprinkles, Java 25 CLI scripts with BCE
• EARS requirements in JavaDoc, @Requirement annotation generating parameterized tests, zunit and Playwright tests, architecture diagrams from BCE
• Outer loop on top of SBCE: the software factory
• entwickler Summit Berlin demo: Currywurst stand application generated in 10 minutes, 30 to 80 percent token savings
• Do we still need architecture? Serializing agents by dispatching GitHub issues to components
• Agent Smith (zsmith): @Concern for cross-cutting concerns, JFR as business observability with agent turn, subagent and LLM API call events, @Relational event groups, roughly 300 KB with no dependencies
• ZHTMLDB (renamed from HTMLDB) with partial keys, BCE in a single Java 25 script, interfaces instead of classes with private constructors
• BCE versus hexagonal: BCE is stable since 1992, hexagonal is a special case with more plumbing and no naming conventions. Homework: clone eBank and show where hexagonal would improve it
• eBank walkthrough: components, JAX-RS resource and MCP tool from the same component, MCP error handling with success plus descriptive text
• J2EE to Quarkus migration with airails.dev skills: migration advisor, concept extractor, lift and shift versus full migration, JDK 6/8 to Java 25 performance gains
• Domain logic in entities and records, procedural logic in controls
• Automation engines: zsmith, LittleHorse, and the Jev model for if/else decisions via plain Java HttpClient
• Free BCE course on YouTube
• Time machine to episode 50: Swing migration workshop at Munich airport, WebAssembly, exception handling, ThreadLocal versus scoped values, thin WARs, equals and hashCode in JPA entities, JAutodoc and AI

Ask questions during the show via twitter mentioning me: https://twitter.com/AdamBien (@AdamBien),using the hashtag: #airhacks or built-in chat at: airhacks.tv. You can join the Q&A session live each first Monday of month, 8 P.M at airhacks.tv

1. Another take on opinionated Spec-Driven development with Java
2. Do we still need architectures?
3. Kafkaesque JFR
4. zhtmldb for agent memory
5. You recommend BCE. How do you keep business logic independent from technology? Do you combine BCE with Hexagonal Architecture, or do you think BCE alone is sufficient?
6. How does BCE compare to hexagonal architecture? What are the Pros and Contras? When to prefer one over the other? Does it make sense to migrate from one to the other or is either one good enough so a migration is not justified?
7. Time machine: 100 episodes back (50th episode):

   Swing Migrations Workshop, Exception handling strategies, Transparent and remote UUI propagation, Thin WARs and 3rd party JPA, Equals and hashCode in JPA entities, Remote CDI events, WebSockets testing, Jakarta EE's future, Combining Primefaces with JAX-RS, When Numbers Are More Important Than Quality

Any questions left? Ask now: gist.github.com/AdamBien/fde8e4518d3aa789f962b87ed93675e1 and get the answers at the next airhacks.tv. Some questions are also answered with a short video: 60 seconds or less with Java

Ask questions during the show via twitter mentioning me: https://twitter.com/AdamBien (@AdamBien),using the hashtag: #airhacks or built-in chat at: airhacks.tv. You can join the Q&A session live each first Monday of month, 8 P.M at airhacks.tv

Subscribe to airhacks.fm podcast via: spotify| iTunes

Before LLMs a senior engineer carried the architecture in their head, and a deviation from it cost typing effort. An agent generates a deviating structure as cheaply as a conforming one, and it does not remember what it generated for the previous feature. Without architecture and design written down, the agent decides everything per feature: where the code goes, how it talks to the rest of the system, which operations to expose, and what the data looks like.

Architecture removes coordination ambiguity: where does this belong, and how does it interact with the rest? It is decided once per system and held constant. It defines what a business component is, that it consists of Boundary, Control and Entity, what each layer may depend on, and how components communicate. The human owns it. Rules a human team treats as guidelines have to be absolute for the agent. It can argue for an exception, but it argues again in every task, without the history behind the rule, and the exception it grants in one component is not remembered in the next. Stricter does not mean more rules. A named architecture such as BCE is three layers, one dependency direction, and a package layout. It compresses pages of rules into a few tokens in the prompt, and the agent never rediscovers it per task. Two agents implementing two features in parallel, with no component structure, edit the same shared classes and overwrite each other's changes. With component boundaries defined up front, each agent works inside its own component. A reviewer checks placement without reading every line.

Design removes implementation ambiguity: how exactly should this piece behave? It is decided per feature, inside the bounds the architecture already fixed. Which operations does this boundary expose, which entities does the component own, is this one control class or three, what is the shape of the record. The agent owns it, steered by a specification. In my projects the specification lives in package-info.java, next to the code it describes (SBCE). The agent implements it, the tests decide whether the result is adequate, and the agent regenerates it when the specification changes.

The test: if a decision would be the same in every business component, it is architecture and belongs in a convention the agent loads once. If it would differ between the orders component and the invoices component, it is design and belongs in the specification of that component. Package layout, layer dependencies and naming rules pass the first test. The shape of an order line item passes the second. A design decision that turns out to be universal gets promoted into the architecture.

In classical projects architecture takes a few days and design takes the rest of the project. With agents the ratio inverts. Design becomes cheap because it is generated. Architecture becomes more valuable because it is the only thing that keeps a thousand generated designs consistent with each other.

Fewer decisions left to the agent means fewer mistakes, fewer corrective turns, fewer tokens, and less human review.

A clarifying question from the agent costs a full round trip. A type declaration costs a handful of tokens. Verbose Java is the cheaper option.

1. Ambiguity costs a turn, verbosity costs tokens. A wrong guess costs a full extra round trip. A declared type costs a few tokens in every turn that follows, and prevents the guess.
2. Constraints are machine-verifiable. javac is the cheapest judge in the loop. A type error costs milliseconds and no tokens. In a dynamic language the same mistake surfaces at runtime or in a review turn.
3. Code is the only context the compiler checks. A sealed interface survives across sessions and developers. A prompt or an instruction file like CLAUDE.md, AGENTS.md or SKILL.md is re-sent on every session and never enforced.
4. Annotations declare rules in a single word. @NotNull, @Size, @Transactional, @Path, @Inject: each states a constraint the agent would otherwise infer from the method body or ask about. Standard annotations compress further, because @Path maps to spec behavior the model has seen thousands of times. An in-house framework has to be explained in every session.
5. Names lead from the requirement to the code. A requirement that mentions the customer email leads the agent to findCustomerByEmail with a single search. A method named get forces it to read the implementation. In a BCE package structure (boundary, control, entity), the package name tells the agent the layer from the import alone. The compiler never checks names, so a misleading name misleads as reliably as a descriptive one guides.
6. Intent is not ceremony. Records, sealed interfaces, generics, final, checked exceptions, annotations and descriptive names carry semantics. Getters, setters and Impl suffixes carry nothing.

Verbose code consumes output tokens and context window. A clarifying question consumes a full round trip on top of both.

A rule from 2013, How To Comment With JavaDoc, predates coding agents and still applies: the WHAT goes in the name, the HOW in the code, and the WHY in the comment. The WHY is the only context the agent cannot derive from the source, so a JavaDoc on a non-obvious decision keeps the rationale in the repository instead of in the prompt. The conventions that made code readable for the next developer make it unambiguous for the agent.

Subscribe to airhacks.fm podcast via: spotify| iTunes

Subscribe to airhacks.fm podcast via: spotify| iTunes

"AI engineers" established a new genre of bragging: how little of the code was written by hand, what percentage the agent generated, how many days since the last manually typed line. The proportion of generated code became the achievement.

Over a century ago, transportation made walking optional. Since then, nobody has opened a story with "I didn't walk here." People talk about where they went.

"Brag about arriving, not about not walking. Brag about shipping, not about not coding."

The users cannot tell a generated line from a typed one, and the maintainers only care whether it is simple and tested. The important details remain the same: the software went into production, it is secure and easy to change, and it works.

Most context engineering goes into supplying the model with knowledge. For a Java project nearly all of that is redundant, because the model already read the specs. What it does not have is an opinion about how your project should look. That is the only thing worth supplying.

• Skip the knowledge plumbing. Java SE, Jakarta EE and MicroProfile APIs stay stable across versions, so what the model learned at training time still applies today. MCP servers, documentation indexes and vector stores mostly re-supply what it already has.
• Start brownfield. I do not generate a project from nothing. quarkus-microprofile for services, java-cli-app for tools, aws-quarkus-lambda-http-api-cdk-plain for AWS Lambda behind an HTTP API.
• Keep the starter tiny. The CLI template is three kilobytes, a README and one App.java. That fixes the package layout, the build and the naming conventions without describing any of them in prose.
• Pick a well represented and stable architecture. BCE has been described since the nineties and has not moved since, so naming it is enough. A homegrown layering has to be taught in every session.
• Keep AGENTS.md minimal. Build instructions only. How to start dev mode, how to package, how to run the system tests. The structure is already visible in the project.
• Put the design principles in skills. A handful of rules is enough, and "use Java SE libraries first" is the one that pays for itself immediately.

The useful content of an AGENTS.md is roughly this much:

cd service
mvn quarkus:dev

cd service-st
mvn verify

Everything else is either already in the code or belongs in a skill. The dependency rule is a good example. Without it the model reaches for whatever library it has seen in a million GitHub projects. With it, the JDK is the default and a new dependency has to be argued for.

The skills implementing BCE for each of these stacks: java-conventions, microprofile-server, java-cli-app and aws-cdk. Installation for any coding agent at airails.dev.

Working code and a few principles. The rest it already knows.

Subscribe to airhacks.fm podcast via: spotify| iTunes

Java specifications, JSRs and JavaDoc have been publicly available, crawlable, versioned and consistently formatted for three decades. Jakarta EE and MicroProfile publish theirs as plain HTML on the open web, where Common Crawl picks them up, and Common Crawl is one of the most widely used sources of LLM training data. Beyond the amount of text, the language itself happens to be built the way an LLM likes it.

1. Explicit types. The contract is written down, not inferred by the reader. A generated signature carries its own meaning, and a wrong guess is rejected by the compiler.
2. Verbosity. Redundant syntax works as error correction. The same intent shows up in the type, the name and the annotation, so a single mistaken token rarely survives.
3. Rigid conventions. PascalCase types, camelCase methods, reverse domain packages, one public type per file. Highly predictable, low entropy.
4. Annotations. @Path, @Inject and @GET declare a concern instead of implementing it. The names are standardized and appear identically across the whole ecosystem, so the model recognizes what is being asked for, and the container supplies the registration, the lookup and the lifecycle. Intent without wiring.
5. Backwards compatibility. Java takes source and binary compatibility seriously, and modern tooling still reads class files from compilers that went out of use decades ago. Books, articles and answers from years back describe code that largely still works, so old material stays useful instead of turning into noise.
6. Normative prose. Jakarta specs state requirements as MUST, SHOULD and MAY, usually citing RFC 2119. MicroProfile defines the required behavior and ships a TCK that checks it. The JLS repeats "it is a compile-time error if" throughout. Precise prose, and something executable that verifies it.
7. Implementation independence. @Inject is JSR 330, not the property of any container. It is read by Jakarta EE, Quarkus, Micronaut, Helidon, Spring, WildFly, JBoss EAP, Payara, GlassFish, Open Liberty, WebLogic, Vidocq, Google Guice, Dagger, Eclipse Sisu, Apache Maven and the Eclipse Platform, and CDI adds scopes, qualifiers, producers and events on top of it. Instead of picking between different versions of unrelated vendor implementations, the model writes a token with stable meaning. There are fewer places to go wrong.
8. A fast compiler as verifier. Invented method names never reach production, they fail in the build. javac needs seconds, and java App.java runs a source file without any build step. Generate, compile, correct is cheap enough to become the model's inner loop.

The result is code with very few degrees of freedom:

public class Garage {

    @Inject
    Cars cars;

    @Inject
    Event registered;

    public void register(Car car) {
        this.cars.add(car);
        this.registered.fire(CarRegistered.of(car.id()));
    }
}

The standardized APIs fix the programming model, javac checks the types and signatures, and the container checks the injection points and the wiring. The model fills in a predefined programming model instead of inventing one.

Subscribe to airhacks.fm podcast via: spotify| iTunes

abstract:

Java's radical openness created the perfect LLM training ground: open specifications, open-source implementations, and the complete JCP including every JSR, JEP. LLMs didn't just learn Java syntax - they absorbed its idioms, patterns, and design philosophy.

This session will demonstrate how to use this LLM's Java knowledge through practical techniques and tools such as Claude Code and Kiro. Through live coding, you will learn how to engineer efficient prompts tailored to Java best practices, generate idiomatic Java 21+ code leveraging records, pattern matching, and proper naming conventions, create meaningful system tests, and maintain architectural consistency in enterprise applications. The resulting code is readable by humans and machines alike.

I used the skills from: airails.dev for LLM-assisted code generation. The BCE architecture is described here: bce.design. Also, check out the Java-flavored spec-driven development with sbce.dev

Docker's building best practices recommend multi-stage builds. The first stage compiles the source, the final stage copies the result into a minimal runtime image. That is useful when Docker is the build environment. In a Maven or Gradle centric organization with an existing CI/CD pipeline, Docker is not the build environment.

The pipeline already compiles, tests, and versions the artifact in a controlled, isolated environment. A multi-stage build compiles it a second time, with a different JDK, a different local repository, and a different cache. The image no longer contains the artifact that passed the tests. It contains a rebuild that happens to share the same commit.

The single-stage alternative packages what the pipeline produced:

FROM eclipse-temurin:25-jre-alpine
COPY target/application.jar /opt/application.jar
CMD ["java", "-jar", "/opt/application.jar"]

Ranked by importance:

1. Build once and promote the exact artifact.
2. Use a controlled, isolated, reproducible CI build environment.
3. Keep the runtime image minimal.
4. Use multi-stage Docker builds when Docker is the chosen build environment.

Multi-stage is a technique, not an architectural best practice. Making multi-stage Dockerfiles the rule obscures the more important one: the build tool and the pipeline own the software build, Docker only packages its output.

Agents generate code in seconds, so investing in code quality looks obsolete. My daily work with agents shows the opposite. Every session starts by reading the existing code, and its quality decides how productive the session is.

• Agents amplify the local style. LLMs match the surrounding code. Clear conventions get reproduced, and so does degradation: in a codebase full of Managers and Impls, the agent generates the next one.
• Simplicity saves context. Every additional layer, interface, or indirection is another file the agent has to read before it can change anything. The smaller and flatter the code, the more of the system fits into the context window, and the faster a human reviews the result.
• Vertical slices localize the change. A prompt describes a feature, not a technical layer. One business component per responsibility keeps the change inside a single package: small context, and parallel agent sessions without collisions. Horizontal layering scatters every feature across the whole tree.
• Verbosity creates semantic context. Spelled-out names, explicit signatures, annotations, and JavaDoc that states the intent are context the prompt no longer has to deliver. The same names are navigation: an agent finds a package named after a business responsibility without scanning the project. This complements simplicity: the structure stays minimal, and the names and declarations carry the meaning.
• Every artifact needs a purpose. Agents treat whatever exists as intentional: they maintain dead code, extend speculative abstractions, and route new features through unused flexibility. Code without a purpose misleads the next session.
• Standard patterns are in the LLM weights. Conventions like BCE are described in decades of books and articles, so agents apply them without explanation. A self-invented structure has to be taught in every session.
• Tests are the feedback loop. An agent iterates autonomously only against executable verification; spec-driven workflows like SBCE use the test suite to decide when the work is done. Without tests, the agent cannot verify its own claims.
• Drift is invisible to the agent. Every generated change looks reasonable in isolation, and the agent has no sense of a slowly degrading whole. Architectural review stays a human responsibility, and simple, short code is what keeps it feasible at agent speed.

Code quality was always an investment in the next developer who has to read the code; in agentic development, the next reader arrives with the next prompt.

The conventions from this post are packaged as installable skills for any coding agent at airails.dev.

"Spring Gateway vs nginx vs cloud API gateways: nginx and HAProxy as proxies, cloud gateways transforming HTTP into CloudEvents, authentication, JWTs and content-based routing, BCE as the show's most used term, BCE namespaces from domain ideas, BCE applied to static pages where folders are menu items and cards are feature components without JavaScript, HTMLDB released today: a database built on HTML as valid XML in ~550 lines of Java 25 with no external libraries, tables and rows via CLI, data viewed in the browser as semantic HTML, HTMLDB motivated by agent memory since agents understand XML well, watching agent memory live in a zero-dependency web server, Agent Smith migrated to HTMLDB, symbolic links as convention over configuration for multiple schemas, HTMLDB in the Z family, not an Oracle or Postgres replacement, floci.io: Quarkus-based emulation of Lambda, DynamoDB, Neptune, CodeBuild and ElastiCache with ~20k GitHub stars in 5 months, always reviewing LLM-generated code to refine skills and AI rails, why web frameworks may disappear: LLMs understand the web platform and do not need React, Angular or Svelte developer experience, agents generating perfect web component code without frameworks, an airhacks.live web components workshop deriving a JTree-like structure from design.md, Jakarta EE Core covering ~80% with CDI, bean validation and JAX-RS, exclusive grounding against MicroProfile so code runs on Quarkus without the agent knowing Quarkus, AI rails updates: AWS CDK skill mapping BCE to CDK constructs, static web and vanilla JavaScript sprinkles, a vanilla Java agent on AWS agent core runtime in ~40 lines with 60ms startup and 5KB, ZDMD turning design.md into design tokens for framework-free web components, ported from TypeScript with shorter Java code, time machine to episode 49 from April 2018: WebStart, JavaFX revival since LLMs understand JavaFX well, no frameworks over JSF-to-Angular, JWT system tests with real test tokens, thin WARs, EclipseLink on Payara over shipping Hibernate, query caching from EHCache to Infinispan, a YouTube course on BCE, and a workshop at Munich airport in December"

Ask questions during the show via twitter mentioning me: https://twitter.com/AdamBien (@AdamBien),using the hashtag: #airhacks or built-in chat at: airhacks.tv. You can join the Q&A session live each first Monday of month, 8 P.M at airhacks.tv

The most asked BCE question is not what the layers mean, but which dependencies are allowed. Inside a business component the dependencies point downwards.

1. boundary to control, control to entity. The boundary offers coarse grained, easy to use methods, the control finer grained, reusable ones, the entity holds the data, as a smart domain object or an anemic record.
2. boundary to entity, directly. A control is only needed for the more complex use cases. For the simple ones, skipping the control is the default.
3. Never entity to control, never entity to boundary. An entity that needs something from above emits an event instead. Any layer of any component can process it, and the entity stays unaware of the receiver.

Between business components three cases matter:

1. boundary to boundary: avoid it. A boundary is designed for external actors, not for other business components. Acceptable at the very beginning, later a control takes over.
2. control to control: allowed, and direct. No interfaces in between required. In Quarkus and MicroProfile applications the control is injected.
3. entity to entity: allowed. Relations between persistent objects would be impossible without it.

Then count the links. A component that communicates less with itself than with its neighbors was cut in the wrong place.

See bce.design for the pattern rules and sbce.dev for the spec-driven workflow built on it.

Episode 6 of the free Screaming Architecture with BCE series applies the rules to two components of the example project:

The full course is available at airhacks.io.

1. BCE/ECB (Boundary-Control-Entity) for ...with static, semantic pages
2. floci.io AWS cloud emulator
3. "the role of the platform in LLM-assisted development" by Ondro at LinkedIn
4. announcement: htmldb
5. Free course: BCE: The Screaming Architecture For Humans and LLMs 👉 airhacks.io
6. New AWS-CDK and web-platform skills 👉 airails.dev
7. One seat left 👉 airhacks.university
8. unscripted: plain HTML showcase 👉 unscripted
9. Time machine: 100 episodes back (49th episode):

   Swing without WebStart, Preventing Web Sessions, Performance Testing with JWT, JPA query result caching, SAML Java Frameworks, JavaScript databinding with WebSockets, Asynchronous Java EE, Using embedded container testing with container resources, When Numbers Are More Important Than Quality

Any questions left? Ask now: gist.github.com/AdamBien/e58d00a2cb06d6ca5e6039bf48f3b1db and get the answers at the next airhacks.tv. Some questions are also answered with a short video: 60 seconds or less with Java

Ask questions during the show via twitter mentioning me: https://twitter.com/AdamBien (@AdamBien),using the hashtag: #airhacks or built-in chat at: airhacks.tv. You can join the Q&A session live each first Monday of month, 8 P.M at airhacks.tv