dx-orchestrator

Enforce a specification-first workflow with role-based transitions in dx-managed repositories.

1|Updated May 12, 2026
One-click install
npx skills add https://github.com/dewitt/dx --skill dx-orchestrator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dx-orchestrator
Source: https://github.com/dewitt/dx/tree/main/skills/dx-orchestrator
Command: npx skills add https://github.com/dewitt/dx --skill dx-orchestrator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents semantic drift and silent failures in AI-assisted software development by enforcing a strict, declaration-first workflow where the specification acts as the single source of truth.

Core Features & Use Cases

  • Role-Based Routing: Automatically directs the AI to the appropriate role (archaeologist, architect, implementer, or judge) based on the task.
  • Workflow Enforcement: Ensures that all code generation is preceded by explicit assumption logging and followed by rigorous verification against defined contracts.
  • Use Case: When tasked with adding a new feature to a codebase, this skill ensures the architect updates the specification, the implementer writes the code, and the judge verifies the implementation against the new contracts, preventing ad-hoc coding.

Quick Start

Invoke the dx-orchestrator skill to analyze the current repository and determine the appropriate role for the requested development task.

Frequently Asked Questions about dx-orchestrator

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

FAQPage Schema
How do I enforce specification-first workflows in AI-assisted coding?

To enforce specification-first workflows in AI-assisted coding, use a declarative orchestration skill that routes tasks through role-based phases to ensure code conformance with defined invariants. This prevents semantic drift by making the specification the single source of truth.

Why does AI-generated code drift from the original architectural design?

AI-generated code drifts from architectural design due to ad-hoc coding without explicit assumption logging or contract verification. An orchestrator prevents this by enforcing role-based transitions between design, implementation, and rigorous verification against defined contracts.

What's the best way to manage role-based transitions for AI coding agents?

The best way to manage role-based transitions for AI coding agents is using a declarative orchestrator that automatically directs the AI to appropriate roles like architect, implementer, or judge based on the requested development task.

How do I prevent silent failures in AI-assisted software development?

Prevent silent failures in AI-assisted software development by enforcing strict linting, assumption logging, and contract-based testing protocols. An orchestration workflow ensures all code generation is followed by rigorous verification against defined contracts.

Can I use declarative orchestration to verify code against defined contracts?

Yes, you can use declarative orchestration to verify code against defined contracts by routing the task to a judge role that rigorously verifies the implementation against new contracts after the implementer writes the code.

Do I need to log assumptions before generating code in a declarative workflow?

Yes, in a declarative workflow you must log assumptions before generating code. Workflow enforcement ensures all code generation is preceded by explicit assumption logging to maintain system integrity and prevent semantic drift.