# AGENTS REGISTRY
# Status: VERSIONED. Capability declarations of all agents.
# Version: 1.0.1
# Loaded by: orchestrators on routing decisions. Updated via PR + ADR.

# ─────────────────────────────────────────────────────
# LAYER 4 — SPECIALIST AGENTS (execute via skills)
# ─────────────────────────────────────────────────────

# ╔══════════════════════════════════════════════════╗
# ║  CLIENT-SIDE SPECIALISTS                          ║
# ╚══════════════════════════════════════════════════╝

frontend-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  state: stateless
  primary_orchestrator: frontend_orch
  capabilities:
    - generate_react_component
    - generate_vue_component
    - generate_svelte_component
    - implement_design_from_figma
    - implement_responsive_layout
    - state_management_setup
    - performance_optimization
    - accessibility_audit
    - storybook_setup
  preferred_skills:
    - shadcn
    - vercel-react-best-practices
    - tailwind-design-system
    - nextjs-app-router-patterns
    - frontend-design
    - web-design-guidelines
    - accessibility
    - react-state-management
  budget_default_usd: 0.50
  quality_threshold: 0.85
  fallbacks: [generalist-engineer]

mobile-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  state: stateless
  primary_orchestrator: frontend_orch
  capabilities:
    - generate_react_native_component
    - implement_swiftui_view
    - implement_jetpack_compose
    - implement_flutter_widget
    - configure_push_notifications
    - integrate_capacitor
  preferred_skills:
    - vercel-react-native-skills
    - swiftui-pro
    - flutter-apply-architecture-best-practices
    - appium-skill
  budget_default_usd: 0.50
  fallbacks: [frontend-specialist]

# ╔══════════════════════════════════════════════════╗
# ║  SERVER-SIDE SPECIALISTS                          ║
# ╚══════════════════════════════════════════════════╝

backend-node-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: backend_orch
  capabilities:
    - design_rest_api
    - design_graphql_schema
    - implement_nestjs_module
    - implement_express_route
    - integrate_database
    - implement_auth_flow
  preferred_skills:
    - nodejs-backend-patterns
    - nestjs-best-practices
    - fastapi-templates
    - graphql-schema
    - openapi-spec-generation
  budget_default_usd: 0.50

backend-python-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: backend_orch
  capabilities:
    - implement_fastapi_endpoint
    - implement_django_view
    - implement_flask_route
    - pydantic_model_design
    - python_performance_optimization
    - mcp_server_python
  preferred_skills:
    - fastapi-templates
    - django-patterns
    - django-security
    - flask-python
    - python-performance-optimization
    - python-mcp-server-generator
  budget_default_usd: 0.50

data-engineer-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: backend_orch
  capabilities:
    - database_schema_design
    - migration_writing
    - vector_db_setup
    - search_engine_integration
    - data_pipeline_construction
    - orm_implementation
  preferred_skills:
    - postgresql-table-design
    - supabase-postgres-best-practices
    - mongodb-schema-design
    - pinecone-docs
    - elasticsearch-esql
  budget_default_usd: 0.50

# ╔══════════════════════════════════════════════════╗
# ║  INTELLIGENCE SPECIALISTS                         ║
# ╚══════════════════════════════════════════════════╝

ai-agent-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: ai_ml_orch
  capabilities:
    - claude_api_integration
    - langchain_chain_construction
    - rag_pipeline_design
    - mcp_server_construction
    - llm_evaluation_setup
  preferred_skills:
    - claude-api
    - langchain-fundamentals
    - langchain-rag
    - mcp-builder
    - rag-implementation
  budget_default_usd: 0.80
  may_escalate_to: planner-opus

vision-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: ai_ml_orch
  capabilities:
    - image_generation
    - image_editing
    - ocr_processing
    - object_detection
    - face_detection
    - document_parsing
  preferred_skills:
    - ai-image-generation
    - flux-best-practices
    - paddleocr-text-recognition
    - segment-anything-model
    - mediapipe-pose-detection

audio-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: ai_ml_orch
  capabilities:
    - text_to_speech
    - speech_to_text
    - music_generation
    - voice_cloning
    - audio_processing
  preferred_skills:
    - elevenlabs/text-to-speech
    - openai-whisper
    - elevenlabs/music
    - ai-voice-cloning
    - livekit-agents

video-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: ai_ml_orch
  capabilities:
    - video_generation
    - video_editing
    - subtitle_generation
    - video_processing
  preferred_skills:
    - ai-video-generation
    - rw-generate-video
    - google-veo
    - kling-3-0
    - ffmpeg

