agent-workflow-architect

Map workflow execution paths, failure modes, and handoff contracts.

2|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/jlaws/dotfiles --skill agent-workflow-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-workflow-architect
Source: https://github.com/jlaws/dotfiles/tree/main/.agents/skills/agent-workflow-architect
Command: npx skills add https://github.com/jlaws/dotfiles --skill agent-workflow-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps product teams and engineering groups map complete execution paths, identify potential failure modes, design state machines, and formalize handoff contracts before coding, reducing rework and miscommunication.

Core Features & Use Cases

  • Workflow trees and state diagrams that capture all paths and transitions.
  • Failure mode analysis with cleanup inventories and recovery options.
  • Handoff contracts and clear interfaces to guide pre-implementation handovers to development.
  • Use Case: Before starting a major feature, create an end-to-end workflow specification that covers success paths, error paths, and boundary conditions.

Quick Start

Draft a baseline workflow for a chosen process, map its states and transitions, and outline the initial handoff contracts to guide the next phase.

Frequently Asked Questions about agent-workflow-architect

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

FAQPage Schema
What's the best way to map workflow failure modes before coding?

Workflow failure mode mapping identifies all potential execution paths and boundary conditions upfront. By designing state machines and documenting cleanup inventories before implementation, teams reduce rework and miscommunication across product and engineering groups.

How do I design a state machine for pre-implementation workflow planning?

To design a pre-implementation state machine, draft a baseline process, map its states and transitions, and outline handoff contracts. This captures all execution paths and failure handling requirements, ensuring clear interfaces before development begins.

Why do I need handoff contracts for workflow state transitions?

Handoff contracts formalize clear interfaces between engineering and product teams. Defining these contracts before coding ensures all execution paths and failure recovery options are documented, preventing miscommunication during pre-implementation handovers.

Can I document all execution paths and error states for a major feature?

Yes, you can document all execution paths by creating an end-to-end workflow specification. This specification captures success paths, error paths, and boundary conditions, translating them into canonical state machines and cleanup inventories.

What are the limitations of design-first workflow mapping?

Design-first workflow mapping requires a defined baseline process to begin. It focuses on pre-implementation planning and state-machine construction, meaning it must be completed before coding starts to effectively reduce downstream rework.