Add GitHub Copilot AI agents for project maintenance

[Copilot]

Implementation Plan for GitHub AI Agents

• Create .github/agents/ directory structure
• Create Documentation Writer agent
  • Define agent role and capabilities
  • Configure for documentation tasks (README, ARCHITECTURE, API docs, etc.)
• Create Software Quality Enforcer agent
  • Define agent role for code quality
  • Configure for linting, testing, code review enforcement
• Create Project Maintainer agent
  • Define agent role for maintenance tasks
  • Configure for dependency updates, issue triage, etc.
• Create optional weekly maintenance workflow (for maintainer agent)
• Update project documentation to reference the agents
• Verify agents configuration is valid
  • All YAML files are syntactically valid
  • Build succeeded with zero warnings
  • All tests pass (25/25)
• Run quality checks
  • Code review completed and feedback addressed
  • Security scanning completed (0 vulnerabilities found)
• Address PR review feedback
  • Update documentation-writer to cover public and private APIs
  • Relax zero-dependency requirement to minimal dependencies
  • Remove release coordination from project-maintainer
  • Change issue management to comment only, not close
  • Update project philosophy to allow appropriate dependencies
  • Fix spelling issue by adding 'triaging' to cspell dictionary
  • Fix markdownlint issues in AGENTS.md

Changes Made

Documentation Writer (.github/agents/documentation-writer.yml)

• Changed to document both public and private APIs

Project Maintainer (.github/agents/project-maintainer.yml)

• Removed "release planning" from description
• Changed dependency management to discuss runtime dependencies with maintainers
• Removed "Release Coordination" section entirely
• Changed issue management to comment on issues but not close them
• Updated project philosophy to "minimal external dependencies where appropriate"
• Changed "What NOT To Do" to require discussion before adding runtime dependencies
• Simplified "Don't close issues" rule

Spell Check (.cspell.json)

• Added 'triaging' to the dictionary to fix spelling check error

Documentation (AGENTS.md)

• Added blank lines before lists to comply with MD032 markdownlint rule

Original prompt

---

This section details on the original issue you should resolve

<issue_title>[Feature]: Github AI Agents</issue_title>
<issue_description>### Problem Statement

The project should have some Github AI agents for standard tasks:

• Documentation Writer
• Software Quality Enforcer
• Project Maintainer

Proposed Solution

Develop Github agents with clearly defined roles. Possibly with the program maintenance being triggered weekly to create new tickets with proposed enhancements.

Alternatives Considered

No response

Usage Examples

N/A

Benefits

This would allow the project to maintain quality and modern features.

Priority

Medium - Would improve my workflow

Willingness to Contribute

Yes, with guidance from maintainers

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]: Github AI Agents #32

---

💡 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 please fix the Triaging spelling report - possibly by adding it to the cspell configuration file.

[Copilot]

@copilot please fix the Triaging spelling report - possibly by adding it to the cspell configuration file.

Added 'triaging' to the cspell dictionary in commit a625df4.

[Malcolmnixon]

@copilot Please fix the markdownlint issues in AGENTS.md

[Copilot]

@copilot Please fix the markdownlint issues in AGENTS.md

Fixed markdownlint issues (MD032 - blank lines around lists) in AGENTS.md in commit de20cd7.