Skip to content

Appendix: Model-to-Task Type Mapping Schema

Archive notice: This page documents historical Spec Kitty behavior and is not the current 3.2 workflow. Start with Spec Kitty 3.2 for current docs.

$schema: "https://json-schema.org/draft/2020-12/schema"
$id: "https://spec-kitty.ai/schemas/doctrine/model-to-task_type.schema.yaml"
title: Model-to-Task Type Mapping
description: Catalog of model capabilities, costs, and routing policy for task assignment.
type: object
additionalProperties: false
required:
- schema_version
- generated_at
- task_types
- models
- routing_policy
- sources
properties:
schema_version:
type: string
pattern: '^1\.0$'
generated_at:
type: string
format: date-time
source_snapshot:
type: string
description: Optional source snapshot ID/hash for traceability.
task_types:
type: array
minItems: 1
items:
type: object
additionalProperties: false
required:
- id
- title
properties:
id:
type: string
pattern: '^[a-z][a-z0-9-]*$'
title:
type: string
minLength: 1
description:
type: string
quality_sensitivity:
type: string
enum: [ low, medium, high ]
cost_sensitivity:
type: string
enum: [ low, medium, high ]
models:
type: array
minItems: 1
items:
type: object
additionalProperties: false
required:
- id
- provider
- task_fit
- cost
properties:
id:
type: string
minLength: 1
provider:
type: string
minLength: 1
family:
type: string
tools:
type: array
items:
type: string
minLength: 1
strengths:
type: array
items:
type: string
weaknesses:
type: array
items:
type: string
task_fit:
type: array
minItems: 1
items:
type: object
additionalProperties: false
required:
- task_type
- score
properties:
task_type:
type: string
pattern: '^[a-z][a-z0-9-]*$'
score:
type: number
minimum: 0
maximum: 1
confidence:
type: string
enum: [ low, medium, high ]
rationale:
type: string
cost:
type: object
additionalProperties: false
required:
- tier
properties:
tier:
type: string
enum: [ low, medium, high, premium ]
input_per_1m_usd:
type: number
minimum: 0
output_per_1m_usd:
type: number
minimum: 0
currency:
type: string
default: USD
pricing_source_url:
type: string
format: uri
latency_tier:
type: string
enum: [ low, medium, high ]
routing_policy:
type: object
additionalProperties: false
required:
- objective
- weights
- override_policy
properties:
objective:
type: string
enum: [ quality_first, balanced, cost_first ]
weights:
type: object
additionalProperties: false
required: [ quality, cost, risk, latency ]
properties:
quality:
type: number
minimum: 0
maximum: 1
cost:
type: number
minimum: 0
maximum: 1
risk:
type: number
minimum: 0
maximum: 1
latency:
type: number
minimum: 0
maximum: 1
tier_constraints:
type: array
items:
type: object
additionalProperties: false
required: [ task_type, max_tier ]
properties:
task_type:
type: string
pattern: '^[a-z][a-z0-9-]*$'
max_tier:
type: string
enum: [ low, medium, high, premium ]
override_policy:
type: object
additionalProperties: false
required: [ mode, require_reason ]
properties:
mode:
type: string
enum: [ advisory, gated, required ]
require_reason:
type: boolean
freshness_policy:
type: object
additionalProperties: false
properties:
max_catalog_age_hours:
type: integer
minimum: 1
sources:
type: array
minItems: 1
items:
type: object
additionalProperties: false
required:
- name
- url
- access_method
- snapshot_at
properties:
name:
type: string
minLength: 1
url:
type: string
format: uri
access_method:
type: string
enum: [ api, dataset, manual ]
snapshot_at:
type: string
format: date-time
license_notes:
type: string

Proposed Data Model (Mermaid)

defines

contains

applies

cites

priced_as

scored_for

matched_by

uses

enforces

limits

constrained_by

MODEL_TASK_CATALOG

string

schema_version

datetime

generated_at

string

source_snapshot

TASK_TYPE

string

id

string

title

string

description

string

quality_sensitivity

string

cost_sensitivity

MODEL_PROFILE

string

id

string

provider

string

family

string[]

tools

string[]

strengths

string[]

weaknesses

string

latency_tier

ROUTING_POLICY

string

objective

SOURCE_ENTRY

string

name

string

url

string

access_method

datetime

snapshot_at

string

license_notes

COST_PROFILE

string

tier

float

input_per_1m_usd

float

output_per_1m_usd

string

currency

string

pricing_source_url

MODEL_TASK_FIT

string

task_type

float

score

string

confidence

string

rationale

WEIGHT_VECTOR

float

quality

float

cost

float

risk

float

latency

OVERRIDE_POLICY

string

mode

boolean

require_reason

TIER_CONSTRAINT

string

task_type

string

max_tier