Skip to content

alirezarezvani/claude-skills / business-operations/skills/vendor-management

vendor-management

Verified

Use when scoring or auditing vendors: scorecards, SLA compliance and service credits, third-party risk tier or a tier-1 vendor review. Runs vendor_scorer.py, sla_compliance_tracker.py and vendor_risk_classifier.py.

references/sla_design_patterns.md

View on GitHub
# SLA Design Patterns

This reference focuses on **measuring vendor SLAs** — what to track, what counts as a breach, when a credit claim is legitimate, and how to distinguish a contractual SLA from an internal operational SLO.

The distinction matters because most operators conflate the two. A vendor's SLA is a **commercial commitment** with credits attached. An internal SLO is an **engineering target** with no money attached. Use the right framing for the right artifact.

## 1. Google SRE Workbook — Chapter 2 ("Implementing SLOs")

The canonical distinction between SLI / SLO / SLA. From the Workbook:

- **SLI** (Indicator) — what you measure (e.g., HTTP request success rate).
- **SLO** (Objective) — internal target (e.g., 99.9% over 28 days).
- **SLA** (Agreement) — **external contractual commitment** with consequences (typically service credits).

The key operational insight: your **SLA should be looser than your SLO**, because the SLO is where you alert internally and the SLA is what you owe the customer. The same logic applies in reverse to vendor SLAs you're tracking: the vendor's SLA is your floor, not your target.

- Source: Google SRE Workbook (Beyer, Murphy, Rensin, Kawahara, Thorne, eds., O'Reilly 2018). Free online: https://sre.google/workbook/implementing-slos/

## 2. Atlassian — SLA Best Practices

Atlassian's product (Jira Service Management) drives a lot of the operational SLA practice in mid-market companies. Their published patterns:

- SLAs should be **measurable** (no "best effort" clauses — those are unenforceable).
- SLA targets should have **business meaning**, not just be round numbers (99.9% has different meaning depending on whether downtime is measured in clock-time or business hours).
- Always document **exclusions** explicitly (planned maintenance, force majeure, customer-caused outages).

- Source: Atlassian — *SLAs: Best Practices*. https://www.atlassian.com/itsm/service-request-management/slas

## 3. ITIL v4 — Service Level Management practice

ITIL v4 (the current edition, replacing v3 in 2019) defines **Service Level Management** as one of the 34 management practices. Key concepts:

- **OLA** (Operational Level Agreement) — the internal mirror of an external SLA. Often missing from vendor relationships, which is why credit claims fail.
- The "watermelon SLA" anti-pattern: SLA reports show green externally but the underlying service is rotting (red on the inside). ITIL's response: report on **customer-experienced** metrics, not vendor-self-reported ones.

- Source: AXELOS — *ITIL Foundation: ITIL 4 Edition* (Stationery Office Books, 2019). https://www.axelos.com/certifications/itil-certifications

## 4. Gartner — SLA research notes (multiple)

Gartner publishes recurring research on SLA design across vendor categories. Recurring themes:

- **Tiered SLAs by service criticality** are now industry standard (e.g., AWS has different SLAs for EC2 vs S3 vs Lambda — your contract should match the workload-vs-SLA pairing).
- **Service credits are typically capped at 10-30% of monthly fees** — if the vendor's standard SLA caps credits at < 10% on a tier-1 dependency, that's a negotiation point.
- **"100% uptime" SLAs are red flags** — no real service is 100% available; the credit clauses around such SLAs are usually unenforceable in practice.

- Source: Gartner — search "Service Level Agreement" in Gartner research portal. https://www.gartner.com/en/documents

## 5. AWS / Azure / GCP — Hyperscaler SLA documentation patterns

The three hyperscalers publish their SLAs as a public reference for the rest of the industry. Things to study:

- **AWS Service Level Agreements** — per-service pages, e.g. EC2 SLA, S3 SLA, RDS SLA. Each defines monthly uptime percentage, service credit tiers, exclusions, and the claim process. https://aws.amazon.com/legal/service-level-agreements/
- **Microsoft Azure SLAs** — same structure, but with a single consolidated SLA summary table per service. https://www.microsoft.com/licensing/docs/view/Service-Level-Agreements-SLA-for-Online-Services
- **Google Cloud SLAs** — per-product, with explicit measurement methodology (e.g., 99.99% means downtime < 4.38 minutes/month). https://cloud.google.com/terms/sla

These public SLAs are the **benchmark** for any cloud-adjacent SaaS vendor. If a vendor offers worse-than-hyperscaler SLA for an analogous service, that's negotiable.

## 6. Shawn Robertson — *Practical Guide to SLAs* (industry e-book / blog)

A practitioner-oriented guide widely cited in IT operations communities. Key themes that show up in this skill's tracker:

- **Measure the right thing**: response time vs resolution time vs uptime are three different SLAs; vendors often hide behind "we hit response SLA" when resolution is what hurt you.
- **Credit-claim eligibility is rarely automatic.** You have to file the claim, with evidence, often within a 30-90 day window. This is why the SLA tracker in this skill flags `credit_claim_eligible: YES` — to remind the operator to actually file.

- Source: Shawn Robertson — practitioner writings on IT service management. Multiple talks at itSMF / HDI conferences (search "Shawn Robertson SLA practical guide").

## 7. ISO/IEC 20000-1:2018 — Service management system requirements

The formal standard backing ITIL practice. Section 8.3.3 (Service Level Management) specifies what your SLM process must include:

- Documented SLAs for each service
- Regular review intervals
- Performance against SLAs measured and reported
- Corrective action where SLAs are not met

When a vendor claims ISO 20000 certification, this is the section that backs that claim. Verify it in the audit report — don't trust the marketing page.

- Source: ISO/IEC 20000-1:2018. https://www.iso.org/standard/70636.html

## Operational recipe (from this canon)

When tracking vendor SLAs in the tool:

1. **Map the SLI** the vendor commits to (e.g., "monthly uptime percentage").
2. **Identify the SLA target** in the contract (e.g., 99.95%).
3. **Verify the measurement methodology** — vendor's status page, your own monitoring, or third-party (Pingdom, Datadog, StatusGator)? Self-reported is least trustworthy.
4. **Track breach count over 12 months** — repeated breaches indicate systemic issues, not bad luck.
5. **File credit claims within the contractual window** — otherwise the credit is forfeited regardless of breach.

The SLA compliance tracker tool flags eligibility but does not file claims automatically. That's a human-in-the-loop step by design.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall