# ai.rizom.brain.card

> Published by [rizom.ai](https://lexicon.garden/identity/did:plc:oehciuqunzskplljt3qnnncw)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:oehciuqunzskplljt3qnnncw/ai.rizom.brain.card)
- [Documentation](https://lexicon.garden/lexicon/did:plc:oehciuqunzskplljt3qnnncw/ai.rizom.brain.card/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:oehciuqunzskplljt3qnnncw/ai.rizom.brain.card/examples)

## Definitions

### `ai.rizom.brain.card`

**Type**: `record`

Public discovery card for a Rizom brain. The operational A2A Agent Card is conventionally served at /.well-known/agent-card.json under siteUrl.

**Key**: `literal:self`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `brain` | `ref` → `#brain` | Yes | Brain identity described by this discovery card. |
| `model` | `string` | Yes | Rizom brain model identifier. |
| `anchor` | `ref` → `#anchor` | Yes | Minimal Anchor snapshot for discovery grouping and display. |
| `skills` | `array` | Yes | User-facing skills this brain advertises for discovery. |
| `siteUrl` | `string` (uri) | Yes | Public site URL. Consumers derive the A2A Agent Card URL from this base. |
| `version` | `string` | Yes | Brain runtime/model implementation version. |
| `createdAt` | `string` (datetime) | Yes |  |
| `updatedAt` | `string` (datetime) | No |  |

### `ai.rizom.brain.card#brain`

**Type**: `object`

Brain identity described by this discovery card.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `did` | `string` | Yes | Public DID for the brain identity. |
| `name` | `string` | Yes | Human-readable brain name. |
| `role` | `string` | Yes | Brain role or persona. |
| `values` | `array` | Yes | Public values or principles for this brain. |
| `purpose` | `string` | Yes | Short public description of what this brain is for. |

### `ai.rizom.brain.card#skill`

**Type**: `object`

User-facing skill this brain advertises for discovery.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | `string` | Yes |  |
| `name` | `string` | Yes |  |
| `tags` | `array` | No |  |
| `examples` | `array` | No |  |
| `description` | `string` | Yes |  |

### `ai.rizom.brain.card#anchor`

**Type**: `object`

Minimal Anchor snapshot for discovery grouping and display.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `did` | `string` | Yes | Public DID for the Anchor identity. |
| `kind` | `string` | Yes | Open semantic profile kind selected by the publishing brain. |
| `name` | `string` | Yes | Human-readable anchor name. |
| `category` | `string` | Yes | Stable structural category for discovery and grouping. |

## Raw Schema

```json
{
  "id": "ai.rizom.brain.card",
  "defs": {
    "main": {
      "key": "literal:self",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "siteUrl",
          "brain",
          "anchor",
          "skills",
          "model",
          "version",
          "createdAt"
        ],
        "properties": {
          "brain": {
            "ref": "#brain",
            "type": "ref",
            "description": "Brain identity described by this discovery card."
          },
          "model": {
            "type": "string",
            "description": "Rizom brain model identifier."
          },
          "anchor": {
            "ref": "#anchor",
            "type": "ref",
            "description": "Minimal Anchor snapshot for discovery grouping and display."
          },
          "skills": {
            "type": "array",
            "items": {
              "ref": "#skill",
              "type": "ref"
            },
            "maxLength": 100,
            "description": "User-facing skills this brain advertises for discovery."
          },
          "siteUrl": {
            "type": "string",
            "format": "uri",
            "description": "Public site URL. Consumers derive the A2A Agent Card URL from this base."
          },
          "version": {
            "type": "string",
            "description": "Brain runtime/model implementation version."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "updatedAt": {
            "type": "string",
            "format": "datetime"
          }
        }
      },
      "description": "Public discovery card for a Rizom brain. The operational A2A Agent Card is conventionally served at /.well-known/agent-card.json under siteUrl."
    },
    "brain": {
      "type": "object",
      "required": [
        "did",
        "name",
        "role",
        "purpose",
        "values"
      ],
      "properties": {
        "did": {
          "type": "string",
          "description": "Public DID for the brain identity."
        },
        "name": {
          "type": "string",
          "maxLength": 200,
          "description": "Human-readable brain name."
        },
        "role": {
          "type": "string",
          "maxLength": 500,
          "description": "Brain role or persona."
        },
        "values": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 200
          },
          "maxLength": 50,
          "description": "Public values or principles for this brain."
        },
        "purpose": {
          "type": "string",
          "maxLength": 2000,
          "description": "Short public description of what this brain is for."
        }
      },
      "description": "Brain identity described by this discovery card."
    },
    "skill": {
      "type": "object",
      "required": [
        "id",
        "name",
        "description"
      ],
      "properties": {
        "id": {
          "type": "string",
          "maxLength": 200
        },
        "name": {
          "type": "string",
          "maxLength": 200
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxLength": 50
        },
        "examples": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "maxLength": 20
        },
        "description": {
          "type": "string",
          "maxLength": 2000
        }
      },
      "description": "User-facing skill this brain advertises for discovery."
    },
    "anchor": {
      "type": "object",
      "required": [
        "did",
        "name",
        "category",
        "kind"
      ],
      "properties": {
        "did": {
          "type": "string",
          "description": "Public DID for the Anchor identity."
        },
        "kind": {
          "type": "string",
          "maxLength": 200,
          "description": "Open semantic profile kind selected by the publishing brain."
        },
        "name": {
          "type": "string",
          "maxLength": 200,
          "description": "Human-readable anchor name."
        },
        "category": {
          "type": "string",
          "description": "Stable structural category for discovery and grouping.",
          "knownValues": [
            "person",
            "team",
            "organization"
          ]
        }
      },
      "description": "Minimal Anchor snapshot for discovery grouping and display."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```