create-saga

Generate saga scaffolds with placeholder steps for Firefly Framework orchestration.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/fireflyframework/fireflyframework-claude-skills --skill create-saga
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-saga
Source: https://github.com/fireflyframework/fireflyframework-claude-skills/tree/main/commands/create-saga
Command: npx skills add https://github.com/fireflyframework/fireflyframework-claude-skills --skill create-saga

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill bootstraps a consistent saga orchestration skeleton with placeholder steps and compensation logic to accelerate implementing Firefly-based workflows.

Core Features & Use Cases

  • Saga skeleton generation: Creates a structured saga class and corresponding step scaffolding following Firefly orchestration patterns.
  • Template artifacts: Provides template saga class and derived values (sagaId, sagaClass, etc.), and event constants skeletons for quick integration.
  • Project placement guidance: Determines correct module and package paths, enabling rapid wiring into multi-module projects.
  • Use case: When starting a new domain workflow that requires orchestration across steps with compensation, this skill provides a ready-made foundation to customize.

Quick Start

Run the /create-saga <name> command with a PascalCase name to generate a saga skeleton.

Frequently Asked Questions about create-saga

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

FAQPage Schema
How do I scaffold a saga workflow with compensation logic for multi-service orchestration?

Scaffolding a saga workflow generates a structured saga class with placeholder steps and compensation logic. This provides a ready-made foundation following Firefly Framework orchestration patterns, enabling rapid customization for staged domain workflows across services.

What is saga orchestration and when do I need it for domain workflows?

Saga orchestration coordinates staged workflows across services with compensation and lifecycle events. You need it when designing domain workflows that require multi-step orchestration, allowing you to handle failures gracefully through defined compensation steps.

How do I generate a saga class and event constants in a multi-module project?

Generating a saga class places the file in core/workflows, while event constants skeletons are placed in interfaces. This project placement guidance determines correct module and package paths, enabling rapid wiring into multi-module Firefly Framework projects.

Does the Firefly Framework support CQRS and saga patterns for distributed transactions?

Yes, the Firefly Framework supports CQRS and saga patterns. This skill generates saga scaffolding with derived values like sagaId and sagaClass, along with event constants skeletons, specifically designed for Firefly orchestration and rapid integration.

Can I customize placeholder steps after generating a saga skeleton?

Yes, placeholder steps are designed for customization. The skill bootstraps a consistent saga orchestration skeleton with placeholder steps and compensation logic to accelerate implementing Firefly-based workflows, providing a ready-made foundation to modify.

What are the limitations of using a generated saga scaffold for event-driven architecture?

The generated saga scaffold provides placeholder steps and compensation logic rather than complete implementations. It serves as a structural foundation for Firefly Framework orchestration, requiring manual customization to implement specific domain workflow logic and validation.