This commit is contained in:
Josh at WLTechBlog
2025-10-03 14:31:09 -05:00
parent 8d9300b317
commit 8a36ced142
3 changed files with 378 additions and 154 deletions

View File

@@ -3,7 +3,7 @@
## Date: October 3, 2025
## Overview
Updated `docs/llm_ada_testing.md` to reflect the new token-efficient accessibility summary tools and corrected all tool names to use the proper double-suffix naming convention (`_cremotemcp_cremotemcp`).
Updated `docs/llm_ada_testing.md` to reflect the new token-efficient accessibility summary tools and corrected all tool names to use the proper **single-suffix** naming convention (`_cremotemcp`) to match the actual MCP server implementation.
---
@@ -13,13 +13,13 @@ Updated `docs/llm_ada_testing.md` to reflect the new token-efficient accessibili
**NEW SECTION** at the top of the document:
```markdown
## ⚠️ IMPORTANT: Tool Naming Convention
All cremote MCP tools use the **double suffix** naming pattern: `toolname_cremotemcp_cremotemcp`
All cremote MCP tools use the **single suffix** naming pattern: `toolname_cremotemcp`
**Correct:** `web_run_axe_cremotemcp_cremotemcp`
**Incorrect:** `web_run_axe_cremotemcp`
**Correct:** `web_run_axe_cremotemcp`
**Incorrect:** `web_run_axe` (missing suffix) or `web_run_axe_cremotemcp_cremotemcp` (double suffix)
```
**Why:** Prevents the previous issue where tools weren't accessible due to incorrect naming.
**Why:** Ensures tool names match the actual MCP server implementation.
---
@@ -174,29 +174,28 @@ cremote form-accessibility-audit
## Global Changes
### Tool Name Corrections
**CORRECTED** 150+ instances of tool names throughout the document:
**CORRECTED** 116+ instances of tool names throughout the document:
**Before:** `web_run_axe_cremotemcp`
**After:** `web_run_axe_cremotemcp_cremotemcp`
**Correction:** All tool names now use **single suffix** `_cremotemcp` to match the actual MCP server implementation.
**Affected tools:**
- web_inject_axe
- web_run_axe
- web_contrast_check
- web_gradient_contrast_check
- web_media_validation
- web_hover_focus_test
- web_text_in_images
- web_cross_page_consistency
- web_sensory_characteristics
- web_animation_flash
- web_enhanced_accessibility
- web_keyboard_test
- web_zoom_test
- web_reflow_test
- web_screenshot
- web_navigate
- console_command
**Examples:**
- `web_inject_axe_cremotemcp`
- `web_run_axe_cremotemcp`
- `web_contrast_check_cremotemcp`
- `web_gradient_contrast_check_cremotemcp`
- `web_media_validation_cremotemcp`
- `web_hover_focus_test_cremotemcp`
- `web_text_in_images_cremotemcp`
- `web_cross_page_consistency_cremotemcp`
- `web_sensory_characteristics_cremotemcp`
- `web_animation_flash_cremotemcp`
- `web_enhanced_accessibility_cremotemcp`
- `web_keyboard_test_cremotemcp`
- `web_zoom_test_cremotemcp`
- `web_reflow_test_cremotemcp`
- `web_screenshot_cremotemcp`
- `web_navigate_cremotemcp`
- `console_command_cremotemcp`
**Why:** Ensures all tool references work correctly with the MCP server.
@@ -226,17 +225,18 @@ cremote form-accessibility-audit
## Verification
### Document Structure
✅ All sections updated with correct tool names
✅ New sections added for summary tools
✅ Workflows reorganized with token-efficient options first
✅ Best practices updated with token management guidance
✅ Coverage summary includes token comparison table
✅ All sections updated with correct tool names
✅ New sections added for summary tools
✅ Workflows reorganized with token-efficient options first
✅ Best practices updated with token management guidance
✅ Coverage summary includes token comparison table
### Tool Names
✅ All 150+ tool references use double suffix
✅ Warning section added at top of document
✅ Examples use correct JSON structure
✅ Command reference organized by efficiency
✅ All 116+ tool references use single suffix `_cremotemcp`
✅ Warning section added at top of document
✅ Examples use correct JSON structure
✅ Command reference organized by efficiency
✅ Matches actual MCP server implementation
### Content Accuracy
✅ Token usage estimates verified
@@ -255,9 +255,9 @@ cremote form-accessibility-audit
4. ⏳ Update other documentation (README, API docs)
### For LLM Agents
1. Use `web_page_accessibility_report_cremotemcp_cremotemcp` for all site-wide assessments
1. Use `web_page_accessibility_report_cremotemcp` for all site-wide assessments
2. Reserve detailed tools for deep dives on specific issues
3. Always use double-suffix naming for all cremote MCP tools
3. Always use single-suffix naming `_cremotemcp` for all cremote MCP tools
4. Budget ~4-6k tokens per page for comprehensive assessments
---
@@ -275,9 +275,11 @@ cremote form-accessibility-audit
The `llm_ada_testing.md` document has been comprehensively updated to:
1. Highlight the new token-efficient summary tools
2. Correct all tool names to use proper double-suffix convention
2. Correct all tool names to use proper **single-suffix** convention (`_cremotemcp`) matching the MCP server
3. Provide clear guidance on when to use each approach
4. Enable comprehensive site-wide assessments within token limits
**Result:** LLM agents can now conduct thorough ADA compliance assessments of 10+ pages within a 200k token budget, compared to only 2-3 pages with the previous approach.
**Critical Fix:** Tool names now match the actual MCP server implementation, preventing "tool not found" errors.