Agent skill
workflow-spec-architect
Designs the cognitive blueprint of a workflow before code generation, focusing on Steps, Triggers, and Handoffs.
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
- User Intent: The raw request describing the desired workflow.
- The Law (Hard Constraints): You MUST scan
.agent/rules/first. These override everything. - The Library (Soft Context): You SHOULD scan
.agent/knowledge-base/for patterns. - 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
- Ingest Rules: Read
.agent/rules/to establish what is forbidden. - Analyze Existing Workflows: Read
.agent/workflows/to understand conventions. - Deconstruct Intent: Break down the user request into discrete steps.
- Select Strategy: Choose the appropriate workflow pattern (Sequential, Fork-Join, State Machine, Loop).
- Map Handoffs: Identify which skills/agents are needed at each step.
- Define Termination: Establish clear exit conditions to prevent infinite loops.
- Specify Blueprint: Create the formal blueprint document.
5. Output
Generate the Workflow Blueprint strictly using the template in references/workflow-blueprint-template.md.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?