Ga naar hoofdinhoud

Available agents & skills

The Hydra pipeline is built from four agents (containerised personas with scoped permissions) plus a large catalogue of skills (reusable workflows invoked as slash-commands inside Claude Code). This page catalogs both.

πŸ’‘ Skills live in two repos. Hydra's own .claude/skills/ ships the pipeline-side workflow (opsx-, hydra-gate-, team-, test-, journeydoc-, utilities). The concurrentie-analyse repo ships the upstream research and app-pipeline catalogue (specter-, tender-, ecosystem-, app-, swc-).

Pipeline agents​

The four containerised personas that move a change from ready-to-build through code-review, security-review, and a binary apply gate to a draft PR ready for one human approval. Each agent runs in its own ephemeral container with scoped permissions and a single responsibility β€” see hydra/agents/README.md for the directory layout and per-agent purpose.md / behavior.md / constraints.md.

PersonaSlugRoleContainerModelTurns
Al Gorithmal-gorithmBuilder β€” implements the change against the OpenSpec proposal, pushes a feature branch early, opens a draft PRhydra-builderopus200
Juan Claude van Dammejuan-claude-van-dammeCode Reviewer β€” reviews PR, posts findings, has fix authority (ADR-013 no-loop policy)hydra-reviewersonnet200
Clyde Barcodeclyde-barcodeSecurity Reviewer β€” SAST analysis, posts findings, has fix authorityhydra-securitysonnet150
Axel PliΓ©raxel-plierApplier β€” binary go/no-go gate after both reviewers, no fix authorityhydra-appliersonnet20

Shared config lives in agents/base.yaml; each agent's config.yaml extends it kustomize-style.

Hydra skills (hydra/.claude/skills/)​

OpenSpec workflow β€” opsx-*​

The day-to-day flow for spec-driven development. The canonical chain:

/opsx-new β†’ /opsx-ff or /opsx-continue β†’ /opsx-plan-to-issues β†’ /opsx-apply β†’ /opsx-verify β†’ /opsx-archive

SkillPurpose
/opsx-newScaffold a new change proposal (openspec/changes/{slug}/)
/opsx-ffFast-forward β€” write proposal + spec delta + tasks in one pass
/opsx-continueResume an in-flight proposal where you left off
/opsx-plan-to-issuesConvert tasks.md into GitHub issues with proper labels
/opsx-applyImplement one task end-to-end
/opsx-apply-loopLoop /opsx-apply over remaining tasks
/opsx-verifyValidate the implementation matches the spec delta
/opsx-archivePromote changes/{slug}/ β†’ specs/ and close the proposal
/opsx-onboardBootstrap an existing repo into the openspec workflow
/opsx-exploreRead-only exploration of a codebase to inform a proposal
/opsx-pipelineRun a full pipeline locally (build β†’ review β†’ apply)
/opsx-coverage-scanAudit annotation coverage on an app
/opsx-annotateAdd x-openregister-* annotations to existing schemas
/opsx-reverse-specProduce a spec delta from clusters of un-annotated code
/opsx-syncSync spec deltas between hydra-specs and per-app openspec/
/opsx-bulk-archiveArchive multiple completed changes in one pass

Quality gates β€” hydra-gate-*​

Mechanical checks that run inside the Builder/Reviewer containers before/after each pass. Used by the pipeline itself, but also runnable locally to pre-empt feedback:

hydra-gates (umbrella) plus individual gates:

hydra-gate-admin-router, hydra-gate-composer-audit, hydra-gate-forbidden-patterns, hydra-gate-initial-state, hydra-gate-modal-isolation, hydra-gate-nc-input-labels, hydra-gate-no-admin-idor, hydra-gate-orphan-auth, hydra-gate-route-auth, hydra-gate-semantic-auth, hydra-gate-spdx, hydra-gate-stub-scan, hydra-gate-unsafe-auth-resolver

Team agents β€” team-*​

Per-discipline reviewers / counsels you can invoke directly when you want a single point of view (rather than running the full pipeline).

SkillRole
team-architectSystem design, ADR fit, cross-spec consistency
team-backendPHP / API / DB review
team-frontendVue / nextcloud-vue / a11y
team-poProduct owner β€” user value, scope fit
team-qaTest plan, edge cases, regression risk
team-reviewerGeneral PR reviewer counterpart to juan-claude-van-damme
team-smScrum master β€” process, sprint health

Testing & journey docs​

SkillPurpose
test-accessibilityAxe-Core + WCAG AA sweep
test-apiNewman-based API contract tests
test-appApp-scoped Playwright run
test-counselOrchestrates parallel test runs across multiple personas
test-functionalFunctional regression sweep
test-performanceLighthouse / load-time checks
test-persona-annemarie, -fatima, -henk, -janwillemPersona-driven flows (each persona file in hydra/personas/)
journeydoc-initScaffold the journeydoc Playwright + Docusaurus capture setup
journeydoc-add-storyAdd a new tutorial-page capture spec
journeydoc-instrumentAdd data-testid instrumentation to existing components

Utilities​

create-pr, clean-env, feature-counsel, local-run, persistence-audit, report-out, review-pr, skill-creator, sync-docs.

Concurrentie-analyse skills (concurrentie-analyse/.claude/skills/)​

The upstream research and app-pipeline side β€” feeds proposals back into Hydra.

GroupSkillsPurpose
App pipelineapp-create, app-design, app-explore, app-pipelineScaffold and explore new apps from intelligence-DB findings
Research β€” Specterspecter-analyze-docs, specter-competitive-alert, specter-concept, specter-harvest, specter-pipeline, specter-prepare-context, specter-research-app, specter-syncThe Specter intelligence pipeline (tender + competitor harvest β†’ cluster β†’ spec)
Tendertender-scan, tender-status, tender-gap-reportOperate on intelligence.db for tender coverage
Ecosystemecosystem-investigate, ecosystem-propose-appFind ecosystem gaps and draft proposals for new apps
Software catalogueswc-test, swc-updateSync the public software catalogue
Miscintelligence-update, readiness-reportDB maintenance + readiness reporting

User personas​

Personas are non-agent β€” they're test subjects representing real user archetypes the testing skills drive flows against:

FilePersona
annemarie-de-vries.mdPublic-sector caseworker β€” Henk's manager's manager
fatima-el-amrani.mdFront-line municipal officer, multilingual
henk-bakker.mdSenior caseworker, sceptical of new tools
janwillem-van-der-berg.mdIT architect, evaluates platform fit
mark-visser.mdDeveloper onboarding the platform
noor-yilmaz.mdCitizen-side user submitting forms
priya-ganpat.mdCompliance officer, ISO / privacy lens
sem-de-jong.mdProduct manager, prioritisation lens

Full persona files live in hydra/personas/.

Going deeper​

  • Each skill is its own folder under .claude/skills/<name>/ with a SKILL.md (the instruction prompt the agent runs) plus optional examples/, references/, templates/, assets/. See Writing skills and the Skill checklist.
  • Skill maturity levels (L1–L7) describe how much evaluation backs each skill. The Skill evaluation page documents the L5+ workflow with evals.json baselines.
  • Skills are invokable via Skill: <name> inside Claude Code or as /<name> slash-commands. The harness also publishes them to sub-agents through the Agent tool.