Adds .claude-plugin/marketplace.json to the repo root, making this
repository a standard Claude Code plugin marketplace. Users can now
install via `claude plugin marketplace add` instead of only through
install.sh. Updates claude-code-plugin/README.md with marketplace
install instructions alongside the existing install.sh method.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Remove $schema (not in spec), move description to metadata.description,
remove undocumented owner.url field.

Addresses review feedback items 1-3 from #48.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Verified against official Claude Code plugin docs. All review items resolved.

chore: update docs manifest

chore: update agent manifest

… handoffs

## Summary

v2.6 release includes comprehensive alignment fixes across the agent ecosystem:

## Changes

### Prompt-to-Agent Name Alignment
- audit-desktop-a11y.prompt.md: Added agent field for desktop-a11y-specialist
- package-python-app.prompt.md: Added agent field for python-specialist
- review-text-quality.prompt.md: Added agent field for text-quality-reviewer
- scaffold-nvda-addon.prompt.md: Added agent field for nvda-addon-specialist
- scaffold-wxpython-app.prompt.md: Added agent field for wxpython-specialist
- setup-github-scanner.prompt.md: Added agent field for web-accessibility-wizard
- setup-lighthouse-scanner.prompt.md: Added agent field for web-accessibility-wizard
- test-desktop-a11y.prompt.md: Added agent field for desktop-a11y-testing-coach

All prompts now have matching agent: fields that enable CLI invocation via agent names.

### Version Synchronization
- Updated prd.md version from 2.5 to 2.6
- Confirmed all package.json and plugin.json files already set to 2.6.0
- Version consistent across vscode-extension, desktop-extension, and claude-code-plugin

### Installer/Updater Review
- Verified install.ps1 and install.sh properly migrate legacy marker names
- Confirmed update.sh cleans up duplicate files in User/prompts/ folder
- Verified uninstall.sh handles both old and new LaunchAgent names on macOS
- Confirmed .a11y-agent-team marker names consistent across platforms

### Handoff References
- All agent handoff references point to correct renamed agents
- No stale references to removed or obsolete agents found
- web-accessibility-wizard, document-accessibility-wizard, and markdown-a11y-assistant correctly referenced

## Compatibility
- Backward compatible with existing installations
- Installers and updaters handle legacy folder names and markers
- No breaking changes to agent APIs or prompt structures

## Installation Notes
- Existing installs will migrate automatically on first update
- New installs use 2.6 structure with .a11y-agent-team folder names
- CLI tools can invoke agents using new consistent naming scheme

Released by GitHub Copilot automated workflow.

…rations

BreaKING CHANGE - Prompt File Rename:
- Renamed 12 prompt files to match agent names for consistent invocation:
  * a11y-update.prompt.md → insiders-a11y-tracker.prompt.md
  * audit-desktop-a11y.prompt.md → desktop-a11y-specialist.prompt.md
  * audit-markdown.prompt.md → markdown-a11y-assistant.prompt.md
  * audit-web-page.prompt.md → web-accessibility-wizard.prompt.md
  * export-document-csv.prompt.md → document-csv-reporter.prompt.md
  * export-markdown-csv.prompt.md → markdown-csv-reporter.prompt.md
  * export-web-csv.prompt.md → web-csv-reporter.prompt.md
  * package-python-app.prompt.md → python-specialist.prompt.md
  * review-text-quality.prompt.md → text-quality-reviewer.prompt.md
  * scaffold-nvda-addon.prompt.md → nvda-addon-specialist.prompt.md
  * scaffold-wxpython-app.prompt.md → wxpython-specialist.prompt.md
  * test-desktop-a11y.prompt.md → desktop-a11y-testing-coach.prompt.md

Installer/Updater Migration Logic (v2.5 → v2.6):
- install.sh: Added migrate_prompts() function to rename old filenames during install
- install.ps1: Added Migrate-Prompts PowerShell function for Windows users
- update.sh: Integrated migrate_prompts() before syncing central/project prompts
- update.ps1: Integrated Migrate-Prompts before syncing central/project prompts
- uninstall.sh/ps1: Already handle both old and new names via wildcard cleanup

For existing v2.5 installations:
- Running install.sh/install.ps1 will automatically rename old prompts to new names
- Running update.sh/update.ps1 will automatically rename old prompts during update
- Both versions coexist during migration; duplicates are removed (new version kept)
- Uninstall will clean up both old and new prompt files

For new v2.6 installations:
- Clean install with new agent-aligned names only

## Phase 1A: Context Management
- Add context compaction guidance to web-accessibility-wizard, document-accessibility-wizard, markdown-a11y-assistant
- Create comprehensive context-management.md guide with examples for web, document, and markdown audits
- Guidance on when to use /compact, what to include in summaries, how to resume analysis

