ARCOS – AI Rule-Constrained Orchestration System

ARCOS is a schema-driven framework for orchestrating AI agents under strict specification and validation rules. It defines how a Coordinator (Maestro) interacts with Speculus, Producer, Validator, and Post-Processor agents through domain-agnostic XML messaging validated against schemas. Each agent may implement domain-specific logic internally, but all inter-agent communication are standardized, verifiable, and schema-based.

📦 This repository publishes the ARCOS schemas (XSD), example XML files, documentation PDFs, and architecture diagrams.
🔗 It also provides a stable URL base for referencing schemas in XML documents.

---

✨ Why ARCOS?

• Deterministic AI orchestration – every interaction is validated against XSD contracts.
• Composable agents – swap in your own Producers, Validators, or Post-Processors.
• Domain-agnostic – bring your own schema; ARCOS will give it to each domain component.
• Fail-fast philosophy – invalid XML is rejected immediately.

🚀 Quick Links

• ARCOS Documentation (.io site)
• Schema Directory (XSD)
• Example XML Files
• ARCOS PDF Overview

📖 Getting Started

1. Clone this repo.
2. Validate an example XML against its schema with your favorite XSD validator.
3. Explore how Maestro coordinates Speculus → Producer → Validator → Post-Processor using the included diagrams.

---

📂 Repository Structure

ARCOS_Repo/
├── README.md # This file
├── LICENSE
├── CONTRIBUTING.md
├── index.html # Interactive architecture viewer (loads architecture.svg)
│
├── 1- Docs (Current)/ # Overview PDFs & support files
│ ├── 1-ARCOS.pdf
│ ├── 2-ARCOS-Architecture-and-Messaging.pdf
│ ├── 3-Domain and ARCOS-Speculus Guide.pdf
│ ├── 4-Domain-Producer Guide.pdf
│ ├── 5-Domain-Validator Guide.pdf
│ ├── 6-Domain-Post-Processor Guide.pdf
│ ├── 7-Domain-Filtering-Input Guide.pdf
│ ├── 8-ARCOS-Orchestrator Guide.pdf
│ ├── JPG/, SVG/, PNG/ # Supporting images for docs/viewer
│
├── 2- Components/ # Per-component details and sample XML
│ ├── Core Related/
│ │ ├── 1-ARCOS-Orchestrator/
│ │ ├── 2-ARCOS-Speculus/
│ ├── Domain Related/
│   ├─ 3-Domain-Speculus/
│   ├─ 4-Domain-Producer/
│   ├─ 5-Domain-Validator/
│   ├─ 6-Domain-Post-Processor/
│
└── 3- Stable/ # Published schemas (XSD), versioned & immutable
├── v0.3.1/
│ ├── Arcos_Project.xsd
│ ├── Maestro_.xsd
│ ├── Producer_Response.xsd
│ ├── Validator_.xsd
│ ├── PostProcessor_*.xsd
│ ├── Domain_Rules.xsd
│ ├── Predefined_Domain_Rules.xsd
│ ├── bleu_parts_v5.xsd
│ ├──
│ ├──
│ ├──
│ ├──                WORK in PROGRESS
│ ├──
│ ├──
│ ├──
│ ├──
│ ├──
│ ├──
└── latest/ # Copy of the most recent version (convenience for viewer)