Skip to content

docs: add Mediated Semantic Alignment reference pattern - #706

Open
codyhartsook wants to merge 1 commit into
mainfrom
docs/mediated-semantic-alignment
Open

docs: add Mediated Semantic Alignment reference pattern#706
codyhartsook wants to merge 1 commit into
mainfrom
docs/mediated-semantic-alignment

Conversation

@codyhartsook

Copy link
Copy Markdown
Contributor

Part of #701. Closes #705.

New reference doc mediated_semantic_alignment.md, same schema as the other patterns under docs/workflows/.

Covers the caller-mediated alignment loop: a Semantic Alignment Agent (SAO) builds a shared agenda of issues/options and scores each round, while an orchestrator drives the start -> decide loop and bridges the engine to the participants over A2A. The engine never calls the agents; roles alternate proposer/responder each round.

Notes:

  • Generic role-based names in the diagram (matches the reference-library docs); Scenario uses the Brazil/Colombia coffee-price vignette.
  • Includes a real ## Workflow section since this pattern has a concrete layout.
  • Still needs a "Mediated Semantic Alignment" catalog entry in starting_workflows.json to be reachable via the API/frontend - tracked separately per Docs: add Mediated Semantic Alignment reference pattern #705.

@codyhartsook
codyhartsook requested a review from a team as a code owner July 21, 2026 04:10

@delthazor delthazor left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@pregnor pregnor left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

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.

Docs: add Mediated Semantic Alignment reference pattern

3 participants