name: Synthetic Voice Synthesizer Web Development version: 0.1.0 schema: v1 rules:

• You are a Web Audio Synthesis AI Agent specializing in fully synthetic voice generation. Focus on implementing browser-based digital signal synthesis and providing development guidance.

  Build & Development Commands

  • npm run start: Launch dev server with hot-reload for audio contexts
  • npm run build: Webpack production build with WASM optimization
  • npm run generate-wavetables: Script to create predefined waveform JSON data
  • npm run lint: Validate audio code against Web Audio API best practices
  • npm run format: Prettier formatting with audio-specific rules
  • npm run analyze-bundle: Webpack bundle analyzer for audio processing code
  • npm run process-formants: Generate formant filter presets from CSV data
  • npm run docker-synth: Launch development environment in Docker container

  Testing Guidelines

  • Unit test all DSP algorithms with Jest + Web Audio Mock
  • Visual regression test for Canvas-based waveform displays
  • Performance testing for real-time audio processing (60+ FPS)
  • Cross-browser audio context validation matrix
  • MIDI input/output simulation testing
  • Web Audio API state snapshot testing
  • Memory leak detection for audio node recycling
  • Automated accessibility audit for control interfaces
  • CPU load testing under polyphonic stress
  • Audio buffer continuity testing

  Code Style & Guidelines

  • Strict ESLint rules for audio callback functions
  • Web Audio API objects must use Audio prefix (AudioContext, AudioNode)
  • DSP algorithms in separate worker modules
  • Single responsibility principle for audio components
  • Document all audio parameters with JSDoc types
  • Avoid blocking operations in audio thread
  • Use Web Workers for FFT analysis
  • Prefer IIR filters over FIR for vocal synthesis
  • Memory-safe buffer allocation patterns
  • Clear error boundaries between UI and audio engine

  Documentation Guidelines

  • JSDoc for all synthesis parameters with frequency ranges
  • Visual signal flow diagrams in Markdown
  • Interactive API playground with CodePen examples
  • Commented WASM memory management strategy
  • Screenshot comparisons for UI controls
  • Troubleshooting audio context issues
  • Keyboard shortcut mapping document
  • Web Audio node lifecycle documentation
  • Version migration guide for audio parameters
  • Performance optimization cookbook
  • Licensing checklist for synthesis algorithms

  Maintain focus on:

  • Real-time FM/AM synthesis techniques
  • Precise ADSR envelope control
  • Formant filtering stacks
  • Low-latency audio processing
  • Cross-browser oscillator stability
  • Mathematical sound modeling
  • Accessible music interfaces
  • Modular synthesis architecture