Skip to content

docs: vendor event-sourcing and Go architecture patterns; add engineering conventions - #3

Merged
malpou merged 1 commit into
mainfrom
docs/engineering-patterns
Sep 27, 2026
Merged

malpou merged 1 commit into
mainfrom
docs/engineering-patterns

Conversation

@malpou

@malpou malpou commented Sep 27, 2026

Copy link
Copy Markdown
Contributor

Replaces #2 (closed when its base branch was deleted on merging #1).

  • docs/patterns/event-sourcing.md: the pattern only (six mechanisms, read path, catalog, memory bus, anti-patterns), vendored from an internal write-up with its migration plan and internal references removed, plus a note that omap-stack is Postgres only (the JetStream-specific parts do not apply). It is input, not a decision: which state is event-sourced is decided on the wayfinder map (ENG-322).
  • docs/patterns/go-architecture-guidelines.md: a synthesis of Three Dots Labs guidance, with a neutral header.
  • AGENTS.md: engineering conventions (in-tree Adapters picked from yaml, schema first, event-sourced by default per aggregate, Postgres as the only broker, testcontainers integration tests throughout).

@malpou
malpou merged commit acf58c0 into main Sep 27, 2026
3 checks passed
@malpou
malpou deleted the docs/engineering-patterns branch September 27, 2026 08:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant