← Catalogue
World Models · legacy example

Agriculture & Husbandry

This meta-model describes farming as an activity: holdings and their fields, crops grown by season, operations applied to them, harvests gathered, and livestock kept, cared for and yielding produce. It is its own model because farming runs on biological and seasonal rhythms that generic production (K8) does not capture: a season is not a production run, a herd is not a batch, and land, weather and animal life cycles shape every record.

AI YAMLAGENTS.mdSource
IDworld.k9-agriculture-and-husbandry
Version history0.2.0-legacy
CategoryReference example
IndustryCross-industry
Domainactivity-work
Tagsagriculture, husbandry
Data structure

Bundles and layers

Bundle

holding

The farm as a unit of land use

Layers

farmProfile`: the holding, its kind and land use · `fieldAndParcel`: fields mapped onto cadastral parcels

Bundle

cultivation

Growing crops through seasons

Layers

cropSeason`: what is grown where in which season · `fieldOperation`: sowing, treatment, irrigation and tillage acts · `harvest`: gathered lots and their measures

Bundle

husbandry

Keeping animals

Layers

herdAndFlock`: animal groups and identification · `animalCare`: feeding, breeding and veterinary events · `animalProduce`: milk, eggs, wool and other recurring yields

Findings

Catalogue-native findings must describe the information grouped by each layer. This legacy version does not declare them separately.

Questions & artifacts

Questions, artifact requirements and serial naming rules are required by Vercy vNext; they remain unassigned in this reference version.

Service layers

How this specification operates

Dimension & namespace

  • REFERENCE `world.landParcel` (P2): fields are grounded on cadastral parcels
  • REFERENCE `world.site` (P5): barns, stores and yards as sites
  • EXTEND `world.actAction` (K2): field and husbandry operations specialize the atomic act
  • REFERENCE `world.planAndSchedule` (K7): season plans and operation schedules
  • REFERENCE `world.productionAndManufacturing` (K8): downstream processing of harvested and collected produce
  • REFERENCE `world.person` (H1) and `world.organization` (O1): holders and operators
  • imports: agrovoc (ALIGN): multilingual concept vocabulary for crops, livestock and inputs
  • imports: fao (REFERENCE): agricultural census and statistical definitions
  • imports: gs1 (REFERENCE): lot identification for produce entering supply chains

Canon, patches & standards

  • REFERENCE `world.landParcel` (P2): fields are grounded on cadastral parcels
  • REFERENCE `world.site` (P5): barns, stores and yards as sites
  • EXTEND `world.actAction` (K2): field and husbandry operations specialize the atomic act
  • REFERENCE `world.planAndSchedule` (K7): season plans and operation schedules
  • REFERENCE `world.productionAndManufacturing` (K8): downstream processing of harvested and collected produce
  • REFERENCE `world.person` (H1) and `world.organization` (O1): holders and operators
  • imports: agrovoc (ALIGN): multilingual concept vocabulary for crops, livestock and inputs
  • imports: fao (REFERENCE): agricultural census and statistical definitions
  • imports: gs1 (REFERENCE): lot identification for produce entering supply chains

Artifact formats & serial data

Format-independent core. Concrete artifact formats and naming prefixes are not declared in this legacy version.

Policies & accepted processes

  • `traceabilityDisclosure`: a buyer or food chain partner traces a lot back to field, season and operations
  • `statisticalReturn`: the holding reports areas, yields and herd sizes to a statistics office per cadence
  • `agronomicDataSharing`: field and operation data are shared with an adviser or research party under the holder's terms

Read / add / edit / delete

CRUD procedures and interface bindings are not declared in this legacy version.

Ownership, roles & access

The farming organization or person holding the farm owns its records; animal identification may additionally answer to a public registrar. Access is granted by the holder via the catalogue's ownership and access models (S1/S2), with audit via S4.

Existing assembly

Objects, relationships, events and projections

Objects

  • `farm`: an agricultural holding; key attributes: name, holder reference, kind (arable, livestock, mixed), total area
  • `field`: a managed area of land; key attributes: identifier, area, soil class, parcel references
  • `cropSeason`: a crop grown on a field in a season; key attributes: crop, variety, season, sown area, expected harvest window
  • `fieldOperation`: one act of cultivation; key attributes: kind, date, inputs applied, machinery, operator
  • `harvestLot`: a gathered quantity of produce; key attributes: crop season reference, quantity, quality grade, storage location
  • `herd`: a managed group of animals; key attributes: species, purpose, size, identification scheme
  • `animal`: an individually identified animal; key attributes: identifier, species, breed, birth date, status
  • `husbandryOperation`: one act of animal care or yield collection; key attributes: kind, date, subject (herd or animal), materials, result

Relationships

  • `farm` -> comprises -> `field` (one-to-many): the land the holding manages
  • `field` -> locatedOn -> `landParcel` (many-to-many): cadastral grounding of the field
  • `cropSeason` -> grownOn -> `field` (many-to-one): where the crop stands
  • `fieldOperation` -> appliedTo -> `cropSeason` (many-to-one): cultivation acts on the growing crop
  • `harvestLot` -> gatheredFrom -> `cropSeason` (many-to-one): origin of the produce
  • `animal` -> memberOf -> `herd` (many-to-one): group membership over time
  • `herd` -> keptAt -> `farm` (many-to-one): where the animals live
  • `husbandryOperation` -> performedOn -> `herd` (many-to-one): care and collection acts on animals

Events

  • `sowingCompleted`: a crop season was established on a field
  • `treatmentApplied`: an input or intervention was applied to a crop or field
  • `harvestGathered`: produce was collected into a harvest lot
  • `animalRegistered`: an animal entered identification records
  • `animalMoved`: an animal or herd changed farm or field
  • `produceCollected`: a recurring animal yield was gathered and measured
  • `seasonClosed`: a crop season ended with its harvest accounted

Projections

  • `cropCalendar`: seasons and operations on a time axis per field; omits produce buyers and prices
  • `holdingRegisterView`: the farm, fields and herds as a registry entry; omits operational detail
  • `provenancePassport`: origin, operations and grades of a lot for its buyer; omits the rest of the holding