Noizefield/audio-plugin-coder

컨셉부터 출시 제품까지 오디오 플러그인을 바이브 코딩(vibe-coding)하기 위한 AI 기반 오픈 소스 프레임워크

**Audio Plugin Coder (APC)**는 창의적인 도구를 만들고, 음악을 쓰고, 궁극적으로 전문적인 오디오 플러그인을 제작하고자 하는 오랜 개인적 집착의 결과물입니다.

소프트웨어 악기와 이펙트를 개발하는 것은 항상 꿈이었지만, 실제 사용 가능한 VST(강력한 DSP, UI, 상태 관리 및 패키징 포함)를 구축하는 것은 악명 높을 정도로 복잡합니다. 시간이 흐르면서, 특히 AI 보조 개발(AI-assisted development)이 급격히 발전함에 따라 그 장벽이 마침내 무너졌습니다.

지난 18개월 동안 APC는 오디오 플러그인 구축을 위한 실용적인 **AI 우선 프레임워크 (AI-first framework)**로서 지속적으로 설계, 테스트 및 반복 개선되었습니다. 여기에는 수천 시간의 실험과 시행착오, 그리고 가끔은 UI를 제대로 렌더링하도록 LLM(대규모 언어 모델)에게 소리를 지르는 과정도 포함되었습니다.

개발 중간에 저는 TÂCHES (glittercowboy)의 훌륭한 작업을 발견했습니다. 컨텍스트 엔지니어링(context engineering)에 대한 그의 접근 방식은 놀라운 발견이었습니다. 저는 그의 핵심 아이디어 중 일부, 특히 메타 프롬프팅(meta prompting) 및 구조화된 에이전트 워크플로(structured agent workflows)에 관한 아이디어를 채택하여 APC의 DNA에 직접 통합함으로써 더욱 강력한 시스템을 만들었습니다.

APC는 에이전트 불가지론 (Agent Agnostic) 방식으로 설계되었습니다. Google의 Antigravity, Kilo, Claude Code 또는 Cursor를 사용하든 관계없이, APC는 그들이 성공하는 데 필요한 구조를 제공합니다.

Audio Plugin Coder (APC)는 현재 활발히 개발 중입니다. API가 변경될 수 있고, 기능이 불완전할 수 있으며, 버그가 발생할 수 있습니다.

안정적인 릴리스가 발표될 때까지 APC를 개발 및 실험 목적으로만 사용하십시오.

**Audio Plugin Coder (APC)**는 LLM 에이전트가 오디오 플러그인 개발 라이프사이클 전체를 거칠 수 있도록 안내하는 구조화된 AI 기반 워크플로 시스템입니다.

이를 통해 AI에게 컨텍스트, 아키텍처 또는 베스트 프랙티스(best practices)를 끊임없이 다시 설명할 필요 없이, 자연어, 사전 정의된 워크플로 및 도메인 특화 기술을 사용하여 VST3 / AU / CLAP 플러그인을 생성할 수 있습니다.

DSP (Digital Signal Processing) 아키텍처, UI 프레임워크, 빌드 시스템, 상태 추적(State tracking) 및 패키징을 수동으로 조절하는 대신, APC는 AI 에이전트가 **장기적 문맥(Long-term context), 검증(Validation) 및 자기 개선 지식(Self-improving knowledge)**을 가지고 작동할 수 있는 통합 프레임워크를 제공합니다.

• 🤖
  LLM 기반 개발 (LLM-Driven Development)
• Antigravity, Kilo, Claude Code, Cursor 또는 모든 코딩 에이전트와 함께 작동하도록 설계되었습니다.
• 🎯
  구조화된 워크플로 (Structured Workflows)
• 5단계 시스템: Dream(구상) → Plan(계획) → Design(설계) → Implement(구현) → Ship(배포).
• 🎨
  이중 UI 프레임워크 (Dual UI Frameworks)
• Visage (순수 C++) 또는 WebView (HTML5 Canvas) 중 선택 가능.
• 📊
  상태 관리 (State Management)
• 자동 진행 상황 추적, 검증 및 롤백(Rollback) 기능.
• 🔧
  자기 개선 (Self-Improving)
• 문제 해결 지식을 자동으로 캡처하며, 시간이 지남에 따라 시스템이 더 똑똑해집니다.
• 🏗️
  프로덕션 준비 완료 (Production Ready)
• CMake 빌드 시스템을 통한 JUCE 8 통합.
• 📚
  포괄적인 기술 (Comprehensive Skills)
• DSP, UI 디자인, 테스트 및 패키징을 위한 사전 구축된 도메인 지식.
• 🎬
  브릿지 템플릿 (Bridge Templates)
• FFGL 비주얼 플러그인 및 Max/MSP 외부 객체(Externals) 지원.

가장 빠르게 시작하는 방법 — 다음을 모든 터미널에 붙여넣으세요:

