{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-convention-over-configuration",
  "id": "convention-over-configuration",
  "kind": "principle",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-declarative-core",
    "json": "https://banes-lab.com/json/records/layer/declarative-core",
    "label": "Declarative Core",
    "markdown": "https://banes-lab.com/records/layer/declarative-core.md",
    "ref": "layer:declarative-core"
  },
  "name": "Convention over Configuration",
  "ref": "architecture:convention-over-configuration",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-stable-conventions",
          "json": "https://banes-lab.com/json/records/lexicon/stable-conventions",
          "label": "Stable Conventions",
          "markdown": "https://banes-lab.com/records/lexicon/stable-conventions.md",
          "ref": "lexicon:stable-conventions"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-pattern-consistency",
          "json": "https://banes-lab.com/json/records/architecture/pattern-consistency",
          "label": "Pattern Consistency",
          "markdown": "https://banes-lab.com/records/architecture/pattern-consistency.md",
          "ref": "architecture:pattern-consistency"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-predictability",
          "json": "https://banes-lab.com/json/records/architecture/predictability",
          "label": "Predictability",
          "markdown": "https://banes-lab.com/records/architecture/predictability.md",
          "ref": "architecture:predictability"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-reduced-boilerplate",
          "json": "https://banes-lab.com/json/records/lexicon/reduced-boilerplate",
          "label": "Reduced Boilerplate",
          "markdown": "https://banes-lab.com/records/lexicon/reduced-boilerplate.md",
          "ref": "lexicon:reduced-boilerplate"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-excessive-configuration",
          "json": "https://banes-lab.com/json/records/lexicon/excessive-configuration",
          "label": "Excessive Configuration",
          "markdown": "https://banes-lab.com/records/lexicon/excessive-configuration.md",
          "ref": "lexicon:excessive-configuration"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-explicitness",
          "json": "https://banes-lab.com/json/records/lexicon/explicitness",
          "label": "Explicitness",
          "markdown": "https://banes-lab.com/records/lexicon/explicitness.md",
          "ref": "lexicon:explicitness"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-convention-over-configuration-explicitness",
          "json": "https://banes-lab.com/json/records/tension/convention-over-configuration-explicitness",
          "label": "Convention over Configuration / Explicitness",
          "markdown": "https://banes-lab.com/records/tension/convention-over-configuration-explicitness.md",
          "ref": "tension:convention-over-configuration-explicitness"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/algorithms#algorithms-automation-kernel",
          "json": "https://banes-lab.com/json/records/algorithms/automation-kernel",
          "label": "Automation Kernel",
          "markdown": "https://banes-lab.com/records/algorithms/automation-kernel.md",
          "ref": "algorithms:automation-kernel"
        }
      ],
      "relation": "contracts"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-inconsistent-conventions",
          "json": "https://banes-lab.com/json/records/lexicon/inconsistent-conventions",
          "label": "Inconsistent Conventions",
          "markdown": "https://banes-lab.com/records/lexicon/inconsistent-conventions.md",
          "ref": "lexicon:inconsistent-conventions"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-standardize-the-interface",
          "json": "https://banes-lab.com/json/records/lexicon/standardize-the-interface",
          "label": "Standardize the Interface",
          "markdown": "https://banes-lab.com/records/lexicon/standardize-the-interface.md",
          "ref": "lexicon:standardize-the-interface"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-centralize-the-rule",
          "json": "https://banes-lab.com/json/records/lexicon/centralize-the-rule",
          "label": "Centralize the Rule",
          "markdown": "https://banes-lab.com/records/lexicon/centralize-the-rule.md",
          "ref": "lexicon:centralize-the-rule"
        }
      ],
      "relation": "refactored-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-contextual",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-contextual",
          "label": "contextual",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-contextual.md",
          "ref": "vocabulary:severity-contextual"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-metadata-self-description-declarative-systems",
          "json": "https://banes-lab.com/json/records/architecture-category/metadata-self-description-declarative-systems",
          "label": "Metadata / Self-Description / Declarative Systems",
          "markdown": "https://banes-lab.com/records/architecture-category/metadata-self-description-declarative-systems.md",
          "ref": "architecture-category:metadata-self-description-declarative-systems"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-derived-naming-registry",
          "json": "https://banes-lab.com/json/records/architecture/derived-naming-registry",
          "label": "Derived Naming Registry",
          "markdown": "https://banes-lab.com/records/architecture/derived-naming-registry.md",
          "ref": "architecture:derived-naming-registry"
        }
      ],
      "relation": "reinforced-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/software-architecture#definitions-own-what",
          "json": "https://banes-lab.com/json/software-architecture/model/definitions-own-what",
          "label": "Definitions own what, code owns how",
          "markdown": "https://banes-lab.com/software-architecture/model/definitions-own-what.md",
          "ref": "chapter:/software-architecture#definitions-own-what"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-correctness-determinism-verification",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-correctness-determinism-verification",
          "label": "Correctness / Determinism / Verification",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-correctness-determinism-verification.md",
          "ref": "chapter:/ontology#architecture-category-correctness-determinism-verification"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-architecture-review-evolution-governance-artifacts",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-architecture-review-evolution-governance-artifacts",
          "label": "Architecture Review / Evolution / Governance Artifacts",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-architecture-review-evolution-governance-artifacts.md",
          "ref": "chapter:/ontology#architecture-category-architecture-review-evolution-governance-artifacts"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-taxonomy-classification-naming",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-taxonomy-classification-naming",
          "label": "Taxonomy / Classification / Naming",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-taxonomy-classification-naming.md",
          "ref": "chapter:/ontology#architecture-category-taxonomy-classification-naming"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-architecture-review-evolution-governance",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-architecture-review-evolution-governance",
          "label": "Architecture Review Evolution Governance",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-architecture-review-evolution-governance.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-architecture-review-evolution-governance"
        },
        {
          "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-modular-design",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-core-modular-design",
          "label": "Core Modular Design",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-core-modular-design.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-core-modular-design"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-metadata-self-description-declarative-systems",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-metadata-self-description-declarative-systems",
          "label": "Metadata / Self-Description / Declarative Systems",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-metadata-self-description-declarative-systems.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-metadata-self-description-declarative-systems"
        },
        {
          "href": "https://banes-lab.com/ontology/algorithms#algorithms-domain-automation",
          "json": "https://banes-lab.com/json/ontology/algorithms/algorithms-domain-automation",
          "label": "Automation",
          "markdown": "https://banes-lab.com/ontology/algorithms/algorithms-domain-automation.md",
          "ref": "chapter:/ontology/algorithms#algorithms-domain-automation"
        },
        {
          "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 framework infers settings from stable naming and placement conventions, and explicit configuration covers only the exceptions.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-capability-declaration",
      "json": "https://banes-lab.com/json/records/architecture/capability-declaration",
      "label": "Capability Declaration",
      "markdown": "https://banes-lab.com/records/architecture/capability-declaration.md",
      "ref": "architecture:capability-declaration"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-declarative-configuration",
      "json": "https://banes-lab.com/json/records/architecture/declarative-configuration",
      "label": "Declarative Configuration",
      "markdown": "https://banes-lab.com/records/architecture/declarative-configuration.md",
      "ref": "architecture:declarative-configuration"
    }
  },
  "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": [
    "Coding by Convention"
  ],
  "exemplar": {
    "after": "const handlers = discoverHandlers(\"./handlers/*.handler.ts\");",
    "before": "registerHandler(\"foo\", \"./handlers/foo-handler\", \"FooHandler\");\nregisterHandler(\"bar\", \"./handlers/bar-handler\", \"BarHandler\");",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "framework",
    "application structure"
  ],
  "severity": "contextual"
}