Convert custom GitHub Copilot agents from YAML to markdown

[Copilot]

Converting Custom Agents from YAML to Markdown

• Explore repository structure and understand current agent files
• Remove .github/agents/README.md file
• Convert documentation-writer.yml to documentation-writer.md
• Convert project-maintainer.yml to project-maintainer.md
• Convert software-quality-enforcer.yml to software-quality-enforcer.md
• Verify converted files follow correct markdown format
• Fix markdownlint errors (MD031, MD032) by adding blank lines around code blocks and lists
• Run quality checks (build, test, code review, security scan)
• Complete task

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[Feature]: Convert custom agents from yaml to markdown files</issue_title>
<issue_description>### Problem Statement

The custom github agents in the /.github/agents folder are in yaml format, but must be defined in markdown files to be functional.

Proposed Solution

Remove the /.github/agents/README.md file so it isn't confused with being an agent, and then convert the three agent yaml files to markdown format.

Alternatives Considered

No response

Usage Examples

Benefits

Support for functional github specialized agents

Priority

High - Blocking my use case

Willingness to Contribute

Yes, I can submit a pull request

Additional Context

No response

Checklist

• I have searched existing issues to ensure this is not a duplicate
• I have provided a clear description of the feature
• I have explained why this feature would be useful</issue_description>

Comments on the Issue (you are @copilot in this section)

• Fixes [Feature]: Convert custom agents from yaml to markdown files #42

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[Malcolmnixon]

@copilot The Quality Checks job failed with the following errors:

Error: .github/agents/project-maintainer.md:81 MD031/blanks-around-fences Fenced code blocks should be surrounded by blank lines [Context: "```markdown"] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md031.md
Error: .github/agents/project-maintainer.md:114 MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "- **Lightweight**: Minimal ext..."] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md032.md
Error: .github/agents/software-quality-enforcer.md:67 MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "- ✅ Zero build warnings (warni..."] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md032.md
Error: .github/agents/software-quality-enforcer.md:79 MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "- [ ] New code has unit tests"] https://github.com/DavidAnson/markdownlint/blob/v0.40.0/doc/md032.md
Error: Failed with exit code: 1

Please fix.

[Copilot]

@copilot The Quality Checks job failed with the following errors:

Error: .github/agents/project-maintainer.md:81 MD031/blanks-around-fences Fenced code blocks should be surrounded by blank lines...

Fixed the markdownlint errors by adding blank lines around code blocks and lists as required by MD031 and MD032 rules. Commit: 9ce2342