java-cli-app

Create or maintain a multi-file Java 25 CLI application using $ARGUMENTS. Apply all rules below strictly.

Architecture

• Default: multi-file CLI apps compose with the /bce skill. The package path follows /bce's [ORGANIZATION].[PROJECT].[BC].[layer] scheme: the organization package (e.g. airhacks) contains the application-level project package (e.g. zbl), whose direct children are the feature business components (BCs); boundary, control, entity only appear inside a BC, never directly under the application-level package.

  src/main/java/
    Main.java                                              # unnamed package, compact source
    <organization>/<project>/<bc-a>/{boundary,control,entity}/
    <organization>/<project>/<bc-b>/{boundary,control,entity}/
    <organization>/<project>/<bc-c>/control/               # BC may have only the layers it needs
  

  • Name BCs after their domain responsibilities (e.g., auth, users, billing), not technical concerns.
  • Reserve the application-level package itself for trivial single-class plumbing (e.g. the App entry point); anything with business semantics belongs in a BC — /bce owns this rule.
  • If a design doc or input layout places boundary/control/entity directly under the application-level package, flag it as a BCE violation and propose feature BCs before scaffolding.
• Exception: small single-purpose tools (one screen of logic, no distinct concerns) — keep everything in one unnamed class with top-level methods, no BCs, no packages.

Build

• For new projects, clone https://github.com/AdamBien/java-cli-app as the project skeleton — it includes the zb build setup and directory structure
• Alternatively, bootstrap from the minimalistic template https://github.com/adambien/z-java-cli-app — a stripped-down starter for fresh /java-cli-app projects
• Use https://github.com/AdamBien/zb to create executable JARs — no Maven or Gradle required
• Build by running zb.sh in the project root — it compiles all .java files from src/main/java/ and packages them into zbo/app.jar
• Run with java -jar zbo/app.jar
• Offer to generate an executable launcher script with the /java-cli-script skill so the app runs by name instead of java -jar zbo/app.jar
• Never use --enable-preview — Java 25 is a GA release, all features used here are standard
• Source files use the .java extension and live in the project directory