How eddlev/vm4ai-air-kit works
AIR is a prompt-based framework for carrying structured AI project work across conversations and compatible platforms, not a standalone service stack. The principal workflow loads the Foundation, onboards a project, maintains an active task and recorded evidence, applies approval boundaries to material actions, then carries project state forward through a validated Handoff. Route and Specialist catalogs support discovery; Specialist packages add focused capabilities. The README and tree establish these product branches. Sampled validators corroborate contract and Handoff boundaries, but do not expose the complete prompt runtime, so uncertain internal wiring is omitted.
Main entry points: AIR_SPECIALIST_PACKAGE_INDEX.json Specialist Package Index · AIR_CORE_RUNTIME.md Core Runtime · AIR_CONTROL_SURFACE.md Control Surface · AIR_DEFAULT_STARTER_PROFILE.json Starter Profile
Components 18
Foundation Runtime
- Core Runtime
prompts/AIR_CORE_RUNTIME.md - Control Surface
prompts/AIR_CONTROL_SURFACE.md - Governance Rules
prompts/AIR_GOV.md - Starter Profile
prompts/AIR_DEFAULT_STARTER_PROFILE.json - Approval Boundaries
prompts/AIR_CONTROL_SURFACE.md
Project Continuity
- Project State
prompts/AIR_CORE_RUNTIME.md - Active Task
prompts/AIR_CORE_RUNTIME.md - Evidence and Blockers
prompts/AIR_CORE_RUNTIME.md - Handoff Card
prompts/AIR_HANDOFF_CARD_TEMPLATE.json
Capability Discovery
- Runtime Route Map
catalog/AIR_RUNTIME_ROUTE_MAP.json - Specialist Package Index
catalog/AIR_SPECIALIST_PACKAGE_INDEX.json
Specialist Packages
- Capability Ecology
profiles/capability ecology architect/AIR_CAPABILITY_ECOLOGY_ARCHITECT.json - AI Governance
profiles/governance specialist/AIR_AI_GOVERNANCE_SPECIALIST.json - Grounding
profiles/grounding specialist/AIR_GROUNDING_SPECIALIST.json - Public Copywriting
profiles/public surface copywriting specialist/AIR_PUBLIC_SURFACE_COPYWRITING_SPECIALIST.json - Specification Verification
profiles/specification first verification specialist/AIR_SPECIFICATION_FIRST_VERIFICATION_SPECIALIST.json
Other components
- Human
- Compatible AI Platform
Connections 20
- Human → Compatible AI Platform: starts project
- Compatible AI Platform → Core Runtime: loads foundation
- Compatible AI Platform → Control Surface: loads foundation
- Compatible AI Platform → Governance Rules: loads foundation
- Compatible AI Platform → Starter Profile: loads foundation
- Starter Profile → Core Runtime: supports onboarding
- Core Runtime → Project State: frames project
- Core Runtime → Active Task: organizes work
- Active Task → Evidence and Blockers: records findings
- Control Surface → Approval Boundaries: defines approval
- Human → Approval Boundaries: approves scope
- Project State → Handoff Card: carries recorded state
- Handoff Card → Compatible AI Platform: restores for validation
- Compatible AI Platform → Runtime Route Map: consults routes
- Compatible AI Platform → Specialist Package Index: discovers packages
- Specialist Package Index → Capability Ecology: lists package
- Specialist Package Index → AI Governance: lists package
- Specialist Package Index → Grounding: lists package
- Specialist Package Index → Public Copywriting: lists package
- Specialist Package Index → Specification Verification: lists package