Agent contract

ck-brain

Generic L1 router and orchestrator that selects one declared route and delegates a structured handoff.

Role: router-orchestrator
Fibonacci level: L1
Module version: v0.1.0
Author: chiralkit
Created: 2026-08-13
Dependencies: None declared

Input

Required fields

request
routes

min_routes: 1
optional: context
route_required: name
agent
description
route_names_unique: true
route_agents_non_empty: true

Output states and sections

states: routed
unrouted
invalid_configuration
delegation_failed
routed_required: status
route
agent
reason
handoff
delegated_result
unrouted_required: status
reason
candidates
invalid_configuration_required: status
reason
delegation_failed_required: status
route
agent
reason
handoff
error

Behavior and invariants

classification_source: route.description
route_name_semantics: opaque_identifier_and_output_only
ambiguous_intent: unrouted
max_routes_selected: 1
max_delegations: 1
direct_edits: false
direct_l3_delegation: false
invent_routes: false
preserve_delegated_result: true
delegation_completion: terminal_completion
delegated_result_source: terminal_result_verbatim

Additional contract boundaries

handoff

required: task
context_notes
constraints

Capabilities

This legacy contract does not declare a separate capabilities manifest.

Runtime entries

Implementations

claude-code: implementations/claude-code/ck-brain.md
codex: implementations/codex/ck-brain.toml

Complete validated contract JSON

{
  "role": "router-orchestrator",
  "input": {
    "required": [
      "request",
      "routes"
    ],
    "min_routes": 1,
    "optional": [
      "context"
    ],
    "route_required": [
      "name",
      "agent",
      "description"
    ],
    "route_names_unique": true,
    "route_agents_non_empty": true
  },
  "handoff": {
    "required": [
      "task",
      "context_notes",
      "constraints"
    ]
  },
  "output": {
    "states": [
      "routed",
      "unrouted",
      "invalid_configuration",
      "delegation_failed"
    ],
    "routed_required": [
      "status",
      "route",
      "agent",
      "reason",
      "handoff",
      "delegated_result"
    ],
    "unrouted_required": [
      "status",
      "reason",
      "candidates"
    ],
    "invalid_configuration_required": [
      "status",
      "reason"
    ],
    "delegation_failed_required": [
      "status",
      "route",
      "agent",
      "reason",
      "handoff",
      "error"
    ]
  },
  "behavior": {
    "classification_source": "route.description",
    "route_name_semantics": "opaque_identifier_and_output_only",
    "ambiguous_intent": "unrouted",
    "max_routes_selected": 1,
    "max_delegations": 1,
    "direct_edits": false,
    "direct_l3_delegation": false,
    "invent_routes": false,
    "preserve_delegated_result": true,
    "delegation_completion": "terminal_completion",
    "delegated_result_source": "terminal_result_verbatim"
  }
}