CEED Router & Version 1.0

The CEED Router is the checking component defined by the CEED Specification. It checks a CEED Delivery Contract at connected merge and deployment gates. Any team can build one with its existing tools. The CEED Project builds a CEED Router for Git and GitHub, open source (Apache 2.0), to demonstrate the model end to end.

The CEED Project's CEED Router for Git and GitHub is expected in January 2027, and the CEED Framework does not wait for it. You can implement the published CEED Specification, schemas and CEED Conformance Pack with your own tools now, with no license fee.

CEED Routers any team can build and share.

Adopting the CEED Framework does not depend on the CEED Project:

  • The CEED Specification, schemas and CEED Conformance Pack are published and openly licensed (CC BY 4.0), with no license fee.
  • Your team can build its own CEED Router with the tools it already runs, without waiting for the CEED Project's CEED Router for Git and GitHub.
  • An implementation can run entirely within your organization's own systems.
  • No team has to use the CEED Project's CEED Router or depend on its maintainers.

Teams can publish their CEED Router in partnership with the CEED Project for other organizations to use. The CEED Project recommends keeping the CEED Delivery Contract and CEED Change Passport formats, so approvals and histories read the same on every platform and every new CEED Router strengthens the shared standard.

The CEED Delivery Contract and CEED Change Passport are the shared record formats. The CEED Specification defines their meaning: scope decisions, evidence interpretation, checkpoint order, retained history and reporting. CEED Router implementations differ by platform. Within their declared conformance scope, they must make the same decisions and produce the same CEED Change Passport records. The CEED Conformance Pack supplies cases for testing that agreement. Engineers, auditors and replacement tools can read the same approval history across implementations.

The CEED Project invites organizations and tool producers to build CEED Router implementations for GitLab and Git in Azure Repos. Teams can also connect CEED results to IT change management tools such as ServiceNow or Jira Service Management. More delivery environments can then use the same approval records.

Test your own implementation against the recorded checks.

To test that agreement, start with the corrected CEED Conformance Pack Guide. It records 1,967 executed checks on the published test cases, with expected results and a coverage map. Reproduce that run, then compare your implementation's outputs with the expected results that apply. You can also try the CEED Framework on one change with CEED in Practice, your existing tools and no new software.

Read the recorded test results →

The CEED Project's first implementation targets Git and GitHub. It brings issuance checks, exact-revision decisions, required deployment checks and CEED Change Passport recording into one CEED Router. It is open source (Apache 2.0): teams may use, modify and redistribute it. The CEED Specification's Git rules apply to any Git host through its own tested platform profile.

What the CEED Router checks

Check the scope

The CEED Router compares every changed file with the allowed and protected scope in the issued CEED Delivery Contract. An extra edit needs approval even when its tests pass.

Evaluate the delivery gates

The CEED Router checks required evidence for each exact revision and required deployment checkpoint. It records the decision before the governed action proceeds.

Keep the history

The CEED Router connects issued CEED Delivery Contract versions, decisions and production findings in the CEED Change Passport. Local reports let reviewers examine those records and follow their references to retained evidence.

The Version 1.0 release

Version 1.0 brings the CEED Specification, the CEED Conformance Pack and the CEED Router together as one stable release. The CEED Delivery Contract (schema version 1.0) and the CEED Change Passport remain the shared standard. Version 1.0 does not change their formats. It adds the CEED Router and aligns the Git platform rules with real GitHub workflows. Implementations for other platforms bring their own tested mappings. Before publication, the CEED Router exercises the CEED Specification against real GitHub workflows and at least one deployment path. The release will show the rules working in actual merge and deployment decisions. The CEED Specification's Git rules apply to any Git host through a tested platform profile for that host.