updates data

docs/specialists/aisling-sidhbe-of-the-wind-folk.md

@@ -1,4 +1,4 @@
-# Aisling Sidhbe, of the Wind Folk (Aisling Sidhbe, vom Windvolk)
+# Aisling Sidhbe of the Wind Folk (Aisling Sidhbe, vom Windvolk)
 
 **Entity Type:** Specialist
 
@@ -20,4 +20,4 @@
 - Ships
 
 ## Source
-Unknown
+All traders

docs/specialists/boar-whisperer.md

@@ -0,0 +1,39 @@
+# Boar Whisperer
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Culture |
+| Slot Type | Specialist |
+| Scope | Sausages Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Sausages Chain | +35% | Radius-based |
+
+## Improves Buildings
+
+- Herb Garden (Albion)
+- Salsicium (Albion)
+
+## Source
+
+Albion traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium covering Herb Gardens and Salsicium buildings to boost sausage production chain productivity by 35%.
+
+## Common Pitfalls
+
+Misplaced radius leads to zero value; only affects Sausages Chain buildings (Herb Garden, Salsicium) in range.

docs/specialists/dough-diviner.md

@@ -0,0 +1,43 @@
+# Dough Diviner (Teigwahrsager)
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Common |
+| Category | Economic |
+| Slot Type | Specialist |
+| Scope | Bread Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Bread Chain | +10% | Radius-based |
+
+## Improves Buildings
+
+- Bakery (Albion)
+- Bakery (Latium)
+- Donkey Mill (Albion)
+- Grain Mill (Latium)
+- Wheat Farm (Albion)
+- Wheat Farm (Latium)
+
+## Source
+
+All Traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium covering bread production buildings to boost productivity across the entire bread chain by 10%.
+
+## Common Pitfalls
+
+Only affects Bread Chain buildings within the area of influence. Ensure proper placement to maximize coverage of bakeries, mills, and wheat farms.

docs/specialists/entlaster.md

@@ -0,0 +1,23 @@
+# Unloader (Entlaster)
+
+**Entity Type:** Specialist
+
+## Properties
+| Field | Value |
+|-------|-------|
+| Rarity | Common |
+| Category | Finance |
+| Slot Type | Captain |
+| Scope | Ship |
+
+## Effects
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Trade Prices | Ship | -5% | Ship |
+| Cargo Weight Slowdown | Ship | -25% | Ship |
+
+## Improves Buildings
+- Ships
+
+## Source
+All traders

docs/specialists/farah-beruehmte-gesandte.md

@@ -0,0 +1,24 @@
+# Farah, Famous Envoy (Farah, beruehmte Gesandte)
+
+**Entity Type:** Specialist
+
+## Properties
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Seafaring |
+| Slot Type | Captain |
+| Scope | Affects ship |
+
+## Effects
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Discovery radius | Ship | +100% | Ship |
+| Goods transfer speed | Ship | +60% | Ship |
+| Travel speed between provinces | Ship | +30% | Ship |
+
+## Improves Buildings
+- Ships
+
+## Source
+Latium traders

docs/specialists/garantiegeberin.md

@@ -0,0 +1,23 @@
+# Warranty Giver (Garantiegeberin)
+
+**Entity Type:** Specialist
+
+## Properties
+| Field | Value |
+|-------|-------|
+| Rarity | Rare |
+| Category | Finance |
+| Slot Type | Captain |
+| Scope | Ship |
+
+## Effects
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Trade Prices | Ship | -10% | Ship |
+| Damage Slowdown | Ship | -30% | Ship |
+
+## Improves Buildings
+- Ships
+
+## Source
+All traders

docs/specialists/gastraphetus-ballistischer-held.md

@@ -0,0 +1,23 @@
+# Gastraphetus, Ballistic Hero (Gastraphetus, ballistischer Held)
+
+**Entity Type:** Specialist
+
+## Properties
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Military |
+| Slot Type | Captain |
+| Scope | Ship |
+
+## Effects
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Ship Scorpio Attack Range | Ship Scorpio | +25% | Ship |
+| Ship Scorpio Attack Speed | Ship Scorpio | +35% | Ship |
+
+## Improves Buildings
+- Ships
+
+## Source
+Valeria

docs/specialists/gigantulas-polyphemischer-kapitaen.md

@@ -0,0 +1,24 @@
+# Gigantulas, Polyphemic Captain (Gigantulas, polyphemischer Kapitän)
+
+**Entity Type:** Specialist
+
+## Properties
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Military |
+| Slot Type | Captain |
+| Scope | Ship |
+
+## Effects
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Hitpoints | Ship | +150% | Ship |
+| Self-repair speed | Ship | +200% | Ship |
+| Movement speed | Ship | -20% | Ship |
+
+## Improves Buildings
+- Ships
+
+## Source
+Unknown

docs/specialists/grape-stomper.md

@@ -0,0 +1,42 @@
+# Grape Stomper
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Rare |
+| Category | Religion |
+| Slot Type | Specialist |
+| Scope | Vintner and Wine Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Vintner and Wine Chain | +20% | Radius-based |
+
+## Improves Buildings
+
+- [Apiary (Albion)](../buildings/apiary-albion.md)
+- [Apiary (Latium)](../buildings/apiary-latium.md)
+- [Vineyard (Albion)](../buildings/vineyard-albion.md)
+- [Vintner (Albion)](../buildings/vintner-albion.md)
+- [Vintner (Latium)](../buildings/vintner-latium.md)
+
+## Source
+
+Latium Traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium covering wine production buildings to boost productivity by 20%.
+
+## Common Pitfalls
+
+Misplaced radius leads to zero value; only affects Vintner and Wine Chain buildings (Apiary, Vineyard, Vintner) in range.

docs/specialists/honer.md

@@ -25,3 +25,15 @@
 ## Source
 
 All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Equip on any ship to improve marksman performance. The +10% precision bonus helps marksmen hit more consistently, while the +1 attack value increases their damage output. Best suited for ships that rely on marksman combat rather than catapults or scorpions.
+
+## Common Pitfalls
+
+As a Common rarity captain item, the bonuses are modest. Players focused on ranged siege weapons (catapults, scorpions) may find other captain specialists more beneficial. Only affects the specific ship where equipped, not a fleet-wide buff.

docs/specialists/iosa-o-iona-hart-wie-diamant.md

@@ -0,0 +1,47 @@
+# Iosa O Iona, Hard as Diamond
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Legendary |
+| Category | Seafaring |
+| Slot Type | Captain |
+| Scope | Ship |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Hitpoints | Ship | +80% | Ship |
+| Self-repair speed | Ship | +150% | Ship |
+| Goods transfer speed | Ship | +75% | Ship |
+| Travel speed between provinces | Ship | +50% | Ship |
+
+## Boost Unlock
+
+At least 75 reputation with the Emperor.
+
+## Improves Buildings
+
+- Ships
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+This legendary captain specialist provides exceptional defensive and utility bonuses for ships. The massive +150% self-repair speed combined with +80% hitpoints makes ships significantly more durable in combat situations. The +75% goods transfer speed and +50% travel speed between provinces make this specialist ideal for trade ships that need to survive dangerous routes while maintaining high efficiency.
+
+## Common Pitfalls
+
+- Requires 75 reputation with the Emperor to unlock the boost effect
+- As a captain slot item, it competes with other powerful captain specialists
+- Best suited for ships that will engage in both combat and trade activities rather than pure combat vessels

