jargon

Architecture & practice·topic 6 of 10

Teams, ownership and Conway's law

The architecture and the org chart are the same drawing. Once you can name the shapes teams come in and what each one is for, half of the arguments that looked technical turn out to be arguments about who owns what.

Read in order · tick what you already know

  1. 01

    the system has four services and the company has four teams, and nobody planned that.

    Conway's law

  2. 02

    they wanted the architecture split three ways, so they reorganised the teams first and waited.

    Inverse Conway manoeuvre

  3. 03

    one team owns a slice of the product end to end and does not hand anything to another team to finish.

    Stream-aligned team

  4. 04

    another team's product is your deploy pipeline, and you are their customer rather than their ticket queue.

    Platform team

  5. 05

    two specialists sat with your team for six weeks, taught you the testing approach, and then left.

    Enabling team

  6. 06

    the pricing engine needs actual mathematicians, so it has its own team rather than living in everyone's backlog.

    Complicated-subsystem team

  7. 07

    you consumed their API and never spoke to them, which was the point.

    X-as-a-service

  8. 08

    the team owns nine services and can explain four of them.

    Cognitive load

  9. 09

    you opened a pull request against another team's repository and it sat there for eleven days.

    Code ownership

  10. 10

    the alert fired and it took forty minutes to establish which team was supposed to answer it.

    Orphaned service

  11. 11

    the team that wrote the code carried the pager for it, and the retry logic got better within a month.

    You build it, you run it

  12. 12

    one person is responsible for answering at 3am this week, and next week it is you.

    On-call rotation

  13. 13

    there was a supported way to spin up a new service, and doing it that way took an afternoon instead of a fortnight.

    Golden path

  14. 14

    you deployed to a new environment without opening a ticket or learning what the infrastructure was.

    Internal developer platform

  15. 15

    one person was on holiday and the release could not go out until they got back.

    Bus factor

  16. 16

    the database changes all go through one team, and their queue is nine weeks long.

    Silo

  17. 17

    the same engineer saves every launch weekend and gets praised for it, and nothing about the launches changes.

    Hero culture