What is the RED phase in this context?

The RED phase involves identifying a real execution failure—such as a commit to the wrong branch—and creating a test scenario that reproduces that specific failure.

What is workflow testing with subagents?

It is the process of using AI subagents to test the clarity of your instructions by trying to break them under simulated pressure to find ambiguities.

Why use simulated pressure during testing?

Agents are more likely to take shortcuts or misread steps when simulated as 'tired' or 'rushed,' revealing hidden ambiguities that wouldn't appear in perfect conditions.

When should I use this skill?

Use it whenever you are creating complex multi-step commands or orchestrator prompts where the specific order of execution is critical for the task's success.

How does this differ from testing-skills?

While testing-skills focuses on whether an agent will comply with rules, workflow testing focuses on whether the agent can correctly understand and follow specific task steps.

Workflow Testing with Subagents

Name: Workflow Testing with Subagents
Author: arittr

byarittr

•

Security & Testing

Validates the clarity of orchestrator prompts and workflow documentation by simulating real-world execution failures with subagents.

This skill adapts Test-Driven Development (TDD) principles to the creation and optimization of Claude Code workflow instructions and command documentation. By identifying real-world execution failures, creating reproducible test scenarios under simulated pressure, and using subagents to verify fixes, it ensures that complex multi-step instructions are unambiguous and resistant to misinterpretation. It is particularly useful for developers building complex orchestrator prompts or multi-branch git workflows where clarity and execution order are critical for success, providing a structured framework to move from failing execution (RED) to verified clarity (GREEN).

Key Features

01Applies the Red-Green-Refactor cycle to non-code workflow documentation

02Identifies root causes of subagent misinterpretation in logs and reports

03Facilitates meta-testing to diagnose why previous instruction fixes failed

04Simulates realistic execution pressure to find instruction loopholes

056 GitHub stars

06Provides specific fix patterns for explicit sequential ordering and warnings

Use Cases

01Troubleshooting recurring errors in automated git workflows

02Hardening command documentation against agent misinterpretation

03Refining orchestrator prompts for complex multi-agent tasks

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add arittr/spectacular testing-workflows-with-subagents

For use in Claude.ai and ChatGPT

Download Skill