npx github:Noizefield/audio-plugin-coder

이 명령은 리포지토리(Repo)를 클론하고, 도구를 확인하며, 사용자의 플랫폼(Windows, macOS 또는 Linux)에서 다음에 수행해야 할 작업을 정확히 출력합니다. Node.js 18+ 및 Git이 필요합니다.

항상 GitHub에서 직접 최신 버전을 가져오므로 별도의 설치나 패키지 매니저가 필요하지 않습니다.

수동 클론을 선호하는 경우:

Windows:

git clone --recurse-submodules https://github.com/Noizefield/audio-plugin-coder.git
cd audio-plugin-coder

macOS / Linux:

git clone --recurse-submodules https://github.com/Noizefield/audio-plugin-coder.git
cd audio-plugin-coder
bash scripts/system-check.sh # 환경 확인

Windows: Windows 11, PowerShell 7+, Visual Studio 2022 (C++ 도구), CMake 3.22+, Git

macOS: macOS 10.13+, Xcode + 커맨드 라인 도구(Command line tools), CMake 3.22+, Git, jq (brew install jq)

Linux: CMake 3.22+, GCC/Clang, Git

모든 플랫폼: LLM 코딩 에이전트 (Claude Code, Antigravity, Kilo, Cursor)

만약 FFGL Visual Plugins 또는 Max for Live Externals를 구축하는 데 특별히 관심이 있다면, Windows용으로 포함된 One-Click Setup 스크립트를 사용하세요:

.\scripts\setup_bridges.bat

이 스크립트는 다음을 수행합니다:

CMake 및 Git 확인.

JUCE 8 자동 다운로드 (누락된 경우).

선택한 브리지(bridge)에 맞춰 Visual Studio 솔루션 구성.

컴파일 준비가 완료된 프로젝트 열기.

LLM 에이전트 초기화:

Kilo의 경우:

# Workflows are automatically discovered from .agent/workflows/

Claude Code의 경우:

# The agent will discover workflows from .agent/workflows/

첫 번째 플러그인 생성하기:

/dream MyReverb

AI가 전체 과정을 안내합니다!

💭 DREAM (아이디어 구상)
↓ 크리에이티브 브리프 작성, 파라미터 정의
📋 PLAN (아키텍처 설계)
...

명령어	설명
/dream [Name]	아이디어 구상 단계를 포함하여 새 플러그인 시작
/plan [Name]	아키텍처 정의 및 UI 프레임워크 선택
/design [Name]	GUI 목업 및 비주얼 디자인 생성
/impl [Name]	DSP 및 UI 코드 구현
/ship [Name]	플러그인 패키징 및 배포
/status [Name]	현재 진행 상황 및 상태 확인
/resume [Name]	마지막 단계부터 개발 재개
/new [Name]	확인 절차를 거쳐 전체 워크플로우 실행

사용자: /dream TapeDelay
AI: 좋습니다! 플러그인 컨셉을 정의해 봅시다.
음향적 특성은 무엇인가요?
...

APC는 단계별 개발을 추적하기 위해 고유한 상태 관리 (State Management) 시스템 (status.json)을 사용합니다. 이를 통해 문맥(context)을 잃지 않고 개발을 일시 중지하거나, 에이전트를 전환하거나, 특정 단계를 재시작할 수 있습니다.

audio-plugin-coder/
├── .[Agent]/ # AI 에이전트 설정
│ ├── workflows/ # 슬래시 명령어 오케스트레이터
...

