zwave-js / zwave-js-ui / 19578966439

20%

push

github

chore: implement specialized agents.md for GitHub Copilot (#4470)

## ✅ Implement specialized agents.md following GitHub best practices

This PR implements a comprehensive agent system for GitHub Copilot based
on best practices from analyzing 2500+ repositories. The implementation
significantly improves the Copilot experience by providing specialized,
role-based agents with clear boundaries and practical guidance.

### 📁 Files Created (3,165 lines, 71 KB total)

#### Main Overview
- [x] **AGENTS.md** (298 lines) - Root-level overview and quick
reference guide

#### Five Specialized Agents
- [x] **backend-agent.md** (287 lines) - Node.js/TypeScript backend
specialist
- [x] **frontend-agent.md** (551 lines) - Vue 3 + Vuetify 3 frontend
specialist
- [x] **testing-agent.md** (650 lines) - QA engineer and testing
specialist
- [x] **documentation-agent.md** (759 lines) - Technical writer
specialist
- [x] **build-agent.md** (620 lines) - DevOps and build specialist

### 🔄 Latest Updates

**Address review feedback:**
- ✅ Clarified that project uses **Vue 3 Options API only** (not
Composition API)
- ✅ Added guidance on code sharing between frontend/backend (e.g.,
`socketEvents`)
- ✅ Added instructions to check utils files before writing new utility
functions
- ✅ Explained `app.confirm` requires `InstancesMixin` mixin
- ✅ Documented that in `App.vue`, use `this.confirm` directly (not
`this.app.confirm`)
- ✅ Added "NEVER duplicate code" boundaries to prevent code duplication

### 🎯 Key Features

Each agent includes:

✅ **YAML Frontmatter**
- Clear persona and specialization
- Complete tech stack listing
- File path scoping (`applyTo`)
- Essential commands with timings
- Boundaries (always/never lists)

✅ **Practical Code Examples**
- 50+ real code snippets from the codebase
- Both correct and incorrect patterns
- Working examples that can be copied
- Domain-specific best practices

✅ **Clear Boundaries**
- "Always do" lists for best practices
- "Never do" lists ... (continued)

333 of 441 branches covered (75.51%)

Branch coverage included in aggregate %.

4048 of 21388 relevant lines covered (18.93%)

1.18 hits per line