Agent manifest schema

# agents/<name>.yaml

# Required — unique identifier for this agent
name: string

# Required — "coordinator" or "specialist"
role: coordinator | specialist

# Required — human-readable description of the agent's purpose
description: string

# Required — LLM model configuration
model:
  provider: anthropic | openai | ollama   # LLM provider
  model: string                            # model identifier (e.g. "claude-sonnet-4-6")

# Required — the system prompt injected on every task
# Supports ${variable} interpolation for runtime values
system_prompt: |
  Multi-line system prompt text...

# Required — skills this agent can always invoke
# Skills not in this list are only available if allow_discovery is true
pinned_skills:
  - skill-name-1
  - skill-name-2

# Optional — whether the agent can discover and invoke skills not in pinned_skills
# Default: false
allow_discovery: boolean

# Optional — inject the list of available specialist agents into the system prompt
# Used by the coordinator to know which specialists it can delegate to
# Default: false
inject_specialists: boolean

# Optional — custom handler for agent-specific logic
# Path relative to the agent YAML file
handler: ./custom-handler.ts

# Optional — memory scope configuration
# Scopes isolate this agent's working memory from other agents
memory:
  scopes:
    - scope-name