## Phase 1B: Authoritative Sources
- Create authoritative-sources.md mapping all agent recommendations to official sources
- WCAG 2.2 specification, ARIA 1.2, axe-core rules, PDF/UA, Microsoft Office standards
- Mobile (React Native, iOS, Android) and desktop (UI Automation, MSAA, ATK/AT-SPI, NSAccessibility)
- Plain language, reading levels, COGA cognitive accessibility, testing tools
- Add verify-sources.yml GitHub Actions workflow for automated link rot detection
- Create Python script for URL validation and reporting
- Source citations grounded in six-tier authority hierarchy

## Phase 1C: Extensibility & Custom Skills
- Create create-custom-skills.md comprehensive guide with step-by-step walkthrough
- Skill file structure, SKILL.md template, rules.json format, examples
- Governance, maintenance, deprecation processes
- Common skill patterns: platform-specific, WCAG criterion, domain-specific, tool-specific
- Complete fintech accessibility skill example
- Add /create-skill guidance pointers to accessibility-lead, developer-hub orchestrators
- Update README with 'Extending the Platform' section linking to custom skills guide

## Phase 0 Tooling Refactor
- Fix all agents to use vscode_askQuestions (VS Code native) instead of non-existent AskUserQuestion
- Updated 11 occurrences across web-accessibility-wizard and document-accessibility-wizard
- Verified zero remaining AskUserQuestion references

## Files Changed
- .github/workflows/verify-sources.yml (new) - Automated source validation workflow
- scripts/verify-sources.py (new) - URL validation script with reporting
- docs/guides/context-management.md (new) - Context management guide
- docs/guides/authoritative-sources.md (new) - Source authority reference
- docs/guides/create-custom-skills.md (new) - Skill creation guide
- claude-code-plugin/agents/accessibility-lead.md - Add custom skills section
- claude-code-plugin/agents/developer-hub.md - Add custom skills section
- claude-code-plugin/agents/web-accessibility-wizard.md - Context management + vscode_askQuestions fixes
- claude-code-plugin/agents/document-accessibility-wizard.md - Context management + vscode_askQuestions fixes
- claude-code-plugin/agents/markdown-a11y-assistant.md - Context management fixes
- README.md - Add 'Extending the Platform' section
- PLAN.md - Updated for v3.0 release (staged previously)

## Standards Implemented
- Source citation policy with inline citations and structured source blocks
- WCAG 2.2 AA conformance grounding for all accessibility claims
- Machine-readable source registry for programmatic access
- Automated freshness checks via verify-sources.yml workflow
- Platform extensibility via reusable custom skills
- vscode_askQuestions for native VS Code UX

Phase 1B completion - Authoritative source citations:

## Agent Updates
- .github/agents: 57 agents cite WCAG, ARIA, platform specs
- claude-code-plugin/agents: 56 agents cite sources
- Total: 113/113 agents cite official documentation

## Sources by Domain
- Web: WCAG 2.2, WAI-ARIA 1.2, axe-core, HTML Living Standard, ARIA APG
- Documents: PDF/UA-1 (ISO 14289-1:2023), Microsoft Office Accessibility,
  Open XML specs, Matterhorn Protocol, EPUB Accessibility 1.1
- Markdown: WCAG 2.2, CommonMark, markdownlint, GitHub Flavored Markdown
- GitHub: REST API, GraphQL API, GitHub CLI, Search Syntax
- Developer: Python docs, PyInstaller, Nuitka, pytest, mypy, wxPython,
  UI Automation, NSAccessibility, AT-SPI
- Testing: NVDA/JAWS/VoiceOver guides, Accessibility Insights, axe-core
- Mobile: React Native Accessibility, iOS/Android APIs, Expo

## Release Documentation
- CHANGELOG.md: v3.0.0 entry with citation framework details
- prd.md: Version bump 2.6 → 3.0
- claude-code-plugin/.claude-plugin/plugin.json: 2.6.0 → 3.0.0
- vscode-extension/package.json: 2.6.0 → 3.0.0
- desktop-extension/package.json: 2.6.0 → 3.0.0
- gemini-extension.json: 2.6.0 → 3.0.0

## Impact
All agent recommendations now ground in published standards. Users can verify
every claim by following inline citations to official W3C/vendor documentation.
No more AI-generated concerns - authority hierarchy Tier 1 (normative specs)
through Tier 6 (compliance standards).

Implements Phase 1A (Context Compaction) and Create Customizations from PLAN.md:

