agent.yaml Reference

spec_version: "0.4.0"
name: code-review-agent
version: 1.0.0
description: Automated code review agent
author: gitagent-examples
license: MIT
model:
  preferred: claude-sonnet-4-5-20250929
  fallback:
    - claude-haiku-4-5-20251001
  constraints:
    temperature: 0.2
    max_tokens: 4096
skills:
  - code-review
tools:
  - lint-check
  - complexity-analysis
runtime:
  max_turns: 20
  timeout: 120

spec_version: "0.4.0"
name: my-agent
version: 1.0.0
description: A full-featured agent example

model:
  preferred: "claude-sonnet-4-6"
  fallback: ["claude-haiku-4-5-20251001"]
  constraints:
    temperature: 0.7
    max_tokens: 4096

tools: [cli, read, write, memory]
skills:
  - code-review

runtime:
  max_turns: 50
  timeout: 300

# Agent inheritance — clone identity + rules from a parent repo
extends: https://github.com/user/parent-agent.git

# Git-based skill/tool dependencies (opengap install resolves these)
dependencies:
  - name: shared-skills
    source: https://github.com/team/shared-skills
    version: main
    mount: deps/shared

# Sub-agent definitions
agents:
  researcher:
    description: "Research assistant"
    delegation:
      mode: auto

delegation:
  mode: auto

# MCP server configuration (v0.4)
mcp_servers:
  my-server:
    command: "npx"
    args: ["-y", "@my/mcp-server"]

# Agent-to-Agent (A2A) protocol support (v0.4)
a2a:
  url: "https://my-agent.example.com/a2a"
  capabilities: ["task", "stream"]
  authentication:
    type: bearer
  protocols: ["a2a/1.0"]

compliance:
  risk_tier: high
  supervision:
    human_in_the_loop: "always"
  frameworks: [finra, federal_reserve]
  recordkeeping:
    audit_logging: true
    retention_period: "7y"
  financial_governance:
    spending:
      max_per_transaction_cents: 10000
    approval:
      require_above_cents: 5000
    firewall: "valkurai"