Skip to content

VM4AI AIR Kit v0.2.2

Choose a tag to compare

@eddlev eddlev released this 15 Jun 15:10

AIR v0.2.2 — Beginner orientation, cooperative work and release notes

AIR v0.2.2 is a documentation and release-hygiene update for the public prompt-based AIR Kit.

This release updates the README and roadmap to match the latest Q1-D onboarding behavior. Q1-D is now documented as a beginner orientation path, not a project activation shortcut or generic tutorial branch.

Changes

  • Updated Q1-D wording from “onboarding tutorial” to “beginner orientation.”
  • Clarified that Q1-D is instructional only and must return to Q1 without activating a project.
  • Added cooperative-work framing to the README.
  • Documented that AIR is cooperative, not automatic: the user steers intent, constraints, corrections, and approvals; AIR protects scope, structure, evidence, blockers, continuity, and next actions.
  • Documented that Q1-D should visibly offer an optional dynamic example AIR project before returning to Q1.
  • Clarified that the example offer is required, but running the example is optional.
  • Clarified that examples should be generated dynamically and interactively, not hardcoded as a fixed canned demo.
  • Updated the roadmap to mark v0.2.1 as released.
  • Added v0.2.2 as the next documentation/examples/release-hygiene track.

Why this matters

AIR depends on deterministic onboarding. The startup phrase “Start a new AIR project” may trigger the first activation flow, but it must not silently answer Q1 as “A. New project.”

This release makes the first-use path clearer:

  1. AIR boots.
  2. AIR asks Q1.
  3. If the user chooses D, AIR explains AIR in beginner-facing language.
  4. AIR explains cooperative work.
  5. AIR offers an optional example project.
  6. AIR returns to Q1.
  7. The user chooses the actual project path.

That keeps onboarding deterministic while making AIR easier to understand for new users.

Scope boundary

This release does not add backend validation, runtime enforcement outside the model session, signed contracts, autonomous execution, or private AIR backend/client features.

AIR remains a prompt-native project runtime kit.

Prompt-side discipline is not backend validation.

Suggested smoke test

After updating, start a fresh model session with the AIR prompt files and type:

Start a new AIR project.

Expected behavior:

  • AIR asks Q1.
  • AIR does not infer Q1 = A.
  • Choosing D starts beginner orientation only.
  • The orientation includes cooperative-work framing.
  • The orientation asks whether the user wants an example AIR project.
  • If the user asks for an example, AIR generates a dynamic interactive example.
  • AIR returns to Q1 without activating a project.

Release type

Documentation / release notes.