{
  "vercy": "1.0-draft",
  "publication": {
    "status": "research-draft",
    "adjudicationStatus": "unreviewed",
    "publishableCanonical": false,
    "generatedAt": "2026-09-12T21:40:43Z",
    "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": 3,
    "engine": "claude",
    "enrichment": {
      "pass": 3,
      "engine": "claude",
      "producedAt": "2026-10-06T10:00:00Z",
      "ingestedAt": "2026-10-06T06:57:27+00:00",
      "fields": [
        "agent_conduct",
        "ethics",
        "owners"
      ]
    },
    "gate": {
      "passed": true,
      "version": "1.0",
      "at": "2026-10-08T19:09:48+00:00",
      "evidence": [
        "completeness 1.00",
        "sense: Wikidata description",
        "2 live sources",
        "review by codex: pass"
      ]
    }
  },
  "metaModel": {
    "id": "THING-Q12366145",
    "registryId": "vr.tr.fish-passage",
    "name": "fish passage",
    "version": "0.2.0-wave.3",
    "entryKind": "thing",
    "family": "Thing Registry",
    "domain": [
      "PHY.BLT"
    ],
    "status": "research-draft"
  },
  "canonicalUrl": "https://ver.cy/models/thing/q12366145/",
  "model": {
    "registry_id": "vr.tr.fish-passage",
    "name": "fish passage",
    "purpose": "Let an agent explain what fish passages are and why they are needed, identify types and their suitability for species, relay design guidance and legal requirements from authorities, and route site-specific design to qualified engineers and biologists.",
    "definition": "A structure built at a dam, weir or other barrier in a river to let migrating fish pass upstream or downstream, including pool-and-weir and vertical-slot fishways, nature-like bypass channels, fish ramps, fish lifts and locks, and screens and bypasses that protect fish moving downstream; designed for the swimming abilities of target species and required by law at many barriers.",
    "what_it_is_for": "Restoring fish migration past barriers in rivers.",
    "affordances": [
      "explain the need and types",
      "match types to species and sites in general terms",
      "relay design guidance and legal requirements",
      "route site-specific design to professionals"
    ],
    "distinguishing_features": [
      "Designed for fish swimming ability",
      "Upstream and downstream passage",
      "Technical and nature-like forms",
      "Monitored for effectiveness"
    ],
    "appearance": "A channel, stepped series of pools, ramp of rock, or lift beside a dam or weir, with water flowing through.",
    "visual_identification": [
      "Structure for fish to pass a barrier",
      "Stepped pools, slots, ramps, lifts or bypass channels",
      "Navigation locks and spillways are not fish passages, though fish may use them"
    ],
    "physical_properties": [
      {
        "quantity": "slope",
        "typical_range": "about 1:10 to 1:20",
        "unit": "ratio",
        "note": "technical fishways; ramps and bypasses gentler"
      },
      {
        "quantity": "pool drop",
        "typical_range": "about 0.1-0.3",
        "unit": "m",
        "note": "typical for pool fishways"
      }
    ],
    "families_and_kinds": [
      "pool-and-weir and vertical-slot fishways",
      "Denil and baffle fishways",
      "nature-like bypass channels and fish ramps",
      "fish lifts and fish locks",
      "downstream bypasses and screens",
      "eel passes"
    ],
    "related_models": [
      {
        "relation": "is a kind of",
        "target": "water feature",
        "why": "in registry terms"
      },
      {
        "relation": "is a kind of",
        "target": "hydraulic structure",
        "why": "an engineering work"
      },
      {
        "relation": "is built at",
        "target": "dam",
        "why": "or weir"
      },
      {
        "relation": "serves",
        "target": "fish migration",
        "why": "the ecological need"
      }
    ],
    "identifiers": [],
    "standards_and_regulation": [
      "Water and fisheries laws requiring passage at barriers",
      "EU Water Framework Directive and national river continuity rules",
      "Design guidelines from fisheries agencies",
      "Dam licensing conditions"
    ],
    "failure_modes_and_hazards": [
      "Poor attraction flow so fish do not find the entrance",
      "Design unsuited to target species",
      "Debris blockage and lack of maintenance",
      "Delay and injury during downstream passage"
    ],
    "in_scope": [],
    "out_of_scope": [],
    "characteristics": [],
    "agent_conduct": {
      "may": [
        "Count and report fish moving through a passage from cameras or counters the agent is authorized to use.",
        "Report blockages, debris or low flow in a fish passage to its operator."
      ],
      "must_not": [
        "Close or alter flow to a fish passage during migration without the operator's decision.",
        "Fish, trap or disturb fish gathered in or near a passage contrary to local rules.",
        "Report a passage as working for a species without monitoring data to show it.",
        "Enter a passage or its channels while water is flowing and controls may change."
      ],
      "requires_human": [
        "Changing flow at a dam or weir that affects both the passage and downstream users."
      ]
    },
    "ethics": {
      "considerations": [
        "Barriers in rivers have cut migratory fish off from their spawning grounds.",
        "Water released for fish competes with power, irrigation and flood control."
      ],
      "affected_parties": [
        "Migratory fish",
        "River fisheries",
        "Communities depending on the river"
      ]
    },
    "owners": {
      "steward": "The operator of the dam or weir; environmental authorities set passage obligations.",
      "master_systems": []
    }
  },
  "sources": [
    {
      "id": "wikidata",
      "title": "Wikidata item Q12366145: fish passage",
      "url": "https://www.wikidata.org/wiki/Q12366145",
      "url_status": "live",
      "what_it_supports": "identity and sense of the item",
      "checked_by": "wikidata-api"
    },
    {
      "id": "wikipedia-es",
      "title": "Wikipedia (es): Sistema de transferencia para peces",
      "url": "https://es.wikipedia.org/wiki/Sistema_de_transferencia_para_peces",
      "url_status": "live",
      "checked_by": "wikidata-api sitelink",
      "what_it_supports": "general description of the item"
    }
  ],
  "structure": {
    "bundles": [
      {
        "id": "understand",
        "name": "Understand",
        "description": "What fish passages are.",
        "rationale": "Definition.",
        "layers": [
          {
            "id": "need",
            "name": "Need",
            "description": "Why passages are needed.",
            "findings": [
              {
                "id": "need-finding",
                "name": "Need",
                "description": "Need.",
                "questions": [
                  {
                    "text": "Why do barriers block fish migration, and what do passages restore?",
                    "kind": "definition"
                  },
                  {
                    "text": "Is the structure a fish passage or another hydraulic structure?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          },
          {
            "id": "types",
            "name": "Types",
            "description": "Types.",
            "findings": [
              {
                "id": "types-finding",
                "name": "Types",
                "description": "Types.",
                "questions": [
                  {
                    "text": "What types of fish passage exist, and how do they work?",
                    "kind": "definition"
                  },
                  {
                    "text": "Which entry fits the specific type?",
                    "kind": "action"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "design",
        "name": "Design",
        "description": "Design and species.",
        "rationale": "Engineering.",
        "layers": [
          {
            "id": "species",
            "name": "Species",
            "description": "Matching species.",
            "findings": [
              {
                "id": "species-finding",
                "name": "Species",
                "description": "Species.",
                "questions": [
                  {
                    "text": "How are passages matched to the swimming abilities and behaviour of target species?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Is the question site-specific, which needs an engineer and biologist?",
                    "kind": "boundary"
                  }
                ]
              }
            ]
          },
          {
            "id": "guidance",
            "name": "Guidance",
            "description": "Design guidance.",
            "findings": [
              {
                "id": "guidance-finding",
                "name": "Guidance",
                "description": "Guidance.",
                "questions": [
                  {
                    "text": "What design guidelines do fisheries agencies publish?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which references are standard?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "law",
        "name": "Law",
        "description": "Requirements and monitoring.",
        "rationale": "Regulation.",
        "layers": [
          {
            "id": "requirements",
            "name": "Requirements",
            "description": "Legal requirements.",
            "findings": [
              {
                "id": "requirements-finding",
                "name": "Requirements",
                "description": "Requirements.",
                "questions": [
                  {
                    "text": "When do laws require fish passage at barriers, and who enforces them?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits river continuity law?",
                    "kind": "action"
                  }
                ]
              }
            ]
          },
          {
            "id": "monitoring",
            "name": "Monitoring",
            "description": "Effectiveness.",
            "findings": [
              {
                "id": "monitoring-finding",
                "name": "Monitoring",
                "description": "Monitoring.",
                "questions": [
                  {
                    "text": "How is passage effectiveness monitored, and what do studies report?",
                    "kind": "measurement"
                  },
                  {
                    "text": "Which sources are cited?",
                    "kind": "provenance"
                  }
                ]
              }
            ]
          }
        ]
      },
      {
        "id": "context",
        "name": "Context",
        "description": "History and alternatives.",
        "rationale": "Context.",
        "layers": [
          {
            "id": "history",
            "name": "History",
            "description": "History.",
            "findings": [
              {
                "id": "history-finding",
                "name": "History",
                "description": "History.",
                "questions": [
                  {
                    "text": "How did fish passage design develop from early ladders to modern bypasses?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits the history of fisheries?",
                    "kind": "action"
                  }
                ]
              }
            ]
          },
          {
            "id": "removal",
            "name": "Removal",
            "description": "Dam removal.",
            "findings": [
              {
                "id": "removal-finding",
                "name": "Removal",
                "description": "Removal.",
                "questions": [
                  {
                    "text": "When is barrier removal preferred to a passage, with positions attributed?",
                    "kind": "provenance"
                  },
                  {
                    "text": "Which entry fits dam removal?",
                    "kind": "action"
                  }
                ]
              }
            ]
          }
        ]
      }
    ]
  },
  "openQuestions": [
    "Should each fishway type be a separate entry?",
    "How should design guidelines be linked?",
    "How should effectiveness monitoring data be recorded?"
  ],
  "statistics": {
    "bundles": 4,
    "layers": 8,
    "findings": 8,
    "questions": 16
  }
}
