team-api

What problem does it solve?

Teams and leaders lack a consistent, discoverable way to surface AI literacy and engineering maturity inside Team Topologies Team API documents, making it hard to coordinate improvement efforts across repositories and to communicate team capabilities to stakeholders.

Core Features & Use Cases

• Update existing Team API: Detect or append an AI Literacy section in an existing Team API and refresh it with the latest portfolio assessment data while preserving other sections.
• Generate from template: Populate references/team-api-template.md with portfolio median levels, repo discipline scores, shared gaps, and organisation-wide improvement plans to create a new team-api.md.
• Operational visibility: Produce Repo Levels, Discipline Scores, Active Shared Gaps, and Current Improvement Focus to help teams prioritize engineering improvements and communicate readiness to dependents.
• Use Case: Create or update the Payments team API to include the current portfolio median, which helps platform teams decide where to invest support and tooling.

Quick Start

Create a Team API for the Payments team using the latest assessments/*-portfolio-assessment.md and write the result to teams/payments/team-api.md.