What This Skill Provides
Core Analysis Capabilities
Settlement vs. Hearing Analysis
- Probability-weighted expected value of hearing outcomes
- Settlement scenario comparison (current offer, counteroffer, midpoint)
- Net benefit calculation with risk adjustment
- Breakeven settlement determination
BATNA Calculation
- Expected award calculation across low/mid/high scenarios
- Total hearing costs (legal fees, expert fees, time costs)
- Net BATNA (total expected cost to buyer)
- Uncertainty analysis (standard deviation, coefficient of variation)
ZOPA Analysis
- Zone of possible agreement identification
- Optimal settlement range recommendations
- Opening offer, target, and walkaway points
- Negotiation leverage assessment
Risk Assessment
- Owner holdout risk scoring (0-30 scale)
- Litigation probability estimation
- Expected hearing duration and cost ranges
- Risk factor identification and mitigation strategies
Strategic Planning
- Concession strategy with diminishing increments
- Negotiation rounds planning
- Timeline and action items
- Decision confidence levels
Key Metrics Calculated
- Expected Hearing Cost: Probability-weighted award + legal/expert fees
- Net Benefit: Settlement savings vs. hearing
- Holdout Risk Score: 0-30 scale (motivation + sophistication + alternatives)
- Litigation Probability: 0-100% based on valuation gap, owner profile, case complexity
- ZOPA Range: Lower bound (seller min) to upper bound (buyer max)
- Optimal Settlement: Target, floor, ceiling within ZOPA
- Risk-Adjusted Benefit: Net benefit minus uncertainty premium
Calculator: settlement_analyzer.py
Location: ${CLAUDE_PLUGIN_ROOT}/skills/settlement-analysis-expert/settlement_analyzer.py
Purpose: Analyze settlement scenarios vs. hearing risk with probability-weighted outcomes
Architecture: Modular design following Issue #21 requirements
- Thin orchestration layer (main calculator)
- Separate modules for validation, calculations, analysis, output formatting
- Shared utilities integration (negotiation_utils, risk_utils, financial_utils, report_utils)
Modules
validators.py
- Input validation against JSON schema
- Probability distribution validation (must sum to 1.0)
- Owner profile and case factors validation
- Award amount ordering validation (low <= mid <= high)
calculations.py
- Settlement scenario calculations
- Hearing expected value (BATNA)
- Net benefit and savings analysis
- Scenario comparison with probability weighting
analysis.py
- Settlement vs. hearing decision analysis
- ZOPA and optimal range calculation
- Concession strategy generation
- Owner holdout risk assessment
- Litigation risk assessment
- Sensitivity analysis
output_formatters.py
- Comprehensive markdown reports
- Executive summaries
- Scenario comparison tables
- Financial summaries
Usage
# Basic usage (markdown report to stdout)
python settlement_analyzer.py samples/sample_1_transmission_easement.json
# Generate report to file
python settlement_analyzer.py samples/sample_1_transmission_easement.json --output report.md
# JSON output for programmatic use
python settlement_analyzer.py samples/sample_1_transmission_easement.json --json > results.json
Input Schema
Required Fields:
case_id: Case identifier
settlement_offer: Current settlement offer amount
hearing_probabilities: {low_award, mid_award, high_award} (must sum to 1.0)
hearing_costs: {low/mid/high_award_amount, legal_fees, expert_fees, time_cost}
Optional Fields:
counteroffer: Owner's counteroffer
buyer_max_settlement: Maximum buyer willing to pay (defaults to BATNA)
settlement_costs: {legal_fees_to_settle, settlement_risk}
owner_profile: {motivation, sophistication, alternatives}
case_factors: {valuation_gap, property_value, legal_complexity, precedent_clarity, jurisdiction_history}
discount_rate: Annual discount rate for NPV (default 5%)
Full Schema: See settlement_input_schema.json (JSON Schema Draft 2020-12)
Sample Input
{
"case_id": "HYDRO-2025-001",
"property_description": "Transmission line easement across 50-acre farm",
"settlement_offer": 180000,
"counteroffer": 220000,
"hearing_probabilities": {
"low_award": 0.2,
"mid_award": 0.5,
"high_award": 0.3
},
"hearing_costs": {
"low_award_amount": 150000,
"mid_award_amount": 185000,
"high_award_amount": 230000,
"legal_fees": 50000,
"expert_fees": 30000,
"time_cost": 10000
},
"settlement_costs": {
"legal_fees_to_settle": 5000,
"settlement_risk": 0.1
},
"owner_profile": {
"motivation": {
"financial_need": "low",
"emotional_attachment": "high",
"business_impact": "moderate"
},
"sophistication": {
"real_estate_experience": "medium",
"legal_representation": true,
"previous_negotiations": 1
},
"alternatives": {
"relocation_options": "some",
"financial_flexibility": "medium",
"timeline_pressure": "low"
}
},
"case_factors": {
"valuation_gap": 40000,
"property_value": 200000,
"legal_complexity": "medium",
"precedent_clarity": "mixed",
"jurisdiction_history": "neutral"
}
}
Output Report
The calculator generates a comprehensive markdown report with:
Executive Summary
- Recommendation (SETTLE / PROCEED TO HEARING / NEUTRAL)
- Rationale and confidence level
- Financial impact
Financial Summary
- Settlement total cost vs. hearing total cost
- Net benefit and savings percentage
- Breakeven settlement amount
Hearing Risk Analysis
- Expected award with probability distribution
- Total costs breakdown (legal, expert, time)
- Award range (low/mid/high scenarios)
- Uncertainty metrics (standard deviation, coefficient of variation)
Settlement Scenarios
- Scenario comparison table (current offer, counteroffer, midpoint)
- Probability-weighted costs
- Scenario descriptions
ZOPA Analysis (if counteroffer provided)
- ZOPA existence and range
- Optimal settlement range (opening, target, walkaway)
- Negotiation room and leverage
Owner Holdout Risk Assessment (if owner profile provided)
- Risk level (LOW/MEDIUM/HIGH/CRITICAL)
- Holdout probability
- Score breakdown (motivation, sophistication, alternatives)
- Key risk factors and mitigation strategies
Litigation Risk Assessment (if case factors provided)
- Litigation probability
- Expected duration (months) and cost
- Risk factors
Shared Utilities Used
negotiation_utils.py:
calculate_batna(): Calculate hearing expected value
calculate_zopa(): Identify zone of possible agreement
probability_weighted_ev(): Probability-weighted scenario comparison
hearing_cost_benefit(): Cost-benefit analysis settlement vs. hearing
optimal_settlement_range(): Calculate optimal negotiation range
calculate_concession_strategy(): Generate diminishing concession pattern
risk_utils.py:
assess_holdout_risk(): Owner holdout risk scoring (0-30)
litigation_risk_assessment(): Litigation probability and duration
sensitivity_analysis(): Impact of variable changes
financial_utils.py:
npv(): Net present value calculations
safe_divide(): Division with zero handling
report_utils.py:
generate_executive_summary(): Decision-focused summaries
format_markdown_table(): Scenario comparison tables
eastern_timestamp(): Report timestamps
generate_document_header(): Standard headers
format_number(): Currency/percentage formatting
Decision Framework
Recommendation Thresholds
SETTLE (High Confidence):
- Net benefit > $10,000
- Settlement saves material amount vs. hearing
- Low hearing uncertainty acceptable
SETTLE (Medium Confidence):
- Net benefit $0 - $10,000
- Settlement saves small amount vs. hearing
- Uncertainty may be concerning
NEUTRAL (Continue Negotiations):
- Net benefit between -$10,000 and $0
- Costs roughly equivalent
- Room for negotiation exists within ZOPA
PROCEED TO HEARING:
- Net benefit < -$10,000
- Hearing expected to save material amount vs. settlement
- Settlement offer insufficient
Risk Adjustment
Hearing Uncertainty Premium:
- Calculate standard deviation of hearing outcomes
- Apply risk premium = std_dev × 0.5 (risk aversion factor)
- Risk-adjusted benefit = net_benefit - risk_premium
Holdout Risk Scoring (0-30 scale):
- 0-9: LOW risk (15% holdout probability)
- 10-14: MEDIUM risk (30% holdout probability)
- 15-19: HIGH risk (50% holdout probability)
- 20-30: CRITICAL risk (70% holdout probability)
Litigation Probability Factors:
- Valuation gap percentage
- Owner risk profile
- Legal complexity
- Precedent clarity
- Jurisdiction history
Workflow Integration
Typical Use Cases
1. Initial Settlement Evaluation
# Evaluate initial settlement offer vs. hearing
python settlement_analyzer.py case_data.json --output initial_analysis.md
2. Counteroffer Analysis
# Update JSON with counteroffer, recalculate ZOPA
python settlement_analyzer.py case_data_with_counter.json --output counter_analysis.md
3. Negotiation Strategy Development
# Generate concession strategy based on ZOPA
python settlement_analyzer.py case_data.json --json | jq '.concession_strategy'
4. Board Approval Package
# Comprehensive report for executive decision
python settlement_analyzer.py case_data.json --output board_memo.md
Integration with Other Skills
Combines with:
- expropriation-compensation-entitlement-analysis: Legal entitlement framework for hearing scenarios
- injurious-affection-assessment: Quantify damages for hearing cost estimates
- agricultural-easement-negotiation-frameworks: Farm-specific negotiation strategies
- negotiation-expert: Evidence-based persuasion and calibrated questions
Key Terms
- BATNA: Best Alternative to Negotiated Agreement (hearing outcome)
- ZOPA: Zone of Possible Agreement (overlap between buyer max and seller min)
- Holdout Risk: Probability owner refuses settlement and forces hearing
- Litigation Probability: Likelihood of proceeding to expropriation hearing
- Net Benefit: Settlement savings vs. hearing (positive = settle, negative = hearing better)
- Expected Award: Probability-weighted hearing compensation
- Optimal Settlement Range: Opening offer, target, and walkaway points
- Concession Strategy: Diminishing increments from opening to target
- Risk-Adjusted Benefit: Net benefit minus uncertainty premium
Expert Guidance
When Settlement Makes Sense
- Certainty Value: Settlement eliminates hearing uncertainty
- Cost Savings: Avoid legal fees, expert fees, time delays
- Relationship Preservation: Maintain goodwill for future dealings
- Timeline Advantage: Faster resolution enables project progress
- Risk Mitigation: Avoid worst-case hearing outcomes
When Hearing Makes Sense
- Insufficient Offer: Settlement offer materially below expected hearing award
- Precedent Setting: Need hearing decision for future similar cases
- Owner Unreasonable: Counteroffer far exceeds fair value
- Strong Case: High confidence in favorable hearing outcome
- ZOPA Absent: No overlap between buyer max and seller min
Negotiation Best Practices
- Start with BATNA: Know your walkaway point before negotiating
- Calculate ZOPA: Identify settlement range where both parties benefit
- Use Diminishing Concessions: Signal approaching limit
- Anchor High/Low: Buyer starts low, seller starts high, meet in middle
- Justify Movements: Each concession tied to new information or reciprocity
- Monitor Owner Risk: Adjust strategy based on holdout probability
- Document Everything: Create audit trail for decision rationale
References
Ontario Expropriations Act:
- s.13: Market value determination
- s.14: Basis of compensation
- s.18: Disturbance damages
- s.20: Interest on compensation
Negotiation Theory:
- Fisher & Ury, "Getting to Yes" (BATNA/ZOPA framework)
- Kahneman & Tversky, Prospect Theory (risk aversion, loss aversion)
- Raiffa, "The Art and Science of Negotiation" (optimal settlement ranges)
Real Estate Valuation:
- USPAP Standard 1: Real Property Appraisal (hearing award estimation)
- CUSPAP: Canadian Uniform Standards of Professional Appraisal Practice
1---2name: settlement-analysis-expert3description: Use when deciding settle-versus-hearing on an expropriation file — computing BATNA from probability-weighted hearing outcomes, identifying ZOPA against an owner counteroffer, scoring owner holdout risk (0-30), running sensitivity on legal/expert fees, or generating a diminishing concession strategy. Produces SETTLE/HEARING/NEGOTIATE recommendations with risk-adjusted net benefit.4---56## What This Skill Provides78### Core Analysis Capabilities9101. **Settlement vs. Hearing Analysis**11 - Probability-weighted expected value of hearing outcomes12 - Settlement scenario comparison (current offer, counteroffer, midpoint)13 - Net benefit calculation with risk adjustment14 - Breakeven settlement determination15162. **BATNA Calculation**17 - Expected award calculation across low/mid/high scenarios18 - Total hearing costs (legal fees, expert fees, time costs)19 - Net BATNA (total expected cost to buyer)20 - Uncertainty analysis (standard deviation, coefficient of variation)21223. **ZOPA Analysis**23 - Zone of possible agreement identification24 - Optimal settlement range recommendations25 - Opening offer, target, and walkaway points26 - Negotiation leverage assessment27284. **Risk Assessment**29 - Owner holdout risk scoring (0-30 scale)30 - Litigation probability estimation31 - Expected hearing duration and cost ranges32 - Risk factor identification and mitigation strategies33345. **Strategic Planning**35 - Concession strategy with diminishing increments36 - Negotiation rounds planning37 - Timeline and action items38 - Decision confidence levels3940### Key Metrics Calculated4142- **Expected Hearing Cost**: Probability-weighted award + legal/expert fees43- **Net Benefit**: Settlement savings vs. hearing44- **Holdout Risk Score**: 0-30 scale (motivation + sophistication + alternatives)45- **Litigation Probability**: 0-100% based on valuation gap, owner profile, case complexity46- **ZOPA Range**: Lower bound (seller min) to upper bound (buyer max)47- **Optimal Settlement**: Target, floor, ceiling within ZOPA48- **Risk-Adjusted Benefit**: Net benefit minus uncertainty premium4950## Calculator: settlement_analyzer.py5152**Location**: `${CLAUDE_PLUGIN_ROOT}/skills/settlement-analysis-expert/settlement_analyzer.py`5354**Purpose**: Analyze settlement scenarios vs. hearing risk with probability-weighted outcomes5556**Architecture**: Modular design following Issue #21 requirements57- Thin orchestration layer (main calculator)58- Separate modules for validation, calculations, analysis, output formatting59- Shared utilities integration (negotiation_utils, risk_utils, financial_utils, report_utils)6061### Modules6263**validators.py**64- Input validation against JSON schema65- Probability distribution validation (must sum to 1.0)66- Owner profile and case factors validation67- Award amount ordering validation (low <= mid <= high)6869**calculations.py**70- Settlement scenario calculations71- Hearing expected value (BATNA)72- Net benefit and savings analysis73- Scenario comparison with probability weighting7475**analysis.py**76- Settlement vs. hearing decision analysis77- ZOPA and optimal range calculation78- Concession strategy generation79- Owner holdout risk assessment80- Litigation risk assessment81- Sensitivity analysis8283**output_formatters.py**84- Comprehensive markdown reports85- Executive summaries86- Scenario comparison tables87- Financial summaries8889### Usage9091```bash92# Basic usage (markdown report to stdout)93python settlement_analyzer.py samples/sample_1_transmission_easement.json9495# Generate report to file96python settlement_analyzer.py samples/sample_1_transmission_easement.json --output report.md9798# JSON output for programmatic use99python settlement_analyzer.py samples/sample_1_transmission_easement.json --json > results.json100```101102### Input Schema103104**Required Fields**:105- `case_id`: Case identifier106- `settlement_offer`: Current settlement offer amount107- `hearing_probabilities`: {low_award, mid_award, high_award} (must sum to 1.0)108- `hearing_costs`: {low/mid/high_award_amount, legal_fees, expert_fees, time_cost}109110**Optional Fields**:111- `counteroffer`: Owner's counteroffer112- `buyer_max_settlement`: Maximum buyer willing to pay (defaults to BATNA)113- `settlement_costs`: {legal_fees_to_settle, settlement_risk}114- `owner_profile`: {motivation, sophistication, alternatives}115- `case_factors`: {valuation_gap, property_value, legal_complexity, precedent_clarity, jurisdiction_history}116- `discount_rate`: Annual discount rate for NPV (default 5%)117118**Full Schema**: See `settlement_input_schema.json` (JSON Schema Draft 2020-12)119120### Sample Input121122```json123{124 "case_id": "HYDRO-2025-001",125 "property_description": "Transmission line easement across 50-acre farm",126 "settlement_offer": 180000,127 "counteroffer": 220000,128 "hearing_probabilities": {129 "low_award": 0.2,130 "mid_award": 0.5,131 "high_award": 0.3132 },133 "hearing_costs": {134 "low_award_amount": 150000,135 "mid_award_amount": 185000,136 "high_award_amount": 230000,137 "legal_fees": 50000,138 "expert_fees": 30000,139 "time_cost": 10000140 },141 "settlement_costs": {142 "legal_fees_to_settle": 5000,143 "settlement_risk": 0.1144 },145 "owner_profile": {146 "motivation": {147 "financial_need": "low",148 "emotional_attachment": "high",149 "business_impact": "moderate"150 },151 "sophistication": {152 "real_estate_experience": "medium",153 "legal_representation": true,154 "previous_negotiations": 1155 },156 "alternatives": {157 "relocation_options": "some",158 "financial_flexibility": "medium",159 "timeline_pressure": "low"160 }161 },162 "case_factors": {163 "valuation_gap": 40000,164 "property_value": 200000,165 "legal_complexity": "medium",166 "precedent_clarity": "mixed",167 "jurisdiction_history": "neutral"168 }169}170```171172### Output Report173174The calculator generates a comprehensive markdown report with:1751761. **Executive Summary**177 - Recommendation (SETTLE / PROCEED TO HEARING / NEUTRAL)178 - Rationale and confidence level179 - Financial impact1801812. **Financial Summary**182 - Settlement total cost vs. hearing total cost183 - Net benefit and savings percentage184 - Breakeven settlement amount1851863. **Hearing Risk Analysis**187 - Expected award with probability distribution188 - Total costs breakdown (legal, expert, time)189 - Award range (low/mid/high scenarios)190 - Uncertainty metrics (standard deviation, coefficient of variation)1911924. **Settlement Scenarios**193 - Scenario comparison table (current offer, counteroffer, midpoint)194 - Probability-weighted costs195 - Scenario descriptions1961975. **ZOPA Analysis** (if counteroffer provided)198 - ZOPA existence and range199 - Optimal settlement range (opening, target, walkaway)200 - Negotiation room and leverage2012026. **Owner Holdout Risk Assessment** (if owner profile provided)203 - Risk level (LOW/MEDIUM/HIGH/CRITICAL)204 - Holdout probability205 - Score breakdown (motivation, sophistication, alternatives)206 - Key risk factors and mitigation strategies2072087. **Litigation Risk Assessment** (if case factors provided)209 - Litigation probability210 - Expected duration (months) and cost211 - Risk factors212213## Shared Utilities Used214215**negotiation_utils.py**:216- `calculate_batna()`: Calculate hearing expected value217- `calculate_zopa()`: Identify zone of possible agreement218- `probability_weighted_ev()`: Probability-weighted scenario comparison219- `hearing_cost_benefit()`: Cost-benefit analysis settlement vs. hearing220- `optimal_settlement_range()`: Calculate optimal negotiation range221- `calculate_concession_strategy()`: Generate diminishing concession pattern222223**risk_utils.py**:224- `assess_holdout_risk()`: Owner holdout risk scoring (0-30)225- `litigation_risk_assessment()`: Litigation probability and duration226- `sensitivity_analysis()`: Impact of variable changes227228**financial_utils.py**:229- `npv()`: Net present value calculations230- `safe_divide()`: Division with zero handling231232**report_utils.py**:233- `generate_executive_summary()`: Decision-focused summaries234- `format_markdown_table()`: Scenario comparison tables235- `eastern_timestamp()`: Report timestamps236- `generate_document_header()`: Standard headers237- `format_number()`: Currency/percentage formatting238239## Decision Framework240241### Recommendation Thresholds242243**SETTLE** (High Confidence):244- Net benefit > $10,000245- Settlement saves material amount vs. hearing246- Low hearing uncertainty acceptable247248**SETTLE** (Medium Confidence):249- Net benefit $0 - $10,000250- Settlement saves small amount vs. hearing251- Uncertainty may be concerning252253**NEUTRAL** (Continue Negotiations):254- Net benefit between -$10,000 and $0255- Costs roughly equivalent256- Room for negotiation exists within ZOPA257258**PROCEED TO HEARING**:259- Net benefit < -$10,000260- Hearing expected to save material amount vs. settlement261- Settlement offer insufficient262263### Risk Adjustment264265**Hearing Uncertainty Premium**:266- Calculate standard deviation of hearing outcomes267- Apply risk premium = std_dev × 0.5 (risk aversion factor)268- Risk-adjusted benefit = net_benefit - risk_premium269270**Holdout Risk Scoring** (0-30 scale):271- 0-9: LOW risk (15% holdout probability)272- 10-14: MEDIUM risk (30% holdout probability)273- 15-19: HIGH risk (50% holdout probability)274- 20-30: CRITICAL risk (70% holdout probability)275276**Litigation Probability Factors**:277- Valuation gap percentage278- Owner risk profile279- Legal complexity280- Precedent clarity281- Jurisdiction history282283## Workflow Integration284285### Typical Use Cases286287**1. Initial Settlement Evaluation**288```bash289# Evaluate initial settlement offer vs. hearing290python settlement_analyzer.py case_data.json --output initial_analysis.md291```292293**2. Counteroffer Analysis**294```bash295# Update JSON with counteroffer, recalculate ZOPA296python settlement_analyzer.py case_data_with_counter.json --output counter_analysis.md297```298299**3. Negotiation Strategy Development**300```bash301# Generate concession strategy based on ZOPA302python settlement_analyzer.py case_data.json --json | jq '.concession_strategy'303```304305**4. Board Approval Package**306```bash307# Comprehensive report for executive decision308python settlement_analyzer.py case_data.json --output board_memo.md309```310311### Integration with Other Skills312313**Combines with**:314- **expropriation-compensation-entitlement-analysis**: Legal entitlement framework for hearing scenarios315- **injurious-affection-assessment**: Quantify damages for hearing cost estimates316- **agricultural-easement-negotiation-frameworks**: Farm-specific negotiation strategies317- **negotiation-expert**: Evidence-based persuasion and calibrated questions318319## Key Terms320321- **BATNA**: Best Alternative to Negotiated Agreement (hearing outcome)322- **ZOPA**: Zone of Possible Agreement (overlap between buyer max and seller min)323- **Holdout Risk**: Probability owner refuses settlement and forces hearing324- **Litigation Probability**: Likelihood of proceeding to expropriation hearing325- **Net Benefit**: Settlement savings vs. hearing (positive = settle, negative = hearing better)326- **Expected Award**: Probability-weighted hearing compensation327- **Optimal Settlement Range**: Opening offer, target, and walkaway points328- **Concession Strategy**: Diminishing increments from opening to target329- **Risk-Adjusted Benefit**: Net benefit minus uncertainty premium330331## Expert Guidance332333### When Settlement Makes Sense3343351. **Certainty Value**: Settlement eliminates hearing uncertainty3362. **Cost Savings**: Avoid legal fees, expert fees, time delays3373. **Relationship Preservation**: Maintain goodwill for future dealings3384. **Timeline Advantage**: Faster resolution enables project progress3395. **Risk Mitigation**: Avoid worst-case hearing outcomes340341### When Hearing Makes Sense3423431. **Insufficient Offer**: Settlement offer materially below expected hearing award3442. **Precedent Setting**: Need hearing decision for future similar cases3453. **Owner Unreasonable**: Counteroffer far exceeds fair value3464. **Strong Case**: High confidence in favorable hearing outcome3475. **ZOPA Absent**: No overlap between buyer max and seller min348349### Negotiation Best Practices3503511. **Start with BATNA**: Know your walkaway point before negotiating3522. **Calculate ZOPA**: Identify settlement range where both parties benefit3533. **Use Diminishing Concessions**: Signal approaching limit3544. **Anchor High/Low**: Buyer starts low, seller starts high, meet in middle3555. **Justify Movements**: Each concession tied to new information or reciprocity3566. **Monitor Owner Risk**: Adjust strategy based on holdout probability3577. **Document Everything**: Create audit trail for decision rationale358359## References360361**Ontario Expropriations Act**:362- s.13: Market value determination363- s.14: Basis of compensation364- s.18: Disturbance damages365- s.20: Interest on compensation366367**Negotiation Theory**:368- Fisher & Ury, "Getting to Yes" (BATNA/ZOPA framework)369- Kahneman & Tversky, Prospect Theory (risk aversion, loss aversion)370- Raiffa, "The Art and Science of Negotiation" (optimal settlement ranges)371372**Real Estate Valuation**:373- USPAP Standard 1: Real Property Appraisal (hearing award estimation)374- CUSPAP: Canadian Uniform Standards of Professional Appraisal Practice