/Team-API-template

A template for defining a Team API - as explained in the Team Topologies book

Creative Commons Attribution Share Alike 4.0 InternationalCC-BY-SA-4.0

Team API template

A template for defining a Team API. A Team API is a description and specification that a team can define that tells others how to interact with that team.

Based on some of the ideas in the book Team Topologies by Matthew Skelton @matthewskelton and Manuel Pais @manupaisable. See pages 47-49 of the book Team Topologies.

See teamtopologies.com for more details about Team Topologies.

Copyright © 2018-2020 Team Topologies - Licenced under CC BY-SA 4.0 CC BY-SA 4.0

Overview

It can be useful to define a "Team API" for each team, to improve the team's clarity of purpose and help other groups understand how that team fits into the broader organization. Use this template to help teams think about how they would define their Team API.

How to use

Each team should answer the questions and fill in the details below. Remember that the answers and details will be a point-in-time snapshot of team relationships and team interactions.

Team API

Date:

  • Team name and focus:
  • Team type:
  • Part of a Platform? (y/n) Details:
  • Do we provide a service to other teams? (y/n) Details:
  • What kind of Service Level Expectations do other teams have of us?
  • Software owned and evolved by this team:
  • Versioning approaches:
  • Wiki search terms:
  • Chat tool channels: #_____________ #_____________ #_____________
  • Time of daily sync meeting:

Team type: (Stream-Aligned, Enabling, Complicated Subsystem, Platform)

What we're currently working on

  • Our services and systems:
  • Ways of working:
  • Wider cross-team or organisational improvements:

Teams we currently interact with

Team name/focus Interaction Mode Purpose Duration
.
.
.
.
.
.

Team Interaction Modes: (Collaboration, X-as-a-Service, Facilitating)

Teams we expect to interact with soon

Team name/focus Interaction Mode Purpose Duration
.
.
.
.
.
.