ark

You are an expert Kubernetes CRD developer working on the ARK project. Your task is to generate a new Custom Resource Definition following ARK's established patterns and design guidelines.

Use this agent when designing architecture for new Ark features, planning component extensions, or evaluating technical approaches that need to align with existing codebase patterns. Examples: - User: "I need to add a new CRD for managing prompt templates" Assistant: "I'll use the ark-architect agent to design how this fits with existing Ark patterns." <launches ark-architect agent> - User: "How should we implement multi-tenant support in Ark?" Assistant: "This requires architectural planning. Let me use the ark-architect agent to analyze the codebase and design a solution." <launches ark-architect agent> - User: "We need to add webhook support to the executor service" Assistant: "I'll engage the ark-architect agent to examine existing webhook patterns in the operator and design a consistent approach." <launches ark-architect agent>

Orchestrates multi-phase Ark feature development using the task folder protocol. Manages task lifecycle, coordinates specialist agents (ark-architect, ark-prototyper), and tracks progress through objectives → architecture → prototype → outcome phases.

Use this agent to build minimal, verifiable prototypes of Ark features. It makes the smallest changes needed to demonstrate the architecture and user experience - minimal CRD updates, simple API endpoints, basic CLI commands, and dashboard UI. Examples: - User: "Prototype the ark-broker feature" Assistant: "I'll use the ark-prototyper agent to build a minimal working version." <launches ark-prototyper agent> - User: "Create a simple version we can test" Assistant: "Let me use the ark-prototyper to implement the minimum viable changes." <launches ark-prototyper agent>

Fix security vulnerabilities in Ark by researching CVEs, analyzing impact, proposing mitigations, implementing patches, and creating PRs. Use when the user reports CVE numbers or security issues that need fixing in Ark. Examples: - User: "Fix CVE-2025-55183 in Ark" Assistant: "I'll use the ark-security-patcher agent to research this vulnerability and apply a fix." <launches ark-security-patcher agent> - User: "The current version of golang has a vulnerability, fix it in ark" Assistant: "Let me use the ark-security-patcher agent to identify and fix this vulnerability." <launches ark-security-patcher agent> - User: "Patch the security issue in our dependencies" Assistant: "I'll engage the ark-security-patcher agent to analyze and remediate security vulnerabilities." <launches ark-security-patcher agent>

Research technical solutions by searching the web, examining GitHub repos, and gathering evidence. Use when exploring implementation options, evaluating technologies, or investigating how to solve a technical problem.

Reference documentation for the Agent2Agent (A2A) protocol. Use when building A2A servers or clients, configuring Ark A2AServer resources, debugging A2A communication, or answering questions about the A2A specification, Agent Cards, task lifecycle, streaming, extensions, or protocol bindings.

Analyze the Ark codebase by cloning the repository to a temporary location. Use this skill when the user asks questions about how Ark works, wants to understand Ark's implementation, or needs to examine Ark source code.

Design architecture for Ark features following existing patterns and principles. Use when planning new features, extending components, or evaluating technical approaches.

Guidance for developing the Ark Kubernetes operator. Use when modifying Go types, CRDs, controllers, or webhooks. Helps with CRD generation and Helm chart sync issues.

Regenerate and debug types across the ARK stack (SDK, API, Dashboard). Use when fixing TypeScript type errors in ark-dashboard, updating types after CRD changes, regenerating types.ts from OpenAPI spec, debugging "Property does not exist on type" schema errors, or adding custom SDK functionality via overlays. Covers the full type pipeline from Kubernetes CRDs to TypeScript.

Run and write Ark Chainsaw tests with mock-llm. Use for running tests, debugging failures, or creating new e2e tests.

Test the Ark Dashboard and UI with Playwright and create PRs with screenshots. Use this skill when testing dashboard UI, taking screenshots for PRs, or validating dashboard changes.

Consolidate open Dependabot PRs into a single integration branch. Use when the user asks to "consolidate dependabot", "merge dependabot PRs", "batch dependency updates", or mentions dependabot PR management.

Guidance for structuring Ark documentation using the Diataxis framework. Use this skill when creating new docs, deciding where content belongs, reviewing documentation PRs, or restructuring existing documentation.

Structured workflow for drafting NEW GitHub issues with codebase research, duplicate detection, task breakdowns, and testing approach. Always asks clarifying questions and shows the draft for approval before creating. For searching, listing, viewing, or updating existing issues, use the "issues" skill instead.

Search, list, view, and update existing GitHub issues. Primary use case is CVE tracking and security vulnerability issue management. Used by the ark-security-patcher agent. For drafting NEW issues with research and task breakdowns, use the "issue-creation" skill instead.

Resolve common penetration testing issues in Ark. Use when fixing security vulnerabilities from pentest reports, security audits, or OWASP Top 10 issues.

Research technical solutions by searching the web, examining GitHub repos, and gathering evidence. Use when exploring implementation options or evaluating technologies.

Set up and install the Ark platform from source. Use this skill when the user wants to install, deploy, or configure Ark in their local Kubernetes cluster.

CVE research and security patch workflow for Ark. Provides CVE API integration, mitigation strategies, and security-focused PR templates. Works with research, analysis, and setup skills for comprehensive vulnerability fixing.