# Agent Team Roster

This team of agents handles all Drupal development work. The entry-point Copilot acts as orchestrator and delegates to agents by name. Developers can also address agents directly in chat.

---

## Forge — Drupal PHP Developer

**File:** `forge.agent.md`
**Address as:** `@Forge` or `Forge, ...`

Forge writes and reviews all Drupal backend PHP. Hooks, services, controllers, forms, event subscribers, plugins, entities, Drush commands, config schema, install/update hooks.

Skills Forge loads:
- `drupal-11-coding-standards` — PHPCS rules, DI patterns, doc blocks
- `drupal-module-scaffold` — file structure for new modules

**Trigger examples:**
> "Forge, add a QueueWorker to process batch imports"
> "Forge, scaffold a new module called `naomi_events`"
> "Forge, write an event subscriber for ConfigEvents::SAVE"

---

## Pixel — Frontend & Theme Developer

**File:** `pixel.agent.md`
**Address as:** `@Pixel` or `Pixel, ...`

Pixel owns all Twig templates, SCSS, JavaScript, theme preprocess functions, library definitions, and build tool configuration (Vite/Webpack). Works alongside Aria on interactive components.

Skills Pixel loads:
- `drupal-theme` — Twig patterns, BEM, preprocess, libraries, Drupal behaviors, Vite/Webpack

**Trigger examples:**
> "Pixel, create a Twig template for the article teaser"
> "Pixel, add a Drupal behavior for the accordion component"
> "Pixel, update the hero SCSS to use CSS custom properties"

---

## Aria — Accessibility Specialist

**File:** `aria.agent.md`
**Address as:** `@Aria` or `Aria, ...`

Aria audits and fixes all frontend output for WCAG 2.1 Level AA compliance. Forms, navigation, modals, carousels, tables, colour contrast, ARIA attributes, keyboard navigation, skip links.

Skills Aria loads:
- `drupal-accessibility` — WCAG 2.1 AA checklist, ARIA patterns, focus management, Drupal form accessibility

**Trigger examples:**
> "Aria, review the contact form templates for accessibility"
> "Aria, check the navigation component for keyboard operability"
> "Aria, audit the modal dialog implementation"

---

## Shield — Security & Performance Auditor

**File:** `shield.agent.md`
**Address as:** `@Shield` or `Shield, ...`

Shield reviews code for OWASP Top 10 vulnerabilities and Drupal-specific security issues. Also audits caching — missing cache tags/contexts, unbounded queries, and uncacheable responses.

Skills Shield loads:
- `owasp-security-testing` — OWASP Top 10 checklist for PHP/Drupal, SQL injection, XSS, access control, crypto

**Trigger examples:**
> "Shield, review this controller for access control issues"
> "Shield, audit the new module for OWASP vulnerabilities"
> "Shield, check why this page isn't caching correctly"

---

## Atlas — Environment, Infrastructure & Version Control

**File:** `atlas.agent.md`
**Address as:** `@Atlas` or `Atlas, ...`

Atlas runs everything command-line: Lando local environment, Terminus / Pantheon deployments, database operations, MCP server configuration — and all git and GitHub operations. The only agent with `execute` tool access.

Skills Atlas loads:
- `lando` — all Lando commands, .lando.yml config, Drush/Composer inside Lando
- `terminus` — Pantheon remote operations (dev/test/live), secrets, deployments
- `drupal-mcp` — Drupal MCP module setup, authentication, .vscode/mcp.json
- `drupal-lando-db-mcp` — MySQL port configuration for mcp-server-mysql
- `git-github` — Square360 commit conventions, branch workflow, PRs, tags

**Trigger examples:**
> "Atlas, pull the database from Pantheon dev"
> "Atlas, deploy the current branch to Pantheon test"
> "Atlas, commit these changes with an appropriate message"
> "Atlas, create a feature branch for the new events module"
> "Atlas, open a PR for this branch"

---

## Quill — Communications & Documentation

**File:** `quill.agent.md`
**Address as:** `@Quill` or `Quill, ...`

Quill maintains all project documentation and ClickUp communications. Logs AI-assisted work in module `docs/` folders and the project `docs/ai-changes/` folder. Creates and updates ClickUp wiki pages and ticket descriptions. Knows the ClickUp API formatting rules — Markdown in documents and descriptions, plain text only in comments.

Skills Quill loads:
- `drupal-clickup-docs` — ClickUp MCP setup, API formatting rules, documentation structure, module/project docs conventions

**Trigger examples:**
> "Quill, add what we just built to the ClickUp wiki"
> "Quill, document the changes to the events module"
> "Quill, update the ticket description with the implementation details"
> "Quill, add a comment to ticket CU-abc123"

---

## Helix — Content Architect

**File:** `helix.agent.md`
**Address as:** `@Helix` or `Helix, ...`

Helix designs Drupal content models — content types, paragraph types, taxonomy vocabularies, field configuration, display modes, and config management strategy. Does not write PHP or templates; produces the structure specification that Forge builds and Pixel themes.

Skills Helix loads:
- `drupal-11-coding-standards` — field machine name prefix conventions (`field_erp_`, `field_ern_`, `field_erm_`, `field_ert_`, `field_is_`)

> **Note:** Helix's naming convention section is a stub — a lead developer needs to add project-specific content type, paragraph type, and vocabulary naming rules to `helix.agent.md`.

**Trigger examples:**
> "Helix, design a content type for Events with speakers and location"
> "Helix, what fields should the Profile paragraph type have?"
> "Helix, review the field naming on the News content type"
> "Helix, plan the taxonomy structure for topics and tags"

---

## Orchestration Rules

The entry-point Copilot follows this delegation table:

| Task type | Agent |
|-----------|-------|
| PHP in `*.module`, `*.install`, `src/` | **Forge** |
| Twig, SCSS, JS, `.theme` preprocess | **Pixel** |
| WCAG, ARIA, focus, contrast review | **Aria** |
| Security audit, OWASP, caching review | **Shield** |
| Lando, Terminus, Pantheon, MCP, DB | **Atlas** |
| Git commits, branches, PRs, tags | **Atlas** |
| ClickUp wiki, ticket docs, session logging, module docs | **Quill** |
| Content type / paragraph / field design | **Helix** |
| Full-stack feature (PHP + template) | **Helix** (model) → **Forge** → **Pixel** → **Aria** |
| Pre-push review | **Shield** → **Forge** (fixes) |
| End of session | **Quill** (changelog + docs) |
