Markdown Editor

Team Interaction Map Template (Team Topologies)

Team types, interaction modes, cognitive load, as-is and target team diagrams, findings and a dated evolution plan

आर्किटेक्चरमानकTeam Topologies, 2nd edition (2025), names onlyteaminteractionmapdiagram
एडिटर में खोलें.md डाउनलोड करें

उपयोग कैसे करें: Use it to see how the teams in one product area work together and how that should change. Fill the team register with self-assessed cognitive load first, then the interaction register as teams actually work today. The main pitfall is collaboration with no end date.

प्रीव्यू

Team Interaction Map: [Organisation unit or product area]

Map of the teams in one product area: the type of each team, the mode of each interaction between teams, how much cognitive load each team carries, and how the interactions are planned to change over time. Team type and interaction mode names follow Team Topologies by Matthew Skelton and Manuel Pais (2nd edition, IT Revolution, 2025). Replace every [bracketed] value and every row marked Example. Worked examples use the invented online grocery retailer from the Context Map template (architecture/context-map).

FieldValue
Area[Online grocery: basket to doorstep]
Map type[As-is / To-be / Both]
Version[0.1]
Status[Draft / Agreed / Superseded]
Owner[@head-of-engineering]
Contributors[@team-leads], [@domain-architect]
Last updatedYYYY-MM-DD
Next reviewYYYY-MM-DD
Related documentsContext Map (architecture/context-map), Core Domain Chart (architecture/core-domain-chart), Team APIs (architecture/team-api)

1. Purpose and scope

[Purpose statement. Example: The map covers the seven teams that build and run the path from basket to doorstep. It supports two decisions: how to staff the replacement of the legacy order management system, and whether the routing work needs its own team.]

2. Vocabulary

TermKindMeaning in this map
Stream-aligned teamTeam typeOwns a flow of work for a product, service or user journey from idea to production
Platform teamTeam typeProvides internal services that stream-aligned teams consume to move faster
Enabling teamTeam typeSpecialists who help other teams gain a capability, then step back
Complicated subsystem teamTeam typeOwns a part that needs deep specialist knowledge most teams do not have
CollaborationInteraction modeTwo teams work closely together for a defined period to discover something new
X-as-a-ServiceInteraction modeOne team consumes what another provides, with little need for close contact
FacilitatingInteraction modeOne team coaches or helps another to remove an obstacle or learn a practice

3. Team register

IDTeamTypeBounded contexts or services ownedSizeCognitive load (1-5)Main load driver
T-01Example: Team CheckoutStream-alignedBasket and Checkout73Many upstream dependencies
T-02Example: Team SlotsStream-alignedSlot Booking63Capacity rules change every season
T-03Example: Team FulfilmentStream-alignedFulfilment85Owns picking and van routing logic and the legacy export adapter
T-04Example: Team RangeStream-alignedCatalogue52Stable domain
T-05Example: Team PaymentsComplicated subsystemPayments43Provider integration and refund rules
T-06Example: Team PlatformPlatformDelivery platform, legacy OMS64Platform product plus legacy OMS support
T-07Example: SRE EnablementEnablingNone (coaching)32Coaching spread across several product areas
[T-NN][Team][Type][Contexts][People][1-5][Driver]

4. Interaction register (as-is)

IDTeam ATeam BModeDirectionPurposeStartedPlanned end
TI-01Example: Team CheckoutTeam SlotsCollaborationBoth waysDesign premium slot pricing in checkoutYYYY-MM-DDYYYY-MM-DD
TI-02Example: Team PlatformTeam CheckoutX-as-a-ServicePlatform providesDeployment pipeline and runtimeYYYY-MM-DDOngoing
TI-03Example: Team PlatformTeam FulfilmentX-as-a-ServicePlatform providesRuntime and nightly OMS exportYYYY-MM-DDOngoing
TI-04Example: Team PaymentsTeam CheckoutX-as-a-ServicePayments providesAuthorisation and refunds APIYYYY-MM-DDOngoing
TI-05Example: SRE EnablementTeam FulfilmentFacilitatingEnablement helpsIntroduce service level objectives and on-callYYYY-MM-DDYYYY-MM-DD
TI-06Example: Team FulfilmentTeam CheckoutCollaborationBoth waysShared substitution rules libraryYYYY-MM-DDNone set
[TI-NN][Team][Team][Mode][Direction][Purpose]YYYY-MM-DDYYYY-MM-DD

5. Interaction diagram (as-is)

Team Range (T-04) has no interaction in this map: it publishes the catalogue API that other teams consume without team-level contact, which is recorded in the context map instead.

6. Findings

IDFindingEvidenceRisk
TF-01Example: Team Fulfilment is overloadedT-03 load 5; owns picking, routing and the OMS adapterSlower delivery on a core context; burnout
TF-02Example: Collaboration on substitution rules has no end dateTI-06Shared library becomes a permanent coupling
TF-03Example: Team Platform runs a product and a legacy systemT-06Platform roadmap slips whenever OMS has an incident
[TF-NN][Finding][Rows][Risk]

7. Planned evolution

IDChangeFromToTrigger or exit criterionOwnerTarget date
EVO-01Example: Create Team Routing to own van route optimisationPart of T-03New complicated subsystem teamTwo routing specialists hired@head-of-engineeringYYYY-MM-DD
EVO-02Example: End substitution rules collaborationTI-06 CollaborationFulfilment provides rules X-as-a-ServiceRules API v1 published, shared library retired@fulfilment-leadYYYY-MM-DD
EVO-03Example: End SRE facilitation for FulfilmentTI-05 FacilitatingNo interactionTeam runs its own on-call for two months without escalation@sre-leadYYYY-MM-DD
EVO-04Example: Move legacy OMS to a time-boxed migration squadT-06 owns OMSSquad inside Team Platform until OMS retiredFunding for OMS replacement approved@platform-leadYYYY-MM-DD
[EVO-NN][Change][Current][Target][Criterion][@owner]YYYY-MM-DD

The target map after EVO-01 to EVO-03 is shown below. Team Range and SRE Enablement are left out because neither has an interaction in this area once EVO-03 is complete; EVO-04 changes ownership inside Team Platform and does not add an interaction.

8. Review log

DateReviewed byChanges madeNext review
YYYY-MM-DDExample: @head-of-engineering with team leadsEVO-03 completed; load of T-03 down from 5 to 4YYYY-MM-DD
YYYY-MM-DD[Names][Changes]YYYY-MM-DD

References

  • Matthew Skelton and Manuel Pais, Team Topologies: Organizing Business and Technology for Fast Flow of Value, 2nd edition, IT Revolution, 23 September 2025 (first edition 2019). Book details: https://itrevolution.com/book/team-topologies/ ; key concepts summary: https://teamtopologies.com/key-concepts (both checked 2026-10-30).
  • Related templates: Team API (architecture/team-api), Context Map (architecture/context-map), Core Domain Chart (architecture/core-domain-chart), Internal Developer Platform Charter (architecture/internal-developer-platform-charter).

Standard and licence note

Team type and interaction mode names are taken from Team Topologies by Matthew Skelton and Manuel Pais (2nd edition, IT Revolution, 2025). The book is a commercial publication: this template uses its terms by name only, with one-line explanations written for this collection, and reproduces no text, figures or shapes from it. Obtain the book for the full method. Team Topologies is a trademark of its owners. All tables, examples and guidance are original. Template licence: MIT.

संबंधित टेम्पलेट