Skip to content

AdamBien/airails

Repository files navigation

airails.dev

Development conventions, SKILLS.md, and AGENTS.md for building modern Java and web applications.

Installation

Download the repository without git, then run the installer:

curl -fsSL https://raw.githubusercontent.com/AdamBien/airails/main/downloadSkills | java --source 25 /dev/stdin
cd airails
./installSkills

Or clone it with git instead of the first step:

git clone https://github.com/AdamBien/airails
cd airails
./installSkills

The installer finds all skills and prompts before copying to each supported agent directory (~/.claude/skills, ~/.vibe/skills, ~/.kiro/skills, ~/.copilot/skills, ~/.agents/skills, ~/.config/goose/skills).

AI agents installing the skills themselves should follow AGENTS.mdinstallSkills requires an interactive terminal.

Manage installed skills:

./installSkills -l           # list available and installed skills
./installSkills -d <name>    # delete a skill by name
./installSkills -h           # show help

What's Inside

Java

  • java-cli-script — Zero-dependency, single-file executable Java scripts for system-wide use via PATH
  • zb — Zero Dependencies Builder for compiling, building, and packaging Java 21+ projects
  • zargs — Zero-dependency, enum-based argument parsing for Java CLI applications
  • zcfg — Zero Dependency Configuration Utility for loading properties and application configuration
  • zcl — Zero-dependency Colour Logger for colored terminal output in Java applications
  • zjson — JSON parsing and generation by copying the org.json source into the project, no Maven/Gradle dependency

Web

  • web-conventions — Composable baseline for all web frontends: semantic HTML, accessibility, design tokens, and Baseline browser-support policy
  • web-static — Modern static websites using semantic HTML and CSS without external dependencies or build systems; composes web-conventions
  • web-components — Single-page applications using web components, BCE layering, lit-html, Redux Toolkit, and client-side routing; composes web-conventions

BCE

  • sbce — Spec-driven BCE (sbce.space): one capability spec equals one business component, the package doc is the boundary contract, driving declare → converge against the stack's test loop
  • java-cli-app — Multi-file Java 25 CLI applications packaged as executable JARs with zb
  • microprofile-server — Architecture and coding conventions for long-running MicroProfile/Jakarta EE server applications using BCE pattern

Documentation

  • bce-diagrams — High-level overview diagrams showing interactions between business components, subsystems, and services
  • drawio — Draw.io overview diagrams with BCE shape mapping and consistent visual style
  • mermaid — Mermaid overview diagrams for architecture and component visualization
  • readme — Conventions for writing README.md files targeting advanced developers

Quickstarters

  • quarkus-microprofile — Quarkus MicroProfile template with BCE architecture, REST endpoints, CDI, and System Tests
  • bce.design — Web Components starter with lit-html, Redux Toolkit, and Vaadin Router
  • ebank — CRUD with Quarkus, JPA, and PostgreSQL
  • java-cli-app — Template for building zero-dependency Java CLI applications with zb
  • zeeds — Zero-dependency Java 25+ source files as starting points, run directly with java filename.java

About

AI and LLM conventions for modern Java 25 CLI apps, MicroProfile servers, serverless applications, Java AWS CDK IaC, and dependency-free static web development.

Topics

Resources

License

Stars

36 stars

Watchers

3 watching

Forks

Contributors