---

name: meta__cheat_sheet description: 'Quick reference for BookStore code rules and patterns. Use this when you need a fast lookup of conventions for IDs (Guid.CreateVersion7), timestamps (DateTimeOffset.UtcNow), event naming, logging (LoggerMessage), caching, or multi-tenancy. DO NOT USE FOR: step-by-step workflows — use the relevant scaffold skill instead.'

BookStore Cheat Sheet

IDs & Timestamps

var id = Guid.CreateVersion7();           // ✅ UUIDv7
var now = DateTimeOffset.UtcNow;          // ✅ UTC timestamp

Event (past tense, record)

public record BookAdded(Guid Id, string Title, decimal Price);

Command (record)

public record AddBookCommand(string Title, decimal Price);

Aggregate Apply Method

public void Apply(BookAdded @event)
{
    Id = @event.Id;
    Title = @event.Title;
}

Handler (static, Wolverine)

public static class AddBookHandler
{
    public static BookAdded Handle(AddBookCommand cmd) =>
        new(Guid.CreateVersion7(), cmd.Title, cmd.Price);
}

HybridCache Query

var result = await cache.GetOrCreateAsync(
    $"books:{culture}",
    async ct => await session.Query<BookProjection>().ToListAsync(ct),
    tags: [CacheTags.BookList],
    cancellationToken: ct);

Cache Invalidation

await cache.RemoveByTagAsync(CacheTags.BookList, ct);

SSE Notification

public record BookUpdatedNotification(Guid Id) : IDomainEventNotification;

TUnit Test

[Test]
public async Task Should_Create_Book()
{
    var result = await client.CreateBookAsync(request);
    await Assert.That(result.Id).IsNotNull();
}

Namespace

namespace BookStore.ApiService.Handlers;  // ✅ File-scoped

Related Skills

• /wolverine__guide - All Wolverine write operations (create, update, delete)
• /marten__guide - Aggregates, projections, and query endpoints