{
  "vercy": "1.0-draft",
  "publication": {
    "status": "research-draft",
    "adjudicationStatus": "unreviewed",
    "publishableCanonical": false,
    "generatedAt": "2026-09-13T14:57:12Z",
    "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:33:37+00:00",
      "fields": [
        "agent_conduct",
        "ethics",
        "owners"
      ]
    },
    "gate": {
      "passed": true,
      "version": "1.0",
      "at": "2026-10-06T19:51:53+00:00",
      "evidence": [
        "completeness 1.00",
        "sense: Wikidata description",
        "2 live sources",
        "review by codex: pass"
      ]
    }
  },
  "metaModel": {
    "id": "THING-Q1057179",
    "registryId": "vr.tr.user-guide",
    "name": "user guide",
    "version": "0.2.0-wave.4",
    "entryKind": "thing",
    "family": "Thing Registry",
    "domain": [
      "INF.KNW"
    ],
    "status": "research-draft"
  },
  "canonicalUrl": "https://ver.cy/models/thing/q1057179/",
  "model": {
    "registry_id": "vr.tr.user-guide",
    "name": "user guide",
    "purpose": "Let an agent explain user guides and their purpose, relay structure, writing standards and kinds from technical communication sources, describe the kinds the registry aliases name, and distinguish user guides from reference manuals, tutorials, specifications and help systems, noting misfiled aliases.",
    "definition": "A document that explains how to use a product, system or service to its users, from quick reference handbooks and software manuals to aircraft operations manuals, video game strategy guides and instructional manuals for skills such as martial arts; the registry aliases also list sample ballot and Herminia, which are not user guides and appear to be misfiled.",
    "what_it_is_for": "Explaining how to use something.",
    "affordances": [
      "explain the document type",
      "relay writing standards",
      "describe kinds",
      "distinguish related documents"
    ],
    "distinguishing_features": [
      "Task oriented",
      "Written for users",
      "Structured",
      "Many domains"
    ],
    "appearance": "A printed or digital document with instructions, diagrams and procedures.",
    "visual_identification": [
      "Instructions for users of a product",
      "Quick reference handbook, aircraft operations manual, strategy guide, martial arts manual",
      "Reference manuals list everything; tutorials teach step by step; specifications define; help systems are embedded"
    ],
    "physical_properties": [
      {
        "quantity": "standard",
        "typical_range": "ISO/IEC/IEEE 26514",
        "unit": "note",
        "note": "user documentation"
      },
      {
        "quantity": "typical sections",
        "typical_range": "getting started, tasks, troubleshooting",
        "unit": "list",
        "note": ""
      },
      {
        "quantity": "formats",
        "typical_range": "print, PDF, online help",
        "unit": "list",
        "note": ""
      }
    ],
    "families_and_kinds": [
      "software and hardware user guides",
      "quick reference handbooks",
      "aircraft and equipment operations manuals",
      "video game strategy guides",
      "skill manuals such as martial arts manuals",
      "online help and knowledge bases"
    ],
    "related_models": [
      {
        "relation": "is a kind of",
        "target": "guideline",
        "why": "in registry terms"
      },
      {
        "relation": "is produced by",
        "target": "technical writer",
        "why": "in most organisations"
      },
      {
        "relation": "is contrasted with",
        "target": "reference manual",
        "why": "organised by feature"
      },
      {
        "relation": "is governed by",
        "target": "ISO/IEC/IEEE 26514",
        "why": "as a standard"
      }
    ],
    "identifiers": [],
    "standards_and_regulation": [
      "ISO/IEC/IEEE 26514 and related documentation standards",
      "Product safety laws requiring instructions",
      "Aviation regulations for operations manuals"
    ],
    "failure_modes_and_hazards": [
      "Outdated or inaccurate instructions",
      "Registry aliases misfiled such as sample ballot and Herminia",
      "Confusing guides with reference manuals"
    ],
    "in_scope": [],
    "out_of_scope": [],
    "characteristics": [],
    "agent_conduct": {
      "may": [
        "Find, quote and summarise a user guide for the product it belongs to, naming its version.",
        "Follow the steps of a user guide when operating equipment the agent is authorized to use.",
        "Point out where a guide is outdated or contradicts the product."
      ],
      "must_not": [
        "Ignore safety warnings in a user guide when operating the product.",
        "Apply instructions from a guide for a different model or version as if they matched.",
        "Remove or alter safety or regulatory content when reproducing a guide.",
        "Reproduce a copyrighted guide in full where the rights holder has not permitted it."
      ],
      "requires_human": [
        "Departing from the guide's instructions on safety-critical equipment, such as aircraft or medical devices.",
        "Publishing corrections to an official guide."
      ]
    },
    "ethics": {
      "considerations": [
        "Users rely on guides for safety; missing or misleading instructions cause injuries.",
        "Guides in only one language or format exclude people who cannot read them."
      ],
      "affected_parties": [
        "Users of the product",
        "People near operated equipment",
        "The publisher"
      ]
    },
    "owners": {
      "steward": "The maker or publisher of the product the guide documents.",
      "master_systems": []
    }
  },
  "sources": [
    {
      "id": "wikidata",
      "title": "Wikidata item Q1057179: user guide",
      "url": "https://www.wikidata.org/wiki/Q1057179",
      "url_status": "live",
      "what_it_supports": "identity and sense of the item",
      "checked_by": "wikidata-api"
    },
    {
      "id": "wikipedia-en",
      "title": "Wikipedia: User guide",
      "url": "https://en.wikipedia.org/wiki/User_guide",
      "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 user guide is.",
        "rationale": "Definition.",
        "layers": [
          {
            "id": "definition",
            "name": "Definition",
            "description": "Definition.",
            "findings": [
              {
                "id": "definition-finding",
                "name": "Definition",
                "description": "Definition.",
                "questions": [
                  {
                    "text": "What is a user guide, and how does it differ from a reference manual, tutorial, specification and help system?",
                    "kind": "definition"
                  },
                  {
                    "text": "Is the question about the document type, a kind, writing practice or a misfiled alias?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          },
          {
            "id": "kinds",
            "name": "Kinds",
            "description": "Kinds.",
            "findings": [
              {
                "id": "kinds-finding",
                "name": "Kinds",
                "description": "Kinds.",
                "questions": [
                  {
                    "text": "What are quick reference handbooks, operations manuals, strategy guides and martial arts manuals?",
                    "kind": "definition"
                  },
                  {
                    "text": "Which entry fits the specific kind?",
                    "kind": "action"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "writing",
        "name": "Writing",
        "description": "Writing.",
        "rationale": "Sources.",
        "layers": [
          {
            "id": "structure",
            "name": "Structure",
            "description": "Structure.",
            "findings": [
              {
                "id": "structure-finding",
                "name": "Structure",
                "description": "Structure.",
                "questions": [
                  {
                    "text": "How are user guides structured, and what do standards require?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which references are standard?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          },
          {
            "id": "style",
            "name": "Style",
            "description": "Style.",
            "findings": [
              {
                "id": "style-finding",
                "name": "Style",
                "description": "Style.",
                "questions": [
                  {
                    "text": "What writing principles make guides usable, such as task orientation and plain language?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which sources are cited?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "practice",
        "name": "Practice",
        "description": "Practice.",
        "rationale": "Application.",
        "layers": [
          {
            "id": "tools",
            "name": "Tools",
            "description": "Tools.",
            "findings": [
              {
                "id": "tools-finding",
                "name": "Tools",
                "description": "Tools.",
                "questions": [
                  {
                    "text": "What tools and formats are used for authoring and publishing guides?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits technical writing?",
                    "kind": "action"
                  }
                ]
              }
            ]
          },
          {
            "id": "regulated",
            "name": "Regulated",
            "description": "Regulated domains.",
            "findings": [
              {
                "id": "regulated-finding",
                "name": "Regulated",
                "description": "Regulated.",
                "questions": [
                  {
                    "text": "How are operations manuals regulated in aviation and safety-critical fields?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits aircraft flight manual?",
                    "kind": "action"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "context",
        "name": "Context",
        "description": "History and registry note.",
        "rationale": "Context.",
        "layers": [
          {
            "id": "history",
            "name": "History",
            "description": "History.",
            "findings": [
              {
                "id": "history-finding",
                "name": "History",
                "description": "History.",
                "questions": [
                  {
                    "text": "How did user documentation develop from printed manuals to online help?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits the history of technical communication?",
                    "kind": "action"
                  }
                ]
              }
            ]
          },
          {
            "id": "aliases",
            "name": "Aliases",
            "description": "Misfiled aliases.",
            "findings": [
              {
                "id": "aliases-finding",
                "name": "Aliases",
                "description": "Aliases.",
                "questions": [
                  {
                    "text": "Why are sample ballot and Herminia not user guides?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits each?",
                    "kind": "action"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  },
  "openQuestions": [
    "Should strategy guide and operations manual be separate primary entries?",
    "How should technical communication sources be linked?",
    "The registry aliases sample ballot and Herminia are not user guides and should be detached"
  ],
  "statistics": {
    "bundles": 4,
    "layers": 8,
    "findings": 8,
    "questions": 16
  }
}