understanding-mfe-architecture

name	understanding-mfe-architecture
description	Provides micro-frontend architecture vocabulary, principles, and decisions framework grounded in Building Micro-Frontends (O'Reilly). Use when a user asks "should we use micro-frontends?", "how do I split my frontend into MFEs?", "what is a micro-frontend?", "help me define MFE boundaries", "should I use horizontal or vertical split?", "how do micro-frontends communicate?", or "is my architecture a distributed monolith?". Requires independent deployment or multi-team scaling as the explicit context. Does not activate for single-team frontend architecture, component design, or build tooling questions with no cross-team deployment angle.
license	MIT — Copyright (c) Luca Mezzalira
compatibility	Works in Claude.ai, Claude Code, and any Claude API environment. No external tools or MCP servers required. Designed for software architects, tech leads, and senior frontend engineers working on multi-team frontend systems.
metadata	{"author":"luca-mezzalira","version":"1.0","category":"architecture","tags":["micro-frontends","architecture","frontend","module-federation","angular","react","domain-driven-design"]}

Micro-frontend core concepts

Canonical vocabulary, principles, and decisions framework for micro-frontend architecture, as defined in Building Micro-Frontends (O'Reilly) and the Micro-Frontend Canvas (buildingmicrofrontends.com).

Task routing

Identify the task type first, then load the appropriate reference file. Do not load all files at once.

Task	Load	First action
Should we use MFEs?	references/boundary-design.md	Apply the organisational readiness gate before any implementation advice
Defining or reviewing boundaries	references/boundary-design.md	Ask about team ownership before discussing technology
Reviewing boundary validity or architecture for principle violations	references/rules.md → or load reviewing-mfe-boundaries skill for code-level detail	Run the boundary health check for validity; scan against the eight rules for violations
Choosing composition, routing, or communication	references/decisions-framework.md	Confirm split strategy (vertical vs horizontal) before composition; shell owns first URL segment, MFE owns sub-routes
Micro-Frontend Canvas facilitation	Install micro-frontend-canvas skill (see references/canvas-pointer.md)	Confirm domain is identified; do not facilitate Canvas from this skill
Generating or reviewing MFE code	Load reviewing-mfe-boundaries skill	This skill handles code-level boundary enforcement

If the user's terminology differs from the canonical definitions in the reference files, map it once to the canonical term, then continue using theirs.

Do not revert to generic frontend advice once this skill is active. Micro-frontend principles apply at the boundary between independently deployed units — not within a single unit.

When not to activate

Stand down if the question is purely about component composition, state management within a single deployed unit, or build tooling with no independent-deployment or team-scaling angle.

---

Examples

Example 1 — adoption decision User says: "We have three teams and our React monorepo is becoming a bottleneck. Should we migrate to micro-frontends?" Expected: Apply the organisational readiness gate. Ask about release independence before recommending. Load references/boundary-design.md.

Example 2 — boundary design User says: "We've just done event storming and identified checkout, catalog, and account as bounded contexts. How should we split our frontend?" Expected: Load references/boundary-design.md. Ask which team owns each context before proposing a split. Point to the micro-frontend-canvas skill for a Canvas session per MFE.

Example 3 — communication pattern User says: "We have two MFEs on the same page. When a user adds to cart in the catalog MFE, the basket MFE needs to update. How?" Expected: Load references/decisions-framework.md. Recommend event emitter. Explicitly rule out shared state managers.

Example 4 — architecture review User says: "Is our current setup a distributed monolith?" Expected: Load references/rules.md. Run the boundary health check. Ask for team and deployment context.