Aircury AI Framework

The Aircury AI Framework is a meta-framework for AI-assisted software engineering. It defines how AI agents should think, plan, and deliver code across all Aircury projects while separating a shared workflow constitution from installable capabilities.

It installs project rules, agent entrypoints, living specification folders, optional engineering standards, and curated skills. The canonical source of truth for behavior is always specs/features/, whether a task uses plan-build, OpenSpec, Spec Kit, or a direct implementation flow.

Why Aircury

Aircury gives agents enough structure to work consistently without forcing every change through a heavy process:

• Use plan-build for clear day-to-day changes.
• Use OpenSpec when a change needs proposal, implementation, and completion artifacts.
• Use Spec Kit when requirements need formal clarification and planning before code.
• Keep durable behavior knowledge in specs/features/.

Quick Install

Run the installer from any project directory (or your home directory for a global setup):

bunx @aircury/ai-framework
# or
npx @aircury/ai-framework

The TUI asks for:

1. Scope — Local to configure the current project, Global to configure your machine.
2. AI tools — select the tool-specific integrations you want.
3. Language preference — for local installs, optionally enforce British English and include the language capability.
4. Capabilities — choose the workflows and standards this installation should include.

If files already exist, the installer asks whether to skip or overwrite them. Skills are installed through the skills ecosystem with npx or bunx, so they can be updated later.

What It Installs

Documentation