airails.dev

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

Installation

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).

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

Web

• web-static — Modern static websites using semantic HTML and CSS without external dependencies or build systems
• web-components — Single-page applications using web components, BCE layering, lit-html, Redux Toolkit, and client-side routing

BCE

• 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