feat: add release changes for AODA WCAG 2.2 accessibility agents, including agent definitions, instructions, and prompts

Author: emmanuelknafo

.copilot-tracking/changes/2026-03-08/copilot-a11y-agents-changes.md

@@ -0,0 +1,58 @@
+<!-- markdownlint-disable-file -->
+# Release Changes: Custom Copilot Agents for AODA WCAG 2.2 Accessibility
+
+**Related Plan**: copilot-a11y-agents-plan.instructions.md
+**Implementation Date**: 2026-03-08
+
+## Summary
+
+Create two declarative GitHub Copilot agents (A11y Detector and A11y Resolver) with supporting WCAG 2.2 instructions and prompt files for AODA compliance.
+
+## Changes
+
+### Added
+
+* `.github/agents/a11y-detector.agent.md` — A11y Detector agent definition with static analysis and runtime scanning protocol (8,484 chars)
+* `.github/agents/a11y-resolver.agent.md` — A11y Resolver agent definition with 18-row remediation table and verify-fix workflow (7,820 chars)
+* `.github/instructions/wcag22-rules.instructions.md` — WCAG 2.2 Level AA compliance rules auto-applied to TSX/JSX/TS/HTML/CSS files, organized by POUR principles
+* `.github/instructions/a11y-remediation.instructions.md` — Remediation patterns lookup table with 19 violation fixes, React/Next.js code examples, and anti-patterns
+* `.github/prompts/a11y-scan.prompt.md` — Quick scan prompt delegating to A11y Detector agent with URL and scope inputs
+* `.github/prompts/a11y-fix.prompt.md` — Quick fix prompt delegating to A11y Resolver agent with file and violations inputs
+
+### Modified
+
+### Removed
+
+## Additional or Deviating Changes
+
+* No deviations from plan. All phases executed as specified.
+
+## Release Summary
+
+**Total files affected:** 6 files created, 0 modified, 0 removed
+
+**Files created:**
+
+* `.github/agents/a11y-detector.agent.md` — A11y Detector agent definition (8,484 chars) with 5-step protocol for static analysis and runtime scanning
+* `.github/agents/a11y-resolver.agent.md` — A11y Resolver agent definition (7,820 chars) with 6-step protocol for remediation and verification
+* `.github/instructions/wcag22-rules.instructions.md` — WCAG 2.2 Level AA rules organized by POUR principles, auto-applied to TSX/JSX/TS/HTML/CSS
+* `.github/instructions/a11y-remediation.instructions.md` — 19-row remediation lookup table with React/Next.js code examples and anti-patterns
+* `.github/prompts/a11y-scan.prompt.md` — Quick scan prompt delegating to A11y Detector with URL and scope inputs
+* `.github/prompts/a11y-fix.prompt.md` — Quick fix prompt delegating to A11y Resolver with file and violations inputs
+
+**ADO Work Items:**
+
+* Epic AB#2012: AODA WCAG 2.2 Copilot Integration
+* Feature AB#2013: Custom Copilot Agents for Accessibility (child of AB#2012)
+* User Story AB#2014: A11y Detector agent (child of AB#2013)
+* User Story AB#2015: A11y Resolver agent (child of AB#2013)
+* User Story AB#2016: WCAG 2.2 compliance instructions (child of AB#2013)
+* User Story AB#2017: Quick-action prompt files (child of AB#2013)
+
+**Git:**
+
+* Branch: `feature/2014-copilot-a11y-agents` from `main`
+* Commit: `feat(agents): add AODA WCAG 2.2 accessibility detector and resolver agents AB#2014`
+* PR: #9 targeting `main` with `Fixes AB#2014 AB#2015 AB#2016 AB#2017`
+
+**Validation:** ESLint 0 errors, 7/7 tests passing, all frontmatter validated

.copilot-tracking/plans/2026-03-08/copilot-a11y-agents-plan.instructions.md

@@ -56,64 +56,64 @@ Create two declarative GitHub Copilot agents — A11y Detector and A11y Resolver
 
 ## Implementation Checklist
 
-### [ ] Implementation Phase 1: Create Agent Definition Files
+### [x] Implementation Phase 1: Create Agent Definition Files
 
 <!-- parallelizable: true -->
 
-* [ ] Step 1.1: Create `.github/agents/` directory and `a11y-detector.agent.md`
+* [x] Step 1.1: Create `.github/agents/` directory and `a11y-detector.agent.md`
   * Details: [copilot-a11y-agents-details.md](.copilot-tracking/details/2026-03-08/copilot-a11y-agents-details.md) (Lines 12-75)
