@output.ai/cli 0.4.2 → 0.5.1

package/README.md

@@ -5,11 +5,7 @@ Command-line interface for creating and running Output Framework workflows.
 [![npm version](https://img.shields.io/npm/v/@output.ai/cli)](https://www.npmjs.com/package/@output.ai/cli)
 [![Documentation](https://img.shields.io/badge/docs-docs.output.ai-blue)](https://docs.output.ai/packages/cli)
 
-## Installation
-
-```bash
-npm install -g @output.ai/cli
-```
+> **Full Documentation**: For detailed command options, flags, and examples, see the [CLI Reference](https://docs.output.ai/packages/cli).
 
 ## Quick Start
 
@@ -35,11 +31,13 @@ output workflow run simple --input '{"question": "who is ada lovelace?"}'
 | `output workflow plan` | Generate a workflow plan from description |
 | `output workflow generate` | Generate a workflow from plan |
 | `output workflow list` | List available workflows |
+| `output workflow runs list` | List recent workflow runs |
 | `output workflow run` | Execute a workflow synchronously |
 | `output workflow start` | Start a workflow asynchronously |
 | `output workflow status` | Get workflow execution status |
 | `output workflow result` | Get workflow execution result |
 | `output workflow stop` | Stop a workflow execution |
+| `output workflow debug` | Display workflow execution trace |
 
 ## Development Services
 
@@ -53,7 +51,7 @@ Running `output dev` starts:
 
 ## Documentation
 
-For comprehensive documentation, visit:
+For comprehensive documentation including all command flags and detailed examples:
 
-- [CLI Reference](https://docs.output.ai/packages/cli)
-- [Getting Started](https://docs.output.ai/quickstart)
+- [CLI Reference](https://docs.output.ai/packages/cli) - Complete command documentation
+- [Getting Started](https://docs.output.ai/quickstart) - Project setup guide

package/dist/assets/docker/docker-compose-dev.yml

@@ -105,7 +105,15 @@ services:
       - TEMPORAL_ADDRESS=temporal:7233
       - TRACE_LOCAL_ON=true
       - HOST_TRACE_PATH=${PWD}/logs
-    command: npm run start-worker
+    command: >
+      sh -c "
+        npm run output:worker:install &&
+        echo 'Installed dependencies' &&
+        npm run output:worker:build &&
+        echo 'Built worker' &&
+        npm run output:worker:start &&
+        echo 'Started worker'
+      "
     working_dir: /app
     volumes:
       - ./:/app

package/dist/services/coding_agents.js

@@ -36,19 +36,29 @@ export const AGENT_CONFIGS = {
             },
             {
                 type: 'template',
-                from: 'agents/context_fetcher.md.template',
-                to: `${AGENT_CONFIG_DIR}/agents/context_fetcher.md`
+                from: 'agents/workflow_context_fetcher.md.template',
+                to: `${AGENT_CONFIG_DIR}/agents/workflow_context_fetcher.md`
             },
             {
                 type: 'template',
-                from: 'agents/prompt_writer.md.template',
-                to: `${AGENT_CONFIG_DIR}/agents/prompt_writer.md`
+                from: 'agents/workflow_prompt_writer.md.template',
+                to: `${AGENT_CONFIG_DIR}/agents/workflow_prompt_writer.md`
+            },
+            {
+                type: 'template',
+                from: 'agents/workflow_debugger.md.template',
+                to: `${AGENT_CONFIG_DIR}/agents/workflow_debugger.md`
             },
             {
                 type: 'template',
                 from: 'commands/plan_workflow.md.template',
                 to: `${AGENT_CONFIG_DIR}/commands/plan_workflow.md`
             },
+            {
+                type: 'template',
+                from: 'commands/debug_workflow.md.template',
+                to: `${AGENT_CONFIG_DIR}/commands/debug_workflow.md`
+            },
             {
                 type: 'template',
                 from: 'commands/build_workflow.md.template',
@@ -63,6 +73,82 @@ export const AGENT_CONFIGS = {
                 type: 'template',
                 from: 'meta/post_flight.md.template',
                 to: '.outputai/meta/post_flight.md'
+            },
+            // Skills (all at top level - no nesting allowed)
+            {
+                type: 'template',
+                from: 'skills/output-services-check/SKILL.md.template',
+                to: `${AGENT_CONFIG_DIR}/skills/output-services-check/SKILL.md`
+            },
+            {
+                type: 'template',
+                from: 'skills/output-workflow-trace/SKILL.md.template',
+                to: `${AGENT_CONFIG_DIR}/skills/output-workflow-trace/SKILL.md`
+            },
+            {
+                type: 'template',
+                from: 'skills/output-workflow-list/SKILL.md.template',
+                to: `${AGENT_CONFIG_DIR}/skills/output-workflow-list/SKILL.md`
+            },
+            {
+                type: 'template',
+                from: 'skills/output-workflow-runs-list/SKILL.md.template',
+                to: `${AGENT_CONFIG_DIR}/skills/output-workflow-runs-list/SKILL.md`
+            },
+            {
+                type: 'template',
+                from: 'skills/output-workflow-run/SKILL.md.template',
+                to: `${AGENT_CONFIG_DIR}/skills/output-workflow-run/SKILL.md`
+            },
+            {
+                type: 'template',
+                from: 'skills/output-workflow-start/SKILL.md.template',
+                to: `${AGENT_CONFIG_DIR}/skills/output-workflow-start/SKILL.md`
+            },
+            {
+                type: 'template',
+                from: 'skills/output-workflow-status/SKILL.md.template',
+                to: `${AGENT_CONFIG_DIR}/skills/output-workflow-status/SKILL.md`
+            },
+            {
+                type: 'template',
+                from: 'skills/output-workflow-result/SKILL.md.template',
+                to: `${AGENT_CONFIG_DIR}/skills/output-workflow-result/SKILL.md`
+            },
+            {
+                type: 'template',
+                from: 'skills/output-workflow-stop/SKILL.md.template',
+                to: `${AGENT_CONFIG_DIR}/skills/output-workflow-stop/SKILL.md`
+            },
+            {
+                type: 'template',
+                from: 'skills/output-error-zod-import/SKILL.md.template',
+                to: `${AGENT_CONFIG_DIR}/skills/output-error-zod-import/SKILL.md`
+            },
+            {
+                type: 'template',
+                from: 'skills/output-error-nondeterminism/SKILL.md.template',
+                to: `${AGENT_CONFIG_DIR}/skills/output-error-nondeterminism/SKILL.md`
+            },
+            {
+                type: 'template',
+                from: 'skills/output-error-try-catch/SKILL.md.template',
+                to: `${AGENT_CONFIG_DIR}/skills/output-error-try-catch/SKILL.md`
+            },
+            {
+                type: 'template',
+                from: 'skills/output-error-missing-schemas/SKILL.md.template',
+                to: `${AGENT_CONFIG_DIR}/skills/output-error-missing-schemas/SKILL.md`
+            },
+            {
+                type: 'template',
+                from: 'skills/output-error-direct-io/SKILL.md.template',
+                to: `${AGENT_CONFIG_DIR}/skills/output-error-direct-io/SKILL.md`
+            },
+            {
+                type: 'template',
+                from: 'skills/output-error-http-client/SKILL.md.template',
+                to: `${AGENT_CONFIG_DIR}/skills/output-error-http-client/SKILL.md`
             }
         ]
     },
@@ -87,23 +173,109 @@ export const AGENT_CONFIGS = {
             },
             {
                 type: 'symlink',
-                from: `${AGENT_CONFIG_DIR}/agents/context_fetcher.md`,
-                to: '.claude/agents/context_fetcher.md'
+                from: `${AGENT_CONFIG_DIR}/agents/workflow_context_fetcher.md`,
+                to: '.claude/agents/workflow_context_fetcher.md'
             },
             {
                 type: 'symlink',
-                from: `${AGENT_CONFIG_DIR}/agents/prompt_writer.md`,
-                to: '.claude/agents/prompt_writer.md'
+                from: `${AGENT_CONFIG_DIR}/agents/workflow_prompt_writer.md`,
+                to: '.claude/agents/workflow_prompt_writer.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/agents/workflow_debugger.md`,
+                to: '.claude/agents/workflow_debugger.md'
             },
             {
                 type: 'symlink',
                 from: `${AGENT_CONFIG_DIR}/commands/plan_workflow.md`,
                 to: '.claude/commands/plan_workflow.md'
             },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/commands/debug_workflow.md`,
+                to: '.claude/commands/debug_workflow.md'
+            },
             {
                 type: 'symlink',
                 from: `${AGENT_CONFIG_DIR}/commands/build_workflow.md`,
                 to: '.claude/commands/build_workflow.md'
+            },
+            // Skills Symlinks (all at top level - no nesting allowed)
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/skills/output-services-check/SKILL.md`,
+                to: '.claude/skills/output-services-check/SKILL.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/skills/output-workflow-trace/SKILL.md`,
+                to: '.claude/skills/output-workflow-trace/SKILL.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/skills/output-workflow-list/SKILL.md`,
+                to: '.claude/skills/output-workflow-list/SKILL.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/skills/output-workflow-runs-list/SKILL.md`,
+                to: '.claude/skills/output-workflow-runs-list/SKILL.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/skills/output-workflow-run/SKILL.md`,
+                to: '.claude/skills/output-workflow-run/SKILL.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/skills/output-workflow-start/SKILL.md`,
+                to: '.claude/skills/output-workflow-start/SKILL.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/skills/output-workflow-status/SKILL.md`,
+                to: '.claude/skills/output-workflow-status/SKILL.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/skills/output-workflow-result/SKILL.md`,
+                to: '.claude/skills/output-workflow-result/SKILL.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/skills/output-workflow-stop/SKILL.md`,
+                to: '.claude/skills/output-workflow-stop/SKILL.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/skills/output-error-zod-import/SKILL.md`,
+                to: '.claude/skills/output-error-zod-import/SKILL.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/skills/output-error-nondeterminism/SKILL.md`,
+                to: '.claude/skills/output-error-nondeterminism/SKILL.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/skills/output-error-try-catch/SKILL.md`,
+                to: '.claude/skills/output-error-try-catch/SKILL.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/skills/output-error-missing-schemas/SKILL.md`,
+                to: '.claude/skills/output-error-missing-schemas/SKILL.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/skills/output-error-direct-io/SKILL.md`,
+                to: '.claude/skills/output-error-direct-io/SKILL.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/skills/output-error-http-client/SKILL.md`,
+                to: '.claude/skills/output-error-http-client/SKILL.md'
             }
         ]
     }

package/dist/services/coding_agents.spec.js

@@ -33,17 +33,23 @@ describe('coding_agents service', () => {
             expect(files).toContain('CLAUDE.md');
             expect(files).toContain('.claude/agents/workflow_planner.md');
             expect(files).toContain('.claude/commands/plan_workflow.md');
+            // Spot check skill files (all at top level - no nesting)
+            expect(files).toContain('.outputai/skills/output-services-check/SKILL.md');
+            expect(files).toContain('.outputai/skills/output-workflow-list/SKILL.md');
+            expect(files).toContain('.outputai/skills/output-error-zod-import/SKILL.md');
+            expect(files).toContain('.claude/skills/output-workflow-trace/SKILL.md');
+            expect(files).toContain('.claude/skills/output-workflow-run/SKILL.md');
+            expect(files).toContain('.claude/skills/output-error-nondeterminism/SKILL.md');
         });
         it('should include both outputai and claude-code files', () => {
             const files = getRequiredFiles();
             const expectedCount = AGENT_CONFIGS.outputai.mappings.length +
                 AGENT_CONFIGS['claude-code'].mappings.length;
             expect(files.length).toBe(expectedCount);
-            expect(files.length).toBe(16);
         });
         it('should have outputai files with .outputai prefix', () => {
             const files = getRequiredFiles();
-            const outputaiFiles = files.slice(0, 9);
+            const outputaiFiles = files.slice(0, 26);
             outputaiFiles.forEach(file => {
                 expect(file).toMatch(/^\.outputai\//);
             });
@@ -78,19 +84,56 @@ describe('coding_agents service', () => {
                     '.outputai/AGENTS.md',
                     '.outputai/agents/workflow_planner.md',
                     '.outputai/agents/workflow_quality.md',
-                    '.outputai/agents/context_fetcher.md',
-                    '.outputai/agents/prompt_writer.md',
+                    '.outputai/agents/workflow_context_fetcher.md',
+                    '.outputai/agents/workflow_prompt_writer.md',
+                    '.outputai/agents/workflow_debugger.md',
                     '.outputai/commands/plan_workflow.md',
+                    '.outputai/commands/debug_workflow.md',
                     '.outputai/commands/build_workflow.md',
                     '.outputai/meta/pre_flight.md',
                     '.outputai/meta/post_flight.md',
+                    // Skills (all at top level - no nesting allowed)
+                    '.outputai/skills/output-services-check/SKILL.md',
+                    '.outputai/skills/output-workflow-trace/SKILL.md',
+                    '.outputai/skills/output-workflow-list/SKILL.md',
+                    '.outputai/skills/output-workflow-runs-list/SKILL.md',
+                    '.outputai/skills/output-workflow-run/SKILL.md',
+                    '.outputai/skills/output-workflow-start/SKILL.md',
+                    '.outputai/skills/output-workflow-status/SKILL.md',
+                    '.outputai/skills/output-workflow-result/SKILL.md',
+                    '.outputai/skills/output-workflow-stop/SKILL.md',
+                    '.outputai/skills/output-error-zod-import/SKILL.md',
+                    '.outputai/skills/output-error-nondeterminism/SKILL.md',
+                    '.outputai/skills/output-error-try-catch/SKILL.md',
+                    '.outputai/skills/output-error-missing-schemas/SKILL.md',
+                    '.outputai/skills/output-error-direct-io/SKILL.md',
+                    '.outputai/skills/output-error-http-client/SKILL.md',
+                    // Claude-code symlinks
                     'CLAUDE.md',
                     '.claude/agents/workflow_planner.md',
                     '.claude/agents/workflow_quality.md',
-                    '.claude/agents/context_fetcher.md',
-                    '.claude/agents/prompt_writer.md',
+                    '.claude/agents/workflow_context_fetcher.md',
+                    '.claude/agents/workflow_prompt_writer.md',
+                    '.claude/agents/workflow_debugger.md',
                     '.claude/commands/plan_workflow.md',
-                    '.claude/commands/build_workflow.md'
+                    '.claude/commands/debug_workflow.md',
+                    '.claude/commands/build_workflow.md',
+                    // Claude-code skill symlinks (all at top level - no nesting allowed)
+                    '.claude/skills/output-services-check/SKILL.md',
+                    '.claude/skills/output-workflow-trace/SKILL.md',
+                    '.claude/skills/output-workflow-list/SKILL.md',
+                    '.claude/skills/output-workflow-runs-list/SKILL.md',
+                    '.claude/skills/output-workflow-run/SKILL.md',
+                    '.claude/skills/output-workflow-start/SKILL.md',
+                    '.claude/skills/output-workflow-status/SKILL.md',
+                    '.claude/skills/output-workflow-result/SKILL.md',
+                    '.claude/skills/output-workflow-stop/SKILL.md',
+                    '.claude/skills/output-error-zod-import/SKILL.md',
+                    '.claude/skills/output-error-nondeterminism/SKILL.md',
+                    '.claude/skills/output-error-try-catch/SKILL.md',
+                    '.claude/skills/output-error-missing-schemas/SKILL.md',
+                    '.claude/skills/output-error-direct-io/SKILL.md',
+                    '.claude/skills/output-error-http-client/SKILL.md'
                 ],
                 isComplete: false
             });
@@ -104,7 +147,7 @@ describe('coding_agents service', () => {
                 missingFiles: [],
                 isComplete: true
             });
-            expect(access).toHaveBeenCalledTimes(17); // dir + 9 outputai + 7 claude-code
+            expect(access).toHaveBeenCalledTimes(51); // dir + 26 outputai + 24 claude-code
         });
         it('should return missing files when some files do not exist', async () => {
             const missingFiles = new Set([
@@ -180,10 +223,10 @@ describe('coding_agents service', () => {
                 force: false,
                 agentProvider: 'claude-code'
             });
-            // Should create outputai files (6 templates)
+            // Should create outputai files (26 templates)
             expect(fs.writeFile).toHaveBeenCalledWith(expect.stringContaining('AGENTS.md'), expect.any(String), 'utf-8');
-            // Should create symlinks (7 symlinks for claude-code)
-            expect(fs.symlink).toHaveBeenCalledTimes(7);
+            // Should create symlinks (24 symlinks for claude-code)
+            expect(fs.symlink).toHaveBeenCalledTimes(24);
         });
         it('should skip existing files when force is false', async () => {
             // Mock some files exist

package/dist/templates/agent_instructions/AGENTS.md.template

@@ -40,17 +40,17 @@ src/workflows/{name}/
 ## Commands
 
 ```bash
-output dev                                      # Start dev (Temporal:8080, API:3001)
-output workflow list                            # List workflows
+npx output dev                                      # Start dev (Temporal:8080, API:3001)
+npx output workflow list                            # List workflows
 
 # Sync execution (waits for result)
-output workflow run <name> --input <JSON|JSON_FILE>      # Execute and wait
+npx output workflow run <name> --input <JSON|JSON_FILE>      # Execute and wait
 
 # Async execution
-output workflow start <name> --input <JSON|JSON_FILE>    # Start workflow, returns ID
-output workflow status <workflowId>             # Check execution status
-output workflow result <workflowId>             # Get result when complete
-output workflow stop <workflowId>               # Cancel running workflow
+npx output workflow start <name> --input <JSON|JSON_FILE>    # Start workflow, returns ID
+npx output workflow status <workflowId>             # Check execution status
+npx output workflow result <workflowId>             # Get result when complete
+npx output workflow stop <workflowId>               # Cancel running workflow
 ```
 
 ## Workflow Pattern
@@ -205,15 +205,21 @@ throw new FatalError('Critical failure - do not retry');
 throw new ValidationError('Invalid input format');
 ```
 
-## Agent System
+## Sub-Agents
 
 For workflow planning and implementation:
-- `.claude/agents/workflow_planner.md` - Workflow architecture specialist
-- `.claude/agents/workflow_quality.md` - Workflow quality and best practices specialist
-- `.claude/agents/prompt_writer.md` - Prompt file creation and review specialist
-- `.claude/agents/context_fetcher.md` - Efficient context retrieval (used by other agents)
-- `.claude/commands/plan_workflow.md` - Planning command
-- `.claude/commands/build_workflow.md` - Implementation command
+- workflow-planner: `.claude/agents/workflow_planner.md` - Workflow architecture specialist
+- workflow-quality: `.claude/agents/workflow_quality.md` - Workflow quality and best practices specialist
+- workflow-prompt-writer: `.claude/agents/workflow_prompt_writer.md` - Prompt file creation and review specialist
+- workflow-context-fetcher: `.claude/agents/workflow_context_fetcher.md` - Efficient context retrieval (used by other agents)
+- workflow-debugger: `.claude/agents/workflow_debugger.md` - Workflow debugging specialist
+
+## Commands
+
+For workflow planning and implementation:
+- /plan_workflow: `.claude/commands/plan_workflow.md` - Planning command
+- /build_workflow: `.claude/commands/build_workflow.md` - Implementation command
+- /debug_workflow: `.claude/commands/debug_workflow.md` - Debugging command
 
 ## Configuration
 

package/dist/templates/agent_instructions/agents/{context_fetcher.md.template → workflow_context_fetcher.md.template}

@@ -1,5 +1,5 @@
 ---
-name: context-fetcher
+name: workflow-context-fetcher
 description: Use proactively to retrieve and extract relevant information from Output SDK project documentation files. Checks if content is already in context before returning.
 tools: Read, Grep, Glob
 model: haiku

package/dist/templates/agent_instructions/agents/workflow_debugger.md.template

@@ -0,0 +1,98 @@
+---
+name: workflow-debugger
+description: Use this agent when you need to debug Output SDK workflows in local development. Invoke when workflows fail, return unexpected results, or you need to analyze execution traces to identify root causes.
+model: opus
+color: yellow
+---
+
+# Output SDK Workflow Debugger Agent
+
+## Identity
+
+You are an Output SDK debugging expert who specializes in diagnosing and resolving workflow execution issues in local development environments. You use a systematic approach: verify infrastructure, gather evidence from execution traces, identify root causes, and suggest targeted fixes based on common error patterns.
+
+## Context Retrieval
+
+Use the `workflow-quality` subagent for:
+- **Code Quality Guidance**: Import conventions, determinism rules, step boundaries
+- **Best Practices**: Schema definitions, retry policies, error handling
+- **Common Pitfalls**: Known issues and their solutions
+
+Use the `workflow-context-fetcher` subagent for:
+- **Project Structure**: Find workflow files in `src/workflows/*/`
+- **Existing Patterns**: Examine similar implementations for comparison
+
+## CLI Commands for Debugging
+
+For detailed command usage, Claude will automatically invoke the relevant skill.
+
+### Quick Reference
+
+| Command | Purpose |
+|---------|---------|
+| `npx output dev` | Start development services |
+| `npx output workflow list` | List available workflows |
+| `npx output workflow runs list` | List execution history |
+| `npx output workflow run` | Execute synchronously |
+| `npx output workflow start` | Start asynchronously |
+| `npx output workflow status` | Check execution status |
+| `npx output workflow result` | Get execution result |
+| `npx output workflow stop` | Stop running workflow |
+| `npx output workflow debug` | Analyze execution trace |
+
+## Temporal UI
+
+For visual workflow inspection and detailed execution timelines, access the Temporal Web UI at:
+
+**http://localhost:8080**
+
+The Temporal UI provides real-time visibility into workflow executions, event history, and task queues.
+
+## Systematic Debugging Approach
+
+### Step 1: Verify Infrastructure
+Confirm Docker containers are running and services are active.
+- **Skill**: `output-services-check`
+
+### Step 2: Gather Evidence
+List recent runs and identify the failing workflow ID.
+- **Skills**: `output-workflow-runs-list`, `output-workflow-trace`
+
+### Step 3: Analyze Trace
+Examine the trace for error messages, failed steps, and I/O data.
+- **Skill**: `output-workflow-trace`
+
+### Step 4: Apply Fix
+Match error symptoms to solutions and verify the fix.
+- **Skills**: `output-error-*` (matched by symptoms)
+
+## Example Interaction
+
+**User**: "My workflow is failing but I don't know why. The run ID is abc123."
+
+**Agent**: Let me help you debug this workflow. First, let's get the execution trace:
+
+```bash
+npx output workflow debug abc123 --format json
+```
+
+This will show us exactly where the workflow failed and what error occurred. While I analyze the trace, you can also check the Temporal UI at http://localhost:8080 for a visual timeline of the execution.
+
+**User**: "The trace shows an error about incompatible schemas in step 'processData'."
+
+**Agent**: This is likely the Zod import source issue. Check your step file - you're probably importing `z` from `zod` instead of `@output.ai/core`. These create different schema instances that aren't compatible.
+
+Change:
+```typescript
+import { z } from 'zod';
+```
+
+To:
+```typescript
+import { z } from '@output.ai/core';
+```
+
+After making this change, run the workflow again with `npx output workflow run <workflowName>` to verify the fix.
+
+---
+*This agent specializes in debugging Output SDK workflows in local development environments.*

package/dist/templates/agent_instructions/agents/workflow_planner.md.template

@@ -14,12 +14,12 @@ You are a Output SDK workflow planning specialist who follows structured XML-bas
 Your workflow planning follows the structured process defined in `/plan_workflow` command with explicit numbered steps and validation checkpoints.
 
 ### Context Retrieval
-Use the `context-fetcher` subagent to retrieve documentation only if not already in context:
+Use the `workflow-context-fetcher` subagent to retrieve documentation only if not already in context:
 - **Pre-Flight**: `.outputai/meta/pre_flight.md` - validation rules and smart defaults
 - **Post-Flight**: `.outputai/meta/post_flight.md` - completion checklist
 - **Existing Patterns**: `src/workflows/*/workflow.ts` - similar workflow patterns
 
-Use the `prompt-writer` subagent for:
+Use the `workflow-prompt-writer` subagent for:
 - Creating and reviewing `.prompt` files
 - Liquid.js template syntax guidance
 - Provider/model configuration
@@ -64,7 +64,7 @@ Only request clarification for:
 - Specify workerModule service usage
 
 ### 🏗️ Step 5-6: Prompt & Orchestration Planning
-- Design LLM prompts with template variables (delegate to `prompt-writer` subagent for implementation)
+- Design LLM prompts with template variables (delegate to `workflow-prompt-writer` subagent for implementation)
 - Define workflow execution logic step-by-step
 - Plan conditional logic and data flow
 - Generate TypeScript code templates

package/dist/templates/agent_instructions/agents/{prompt_writer.md.template → workflow_prompt_writer.md.template}

@@ -1,5 +1,5 @@
 ---
-name: prompt-writer
+name: workflow-prompt-writer
 description: Use this agent when writing, reviewing, or debugging LLM prompt files (.prompt). Specializes in Liquid.js template syntax, YAML frontmatter configuration, and Output SDK prompt conventions.
 tools: Read, Write, Edit, Grep, Glob
 model: sonnet

package/dist/templates/agent_instructions/agents/workflow_quality.md.template

@@ -13,11 +13,11 @@ You are an Output SDK implementation expert who ensures workflow code follows be
 
 ## Context Retrieval
 
-Use the `context-fetcher` subagent to efficiently retrieve:
+Use the `workflow-context-fetcher` subagent to efficiently retrieve:
 - **Existing Patterns**: Find similar implementations in `src/workflows/*/`
 - **Project Conventions**: Check `.outputai/AGENTS.md` for project-specific rules
 
-Use the `prompt-writer` subagent for:
+Use the `workflow-prompt-writer` subagent for:
 - Creating new `.prompt` files
 - Reviewing or debugging prompt template syntax
 - Understanding Liquid.js syntax and YAML frontmatter

package/dist/templates/agent_instructions/commands/build_workflow.md.template

@@ -25,7 +25,7 @@ Implement the workflow described in the plan document, following Output SDK patt
 
 <process_flow>
 
-<step number="1" name="plan_analysis" subagent="context-fetcher">
+<step number="1" name="plan_analysis" subagent="workflow-context-fetcher">
 
 ### Step 1: Plan Analysis
 
@@ -122,7 +122,7 @@ export const stepName = step( {
 
 </step>
 
-<step number="4" name="prompt_templates" subagent="prompt-writer">
+<step number="4" name="prompt_templates" subagent="workflow-prompt-writer">
 
 ### Step 4: Prompt Templates (if needed)