apex-team-topology-design

Generate target Team Topologies designs with team classifications, interaction modes, and Mermaid diagrams.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/JaviMontano/metodologia-propuesta-agent-public --skill apex-team-topology-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apex-team-topology-design
Source: https://github.com/JaviMontano/metodologia-propuesta-agent-public/tree/main/.claude/skills/team/team-topology-design
Command: npx skills add https://github.com/JaviMontano/metodologia-propuesta-agent-public --skill apex-team-topology-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Team topology design helps organizations structure teams to align with product value streams and architecture, reducing cognitive load and coordination overhead.

Core Features & Use Cases

  • Classify teams into Stream-aligned, Platform, Enabling, and Complicated-subsystem to reflect your architecture.
  • Design interaction modes (Collaboration, X-as-a-Service, Facilitating) and evolve them over time.
  • Generate a topology map (Mermaid) plus a transition roadmap with milestones and metrics.

Quick Start

Provide your current org structure and architecture context to generate the target topology design.

Frequently Asked Questions about apex-team-topology-design

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

FAQPage Schema
How do I design a team topology that aligns with my software architecture?

Design a team topology by mapping your current organization structure and architecture context to value streams, then classifying teams into Stream-aligned, Platform, Enabling, or Complicated-subsystem types to reduce cognitive load and coordination overhead.

What is Conway's Law and how does it affect team structure?

Conway's Law dictates that an organization's communication structures mirror its software architecture. Addressing it through team topology design aligns your team boundaries with intended product value streams to ensure fast flow.

How do I map team interaction modes to optimize fast flow?

Map team interaction modes by assigning Collaboration, X-as-a-Service, or Facilitating relationships between teams. Evolving these interaction modes over time aligns your organization structure with your architecture for optimized fast flow.

When do I need a platform team in my organization?

You need a platform team when stream-aligned teams experience high cognitive load from managing underlying infrastructure. Platform teams reduce this coordination overhead by providing internal services as a product.

Can I generate a visual diagram of my target team topology?

Yes, you can generate a visual topology map by providing your current org structure. The design produces a Mermaid topology diagram detailing team classifications, interaction modes, and cognitive load boundaries.

How do I transition my current teams to a new team topology model?

Transition your teams by following an actionable transition plan with defined milestones, metrics, and risk indicators. This roadmap guides the implementation from your current org structure to the target topology design.