Add YAML frontmatter to agent files for GitHub recognition (#1944)

* Initial plan

* Add YAML frontmatter to review-lead agent

Co-authored-by: Flix6x <[email protected]>

* Add YAML frontmatter to coordinator agent

Co-authored-by: Flix6x <[email protected]>

* Add YAML frontmatter to api-backward-compatibility-specialist agent

Co-authored-by: Flix6x <[email protected]>

* Add YAML frontmatter to architecture-domain-specialist agent

Co-authored-by: Flix6x <[email protected]>

* Add YAML frontmatter to data-time-semantics-specialist agent

Co-authored-by: Flix6x <[email protected]>

* Add YAML frontmatter to documentation-developer-experience-specialist agent

Co-authored-by: Flix6x <[email protected]>

* Add YAML frontmatter to performance-scalability-specialist agent

Co-authored-by: Flix6x <[email protected]>

* Add YAML frontmatter to tooling-ci-specialist agent

Co-authored-by: Flix6x <[email protected]>

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: Flix6x <[email protected]>

Author: Copilot

.github/agents/api-backward-compatibility-specialist.md

@@ -1,3 +1,8 @@
+---
+name: api-backward-compatibility-specialist
+description: Protects users and integrators by ensuring API changes are backwards compatible, properly versioned, and well-documented
+---
+
 # Agent: API & Backward Compatibility Specialist
 
 ## Role

.github/agents/architecture-domain-specialist.md

@@ -1,3 +1,8 @@
+---
+name: architecture-domain-specialist
+description: Guards domain model, invariants, and architecture to maintain model clarity and prevent erosion of core principles
+---
+
 # Agent: Architecture & Domain Specialist
 
 ## Role

.github/agents/coordinator.md

@@ -1,3 +1,8 @@
+---
+name: coordinator
+description: Meta-agent that manages agent lifecycle, enforces structural standards, and maintains coherence across the agent system
+---
+
 # Agent: Coordinator
 
 ## Role

.github/agents/data-time-semantics-specialist.md

@@ -1,3 +1,8 @@
+---
+name: data-time-semantics-specialist
+description: Prevents subtle bugs in time handling, units, and data semantics with focus on timezone-aware operations and unit conversions
+---
+
 # Agent: Data & Time Semantics Specialist
 
 ## Role

.github/agents/documentation-developer-experience-specialist.md

@@ -1,3 +1,8 @@
+---
+name: documentation-developer-experience-specialist
+description: Ensures excellent documentation, clear error messages, and smooth developer workflows to keep FlexMeasures accessible
+---
+
 # Agent: Documentation & Developer Experience Specialist
 
 ## Role

.github/agents/performance-scalability-specialist.md

@@ -1,3 +1,8 @@
+---
+name: performance-scalability-specialist
+description: Identifies performance bottlenecks, inefficient algorithms, and scalability issues to keep FlexMeasures fast under load
+---
+
 # Agent: Performance & Scalability Specialist
 
 ## Role

.github/agents/review-lead.md

@@ -1,3 +1,8 @@
+---
+name: review-lead
+description: Orchestrates team of specialist agents for comprehensive code reviews and synthesizes their findings into unified recommendations
+---
+
 # Agent: Review Lead
 
 ## Role

.github/agents/tooling-ci-specialist.md

@@ -1,3 +1,8 @@
+---
+name: tooling-ci-specialist
+description: Reviews GitHub Actions workflows, pre-commit hooks, and CI/CD pipelines to ensure automation reliability
+---
+
 # Agent: Tooling & CI Specialist
 
 ## Role