team-design

Team Design Plugin

Team structure and organization design using Team Topologies and related methodologies.

Skills

Skill	Purpose
team-topologies	Four fundamental team types and interaction modes
cognitive-load-assessment	Measure and manage team cognitive load
inverse-conway	Align architecture and team structure
team-api-design	Define team interfaces and contracts
interaction-patterns	Team interaction modes and evolution

Agents

Agent	Purpose
team-architect	Design team structures aligned with architecture
team-health-assessor	Evaluate team effectiveness and cognitive load

User-Invocable Skills

Skill	Purpose
/team-structure	Design team topology for an organization
/cognitive-load	Assess and optimize team cognitive load

Installation

/plugin install team-design@claude-code-plugins

Usage Examples

Design Team Structure

/team-structure "e-commerce platform"
/team-structure "data platform" teams=5

Assess Cognitive Load

/cognitive-load "payments team"
/cognitive-load depth=detailed

Team Topology Analysis

Invoke the team-architect agent to:
- Map current team structure
- Identify team type mismatches
- Plan team evolution
- Design interaction patterns

Methodologies Covered

Team Topologies (Skelton & Pais)

Four fundamental team types:

• Stream-aligned: Aligned to flow of work, end-to-end ownership
• Platform: Provide self-service internal products
• Enabling: Help teams overcome obstacles
• Complicated-subsystem: Handle complex technical domains

Cognitive Load Management

Based on cognitive load theory:

• Intrinsic: Inherent complexity of the domain
• Extraneous: Unnecessary complexity
• Germane: Learning new skills

Inverse Conway Maneuver

Deliberately evolve team structure to achieve desired architecture:

• Architecture follows communication
• Change teams to change architecture
• Bounded contexts to team boundaries

Team Interaction Modes

Three core interaction modes:

• Collaboration: Working together closely
• X-as-a-Service: Consuming via API
• Facilitating: Helping other teams improve

Related Plugins

• enterprise-architecture - Architecture and bounded contexts
• systems-design - Platform engineering and architecture
• business-analysis - Capability mapping

References

Based on "Team Topologies" by Matthew Skelton and Manuel Pais.