Agent Teams Configuration

Agent Teams Configuration

This file defines coordinated multi-agent workflows for enterprise accessibility scanning in the Claude Code environment.

Team: Markdown Accessibility Audit

**Lead:** `markdown-a11y-assistant`

**Members:**

• markdown-scanner (hidden helper) - Per-file scanning across all 9 accessibility domains; returns structured findings
• markdown-fixer (hidden helper) - Applies auto-fixes and presents human-judgment items for approval
• markdown-csv-reporter (hidden helper) - Exports findings to CSV with WCAG help links and markdownlint rule references

**Workflow:**

1. markdown-a11y-assistant receives the user request and runs Phase 0 (discovery + configuration)
2. markdown-scanner is dispatched in parallel via the Task tool for each discovered file
3. All scan results are aggregated; cross-file patterns are identified
4. Review gate is presented to the user with auto-fix list + human-judgment items
5. markdown-fixer applies approved fixes in a single edit pass per file
6. Final MARKDOWN-ACCESSIBILITY-AUDIT.md report is generated with per-file scores and grades

**Handoffs:**

• markdown-csv-reporter for CSV export with WCAG help links
• web-accessibility-wizard after markdown audit is complete for HTML/JSX/TSX files
• document-accessibility-wizard for Office/PDF documents after markdown audit

Team: Document Accessibility Audit

**Lead:** `document-accessibility-wizard`

**Members:**

• document-inventory - File discovery, inventory building, delta detection
• cross-document-analyzer - Pattern detection, severity scoring, template analysis
• word-accessibility - DOCX scanning and remediation (DOCX-* rules)
• excel-accessibility - XLSX scanning and remediation (XLSX-* rules)
• powerpoint-accessibility - PPTX scanning and remediation (PPTX-* rules)
• pdf-accessibility - PDF scanning and remediation (PDFUA., PDFBP., PDFQ.* rules)
• office-scan-config - Office scan configuration management
• pdf-scan-config - PDF scan configuration management
• epub-scan-config - ePub scan configuration management
• document-csv-reporter - Exports document audit findings to CSV with Microsoft Office and Adobe PDF help links

**Members (PDF Remediation):**

• pdf-remediator - Programmatic and manual PDF remediation via pdf-lib/qpdf/ghostscript and Adobe Acrobat Pro

**Members (Office Remediation):**

• office-remediator - Programmatic Office document (Word/Excel/PowerPoint) remediation via python-docx/openpyxl/python-pptx

**Members (ePub):**

• epub-accessibility - EPUB scanning and remediation (EPUB-E*, EPUB-W*, EPUB-T* rules)

**Workflow:**

1. document-accessibility-wizard receives the user request and runs Phase 0 (discovery)
2. document-inventory discovers and inventories all matching files
3. File-type specialists (word-accessibility, excel-accessibility, powerpoint-accessibility, pdf-accessibility) scan documents in parallel by type
4. cross-document-analyzer analyzes