data-contracts
/data-contracts
Uzgadnia, wersjonuje i egzekwuje kontrakty na zbiory danych używane przez inne zespoły, modele lub pulpity.
- Autor
- afonsoalrocha ↗
- Repozytorium
- skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 12.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 5
- Skrypty
- 1
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/contract_diff.py
Co robi i kiedy
Uzgadnia, wersjonuje i egzekwuje kontrakty na zbiory danych używane przez inne zespoły, modele lub pulpity.
Oryginalny opis (EN)
Use when a dataset is consumed by another team, model, dashboard or agent and its schema, grain, keys, freshness or semantics must be agreed, versioned and enforced, or when a producer wants to change such a dataset.
Jak działa
- Invariants
- Flow
- Routes
Podgląd SKILL.md
--- name: data-contracts description: "Use when a dataset is consumed by another team, model, dashboard or agent and its schema, grain, keys, freshness or semantics must be agreed, versioned and enforced, or when a producer wants to change such a dataset." --- # Data contracts A contract is the explicit promise a producer makes to consumers: what the dataset is, at what grain, with which columns and types, how fresh, and what the values mean. It turns "don't break my dashboard" into something a machine checks. ## Invariants - Contract the boundaries, not every model: sources you ingest from, and marts or exports others consume. - A contract states: owner, purpose, grain and primary key, columns with types/nullability/meaning, freshness SLA, allowed values or ranges for critical columns, version. - The contract lives in the repo next to the model (YAML), versioned and reviewed like code. - Enforce it in the build: schema enforcement (e.g. dbt model contracts) plus tests for keys, ranges and freshness (skill `data-quality-gates`); a broken contract blocks. - Additive changes (new nullable column) are minor; removing/renaming a column, changing type, grain or meaning is breaking. - Breaking changes ship as a new version with a deprecation window; the old version keeps working until consumers migrate. - Semantics count as much as schema: a column whose meaning changes is a breaking change even if its type does not. - Do not contract what you do not understand yet; profile the source first and start with a light contract (expected columns + PK), then tighten. - Consumers are listed (dbt exposures or a consumers section) so impact is known before a change. - Metric meaning and status live in the `metric-card` skill (data-analysis plugin). A contract may name the metrics a dataset feeds; it does not redefine them. Publishing gates that read the card are in `data-quality-gates`. ## Flow 1. Identify the boundary and its consumers. 2. Draft the contract from `references/contract-template.yaml`. 3. Agree with consumers on grain, keys, freshness and meaning of critical columns. 4. Enforce: model contract and tests in CI; freshness before builds. 5. Change: classify additive vs breaking with `scripts/contract_diff.py`; breaking means a new version. ## Routes Read only the reference for the task. | If the task is... | Read | |-------------------|------| | Writing a contract file | `references/contract-template.yaml` | | Enforcing in dbt (contract enforced, constraints, versions, exposures) | `references/dbt-contracts.md` | | Contracts on ingested sources (expected columns, schema drift handling) | `references/source-contracts.md` | | Classifying a schema change as additive or breaking | `scripts/contract_diff.py` (requires PyYAML, outside the standard library) |
Pliki w paczce (5)
- SKILL.md 3 KB
- references/contract-template.yaml 1 KB
- references/dbt-contracts.md 1 KB
- references/source-contracts.md 1 KB
- scripts/contract_diff.py 2 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · afonsoalrocha/skills | 90 | MIT |
| sallaumen/elixir-agent-kit | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 8b84ebeb24e9 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100designing-data-contracts
Definiuje i egzekwuje kontrakty danych między producentami i konsumentami: schemat, semantykę, właściciela, SLA i wersjonowanie, by zmiany w źródle nie psuły potoków. - 100design-data-contracts-and-tests
Wyprowadza kontrakt danych na granicy producenta (schemat, semantyka, świeżość, wolumen, właściciel) i zestaw testów walidacyjnych z poziomami ważności. - 90data-data-contracts
Definiuje kontrakty danych między producentami i konsumentami, z wersjonowaniem, testami w CI i konfiguracją dbt. - 100odcs-contracts
Pisze i waliduje kontrakty danych w standardzie ODCS v3.2.0 i pilnuje, by modele dbt zgadzały się z kontraktem. - 100data-contract
Definiuje kontrakt danych dla tabeli używanej przez innych: schemat, klucze, dozwolone wartości, świeżość i właściciela oraz generuje testy. - 100data-designer
Generuje syntetyczne zbiory danych i buduje potok ich tworzenia na podstawie opisu zbioru podanego przez użytkownika.