conductor-mechanics

Diagnose Conductor workflow YAML routing and template rendering failures.

Updated Apr 29, 2026
One-click install
npx skills add https://github.com/PolyphonyRequiem/polyphony --skill conductor-mechanics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: conductor-mechanics
Source: https://github.com/PolyphonyRequiem/polyphony/tree/main/.github/skills/conductor-mechanics
Command: npx skills add https://github.com/PolyphonyRequiem/polyphony --skill conductor-mechanics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents runtime surprises in Conductor workflow YAML by documenting the real execution contracts that templates, routing conditions, and agent outputs must follow.

Core Features & Use Cases

  • Agent output shape correctness: ensure scripts, LLM agents, and human gates expose the fields your templates and routes expect, including provider-specific raw-string fallbacks.
  • Routing and template evaluation sanity: understand how when: conditions are evaluated (including current-agent output shorthand) and why missing catch-alls cause route failures or silent truncation.
  • Schema, parsing, and provider/model namespace safety: enforce the rule that LLM agents must declare output: schemas for named-field access, and select valid models within provider namespaces.
  • Operational footgun coverage: avoid cross-platform subprocess issues, env-var parsing collisions, group/parallel output key differences, and iteration-limit pitfalls that only show up at execution time.

Quick Start

Use this skill to diagnose a failing workflow by checking whether the referenced template fields match the producing agent’s declared output shape and schema, then verify the route table includes an explicit match (or intended terminal) for every possible output value.

Frequently Asked Questions about conductor-mechanics

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

FAQPage Schema
How do I debug routing failures in Conductor workflow YAML?

Debug Conductor workflow YAML routing failures by verifying route `when:` conditions match the full output domain and ensuring an explicit catch-all exists to prevent silent truncation or execution-time crashes.

Why does my template evaluation fail to access LLM agent output fields?

Template evaluation fails when LLM agents lack explicit `output:` schemas for named-field access, requiring you to declare schemas or handle provider-specific raw-string fallbacks to expose expected fields.

How do agent output shapes differ from group outputs in Conductor workflows?

Agent output shapes differ from group outputs in Conductor workflows by exposing individual typed fields versus parallel output keys, requiring you to align runtime data shapes with the producer's declared schema.

What causes silent truncation in workflow routing conditions?

Silent truncation in workflow routing conditions is caused by missing catch-all routes that fail to match every possible output value, resulting in unhandled execution paths and route failures.

How do I avoid subprocess and environment variable issues in Conductor YAML?

Avoid cross-platform subprocess issues and env-var parsing collisions in Conductor YAML by enforcing safe execution constraints, scanning environment variables correctly, and verifying provider/model namespace correctness.

Do I need to declare output schemas for all agents in a Conductor workflow?

You must declare explicit `output:` schemas for LLM agents in Conductor workflows to enable named-field access, as runtime contracts require scripts, LLM agents, and human gates to exchange typed outputs.