update

docs/specialists/fashionist.md

@@ -0,0 +1,43 @@
+# Fashionist
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Common |
+| Category | Civic |
+| Slot Type | Specialist |
+| Scope | Residences in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Prestige from Tunics | Residence | +1 | Radius-based (if supplied) |
+
+## Improves Buildings
+
+- Residence (Albion)
+- Residence (Latium)
+
+## Related Goods
+
+- Tunics
+
+## Source
+
+Latium traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium to boost Prestige from Tunics by +1 for all residences within the building's area of influence. Only effective when residences are supplied with Tunics.
+
+## Common Pitfalls
+
+Effect is conditional on Tunics supply; residences not receiving Tunics will not benefit from the Prestige bonus. Ensure Tunics production chain is established before relying on this specialist.

docs/specialists/laconic-swordsmith.md

@@ -0,0 +1,43 @@
+# Laconic Swordsmith
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Rare |
+| Category | Military |
+| Slot Type | Specialist |
+| Scope | Weapons Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Weapons Chain | +20% | Radius-based |
+
+## Improves Buildings
+
+- Iron Mine (Albion)
+- Iron Mine (Latium)
+- Furnace (Albion)
+- Furnace (Latium)
+- Weaponsmith (Albion)
+- Weaponsmith (Latium)
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium that covers Iron Mines, Furnaces, and Weaponsmiths to boost the entire weapons production chain productivity by 20%. Ideal for military-focused layouts where weapons production is a priority.
+
+## Common Pitfalls
+
+Only affects buildings within the radius of the building where the specialist is placed. Ensure all parts of the weapons chain (Iron Mine, Furnace, Weaponsmith) are within range to maximize the benefit.

docs/specialists/lamellar-armour-master.md

@@ -0,0 +1,49 @@
+# Lamellar Armour Master
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Rare |
+| Category | Military |
+| Slot Type | Specialist |
+| Scope | Armour Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Armour Chain | +20% | Radius-based |
+
+## Improves Buildings
+
+- Iron Mine (Albion)
+- Iron Mine (Latium)
+- Tannery (Albion)
+- Tannery (Latium)
+- Woodcutter (Albion)
+- Furnace (Albion)
+- Furnace (Latium)
+- Armourer (Albion)
+- Armourer (Latium)
+- Salt Ponds (Latium)
+- Pig Farm (Albion)
+- Pig Farm (Latium)
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium to boost productivity of all buildings in the armour production chain by 20%. Affects the entire supply chain from raw materials (iron ore, leather, wood, salt, pigs) through to final armour production.
+
+## Common Pitfalls
+
+Only affects buildings within the radius of the building where the specialist is placed. Since it targets the full armour chain, optimal placement should cover as many chain buildings as possible.

docs/specialists/lygos-exakion-architectus-eparchus.md

@@ -0,0 +1,40 @@
+# Lygos Exakion, Architectus Eparchus
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Military |
+| Slot Type | Specialist |
+| Scope | Gates in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Ranged Offence | Gates | +1 | Radius-based |
+| Attack Speed | Gates | +25% | Radius-based |
+| Hitpoints | Gates | +40% | Radius-based |
+
+## Improves Buildings
+
+- Gates
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium to significantly enhance gate defensive capabilities within range. The combination of increased ranged offence, faster attack speed, and substantially higher hitpoints makes gates much more formidable defensive structures.
+
+## Common Pitfalls
+
+Only affects gates within the area of influence; ensure gates are positioned within range of the Governor Villa or Officium containing this specialist.

docs/specialists/marix-who-knows-the-merrows.md

@@ -0,0 +1,41 @@
+# Marix, Who Knows The Merrows
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Research |
+| Slot Type | Specialist |
+| Scope | Mirrors Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Mirrors Chain | +35% | Radius-based |
+
+## Improves Buildings
+
+- Shell Gatherer (Albion)
+- Narcissium (Albion)
+- Silver Mine (Albion)
+- Silver Forge (Albion)
+
+## Source
+
+Corvinus
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium covering Mirrors production chain buildings in Albion to boost their productivity by +35%. The effect applies to all buildings in the Mirrors production chain within range.
+
+## Common Pitfalls
+
+Only affects Mirrors chain buildings; ensure the specialist is placed in a building whose area of influence covers the target production facilities.

docs/specialists/maxima-cottius-upholsterer-of-atlas.md

