{"id":48683547,"url":"https://github.com/adambien/airails","last_synced_at":"2026-07-14T08:00:43.457Z","repository":{"id":335820497,"uuid":"1116267647","full_name":"AdamBien/airails","owner":"AdamBien","description":"AI and LLM conventions for modern Java 25 CLI apps, MicroProfile servers, serverless applications, Java AWS CDK IaC, and dependency-free static web development.","archived":false,"fork":false,"pushed_at":"2026-07-04T06:37:30.000Z","size":307,"stargazers_count":33,"open_issues_count":0,"forks_count":10,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-07-04T08:23:39.662Z","etag":null,"topics":["agents","ai","bce-design","java","llm","skills","web","webstandards"],"latest_commit_sha":null,"homepage":"https://airails.dev","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AdamBien.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-14T14:32:02.000Z","updated_at":"2026-07-04T06:37:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/AdamBien/airails","commit_stats":null,"previous_names":["adambien/airails"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AdamBien/airails","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdamBien%2Fairails","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdamBien%2Fairails/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdamBien%2Fairails/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdamBien%2Fairails/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AdamBien","download_url":"https://codeload.github.com/AdamBien/airails/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AdamBien%2Fairails/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35451878,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-14T02:00:06.603Z","response_time":114,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","ai","bce-design","java","llm","skills","web","webstandards"],"created_at":"2026-04-11T03:39:02.544Z","updated_at":"2026-07-14T08:00:43.450Z","avatar_url":"https://github.com/AdamBien.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# airails.dev\n\nHome of Spec-Driven BCE ([**sbce.space**](https://sbce.space)) — development conventions, [SKILLS.md](https://agentskills.io/specification), and [AGENTS.md](https://agents.md) for building modern Java and web applications.\n\n## Installation\n\nDownload the repository without `git`, then run the installer:\n\n```\ncurl -fsSL https://raw.githubusercontent.com/AdamBien/airails/main/downloadSkills | java --source 25 /dev/stdin\ncd airails\n./installSkills\n```\n\nOr clone it with `git` instead of the first step:\n\n```\ngit clone https://github.com/AdamBien/airails\ncd airails\n./installSkills\n```\n\nThe 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`).\n\nWithout a JDK or `git`, download the prepacked zip for your agent from the rolling [skills release](https://github.com/AdamBien/airails/releases/tag/skills) and unzip it into the home directory:\n\n```\ncurl -fsSLO https://github.com/AdamBien/airails/releases/download/skills/airails-claude.zip\nunzip -o airails-claude.zip -d ~\n```\n\nEach zip contains all skills with the agent's skills directory baked into the entry paths: `airails-claude.zip`, `airails-vibe.zip`, `airails-kiro.zip`, `airails-copilot.zip`, `airails-codex.zip`, `airails-goose.zip`.\n\nAI agents installing the skills themselves should follow [AGENTS.md](AGENTS.md) — `installSkills` requires an interactive terminal.\n\nManage installed skills:\n\n```\n./installSkills -l           # list available and installed skills\n./installSkills -d \u003cname\u003e    # delete a skill by name\n./installSkills -h           # show help\n```\n\n## What's Inside\n\n### Spec-Driven BCE (SBCE)\n\nOne capability spec equals one business component, and the spec is the boundary contract ([sbce.space](https://sbce.space)). Declare the capability, then converge the code against the stack's own test loop.\n\n- [**sbce**](bce/sbce) — The workflow: `new` decomposes a feature into capability specs, `apply` converges code to spec; composes with bce and a stack skill (java-cli-app, microprofile-server, web-components)\n- [**ears-tests**](bce/ears-tests) — Parameterized (table-driven) tests generated from the EARS requirement statements in a capability spec, one labeled row per requirement id\n\n### Java\n\n- [**java-conventions**](java/java-conventions) — Composable Java 25 code conventions: modern syntax, naming, visibility, streams, and exceptions across all Java contexts\n- [**java-cli-script**](java/java-cli-script) — Zero-dependency, single-file executable Java scripts for system-wide use via PATH\n- [**java-distiller**](java/java-distiller) — Simplifies, modernizes, and refactors existing code into idiomatic Java 25\n- [**python-to-java**](java/python-to-java) — Converts Python scripts to zero-dependency Java 25 CLI programs\n- [**enterprisifier**](java/enterprisifier) — Deliberately overengineers code with maximum patterns, indirections, and abstractions, for comedic or educational purposes\n- [**zb**](java/zb) — Zero Dependencies Builder for compiling, building, and packaging Java 21+ projects\n- [**zb-release-pipeline**](java/zb-release-pipeline) — GitHub Actions pipeline that builds a zb project and publishes the JAR as a GitHub Release\n- [**zargs**](java/zargs) — Zero-dependency, enum-based argument parsing for Java CLI applications\n- [**zcfg**](java/zcfg) — Zero Dependency Configuration Utility for loading properties and application configuration\n- [**zcl**](java/zcl) — Zero-dependency Colour Logger for colored terminal output in Java applications\n- [**zjson**](java/zjson) — JSON parsing and generation by copying the org.json source into the project, no Maven/Gradle dependency\n- [**zunit**](java/zunit) — Generates and runs zunit tests for java-cli-app projects\n\n### Web\n\n- [**web-conventions**](web/web-conventions) — Composable baseline for all web frontends: semantic HTML, accessibility, design tokens, and Baseline browser-support policy\n- [**web-static**](web/web-static) — Modern static websites using semantic HTML and CSS without external dependencies or build systems; composes web-conventions\n- [**web-components**](web/web-components) — Single-page applications using web components, BCE layering, lit-html, Redux Toolkit, and client-side routing; composes web-conventions\n\n### BCE\n\n- [**bce**](bce/bce) — Composable, technology-neutral architecture rules for the Boundary-Control-Entity pattern: business components, layer responsibilities, and package structure\n- [**java-cli-app**](bce/java-cli-app) — Multi-file Java 25 CLI applications packaged as executable JARs with zb\n- [**microprofile-server**](bce/microprofile-server) — Architecture and coding conventions for long-running MicroProfile/Jakarta EE server applications using BCE pattern\n- [**continuous-testing**](bce/continuous-testing) — Test-driven loop on top of microprofile-server: builds, starts the server, and runs Unit, Integration, and System Tests after every change\n- [**showtime**](bce/showtime) — Live coding mode on top of any project skill: generates code without running tests or builds, for demos and workshops\n\n### Documentation\n\n- [**bce-diagrams**](documentation/bce-diagrams) — High-level overview diagrams showing interactions between business components, subsystems, and services\n- [**drawio**](documentation/drawio) — Draw.io overview diagrams with BCE shape mapping and consistent visual style\n- [**mermaid**](documentation/mermaid) — Mermaid overview diagrams for architecture and component visualization\n- [**readme**](documentation/readme) — Conventions for writing README.md files targeting advanced developers\n\n### Quickstarters\n\n- [**quarkus-microprofile**](https://github.com/AdamBien/quarkus-microprofile) — Quarkus MicroProfile template with BCE architecture, REST endpoints, CDI, and System Tests\n- [**bce.design**](https://github.com/AdamBien/bce.design) — Web Components starter with lit-html, Redux Toolkit, and standards-based routing (Navigation API + URLPattern)\n- [**ebank**](https://github.com/AdamBien/ebank) — CRUD with Quarkus, JPA, and PostgreSQL\n- [**java-cli-app**](https://github.com/AdamBien/java-cli-app) — Template for building zero-dependency Java CLI applications with zb\n- [**zeeds**](https://github.com/AdamBien/zeeds) — Zero-dependency Java 25+ source files as starting points, run directly with `java filename.java`","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadambien%2Fairails","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadambien%2Fairails","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadambien%2Fairails/lists"}