[AI Ops] Audit and update markdown.instructions.md for canonical standards and clarity #34

AI Ops Summary

This issue tracks the work to audit and update markdown.instructions.md in the LightSpeedWP .github repository. The goal is to ensure the document is clear, authoritative, and follows best practices for markdown instructions and documentation standards.

Objectives:

• Clarify the canonical scope and precedence of markdown.instructions.md within the repo
• Add and update cross-references to related markdown instruction files and standards
• Add a summary table of markdown-related instruction files and their scope
• Reference accessibility requirements (including WCAG and a11y instructions)
• Expand and improve examples for content rules
• Add contribution and review guidelines for markdown standards
• Add a consistent footer with references, contact info, and license

Success Criteria:

• The instructions file is clear, authoritative, and easy to follow
• Contributors and agents can find and apply markdown rules easily
• Accessibility requirements are explicit and actionable
• The issue is well-documented for review and future changes

Labels: documentation, standards, area:content, priority:important, status:triage

Problem / Opportunity

Approach / Solution

Acceptance Criteria

• AI workflow/agent described
• Problem/opportunity scoped
• Success metric defined
• Documentation updated
• PR uses correct branch prefix (ai/)
• Approved by at least one maintainer

Additional Context

References

• Contribution Guidelines
• Branching Strategy
• Automation Governance
• PR Labels
• Saved Replies
• Project Meta
• Labeler Config
• Labels
• Issue Types

Definition of Ready (DoR)

• AI ops goal described
• Area/action mapped
• Acceptance criteria listed
• Estimate added

Definition of Done (DoD)

• All acceptance criteria met
• Solution/automation verified
• Documentation updated
• PR uses correct branch prefix (ai/)