#Laravel Spatie Event Sourcing — Claude Code Skill

#Compatibility

A Claude Code skill that helps you design and generate event-sourced domain code for Laravel using spatie/laravel-event-sourcing.

#What it does

This skill guides you through a two-gate workflow:

1. Gate 1 — Design: Claude asks focused domain questions, then produces an Architecture Decision Record (ADR) covering aggregates, commands, events, projectors, and reactors. You review and approve before any code is written.

2. Gate 2 — Implementation: Once the ADR is approved, Claude generates the full domain — tests first (TDD), then commands, handlers, aggregates, events, projectors, reactors, and migrations. It runs the test suite and reports results.

#Installation

#Recommended: one-command plugin install

Inside Claude Code, add the marketplace and install the plugin:

/plugin marketplace add albertoarena/claude-laravel-event-sourcing
/plugin install laravel-spatie-event-sourcing@albertoarena

Claude Code shows a details panel (description, author, version, and what will be installed) and lets you pick a scope — User (all your projects), Project (shared with your team via git), or Local. The skill loads automatically once installed.

#Manual fallback: copy the skill folder

If you'd rather not use the plugin system, copy the skill directory into any skills location and Claude Code picks it up automatically next session:

git clone https://github.com/albertoarena/claude-laravel-event-sourcing.git /tmp/claude-les
cp -r /tmp/claude-les/plugins/laravel-spatie-event-sourcing/skills/laravel-spatie-event-sourcing \
  ~/.claude/skills/                       # global, or .claude/skills/ inside a project
rm -rf /tmp/claude-les

#Manual fallback: .skill package

Download the packaged archive and install it via Claude Code:

curl -LO https://github.com/albertoarena/claude-laravel-event-sourcing/raw/main/laravel-spatie-event-sourcing.skill

Then install it via Claude Code's /install-skill command or place it in ~/.claude/skills/.

#Prerequisites

Your Laravel project needs:

• Laravel 10+ with spatie/laravel-event-sourcing v7 installed
• Published migrations and config (php artisan vendor:publish)
• A test framework (Pest recommended, PHPUnit supported)

The skill checks all of this automatically on first run.

#Quick start

Open Claude Code in your Laravel project and say something like:

"I want to add order management using Spatie event sourcing. Orders can be placed, have line items added, shipped, and cancelled — but not if already shipped."

Claude will walk you through the design, get your approval, then generate all the code with tests.

#What gets generated

app/Domain/<Context>/
├── Aggregates/          — Aggregate roots with invariant enforcement
├── Commands/            — Command DTOs
├── CommandHandlers/     — Handlers that load aggregates and call methods
├── Events/              — Domain events (past-tense, immutable)
├── Projectors/          — Event-to-read-model transformers
├── Reactors/            — Side-effect handlers (emails, API calls)
└── ReadModels/          — Eloquent models for read-side queries

tests/Feature/<Context>/ — Full test suite (aggregate, projector, reactor tests)
database/migrations/     — Read-model table migrations

#Scope

• Greenfield only — This skill generates new event-sourced domains. It does not refactor existing CRUD code into event sourcing.
• Laravel + Spatie ES v7 — Specifically designed for this stack.

#📬 Stay updated

Subscribe and get my free Spatie Event Sourcing cheat sheet (printable PDF), plus practical notes on Laravel and AI-assisted development, roughly once a month. No spam.

Get the cheat sheet →

#License

MIT