Context Compaction (2.5 hours):
- Add /compact guidance to web-accessibility-wizard after Phase 6
- Add /compact guidance to document-accessibility-wizard after Phase 4
- Add /compact guidance to markdown-a11y-assistant after Phase 2
- Link to docs/guides/context-management.md (already exists)
- Suggests context compaction after 6+ conversation turns

Create Customizations (5 hours):
- Add custom skills guidance to developer-hub and accessibility-lead
- Link to docs/guides/create-custom-skills.md (already exists)
- Guide users to extend agent ecosystem with domain-specific rules
- Example use cases: industry compliance, framework patterns, regional standards

Changes:
- .github/agents/: 5 agents updated (web/doc/markdown wizards, dev-hub, a11y-lead)
- claude-code-plugin/agents/: 5 agents updated (same agents for Claude Code)
- README.md already links to both guides

Benefits:
- Long audit conversations stay focused with context management
- Users can extend agents without modifying core files
- Discoverability of /compact and custom skill workflows

Effort: 7.5 hours total (Phase 1A + Create Customizations)
Milestone: Phase 1A + Create Customizations COMPLETE

Implements Phases 1-2 of Agentic Browser Tools (PLAN.md):
- Phase 1: Comprehensive browser verification documentation (4h)
- Phase 2: Web accessibility wizard enhancement (3h)

Phase 1 Deliverables:
- Created docs/guides/browser-tool-usage.md (300+ lines)
- Overview of autonomous verification workflow
- Setting requirements (workbench.browser.enableChatTools)
- Available browser tools documentation
- Verification workflow examples
- Failure handling patterns
- Best practices and troubleshooting
- Integration with audit reports
- Future enhancements roadmap

Phase 2 Deliverables:
- Added Phase 12: Browser Verification to web-accessibility-wizard
- Dev server detection (ports 3000, 5173, 8080, 4200, 8000)
- Browser tool availability check with graceful degradation
- Screenshot evidence collection to .a11y-screenshots/
- Shift CI/CD Integration to Phase 13
- Enhanced web-issue-fixer with browser verification support
- Auto-screenshot after each fix application
- Browser verification in output contract (PASS/FAIL/SKIPPED)
- Before/after screenshot comparison
- Enhanced failure reporting with browser context
- Updated README with browser-tool-usage guide reference

Changes:
- docs/guides/browser-tool-usage.md: NEW - comprehensive guide
- .github/agents/web-accessibility-wizard.agent.md: Added Phase 12
- .github/agents/web-issue-fixer.agent.md: Enhanced with verification
- claude-code-plugin/agents/web-accessibility-wizard.md: Mirrored Phase 12
- claude-code-plugin/agents/web-issue-fixer.md: Mirrored verification
- README.md: Added browser-tool-usage guide to Key guides section

Effort: 7 hours (4h Phase 1 + 3h Phase 2)
Status: Phases 1-2 of 4 complete
Remaining: Phase 3 (Web Issue Fixer Enhancement - 3h), Phase 4 (Testing - 3h)

…klog

Completes requested non-plugin backlog items:
- Agent Debug Panel guidance (user-facing troubleshooting workflows)
- Source currency automation hardening
- Operational citation backlog (Batch 8 + Claude batches)
- Release docs refresh (CHANGELOG, PRD, README)

What changed:
- Added docs/guides/debug-panel-workflows.md
  - Troubleshoot instruction loading, handoffs, tool failures, browser verification
  - Includes reproducible issue checklist
- Updated README.md
  - Linked Debug Panel Workflows in Advanced Guides and Key Guides
- Updated CHANGELOG.md (Unreleased)
  - Added debug guide, source automation improvements, and backlog closure notes
- Updated prd.md
  - Refreshed source automation capability language
  - Added Agent Debug Panel guidance capability
- Hardened source automation workflows
  - .github/workflows/verify-sources.yml: expanded PR triggers to claude-code-plugin agents, verifier script, source registry
  - .github/workflows/source-currency-check.yml: added pull_request and push triggers for source-related changes
- Improved scripts/verify-sources.py
  - Updated directory scope docs to include claude-code-plugin agents
  - Added URL-level cache to reduce duplicate HTTP calls