docs/specialists/kapitaen-achab-von-miolmor.md

@@ -0,0 +1,46 @@
+# Kapitaen Achab von Miolmor
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Legendary |
+| Category | Seafaring |
+| Slot Type | Captain |
+| Scope | Ship |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Cargo Weight Slowdown | Ship | -80% | Ship |
+| Damage Slowdown | Ship | -90% | Ship |
+| Unfavourable Wind Impact | Ship | -100% | Ship |
+
+## Boost Unlock
+
+Requires: Own at least 15 trade routes.
+
+## Improves Buildings
+
+- Ships (Schiffe)
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+This legendary seafaring specialist is ideal for trade ships that need to maintain consistent speed regardless of conditions. The complete elimination of unfavorable wind impact (-100%) combined with massive reductions to cargo weight slowdown (-80%) and damage slowdown (-90%) makes this specialist exceptional for long-distance trade routes where speed consistency is critical. Place in a ship's captain slot to benefit from these effects.
+
+## Common Pitfalls
+
+- Forgetting to unlock the legendary boost by establishing at least 15 trade routes first
+- Using on ships that rarely encounter unfavorable wind conditions, wasting the wind impact bonus
+- Not prioritizing this specialist for your most important trade routes where speed matters most

docs/specialists/keincaled-die-zaehe.md

@@ -0,0 +1,47 @@
+# Keincaled, die Zaehe
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Legendary |
+| Category | Seafaring |
+| Slot Type | Captain |
+| Scope | Ship |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Upkeep cost | Ship | -60% | Ship |
+| Hitpoints | Ship | +90 | Ship |
+| Self-repair speed | Ship | +100 | Ship |
+| Damage slowdown | Ship | -80% | Ship |
+
+## Boost Unlock
+
+Minimum 20,000 fleet strength.
+
+## Improves Buildings
+
+- Ships (Schiffe)
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+This legendary seafaring specialist is ideal for ships that need to survive prolonged engagements or operate far from port. The combination of massively reduced upkeep costs (-60%), increased hitpoints (+90), doubled self-repair speed (+100), and greatly reduced damage slowdown (-80%) makes Keincaled an excellent choice for capital ships or long-range trading vessels that may encounter pirates.
+
+## Common Pitfalls
+
+- Requires 20,000 fleet strength to unlock the boost effect, so this specialist is not fully effective early game
+- As a captain slot specialist, cannot be combined with other captain specialists on the same ship
+- The self-repair bonus is most valuable on ships that take damage but survive; for glass cannon builds, other specialists may be more effective

docs/specialists/kreuzer.md

@@ -0,0 +1,41 @@
+# Kreuzer
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Common |
+| Category | Seafaring |
+| Slot Type | Captain |
+| Scope | Ship |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Movement speed | Ship | +5% | Ship |
+| Favourable wind angle | Ship | +25 | Ship |
+
+## Improves Buildings
+
+- Ships (Schiffe)
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Kreuzer is a common Seafaring specialist that improves ship mobility. The movement speed bonus helps ships travel faster across the map, while the favourable wind angle bonus allows ships to sail more efficiently against the wind. Place this specialist in a ship's captain slot to benefit from these bonuses.
+
+## Common Pitfalls
+
+- As a common specialist, the bonuses are relatively modest compared to higher rarity alternatives
+- Only affects the ship it is placed on, not fleet-wide
+- The favourable wind angle bonus is most useful for routes that frequently require sailing against prevailing winds

docs/specialists/lars-farsuleius-windflinker-hafenarbeiter.md

@@ -0,0 +1,42 @@
+# Lars Farsuleius, Wind-Swift Dockworker
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Seafaring |
+| Slot Type | Captain |
+| Scope | Ship |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Movement Speed | Ship | +10% | Ship |
+| Cargo Weight Slowdown | Ship | -50% | Ship |
+| Travel Speed Between Provinces | Ship | +25% | Ship |
+
+## Improves Buildings
+
+- Ships (Schiffe)
+
+## Source
+
+Unknown
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Lars Farsuleius is a seafaring specialist designed to enhance ship performance. Place him in a Captain slot on ships to significantly boost movement speed, reduce the impact of cargo weight on ship speed, and increase travel speed between provinces. This combination makes him ideal for trade ships that need to move large amounts of cargo quickly across the map.
+
+## Common Pitfalls
+
+- Only works when placed in a Captain slot on ships
+- The cargo weight slowdown reduction (-50%) only matters when ships are carrying heavy loads
+- Ensure you have other specialists for combat ships since this specialist focuses on speed and logistics rather than combat effectiveness

docs/specialists/magnus-pompeiuns-magnus-princeps-nauarchus-maximus.md

@@ -0,0 +1,47 @@
+# Magnus Pompeiuns Magnus, Princeps Nauarchus Maximus
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Legendary |
+| Category | Military |
+| Slot Type | Captain |
+| Scope | Ship |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Ship Catapult Precision | Ship | +25% | Ship |
+| Ship Catapult Attack Range | Ship | +20% | Ship |
+| Ship Catapult Ranged Attack | Ship | +30 | Ship |
+| Ship Catapult Attack Speed | Ship | +40% | Ship |
+
+## Boost Unlock
+
+Generate at least 5,000 income.
+
+## Improves Buildings
+
+- Ships
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+This legendary captain specialist dramatically enhances ship catapult performance. Place on warships equipped with catapults to maximize ranged naval combat effectiveness. The combination of increased precision, range, damage, and attack speed makes this specialist ideal for ships engaging in long-range artillery battles.
+
+## Common Pitfalls
+
+- Only effective on ships with catapults installed; wasted on ships without catapult weapons
+- Must be placed in a Captain slot, not a general specialist slot
+- Boost requires reaching 5,000 income threshold before legendary effects activate

docs/specialists/marinus-of-sidon-medidian-kartograph.md

@@ -0,0 +1,47 @@
+# Marinus of Sidon, Medidian Kartograph
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Legendary |
+| Category | Seafaring |
+| Slot Type | Captain |
+| Scope | Ship |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Discovery radius | Ship | +150% | Ship |
+| Movement speed | Ship | +10% | Ship |
+| Bad wind influence | Ship | -70% | Ship |
+| Travel speed between provinces | Ship | +40% | Ship |
+
+## Boost Unlock
+
+Discover at least 16 islands.
+
+## Improves Buildings
+
+- Ships
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+This legendary seafaring specialist is ideal for exploration and long-distance trade ships. The massive +150% discovery radius bonus makes it excellent for scouting new islands and revealing fog of war. The -70% bad wind influence and +40% travel speed between provinces significantly improve inter-province logistics. Place on ships that frequently travel between provinces or are assigned to exploration duties.
+
+## Common Pitfalls
+
+- Wasting this specialist on stationary or short-range ships that don't benefit from the exploration and travel bonuses
+- Not prioritizing the boost unlock (discovering 16 islands) to maximize the specialist's potential
+- Using on combat ships where other combat-focused specialists would provide more value