@@ -0,0 +1,44 @@
+# Maxima Cottius, Upholsterer of Atlas
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Culture |
+| Slot Type | Specialist |
+| Scope | Loungers Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Loungers Chain | +35% | Radius-based |
+
+## Improves Buildings
+
+- Dye Works (Latium)
+- Chair Maker (Latium)
+- Cushion Stuffer (Latium)
+- Sandarac Nursery (Latium)
+- Sheep Farm (Albion)
+- Sheep Farm (Latium)
+- Snailery (Latium)
+
+## Source
+
+Latium Traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium to boost productivity of all Loungers production chain buildings within the area of influence by +35%. This specialist affects the entire chain from raw materials (Sheep Farms, Snaileries, Sandarac Nursery) through processing (Dye Works, Cushion Stuffer) to finished products (Chair Maker).
+
+## Common Pitfalls
+
+The +35% productivity bonus only applies to buildings within the specialist's area of influence. Ensure all relevant Loungers chain buildings are positioned within range of the Governor Villa or Officium where this specialist is placed. Buildings outside the radius receive no benefit.

docs/specialists/mellarius.md

@@ -0,0 +1,41 @@
+# Mellarius
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Common |
+| Category | Research |
+| Slot Type | Specialist |
+| Scope | Wax Tablets Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Wax Tablets Chain | +10% | Radius-based |
+
+## Improves Buildings
+
+- Apiary (Albion)
+- Apiary (Latium)
+- Sandarac Nursery (Latium)
+- Tabulus (Latium)
+
+## Source
+
+Latium traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium that covers your Wax Tablets production chain buildings. All Apiaries, Sandarac Nurseries, and Tabulus buildings within range receive a +10% productivity bonus.
+
+## Common Pitfalls
+
+Only affects buildings in the Wax Tablets production chain; buildings outside the area of influence receive no benefit. Position carefully to maximize coverage of all chain buildings.

docs/specialists/mercurial-marketeer.md

@@ -0,0 +1,38 @@
+# Mercurial Marketeer
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Rare |
+| Category | Economic |
+| Slot Type | Specialist |
+| Scope | Mercator Residence in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Workforce from residents | Mercator Residence | +15% | Radius-based |
+
+## Improves Buildings
+
+- Residence (Albion)
+
+## Source
+
+Albion traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium covering Mercator residences to boost workforce output by +15% per residence in range. Ideal for maximizing workforce from high-tier Albion population.
+
+## Common Pitfalls
+
+Only affects Mercator residences; placing near lower-tier residences (Waders, Smiths, Elders) provides no benefit. Ensure the building's radius covers Mercator housing districts.

docs/specialists/nero-vulius-fama-pastoralist-pastor.md

@@ -0,0 +1,42 @@
+# Nero Vulius Fama, Pastoralist Pastor
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Economic |
+| Slot Type | Specialist |
+| Scope | Snailery, Sheep Farm, Pig Farm in Latium in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Workforce needed | Snailery, Sheep Farm, Pig Farm | -35% | Radius-based |
+| Upkeep cost | Snailery, Sheep Farm, Pig Farm | -80% | Radius-based |
+| Change of workforce type | Snailery, Sheep Farm, Pig Farm | Equites instead of Libertus | Radius-based |
+
+## Improves Buildings
+
+- Sheep Farm (Latium)
+- Snailery (Latium)
+- Pig Farm (Latium)
+
+## Source
+
+Latium traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium covering animal husbandry operations in Latium. The combination of -35% workforce and -80% upkeep makes this specialist extremely cost-effective for livestock farms. The workforce change from Libertus to Equites can help balance population tier requirements.
+
+## Common Pitfalls
+
+Only affects buildings in Latium; ensure your Sheep Farms, Snaileries, and Pig Farms are within the radius. The workforce type change to Equites may require you to have sufficient Equites population available.

docs/specialists/netter.md

@@ -0,0 +1,38 @@
+# Netter (Netzangler)
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Common |
+| Category | Economic |
+| Slot Type | Specialist |
+| Scope | Sardines Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Sardines Chain | +10% | Radius-based |
+
+## Improves Buildings
+
+- Fishing Hut (Latium)
+
+## Source
+
+Latium Traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium covering Sardines Chain buildings to boost productivity by 10%.
+
+## Common Pitfalls
+
+Only affects Sardines Chain buildings (Fishing Hut) within the area of influence.

docs/specialists/nomadic-herder.md