**Skills (기술)**은 도메인 지식(

워크플로(workflow)는 status.json에서 사용자의 UI 프레임워크 선택 사항(Visage 또는 WebView)을 확인한 후, 적절한 디자인 기술(design skill)을 자동으로 로드합니다.

• Visage 프레임을 통한 네이티브 C++ UI
• 높은 성능, 낮은 오버헤드 (low overhead)
• 완전한 C++ 제어
• visage::Frame을 이용한 커스텀 렌더링 (custom rendering)

참고: Visage 통합은 현재 활발히 테스트 중이며, 일부 호스트에서 불안정할 수 있습니다.

• 현대적인 웹 기술
• 핫 리로드 (hot reload)를 통한 빠른 반복 (iteration)
• 풍부한 컴포넌트 라이브러리
• 성능을 위한 캔버스 기반 렌더링 (Canvas-based rendering)

AI는 계획 단계(planning phase)에서 플러그인의 복잡성과 요구 사항을 기반으로 선택을 도와줍니다.

모든 플러그인은 다음 사항을 추적하는 status.json 파일을 가집니다:

• 현재 개발 단계
• UI 프레임워크 선택 사항
• 완료된 마일스톤 (milestones)
• 검증 체크포인트 (validation checkpoints)
• 오류 복구 지점 (error recovery points)

이점 (Benefits):

• 언제든 개발 재개 가능
• 선결 조건 자동 검증
• 오류 발생 시 롤백 (rollback)
• 프로젝트 이력 추적

APC에는 문제로부터 학습하는 **자동 캡처 시스템 (auto-capture system)**이 포함되어 있습니다:

AI가 오류 직면 → 알려진 이슈 데이터베이스 검색
알려진 경우 → 문서화된 솔루션을 즉시 적용
알려지지 않은 경우 → 해결 시도 및 시도 횟수 추적
3회 시도 후 → 이슈 항목 자동 생성
해결 시 → 향후 사용을 위해 솔루션 문서화

위치: .agent/troubleshooting/

결과: 시스템은 직면하는 모든 이슈를 통해 더욱 똑똑해집니다!

APC는 다음을 지원하는 모든 LLM 기반 코딩 에이전트와 함께 작동합니다:

• 커스텀 워크플로/슬래시 명령어 (slash commands)
• 파일 시스템 접근
• 셸 실행 (Shell execution) (Windows의 PowerShell, macOS/Linux의 Bash)

테스트 완료:

• ✅ Claude Code (Anthropic)
• ✅ Kilo (kilo.ai)
• ✅ Cursor
• 기타 에이전트 환영!

JUCE 8 - 오디오 플러그인 프레임워크 (DSP, GUI 등 포함)
CMake - 빌드 시스템 (Windows의 Visual Studio, macOS의 Xcode)
PowerShell / Bash - 자동화 스크립팅 (플랫폼별 상이)
WebView2 / WKWebView - 웹 UI (Windows / macOS)
YAML - 지식 베이스 (knowledge base) 형식
Markdown - 문서화 및 워크플로

형식	Windows	macOS	Linux
VST3	✅	✅	✅
...
CLAP 지원은 향후 릴리스에 계획되어 있습니다.

상세한 문서는 docs/ 디렉토리에서 확인할 수 있습니다:

Getting Started - 문서 인덱스 및 빠른 시작
Plugin Development Lifecycle - 상세 단계 가이드
Command Reference - 모든 명령 및 스크립트
FAQ - 자주 묻는 질문
Troubleshooting - 일반적인 문제 및 해결 방법

• Windows 지원
• GitHub Actions CI/CD
• 상세한 문서화
• macOS 로컬 빌드 지원
• Linux 로컬 빌드 지원
• visage (GUI) 지원 (https://github.com/VitalAudio/visage)
• FFGL 브리지 템플릿 (Resolume, VDMX 등을 위한 VJ 플러그인)
• Max/MSP 외부 템플릿
• CLAP 형식 지원
• 프리셋 (Preset) 관리 시스템
• 플러그인 마켓플레이스 통합
• 실시간 협업 기능

저는 이 프로젝트에 수백 시간(및 상당한 API 비용)을 쏟아붓고 있는 독립 개발자입니다.

다양한 AI 에이전트(AI agents)에서 작동하는 프레임워크를 개발한다는 것은 Claude

JUCE Team - 업계 표준 프레임워크를 위해.
The AI Community - 특히 메타 프롬프팅 (meta-prompting) 개척자들을 위해.
Matt Tytel - 매우 뛰어난 Visage 라이브러리 (https://github.com/VitalAudio/visage)를 위해.
TÂCHES (glittercowboy) - 컨텍스트 엔지니어링 (context engineering) 시스템에 대한 영감을 위해.
12Matt3r - FFGL 및 Max/MSP 브리지 템플릿 기여.
vjcharles - macOS 지원 및 보안 강화 (PR #6).

이 프로젝트는 MIT 라이선스(MIT License) 하에 라이선스가 부여됩니다 - 자세한 내용은 LICENSE 파일을 참조하세요.

APC는 오디오 플러그인 프레임워크로 JUCE 8을 사용합니다. JUCE 8은 이중 라이선스(dual-licensed) 방식입니다:

라이선스	사용 사례	요구 사항
AGPLv3	오픈 소스 프로젝트	플러그인을 반드시 AGPLv3 하에 오픈 소스로 공개해야 함
JUCE Commercial	폐쇄형 소스/상업용	JUCE 라이선스 구매 필요

핵심 사항:

• APC 자체는 MIT 라이선스(허용적)입니다.
• APC로 구축된 플러그인은 JUCE의 라이선스 요구 사항을 상속받습니다.
• 플러그인을 판매하거나 소스 코드를 공개하지 않는 경우, JUCE 상업용 라이선스가 필요합니다.
• 플러그인을 AGPLv3 하에 오픈 소스로 공개하는 경우, JUCE를 무료로 사용할 수 있습니다.

공식 JUCE 리소스:

JUCE 사용이 해당 라이선스 약관을 준수하는지 확인할 책임은 사용자에게 있습니다.

오디오 개발 커뮤니티를 위해 ❤️ (그리고 수많은 토큰)를 담아 만들었습니다.

AI의 힘으로 당신의 플러그인 아이디어를 현실로 만드세요