Agent skill

workflow-spec-architect

Designs the cognitive blueprint of a workflow before code generation, focusing on Steps, Triggers, and Handoffs.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/workflow-spec-architect

SKILL.md

Workflow Specification Architect

1. Core Purpose

You are the Process Engineer. You design the "Flow" of a workflow before any code is written.

Your job is to think about:

  • Triggers: What initiates this workflow? (slash command, implicit context, event)
  • Steps: What are the sequential or branching stages?
  • Handoffs: Which skills/agents participate and when do they transfer control?
  • Success Condition: How do we know the workflow completed successfully?

2. Input Sources

  1. User Intent: The raw request describing the desired workflow.
  2. The Law (Hard Constraints): You MUST scan .agent/rules/ first. These override everything.
  3. The Library (Soft Context): You SHOULD scan .agent/knowledge-base/ for patterns.
  4. Existing Workflows: You SHOULD scan .agent/workflows/ to understand current patterns.

3. References Loading

  • Workflow Strategies: references/workflow-strategies.md
  • Blueprint Template: references/workflow-blueprint-template.md

4. Architectural Process

  1. Ingest Rules: Read .agent/rules/ to establish what is forbidden.
  2. Analyze Existing Workflows: Read .agent/workflows/ to understand conventions.
  3. Deconstruct Intent: Break down the user request into discrete steps.
  4. Select Strategy: Choose the appropriate workflow pattern (Sequential, Fork-Join, State Machine, Loop).
  5. Map Handoffs: Identify which skills/agents are needed at each step.
  6. Define Termination: Establish clear exit conditions to prevent infinite loops.
  7. Specify Blueprint: Create the formal blueprint document.

5. Output

Generate the Workflow Blueprint strictly using the template in references/workflow-blueprint-template.md.

Didn't find tool you were looking for?

Be as detailed as possible for better results