.claude/skills/dream/SKILL.md
# SKILL: IDEATION & DREAMING **Goal:** Define the plugin concept and initialize the project state. **Trigger:** `/dream [Name]` **Output Location:** `plugins/[Name]/` ## ⛔ OUTPUT RESTRICTIONS (MANDATORY) * **NO C++ Code.** * **NO Build Scripts.** * **NO CMake configurations.** ## STEP 1: THE INTERVIEW **Do NOT generate files yet.** If the user prompt is vague, ask 3 clarifying questions: 1. **Sonic Goal:** What is the character? (e.g., "Dirty Tape Delay", "Clean EQ") 2. **Controls:**
npx skillsauth add noizefield/audio-plugin-coder .claude/skills/dreamInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Goal: Define the plugin concept and initialize the project state.
Trigger: /dream [Name]
Output Location: plugins/[Name]/
Do NOT generate files yet. If the user prompt is vague, ask 3 clarifying questions:
STOP and WAIT for the user's response.
Only after the user answers, generate these files:
plugins/[Name]/.ideas/creative-brief.mdThe vision statement.
plugins/[Name]/.ideas/parameter-spec.mdThe definitive list of controls.
| ID | Name | Type | Range | Default | Unit |
| :--- | :--- | :--- | :--- | :--- | :--- |
| gain | Gain | Float | 0.0 - 1.0 | 0.5 | dB |
plugins/[Name]/status.json (ROOT)Initialize the project tracking file in the plugin root using the standardized schema.
Use the state management system:
# Import state management
. "$PSScriptRoot\..\scripts\state-management.ps1"
# Initialize state
New-PluginState -PluginName "[Name]" -PluginPath "plugins\[Name]"
Schema structure:
{
"plugin_name": "[Name]",
"version": "v0.0.0",
"current_phase": "ideation",
"ui_framework": "pending",
"complexity_score": 0,
"created_at": "2026-01-04T20:20:00Z",
"last_modified": "2026-01-04T20:20:00Z",
"phase_history": [],
"validation": {
"creative_brief_exists": true,
"parameter_spec_exists": true,
"architecture_defined": false,
"ui_framework_selected": false,
"design_complete": false,
"code_complete": false,
"tests_passed": false,
"ship_ready": false
},
"framework_selection": {
"decision": "pending",
"rationale": "",
"implementation_strategy": "pending"
},
"error_recovery": {
"last_backup": null,
"rollback_available": false,
"error_log": []
}
}
Update state after completion:
# Use standardized phase completion function
Complete-Phase -PluginPath "plugins\[Name]" -Phase "ideation" -Updates @{
"validation.creative_brief_exists" = $true
"validation.parameter_spec_exists" = $true
}
development
# SKILL: TROUBLESHOOTING & ISSUE RESOLUTION ## STEP 1: CHECK KNOWN ISSUES FIRST **Before trying random solutions:** ```powershell # Search known issues database $errorPattern = "duplicate target juce" $knownIssues = Get-Content ...kilocode\troubleshooting\known-issues.yaml | ConvertFrom-Yaml $matches = $knownIssues.issues | Where-Object { $_.error_patterns -match $errorPattern } if ($matches) { Write-Host "✓ Known issue found: $($matches.title)" Write-Host "Resolution: $($matches
tools
# SKILL: TESTING **Goal:** Stability Check. ## TASKS 1. **Pluginval:** Run validation script. 2. **Crash Analysis:** If crash reported, read Documents/APC_CRASH_REPORT.txt. 3. **Manual Check:** Ask user to load in DAW and move knobs.
tools
# SKILL: ARCHITECTURE & PLANNING **Goal:** Define DSP architecture, complexity assessment, and implementation strategy **Trigger:** `/plan [Name]` **Input:** Reads `plugins/[Name]/.ideas/creative-brief.md` and `parameter-spec.md` **Output Location:** `plugins/[Name]/.ideas/` --- ## 🎯 PHASE 2: PLAN (Architecture & Strategy) **Prerequisites:** - `plugins/[Name]/.ideas/creative-brief.md` exists - `plugins/[Name]/.ideas/parameter-spec.md` exists - Phase 1 (DREAM) complete **Output Files:** - `p
tools
# SKILL: PACKAGING (Cross-Platform) **Goal:** Create professional, cross-platform plugin installers for Windows, macOS, and Linux **Trigger:** `/ship [Name]` or "Ship [Name]" **Prerequisites:** Phase 4 (CODE) complete, audio engine working, all tests passed **Output Location:** `dist/[Name]_v[version]/` --- ## Overview This skill handles the complete packaging and distribution process for APC plugins. It supports: - **Local builds** (current platform only) - **GitHub Actions builds** (cross