- Completed citation backlog across Claude directories
  - Added missing '## Authoritative Sources' to all .claude/agents/*.md
  - Added missing '## Authoritative Sources' to claude-code-plugin/agents/web-csv-reporter.md
  - Verified coverage counts: Copilot=0 missing, ClaudePlugin=0 missing, DotClaude=0 missing

Validation:
- get_errors: no errors in changed workflows/docs/scripts/agent files
- source coverage checks: all target agent directories fully covered

…me-copilot

- Created plugin.yaml manifest for VS Code Marketplace discovery
- Bundled 56 agents, 17 skills, 60+ prompts, 5 workspace instructions
- Updated README with marketplace installation guide
- Refreshed prd.md version and marketplace readiness status
- Updated CHANGELOG.md with v3.0.0 release details
- Created MARKETPLACE_SUBMISSION.md with 5-step submission guide
- Ready for immediate submission to awesome-copilot and copilot-plugins registries

Migrated all PLAN.md content to prd.md:- Added 'v3.0 Release Management' section with documentation requirements, testing checklist, git commits- Added 'Success Metrics for v3.0' table with execution status- Added 'Version History' table with phase completion dates- Enhanced 'Implementation Status' section with phase 4 details and cross-references
All user-facing guidance (context management, custom skills) already in:- docs/guides/context-management.md- docs/guides/create-custom-skills.md- README.md 'Extending the Platform'
REASONS FOR DELETION:- PLAN.md was strategic planning document (created 2026-03-04)- All content professionally packaged in prd.md (single source of truth)- Every technical deliverable implemented and linked- Release management fully documented- No meaningful content loss
Created MIGRATION-AUDIT.md documenting complete content audit.

RELEASE STATUS:✅ Phase 1A: Context Compaction (2.5h, complete 2026-03-07)✅ Phase 1B: Source Citations (15h, complete 2026-03-14)✅ Phase 1C: Agent Plugins (3h, complete 2026-03-21)✅ Phase 3: Agentic Browser Tools (13h, complete 2026-03-05)🔄 Phase 4: Lifecycle Hooks (7h, ready for approval)🟡 Phase 2 & 6+: Planned for v3.1+

Total completed: 38.5 hours

Phase 4: Lifecycle Hooks (Cross-Platform) - 7h
- Implement Python-based hook scripts in .github/hooks/ and .claude/hooks/
- SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, SessionEnd hooks
- Cross-platform support: Windows, macOS, Linux
- Consolidated hook configuration (hooks-consolidated.json)
- Installer updates: install.sh, install.ps1, update.sh, update.ps1, uninstall.sh, uninstall.ps1
- Documentation: docs/hooks-guide.md, docs/guides/agent-debug-panel.md
- Three-hook enforcement system tested in web projects

Phase 5: VS Code 1.110 High Priority Features - 4h
- Agent Debug Panel integration (400+ line comprehensive guide)
- Debug panel references in hooks-guide.md, getting-started.md, README.md
- Session forking guidance with /fork command in context-management.md
- Fork suggestions in web-accessibility-wizard, document-accessibility-wizard, developer-hub
- getDiagnostics tool integration in 4 specialist agents
- accessibility-lead, aria-specialist, forms-specialist, keyboard-navigator check jsx-a11y linting errors
- VS Code 1.110 feature analysis (27+ features analyzed)

Phase 6: VS Code 1.110 Remaining Features - 3h
- Built-in accessibility skill comparison guide (docs/guides/vscode-builtin-skill-comparison.md)
- OS notifications documentation for long-running audits
- AI co-author attribution guidance (git.addAICoAuthor setting)
- Inline chat session continuity documentation
- Collapsible terminal tool calls documentation
- Custom thinking phrases for accessibility-themed loading text
- Removed VS-CODE-1.110-RECOMMENDATIONS.md (all features implemented)

Documentation Updates:
- CHANGELOG.md: Added Phase 5 and Phase 6 entries
- prd.md: Updated all phases to COMPLETE status, version history updated
- README.md: System requirements, optional customization, troubleshooting sections
- CONTRIBUTING.md: Testing requirements for latest tool versions
- getting-started.md: Version currency warnings, OS notifications, AI co-author attribution
- context-management.md: Forking, inline chat continuity, collapsible terminal notes

Version Updates:
- All manifests updated from 2.6.0 to 3.0.0
- desktop-extension/manifest.json, package.json, package-lock.json
- vscode-extension/package-lock.json
- Installer comments updated to v3.0

New Files (52 files):
- .github/hooks/ - 5 Python hook scripts + configuration
- .claude/hooks/ - Claude Code hook installation
- .github/prompts/ - 47 prompt files for slash command invocation
- docs/guides/agent-debug-panel.md - Debug panel troubleshooting guide
- docs/guides/vscode-builtin-skill-comparison.md - Comparison with VS Code built-in skill

Deleted Files:
- msg.txt - Temporary file from commit operation
- docs/VS-CODE-1.110-RECOMMENDATIONS.md - All recommendations implemented

Files Modified: 21 agent/documentation files
Files Added: 52 new files (hooks, prompts, guides)
Files Deleted: 2 temporary/completed files

All v3.0 features complete and production-ready.