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

docs: ADR-015 — Inter-agent communication patterns

Aperta
#185 1 commento 0 reazioni 0 assegnatari Vedi su GitHub
documentation governance
Lingua principale
TypeScript
Stelle
143
Fork
46
Merge medio
3g 10h
PR unite (30g)
24

Descrizione

## 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

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Inizia leggendo ADR-009, ADR-003 e ADR-012 per comprendere i confini dei ruoli, la governance e le dipendenze dall’applicazione. Redigi ADR-015 con lo stato proposto, documentando le modalità basate sugli eventi e i relativi compromessi, oltre ai pattern di interazione dalla pianificazione all’implementazione fino alla revisione; valuta eventuali modifiche ad ADR-009 o ADR-003 solo dopo l’accettazione di ADR-015.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
aws, github
Ambito
documentation
Tipo di issue
Documentazione
Difficoltà
5/5
Tempo stimato
Più di una settimana
Stato di attività
Tranquilla
Chiarezza
Specificata chiaramente
Idoneità per principianti
45/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.