# ╔══════════════════════════════════════════════════╗
# ║  OPERATIONS SPECIALISTS                           ║
# ╚══════════════════════════════════════════════════╝

devops-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: devops_orch
  capabilities:
    - dockerize
    - kubernetes_manifest
    - terraform_module
    - ci_cd_pipeline
    - aws_infrastructure
    - azure_infrastructure
    - gcp_infrastructure
  preferred_skills:
    - docker-expert
    - azure-kubernetes
    - terraform-module-library
    - github-actions-docs
    - aws-cdk
    - gcloud-cli
    - pulumi-best-practices

observability-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: devops_orch
  capabilities:
    - setup_metrics
    - setup_logs
    - setup_traces
    - configure_alerts
    - error_tracking_integration
  preferred_skills:
    - prometheus
    - loki
    - tempo
    - otel-instrumentation
    - sentry-nextjs-sdk
    - find-bugs

# ╔══════════════════════════════════════════════════╗
# ║  QUALITY & SECURITY SPECIALISTS                   ║
# ╚══════════════════════════════════════════════════╝

qa-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: qa_orch
  capabilities:
    - write_unit_test
    - write_integration_test
    - write_e2e_test
    - mutation_testing
    - property_based_testing
    - chaos_testing
  preferred_skills:
    - test-driven-development
    - webapp-testing
    - playwright-best-practices
    - vitest
    - testcontainers-go
    - mutation-testing
    - chaos-engineer

security-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: security_orch
  capabilities:
    - security_review
    - owasp_audit
    - pentest_simulation
    - dependency_scan
    - secrets_audit
  preferred_skills:
    - security-review
    - owasp-security
    - hack
    - sqli-sql-injection
    - xss-cross-site-scripting
    - snyk-fix

auditor-haiku:
  layer: 4
  role: specialist
  model: haiku-4-5   # cheap auditor
  state: stateless
  primary_orchestrator: any
  capabilities:
    - validate_output_against_schema
    - check_constitutional_compliance
    - rca_on_incident
    - suggest_remediation
  invoked_after: every_artifact_generation
  budget_default_usd: 0.02
  always_available: true

# ╔══════════════════════════════════════════════════╗
# ║  QUANT/FINANCE SPECIALISTS                        ║
# ╚══════════════════════════════════════════════════╝

quant-analyst-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: finance_trading_orch
  capabilities:
    - technical_analysis
    - fundamental_analysis
    - backtesting
    - risk_metrics_calculation
    - portfolio_optimization
  preferred_skills:
    - backtesting-frameworks
    - risk-metrics-calculation
    - vectorbt-expert
    - longbridge-smc
    - kelly-criterion
    - dcf-model
    - equity-research
    - macro-rates-monitor

trader-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: finance_trading_orch
  capabilities:
    - strategy_implementation
    - exchange_integration
    - arbitrage_detection
    - market_making
  preferred_skills:
    - ccxt-python
    - yahoo-finance
    - mql5-indicator-patterns

# ╔══════════════════════════════════════════════════╗
# ║  INTEGRATIONS SPECIALISTS                         ║
# ╚══════════════════════════════════════════════════╝

payments-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: integrations_orch
  capabilities:
    - stripe_integration
    - paypal_integration
    - subscription_management
    - webhook_handling
  preferred_skills:
    - stripe-best-practices
    - stripe-webhooks
    - paypal-webhooks

communications-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: integrations_orch
  capabilities:
    - whatsapp_integration
    - telegram_bot
    - discord_bot
    - slack_integration
    - email_dispatch
  preferred_skills:
    - whatsapp-automation
    - telegram-bot-builder
    - discord-bot
    - slack-messaging
    - resend
    - postmark

# ╔══════════════════════════════════════════════════╗
# ║  META SPECIALISTS                                 ║
# ╚══════════════════════════════════════════════════╝

planner-opus:
  layer: 4
  role: planner
  model: opus-4-7
  state: stateless
  primary_orchestrator: cortex
  invoked_when:
    - complexity_score > 0.8
    - novel_problem
    - architectural_decision_required
    - meta_learning_review
  capabilities:
    - deep_planning
    - tree_of_thoughts
    - reflexion
    - constitutional_review
  budget_default_usd: 3.00
  use_sparingly: true

doc-writer-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  primary_orchestrator: meta_orch
  capabilities:
    - generate_prd
    - generate_adr
    - generate_readme
    - technical_writing
    - api_documentation
  preferred_skills:
    - prompt-engineering-patterns
    - crafting-effective-readmes
    - documentation-and-adrs
    - technical-writing

