claude-code-arcane 1.0.0

package/skills/financial-analyst/references/forecasting-best-practices.md

@@ -0,0 +1,279 @@
+# Forecasting Best Practices
+
+Comprehensive reference for financial forecasting including driver-based models, rolling forecasts, accuracy improvement techniques, and scenario planning.
+
+## 1. Driver-Based Forecasting
+
+### Overview
+
+Driver-based forecasting models financial outcomes based on key business drivers rather than extrapolating from historical trends alone. This approach creates more transparent, actionable, and accurate forecasts.
+
+### Identifying Key Drivers
+
+**Revenue Drivers:**
+
+| Business Model | Primary Drivers |
+|---------------|----------------|
+| SaaS/Subscription | Customers x ARPU x Retention Rate |
+| E-commerce | Visitors x Conversion Rate x AOV |
+| Manufacturing | Units x Price per Unit |
+| Professional Services | Headcount x Utilization x Bill Rate |
+| Retail | Stores x Revenue per Store (or sqft) |
+| Marketplace | GMV x Take Rate |
+
+**Cost Drivers:**
+
+| Category | Common Drivers |
+|----------|---------------|
+| COGS | Revenue x (1 - Gross Margin) or Units x Unit Cost |
+| Headcount Costs | Employees x Average Compensation x (1 + Benefits Rate) |
+| Sales & Marketing | Revenue x S&M % or CAC x New Customers |
+| R&D | Engineering Headcount x Avg Salary |
+| G&A | Headcount-based + fixed costs |
+| CapEx | Revenue x CapEx Intensity or Project-based |
+
+### Building a Driver-Based Model
+
+**Step 1: Map the value chain**
+- Revenue = f(volume drivers, pricing drivers, mix drivers)
+- Costs = f(variable drivers, fixed components, step functions)
+
+**Step 2: Establish driver relationships**
+- Linear: Revenue = Units x Price
+- Non-linear: Revenue = Base x (1 + Growth Rate)^t
+- Step function: Facilities costs that jump at capacity thresholds
+
+**Step 3: Validate driver assumptions**
+- Compare driver values to historical actuals
+- Benchmark against industry data
+- Stress-test extreme values
+
+**Step 4: Build sensitivity**
+- Identify which drivers have the largest impact on output
+- Quantify the range of reasonable values for each driver
+- Create scenario combinations
+
+### Driver Sensitivity Matrix
+
+Rank drivers by impact and uncertainty:
+
+| | High Impact | Low Impact |
+|---|-----------|-----------|
+| **High Uncertainty** | Model these carefully, run scenarios | Monitor but don't over-model |
+| **Low Uncertainty** | Get these right; high accuracy needed | Use simple assumptions |
+
+## 2. Rolling Forecasts
+
+### What Is a Rolling Forecast?
+
+A rolling forecast continuously extends the forecast horizon as each period closes. Unlike a static annual budget, a rolling forecast always looks forward the same number of periods (typically 12-18 months).
+
+### Rolling Forecast vs Annual Budget
+
+| Feature | Annual Budget | Rolling Forecast |
+|---------|--------------|-----------------|
+| Time Horizon | Fixed (Jan-Dec) | Rolling (12-18 months) |
+| Update Frequency | Once per year | Monthly or quarterly |
+| Detail Level | Very detailed | Driver-level |
+| Preparation Time | 3-6 months | 2-5 days per cycle |
+| Relevance | Declines over time | Stays current |
+| Flexibility | Rigid | Adaptive |
+
+### Implementation Steps
+
+1. **Select the horizon** - 12 months rolling is most common (some use 18 months for CapEx planning)
+2. **Define update cadence** - Monthly for volatile businesses; quarterly for stable ones
+3. **Choose the right detail** - Driver-level, not line-item detail
+4. **Automate data feeds** - Reduce manual effort per cycle
+5. **Separate actuals from forecast** - Clear delineation between reported and projected periods
+6. **Track forecast accuracy** - Measure MAPE (Mean Absolute Percentage Error) over time
+
+### 13-Week Cash Flow Forecast
+
+A specialized rolling forecast for liquidity management:
+
+**Structure:**
+- Week-by-week cash inflows and outflows
+- Opening and closing cash balances
+- Minimum cash threshold alerts
+
+**Key Components:**
+| Inflows | Outflows |
+|---------|----------|
+| Customer collections (by aging) | Payroll (fixed cadence) |
+| Other receivables | Rent / Lease payments |
+| Asset sales | Vendor payments (by terms) |
+| Financing proceeds | Debt service |
+| Tax refunds | Tax payments |
+| Other income | Capital expenditures |
+
+**Collection Modeling:**
+- Apply collection rates by customer segment or aging bucket
+- Model DSO trends to project collection timing
+- Account for seasonal patterns in payment behavior
+
+## 3. Accuracy Improvement
+
+### Measuring Forecast Accuracy
+
+**Mean Absolute Percentage Error (MAPE):**
+```
+MAPE = (1/n) x Sum of |Actual - Forecast| / |Actual| x 100%
+```
+
+**Accuracy Benchmarks:**
+| MAPE | Rating |
+|------|--------|
+| < 5% | Excellent |
+| 5% - 10% | Good |
+| 10% - 20% | Acceptable |
+| > 20% | Needs improvement |
+
+**Weighted MAPE (WMAPE):**
+Use when line items vary significantly in magnitude - weights errors by actual values.
+
+### Techniques to Improve Accuracy
+
+**1. Bias Detection and Correction**
+- Track directional bias (consistently over or under forecasting)
+- Calculate mean signed error to detect systematic bias
+- Adjust driver assumptions to correct persistent bias
+
+**2. Variance Analysis Loop**
+- After each period closes, compare actual vs forecast
+- Identify root causes of significant variances
+- Update driver assumptions based on learnings
+- Document what changed and why
+
+**3. Ensemble Approach**
+- Combine multiple forecasting methods
+- Blend statistical (trend) with judgmental (management input)
+- Weight methods by their historical accuracy
+
+**4. Granularity Optimization**
+- Forecast at the right level of detail - not too aggregated, not too granular
+- Product/segment level usually more accurate than single top-line
+- Aggregate bottom-up forecasts for total, then adjust
+
+**5. Leading Indicators**
+- Identify metrics that predict financial outcomes 1-3 months ahead
+- Pipeline/bookings predict revenue
+- Hiring plans predict headcount costs
+- Customer churn signals predict retention revenue
+
+### Common Accuracy Killers
+
+1. **Anchoring bias** - Over-relying on last year's numbers
+2. **Optimism bias** - Systematic overestimation of growth
+3. **Lack of accountability** - No one tracks forecast vs actual
+4. **Stale assumptions** - Not updating for market changes
+5. **Missing data** - Forecasting without key driver inputs
+6. **Over-precision** - False precision in uncertain environments
+
+## 4. Scenario Planning
+
+### Three-Scenario Framework
+
+| Scenario | Description | Probability |
+|----------|-------------|-------------|
+| **Base Case** | Most likely outcome based on current trajectory | 50-60% |
+| **Bull Case** | Favorable conditions, upside realization | 15-25% |
+| **Bear Case** | Adverse conditions, downside risks | 15-25% |
+
+### Scenario Construction
+
+**Base Case:**
+- Continuation of current trends
+- Management's operational plan
+- Market consensus assumptions
+- Normal competitive dynamics
+
+**Bull Case (apply selectively, not uniformly):**
+- Faster customer acquisition or market adoption
+- Successful product launch or expansion
+- Favorable macro conditions
+- Competitor weakness or exit
+- Margin expansion from operating leverage
+
+**Bear Case (be realistic, not catastrophic):**
+- Slower growth or market contraction
+- Increased competition or pricing pressure
+- Key customer or contract loss
+- Supply chain disruption
+- Regulatory headwinds
+
+### Scenario Variables
+
+Map each scenario to specific driver values:
+
+| Driver | Bear | Base | Bull |
+|--------|------|------|------|
+| Revenue Growth | +2% | +8% | +15% |
+| Gross Margin | 35% | 40% | 43% |
+| Customer Churn | 8% | 5% | 3% |
+| New Customers/Month | 50 | 100 | 180 |
+| Price Increase | 0% | 3% | 5% |
+
+### Presenting Scenarios
+
+1. **Show the range** - Management needs to see the potential outcomes
+2. **Quantify the gap** - Dollar impact of bull vs bear on key metrics
+3. **Identify triggers** - What conditions would cause each scenario
+4. **Define actions** - What levers to pull in each scenario
+5. **Assign probabilities** - Not all scenarios are equally likely
+
+## 5. Forecast Communication
+
+### Stakeholder Needs
+
+| Audience | Needs |
+|----------|-------|
+| Board | High-level scenarios, key risks, strategic implications |
+| CEO/CFO | Detailed drivers, variance explanations, action items |
+| Department Heads | Their specific budget vs forecast, headcount plans |
+| Investors | Revenue guidance, margin trajectory, capital allocation |
+| Operations | Weekly/monthly targets, resource requirements |
+
+### Presentation Framework
+
+1. **Executive summary** - Key metrics, direction of travel, confidence level
+2. **Variance bridge** - Walk from budget/prior forecast to current forecast
+3. **Driver analysis** - What changed and why
+4. **Scenario comparison** - Range of outcomes
+5. **Key risks and opportunities** - What could change the forecast
+6. **Action items** - Decisions needed based on forecast
+
+### Forecast Cadence
+
+| Activity | Frequency | Time Required |
+|----------|-----------|--------------|
+| 13-week cash flow update | Weekly | 1-2 hours |
+| Rolling forecast update | Monthly | 1-2 days |
+| Full reforecast | Quarterly | 3-5 days |
+| Annual budget/plan | Annually | 4-8 weeks |
+| Board reporting | Quarterly | 2-3 days |
+
+## 6. Industry-Specific Considerations
+
+### SaaS Metrics in Forecasting
+
+- **MRR/ARR decomposition:** New, expansion, contraction, churn
+- **Cohort-based forecasting:** Forecast by customer cohort for retention accuracy
+- **Rule of 40:** Revenue growth % + Profit margin % should exceed 40%
+- **Net Revenue Retention:** Target > 110% for healthy SaaS
+- **CAC Payback:** Should be < 18 months
+
+### Retail Forecasting
+
+- **Same-store sales growth** as primary organic growth metric
+- **Seasonal decomposition** for accurate monthly/weekly forecasts
+- **Markdown optimization** impact on gross margin
+- **Inventory turns** drive working capital forecasts
+
+### Manufacturing Forecasting
+
+- **Order backlog** as a leading indicator
+- **Capacity constraints** creating step-function cost increases
+- **Raw material price forecasts** for COGS
+- **Maintenance CapEx vs growth CapEx** distinction
+- **Utilization rates** driving unit cost projections

