type: schema name: AgentCard schema specification last_updated: 2026-05-12

AgentCard YAML schema

Кожен index.md агента має наступний YAML frontmatter. Поля required (R) та optional (O):

---
# Identity
type: agent                          # R: agent | director | crew | subagent | schema | org-chart
name: Display Name                   # R: human-readable
slug: agent-slug                     # R: unique kebab-case
kind: subagent                       # R: crew | subagent | single | director | orchestrator
department: it                       # R: it | marketing | content | legal | hr | ceo

# Hierarchy
reports_to: it-director              # R: parent agent slug (or "human (Сергій)" for CEO direct reports)
manages: [agent-a, agent-b]          # O: direct reports if this is a director/crew

# Status
status: active                       # R: active | planned | idle-manual | scheduled | disabled | error
readiness_pct: 80                    # O: 0-100

# Runtime
implementation: systemd-service      # R: systemd-service | systemd-timer | crewai | gemini-cli | rest-api | claude-cli | manual
runtime: python3 + crewai            # O: тех-стек
model: gemini-3.1-pro-preview        # O: LLM-модель або null
trigger: cron                        # R: cron | event | manual | on-demand
schedule: "0 4 * * *"                # O: cron expression якщо trigger=cron
endpoint: http://127.0.0.1:9000      # O: HTTP endpoint якщо REST API
source_dir: /srv/projects/foo        # O: де код

# Capabilities (для capability discovery)
skills:                              # R: list of skills для skill→agent inverted index
  - skill-tag-1
  - skill-tag-2
responsibilities:                    # R: list of responsibilities
  - what they do day-to-day

# Connections
projects_involved:                   # O: список slug'ів проектів wiki
  - project-slug-1
tools:                               # O: список tools/integrations
  - BigQuery
  - Gemini API

# Lifecycle
created: 2026-05-12                  # R
last_updated: 2026-05-12             # R
last_audit: null                     # O: коли HR-agent востаннє аудитував
---

Convention notes

• slug має бути унікальним по всьому штату (HR-agent перевіряє)
• manages для director = список direct reports
• manages для crew = список ролей crew (внутрішні агенти CrewAI)
• manages для subagent = [] (пусто)
• reports_to: human (Сергій) для CEO direct reports (vps-claude, desktop-claude)
• reports_to: ceo НЕ використовуємо — CEO це human
• department: ceo означає що це CEO direct report (orchestrator, infra)

Field examples

skills — це capability tags. Орієнтир: 3-7 skills per agent, kebab-case. Приклади: google-ads-mcc, bigquery-pipeline, gcp-iam-audit, cron-monitoring, creative-fatigue-detection, legal-bad-compliance-ua, web-scraping-playwright, vector-semantic-search, markdown-rendering.

responsibilities — human-readable bullets. Приклад: «daily ГРВІ-кейс модерація», «щотижневий audit cookies expire».

projects_involved — slug із wiki-index.py registry проектів. Приклад: [ad-analytics-hub, med-detective].