Domain Intelligence Schema (DIS) v1.6

Official JSON Schema definitions for the Domain Intelligence System - A grammar for modeling and deploying agentic AI systems in enterprise environments.

🎯 What is DIS?

DIS is "Terraform for Agentic AI" — a declarative specification that captures:

• Domain structure (entities, roles, applications)
• Behavioral rules (AgenticTriplets: Entity-Mode-Role)
• Execution bindings (functions, endpoints, workflows)
• Governance (RBAC, privacy, telemetry, change management)

Think of it as the BNF for business units, providing a formal grammar (not taxonomy) for composing valid domain models.

🚀 Quick Start

IDE Integration

Reference schemas directly for autocomplete and validation:

{
  "$schema": "https://schemas.domainintelligenceschema.org/dis/1.6.0/DISDossier.schema.json",
  "dossierId": "customer-service-v1",
  "name": "Customer Service Domain",
  "disSpecificationRef": "1.6.0"
}

Validation

# Using AJV with CDN
ajv validate \
  -s https://schemas.domainintelligenceschema.org/dis/1.6.0/DISDossier.schema.json \
  -d my-dossier.json

# Using local schemas
ajv validate -s schemas/v1.6.0/DISDossier.schema.json -d my-dossier.json

Type Generation

# TypeScript
json-schema-to-typescript \
  https://schemas.domainintelligenceschema.org/dis/1.6.0/Entity.schema.json \
  > types/Entity.ts

# Python
datamodel-codegen \
  --url https://schemas.domainintelligenceschema.org/dis/1.6.0/Entity.schema.json \
  --output models/entity.py

📚 Schema Catalog

23 Core Constructs organized into 6 categories:

Foundation (2)

• CommonEnums - Centralized vocabulary (31 enums)
• DISDossier - Root container and manifest

Identity & Structure (5)

• Entity - Data objects and AI agents
• Role - Behavioral capacities
• Application - Software systems
• Endpoint - API interfaces
• Modes - Mode collections

Behavioral Grammar (2)

• AgenticTriplet - Core behavioral unit
• ModeOfInteractionRegistryEntry - Mode metadata

Matrices (4)

• AccessGateMatrix - RBAC rules
• EntityModeMatrix - Capability mapping
• RelationshipMatrix - Construct relationships
• TripletFunctionMatrixEntry - Execution bindings

Supporting Constructs (4)

• FunctionCatalogEntry - Reusable functions
• KnowledgeDocument - RAG artifacts
• TagDefinition - Metadata taxonomy
• ValidationRule - Business rules

Business Value & Governance (6) — NEW in v1.6

• ValueEngineeringProfile - ROI metrics
• DossierComparison - Version deltas
• PrivacyManifest - GDPR/CCPA compliance
• TelemetryConfiguration - Observability
• MarketplaceEntry - Publishing metadata
• ChangeManagementRecord - ITIL change management

🎨 Key Features

7 Canonical Modes

The atomic verbs that force proper entity discovery:

• CREATE - Bring new data into existence
• READ - Retrieve and query data
• UPDATE - Modify existing data
• DELETE - Remove data
• INITIATE - Start asynchronous interactions
• RESPOND - Reply to initiated interactions
• NOTIFY - Send one-way alerts

Zero Vendor Lock-in

v1.6 removes all proprietary references. Compile to:

• LangGraph
• CrewAI
• AWS Bedrock Agents
• Microsoft AutoGen
• Or custom platforms

JMESPath Expressions

Standardized query and transformation language for:

• Validation rules
• Access gate conditions
• Payload transformations
• Data filtering

📖 Documentation

• Live Schema Browser
• Canonical URIs
• Schema Index
• Repository Documentation Map
• Architecture
• Runbook
• Repository Documentation Map
• Architecture
• Runbook

🔧 Development

Validate All Schemas

./scripts/validate-schemas.sh

Sync from CDN

./scripts/sync-from-cdn.sh

📦 Distribution

Canonical URIs:

• Base: https://schemas.domainintelligenceschema.org/dis/1.6.0/
• Index: https://schemas.domainintelligenceschema.org/dis/1.6.0/index.json
• Docs: https://schemas.domainintelligenceschema.org/docs/

Features:

• ✅ CORS-enabled for web tools
• ✅ Immutable 1-year cache
• ✅ CDN-optimized delivery
• ✅ HTTPS with managed certificates

🤝 Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Validate your changes with ./scripts/validate-schemas.sh
4. Submit a pull request

📄 License

Apache License 2.0 - See LICENSE for details

🔗 Links

• Official Website
• Schema Browser
• Issue Tracker

📊 Version History

• v1.6.0 (Q1 2026) - First production-ready release
  • 23 core constructs
  • CommonEnums centralization
  • JMESPath standardization
  • 6 new governance constructs
  • Zero vendor lock-in

---

Status: ✅ Production Ready | Release: Q1 2026