package/skills/financial-analyst/references/industry-adaptations.md

@@ -0,0 +1,103 @@
+# Industry Adaptations
+
+Sector-specific metrics, benchmarks, and considerations for financial analysis.
+
+## SaaS / Software
+
+**Key Metrics:**
+- ARR / MRR growth rate
+- Net Revenue Retention (NRR) — target >110%
+- CAC Payback Period — target <18 months
+- Rule of 40 (growth rate + profit margin ≥ 40%)
+- LTV:CAC ratio — target >3:1
+- Gross margin — target >70%
+
+**Valuation Multiples:**
+- Revenue multiple: 5-15x ARR (growth-adjusted)
+- High-growth (>50%): 15-25x ARR
+- Moderate growth (20-50%): 8-15x ARR
+- Low growth (<20%): 3-8x ARR
+
+**Considerations:**
+- Deferred revenue recognition (ASC 606)
+- Stock-based compensation impact on margins
+- Cohort analysis critical for retention metrics
+
+## Retail / E-Commerce
+
+**Key Metrics:**
+- Same-store sales growth (SSS)
+- Gross margin by category
+- Inventory turnover — target varies by segment (grocery: 14-20x, fashion: 4-6x)
+- Revenue per square foot (physical)
+- Customer acquisition cost vs. AOV
+- Return rate impact on unit economics
+
+**Valuation Multiples:**
+- EV/EBITDA: 8-15x (premium brands higher)
+- P/E: 15-25x
+
+**Considerations:**
+- Seasonal revenue concentration (Q4 holiday)
+- Working capital intensity (inventory cycles)
+- Omnichannel attribution complexity
+
+## Manufacturing
+
+**Key Metrics:**
+- Gross margin by product line
+- Capacity utilization rate — target >80%
+- Days Inventory Outstanding (DIO)
+- Warranty reserve as % of revenue
+- Capex as % of revenue (maintenance vs. growth)
+- Order backlog / book-to-bill ratio
+
+**Valuation Multiples:**
+- EV/EBITDA: 6-12x
+- P/E: 12-20x
+
+**Considerations:**
+- Raw material cost volatility
+- Currency exposure in supply chain
+- Depreciation schedules (straight-line vs. accelerated)
+- Regulatory compliance costs (environmental, safety)
+
+## Financial Services
+
+**Key Metrics:**
+- Net Interest Margin (NIM)
+- Return on Equity (ROE) — target >12%
+- Cost-to-Income Ratio — target <60%
+- Non-Performing Loan (NPL) ratio
+- Tier 1 Capital Ratio — regulatory minimum varies
+- Assets Under Management (AUM) growth
+
+**Valuation Multiples:**
+- Price-to-Book (P/B): 1.0-2.5x
+- P/E: 10-18x
+
+**Considerations:**
+- Regulatory capital requirements (Basel III/IV)
+- Interest rate sensitivity analysis
+- Credit risk provisioning (CECL / IFRS 9)
+- Mark-to-market vs. held-to-maturity accounting
+
+## Healthcare
+
+**Key Metrics:**
+- Revenue per patient / per bed
+- Payor mix (Medicare/Medicaid vs. commercial)
+- EBITDAR margin (rent-adjusted for facilities)
+- Clinical trial pipeline value (biotech/pharma)
+- Patent cliff exposure
+- R&D as % of revenue — benchmark 15-25% (pharma)
+
+**Valuation Multiples:**
+- EV/EBITDA: 10-18x (medtech), 12-20x (pharma)
+- EV/Revenue: 3-8x (services), 5-15x (devices)
+
+**Considerations:**
+- Reimbursement rate changes (regulatory risk)
+- FDA approval timelines and probability-weighted pipeline
+- 340B pricing program impact
+- Medical device regulation (MDR, QSR compliance)

