v0.1.0: AICaC Specification & GitHub Action

🚀 AICaC v0.1.0 - First Public Release

First official release of AI Context as Code (AICaC) - a structured approach to AI-readable project documentation.

📦 What's Included

Specification

• ✅ Complete AICaC whitepaper (23KB)
• ✅ .ai/ directory convention
• ✅ Four compliance levels
• ✅ Token efficiency validation

GitHub Action

• ✅ Smart auto-mode detection - automatically bootstraps or maintains
• ✅ Setup mode - Creates PR to adopt AICaC
• ✅ Maintain mode - Validates compliance and updates badges
• ✅ 99 tests, 81% coverage

Badging System

• ✅ Visual compliance indicators
• ✅ Automatic updates
• ✅ Four levels: None, Minimal, Standard, Comprehensive

🎯 Quick Start

Add this workflow to .github/workflows/aicac.yml:

name: AICaC Adoption

on:
  push:
    branches: [main]
  workflow_dispatch:

jobs:
  aicac:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v3

      - name: Check if .ai exists
        id: check
        run: |
          if [ -d ".ai" ]; then
            echo "mode=maintain" >> $GITHUB_OUTPUT
          else
            echo "mode=setup" >> $GITHUB_OUTPUT
          fi

      - uses: eFAILution/AICaC/.github/actions/aicac-adoption@v0.1.0
        with:
          mode: ${{ steps.check.outputs.mode }}
          github-token: ${{ secrets.GITHUB_TOKEN }}
          update-badge: 'true'

Important: Enable Actions to create PRs in Settings > Actions > General > Workflow permissions

📚 Documentation

• Complete Specification
• Action Documentation
• Badge Guide
• Testing Guide

🔬 Validation Results

• 40-60% token reduction vs traditional documentation
• 15-25% faster task completion (empirically validated)
• Direct queryability for AI assistants

🙏 Contributing

We welcome contributions! See the repository for details.

---

Making AI-readable documentation a reality.