# Preserve Quetrex Voice Architecture

Voice changes can break echo cancellation, WebRTC audio flow, or OpenAI Realtime behavior. This skill gives developers Quetrex-specific rules for safe voice interface changes.

## Install

```bash
npx skillstore add barnhardt-enterprises-inc/voice-system-expert
```

## Metadata

- - Slug: barnhardt-enterprises-inc-voice-system-expert
- - Version: 1.0.0
- - Author: Barnhardt-Enterprises-Inc
- - GitHub username: Barnhardt-Enterprises-Inc
- - License: MIT
- - Repository: https://github.com/Barnhardt-Enterprises-Inc/quetrex-plugin/tree/main/templates/skills/voice-system-expert
- - Ref: main
- - Supported tools: Claude, Codex, Claude Code
- - Risk level: safe
- - Quality score: 80
- - Quality tier: silver
- - Public page: https://skillstore.pages.dev/skills/barnhardt-enterprises-inc-voice-system-expert
- - Manifest: https://skillstore.pages.dev/api/skills/barnhardt-enterprises-inc-voice-system-expert/manifest

## Capabilities

- Explains Quetrex voice architecture and required documentation to review before changes.
- Identifies the always-on microphone pattern used with browser echo cancellation.
- Lists voice implementation areas that can be changed safely.
- Warns against microphone toggling, custom echo cancellation, and native audio bypasses.
- Provides testing guidance for browsers, permissions, network issues, and echo scenarios.
- Points developers to key Quetrex files and functions for voice work.

## Use Cases

- Review a Voice Bug Fix: Check whether a proposed fix keeps the microphone always enabled and preserves browser echo cancellation.
- Plan OpenAI Realtime Changes: Identify safe areas to modify before changing WebRTC setup, connection handling, or audio response playback.
- Validate Release Testing: Build a focused browser test checklist for echo, permissions, disconnects, and platform coverage.

## Prompt Templates

### Check a Simple Voice Change

```
Review this planned Quetrex voice change. Tell me whether it keeps the always-on microphone pattern and browser echo cancellation intact.
```

### Find Risky Audio Patterns

```
Inspect this voice interface change for patterns that could break WebRTC audio, echo cancellation, or OpenAI Realtime turn detection.
```

### Design Safe Error Handling

```
Help me design Quetrex voice error handling for denied microphone permission, missing devices, and reconnect failures without changing audio routing.
```

### Audit a Voice Architecture Proposal

```
Evaluate this proposed Quetrex voice architecture change against ADR-001 and the documented browser AEC approach. List approval criteria and blockers.
```

## Limitations

- It is specific to Quetrex architecture and may not apply to unrelated voice systems.
- It provides guidance only and does not inspect source code automatically.
- It does not replace real browser and device testing for voice changes.
- It assumes the project remains a web application using browser WebRTC behavior.

## Best Practices

- Read the voice ADR and architecture documents before changing voice behavior.
- Keep microphone input and speaker output inside the browser audio pipeline.
- Test voice changes on real browsers with high speaker volume and permission edge cases.

## Anti Patterns

- Do not toggle the microphone track to avoid echo.
- Do not bypass browser audio with native routing or AudioWorklet workarounds.
- Do not add artificial delays as a substitute for correct echo cancellation.

## Security Audit

- - Safe to publish: true
- - Audited at: 2026-06-28T13:29:09.837\+00:00
- - Summary: Static analysis flagged Markdown backticks, documentation references, and prose substrings as shell execution, Windows SAM access, and weak cryptography. Review found no executable scripts, network calls, filesystem writes, secret access, prompt injection text, or malicious intent; the skill only allows Read and provides architecture guidance.

## Stats

- - Views: 258
- - Downloads: 4
- - Favorites: 0
- - Popularity score: 0