| name | resolve |
| description | Provides quick fixes for common VergeOS issues by matching symptoms against known patterns and official docs. Use when a user reports a VergeOS problem and wants a fast resolution. Applies to "my VM won't start", "network has no connectivity", "storage tier is full", "LDAP login is failing", "how do I fix X in VergeOS", "VergeOS isn't working". Returns a concise issue / quick-fix / steps response with a doc link, and points to a diagnostic-bundle workflow when symptoms need deeper investigation. |
| allowed-tools | Read, Grep, Glob |
Quick Resolution: $ARGUMENTS
I'll check if this is a common issue with a known quick fix.
Step 1: Common Issues Check
First, match against known common issues:
| Category | Common Symptoms | Quick Fix |
|---|
| VM | Won't start, stuck booting, no console | Check resources, verify NIC/disk config, review VM logs |
| Network | No connectivity, VLAN not working, DNS issues | Verify network assignment, check firewall rules, validate VLAN tags |
| Storage | Disk full, slow I/O, tier issues | Check tier capacity, review sync status, verify vSAN health |
| Auth | Login failed, LDAP/OIDC issues, permission denied | Verify credentials, check auth source config, review group mappings |
Step 2: Search VergeOS Docs for Exact Match
Query mcp__vergeos-docs__searchDocumentation with:
- The exact error message (if provided)
- Key symptoms: "$ARGUMENTS"
Step 3: Resolution Path
If common issue with documented fix:
- Provide the quick resolution steps
- Include specific commands with syntax
- Link to relevant documentation
If NOT a common pattern (after 2 VergeOS Docs searches without clear answer):
- State: "This needs deeper investigation than a quick fix."
- If the issue is system-level (storage, networking, node health, performance), recommend collecting a diagnostic bundle and running
/diag on it.
- If the issue is conceptual ("how does X work"), point the user to
/explain $ARGUMENTS.
- Do not invent a fix. It is better to route to the right next step than to guess.
Step 4: Response Format
Provide a concise response:
**Issue:** [Brief description]
**Quick Fix:**
1. [Step 1]
2. [Step 2]
3. [Step 3]
**Documentation:** [Link to relevant docs]
Citation Requirements
- Include documentation URLs from VergeOS Docs search results
- Format:
[Topic - VergeOS Docs](URL)