package/skills/financial-analyst/references/valuation-methodology.md

@@ -0,0 +1,246 @@
+# Valuation Methodology Guide
+
+Comprehensive reference for business valuation approaches including DCF analysis, comparable company analysis, and precedent transactions.
+
+## 1. Discounted Cash Flow (DCF) Methodology
+
+### Overview
+
+DCF is an intrinsic valuation method that estimates the present value of a company's expected future free cash flows, discounted at an appropriate rate reflecting the risk of those cash flows.
+
+**Core Principle:** The value of a business equals the present value of all future cash flows it will generate.
+
+**Formula:**
+
+```
+Enterprise Value = Sum of [FCF_t / (1 + WACC)^t] + Terminal Value / (1 + WACC)^n
+```
+
+Where:
+- FCF_t = Free Cash Flow in year t
+- WACC = Weighted Average Cost of Capital
+- n = number of projection years
+
+### Step 1: Historical Analysis
+
+Before projecting, analyze 3-5 years of historical financials:
+
+- **Revenue growth rates** - Identify organic vs acquisition-driven growth
+- **Margin trends** - Gross, operating, and net margin trajectories
+- **Capital intensity** - CapEx as % of revenue
+- **Working capital** - Cash conversion cycle trends
+- **Free cash flow conversion** - FCF / Net Income ratio
+
+### Step 2: Revenue Projections
+
+**Approaches:**
+1. **Top-down:** Market size x Market share x Pricing
+2. **Bottom-up:** Units x Price, or Customers x ARPU
+3. **Growth rate extrapolation:** Historical growth with decay
+
+**Revenue Projection Best Practices:**
+- Use 5-7 year explicit projection period
+- Growth should converge toward GDP growth by terminal year
+- Support assumptions with market data and management guidance
+- Model revenue by segment/product line when possible
+
+### Step 3: Free Cash Flow Calculation
+
+**Unlevered Free Cash Flow (UFCF):**
+
+```
+UFCF = EBIT x (1 - Tax Rate)
+     + Depreciation & Amortization
+     - Capital Expenditures
+     - Changes in Net Working Capital
+```
+
+**Key Drivers:**
+- Operating margin trajectory
+- CapEx as % of revenue (maintenance vs growth)
+- Working capital requirements (DSO, DIO, DPO)
+- Tax rate (effective vs marginal)
+
+### Step 4: WACC Calculation
+
+**Weighted Average Cost of Capital:**
+
+```
+WACC = (E/V x Re) + (D/V x Rd x (1 - T))
+```
+
+Where:
+- E/V = Equity weight (market value)
+- D/V = Debt weight (market value)
+- Re = Cost of equity
+- Rd = Cost of debt (pre-tax)
+- T = Marginal tax rate
+
+#### Cost of Equity (CAPM)
+
+```
+Re = Rf + Beta x (Rm - Rf) + Size Premium + Company-Specific Risk
+```
+
+| Component | Description | Typical Range |
+|-----------|-------------|---------------|
+| Risk-Free Rate (Rf) | 10-year Treasury yield | 3.5% - 5.0% |
+| Equity Risk Premium (ERP) | Market return above risk-free | 5.0% - 7.0% |
+| Beta | Systematic risk relative to market | 0.5 - 2.0 |
+| Size Premium | Small-cap additional risk | 0% - 5% |
+| Company-Specific Risk | Unique risk factors | 0% - 5% |
+
+**Beta Estimation:**
+- Use 2-5 year weekly returns against broad market index
+- Unlevered betas for comparability, then re-lever to target capital structure
+- Consider industry median beta for stability
+
+#### Cost of Debt
+
+```
+Rd = Yield on comparable-maturity corporate bonds
+   OR
+Rd = Risk-Free Rate + Credit Spread
+```
+
+**Credit Spread by Rating:**
+| Rating | Typical Spread |
+|--------|---------------|
+| AAA | 0.5% - 1.0% |
+| AA | 1.0% - 1.5% |
+| A | 1.5% - 2.0% |
+| BBB | 2.0% - 3.0% |
+| BB | 3.0% - 5.0% |
+| B | 5.0% - 8.0% |
+
+### Step 5: Terminal Value
+
+Terminal value typically represents 60-80% of total enterprise value. Use two methods and cross-check.
+
+#### Perpetuity Growth Method
+
+```
+TV = FCF_n x (1 + g) / (WACC - g)
+```
+
+Where g = terminal growth rate (typically 2.0% - 3.0%, should not exceed long-term GDP growth)
+
+**Sensitivity:** Terminal value is highly sensitive to g. A 0.5% change in g can move enterprise value by 15-25%.
+
+#### Exit Multiple Method
+
+```
+TV = Terminal Year EBITDA x Exit EV/EBITDA Multiple
+```
+
+**Exit Multiple Selection:**
+- Use current trading multiples of comparable companies
+- Consider whether current multiples are at historical highs/lows
+- Apply a discount for lack of marketability if private
+
+**Cross-Check:** Both methods should yield similar results. Large discrepancies signal inconsistent assumptions.
+
+### Step 6: Enterprise to Equity Bridge
+
+```
+Enterprise Value
+- Net Debt (Total Debt - Cash)
+- Minority Interest
+- Preferred Equity
++ Equity Method Investments
+= Equity Value
+
+Equity Value / Diluted Shares Outstanding = Value Per Share
+```
+
+### Step 7: Sensitivity Analysis
+
+Always present results as a range, not a single point estimate.
+
+**Standard Sensitivity Tables:**
+1. WACC vs Terminal Growth Rate
+2. WACC vs Exit Multiple
+3. Revenue Growth vs Operating Margin
+
+**Scenario Analysis:**
+- Base case: Management guidance / consensus estimates
+- Bull case: Upside scenario with faster growth or margin expansion
+- Bear case: Downside scenario with slower growth or margin compression
+
+## 2. Comparable Company Analysis
+
+### Methodology
+
+1. **Select peer group** - Similar size, industry, growth profile, and margins
+2. **Calculate trading multiples** for each peer
+3. **Determine appropriate multiple range**
+4. **Apply to target company's metrics**
+
+### Common Multiples
+
+| Multiple | When to Use |
+|----------|-------------|
+| EV/Revenue | Pre-profit companies, high-growth tech |
+| EV/EBITDA | Most common for mature companies |
+| EV/EBIT | When D&A differs significantly across peers |
+| P/E | Stable earnings, financial services |
+| P/B | Banks, insurance, asset-heavy industries |
+| EV/FCF | Capital-light businesses with clean FCF |
+
+### Peer Selection Criteria
+
+- **Industry:** Same or closely adjacent sectors
+- **Size:** Within 0.5x to 2x of target revenue/market cap
+- **Geography:** Same primary markets
+- **Growth profile:** Similar revenue growth rates (within 5-10%)
+- **Margin profile:** Similar operating margin structure
+- **Business model:** Comparable revenue mix and customer base
+
+### Premium/Discount Adjustments
+
+| Factor | Adjustment |
+|--------|-----------|
+| Higher growth | Premium of 1-3x on EV/EBITDA |
+| Lower margins | Discount of 1-2x |
+| Smaller scale | Discount of 10-20% |
+| Private company | Discount of 15-30% (illiquidity) |
+| Control premium | Premium of 20-40% (for acquisitions) |
+
+## 3. Precedent Transaction Analysis
+
+### Methodology
+
+1. **Identify comparable transactions** in same industry
+2. **Calculate transaction multiples** (EV/Revenue, EV/EBITDA)
+3. **Adjust for market conditions** and deal-specific factors
+4. **Apply adjusted multiples** to target
+
+### Key Considerations
+
+- Transactions include control premiums (typically 20-40%)
+- Market conditions at time of deal affect multiples
+- Strategic vs financial buyer valuations differ
+- Consider synergy expectations embedded in price
+- More recent transactions carry greater relevance
+
+## 4. Valuation Framework Selection
+
+| Situation | Primary Method | Secondary Method |
+|-----------|---------------|-----------------|
+| Profitable, stable | DCF | Comparable companies |
+| High growth, pre-profit | Comparable companies (EV/Revenue) | DCF with scenario analysis |
+| M&A target | Precedent transactions | DCF |
+| Asset-heavy, cyclical | Asset-based valuation | Normalized DCF |
+| Financial institution | Dividend discount model | P/B, P/E comps |
+| Distressed | Liquidation value | Restructured DCF |
+
+## 5. Common Pitfalls
+
+1. **Hockey stick projections** - Unrealistic growth acceleration in later years
+2. **Terminal value dominance** - If TV > 80% of EV, shorten projection period or question assumptions
+3. **Circular references** - WACC depends on equity value which depends on WACC
+4. **Ignoring working capital** - Can significantly affect FCF
+5. **Single-point estimates** - Always present as a range
+6. **Stale comparables** - Market conditions change; update regularly
+7. **Confirmation bias** - Don't work backward from a desired conclusion
+8. **Ignoring dilution** - Use fully diluted shares (treasury stock method for options)