firefly-architect

Provide architecture guidance for Firefly Framework services with tiers, patterns, and module layouts.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides structured architectural guidance for Firefly Framework services, helping teams decide tiers, patterns, and module layouts to accelerate design quality and consistency.

Core Features & Use Cases

  • Decide optimal tier (Core, Domain, Experience, Application, Data) for new or existing services.
  • Choose architectural patterns (CQRS, Saga, Event Sourcing, EDA) with concrete rationale and Firefly-specific references.
  • Produce actionable architecture plans with module layouts, annotations, and configuration guidance.

Quick Start

Describe your service goals and I will propose an architecture plan with tier, patterns, and module structure.

Frequently Asked Questions about firefly-architect

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

FAQPage Schema
How do I choose the right architecture pattern for my microservices?

To choose the right architecture pattern, you should evaluate service goals and constraints to decide between patterns like CQRS, Saga, Event Sourcing, or EDA. This Skill provides concrete rationale and module layouts to help you select the optimal pattern for your specific microservices.

What is the best way to structure a new Firefly Framework service?

The best way to structure a new Firefly Framework service is to determine its optimal tier, such as Core, Domain, Experience, Application, or Data. This Skill outputs actionable designs with module layouts and configuration guidance tailored to your service goals.

When do I need the Saga pattern in microservices architecture?

You need the Saga pattern in microservices architecture when managing distributed transactions across multiple services. This Skill helps you determine if Saga is appropriate by analyzing your service goals and providing concrete rationale for its application alongside other patterns like EDA.

Can I use CQRS with Event Sourcing in an existing Firefly service?

Yes, you can apply CQRS with Event Sourcing to existing Firefly services. This Skill evaluates your current service architecture and delivers concrete recommendations on integrating these patterns with specific Firefly modules and configuration adjustments.

How do I decide between Core, Domain, and Experience tiers for my service?

To decide between Core, Domain, Experience, Application, and Data tiers, you must map your service's responsibilities to business capabilities. This Skill provides structured guidance to select the optimal tier and delivers actionable module layouts for your chosen architecture.