| name | ensemble-create-workstream-trd |
| description | Generate a normalized executable workstream TRD from multiple source TRDs (Codex skill for /ensemble:create-workstream-trd) |
| user-invocable | true |
| argument-hint | <trd-path> <trd-path> [more-trd-paths] [--out path] |
| model | gpt-5.1-codex |
Ensemble Command: /ensemble:create-workstream-trd
This Codex skill mirrors the Ensemble slash command /ensemble:create-workstream-trd.
Follow the workflow below, adapt to the current repository, and keep outputs structured.
Combine multiple canonical TRDs into one generated, executable workstream TRD
that preserves source PRD/TRD/REQ/AC provenance and can be passed as the
single input to /ensemble:implement-trd-beads.
Source TRDs remain canonical. The generated workstream TRD is an execution
artifact that normalizes the graph-critical Master Task List while preserving
source task markdown verbatim. It decomposes every referenced PRD acceptance
criterion into AC-level implementation, executable-test, and validation tasks
with Definition of Done evidence requirements. Generated workstream files
use micro UUID document IDs (TRD-YYYY-<8hex>-workstream-.md), not
sequence numbers, to avoid collisions across large teams.
Workflow
Phase 1: Generate Workstream TRD
1. Parse Arguments
Validate source TRD paths and locate deterministic TRD CLI
- Extract all .md paths from $ARGUMENTS in the order provided. Require at least two TRD paths.
- If fewer than two paths are supplied: print 'ERROR: create-workstream-trd requires two or more TRD paths.' and HALT.
- Resolve TRD_CLI to first existing path among: ${CLAUDE_PLUGIN_ROOT}/lib/trd-cli.js, packages/development/lib/trd-cli.js. If missing, print error and HALT.
2. Generate
Create normalized executable workstream TRD
- Run: node "$TRD_CLI" create-workstream-trd <TRD_PATHS...> plus --out if provided.
- Parse JSON stdout. If ok is false, process exits non-zero, or JSON malformed: print every error and HALT.
- The generated file MUST contain a Source TRD Manifest, normalized Master Task List, source provenance, verbatim source task markdown payloads, AC-level implementation tasks, AC-level executable test tasks, AC validation tasks, and Definition of Done evidence requirements. Default output path format is docs/TRD/workstreams/TRD-YYYY-<micro_uuid>-workstream-.md.
3. Report
Tell the user how to execute the generated workstream
- Print generated path, workstream slug, source TRD count, and next step: /ensemble:implement-trd-beads .
- Do not start implementation automatically.
Usage
/ensemble:create-workstream-trd <trd-path> <trd-path> [more-trd-paths] [--out path]
