# DSP Architecture Specification

## Core Components
List the main DSP building blocks needed:

**Example for a compressor:**
- Input gain stage
- Sidechain detection (RMS/Peak)
- Gain computer (log/linear)
- Lookahead delay buffer
- Output gain stage

**Example for a delay:**
- Input buffer management
- Delay line (circular buffer)
- Feedback processing
- Mix control
- Output processing

## Processing Chain
Define the signal flow:

**Example:**

## Parameter Mapping
Map each parameter to DSP components:

| Parameter | Component | Function | Range |
|-----------|-----------|----------|-------|
| Threshold | Detector | Sets detection level | -60dB to 0dB |
| Ratio | Gain Computer | Sets compression ratio | 1:1 to 20:1 |
| Attack | Detector | Sets attack time | 0.1ms to 100ms |

## Complexity Assessment
Rate the plugin complexity (1-5):

**Level 1 (Simple):** Basic gain, simple filter, single parameter
**Level 2 (Moderate):** Multi-parameter, basic dynamics, simple modulation
**Level 3 (Advanced):** Multi-band processing, complex algorithms, state management
**Level 4 (Expert):** Synthesis engines, complex feedback, real-time analysis
**Level 5 (Research):** Machine learning, complex modeling, advanced DSP

**Score: [1-5]**
**Rationale: [Explain the complexity factors]**

# Implementation Plan

## Complexity Score: [1-5]

## Implementation Strategy

### Single-Pass Implementation (Score ≤2)
Execute all DSP components in one implementation session:
- Core processing logic
- Parameter binding
- Basic optimization

**Example for simple gain plugin:**
- Implement gain calculation
- Connect to parameter
- Add smoothing

### Phased Implementation (Score ≥3)
Break implementation into logical phases:

**Phase 2.1.1: Core Processing**
- [ ] Basic signal path
- [ ] Core DSP algorithm
- [ ] Parameter integration

**Phase 2.1.2: Optimization**
- [ ] Real-time safety
- [ ] Memory management
- [ ] Performance tuning

**Phase 2.1.3: Polish**
- [ ] Edge case handling
- [ ] State management
- [ ] Testing integration

## Dependencies
List required JUCE modules and external dependencies:

**Required JUCE Modules:**
- juce_audio_basics
- juce_audio_processors
- juce_dsp

**Optional Modules:**
- juce_gui_basics (for custom UI)
- juce_audio_formats (for file I/O)

## Risk Assessment
Identify potential implementation challenges:

**High Risk:**
- [List complex algorithms or real-time constraints]

**Medium Risk:**
- [List parameter smoothing or state management issues]

**Low Risk:**
- [List straightforward components]

# Import state management module
. "$PSScriptRoot\..\scripts\state-management.ps1"

# Check that ideation phase is complete
if (-not (Test-PluginState -PluginPath "plugins\[Name]" -RequiredPhase "ideation_complete" -RequiredFiles @(".ideas/creative-brief.md", ".ideas/parameter-spec.md"))) {
    Write-Error "Prerequisites not met. Complete ideation phase first."
    exit 1
}

# Use centralized framework selection
Set-PluginFramework -PluginPath "plugins\[Name]" -Framework "[visage/webview]" -Rationale "[Explain framework choice]"

# Update state with planning completion
Complete-Phase -PluginPath "plugins\[Name]" -Phase "plan" -Updates @{
  "complexity_score" = [1-5]
  "framework_selection.implementation_strategy" = "[single-pass/phased]"
  "validation.architecture_defined" = $true
  "validation.ui_framework_selected" = $true
}

{
  "plugin_name": "[Name]",
  "version": "v0.0.0",
  "current_phase": "plan_complete",
  "ui_framework": "[visage/webview]",
  "complexity_score": [1-5],
  "created_at": "2026-01-04T20:20:00Z",
  "last_modified": "2026-01-04T20:20:00Z",
  "phase_history": [
    {
      "phase": "ideation_complete",
      "completed_at": "2026-01-04T20:20:00Z",
      "framework_selected": null
    },
    {
      "phase": "plan_complete",
      "completed_at": "2026-01-04T20:20:00Z",
      "framework_selected": "[visage/webview]"
    }
  ],
  "validation": {
    "creative_brief_exists": true,
    "parameter_spec_exists": true,
    "architecture_defined": true,
    "ui_framework_selected": true,
    "design_complete": false,
    "code_complete": false,
    "tests_passed": false,
    "ship_ready": false
  },
  "framework_selection": {
    "decision": "[visage/webview]",
    "rationale": "[Framework choice explanation]",
    "implementation_strategy": "[single-pass/phased]"
  },
  "error_recovery": {
    "last_backup": null,
    "rollback_available": false,
    "error_log": []
  }
}

✓ Architecture & Planning Complete

Plugin: [Name]
Complexity: [Score]/5
Framework: [visage/webview]

What's next?
1. Start DESIGN phase - Create UI mockups and specifications
2. Review architecture - Examine DSP design and implementation plan
3. Modify plan - Adjust complexity assessment or framework choice
4. Pause here

Choose (1-4): _