docs/specialists/measurer.md

@@ -1,8 +1,9 @@
-# Measurer (Vermesserin)
+# Measurer
 
 **Entity Type:** Specialist
 
 ## Properties
+
 | Field | Value |
 |-------|-------|
 | Rarity | Common |
@@ -11,12 +12,14 @@
 | Scope | Clothiers in range |
 
 ## Effects
+
 | Effect Type | Target | Value | Scope |
 |------------|--------|-------|-------|
 | Workforce needed | Clothiers | -25% | Area |
 | Upkeep cost | Clothiers | -50% | Area |
 
 ## Improves Buildings
+
 - Hosier (Albion)
 - Sandal Maker (Latium)
 - Shoe Weaver (Albion)
@@ -25,4 +28,17 @@
 - Loom Weavery (Latium)
 
 ## Source
+
 All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium covering textile production buildings to reduce workforce by 25% and upkeep costs by 50% for all Clothiers in range. Ideal for clusters of Spinners, Hosiers, or Loom Weaveries.
+
+## Common Pitfalls
+
+Only affects buildings within the placement building's area of influence; buildings outside the radius receive no benefit. Ensure all target Clothiers are within range before placement.

docs/specialists/menaechmus-parabeln-genie.md

@@ -0,0 +1,40 @@
+# Menaechmus, Parabeln-Genie
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Military |
+| Slot Type | Captain |
+| Scope | Affects ship |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Ship Catapult Precision | Ship | +20% | Ship |
+| Ship Catapult Attack Speed | Ship | +35% | Ship |
+
+## Improves Buildings
+
+- Ships (Schiffe)
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+This specialist is ideal for naval combat fleets that rely on catapult-equipped ships. Place Menaechmus on vessels with ship catapults to significantly boost both accuracy and rate of fire, making the ship more effective in naval engagements.
+
+## Common Pitfalls
+
+- This specialist only affects ships with catapults; placing on ships without catapult weapons provides no benefit
+- As a Captain slot specialist, cannot be combined with other Captain specialists on the same ship

docs/specialists/merypath-gromaticus-vermesser.md

@@ -0,0 +1,47 @@
+# Merypath, Gromatic Surveyor
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Unique |
+| Category | Seafaring |
+| Slot Type | Captain |
+| Scope | Affects ship |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Discovery radius | Ship | +100% | Ship |
+| Hitpoints | Ship | +25% | Ship |
+| Movement speed | Ship | +15% | Ship |
+| Favourable wind angle | Ship | +45 | Ship |
+
+## Boost Unlock
+
+Condition: Less than 5,000 fleet strength.
+
+## Improves Buildings
+
+- Ships (Schiffe)
+
+## Source
+
+Hall of Fame
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+This specialist is ideal for exploration and scouting ships. The massive +100% discovery radius bonus makes it excellent for revealing new areas of the map quickly. The combination of movement speed (+15%) and improved favourable wind angle (+45) ensures your exploration vessel can navigate efficiently in various wind conditions. The hitpoints bonus (+25%) provides additional survivability when venturing into unknown or hostile waters.
+
+## Common Pitfalls
+
+- This specialist requires a boost unlock condition of less than 5,000 fleet strength, which may conflict with military fleet-building strategies. Plan your fleet composition accordingly.
+- The effects only apply to the ship the captain is assigned to, not to your entire fleet.
+- Since it's a Captain slot item, it competes with combat-oriented captains; consider dedicating a specific exploration vessel for this specialist rather than using it on combat ships.

docs/specialists/mudlark.md

@@ -0,0 +1,38 @@
+# Mudlark (Schlammsucherin)
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Common |
+| Category | Economic |
+| Slot Type | Specialist |
+| Scope | Eel Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Eel Chain | +10% | Radius-based |
+
+## Improves Buildings
+
+- Eel Grabber (Albion)
+
+## Source
+
+Albion Traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium covering Eel Chain buildings to boost productivity by 10%.
+
+## Common Pitfalls
+
+Only affects Eel Chain buildings (Eel Grabber) within the area of influence. Ensure the specialist is placed in a building whose radius covers your eel production facilities.

docs/specialists/naomh-og-die-wellenreiterin.md

@@ -0,0 +1,42 @@
+# Naomh Og, die Wellenreiterin
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Seafaring |
+| Slot Type | Captain |
+| Scope | Ship |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Hitpoints | Ship | +65% | Ship |
+| Self-repair speed | Ship | +150% | Ship |
+| Movement speed | Ship | +15% | Ship |
+
+## Improves Buildings
+
+- Ships (Schiffe)
+
+## Source
+
+Unknown
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+This specialist is ideal for enhancing ship survivability and speed. The substantial +150% self-repair speed bonus significantly reduces downtime after naval engagements, while the +65% hitpoints boost makes ships considerably more durable. The +15% movement speed bonus helps with both exploration and escaping dangerous encounters.
+
+## Common Pitfalls
+
+- This is a Captain slot specialist, meaning it must be placed directly on a ship rather than in a Governor Villa or Officium
+- The effects only apply to the specific ship this specialist is assigned to
+- Self-repair speed bonus is most valuable for ships that engage in combat frequently; for pure trading vessels, other specialists may provide more utility

docs/specialists/primus-tremellius-valens-of-towering-ivory.md

@@ -0,0 +1,40 @@
+# Primus Tremellius Valens, of Towering Ivory
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Economic |
+| Slot Type | Specialist |
+| Scope | Towers in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Workforce needed | Towers | -35% | Radius-based |
+| Upkeep cost | Towers | -80% | Radius-based |
+| Change of workforce type | Towers | Run by Equites Workforce, instead of Libertus Workforce | Radius-based |
+
+## Improves Buildings
+
+- Towers
+
+## Source
+
+Latium traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium covering tower defenses to reduce workforce needs by 35%, slash upkeep by 80%, and switch the workforce type from Libertus to Equites. This makes towers far more economical and shifts the labor burden to a different population tier.
+
+## Common Pitfalls
+
+Misplaced radius leads to zero value; only affects Towers in range. Ensure you have sufficient Equites workforce available before applying this specialist, as the workforce type change means Libertus workers will no longer be used for affected towers.

docs/specialists/prince-of-porphyry.md

@@ -0,0 +1,42 @@
+# Prince of Porphyry
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Rare |
+| Category | Civic |
+| Slot Type | Specialist |
+| Scope | Togas Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Togas Chain buildings | +20% | Radius-based |
+
+## Improves Buildings
+
+- Dye Works (Latium)
+- Flax Farm (Albion)
+- Flax Farm (Latium)
+- Snailery (Latium)
+- Loom Weavery (Latium)
+
+## Source
+
+Diana
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium covering Togas production chain buildings to boost productivity by +20%. Affects the entire Togas chain including flax farms, snaileries, dye works, and loom weaveries.
+
+## Common Pitfalls
+
+Misplaced radius leads to zero value; only affects Togas chain buildings within range. Buildings must be within the area of influence of the Governor Villa or Officium where the specialist is placed.

docs/specialists/publius-aelius-adrian-balustrian-builder.md

