Skip to content

ainfera-ai/specs

specs

Open methodology for Ainfera's outcome-aware inference routing — routing methodology, API contracts, and schema validators.

License: CC BY 4.0 CI

Visibility PUBLIC
Primary Language Python
Created 2026-05-14
Last Updated 2026-06-16

Quick Start

  1. Clone: git clone https://github.com/ainfera-ai/specs.git
  2. Install validators: pip install jsonschema
  3. Run all schema validators: python scripts/validate_all_schemas.py
  4. Read specs in order: _meta/alignment.mdontology/spec.md → choose your path below.

Specs

Spec Status Description
Ontology v1.0 Active Layer ontology, core entity catalog, internal agent roles, stakeholder model
Auth v1.0 Active API key format, storage, transport, deprecation, rotation (ainfera_* prefix, AIN-368)
ATS v1.0 Deprecated Retired 2026-05-22 — folded into L2 Routing q_empirical (AIN-243)
AAMC v1.1 Deprecated Retired 2026-05-22 — deliberation council; M_allowed gate survives in Routing
Annex IV mapping Active EU AI Act Annex IV technical documentation → Ainfera primitive mapping
A2A v1.0 Active Agent-to-Agent communication primitive
Alignment matrix Active External standards composition matrix
Baseline methodology v0.1 Draft Public savings-counterfactual methodology and third-party verifier contract
Status Active Per-spec lifecycle status

Compose, don't invent

Every specification in this repository opens with an Alignment section showing which external standards it composes. We do not propose to replace:

We implement them. See _meta/alignment.md for the full composition matrix.

Reading order

  1. Start with _meta/alignment.md — the composition matrix establishing how Ainfera relates to the external standards landscape.
  2. Read ontology/spec.md — the vocabulary and layer model used throughout the other specs.
  3. Then choose your path:

Versioning

Each specification carries a YAML front-matter version (version: 1.0) and an independent CHANGELOG. Tagged releases on this repository use <spec>-v<version> (e.g. ats-v1.0).

  • Major version bumps signal breaking changes to schemas or semantics.
  • Minor version bumps signal clarifications, examples, and additions that do not break conformance.

Internal pre-public drafts (versions below 1.0) are not republished in this repository.

Attribution

When reusing a specification from this repository, please attribute:

Based on <Spec Name> v<version> by Ainfera Inc., licensed under CC-BY 4.0.

License

This repository is part of the Ainfera project.

About

Open methodology for Ainfera outcome-aware inference routing — API contracts and benchmark harness.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages