aws-samples / aws-samples/sample-autonomous-cloud-coding-agents

docs: ADR-015 — Inter-agent communication patterns

Offen
#185 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
documentation governance
Vorherrschende Sprache
TypeScript
Sterne
143
Forks
46
Ø Merge
3 T. 10 Std.
Gemergte PRs (30 T.)
24

Beschreibung

## Summary

Define the communication protocol between development-time agents operating in different roles (Planner, Implementor, Reviewer per ADR-009).

## Context

- ADR-009 establishes role boundaries but intentionally defers the communication mechanism
- PR #144 review identified this gap (reviewer @scoropeza, confirmed by @scottschreckengaust)
- Current state: single-agent-per-task model with no inter-agent communication

## Scope

- Event-based communication model (asynchronous, not direct messaging)
- Modalities: GitHub issue/PR comments, EventBridge events, TaskEventsTable entries
- Discovery: agents discover work via issue assignment, not peer-to-peer negotiation
- No direct agent-to-agent messaging (avoids coupling and race conditions)

## Dependencies

- ADR-009 (role boundaries — prerequisite, established)
- ADR-003 (governance — issue-based coordination)
- ADR-012 (operational knowledge stack — enforcement layer)

## Acceptance criteria

- [ ] ADR-015 draft with status `proposed`
- [ ] Communication modalities documented with pros/cons
- [ ] Interaction patterns for common multi-agent workflows (plan → implement → review)
- [ ] Amend ADR-009, ADR-003 as needed after ADR-015 is accepted

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

Beginne mit dem Lesen von ADR-009, ADR-003 und ADR-012, um die Rollenabgrenzungen, Governance und Durchsetzungsabhängigkeiten zu verstehen. Erstelle ADR-015 mit dem Status „proposed“, dokumentiere die ereignisbasierten Modalitäten und ihre Abwägungen sowie die Interaktionsmuster von Planung über Implementierung bis zur Überprüfung; prüfe Änderungen an ADR-009 oder ADR-003 erst, nachdem ADR-015 akzeptiert wurde.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
aws, github
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Aktivitätsstatus
Ruhig
Klarheit
Klar beschrieben
Anfängerfreundlichkeit
45/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.