@@ -0,0 +1,43 @@
+# Publius Aelius Adrian, Balustrian Builder (Publius Aelius Adrian, balustrischer Baumeister)
+
+**Entity Type:** Specialist
+
+## Properties
+| Field | Value |
+|-------|-------|
+| Rarity | Legendary |
+| Category | Military |
+| Slot Type | Specialist |
+| Scope | Walls and Gates in range |
+
+## Effects
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Workforce needed | Walls and Gates | -25% | Area |
+| Hitpoints | Walls and Gates | +40% | Area |
+| Self-repair speed | Walls and Gates | +100% | Area |
+
+## Boost Unlock
+Have at least 100 Wall Blocks on your island.
+
+## Improves Buildings
+- Gates
+- Walls
+
+## Source
+All traders
+
+## Stack Rules
+- Standard specialist stacking rules apply
+- Place in a Governor Villa or Officium to affect buildings in area of influence
+
+## Usage Patterns
+- Ideal for fortified settlements with extensive wall networks
+- Reduces workforce requirements for wall maintenance by 25%
+- Significantly improves wall durability with +40% hitpoints
+- Doubles self-repair speed, reducing downtime after attacks
+
+## Common Pitfalls
+- Requires 100 Wall Blocks on the island to unlock legendary boost
+- Only affects Walls and Gates within the Governor Villa or Officium influence area
+- Does not affect other defensive structures like towers

docs/specialists/reangler.md

@@ -21,4 +21,19 @@
 - Scomber's Shack
 
 ## Source
+
 Latium traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Villa or Officium covering Fishing Huts and Scomber's Shacks to reduce workforce requirements by 25% and switch the workforce type from Liberti to Plebeians. This is useful when you have more Plebeian workers available than Liberti.
+
+## Common Pitfalls
+
+- Only affects Fishing Hut and Scomber's Shack buildings within the area of influence
+- The workforce type change means these buildings will compete with other Plebeian-using buildings for workers
+- Ensure you have sufficient Plebeian workforce before applying this specialist

docs/specialists/renaturizer.md

@@ -0,0 +1,42 @@
+# Renaturizer (Renaturierer)
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Common |
+| Category | Economic |
+| Slot Type | Specialist |
+| Scope | Herb Garden and Barley Farm in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Workforce Needed | Herb Garden, Barley Farm | -25% | Radius-based |
+| Workforce Type Change | Herb Garden, Barley Farm | Smiths instead of Waders | Radius-based |
+
+## Improves Buildings
+
+- Barley Farm (Albion)
+- Herb Garden (Albion)
+
+## Source
+
+Albion Traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Villa or Officium covering Herb Gardens and Barley Farms to reduce workforce requirements by 25% and change the workforce type from Waders to Smiths. This is particularly useful when you have excess Smiths workforce but are short on Waders.
+
+## Common Pitfalls
+
+- Only affects Herb Garden and Barley Farm buildings within the area of influence
+- Misplaced radius leads to zero value if target buildings are not in range
+- Changing workforce type may cause issues if you have limited Smiths population

docs/specialists/reunionist.md

@@ -3,22 +3,38 @@
 **Entity Type:** Specialist
 
 ## Properties
+
 | Field | Value |
 |-------|-------|
 | Rarity | Common |
 | Category | Economic |
 | Slot Type | Specialist |
-| Scope | Area (Oat Farm, Olive Grower in range) |
+| Scope | Oat Farm, Olive Grower in range |
 
 ## Effects
+
 | Effect Type | Target | Value | Scope |
 |------------|--------|-------|-------|
-| Workforce needed | Oat Farm, Olive Grower | -25% | Area |
+| Workforce needed | Oat Farm, Olive Grower | -25% | Radius-based |
-| Change of workforce type | Oat Farm, Olive Grower | Plebeian instead of Liberti | Area |
+| Change of workforce type | Oat Farm, Olive Grower | Plebeian instead of Libertus | Radius-based |
 
 ## Improves Buildings
-- Oat Farm
+
-- Olive Grower
+- Oat Farm (Latium)
+- Olive Grower (Latium)
 
 ## Source
+
 Latium traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Villa or Officium covering Oat Farms and Olive Growers to reduce workforce needs by 25% and change the workforce type from Libertus to Plebeian.
+
+## Common Pitfalls
+
+Only affects Oat Farm and Olive Grower buildings within the area of influence.

docs/specialists/sailor.md

@@ -0,0 +1,41 @@
+# Sailor (Segler)
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Common |
+| Category | Economic |
+| Slot Type | Specialist |
+| Scope | Sailmaker and Sails Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Sailmaker and Sails Chain | +10% | Radius-based |
+
+## Improves Buildings
+
+- Hemp Farm (Albion)
+- Hemp Farm (Latium)
+- Sailmaker (Albion)
+- Sailmaker (Latium)
+
+## Source
+
+All Traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Villa or Officium covering Hemp Farms and Sailmakers to boost productivity of the entire Sails production chain by 10%.
+
+## Common Pitfalls
+
+Only affects Sailmaker and Sails Chain buildings (Hemp Farms, Sailmakers) within the area of influence.

docs/specialists/sceilg-eremitscher-reduktionist.md

@@ -7,22 +7,21 @@
 | Field | Value |
 |-------|-------|
 | Rarity | Legendary |
-| Category | Economy |
+| Category | Economic |
 | Slot Type | Specialist |
-| Scope | Forest Lodge in range |
+| Scope | Forest Camps in range |
 
 ## Effects
 
 | Effect Type | Target | Value | Scope |
 |------------|--------|-------|-------|
-| Productivity | Forest Lodge | +30% | Radius-based |
+| Productivity | Forest Camps | +30% | Area |
-| Required Area | Forest Lodge | -30% | Radius-based |
+| Required Area | Forest Camps | -30% | Area |
-| Bonus Goods | Forest Lodge | +1t every 10 cycles | Radius-based |
+| Additional output | Forest Camps | +1t every 10 cycles | Area |
 
-## Unlock Condition
+## Boost Unlock
 
-To unlock the legendary bonus, you must meet the following condition:
+Have less than 2,000 residents on your island.
-- Have fewer than 2,500 residents on the island.
 
 ## Improves Buildings
 
@@ -48,5 +47,5 @@ Slot into a Villa or Officium covering forest-based production buildings to sign
 
 ## Common Pitfalls
 
-- The unlock condition requires keeping island population below 2,500, which may conflict with expansion goals.
+- The unlock condition requires keeping island population below 2,000, which may conflict with expansion goals.
-- Misplaced radius leads to zero value; only affects Forest Lodge buildings in range.
+- Misplaced radius leads to zero value; only affects Forest Camp buildings in range.

docs/specialists/seamster.md

@@ -0,0 +1,41 @@
+# Seamster
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Common |
+| Category | Finance |
+| Slot Type | Specialist |
+| Scope | Tunics Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Tunics Chain | +10% | Radius-based |
+
+## Improves Buildings
+
+- Hemp Farm (Albion)
+- Hemp Farm (Latium)
+- Spinner (Albion)
+- Spinner (Latium)
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium to boost productivity of all Tunics Chain buildings within range by +10%. Useful for optimizing tunic production lines in both Albion and Latium regions.
+
+## Common Pitfalls
+
+Only affects buildings in the Tunics Chain production category; other production buildings will not benefit. Ensure the specialist's area of influence covers the target Hemp Farms and Spinners.

docs/specialists/senchaid-sciatharglan.md

@@ -1,4 +1,4 @@
-# Senchaid Sciatharglan, Embedded Weapon Shield
+# Senchaid Sciatharglan, Ensconced Escutcheon
 
 **Entity Type:** Specialist
 
@@ -15,26 +15,35 @@
 
 | Effect Type | Target | Value | Scope |
 |------------|--------|-------|-------|
-| Ranged Attack | Gates | +3 | Radius-based |
+| Ranged Offence | Gates | +3 | Radius-based |
-| Hit Points | Gates | +45% | Radius-based |
+| Hitpoints | Gates | +45% | Radius-based |
-| Self-Repair Speed | Gates | +80% | Radius-based |
+| Self-repair Speed | Gates | +80% | Radius-based |
 
-## Unlock Condition
+## Boost Unlock
 
-Wants to challenge the Emperor to combat.
+Wants to challenge the Emperor in combat.
+
+## Improves Buildings
+
+- Gates
 
 ## Source
 
-All Traders
+All traders
 
 ## Stack Rules
 
-Unknown
+Unknown - standard specialist stacking rules likely apply.
 
 ## Usage Patterns
 
-Slot into a Villa or Officium covering Gates to boost ranged attack, hit points, and self-repair speed of defensive structures.
+- Place in a Governor Villa or Officium with Gates in the area of influence
+- Significantly boosts gate survivability with +45% hitpoints and +80% self-repair speed
+- The +3 ranged offence allows gates to deal damage to approaching enemies
+- Ideal for fortified defensive positions around key chokepoints
 
 ## Common Pitfalls
 
-Misplaced radius leads to zero value; only affects Gates in range.
+- Only affects Gates within the area of influence - ensure proper placement of the Villa/Officium
+- No benefit if there are no Gates in range
+- The boost unlock condition requires challenging the Emperor, which may be a late-game or specific quest requirement

docs/specialists/stalwart-smith.md

@@ -0,0 +1,39 @@
+# Stalwart Smith
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Rare |
+| Category | Economic |
+| Slot Type | Specialist |
+| Scope | Smith Residence in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Workforce from residents | Residence | +30% | Radius-based (Smith Residence required) |
+
+## Improves Buildings
+
+- Residence (Albion)
+- Residence (Latium)
+
+## Source
+
+Albion traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium covering residences to boost workforce from residents by +30%. The effect requires a Smith Residence to be within the area of influence.
+
+## Common Pitfalls
+
+The effect only triggers when a Smith Residence is within the radius. Placing this specialist without nearby Smith Residences leads to zero value.

docs/specialists/tawer.md

@@ -1,21 +1,24 @@
-# Tawer (Weissgerberin)
+# Tawer
 
 **Entity Type:** Specialist
 
 ## Properties
+
 | Field | Value |
 |-------|-------|
 | Rarity | Common |
 | Category | Finance |
 | Slot Type | Specialist |
-| Scope | Area of Influence |
+| Scope | Sandals Chain in range |
 
 ## Effects
+
 | Effect Type | Target | Value | Scope |
 |------------|--------|-------|-------|
-| Productivity | Sandals Chain | +10% | In range |
+| Productivity | Sandals Chain | +10% | Radius-based |
 
 ## Improves Buildings
+
 - Tannery (Albion)
 - Tannery (Latium)
 - Sandal Maker (Latium)
@@ -23,4 +26,17 @@
 - Pig Farm (Latium)
 
 ## Source
+
 Latium traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium covering Sandals Chain buildings to boost productivity by +10% for all affected buildings in range.
+
+## Common Pitfalls
+
+Misplaced radius leads to zero value; only affects Sandals Chain buildings (Tannery, Sandal Maker, Pig Farm) within the building's area of influence.

docs/specialists/titus-faber-master-of-tasks.md

@@ -0,0 +1,39 @@
+# Titus Faber, Master of Tasks
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Economic |
+| Slot Type | Specialist |
+| Scope | Libertus Residence in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Workforce from residents | Residence | +25% | Radius-based |
+
+## Improves Buildings
+
+- Residence (Albion)
+- Residence (Latium)
+
+## Source
+
+Latium traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium covering Libertus residences to boost workforce output from residents by 25%. Particularly useful for increasing labor availability in densely populated residential areas.
+
+## Common Pitfalls
+
+Misplaced radius leads to zero value; only affects Libertus Residences in range. Ensure the specialist is placed in a building that provides adequate coverage over residential buildings.

docs/specialists/troucotouto-subjugating-subiudex.md

@@ -0,0 +1,44 @@
+# Troucotouto, Subjugating Subiudex
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Unique |
+| Category | Economic |
+| Slot Type | Specialist |
+| Scope | Liberti and Waders Residences in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Workforce from Residents | Residence | +30% | Radius-based |
+| Happiness | Residence | -1 | Radius-based |
+
+## Unlock Condition
+
+Respects Calidus and no one else.
+
+## Improves Buildings
+
+- Residence (Albion)
+- Residence (Latium)
+
+## Source
+
+Hall of Fame
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium covering Liberti or Waders residences to boost workforce output at the cost of reduced happiness.
+
+## Common Pitfalls
+
+The happiness penalty (-1) must be offset by other means such as public services or goods. Only affects Liberti and Waders residences within the area of influence.

docs/specialists/tullus-caecilius-cornutus-arval-brother-of-insitor.md

@@ -0,0 +1,46 @@
+# Tullus Caecilius Cornutus, Arval Brother of Insitor
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Nature |
+| Slot Type | Specialist |
+| Scope | Arable Farms in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Workforce needed | Arable Farms | -40% | Radius-based |
+| Upkeep cost | Arable Farms | -80% | Radius-based |
+
+## Improves Buildings
+
+- Flax Farm (Albion)
+- Flax Farm (Latium)
+- Barley Farm (Albion)
+- Oat Farm (Latium)
+- Hemp Farm (Albion)
+- Hemp Farm (Latium)
+- Wheat Farm (Albion)
+- Wheat Farm (Latium)
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium covering arable farm clusters to drastically reduce workforce requirements by 40% and upkeep costs by 80%. Ideal for large agricultural zones with multiple grain and fiber farms. The dual effect on both workforce and upkeep makes this one of the most economically impactful Nature specialists.
+
+## Common Pitfalls
+
+Only affects buildings in the "Arable Farms" category; orchards, vineyards, and animal farms are not included. Ensure the placement building's influence radius covers all target farms before slotting this specialist.

docs/specialists/twiner.md

@@ -0,0 +1,39 @@
+# Twiner (Verzwirnerin)
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Common |
+| Category | Economic |
+| Slot Type | Specialist |
+| Scope | Ropemaker and Ropes Chain in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Productivity | Ropemaker and Ropes Chain | +10% | Radius-based |
+
+## Improves Buildings
+
+- Ropemaker (Albion)
+- Ropemaker (Latium)
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Villa or Officium covering Ropemaker buildings to boost productivity by 10%. Useful for increasing rope production which is required for shipbuilding and other advanced production chains.
+
+## Common Pitfalls
+
+Only affects Ropemaker buildings (Albion and Latium variants) within the area of influence. Does not affect other production buildings in the chain such as Hemp Farms.

docs/specialists/uassoro-der-moorgeist.md

@@ -1,38 +0,0 @@
-# Uassoro, der Moorgeist
-
-**Entity Type:** Specialist
-
-## Properties
-
-| Field | Value |
-|-------|-------|
-| Rarity | Epic |
-| Category | Economy |
-| Slot Type | Specialist |
-| Scope | Waders in range |
-
-## Effects
-
-| Effect Type | Target | Value | Scope |
-|------------|--------|-------|-------|
-| Workforce from Residents | Residence | +25% | Radius-based |
-
-## Improves Buildings
-
-- Residence (Albion)
-
-## Source
-
-Albion Trader
-
-## Stack Rules
-
-Unknown
-
-## Usage Patterns
-
-Slot into a Villa or Officium covering Wader residences to boost workforce output from residents within range.
-
-## Common Pitfalls
-
-Misplaced radius leads to zero value; only affects Wader residential buildings in range.

docs/specialists/uassoro-neck-deep-wader.md

@@ -0,0 +1,38 @@
+# Uassoro, Neck-Deep Wader
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Epic |
+| Category | Economic |
+| Slot Type | Specialist |
+| Scope | Wader Residence in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Workforce from residents | Wader Residence | +25% | Radius-based |
+
+## Improves Buildings
+
+- Residence (Albion)
+
+## Source
+
+Albion traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium covering Wader residential areas to boost workforce output by 25% from residents within range.
+
+## Common Pitfalls
+
+Misplaced radius leads to zero value; only affects Wader Residence buildings in range.

docs/specialists/uesuca-of-the-holy-terroir.md

@@ -1,24 +1,40 @@
-# Uesuca, of the Holy Terroir (Uesuca aus dem Terrorterroir)
+# Uesuca, of the Holy Terroir
 
 **Entity Type:** Specialist
 
 ## Properties
+
 | Field | Value |
 |-------|-------|
 | Rarity | Epic |
 | Category | Civic |
 | Slot Type | Specialist |
-| Scope | Area (Residences in range) |
+| Scope | Residences in range |
 
 ## Effects
+
 | Effect Type | Target | Value | Scope |
 |------------|--------|-------|-------|
-| Prestige from Wine | Residences | +3 | Area (if supplied) |
+| Prestige from Wine | Residences | +3 | Radius-based (if supplied) |
 
 ## Improves Buildings
+
 - Residence (Albion)
 - Residence (Latium)
 - Wine
 
 ## Source
+
 Latium traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium to increase prestige from Wine by +3 for all residences in the area of influence. Only affects residences that are supplied with Wine.
+
+## Common Pitfalls
+
+Effect only triggers when residences are actually supplied with Wine; without Wine supply, the specialist provides no benefit.

docs/specialists/venator-of-artemis.md

@@ -3,6 +3,7 @@
 **Entity Type:** Specialist
 
 ## Properties
+
 | Field | Value |
 |-------|-------|
 | Rarity | Rare |
@@ -11,12 +12,14 @@
 | Scope | Hunting Cabins and Fisheries in range |
 
 ## Effects
+
 | Effect Type | Target | Value | Scope |
 |------------|--------|-------|-------|
 | Workforce needed | Hunting Cabins and Fisheries | -33% | Area |
 | Upkeep cost | Hunting Cabins and Fisheries | -66% | Area |
 
 ## Improves Buildings
+
 - Eel Grabber
 - Oyster Bed
 - Beaver Trapper
@@ -28,4 +31,17 @@
 - Bird Charmer
 
 ## Source
+
 All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a Governor Villa or Officium to reduce workforce and upkeep costs for all Hunting Cabins and Fisheries within the area of influence. The -33% workforce reduction frees up population for other buildings, while the substantial -66% upkeep cost reduction significantly improves profitability of fishing and hunting operations. Ideal for coastal settlements or regions with heavy reliance on fishing and hunting resources.
+
+## Common Pitfalls
+
+Only affects buildings within the area of influence of the Governor Villa or Officium where the specialist is placed. Ensure hunting cabins and fisheries are positioned within range to receive the benefits. As a Religion category specialist, it competes for slots with other religion-focused specialists. The effects do not stack across multiple Venator of Artemis specialists in overlapping areas.

docs/specialists/vengeful-villicus.md

@@ -0,0 +1,40 @@
+# Vengeful Villicus
+
+**Entity Type:** Specialist
+
+## Properties
+
+| Field | Value |
+|-------|-------|
+| Rarity | Rare |
+| Category | Military |
+| Slot Type | Specialist |
+| Scope | Gates in range |
+
+## Effects
+
+| Effect Type | Target | Value | Scope |
+|------------|--------|-------|-------|
+| Attack range | Gates | +25% | Radius-based |
+| Ranged offence | Gates | +1 | Radius-based |
+| Attack speed | Gates | +20% | Radius-based |
+
+## Improves Buildings
+
+- Gates
+
+## Source
+
+All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium near Gates to enhance their defensive capabilities with increased attack range, ranged offense, and attack speed. Ideal for fortifying entry points along walls.
+
+## Common Pitfalls
+
+Only affects Gates within the radius of the building where the specialist is placed. Ensure your Governor Villa or Officium covers all critical gate positions.

docs/specialists/vexillarius.md

@@ -20,4 +20,17 @@
 - Vigiles (Latium)
 
 ## Source
+
 All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Place in a villa or officium near Vigiles buildings to increase the number of available patrols by +1 per Vigiles station in range. Useful for expanding fire and security coverage across densely built areas.
+
+## Common Pitfalls
+
+Misplaced radius leads to zero value; only affects Vigiles buildings within the building's range. Ensure the specialist is slotted into a building whose area of influence overlaps with your Vigiles stations.

docs/specialists/watchful-villicus.md

@@ -20,4 +20,17 @@
 - Gates
 
 ## Source
-All traders
+
+All Traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium that covers Gates to boost their defensive capabilities with increased ranged offence and hitpoints. Ideal for fortifying chokepoints and city entrances.
+
+## Common Pitfalls
+
+Misplaced radius leads to zero value; only affects Gates within the area of influence.

docs/specialists/watchman.md

@@ -1,8 +1,9 @@
-# Watchman (Wachter)
+# Watchman
 
 **Entity Type:** Specialist
 
 ## Properties
+
 | Field | Value |
 |-------|-------|
 | Rarity | Common |
@@ -11,13 +12,28 @@
 | Scope | Custodes in range |
 
 ## Effects
+
 | Effect Type | Target | Value | Scope |
 |------------|--------|-------|-------|
 | Available patrols | Custodes | +1 | Custodes in range |
 
 ## Improves Buildings
+
 - Custodes (Albion)
 - Custodia (Latium)
 
 ## Source
+
 All traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a villa or officium to grant +1 available patrol to all Custodes buildings within range. Useful for expanding security coverage without building additional Custodes stations.
+
+## Common Pitfalls
+
+Ensure the villa/officium placement covers the Custodes buildings you want to affect; otherwise the patrol bonus will not apply.

docs/specialists/xeno-of-phillipopolis-hipparchon.md

@@ -1,8 +1,9 @@
-# Xeno of Phillipopolis, Hipparchon (Xeno von Phillipopolis, Hipparchon)
+# Xeno of Phillipopolis, Hipparchon
 
 **Entity Type:** Specialist
 
 ## Properties
+
 | Field | Value |
 |-------|-------|
 | Rarity | Epic |
@@ -11,13 +12,28 @@
 | Scope | Horses Chain in range |
 
 ## Effects
+
 | Effect Type | Target | Value | Scope |
 |------------|--------|-------|-------|
-| Productivity | Horses Chain | +35% | Area of influence |
+| Productivity | Horses Chain | +35% | Radius-based |
 
 ## Improves Buildings
+
 - Horse Breeder (Albion)
 - Horse Breeder (Latium)
 
 ## Source
+
 Latium traders
+
+## Stack Rules
+
+Unknown
+
+## Usage Patterns
+
+Slot into a Governor Villa or Officium covering Horse Breeder buildings to boost productivity by +35% for all Horses Chain buildings in range.
+
+## Common Pitfalls
+
+Misplaced radius leads to zero value; only affects Horses Chain buildings in range.

processed.md

@@ -32,85 +32,85 @@ When Claude processes a JSON file and adds its data to docs.md, mark it here.
 - [x] en_anno-117-specialists_praezisionistin.json
 - [x] en_anno-117-specialists_paullus-julius-frigoris-der-rastlose.json
 - [x] en_anno-117-specialists_osmuinn-tathlum-traegerin.json
