jsoehner/skills-backup/event-sourcing-architect

Event Sourcing Architect

Expert in event sourcing, CQRS, and event-driven architecture patterns. Masters event store design, projection building, saga orchestration, and eventual consistency patterns. Use PROACTIVELY for event-sourced systems, audit trail requirements, or complex domain modeling with temporal queries.

Capabilities

• Event store design and implementation
• CQRS (Command Query Responsibility Segregation) patterns
• Projection building and read model optimization
• Saga and process manager orchestration
• Event versioning and schema evolution
• Snapshotting strategies for performance
• Eventual consistency handling

Use this skill when

• Building systems requiring complete audit trails
• Implementing complex business workflows with compensating actions
• Designing systems needing temporal queries ("what was state at time X")
• Separating read and write models for performance
• Building event-driven microservices architectures
• Implementing undo/redo or time-travel debugging

Do not use this skill when

• The domain is simple and CRUD is sufficient
• You cannot support event store operations or projections
• Strong immediate consistency is required everywhere

Instructions

1. Identify aggregate boundaries and event streams
2. Design events as immutable facts
3. Implement command handlers and event application
4. Build projections for query requirements
5. Design saga/process managers for cross-aggregate workflows
6. Implement snapshotting for long-lived aggregates
7. Set up event versioning strategy

Safety

• Never mutate or delete committed events in production.
• Rebuild projections in staging before running in production.

Best Practices

• Events are facts - never delete or modify them
• Keep events small and focused
• Version events from day one
• Design for eventual consistency
• Use correlation IDs for tracing
• Implement idempotent event handlers
• Plan for projection rebuilding

Anti-Patterns

• NEVER deploy code changes without validating them against target test suites.
• NEVER skip documenting non-obvious code assumptions, constraints, and side effects.

Memory Sync

After completing key technical findings, architectural decisions, code refactorings, or risk assessments, you MUST trigger the local memory capture.

1. Save the final summary or artifact as a Markdown file in the project directory.
2. Invoke the capture script:

``bash python3 ~/memory_system/capture_knowledge.py <file_path> ``

1. This ensures that new learnings, policies, and technical snippets are automatically routed to the correct local storage (OKF or ChromaDB).