symphony

Orchestrate OpenAI Symphony reference-runner execution for Linear-backed implementation issues.

Updated May 23, 2026

Search Tags:#workflow orchestration #task runner #linear #local development #guardrails #symphony #bun scripts

Ready to run

npx skills add https://github.com/matthewharwood/dean-n-dean --skill symphony-matthewharwood

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: symphony
Source: https://github.com/matthewharwood/dean-n-dean/tree/main/.agents/skills/symphony
Command: npx skills add https://github.com/matthewharwood/dean-n-dean --skill symphony-matthewharwood

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Symphony integration helps you execute and debug Linear-backed implementation issues in a consistent, repo-aligned way without polluting the deployed app or committing local secrets.

Core Features & Use Cases

Local orchestration for implementation tasks: wires bun run symphony and bun run dev:symphony to run the Symphony reference runner against the correct target app.
Repo-safe workflow package support: coordinates the @dean-stack/symphony-first-five workflow and Symphony runner behavior using WORKFLOW-driven execution.
Linear environment wiring with guardrails: loads required Linear credentials from ignored local .symphony/secrets.env and enforces UTF-8 locale defaults so terminal output renders reliably.

Quick Start

Create .symphony/secrets.env with your LINEAR_API_KEY and LINEAR_PROJECT_SLUG, then run bun run symphony.

Frequently Asked Questions about symphony

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I run Linear-backed issue workflows for local development?▼

Run Linear-backed issue workflows locally by executing `bun run symphony` or `bun run dev:symphony`, which wires the Symphony reference runner to your target app via DEAN_APP environment variables.

How do I set up Linear environment credentials for local workflow orchestration without committing secrets?▼

Load Linear credentials by creating a local `.symphony/secrets.env` file containing your `LINEAR_API_KEY` and `LINEAR_PROJECT_SLUG`, which keeps secrets ignored and separate from the deployed app.

Does the Symphony workflow runner require a specific task runner or package manager?▼

Yes, local execution requires Bun to run TypeScript wrapper scripts and integrates with the Turbo task graph to coordinate workflow orchestration and dependency management across your repository.

Why does my terminal output render incorrectly when running local Bun scripts for workflow orchestration?▼

Terminal output renders incorrectly because child processes lack UTF-8 locale defaults. The workflow orchestration enforces UTF-8 locale defaults for child processes to ensure terminal output renders reliably.

Can I target specific apps when executing workflow-driven specs locally?▼

Yes, target specific apps during workflow-driven spec execution by setting the `DEAN_APP` or `DEAN_APP_FILTER` environment variables to select the correct application target for the Symphony runner.

What is the best way to install the Symphony reference runner without polluting the deployed app?▼

Install the Symphony reference runner under the `tmp/symphony` directory to keep local-only ignored installs separate from your deployed application and repository.