prpm.json

{
  "name": "agent-relay",
  "version": "1.0.0",
  "description": "Real-time agent-to-agent communication system for CLI agents (Claude Code, Codex, Cursor)",
  "author": "khaliqgant",
  "organization": "agent-relay",
  "license": "MIT",
  "repository": "https://github.com/khaliqgant/agent-relay",
  "homepage": "https://agentrelay.com",
  "packages": [
    {
      "name": "choosing-swarm-patterns",
      "version": "1.0.0",
      "description": "Use when coordinating multiple AI agents and need to pick the right orchestration pattern - covers 10 patterns (fan-out, pipeline, hub-spoke, consensus, mesh, handoff, cascade, dag, debate, hierarchical) with decision framework and reflection protocol",
      "format": "claude",
      "subtype": "skill",
      "tags": [
        "multi-agent",
        "orchestration",
        "swarm-patterns",
        "workflow",
        "coordination",
        "agent-management"
      ],
      "files": ["skills/choosing-swarm-patterns/SKILL.md"]
    },
    {
      "name": "adding-swarm-patterns",
      "version": "1.0.0",
      "description": "Use when implementing custom swarm coordination patterns for multi-agent systems - covers pattern design, implementation strategies, and integration with existing agent orchestration",
      "format": "claude",
      "subtype": "skill",
      "tags": [
        "swarm-patterns",
        "multi-agent",
        "orchestration",
        "coordination",
        "architecture",
        "workflow-design"
      ],
      "files": ["skills/adding-swarm-patterns/SKILL.md"]
    },
    {
      "name": "writing-agent-relay-workflows",
      "version": "1.0.3",
      "description": "Use when building multi-agent workflows with the relay broker-sdk - covers the WorkflowBuilder API, DAG step dependencies, agent definitions, step output chaining via {{steps.X.output}}, verification gates, deterministic steps, dedicated channels, swarm patterns, error handling, event listeners, step sizing rules, and the lead+workers team pattern for complex steps",
      "format": "claude",
      "subtype": "skill",
      "tags": ["workflow", "multi-agent", "dag", "orchestration", "broker-sdk", "swarm-patterns"],
      "files": ["skills/writing-agent-relay-workflows/SKILL.md"]
    },
    {
      "name": "using-agent-relay",
      "version": "1.2.0",
      "description": "Use when coordinating multiple AI agents in real-time - provides inter-agent messaging via Relaycast MCP tools with channels, threads, reactions, search, and webhooks",
      "format": "claude",
      "subtype": "skill",
      "tags": ["multi-agent", "agent-communication", "inter-agent", "coordination", "real-time", "messaging"],
      "files": ["skills/using-agent-relay/SKILL.md"]
    },
    {
      "name": "running-headless-orchestrator",
      "version": "1.0.0",
      "description": "Use when an agent needs to self-bootstrap agent-relay and autonomously manage a team of workers - covers infrastructure startup, agent spawning, lifecycle monitoring, and team coordination without human intervention",
      "format": "claude",
      "subtype": "skill",
      "tags": [
        "multi-agent",
        "orchestration",
        "headless",
        "autonomous",
        "self-bootstrap",
        "agent-management"
      ],
      "files": ["skills/running-headless-orchestrator/SKILL.md"]
    },
    {
      "name": "agent-relay-snippet",
      "version": "1.2.0",
      "description": "AGENTS.md / CLAUDE.md snippet for agents on how to use agent-relay",
      "format": "generic",
      "subtype": "snippet",
      "snippet": {
        "target": "AGENTS.md",
        "position": "append",
        "header": "Agent Relay"
      },
      "files": ["relay-snippets/agent-relay-snippet.md"]
    },
    {
      "name": "agent-relay-protocol",
      "version": "1.1.1",
      "description": "Internal protocol snippet with session persistence, continuity, and trajectory tracking for dashboard integration",
      "format": "generic",
      "subtype": "snippet",
      "private": true,
      "snippet": {
        "target": "AGENTS.md",
        "position": "append",
        "header": "Agent Relay Protocol"
      },
      "files": ["relay-snippets/agent-relay-protocol.md"]
    },
    {
      "name": "shadow-agents",
      "version": "1.0.0",
      "description": "Shadow agent profiles for code review, session auditing, and active monitoring - assign to spawned agents for oversight",
      "format": "claude",
      "subtype": "agent",
      "tags": ["shadow", "review", "audit", "monitoring", "oversight", "code-review"],
      "files": [
        ".claude/agents/shadow-reviewer.md",
        ".claude/agents/shadow-auditor.md",
        ".claude/agents/shadow-active.md"
      ]
    },
    {
      "name": "agent-policy-snippet",
      "version": "1.0.0",
      "description": "Agent policy rules snippet - informs agents of spawn, messaging, and tool restrictions",
      "format": "generic",
      "subtype": "snippet",
      "snippet": {
        "target": "AGENTS.md",
        "position": "append",
        "header": "Agent Policy"
      },
      "tags": ["policy", "rules", "permissions", "authorization", "security", "multi-agent"],
      "files": ["relay-snippets/agent-policy-snippet.md"]
    },
    {
      "name": "lead-agent",
      "version": "1.0.1",
      "description": "Coordinator agent for multi-agent teams - delegates tasks, makes decisions, tracks progress without implementing",
      "format": "claude",
      "subtype": "agent",
      "tags": ["coordination", "delegation", "leadership", "multi-agent", "project-management"],
      "files": [".claude/agents/lead.md"]
    },
    {
      "name": "frontend-agent",
      "version": "1.0.1",
      "description": "Frontend development agent - creates distinctive, production-grade web interfaces with high design quality",
      "format": "claude",
      "subtype": "agent",
      "tags": ["frontend", "react", "css", "design", "ui-ux", "web-development"],
      "files": [".claude/agents/frontend.md"]
    },
    {
      "name": "backend-agent",
      "version": "1.0.1",
      "description": "Backend development agent - APIs, services, server-side logic, and database integration",
      "format": "claude",
      "subtype": "agent",
      "tags": ["backend", "api", "server", "database", "services", "nodejs"],
      "files": [".claude/agents/backend.md"]
    },
    {
      "name": "database-agent",
      "version": "1.0.1",
      "description": "Database specialist agent - schema design, query optimization, migrations, and data modeling",
      "format": "claude",
      "subtype": "agent",
      "tags": ["database", "sql", "postgresql", "migrations", "schema-design", "optimization"],
      "files": [".claude/agents/database.md"]
    },
    {
      "name": "api-designer-agent",
      "version": "1.0.1",
      "description": "API design agent - REST and GraphQL API design, endpoint schemas, versioning, and documentation",
      "format": "claude",
      "subtype": "agent",
      "tags": ["api", "rest", "graphql", "api-design", "openapi", "documentation"],
      "files": [".claude/agents/api-designer.md"]
    },
    {
      "name": "debugger-agent",
      "version": "1.0.1",
      "description": "Debugging specialist agent - systematic bug investigation, root cause analysis, and minimal targeted fixes",
      "format": "claude",
      "subtype": "agent",
      "tags": ["debugging", "troubleshooting", "root-cause-analysis", "bug-fixing", "investigation"],
      "files": [".claude/agents/debugger.md"]
    },
    {
      "name": "refactorer-agent",
      "version": "1.0.1",
      "description": "Refactoring specialist agent - code restructuring, technical debt reduction, and maintainability improvements",
      "format": "claude",
      "subtype": "agent",
      "tags": ["refactoring", "technical-debt", "code-quality", "maintainability", "clean-code"],
      "files": [".claude/agents/refactorer.md"]
    },
    {
      "name": "performance-agent",
      "version": "1.0.1",
      "description": "Performance optimization agent - profiling, bottleneck analysis, and performance improvements",
      "format": "claude",
      "subtype": "agent",
      "tags": ["performance", "optimization", "profiling", "bottlenecks", "benchmarking"],
      "files": [".claude/agents/performance.md"]
    },
    {
      "name": "tester-agent",
      "version": "1.0.1",
      "description": "Testing specialist agent - unit tests, integration tests, e2e tests, and test strategy",
      "format": "claude",
      "subtype": "agent",
      "tags": ["testing", "unit-tests", "integration-tests", "e2e", "test-coverage", "tdd"],
      "files": [".claude/agents/tester.md"]
    },
    {
      "name": "security-agent",
      "version": "1.0.1",
      "description": "Security auditing agent - vulnerability assessment, OWASP compliance, and security best practices",
      "format": "claude",
      "subtype": "agent",
      "tags": ["security", "vulnerability", "owasp", "audit", "penetration-testing", "compliance"],
      "files": [".claude/agents/security.md"]
    },
    {
      "name": "qa-agent",
      "version": "1.0.1",
      "description": "Quality assurance agent - test planning, defect tracking, and quality metrics",
      "format": "claude",
      "subtype": "agent",
      "tags": ["qa", "quality-assurance", "test-planning", "defect-tracking", "quality-metrics"],
      "files": [".claude/agents/qa.md"]
    },
    {
      "name": "accessibility-agent",
      "version": "1.0.1",
      "description": "Accessibility auditing agent - WCAG compliance, a11y testing, and inclusive design",
      "format": "claude",
      "subtype": "agent",
      "tags": ["accessibility", "a11y", "wcag", "inclusive-design", "screen-readers", "aria"],
      "files": [".claude/agents/accessibility.md"]
    },
    {
      "name": "validator-agent",
      "version": "1.0.1",
      "description": "Validation specialist agent - input validation, schema enforcement, and data integrity",
      "format": "claude",
      "subtype": "agent",
      "tags": ["validation", "input-validation", "schema", "data-integrity", "sanitization"],
      "files": [".claude/agents/validator.md"]
    },
    {
      "name": "documentor-agent",
      "version": "1.0.0",
      "description": "Documentation specialist agent - technical docs, API documentation, and README files",
      "format": "claude",
      "subtype": "agent",
      "tags": ["documentation", "technical-writing", "api-docs", "readme", "jsdoc"],
      "files": [".claude/agents/documentor.md"]
    },
    {
      "name": "explainer-agent",
      "version": "1.0.0",
      "description": "Code explanation agent - architecture walkthroughs, code explanation, and knowledge transfer",
      "format": "claude",
      "subtype": "agent",
      "tags": ["explanation", "architecture", "code-review", "knowledge-transfer", "onboarding"],
      "files": [".claude/agents/explainer.md"]
    },
    {
      "name": "reviewer-agent",
      "version": "1.0.0",
      "description": "Code review agent - quality checks, best practices, and constructive feedback",
      "format": "claude",
      "subtype": "agent",
      "tags": ["code-review", "best-practices", "feedback", "quality", "pull-requests"],
      "files": [".claude/agents/reviewer.md"]
    },
    {
      "name": "researcher-agent",
      "version": "1.0.0",
      "description": "Research specialist agent - codebase exploration, investigation, and information gathering",
      "format": "claude",
      "subtype": "agent",
      "tags": ["research", "exploration", "investigation", "codebase-analysis", "information-gathering"],
      "files": [".claude/agents/researcher.md"]
    },
    {
      "name": "architect-agent",
      "version": "1.0.0",
      "description": "System architecture agent - design decisions, technical planning, and architectural patterns",
      "format": "claude",
      "subtype": "agent",
      "tags": ["architecture", "system-design", "technical-planning", "design-patterns", "scalability"],
      "files": [".claude/agents/architect.md"]
    },
    {
      "name": "devops-agent",
      "version": "1.0.1",
      "description": "DevOps specialist agent - CI/CD pipelines, infrastructure as code, and deployment automation",
      "format": "claude",
      "subtype": "agent",
      "tags": ["devops", "ci-cd", "infrastructure", "automation", "deployment", "docker"],
      "files": [".claude/agents/devops.md"]
    },
    {
      "name": "devops-ci-agent",
      "version": "1.0.0",
      "description": "CI/CD specialist agent - pipeline configuration, build optimization, and continuous integration",
      "format": "claude",
      "subtype": "agent",
      "tags": ["ci-cd", "pipelines", "github-actions", "jenkins", "build-automation"],
      "files": [".claude/agents/devops-ci.md"]
    },
    {
      "name": "migrator-agent",
      "version": "1.0.1",
      "description": "Migration specialist agent - data migrations, schema changes, and version upgrades",
      "format": "claude",
      "subtype": "agent",
      "tags": ["migration", "data-migration", "schema-changes", "version-upgrades", "database"],
      "files": [".claude/agents/migrator.md"]
    },
    {
      "name": "deployer-agent",
      "version": "1.0.1",
      "description": "Deployment specialist agent - release management, deployment automation, and rollback strategies",
      "format": "claude",
      "subtype": "agent",
      "tags": ["deployment", "release-management", "rollback", "blue-green", "canary"],
      "files": [".claude/agents/deployer.md"]
    },
    {
      "name": "monitor-agent",
      "version": "1.0.1",
      "description": "Monitoring specialist agent - observability setup, alerting, and metrics configuration",
      "format": "claude",
      "subtype": "agent",
      "tags": ["monitoring", "observability", "alerting", "metrics", "logging", "tracing"],
      "files": [".claude/agents/monitor.md"]
    },
    {
      "name": "sysadmin-agent",
      "version": "1.0.1",
      "description": "System administration agent - server configuration, system maintenance, and infrastructure management",
      "format": "claude",
      "subtype": "agent",
      "tags": ["sysadmin", "linux", "server-management", "configuration", "infrastructure"],
      "files": [".claude/agents/sysadmin.md"]
    },
    {
      "name": "data-agent",
      "version": "1.0.1",
      "description": "Data engineering agent - ETL pipelines, data processing, and data quality",
      "format": "claude",
      "subtype": "agent",
      "tags": ["data-engineering", "etl", "data-pipelines", "data-quality", "data-processing"],
      "files": [".claude/agents/data.md"]
    },
    {
      "name": "mobile-agent",
      "version": "1.0.1",
      "description": "Mobile development agent - React Native, iOS, Android, and cross-platform development",
      "format": "claude",
      "subtype": "agent",
      "tags": ["mobile", "react-native", "ios", "android", "cross-platform"],
      "files": [".claude/agents/mobile.md"]
    },
    {
      "name": "cli-agent",
      "version": "1.0.1",
      "description": "CLI development agent - command-line tools, terminal utilities, and Unix philosophy",
      "format": "claude",
      "subtype": "agent",
      "tags": ["cli", "command-line", "terminal", "unix", "shell-scripting"],
      "files": [".claude/agents/cli.md"]
    },
    {
      "name": "integrator-agent",
      "version": "1.0.1",
      "description": "Integration specialist agent - third-party APIs, webhooks, OAuth, and service integration",
      "format": "claude",
      "subtype": "agent",
      "tags": ["integration", "api", "webhooks", "oauth", "third-party"],
      "files": [".claude/agents/integrator.md"]
    },
    {
      "name": "prototyper-agent",
      "version": "1.0.1",
      "description": "Rapid prototyping agent - MVPs, proof of concepts, and quick validation",
      "format": "claude",
      "subtype": "agent",
      "tags": ["prototyping", "mvp", "proof-of-concept", "rapid-development", "validation"],
      "files": [".claude/agents/prototyper.md"]
    },
    {
      "name": "fixer-agent",
      "version": "1.0.1",
      "description": "Quick fix specialist agent - hotfixes, urgent patches, and rapid bug resolution",
      "format": "claude",
      "subtype": "agent",
      "tags": ["hotfix", "quick-fix", "urgent", "bug-fix", "patches"],
      "files": [".claude/agents/fixer.md"]
    },
    {
      "name": "opencode-relay-plugin",
      "version": "0.1.0",
      "description": "OpenCode plugin for Agent Relay - native tools, idle polling hooks, worker spawning, and multi-agent orchestration",
      "format": "generic",
      "subtype": "plugin",
      "tags": ["opencode", "plugin", "multi-agent", "relaycast", "tools", "hooks"],
      "files": [
        "plugins/opencode-relay-plugin/src/index.ts",
        "plugins/opencode-relay-plugin/src/tools.ts",
        "plugins/opencode-relay-plugin/src/hooks.ts",
        "plugins/opencode-relay-plugin/package.json",
        "plugins/opencode-relay-plugin/tsconfig.json"
      ]
    },
    {
      "name": "gemini-relay-extension",
      "version": "0.1.0",
      "description": "Gemini CLI extension for Agent Relay - MCP server, lifecycle hooks, custom commands, and multi-agent skills",
      "format": "generic",
      "subtype": "plugin",
      "tags": ["gemini-cli", "extension", "multi-agent", "relaycast", "mcp", "hooks"],
      "files": [
        "plugins/gemini-relay-extension/gemini-extension.json",
        "plugins/gemini-relay-extension/relay-server.js",
        "plugins/gemini-relay-extension/hooks/hooks.json",
        "plugins/gemini-relay-extension/hooks/after-tool-inbox.sh",
        "plugins/gemini-relay-extension/hooks/after-agent-inbox.sh",
        "plugins/gemini-relay-extension/hooks/before-model-inject.sh",
        "plugins/gemini-relay-extension/hooks/session-start.sh",
        "plugins/gemini-relay-extension/hooks/session-end.sh",
        "plugins/gemini-relay-extension/commands/status/status.toml",
        "plugins/gemini-relay-extension/commands/team/team.toml",
        "plugins/gemini-relay-extension/commands/fanout/fanout.toml",
        "plugins/gemini-relay-extension/skills/relay-orchestration/SKILL.md",
        "plugins/gemini-relay-extension/skills/relay-protocol/SKILL.md",
        "plugins/gemini-relay-extension/agents/relay-worker.md",
        "plugins/gemini-relay-extension/agents/relay-researcher.md",
        "plugins/gemini-relay-extension/agents/relay-reviewer.md",
        "plugins/gemini-relay-extension/GEMINI.md"
      ]
    }
  ],
  "collections": [
    {
      "id": "agent-relay-skills",
      "name": "Agent Relay Skills",
      "description": "Core skills for multi-agent coordination — swarm patterns, workflow building, relay usage, and headless orchestration",
      "version": "1.0.0",
      "category": "development",
      "tags": ["multi-agent", "orchestration", "skills", "swarm-patterns", "workflow"],
      "packages": [
        {
          "packageId": "using-agent-relay",
          "version": "^1.0.0",
          "required": true,
          "reason": "Core skill for inter-agent messaging via Relaycast MCP tools"
        },
        {
          "packageId": "choosing-swarm-patterns",
          "version": "^1.0.0",
          "required": true,
          "reason": "Decision framework for selecting the right multi-agent coordination pattern"
        },
        {
          "packageId": "adding-swarm-patterns",
          "version": "^1.0.0",
          "required": false,
          "reason": "For implementing custom swarm patterns beyond the built-in set"
        },
        {
          "packageId": "writing-agent-relay-workflows",
          "version": "^1.0.0",
          "required": true,
          "reason": "WorkflowBuilder API for DAG-based multi-agent workflows"
        },
        {
          "packageId": "running-headless-orchestrator",
          "version": "^1.0.0",
          "required": false,
          "reason": "For autonomous orchestration without human intervention"
        }
      ]
    },
    {
      "id": "agent-relay-complete",
      "name": "Agent Relay Complete",
      "description": "Everything needed for multi-agent coordination — all skills, agents, snippets, and CLI plugins bundled together",
      "version": "1.0.0",
      "category": "development",
      "tags": ["multi-agent", "complete", "all-in-one", "orchestration", "agent-relay"],
      "packages": [
        {
          "packageId": "using-agent-relay",
          "version": "^1.0.0",
          "required": true,
          "reason": "Core inter-agent messaging skill"
        },
        {
          "packageId": "choosing-swarm-patterns",
          "version": "^1.0.0",
          "required": true,
          "reason": "Swarm pattern decision framework"
        },
        {
          "packageId": "adding-swarm-patterns",
          "version": "^1.0.0",
          "required": false,
          "reason": "Custom swarm pattern implementation"
        },
        {
          "packageId": "writing-agent-relay-workflows",
          "version": "^1.0.0",
          "required": true,
          "reason": "WorkflowBuilder API for DAG workflows"
        },
        {
          "packageId": "running-headless-orchestrator",
          "version": "^1.0.0",
          "required": false,
          "reason": "Autonomous headless orchestration"
        },
        {
          "packageId": "agent-relay-snippet",
          "version": "^1.0.0",
          "required": true,
          "reason": "AGENTS.md snippet for relay usage instructions"
        },
        {
          "packageId": "agent-relay-protocol",
          "version": "^1.0.0",
          "required": false,
          "reason": "Internal protocol snippet for dashboard integration"
        },
        {
          "packageId": "agent-policy-snippet",
          "version": "^1.0.0",
          "required": false,
          "reason": "Agent policy rules for spawn and messaging restrictions"
        },
        {
          "packageId": "lead-agent",
          "version": "^1.0.0",
          "required": true,
          "reason": "Lead coordinator agent for multi-agent teams"
        },
        {
          "packageId": "shadow-agents",
          "version": "^1.0.0",
          "required": false,
          "reason": "Shadow agents for code review, auditing, and monitoring"
        },
        {
          "packageId": "opencode-relay-plugin",
          "version": "^0.1.0",
          "required": false,
          "reason": "OpenCode native plugin"
        },
        {
          "packageId": "gemini-relay-extension",
          "version": "^0.1.0",
          "required": false,
          "reason": "Gemini CLI native extension"
        }
      ]
    }
  ]
}