@@ -0,0 +1,45 @@
+# Nomadic Herder
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Rare |
+| Category | Nature |
+| Slot Type | Specialist |
+| Scope | Livestock Farms in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Workforce needed | Livestock Farms | -33% | Radius-based |
+| Upkeep cost | Livestock Farms | -66% | Radius-based |
+
+## Improves Buildings
+
+- Ox Farm (Albion)
+- Horse Breeder (Albion)
+- Horse Breeder (Latium)
+- Sheep Farm (Albion)
+- Sheep Farm (Latium)
+- Pig Farm (Albion)
+- Pig Farm (Latium)
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium covering livestock farms to significantly reduce both workforce requirements (-33%) and upkeep costs (-66%). This specialist is particularly valuable for large-scale animal husbandry operations spanning both Albion and Latium regions.
+
+## Common Pitfalls
+
+Only affects Livestock Farm category buildings (Ox Farm, Horse Breeders, Sheep Farms, Pig Farms) within the area of influence. Does not affect other agricultural buildings like crop farms or fishing operations.

docs/specialists/obtorquist.md

@@ -0,0 +1,39 @@
+# Obtorquist
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Common |
+| Category | Civic |
+| Slot Type | Specialist |
+| Scope | Torcs Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Torcs Chain buildings | +10% | Radius-based |
+
+## Improves Buildings
+
+- Wire-Twister (Albion)
+- Copper Mine (Albion)
+
+## Source
+
+Albion traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium to boost productivity of Torcs Chain buildings (Wire-Twister, Copper Mine) by +10% within the area of influence.
+
+## Common Pitfalls
+
+Only affects Torcs Chain production buildings within range; ensure proper placement near Wire-Twister and Copper Mine clusters in Albion.

docs/specialists/optio-principalis-nico-capturer-of-motion.md

@@ -0,0 +1,46 @@
+# Optio Principalis Nico, Capturer of Motion (Optio Principalis Nico, Einfanger von Bewegungen)
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Legendary |
+| Category | Military |
+| Slot Type | Specialist |
+| Scope | Towers and Stone Gates in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Attack Range | Towers and Stone Gates | +10% | Radius-based |
+| Ranged Offence | Towers and Stone Gates | +1 | Radius-based |
+| Attack Speed | Towers and Stone Gates | +35% | Radius-based |
+| Hitpoints | Towers and Stone Gates | +25% | Radius-based |
+
+## Boost Unlock
+
+Generate at least 800 Happiness.
+
+## Improves Buildings
+
+- Towers
+- Stone Gates
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium to buff all Towers and Stone Gates within its area of influence. The +35% attack speed combined with +10% attack range makes defensive structures significantly more effective at eliminating threats before they reach your walls. The +25% hitpoints bonus also makes these structures more durable.
+
+## Common Pitfalls
+
+Misplaced radius leads to zero value; only affects Towers and Stone Gates in range. Plan your defensive perimeter layout carefully to ensure the Governor Villa or Officium coverage overlaps with your key defensive structures. The legendary boost requires 800 Happiness, so ensure you have adequate population happiness before expecting full benefits.

docs/specialists/palaephaesta-dextrous-demiurgus.md

@@ -0,0 +1,45 @@
+# Palaephaesta, Dextrous Demiurgus
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Culture |
+| Slot Type | Specialist |
+| Scope | Artisanal Studios in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Workforce needed | Artisanal Studios | -40% | Radius-based |
+| Upkeep cost | Artisanal Studios | -80% | Radius-based |
+
+## Improves Buildings
+
+- Beaver Hatter (Albion)
+- Wire-Twister (Albion)
+- Fibularium (Albion)
+- Glassblower (Latium)
+- Jeweller (Latium)
+- Narcissium (Albion)
+- Pileus Felter (Latium)
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium covering Artisanal Studios to significantly reduce workforce requirements by 40% and upkeep costs by 80%. This specialist is excellent for optimizing luxury goods production chains, particularly useful in late-game economies where upkeep costs become a major expense.
+
+## Common Pitfalls
+
+Only affects Artisanal Studios within the radius of the building where the specialist is placed. Buildings outside the area of influence will not receive the workforce and upkeep reductions.

docs/specialists/plebeian-praepositus.md