-- [~] en_anno-117-specialists_naomh-og-die-wellenreiterin.json
+- [x] en_anno-117-specialists_naomh-og-die-wellenreiterin.json
-- [~] en_anno-117-specialists_merypath-gromaticus-vermesser.json
+- [x] en_anno-117-specialists_merypath-gromaticus-vermesser.json
-- [~] en_anno-117-specialists_menaechmus-parabeln-genie.json
+- [x] en_anno-117-specialists_menaechmus-parabeln-genie.json
-- [~] en_anno-117-specialists_marinus-of-sidon-medidian-kartograph.json
+- [x] en_anno-117-specialists_marinus-of-sidon-medidian-kartograph.json
-- [~] en_anno-117-specialists_magnus-pompeiuns-magnus-princeps-nauarchus-maximus.json
+- [x] en_anno-117-specialists_magnus-pompeiuns-magnus-princeps-nauarchus-maximus.json
-- [~] en_anno-117-specialists_lars-farsuleius-windflinker-hafenarbeiter.json
+- [x] en_anno-117-specialists_lars-farsuleius-windflinker-hafenarbeiter.json
-- [~] en_anno-117-specialists_kreuzer.json
+- [x] en_anno-117-specialists_kreuzer.json
-- [~] en_anno-117-specialists_keincaled-die-zaehe.json
+- [x] en_anno-117-specialists_keincaled-die-zaehe.json
-- [~] en_anno-117-specialists_kapitaen-achab-von-miolmor.json
+- [x] en_anno-117-specialists_kapitaen-achab-von-miolmor.json
-- [~] en_anno-117-specialists_iosa-o-iona-hart-wie-diamant.json
+- [x] en_anno-117-specialists_iosa-o-iona-hart-wie-diamant.json
-- [ ] en_anno-117-specialists_honer.json
+- [x] en_anno-117-specialists_honer.json
-- [ ] en_anno-117-specialists_gigantulas-polyphemischer-kapitaen.json
+- [x] en_anno-117-specialists_gigantulas-polyphemischer-kapitaen.json
-- [ ] en_anno-117-specialists_gastraphetus-ballistischer-held.json
+- [x] en_anno-117-specialists_gastraphetus-ballistischer-held.json
-- [ ] en_anno-117-specialists_garantiegeberin.json
+- [x] en_anno-117-specialists_garantiegeberin.json
-- [ ] en_anno-117-specialists_gan-ye-gesandte-von-haixi.json
+- [x] en_anno-117-specialists_gan-ye-gesandte-von-haixi.json
-- [ ] en_anno-117-specialists_flotte-bootsfrau.json
+- [x] en_anno-117-specialists_flotte-bootsfrau.json
-- [ ] en_anno-117-specialists_farah-beruehmte-gesandte.json
+- [x] en_anno-117-specialists_farah-beruehmte-gesandte.json
-- [ ] en_anno-117-specialists_even-keeler.json
+- [x] en_anno-117-specialists_even-keeler.json
-- [ ] en_anno-117-specialists_erquicker.json
+- [x] en_anno-117-specialists_erquicker.json
-- [ ] en_anno-117-specialists_entlaster.json
+- [x] en_anno-117-specialists_entlaster.json
-- [ ] en_anno-117-specialists_entfernungsmesser.json
+- [x] en_anno-117-specialists_entfernungsmesser.json
-- [ ] en_anno-117-specialists_eifriger-verlader.json
+- [x] en_anno-117-specialists_eifriger-verlader.json
-- [ ] en_anno-117-specialists_donnernder-blitzschleuderer.json
+- [x] en_anno-117-specialists_donnernder-blitzschleuderer.json
-- [ ] en_anno-117-specialists_deaglan-donnchadh-gaothoir-orga.json
+- [x] en_anno-117-specialists_deaglan-donnchadh-gaothoir-orga.json
-- [ ] en_anno-117-specialists_dacianus-erfolgreicher-taucher.json
+- [x] en_anno-117-specialists_dacianus-erfolgreicher-taucher.json
-- [ ] en_anno-117-specialists_cuillionn-ni-aife-ehemals-von-den-scathach.json
+- [x] en_anno-117-specialists_cuillionn-ni-aife-ehemals-von-den-scathach.json
-- [ ] en_anno-117-specialists_copia-abundantia-die-tugendhafte-und-wohlhabende.json
+- [x] en_anno-117-specialists_copia-abundantia-die-tugendhafte-und-wohlhabende.json
-- [ ] en_anno-117-specialists_connmhach-bodhran-trommler.json
+- [x] en_anno-117-specialists_connmhach-bodhran-trommler.json
-- [ ] en_anno-117-specialists_collegiatus-von-aeneas.json
+- [x] en_anno-117-specialists_collegiatus-von-aeneas.json
-- [ ] en_anno-117-specialists_centurio-chirotreca-schiffskatze.json
+- [x] en_anno-117-specialists_centurio-chirotreca-schiffskatze.json
-- [ ] en_anno-117-specialists_cathubodua-kampfkraehe.json
+- [x] en_anno-117-specialists_cathubodua-kampfkraehe.json
-- [ ] en_anno-117-specialists_cantabricus-iv-hegemon-der-meere.json
+- [x] en_anno-117-specialists_cantabricus-iv-hegemon-der-meere.json
-- [ ] en_anno-117-specialists_calydon-deiranira-arkadische-bogenschuetzin.json
+- [x] en_anno-117-specialists_calydon-deiranira-arkadische-bogenschuetzin.json
-- [ ] en_anno-117-specialists_caemgen-sciathoir-klingenwunder.json
+- [x] en_anno-117-specialists_caemgen-sciathoir-klingenwunder.json
-- [ ] en_anno-117-specialists_caelus-laecanius-der-ungebrochene.json
+- [x] en_anno-117-specialists_caelus-laecanius-der-ungebrochene.json
-- [ ] en_anno-117-specialists_bestaendiger-windsegler.json
+- [x] en_anno-117-specialists_bestaendiger-windsegler.json
-- [ ] en_anno-117-specialists_besonnener-takler.json
+- [x] en_anno-117-specialists_besonnener-takler.json
-- [ ] en_anno-117-specialists_ausbesserer.json
+- [x] en_anno-117-specialists_ausbesserer.json
-- [ ] en_anno-117-specialists_antreiber.json
+- [x] en_anno-117-specialists_antreiber.json
-- [ ] en_anno-117-specialists_angespannter-leiter.json
+- [x] en_anno-117-specialists_angespannter-leiter.json
-- [ ] en_anno-117-specialists_amulius-ignius-serranus-thysdrianischer-praetor.json
+- [x] en_anno-117-specialists_amulius-ignius-serranus-thysdrianischer-praetor.json
-- [ ] en_anno-117-specialists_aisling-sidhbe-vom-windvolk.json
+- [x] en_anno-117-specialists_aisling-sidhbe-vom-windvolk.json
-- [ ] en_anno-117-specialists_ahumm-von-sidon-naumachie-champion.json
+- [x] en_anno-117-specialists_ahumm-von-sidon-naumachie-champion.json
-- [ ] en_anno-117-specialists_agesistrata-von-perga-lithoballistische-gelehrte.json
+- [x] en_anno-117-specialists_agesistrata-von-perga-lithoballistische-gelehrte.json
-- [ ] en_anno-117-specialists_aelia-avita-die-niemals-untaetige.json
+- [x] en_anno-117-specialists_aelia-avita-die-niemals-untaetige.json
-- [ ] en_anno-117-specialists_zorsines-sarmatischer-schwertformer.json
+- [x] en_anno-117-specialists_zorsines-sarmatischer-schwertformer.json
-- [ ] en_anno-117-specialists_xeno-von-phillipopolis-hipparchon.json
+- [x] en_anno-117-specialists_xeno-von-phillipopolis-hipparchon.json
-- [ ] en_anno-117-specialists_wiedervereiniger.json
+- [x] en_anno-117-specialists_wiedervereiniger.json
-- [ ] en_anno-117-specialists_weissgerberin.json
+- [x] en_anno-117-specialists_weissgerberin.json
-- [ ] en_anno-117-specialists_warenhueter.json
+- [x] en_anno-117-specialists_warenhueter.json
-- [ ] en_anno-117-specialists_waechter.json
+- [x] en_anno-117-specialists_waechter.json
-- [ ] en_anno-117-specialists_wachsamer-villicus.json
+- [x] en_anno-117-specialists_wachsamer-villicus.json
-- [ ] en_anno-117-specialists_vexillarius.json
+- [x] en_anno-117-specialists_vexillarius.json
-- [ ] en_anno-117-specialists_vermesserin.json
+- [x] en_anno-117-specialists_vermesserin.json
-- [ ] en_anno-117-specialists_venator-der-artemis.json
+- [x] en_anno-117-specialists_venator-der-artemis.json
-- [ ] en_anno-117-specialists_umdenkerin.json
+- [x] en_anno-117-specialists_umdenkerin.json
-- [ ] en_anno-117-specialists_uesuca-aus-dem-terrorterroir.json
+- [x] en_anno-117-specialists_uesuca-aus-dem-terrorterroir.json
-- [ ] en_anno-117-specialists_uassoro-der-moorgeist.json
+- [x] en_anno-117-specialists_uassoro-der-moorgeist.json
-- [ ] en_anno-117-specialists_tullus-caecilius-cornutus-arvalbruder-des-insitors.json
+- [x] en_anno-117-specialists_tullus-caecilius-cornutus-arvalbruder-des-insitors.json
-- [ ] en_anno-117-specialists_tuechtiger-schmied.json
+- [x] en_anno-117-specialists_tuechtiger-schmied.json
-- [ ] en_anno-117-specialists_troucotouto-enterwerfender-subiudex.json
+- [x] en_anno-117-specialists_troucotouto-enterwerfender-subiudex.json
-- [ ] en_anno-117-specialists_traubenstampferin.json
+- [x] en_anno-117-specialists_traubenstampferin.json
-- [ ] en_anno-117-specialists_titus-faber-meister-der-aufgaben.json
+- [x] en_anno-117-specialists_titus-faber-meister-der-aufgaben.json
-- [ ] en_anno-117-specialists_tirechan-ua-aergol-unermuedlicher-pflueger.json
+- [x] en_anno-117-specialists_tirechan-ua-aergol-unermuedlicher-pflueger.json
-- [ ] en_anno-117-specialists_teigwahrsager.json
+- [x] en_anno-117-specialists_teigwahrsager.json
-- [ ] en_anno-117-specialists_standhafte-hafenwache.json
+- [x] en_anno-117-specialists_standhafte-hafenwache.json
-- [ ] en_anno-117-specialists_senchaid-sciatharglan-eingebetteter-waffenschild.json
+- [x] en_anno-117-specialists_senchaid-sciatharglan-eingebetteter-waffenschild.json
-- [ ] en_anno-117-specialists_verzwirnerin.json
+- [x] en_anno-117-specialists_verzwirnerin.json
-- [ ] en_anno-117-specialists_segler.json
+- [x] en_anno-117-specialists_segler.json
-- [ ] en_anno-117-specialists_schweinefluesterer.json
+- [x] en_anno-117-specialists_schweinefluesterer.json
-- [ ] en_anno-117-specialists_schlammsucherin.json
+- [x] en_anno-117-specialists_schlammsucherin.json
 - [ ] en_anno-117-specialists_sceilg-eremitscher-reduktionist.json
-- [ ] en_anno-117-specialists_saeumer.json
+- [x] en_anno-117-specialists_saeumer.json
-- [ ] en_anno-117-specialists_saturnsischer-schmelzer.json
+- [x] en_anno-117-specialists_saturnsischer-schmelzer.json
 - [ ] en_anno-117-specialists_rhea-proserpina-dis-mater.json
-- [ ] en_anno-117-specialists_renaturierer.json
+- [x] en_anno-117-specialists_renaturierer.json
 - [ ] en_anno-117-specialists_rachsuechtige-villica.json
-- [ ] en_anno-117-specialists_publius-aelius-adrian-balustrischer-baumeister.json
+- [x] en_anno-117-specialists_publius-aelius-adrian-balustrischer-baumeister.json
-- [ ] en_anno-117-specialists_princeps-von-porphyr.json
+- [x] en_anno-117-specialists_princeps-von-porphyr.json
 - [ ] en_anno-117-specialists_primus-tremellius-valens-vom-tuermenden-elfenbein.json
 - [ ] en_anno-117-specialists_praktizierender-heiler.json
 - [ ] en_anno-117-specialists_pragmatische-aegis.json