CtrlK
BlogDocsLog inGet started
Tessl Logo

apex-spotify-model

Use when the user asks to "implement Spotify model", "design squads and tribes", "organize chapters and guilds", "create autonomous team structure", "apply Spotify engineering culture", or mentions Spotify, squads, tribes, chapters, guilds, autonomous teams, matrix organization, squad health check model.

The canonical home for this skill is apex-spotify-model in JaviMontano/mao-discovery-framework

SKILL.md
Quality
Evals
Security

Spotify Model: Squads, Tribes, Chapters, Guilds

TL;DR: Designs an organizational model inspired by Spotify's approach: autonomous squads aligned to missions, tribes for coordination, chapters for functional excellence, and guilds for cross-cutting knowledge sharing. Emphasizes autonomy with alignment, not prescriptive process.

Principio Rector

El modelo Spotify no es un framework — es un ejemplo de diseño organizacional basado en autonomía con alineación. Cada squad es autónomo en HOW pero alineado en WHAT y WHY. Los chapters aseguran excelencia técnica sin sacrificar autonomía. Los guilds crean comunidades de práctica orgánicas. Copiar la estructura sin los principios es el error más común.

Assumptions & Limits

  • Assumes organization has ≥20 engineers to justify squad/tribe structure [PLAN]
  • Assumes leadership supports autonomous teams (not command-and-control) [STAKEHOLDER]
  • Breaks when organization has strict hierarchical culture that prevents squad autonomy
  • Does not implement day-to-day squad operations; designs the organizational structure
  • Assumes product/service portfolio is sufficiently complex for multi-squad coordination [SUPUESTO]
  • Limited to engineering/product teams; support functions require adapted patterns

Usage

# Full Spotify model design
/pm:spotify-model $ARGUMENTS="--teams 30 --products 5"

# Squad health check framework
/pm:spotify-model --type health-check --squads 8

# Chapter and guild design only
/pm:spotify-model --type chapters-guilds --disciplines "engineering,design,qa,data"

Parameters:

ParameterRequiredDescription
$ARGUMENTSYesTeam count and product portfolio size
--typeNofull (default), health-check, chapters-guilds, transition
--teamsNoTotal number of people
--productsNoNumber of products or services
--disciplinesNoFunctional disciplines for chapter design

Service Type Routing

{TIPO_PROYECTO}: Agile-Transformation for large engineering organizations; Digital-Transformation for product-centric restructuring; PMO-Setup for redefining team topology.

Before Designing

  1. Read current organizational structure to understand team composition [PLAN]
  2. Read product/service portfolio to identify mission candidates for squads [PLAN]
  3. Glob **/team_topology* or **/org_chart* to find existing structure documentation [PLAN]
  4. Grep for coordination pain points in retrospective outputs or team feedback [INFERENCIA]

Entrada (Input Requirements)

  • Current organizational structure
  • Product/service portfolio
  • Team count and skill distribution
  • Desired autonomy level
  • Current pain points in coordination

Proceso (Protocol)

  1. Mission mapping — Define missions that squads will own (aligned to customer value)
  2. Squad design — Create cross-functional squads (6-12 people) with clear missions
  3. Tribe formation — Group related squads into tribes (max ~100 people) with tribe lead
  4. Chapter design — Define functional chapters (engineering, design, QA) with chapter leads
  5. Guild creation — Identify cross-cutting communities of interest
  6. Alignment mechanisms — Design quarterly reviews, OKRs, and strategy alignment cadences
  7. Dependency management — Establish inter-squad coordination protocols
  8. Health check model — Implement squad health check framework
  9. Transition plan — Design migration from current structure to Spotify-inspired model
  10. Evolution protocol — Define how structure evolves based on product and team growth