@@ -0,0 +1,38 @@
+# Plebeian Praepositus
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Rare |
+| Category | Economic |
+| Slot Type | Specialist |
+| Scope | Plebeian Residences in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Workforce from residents | Plebeian Residence | +15% | Radius-based |
+
+## Improves Buildings
+
+- Residence (Latium)
+
+## Source
+
+Latium traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium covering Plebeian residences to boost workforce output from those residences by +15%. Ideal for densely packed residential areas where you want to maximize workforce without expanding housing footprint.
+
+## Common Pitfalls
+
+Only affects Plebeian Residences specifically within the radius of effect; other residence types (Patrician, etc.) are not boosted. Misplaced radius leads to zero value.

docs/specialists/practicing-healer.md

@@ -0,0 +1,39 @@
+# Practicing Healer
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Common |
+| Category | Nature |
+| Slot Type | Specialist |
+| Scope | Medici in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Available patrols | Medici | +1 | Radius-based |
+
+## Improves Buildings
+
+- Medici (Albion)
+- Medici (Latium)
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a villa or officium covering Medici buildings to increase available patrols by +1. This allows the Medici to serve more residences within its range.
+
+## Common Pitfalls
+
+Only affects Medici within the building's radius; misplaced coverage means no benefit. Ensure the specialist is slotted in a building whose area of influence covers the target Medici.

docs/specialists/pragmatic-aegis.md

@@ -0,0 +1,42 @@
+# Pragmatic Aegis
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Rare |
+| Category | Civic |
+| Slot Type | Specialist |
+| Scope | Clan Shields Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Clan Shields Chain | +20% | Radius-based |
+
+## Improves Buildings
+
+- Bronze Smelter (Albion)
+- Weld Crop (Albion)
+- Copper Mine (Albion)
+- Shieldbeater (Albion)
+- Tin Mine (Albion)
+
+## Source
+
+Manx
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium to boost productivity of Clan Shields production chain buildings within range by +20%. Covers the entire chain from raw materials (Copper Mine, Tin Mine) through processing (Bronze Smelter, Weld Crop) to final production (Shieldbeater).
+
+## Common Pitfalls
+
+Only affects Albion region buildings; ensure all Clan Shields chain buildings are within the area of influence for maximum benefit.

docs/specialists/prefect-of-oxen.md

@@ -0,0 +1,40 @@
+# Prefect of Oxen
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Rare |
+| Category | Economic |
+| Slot Type | Specialist |
+| Scope | Roast Beef Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Roast Beef Chain | +20% | Radius-based |
+
+## Improves Buildings
+
+- Earth Oven (Albion)
+- Ox Farm (Albion)
+- Saltwort Picker (Albion)
+
+## Source
+
+Valeria
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium to boost productivity of Roast Beef production chain buildings by +20% within the area of influence. Ideal for Albion settlements with concentrated Roast Beef production.
+
+## Common Pitfalls
+
+Only affects buildings within the radius of influence; ensure all three building types (Earth Oven, Ox Farm, Saltwort Picker) are within range to maximize the productivity bonus across the entire production chain.

docs/specialists/prime-mantler.md

@@ -0,0 +1,43 @@
+# Prime Mantler
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Rare |
+| Category | Nature |
+| Slot Type | Specialist |
+| Scope | Cloaks Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Cloaks Chain | +20% | Radius-based |
+
+## Improves Buildings
+
+- Birrus Stitcher (Albion)
+- Weld Crop (Albion)
+- Greenhands (Albion)
+- Copper Mine (Albion)
+- Sheep Farm (Albion)
+- Sheep Farm (Latium)
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium to boost productivity of all Cloaks production chain buildings within range by +20%. Covers the entire chain from raw materials (Sheep Farm, Copper Mine) through processing (Greenhands, Weld Crop) to final production (Birrus Stitcher).
+
+## Common Pitfalls
+
+Only affects buildings within the area of influence; ensure all Cloaks chain buildings are clustered within range of the placement building. Does not affect buildings outside the chain even if they share similar resource types.

docs/specialists/shell-collector.md

@@ -0,0 +1,38 @@
+# Shell Collector
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Common |
+| Category | Culture |
+| Slot Type | Specialist |
+| Scope | Cockles Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Cockles Chain | +10% | Radius-based |
+
+## Improves Buildings
+
+- Cockle Picker (Albion)
+
+## Source
+
+Albion traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium covering Cockle Picker buildings to boost their productivity by +10%. Best positioned to cover multiple Cockle Pickers to maximize the productivity bonus.
+
+## Common Pitfalls
+
+Only affects Cockle Picker buildings within the building's area of influence; ensure proper placement to cover your cockles production chain.