Skip to content

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

Closed
malpou wants to merge 1 commit into
chore/agent-skills-setupfrom
docs/engineering-patterns
Closed

malpou wants to merge 1 commit into
chore/agent-skills-setupfrom
docs/engineering-patterns

Conversation

@malpou

@malpou malpou commented Sep 27, 2026

Copy link
Copy Markdown
Contributor

Stacked on #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 deleted the branch chore/agent-skills-setup September 27, 2026 08:05
@malpou malpou closed this Sep 27, 2026
malpou added a commit that referenced this pull request Sep 27, 2026
…ring conventions (#3)

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).
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