team-topology-design

Design team structures using Team Topologies to reduce cognitive load.

1|Updated Nov 29, 2025
One-click install
npx skills add https://github.com/SSiertsema/claude-code-plugins --skill team-topology-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: team-topology-design
Source: https://github.com/SSiertsema/claude-code-plugins/tree/main/team-topology-design/skills/team-topology-design
Command: npx skills add https://github.com/SSiertsema/claude-code-plugins --skill team-topology-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Team Topologies provides a framework to design team structures and interactions that reduce cognitive load, align delivery with the flow of change, and limit handoffs across product domains.

Core Features & Use Cases

  • Four team types (stream-aligned, platform, enabling, complicated-subsystem) and three interaction modes (collaboration, X-as-a-Service, facilitating) guide organizational design.
  • Cognitive-load-aware boundaries and alignment with Conway's law, with guidance on Reverse-Conway where needed.
  • Phase-driven guidance from setup through Team API and scaling patterns.

Quick Start

Provide your organization's domains and current teams to generate an initial Team Topology map and recommended team types.

Frequently Asked Questions about team-topology-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design team structures to reduce cognitive load and improve delivery flow?

Design team structures using Team Topologies to reduce cognitive load and improve flow by mapping your organization's domains and current teams to stream-aligned, platform, enabling, and complicated-subsystem team types. This framework aligns delivery with the flow of change and limits handoffs across product domains.

What are the four team types in Team Topologies and when should I apply them?

The four team types in Team Topologies are stream-aligned, platform, enabling, and complicated-subsystem teams. Apply these team types across your current teams, domains, and pain points to establish cognitive-load-aware boundaries and align delivery with the flow of change.

How do I generate a Team Topology map for my organization's current teams and domains?

To generate a Team Topology map, provide your organization's domains and current teams as input. The Skill outputs an initial topology map specifying requirements for team types, interaction modes, cognitive-load assessment, bounded contexts, and Team API.

What interaction modes does Team Topologies use for team communication?

Team Topologies uses three interaction modes: collaboration, X-as-a-Service, and facilitating. These modes guide organizational design by defining how stream-aligned, platform, enabling, and complicated-subsystem teams interact to optimize flow and reduce handoffs.

Can I use Team Topologies to address Conway's law and bounded context boundaries?

Yes, Team Topologies applies cognitive-load-aware boundaries and alignment with Conway's law, including guidance on Reverse-Conway maneuvers where needed. It specifies requirements for bounded contexts and Team API to mitigate anti-patterns and track health metrics.

What do I need to provide to start mapping team types and interaction modes?

You need to provide your organization's current teams and domains to generate an initial Team Topology map. The Skill then outputs recommended team types, interaction modes, cognitive-load assessments, bounded contexts, and health metrics based on your specific pain points.