{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-contract-first-design",
  "id": "contract-first-design",
  "kind": "principle",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-contracts-core",
    "json": "https://banes-lab.com/json/records/layer/contracts-core",
    "label": "Contracts Core",
    "markdown": "https://banes-lab.com/records/layer/contracts-core.md",
    "ref": "layer:contracts-core"
  },
  "name": "Contract-First Design",
  "ref": "architecture:contract-first-design",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-explicit-contracts",
          "json": "https://banes-lab.com/json/records/architecture/explicit-contracts",
          "label": "Explicit Contracts",
          "markdown": "https://banes-lab.com/records/architecture/explicit-contracts.md",
          "ref": "architecture:explicit-contracts"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-schema-contract",
          "json": "https://banes-lab.com/json/records/architecture/schema-contract",
          "label": "Schema Contract",
          "markdown": "https://banes-lab.com/records/architecture/schema-contract.md",
          "ref": "architecture:schema-contract"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-interoperability",
          "json": "https://banes-lab.com/json/records/architecture/interoperability",
          "label": "Interoperability",
          "markdown": "https://banes-lab.com/records/architecture/interoperability.md",
          "ref": "architecture:interoperability"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-backward-compatibility",
          "json": "https://banes-lab.com/json/records/architecture/backward-compatibility",
          "label": "Backward Compatibility",
          "markdown": "https://banes-lab.com/records/architecture/backward-compatibility.md",
          "ref": "architecture:backward-compatibility"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-consumer-driven-development",
          "json": "https://banes-lab.com/json/records/lexicon/consumer-driven-development",
          "label": "Consumer-Driven Development",
          "markdown": "https://banes-lab.com/records/lexicon/consumer-driven-development.md",
          "ref": "lexicon:consumer-driven-development"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-implementation-first-integration",
          "json": "https://banes-lab.com/json/records/lexicon/implementation-first-integration",
          "label": "Implementation-First Integration",
          "markdown": "https://banes-lab.com/records/lexicon/implementation-first-integration.md",
          "ref": "lexicon:implementation-first-integration"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-iteration-speed",
          "json": "https://banes-lab.com/json/records/lexicon/iteration-speed",
          "label": "Iteration Speed",
          "markdown": "https://banes-lab.com/records/lexicon/iteration-speed.md",
          "ref": "lexicon:iteration-speed"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-contract-first-design-iteration-speed",
          "json": "https://banes-lab.com/json/records/tension/contract-first-design-iteration-speed",
          "label": "Contract-First Design / Iteration Speed",
          "markdown": "https://banes-lab.com/records/tension/contract-first-design-iteration-speed.md",
          "ref": "tension:contract-first-design-iteration-speed"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-implementation-first-integration",
          "json": "https://banes-lab.com/json/records/lexicon/implementation-first-integration",
          "label": "Implementation-First Integration",
          "markdown": "https://banes-lab.com/records/lexicon/implementation-first-integration.md",
          "ref": "lexicon:implementation-first-integration"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-define-contract",
          "json": "https://banes-lab.com/json/records/lexicon/define-contract",
          "label": "Define Contract",
          "markdown": "https://banes-lab.com/records/lexicon/define-contract.md",
          "ref": "lexicon:define-contract"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-code-generation",
          "json": "https://banes-lab.com/json/records/lexicon/code-generation",
          "label": "Code Generation",
          "markdown": "https://banes-lab.com/records/lexicon/code-generation.md",
          "ref": "lexicon:code-generation"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-contract-testing",
          "json": "https://banes-lab.com/json/records/lexicon/contract-testing",
          "label": "Contract Testing",
          "markdown": "https://banes-lab.com/records/lexicon/contract-testing.md",
          "ref": "lexicon:contract-testing"
        }
      ],
      "relation": "refactored-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-recommended",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-recommended",
          "label": "recommended",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-recommended.md",
          "ref": "vocabulary:severity-recommended"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-contracts-interfaces-compatibility",
          "json": "https://banes-lab.com/json/records/architecture-category/contracts-interfaces-compatibility",
          "label": "Contracts / Interfaces / Compatibility",
          "markdown": "https://banes-lab.com/records/architecture-category/contracts-interfaces-compatibility.md",
          "ref": "architecture-category:contracts-interfaces-compatibility"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-consumer-driven-contracts",
          "json": "https://banes-lab.com/json/records/architecture/consumer-driven-contracts",
          "label": "Consumer-Driven Contracts",
          "markdown": "https://banes-lab.com/records/architecture/consumer-driven-contracts.md",
          "ref": "architecture:consumer-driven-contracts"
        }
      ],
      "relation": "reinforced-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-contracts-interfaces-compatibility",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-contracts-interfaces-compatibility",
          "label": "Contracts / Interfaces / Compatibility",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-contracts-interfaces-compatibility.md",
          "ref": "chapter:/ontology#architecture-category-contracts-interfaces-compatibility"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-contracts-interfaces-compatibility",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-contracts-interfaces-compatibility",
          "label": "Contracts / Interfaces / Compatibility",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-contracts-interfaces-compatibility.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-contracts-interfaces-compatibility"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-core-vocabulary",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-core-vocabulary",
          "label": "Core Vocabulary",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-core-vocabulary.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-core-vocabulary"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-vocabulary-severity",
          "json": "https://banes-lab.com/json/ontology/schema/the-vocabulary-severity",
          "label": "Severity levels",
          "markdown": "https://banes-lab.com/ontology/schema/the-vocabulary-severity.md",
          "ref": "chapter:/ontology/schema#the-vocabulary-severity"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-resolutions",
          "json": "https://banes-lab.com/json/ontology/schema/the-resolutions",
          "label": "The resolutions",
          "markdown": "https://banes-lab.com/ontology/schema/the-resolutions.md",
          "ref": "chapter:/ontology/schema#the-resolutions"
        }
      ],
      "relation": "linked-from"
    }
  ],
  "summary": "A design rule that a boundary's contract is written and agreed before the implementation behind it.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-api-contract",
      "json": "https://banes-lab.com/json/records/architecture/api-contract",
      "label": "API Contract",
      "markdown": "https://banes-lab.com/records/architecture/api-contract.md",
      "ref": "architecture:api-contract"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-interface-based-design",
      "json": "https://banes-lab.com/json/records/architecture/interface-based-design",
      "label": "Interface-Based Design",
      "markdown": "https://banes-lab.com/records/architecture/interface-based-design.md",
      "ref": "architecture:interface-based-design"
    }
  },
  "up": {
    "href": null,
    "json": "https://banes-lab.com/json/api/records/architecture",
    "label": "Architecture principles",
    "markdown": "https://banes-lab.com/api/records/architecture.md",
    "ref": "api:records/architecture"
  },
  "aliases": [],
  "exemplar": {
    "after": "type CreateFooRequest = { name: string };\ntype CreateFooResponse = { id: FooId; version: 1 };\ninterface CreateFooContract {\n  request: CreateFooRequest;\n  response: CreateFooResponse;\n}\napp.post(\"/foo\", implement<CreateFooContract>(createFoo));",
    "before": "app.post(\"/foo\", async request => fooStore.save(await request.json()));",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "API",
    "service",
    "integration"
  ],
  "severity": "recommended"
}