noizefield/audio-plugin-coder

orchestrate

Decompose a goal and orchestrate APC subagent workers to execute it in parallel, then verify and integrate results.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/noizefield/audio-plugin-coder --skill orchestrate

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Orchestrate — Subagent Delegation

Trigger: /apc-orchestrate <goal> (skill action orchestrate)

You are the orchestrator. Do NOT do the implementation work yourself — decompose the goal into subtasks, assign them to worker subagents, then verify and integrate their results.

The goal is whatever the user typed after the command. If no goal is given, ask for one and stop.

Worker profiles

Canonical definitions live in .agents/agents/*.md. Per-host adapters are generated by scripts/sync-agents.ps1 / .sh — if a worker profile is unavailable in your host, run the sync script once.

ProfileTier intentUse for
cheap-workerlow costSearch, extraction, exploration, formatting, simple edits
standard-workerdefaultImplementation, routine debugging, refactoring, tests, review
deep-workerstrongMulti-step, ambiguous, cross-component, concurrency
expert-workerescalation onlyAfter verified failure of a lower tier

Codex parity: .codex/agents/*.toml (underscores: cheap_worker …) plus scripts/codex/apc-codex-run.* tier routing — see docs/codex-orchestration.md.

Spawning per host

Use your host's native subagent mechanism and select the profile by name:

  • Devin CLI — run_subagent (.agents/agents/*.md is read

natively); background for parallel waves.

  • Claude Code — Task/subagent with .claude/agents/ profiles.
  • OpenCode — subagent mode with .opencode/agent/ profiles.
  • Cursor / Kilo — Task/subagent or mode delegation; pass the

worker definition contents as the subagent brief if profiles are not registered.

  • Hosts without subagents — dispatch workers as headless runs via

scripts/codex/apc-codex-run.ps1 / .sh (Codex CLI) or execute the subtasks sequentially yourself; say which fallback you used.

Workflow

  1. Preconditions — confirm an APC checkout (templates/,

scripts/, CMakeLists.txt). If the goal touches a plugin, read <plugins_dir>/<PluginName>/status.json first and respect phase gates — never have a worker edit a frozen (ship_complete) plugin.

  1. Decompose — split the goal into self-contained subtasks with

DISJOINT file sets. Two write-capable workers may never touch the same file or directory; merge or sequence tasks that collide.

  1. Wave 0 — research — if workers need context you lack, spawn

cheap-worker/deep-worker research tasks first; fold findings into the write-task briefs.

  1. Wave 1 — execute — run write-capable workers in parallel,

max 3 concurrent (parallel workers multiply spend). Independent tasks always run concurrently, never sequentially.

  1. Wave 2 — verify — after writes land, run the narrowest real

check: node bin/apc.js build <Name> (preferred) or scripts/build-and-install.ps1 / .sh for plugin work; targeted tests or lint for repo work. Prefer objective verification over worker self-assessment.

  1. Integrate & report — collect every worker's report, resolve

small conflicts yourself, retry/escalate failed tasks one tier up (deep-worker, then expert-worker), then deliver one consolidated summary: per-worker outcome, files changed, verification result, leftovers.

Worker brief contract

Every task you hand to a worker must state:

  • Repo root and the APC plugin path (Get-ApcPluginPath), if relevant
  • The exact deliverable and definition of done
  • File boundaries: which paths it owns, which it must NOT touch
  • All needed context — workers are stateless and cannot see this

conversation; they also cannot ask the user questions

  • Relevant APC rules: ui_framework from status.json, PowerShell

vs Bash by OS, no raw cmake, no Co-authored-by AI trailers

  • Required report format back to you

Rules

  • Track the task DAG with the host's todo/plan tool.
  • Read AGENTS.md (and .agents/rules/juce-build-protocols.md for

plugin code work) before writing worker briefs, and enforce those rules inside the briefs.

  • Preserve ui_framework: Visage tasks never produce WebView files

and vice versa — state it explicitly in the brief.

  • Resolve ambiguity with the user BEFORE spawning; workers cannot

ask questions.

  • Back up plugin state (Backup-PluginState / backup_plugin_state)

before delegating implementation or packaging changes.

  • If the goal is smaller than the delegation overhead, say so and

offer to do it directly — but default to delegating since the user invoked this command expecting it.

  • Keep the user informed: one short line per wave, not play-by-play.