principle-event-driven

principle-event-driven is a skill for Claude Code from lugassawan/swe-workbench. It costs 84 tokens per session (1,333 once invoked), scanned A, original, MIT.

A guide to software built around events: recorded facts that other parts of the system handle later. It covers event sourcing, CQRS, workflows, message consumers, and changes to event formats.

In plain words
What is it for?
Use it when designing event-based services, rebuilding state from history, separating reads from writes, coordinating long workflows, or safely processing messages again.
Why use it?
Asynchronous systems can handle work independently, but they introduce delays, retries, replaying, and more ways for failures to spread.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the swe-workbench plugin — 60 skills, 25 commands, 22 agents, 4 hooks shipped together

Good fit Use it when designing event-based services, rebuilding state from history, separating reads…

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/lugassawan/swe-workbench/principle-event-driven
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add lugassawan/swe-workbench --skill principle-event-driven
Clone the repo
git clone --depth 1 https://github.com/lugassawan/swe-workbench

Made for: Claude Code.

Or install swe-workbench, the plugin that ships this one along with the rest of its 60 skills, 25 commands, 22 agents, 4 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for principle-event-driven

README.md
[![agentmods](https://agentmods.dev/badge/skills/lugassawan/swe-workbench/principle-event-driven.svg)](https://agentmods.dev/skills/lugassawan/swe-workbench/principle-event-driven)
Your own site
<a href="https://agentmods.dev/skills/lugassawan/swe-workbench/principle-event-driven"><img src="https://agentmods.dev/badge/skills/lugassawan/swe-workbench/principle-event-driven.svg" alt="Measured on agentmods" height="20"></a>
Per session 84 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,333 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00084 $0.01333
Opus 5 $0.00042 $0.00666
Sonnet 5 $0.00017 $0.00267
Haiku 4.5 $0.00008 $0.00133

Measured 3d ago against content hash 78a47840f771, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

principle-event-driven scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/principle-event-driven/SKILL.md · 93 lines

How it starts

The opening of the file, as written. The whole thing — 93 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Event-Driven Architecture

The log is the source of truth: producers emit immutable events; consumers react asynchronously. This decouples services at deployment and operational boundaries and lets new consumers replay history — at the cost of eventual consistency and significantly more failure surface area than synchronous calls.

Event Sourcing

Store every state change as an immutable event; derive current state by replaying the log. The aggregate's current state is a projection, not the record of truth.

  • Snapshots cap replay cost: persist a projected state checkpoint every N events and replay only from the latest snapshot.
  • Projections are disposable — design them to be rebuilt by replaying; avoid hand-rolled caches that drift from the log.
  • Event store must be append-only; mutating or deleting events destroys the audit trail and breaks replaying consumers.
  • GDPR erasure: store PII in a side-table and tombstone the key rather than mutating event history.

CQRS (Command Query Responsibility Segregation)

Separate the write model (commands that mutate state) from the read model (queries over projections). Often paired with event sourcing but independent of it.

  • Read replicas can be denormalized and tuned for specific query shapes without polluting the write model.
  • Consistency lag between write and read models is a feature contract, not a bug — document the SLA.
  • Avoid CQRS in simple CRUD services; indirection cost exceeds benefit until query and write shapes diverge significantly.

Sagas — Choreography vs Orchestration

Long-running transactions spanning services must be modeled as sagas with explicit compensation steps.

Choreography — each service emits events and reacts to others; no central coordinator.

  • Low coupling; hard to trace and debug as the workflow grows beyond two or three participants.

Orchestration — a central saga orchestrator drives the workflow and issues commands to participants.

  • Easier observability and rollback reasoning; introduces a single point of coordination and coupling.
  • Prefer orchestration when compensation logic is non-trivial or the workflow has more than three participants.

Read the full file on GitHub · 93 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 93 lines · 84 tokens per session scan A 78a47840f771

Subscribe to this mod's changes

principle-event-driven is a skill published in the GitHub repository lugassawan/swe-workbench (2 stars, last pushed yesterday), licensed MIT. It adds 84 tokens to every session and 1,333 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

code-forge

Generate implementation code from an approved design blueprint or verbal requirements. Composes context anchoring, architecture, clean code, DDD, security, and test quality into an inside-out implementation workflow. Use when moving from design to code, implementing approved contracts, or when the user says…

techygarg/lattice · 81 tokens

slack-block-kit

Proactively apply when generating Slack API payloads with blocks, chat.postMessage calls with structured content, streaming AI responses, or views.open/views.publish calls. Triggers on Block Kit, Slack blocks, section block, actions block, header block, context block, alert block, card block, carousel block, container…

ccheney/robust-skills · 212 tokens

clean-ddd-hexagonal

Proactively apply when designing APIs, microservices, or scalable backend structure. Triggers on DDD, Clean Architecture, Hexagonal, ports and adapters, entities, value objects, domain events, CQRS, event sourcing, repository pattern, use cases, onion architecture, outbox pattern, aggregate root, anti-corruption…

ccheney/robust-skills · 120 tokens

postgres-drizzle

Proactively apply when creating APIs, backends, or data models. Triggers on PostgreSQL, Postgres, Drizzle, drizzle-orm, drizzle-kit, database, schema, pgTable, tables, columns, indexes, queries, migrations, ORM, relations, relational queries, joins, transactions, SQL, connection pooling, PgBouncer, N+1, JSONB, RLS…

ccheney/robust-skills · 119 tokens

functions-development

Build serverless Go or Python functions for Falcon Foundry apps. TRIGGER when user asks to "create a function", "write a serverless function", "build backend logic", runs foundry functions create, or needs help with FDK handler patterns, function testing, or collection integration from functions. Also TRIGGER when…

CrowdStrike/foundry-skills · 195 tokens

go-expert

Use when writing or reviewing Go backend services - go.mod, .go files, net/http handlers, pgx/sqlc database code, goroutines, context.Context plumbing, or failing go test runs. Builds HTTP APIs on the Go 1.22+ stdlib router, fixes error-wrapping and context-cancellation bugs, designs leak-free goroutine lifecycles…

Aarvion-AI/stackwise-skills · 117 tokens