-* [ ] Step 1.2: Create `.github/agents/a11y-resolver.agent.md`
+* [x] Step 1.2: Create `.github/agents/a11y-resolver.agent.md`
   * Details: [copilot-a11y-agents-details.md](.copilot-tracking/details/2026-03-08/copilot-a11y-agents-details.md) (Lines 77-141)
 
-### [ ] Implementation Phase 2: Create Supporting Instructions Files
+### [x] Implementation Phase 2: Create Supporting Instructions Files
 
 <!-- parallelizable: true -->
 
-* [ ] Step 2.1: Create `.github/instructions/wcag22-rules.instructions.md`
+* [x] Step 2.1: Create `.github/instructions/wcag22-rules.instructions.md`
   * Details: [copilot-a11y-agents-details.md](.copilot-tracking/details/2026-03-08/copilot-a11y-agents-details.md) (Lines 145-188)
-* [ ] Step 2.2: Create `.github/instructions/a11y-remediation.instructions.md`
+* [x] Step 2.2: Create `.github/instructions/a11y-remediation.instructions.md`
   * Details: [copilot-a11y-agents-details.md](.copilot-tracking/details/2026-03-08/copilot-a11y-agents-details.md) (Lines 190-250)
 
-### [ ] Implementation Phase 3: Create Prompt Files
+### [x] Implementation Phase 3: Create Prompt Files
 
 <!-- parallelizable: true -->
 
-* [ ] Step 3.1: Create `.github/prompts/a11y-scan.prompt.md`
+* [x] Step 3.1: Create `.github/prompts/a11y-scan.prompt.md`
   * Details: [copilot-a11y-agents-details.md](.copilot-tracking/details/2026-03-08/copilot-a11y-agents-details.md) (Lines 252-285)
-* [ ] Step 3.2: Create `.github/prompts/a11y-fix.prompt.md`
+* [x] Step 3.2: Create `.github/prompts/a11y-fix.prompt.md`
   * Details: [copilot-a11y-agents-details.md](.copilot-tracking/details/2026-03-08/copilot-a11y-agents-details.md) (Lines 287-322)
 
-### [ ] Implementation Phase 4: ADO Work Items and Branching
+### [x] Implementation Phase 4: ADO Work Items and Branching
 
 <!-- parallelizable: false -->
 
-* [ ] Step 4.1: Create ADO Epic, Feature, and User Stories for the agent work
+* [x] Step 4.1: Create ADO Epic, Feature, and User Stories for the agent work
   * Details: [copilot-a11y-agents-details.md](.copilot-tracking/details/2026-03-08/copilot-a11y-agents-details.md) (Lines 326-353)
-* [ ] Step 4.2: Create feature branch and commit with AB# linking
+* [x] Step 4.2: Create feature branch and commit with AB# linking
   * Details: [copilot-a11y-agents-details.md](.copilot-tracking/details/2026-03-08/copilot-a11y-agents-details.md) (Lines 355-377)
 
-### [ ] Implementation Phase 5: Validation
+### [x] Implementation Phase 5: Validation
 
 <!-- parallelizable: false -->
 
-* [ ] Step 5.1: Validate agent file structure and frontmatter
+* [x] Step 5.1: Validate agent file structure and frontmatter
   * Verify YAML frontmatter parses correctly in both agent files
   * Confirm `description` under 120 characters
   * Confirm agent body under 30,000 characters (GitHub.com limit)
   * Verify no `maturity` field in agent frontmatter (per prompt-builder rules)
-* [ ] Step 5.2: Validate instructions file structure
+* [x] Step 5.2: Validate instructions file structure
   * Verify `applyTo` glob patterns match intended file types
   * Confirm instructions files have YAML frontmatter with `description` and `applyTo`
-* [ ] Step 5.3: Validate prompt file structure
+* [x] Step 5.3: Validate prompt file structure
   * Verify prompt files have `description`, `agent`, and `argument-hint` fields
-* [ ] Step 5.4: Run project linting and tests
+* [x] Step 5.4: Run project linting and tests
   * Execute `npm run lint` for ESLint validation
   * Execute `npm run test` for unit test verification
   * Verify no regressions from new files
-* [ ] Step 5.5: Fix minor validation issues
+* [x] Step 5.5: Fix minor validation issues
   * Iterate on lint errors and formatting issues
   * Apply fixes directly when corrections are straightforward
-* [ ] Step 5.6: Report blocking issues
+* [x] Step 5.6: Report blocking issues
   * Document issues requiring additional research
   * Provide user with next steps rather than large-scale inline fixes