{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-one-concern-per-file",
  "id": "one-concern-per-file",
  "kind": "principle",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-structural-core",
    "json": "https://banes-lab.com/json/records/layer/structural-core",
    "label": "Structural Core",
    "markdown": "https://banes-lab.com/records/layer/structural-core.md",
    "ref": "layer:structural-core"
  },
  "name": "One Concern Per File",
  "ref": "architecture:one-concern-per-file",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-classification-judgment",
          "json": "https://banes-lab.com/json/records/lexicon/classification-judgment",
          "label": "Classification Judgment",
          "markdown": "https://banes-lab.com/records/lexicon/classification-judgment.md",
          "ref": "lexicon:classification-judgment"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-separation-of-concerns",
          "json": "https://banes-lab.com/json/records/architecture/separation-of-concerns",
          "label": "Separation of Concerns",
          "markdown": "https://banes-lab.com/records/architecture/separation-of-concerns.md",
          "ref": "architecture:separation-of-concerns"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-narrowest-concern",
          "json": "https://banes-lab.com/json/records/architecture/narrowest-concern",
          "label": "Narrowest Concern",
          "markdown": "https://banes-lab.com/records/architecture/narrowest-concern.md",
          "ref": "architecture:narrowest-concern"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-multi-role-file",
          "json": "https://banes-lab.com/json/records/lexicon/multi-role-file",
          "label": "Multi-Role File",
          "markdown": "https://banes-lab.com/records/lexicon/multi-role-file.md",
          "ref": "lexicon:multi-role-file"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-sentence-shaped-name",
          "json": "https://banes-lab.com/json/records/lexicon/sentence-shaped-name",
          "label": "Sentence-Shaped Name",
          "markdown": "https://banes-lab.com/records/lexicon/sentence-shaped-name.md",
          "ref": "lexicon:sentence-shaped-name"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-multi-role-file",
          "json": "https://banes-lab.com/json/records/lexicon/multi-role-file",
          "label": "Multi-Role File",
          "markdown": "https://banes-lab.com/records/lexicon/multi-role-file.md",
          "ref": "lexicon:multi-role-file"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-split-by-responsibility",
          "json": "https://banes-lab.com/json/records/lexicon/split-by-responsibility",
          "label": "Split by Responsibility",
          "markdown": "https://banes-lab.com/records/lexicon/split-by-responsibility.md",
          "ref": "lexicon:split-by-responsibility"
        }
      ],
      "relation": "refactored-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-mandatory",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-mandatory",
          "label": "mandatory",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-mandatory.md",
          "ref": "vocabulary:severity-mandatory"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-taxonomy-classification-naming",
          "json": "https://banes-lab.com/json/records/architecture-category/taxonomy-classification-naming",
          "label": "Taxonomy / Classification / Naming",
          "markdown": "https://banes-lab.com/records/architecture-category/taxonomy-classification-naming.md",
          "ref": "architecture-category:taxonomy-classification-naming"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-collision-consolidation",
          "json": "https://banes-lab.com/json/records/architecture/collision-consolidation",
          "label": "Collision Consolidation",
          "markdown": "https://banes-lab.com/records/architecture/collision-consolidation.md",
          "ref": "architecture:collision-consolidation"
        }
      ],
      "relation": "required-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/disciplined-methodology/build#placement-is-a-grammar",
          "json": "https://banes-lab.com/json/disciplined-methodology/build/placement-is-a-grammar",
          "label": "Placement is a grammar",
          "markdown": "https://banes-lab.com/disciplined-methodology/build/placement-is-a-grammar.md",
          "ref": "chapter:/disciplined-methodology/build#placement-is-a-grammar"
        },
        {
          "href": "https://banes-lab.com/software-architecture#the-layer-spine",
          "json": "https://banes-lab.com/json/software-architecture/model/the-layer-spine",
          "label": "The layer spine",
          "markdown": "https://banes-lab.com/software-architecture/model/the-layer-spine.md",
          "ref": "chapter:/software-architecture#the-layer-spine"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-core-modular-design",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-core-modular-design",
          "label": "Core Modular Design",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-core-modular-design.md",
          "ref": "chapter:/ontology#architecture-category-core-modular-design"
        },
        {
          "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-taxonomy-classification-naming",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-taxonomy-classification-naming",
          "label": "Taxonomy / Classification / Naming",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-taxonomy-classification-naming.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-taxonomy-classification-naming"
        },
        {
          "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"
        }
      ],
      "relation": "linked-from"
    }
  ],
  "summary": "A design rule that each file plays exactly one declared role, and a file that plays two is split.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-narrowest-concern",
      "json": "https://banes-lab.com/json/records/architecture/narrowest-concern",
      "label": "Narrowest Concern",
      "markdown": "https://banes-lab.com/records/architecture/narrowest-concern.md",
      "ref": "architecture:narrowest-concern"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-sideways-overflow",
      "json": "https://banes-lab.com/json/records/architecture/sideways-overflow",
      "label": "Sideways Overflow",
      "markdown": "https://banes-lab.com/records/architecture/sideways-overflow.md",
      "ref": "architecture:sideways-overflow"
    }
  },
  "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": "foo.store.ts + foo.validator.ts → the ambiguity was the finding; the split is the fix",
    "before": "foo.store.ts → holds the state AND validates every write, so its concern is two words",
    "lang": "flow",
    "medium": "composite"
  },
  "formedBy": null,
  "scope": [
    "file"
  ],
  "severity": "mandatory"
}