Skip to content

docs(decision-records): add lifecycle agents decision record#143

Merged
paullatzelsperger merged 1 commit into
mainfrom
docs/decision_record_lifecycle_agents
Jun 26, 2026
Merged

docs(decision-records): add lifecycle agents decision record#143
paullatzelsperger merged 1 commit into
mainfrom
docs/decision_record_lifecycle_agents

Conversation

@paullatzelsperger

Copy link
Copy Markdown
Contributor

Summary

Adds a decision record documenting the introduction of lifecycle agents — standalone services that react to domain lifecycle events delivered as CloudEvents over NATS JetStream, distinct from the existing orchestration agents.

The DR covers:

  • Decision — a reusable common/lifecycleagent framework and a separate agent/lifecycle organization.
  • Rationale — decoupling event producers from consumers, keeping the orchestration model focused, and using CloudEvents instead of an ad-hoc envelope.
  • Approach — CloudEvents v1.0 envelopes, JetStream InterestPolicy for fan-out, explicit subjects (fail-fast when none configured), and naming/layout conventions.

Also adds the entry to the decision records index.

🤖 Generated with Claude Code

Document the decision to introduce lifecycle agents that react to domain
lifecycle events delivered as CloudEvents over NATS, separate from the
orchestration agents.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@paullatzelsperger paullatzelsperger merged commit 9aa9eb4 into main Jun 26, 2026
3 checks passed
@paullatzelsperger paullatzelsperger deleted the docs/decision_record_lifecycle_agents branch June 26, 2026 12:20
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.

2 participants