AI-SEOS

AI Software Engineering Operating System

AI-SEOS adalah sebuah Operating System berbasis repository yang menyediakan aturan, pengetahuan, standar, workflow, dan artefak software engineering agar AI Agent dapat mengerjakan proyek perangkat lunak secara konsisten.

AI-SEOS tidak menjalankan AI.

AI-SEOS menjadi sumber kebenaran (Source of Truth) yang digunakan oleh AI Orchestrator seperti Antigravity, 9Router, atau sistem sejenis.

---

Purpose

AI-SEOS bertujuan untuk menstandarkan proses software engineering sehingga AI dapat:

• memahami kebutuhan stakeholder;
• menyusun rencana proyek;
• menghasilkan artefak software engineering;
• menjaga konsistensi pengetahuan;
• mengikuti standar engineering yang sama pada setiap proyek.

---

Scope

AI-SEOS mendefinisikan:

• Vision
• Governance
• Knowledge
• Context
• Workflow
• Roles
• Skills
• Tasks
• Artifacts
• Project Lifecycle
• Engineering Standards
• Templates
• Schemas
• Playbooks

AI-SEOS tidak mengimplementasikan AI Runtime maupun Large Language Model.

---

Core Principles

• Single Source of Truth
• Knowledge First
• Standardized Engineering
• Traceable Decisions
• Reusable Components
• Project Agnostic

---

Repository Structure

AI-SEOS/
├── *.md          Core specifications and governance
├── config/       Machine-readable repository configuration
├── schemas/      Data structure contracts
├── standards/    Engineering standards
├── playbooks/    Phase execution guidance
├── templates/    Artifact templates
├── quality/      Quality gates, review, and traceability
├── lifecycle/    Project and artifact lifecycle definitions
├── registry/     Component catalogs
├── examples/     Example project knowledge
├── outputs/      Isolated project artifacts and implementations
├── scripts/      Repository verification utilities
└── meta/         Repository decisions and improvement backlog

WORKFLOW.md adalah definisi Workflow kanonis. config/workflow.yaml menyediakan representasi machine-readable, sedangkan playbook menjabarkan aktivitas teknis setiap tahap atau subfase.

---

Quick Start

Prerequisites

• Git
• Node.js 18 atau lebih baru

Repository tidak memerlukan instalasi dependency karena verifier dan test suite hanya menggunakan modul bawaan Node.js.

Verification

Jalankan pemeriksaan kepatuhan repository:

node scripts/verify-seos.js

Jalankan test suite verifier:

node --test scripts/verify-seos.test.js

Pasang pre-commit hook opsional agar verifier dijalankan sebelum setiap commit:

node scripts/setup-hooks.js

Exit code 0 berarti pemeriksaan lulus. Exit code 1 berarti ditemukan pelanggaran yang harus diperbaiki. Warning menunjukkan review manual atau reverse sync yang diperlukan, tetapi tidak menggagalkan commit.

Verifier repository hanya memindai file yang dimiliki repository. Direktori yang diabaikan Git, termasuk proyek lokal terisolasi, tidak termasuk dalam pemeriksaan default.

Dokumentasi lengkap tersedia pada:

• CONTRIBUTING.md untuk alur kontribusi.
• docs/verification-spec.md untuk kontrak verifier.
• WORKFLOW.md untuk Workflow kanonis dan Tier.
• GOVERNANCE.md untuk aturan pengelolaan.
• docs/roadmap.md untuk status dan rencana pengembangan.

---

Target Users

• AI Orchestrator
• AI Agent
• Software Engineer
• Solution Architect
• System Analyst
• Technical Writer

---

License

Refer to LICENSE.