| name | platform-capability |
| description | Design and deliver an internal platform capability with a clear consumer contract, paved path, self-service interface, reliability expectations, and operational ownership. |
Platform Capability
Use for shared developer/runtime capabilities consumed by multiple teams or services.
Procedure
- Identify platform consumers and the recurring problem that justifies centralization.
- Define a stable contract and abstraction boundary that hides accidental complexity without blocking necessary control.
- Design a paved path for common cases and explicit escape hatches for legitimate exceptions.
- Address tenancy, quotas, identity, secrets, observability, reliability, versioning, and backward compatibility.
- Provide self-service provisioning or clear automation where manual platform-team intervention would become a bottleneck.
- Build usage documentation and examples as part of the capability.
- Measure adoption, failure modes, support burden, and whether the platform actually reduces consumer complexity.
Quality gate
A platform feature should make repeated work easier for consumers. Centralizing complexity without a good interface merely moves the problem.