agency-workflow-architect

Map system workflows into build-ready workflow tree specifications with step-level actions and test cases.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/omeraltn/ice_cream_website_testing --skill agency-workflow-architect-omeraltn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agency-workflow-architect
Source: https://github.com/omeraltn/ice_cream_website_testing/tree/main/.antigravity/agency-workflow-architect
Command: npx skills add https://github.com/omeraltn/ice_cream_website_testing --skill agency-workflow-architect-omeraltn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the risk of undocumented or partially documented workflows by discovering, naming, and fully specifying every path through a system so engineers, QA, and operators can implement and test reliably. It prevents production surprises caused by implicit workflows, race conditions, missing cleanup steps, and untracked assumptions. It ensures every handoff and failure mode is explicit and actionable.

Core Features & Use Cases

  • Comprehensive Discovery: Scan routes, workers, migrations, infra, and config to find workflow entry points and implicit lifecycles.
  • Structured Workflow Trees: Produce step-by-step specs with timeouts, observable states, handoff contracts, cleanup inventories, and derived test cases.
  • Reality Checker Integration: Compare specs against actual code and record discrepancies, assumptions, and remediation actions.
  • Use Case: Turn an undocumented order checkout flow into an approved WORKFLOW-order-checkout.md that developers and QA use to implement and validate the system.

Quick Start

Ask the Workflow Architect to generate a WORKFLOW tree spec for the "order checkout" flow by scanning the repository's routes, workers, and infra and listing all failure modes and recovery paths.

Frequently Asked Questions about agency-workflow-architect

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

FAQPage Schema
How do I document undocumented API workflows and failure modes for engineers and QA?

To document undocumented API workflows, you scan repository routes, workers, and infrastructure to discover entry points and implicit lifecycles, generating build-ready specs with failure modes, handoff contracts, and test cases.

What is a workflow tree specification and when do I need one for background jobs?

A workflow tree specification is an exhaustive, step-level breakdown of system paths including timeouts, observable states, and cleanup inventories. You need one for background jobs to prevent production surprises caused by implicit workflows and race conditions.

How to generate test cases and cleanup inventories from existing user journeys?

Generate test cases and cleanup inventories by mapping user journeys into structured workflow trees that specify step-level actions, handoff payload schemas, and observable states suitable for QA validation.

Can I compare my workflow specifications against actual code to find discrepancies?

Yes, you can compare workflow specifications against actual code using reality checker integration to record discrepancies, track assumptions, and define remediation actions for undocumented branches.

What's the best way to specify handoff payload schemas for scheduled tasks?

The best way to specify handoff payload schemas for scheduled tasks is to map them into structured workflow trees that explicitly define every handoff, failure mode, and observable state.

What are the limitations of discovering implicit workflows in infrastructure modules?

A limitation is that discovering implicit workflows in infrastructure modules requires scanning existing config and migrations to find entry points, meaning fully untracked or dynamically generated infrastructure paths may remain undiscovered without explicit repository access.