# ─────────────────────────────────────────────────────
# LAYER 5 — WORKER AGENTS (stateless, atomic)
# ─────────────────────────────────────────────────────

code-writer-worker:
  layer: 5
  role: worker
  model: haiku-4-5
  state: stateless
  capabilities: [write_file, edit_file]
  invoked_by: any_specialist
  budget_default_usd: 0.05
  max_duration_seconds: 30

file-operator-worker:
  layer: 5
  role: worker
  model: haiku-4-5
  state: stateless
  capabilities: [read_file, list_dir, glob_search, grep]
  budget_default_usd: 0.02

api-caller-worker:
  layer: 5
  role: worker
  model: haiku-4-5
  state: stateless
  capabilities: [http_request, retry_with_backoff]
  budget_default_usd: 0.05

test-runner-worker:
  layer: 5
  role: worker
  model: haiku-4-5
  state: stateless
  capabilities: [run_command, parse_test_output]
  budget_default_usd: 0.05

git-worker:
  layer: 5
  role: worker
  model: haiku-4-5
  state: stateless
  capabilities: [git_status, git_diff, git_log, git_commit]
  budget_default_usd: 0.02

# ╔══════════════════════════════════════════════════╗
# ║  EXPANSION SPECIALISTS (Sessão #5)                ║
# ╚══════════════════════════════════════════════════╝

writing-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  state: stateless
  primary_orchestrator: meta_orch
  primary_area: writing-content
  capabilities:
    - draft_technical_documentation
    - write_adr
    - draft_readme
    - prompt_engineering
    - brand_voice_writing
  preferred_skills:
    - technical-writing
    - crafting-effective-readmes
    - adr-architecture
    - prompt-engineering
    - prompt-engineering-patterns
    - brand-guidelines
    - branding
  budget_default_usd: 0.30
  quality_threshold: 0.80
  fallbacks: [generalist-engineer]

automation-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  state: stateless
  primary_orchestrator: integrations_orch
  primary_area: automation
  capabilities:
    - design_workflow_dag
    - implement_scraper
    - schedule_recurring_job
    - build_n8n_workflow
  preferred_skills:
    - airflow
    - airflow-dag-patterns
    - dagster-expert
    - n8n-mcp-tools-expert
    - n8n-workflow-patterns
    - puppeteer-automation
    - scrapy-web-scraping
    - apify-ultimate-scraper
  budget_default_usd: 0.40
  quality_threshold: 0.85
  fallbacks: [backend-python-specialist]

analytics-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  state: stateless
  primary_orchestrator: backend_orch
  primary_area: analytics
  capabilities:
    - instrument_event_tracking
    - design_funnel_analysis
    - configure_feature_flags
    - debug_analytics_pipeline
  preferred_skills:
    - posthog-instrumentation
    - posthog-debugger
    - mixpanel
    - amplitude
    - plausible
    - statsig
    - flags-sdk
  budget_default_usd: 0.30
  quality_threshold: 0.80

mathematics-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  state: stateless
  primary_orchestrator: finance_trading_orch
  primary_area: mathematics
  capabilities:
    - quantitative_research
    - risk_modeling
    - backtest_strategy
  preferred_skills:
    - quantitative-research
    - risk-metrics-calculation
    - backtesting-frameworks
  budget_default_usd: 0.40
  quality_threshold: 0.85

communication-specialist:
  layer: 4
  role: specialist
  model: sonnet-4-6
  state: stateless
  primary_orchestrator: integrations_orch
  primary_area: comunicacao
  capabilities:
    - integrate_slack_workspace
    - build_discord_bot
    - send_whatsapp_message
    - publish_to_bluesky
  preferred_skills:
    - slack-messaging
    - slack-workflows
    - discord
    - discord-bot
    - discord-bot-architect
    - automate-whatsapp
    - integrate-whatsapp
    - observe-whatsapp
    - bluesky
    - telegram-bot
  budget_default_usd: 0.25
  quality_threshold: 0.80

# ─────────────────────────────────────────────────────
# AGENT REGISTRY META
# ─────────────────────────────────────────────────────
_meta:
  total_specialists: 25
  total_workers: 5
  total_orchestrators: 12   # 1 global + 10 domain + N task (ephemeral)

  global_rules:
    - all_agents_must_declare_capabilities
    - all_agents_must_declare_budget
    - all_agents_must_validate_outputs
    - all_specialists_must_emit_quality_score
    - all_workers_must_be_idempotent

  version_policy:
    breaking_change: bump_major
    capability_added: bump_minor
    prompt_tweak: bump_patch