Skip to content

Broken README link under Markdown Accessibility Prompts — should be markdown-a11y-assistant.prompt.md #105

@joedevon

Description

@joedevon

Platform

Claude Code (terminal)

Install type

No response

Operating system

No response

Which agent?

README documentation

What happened?

In docs/prompts/README.md, the table row for audit-markdown uses this link:

[audit-markdown](../../.github/prompts/audit-markdown.prompt.md)

Problem: That file does not exist. It was renamed in v3.0 and is now called markdown-a11y-assistant.prompt.md.

  • The correct file is at: .github/prompts/markdown-a11y-assistant.prompt.md

  • The link should be:

    [audit-markdown](../../.github/prompts/markdown-a11y-assistant.prompt.md)
    

Recommended fix:

  • Update the README table to use the correct filename for the prompt link.

Steps to reproduce

  1. Navigate to https://github.com/Community-Access/accessibility-agents/blob/main/docs/prompts/README.md#markdown-accessibility-prompts
  2. Attempt to click the audit-markdown link
  3. Results in a 404/not found
  4. Compare with actual prompt files under .github/prompts (markdown-a11y-assistant.prompt.md is present)
  5. Check v3.0 migration scripts and manifest for the new filename mapping

Additional context

See also project upgrade scripts and the agent manifest for a list of prompt renames (audit-markdown.prompt.md → markdown-a11y-assistant.prompt.md).

FROM JOE: I had github copilot help me with this bug report and asked it to try to find the location of the correct file. I'm not 100% sure that the file you intended for this link is actually markdown-a11y-assistant.prompt.md or else I'd have issued this as a PR rather than an issue for a core dev to look at it.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions