🤖 .github/agents/

April 22, 2026 · View on GitHub

This directory contains 24 agent files for GitHub Copilot and GitHub Agentic Workflows. It is the single source of truth for every agent persona used across the repository.

Canonical long-form catalog: see AGENTS.md at the repository root for full capability matrices, skill-mapping tables, and invocation examples. Workflow prompt imports (not agent files): see .github/prompts/README.md.

📋 Two kinds of file live here

gh-aw distinguishes two ways to package a reusable persona. Both live in this directory, but they are used for different things.

KindFilename conventionFrontmatter shapeUsed by
Persona agent (Copilot Agent File)<name>.mdname, description, tools: ["*"]assign_copilot_to_issue, create_pull_request_with_copilot, or a single workflow that needs exactly one persona
Workflow-specialist agent<name>.agent.mdname, description, optional disable-model-invocation: trueInvoked by name from within agentic workflows or manual flows (not auto-selected by Copilot)
Shared developer instructionsdeveloper.instructions.mddescription, applyTo: "**/*"Applied repository-wide to every Copilot session

Per gh-aw's packaging & imports guide, a workflow may import at most one Copilot Agent File, but can mix it with any number of plain-prompt imports from .github/prompts/.

🧑‍💼 14 Persona Agents (used via assign_copilot_to_issue)

These are the production personas that human maintainers assign to GitHub issues and PRs. They match the catalog in AGENTS.md and the "🎯 Agent Quick Reference" in copilot-instructions.md.

#FilePersonaPrimary domain
1security-architect.mdsecurity-architectSecurity architecture, ISMS compliance (ISO 27001 / NIST CSF / CIS Controls v8.1), STRIDE threat modeling
2documentation-architect.mddocumentation-architectC4 architecture models, Mermaid diagrams, Hack23 documentation standards
3quality-engineer.mdquality-engineerHTML/CSS validation, accessibility (WCAG 2.1 AA), link checking, CI quality gates
4frontend-specialist.mdfrontend-specialistStatic HTML/CSS, responsive design, 14-language localization, modern frontend
5isms-compliance-manager.mdisms-compliance-managerHack23 ISMS enforcement, audit preparation, gap analysis
6deployment-specialist.mddeployment-specialistGitHub Pages, CI/CD automation, GitHub Actions security
7devops-engineer.mddevops-engineerCI/CD pipelines, infrastructure automation, monitoring, performance optimization
8intelligence-operative.mdintelligence-operativePolitical science, OSINT, Swedish politics, behavioral analysis, risk indicators
9news-journalist.mdnews-journalistPolitical journalism, editorial standards, OSINT/INTOP data-driven reporting
10content-generator.mdcontent-generatorAutomated content generation, intelligence reports, 14-language templated rendering
11data-pipeline-specialist.mddata-pipeline-specialistCIA data consumption, ETL workflows, caching strategies, validation
12data-visualization-specialist.mddata-visualization-specialistChart.js / D3.js, interactive dashboards, political metrics visualization
13task-agent.mdtask-agentProduct analysis, issue creation, Playwright testing, agent coordination
14ui-enhancement-specialist.mdui-enhancement-specialistDesign system, cyberpunk theme, CSS-only data visualizations, accessibility

Persona agent frontmatter shape

Persona agents in this repo use the minimal Copilot Agent File contract:

---
name: <agent-name>
description: <one-line summary of expertise>
tools: ["*"]
---

MCP servers are not declared per-agent; they are configured repository-wide in .github/copilot-mcp.json and made available to every agent automatically.

Invocation patterns

// 1. Assign a persona to an existing issue
assign_copilot_to_issue({
  owner: "Hack23",
  repo: "riksdagsmonitor",
  issue_number: 123,
  custom_agent: "intelligence-operative",
  custom_instructions: "Build a voting-discipline dashboard for 2026 Q1"
})

// 2. Delegate a task that should produce a PR
create_pull_request_with_copilot({
  owner: "Hack23",
  repo: "riksdagsmonitor",
  title: "Add coalition-cohesion panel",
  problem_statement: "Implement a CSS-only stacked-bar panel ...",
  base_ref: "main"
})

Full invocation examples, skill-mapping tables, and per-persona capabilities live in AGENTS.md.

🛠️ 9 Workflow-Specialist Agents (.agent.md)

These agents are not selected automatically by Copilot (most carry disable-model-invocation: true). They encode reusable procedures for specific CI / authoring flows. They are referenced by name from agentic workflows, manual tasks, or other agents.

#FileAgentPurpose
1agentic-workflows.agent.mdagentic-workflowsCreate, debug, and upgrade gh-aw workflows with intelligent prompt routing
2ci-cleaner.agent.mdci-cleanerFormat sources, run linters, fix issues, run tests, recompile workflow lock files
3contribution-checker.agent.mdcontribution-checkerEvaluate a PR against the target repository's CONTRIBUTING.md
4create-safe-output-type.agent.md(procedure)Guide for adding a new safe-output type to gh-aw
5custom-engine-implementation.agent.md(procedure)Implement a custom agentic engine inside gh-aw
6grumpy-reviewer.agent.mdgrumpy-reviewerCritical code reviewer with 40+ years of (sarcastic) experience
7interactive-agent-designer.agent.mdinteractive-agent-designerWizard that guides users through creating agents, prompts, and workflow descriptions
8technical-doc-writer.agent.mdtechnical-doc-writerAI technical documentation writer using GitHub Docs voice
9w3c-specification-writer.agent.mdw3c-specification-writerTechnical specification writer following W3C conventions

📏 Shared developer instructions

FileApplies toPurpose
developer.instructions.md**/* (every file in every session)Cross-cutting Developer Instructions for GitHub Agentic Workflows — style, shell-safety, commit hygiene

🔐 Agent-file size and governance constraints

ConstraintValueEnforced by
Maximum file size16 KBGitHub Copilot agent runtime
Frontmatter tools:["*"] for persona agentsRepository convention (MCP servers configured globally)
ISMS governanceCEO approval for changes under .github/agents/Change_Management.md — Normal change
AI attributionAI-assisted edits require human review + DCO sign-offAI_Policy.md
Prohibited readingDo not read .github/agents/* from other agents (see copilot-instructions.md <disallowed_actions>)Repository policy

🎯 Choosing the right agent

flowchart TD
    A[I need to do …] --> B{Is it a single<br/>well-scoped issue?}
    B -- yes --> C{Domain?}
    B -- no, it's a recurring<br/>workflow → .agent.md or gh-aw
    C --> D[Security → security-architect]
    C --> E[Docs/diagrams → documentation-architect]
    C --> F[HTML/CSS/a11y → quality-engineer or ui-enhancement-specialist]
    C --> G[Political analysis → intelligence-operative]
    C --> H[News article → news-journalist or content-generator]
    C --> I[CI/CD → deployment-specialist or devops-engineer]
    C --> J[Data pipeline → data-pipeline-specialist]
    C --> K[Visualisation → data-visualization-specialist]
    C --> L[Compliance audit → isms-compliance-manager]
    C --> M[Product issues → task-agent]
    style A fill:#0a0e27,stroke:#00d9ff,color:#e0e0e0
    style B fill:#1a1e3d,stroke:#ff006e,color:#e0e0e0

See AGENTS.md §"Best Practices" for full decision guidance.

📋 Document owner: CEO | 🏷️ Classification: Public | 🔄 Review cycle: Quarterly