Edge Cases

  1. Organization too small (<20 engineers) — Spotify model adds overhead without benefit. Recommend simple Scrum teams with lightweight coordination [INFERENCIA].
  2. Chapter leads becoming command-and-control managers — Redesign chapter lead role as coaching/mentoring. Remove approval authority from chapter leads. Chapters serve technical excellence, not management [STAKEHOLDER].
  3. Squad mission overlap creating confusion — Clarify mission boundaries through API contracts between squads. If overlap persists, merge squads or restructure missions [PLAN].
  4. Tribe exceeding 150 people (Dunbar's number) — Split tribe along natural product boundaries. Each resulting tribe must have cohesive mission scope [PLAN].

Example: Good vs Bad

Good example — Principled Spotify design:

AttributeValue
Squads8 squads (6-12 people each) with distinct missions
Tribes2 tribes aligned to product domains
Chapters4 chapters (engineering, design, QA, data)
Guilds3 guilds (DevOps, accessibility, security)
Health checkQuarterly squad health checks with 10 indicators
Transition3-phase rollout over 6 months

Bad example — Copy-paste Spotify: Renamed existing teams as "squads," department heads as "tribe leads," and created empty "guilds" with no activity. Structure renamed without principle adoption. Squads have no autonomy, chapters have no technical authority, guilds exist on paper only.

Salida (Deliverables)

  • 02_spotify_model_{proyecto}_{WIP}.md — Organizational design document
  • Squad-tribe-chapter-guild map (Mermaid)
  • Mission-to-squad alignment matrix
  • Health check template
  • Transition roadmap

Validation Gate

  • Every squad has a distinct mission aligned to customer value [PLAN]
  • Squad sizes within 6-12 people range [METRIC]
  • Tribes sized ≤100 people (≤150 absolute max) [METRIC]
  • ≥3 chapters defined with chapter lead role descriptions [PLAN]
  • Alignment mechanism defined (OKRs, quarterly reviews) [PLAN]
  • Squad health check framework with ≥8 indicators [PLAN]
  • Transition plan with phases and timeline [SCHEDULE]
  • Inter-squad dependency management protocols defined [PLAN]
  • Evidence ratio: ≥75% [PLAN], <25% [SUPUESTO]
  • Design based on Spotify principles (autonomy + alignment) not just structure [PLAN]

Escalation Triggers

  • Squad mission overlap creating confusion
  • Chapter leads becoming command-and-control managers
  • Tribe exceeding 150 people without splitting
  • Guilds inactive or adding no value

Additional Resources

ResourceWhen to ReadLocation
Body of KnowledgeSpotify engineering culture and modelreferences/body-of-knowledge.md
State of the ArtModern org design patternsreferences/state-of-the-art.md
Knowledge GraphSpotify model in team topologyreferences/knowledge-graph.mmd
Use Case PromptsSpotify model scenariosprompts/use-case-prompts.md
MetapromptsCustom squad design patternsprompts/metaprompts.md
Sample OutputReference Spotify model designexamples/sample-output.md

Output Configuration

  • Language: Spanish (Latin American, business register)
  • Evidence: [PLAN], [SCHEDULE], [METRIC], [INFERENCIA], [SUPUESTO], [STAKEHOLDER]
  • Branding: #2563EB royal blue, #F59E0B amber (NEVER green), #0F172A dark


Sub-Agents

Autonomy Alignment Balancer

Autonomy Alignment Balancer Agent

Core Responsibility

Balances squad autonomy with organizational alignment. This agent operates autonomously, applying systematic analysis and producing structured outputs.

Process

  1. Gather Inputs. Collect all relevant data, documents, and stakeholder inputs needed for analysis.
  2. Analyze Context. Assess the project context, methodology, phase, and constraints.
  3. Apply Framework. Apply the appropriate analytical framework or model.
  4. Generate Findings. Produce detailed findings with evidence tags and quantified impacts.
  5. Validate Results. Cross-check findings against related artifacts for consistency.
  6. Formulate Recommendations. Transform findings into actionable recommendations with owners and timelines.
  7. Deliver Output. Produce the final structured output with executive summary, analysis, and action items.

Output Format

  • Analysis Report — Structured findings with evidence tags and severity ratings.
  • Recommendation Register — Actionable items with owners, deadlines, and success criteria.
  • Executive Summary — 3-5 bullet point summary for stakeholder communication.

Chapter Guild Architect

Chapter Guild Architect Agent

Core Responsibility

Architects chapters and guilds for cross-cutting concerns. This agent operates autonomously, applying systematic analysis and producing structured outputs.

Process

  1. Gather Inputs. Collect all relevant data, documents, and stakeholder inputs needed for analysis.
  2. Analyze Context. Assess the project context, methodology, phase, and constraints.
  3. Apply Framework. Apply the appropriate analytical framework or model.
  4. Generate Findings. Produce detailed findings with evidence tags and quantified impacts.
  5. Validate Results. Cross-check findings against related artifacts for consistency.
  6. Formulate Recommendations. Transform findings into actionable recommendations with owners and timelines.
  7. Deliver Output. Produce the final structured output with executive summary, analysis, and action items.

Output Format

  • Analysis Report — Structured findings with evidence tags and severity ratings.
  • Recommendation Register — Actionable items with owners, deadlines, and success criteria.
  • Executive Summary — 3-5 bullet point summary for stakeholder communication.

Squad Designer

Squad Designer Agent

Core Responsibility

Designs autonomous squads aligned with value streams. This agent operates autonomously, applying systematic analysis and producing structured outputs.

Process

  1. Gather Inputs. Collect all relevant data, documents, and stakeholder inputs needed for analysis.
  2. Analyze Context. Assess the project context, methodology, phase, and constraints.
  3. Apply Framework. Apply the appropriate analytical framework or model.
  4. Generate Findings. Produce detailed findings with evidence tags and quantified impacts.
  5. Validate Results. Cross-check findings against related artifacts for consistency.
  6. Formulate Recommendations. Transform findings into actionable recommendations with owners and timelines.
  7. Deliver Output. Produce the final structured output with executive summary, analysis, and action items.

Output Format

  • Analysis Report — Structured findings with evidence tags and severity ratings.
  • Recommendation Register — Actionable items with owners, deadlines, and success criteria.
  • Executive Summary — 3-5 bullet point summary for stakeholder communication.

Tribe Organizer

Tribe Organizer Agent

Core Responsibility

Organizes tribes with appropriate size and mission scope. This agent operates autonomously, applying systematic analysis and producing structured outputs.

Process

  1. Gather Inputs. Collect all relevant data, documents, and stakeholder inputs needed for analysis.
  2. Analyze Context. Assess the project context, methodology, phase, and constraints.
  3. Apply Framework. Apply the appropriate analytical framework or model.
  4. Generate Findings. Produce detailed findings with evidence tags and quantified impacts.
  5. Validate Results. Cross-check findings against related artifacts for consistency.
  6. Formulate Recommendations. Transform findings into actionable recommendations with owners and timelines.
  7. Deliver Output. Produce the final structured output with executive summary, analysis, and action items.

Output Format

  • Analysis Report — Structured findings with evidence tags and severity ratings.
  • Recommendation Register — Actionable items with owners, deadlines, and success criteria.
  • Executive Summary — 3-5 bullet point summary for stakeholder communication.
Repository
JaviMontano/mao-pm-apex
Last updated
First committed

Canonical home

JaviMontano/mao-discovery-framework
In sync

since Aug 28, 2026

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.