{
  "vercy": "1.0-draft",
  "publication": {
    "status": "research-draft",
    "adjudicationStatus": "unreviewed",
    "publishableCanonical": false,
    "generatedAt": "2026-09-13T19:00:33Z",
    "providers": [
      "Claude"
    ],
    "breadth": "written by Claude from model knowledge without web access - no source was read, every claim is a lead to verify",
    "pass": 2,
    "wave": 4,
    "engine": "claude",
    "enrichment": {
      "pass": 3,
      "engine": "claude",
      "producedAt": "2026-10-06T11:00:00Z",
      "ingestedAt": "2026-10-06T07:39:07+00:00",
      "fields": [
        "agent_conduct",
        "ethics",
        "owners"
      ]
    }
  },
  "metaModel": {
    "id": "THING-Q1709010",
    "registryId": "vr.tr.software-engineer",
    "name": "software engineer",
    "version": "0.2.0-wave.4",
    "entryKind": "thing",
    "family": "Thing Registry",
    "domain": [
      "SOC.PER"
    ],
    "status": "research-draft"
  },
  "canonicalUrl": "https://ver.cy/models/thing/q1709010/",
  "model": {
    "registry_id": "vr.tr.software-engineer",
    "name": "software engineer",
    "purpose": "Let an agent explain the software engineer role and specialisations, relay practices, education, career levels and regulation from professional and labour sources, describe the roles the registry aliases name, and distinguish software engineers from developers, systems engineers, data scientists and computer scientists.",
    "definition": "An engineer who applies engineering principles to the design, development, testing and maintenance of software systems, with specialisations such as principal software engineers, machine learning engineers, natural language processing engineers, research software engineers in academia, bioinformatics engineers and software evaluators; the title overlaps with software developer, and in some jurisdictions the term engineer is legally regulated.",
    "what_it_is_for": "Engineering software systems.",
    "affordances": [
      "explain the role",
      "relay practices and careers",
      "describe specialisations",
      "distinguish related roles"
    ],
    "distinguishing_features": [
      "Engineering discipline",
      "Lifecycle focus",
      "Many specialisations",
      "Title regulation varies"
    ],
    "appearance": "Not a visible object; a professional.",
    "visual_identification": [
      "Engineer of software systems",
      "Principal, machine learning, NLP, research software and bioinformatics engineers, software evaluators",
      "Developers write software broadly; systems engineers integrate systems; data scientists analyse data; computer scientists study theory"
    ],
    "physical_properties": [
      {
        "quantity": "term popularised",
        "typical_range": "1968",
        "unit": "year",
        "note": "NATO Software Engineering Conference"
      },
      {
        "quantity": "SWEBOK",
        "typical_range": "body of knowledge guide",
        "unit": "note",
        "note": "IEEE Computer Society"
      },
      {
        "quantity": "regulated title",
        "typical_range": "in some countries and Canadian provinces",
        "unit": "note",
        "note": ""
      }
    ],
    "families_and_kinds": [
      "software engineers by level such as principal",
      "machine learning and NLP engineers",
      "research software engineers",
      "bioinformatics engineers",
      "test and evaluation engineers",
      "site reliability engineers"
    ],
    "related_models": [
      {
        "relation": "is a kind of",
        "target": "systems engineer",
        "why": "in registry terms"
      },
      {
        "relation": "practises",
        "target": "software engineering",
        "why": ""
      },
      {
        "relation": "is contrasted with",
        "target": "software developer",
        "why": "overlapping role"
      },
      {
        "relation": "uses",
        "target": "SWEBOK",
        "why": "as reference"
      }
    ],
    "identifiers": [],
    "standards_and_regulation": [
      "IEEE and ISO software engineering standards",
      "Professional engineering title laws in some jurisdictions",
      "ACM/IEEE Software Engineering Code of Ethics"
    ],
    "failure_modes_and_hazards": [
      "Confusing titles across companies",
      "Legal title restrictions",
      "Registry aliases mixing levels and specialisations"
    ],
    "in_scope": [],
    "out_of_scope": [],
    "characteristics": [],
    "agent_conduct": {
      "may": [
        "Describe software engineering roles and specialisations from professional sources.",
        "Note where the engineer title is legally restricted in a jurisdiction."
      ],
      "must_not": [
        "Assume titles mean the same level across companies.",
        "Use the title engineer for a person where the law restricts it.",
        "Profile or rank named engineers from scraped data without consent.",
        "Mix up levels and specialisations in the registry aliases as one role."
      ],
      "requires_human": [
        "Hiring, firing or evaluating a named engineer."
      ]
    },
    "ethics": {
      "considerations": [
        "Software engineers build systems whose failures can harm many people.",
        "Automated screening of candidates can discriminate."
      ],
      "affected_parties": [
        "Software engineers",
        "Job applicants",
        "Users of their software"
      ]
    },
    "owners": {
      "steward": "The person in the role; professional licensing bodies where the title is regulated.",
      "master_systems": [
        "Professional engineer licensing registers"
      ]
    }
  },
  "sources": [
    {
      "id": "wikidata",
      "title": "Wikidata item Q1709010: software engineer",
      "url": "https://www.wikidata.org/wiki/Q1709010",
      "url_status": "live",
      "what_it_supports": "identity and sense of the item",
      "checked_by": "wikidata-api"
    },
    {
      "id": "wikipedia-en",
      "title": "Wikipedia: Software engineer",
      "url": "https://en.wikipedia.org/wiki/Software_engineer",
      "url_status": "live",
      "what_it_supports": "general description of the item",
      "checked_by": "wikidata-api sitelink"
    }
  ],
  "structure": {
    "bundles": [
      {
        "id": "understand",
        "name": "Understand",
        "description": "What a software engineer is.",
        "rationale": "Definition.",
        "layers": [
          {
            "id": "definition",
            "name": "Definition",
            "description": "Definition.",
            "findings": [
              {
                "id": "definition-finding",
                "name": "Definition",
                "description": "Definition.",
                "questions": [
                  {
                    "text": "What is a software engineer, and how does the role differ from developer, systems engineer, data scientist and computer scientist?",
                    "kind": "definition"
                  },
                  {
                    "text": "Is the question about the role, a specialisation, careers or title regulation?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          },
          {
            "id": "roles",
            "name": "Roles",
            "description": "Specialisations.",
            "findings": [
              {
                "id": "roles-finding",
                "name": "Roles",
                "description": "Roles.",
                "questions": [
                  {
                    "text": "What do principal, ML, NLP, research software and bioinformatics engineers and software evaluators do?",
                    "kind": "definition"
                  },
                  {
                    "text": "Which entry fits the specific role?",
                    "kind": "action"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "practice",
        "name": "Practice",
        "description": "Practice.",
        "rationale": "Sources.",
        "layers": [
          {
            "id": "methods",
            "name": "Methods",
            "description": "Methods.",
            "findings": [
              {
                "id": "methods-finding",
                "name": "Methods",
                "description": "Methods.",
                "questions": [
                  {
                    "text": "What engineering practices do software engineers use across the lifecycle?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which references are standard?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          },
          {
            "id": "ethics",
            "name": "Ethics",
            "description": "Ethics.",
            "findings": [
              {
                "id": "ethics-finding",
                "name": "Ethics",
                "description": "Ethics.",
                "questions": [
                  {
                    "text": "What does the software engineering code of ethics require?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which sources are cited?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "career",
        "name": "Career",
        "description": "Career and regulation.",
        "rationale": "Regulation.",
        "layers": [
          {
            "id": "levels",
            "name": "Levels",
            "description": "Career levels.",
            "findings": [
              {
                "id": "levels-finding",
                "name": "Levels",
                "description": "Levels.",
                "questions": [
                  {
                    "text": "How do career ladders such as senior, staff and principal work?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits engineering career ladder?",
                    "kind": "action"
                  }
                ]
              }
            ]
          },
          {
            "id": "title",
            "name": "Title",
            "description": "Title regulation.",
            "findings": [
              {
                "id": "title-finding",
                "name": "Title",
                "description": "Title.",
                "questions": [
                  {
                    "text": "Where is the title engineer legally protected, and how does it apply to software?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits professional engineer?",
                    "kind": "action"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "context",
        "name": "Context",
        "description": "History and research.",
        "rationale": "Context.",
        "layers": [
          {
            "id": "history",
            "name": "History",
            "description": "History.",
            "findings": [
              {
                "id": "history-finding",
                "name": "History",
                "description": "History.",
                "questions": [
                  {
                    "text": "How did software engineering emerge from the software crisis?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits software crisis?",
                    "kind": "action"
                  }
                ]
              }
            ]
          },
          {
            "id": "rse",
            "name": "RSE",
            "description": "Research software engineering.",
            "findings": [
              {
                "id": "rse-finding",
                "name": "RSE",
                "description": "RSE.",
                "questions": [
                  {
                    "text": "What is research software engineering in academia?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits research software engineering?",
                    "kind": "action"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  },
  "openQuestions": [
    "Should machine learning engineer and research software engineer be separate primary entries?",
    "How should professional sources be linked?",
    "The registry entry has merged aliases naming levels and specialisations; should they be split off?"
  ],
  "statistics": {
    "bundles": 4,
    "layers": 8,
    "findings": 8,
    "questions": 16
  }
}
