Skip to content

[AI Ops] Patch markdown.instructions.md to Meet Canonical Standards #44

@ashleyshaw

Description

@ashleyshaw

AI Ops Summary

Patch and update markdown.instructions.md to meet canonical standards for markdown instructions. Ensure scope/canonical statement, cross-references, summary table, accessibility references, expanded examples, contribution/review section, and consistent branded footer.

Problem / Opportunity

Outdated or incomplete markdown instructions disrupt contributor experience and automation compliance.

Approach / Solution

  • Add/clarify canonical scope statement
  • Add cross-references and summary table
  • Reference accessibility and a11y standards
  • Expand examples and validation steps
  • Contribution/review process section
  • Consistent branded footer with references

Acceptance Criteria

  • Canonical scope statement added
  • Cross-references and summary table included
  • Accessibility referenced
  • Examples/validation steps expanded
  • Contribution/review section present
  • Footer consistent and branded
  • PR uses correct branch prefix (ai/)
  • Approved by one maintainer

Additional Context

See: .github/markdown.instructions.md, docs/specs

References

Definition of Ready (DoR)

  • 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/)

Metadata

Metadata

Assignees

Type

No type

Priority

None yet

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions