@raishin/vanguard-frontier-agentic 2.7.1 → 2.8.0

package/skills/finance/finance-maestro/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: finance-maestro
+description: Route corporate finance questions to the narrowest specialist in the catalog. Use when you do not already know the specialist needed. Not for direct finance answers; Maestro classifies, dispatches, and synthesizes only. Dispatches single agent for focused tasks, parallel team (max 3) for multi-domain tasks. Never auto-dispatches any write-capable agent — requires explicit human confirmation before routing to any agent with planning system or ERP write access.
+allowed-tools: Agent Skill Read Grep Glob
+metadata:
+  author: "github: Raishin"
+  version: "0.1.0"
+  updated: "2026-06-01"
+  category: finance
+  lifecycle: experimental
+---
+
+# Finance Maestro — Routing Skill
+
+## Purpose
+
+Routes all corporate finance tasks to the narrowest matching specialist. Never answer finance questions directly; always route.
+
+## Domain Map
+
+| Task type | Route to | Example query |
+|---|---|---|
+| Budget vs. actual variance, YoY/QoQ analysis, MD&A commentary, restatement-risk scan | `finance-variance-analysis-advisor-agent` | "Our Q3 budget vs actual shows a $12M unfavorable variance. Run a price volume mix analysis and draft the MD&A management commentary for the board pack." |
+| Treasury, cash management, liquidity, cash pooling, FX exposure, Basel III LCR/NSFR, cash repatriation, capital controls | `finance-treasury-liquidity-advisor-agent` | "Review our cash management policy for the APAC entities, assess cash pooling structures, FX exposure from our Singapore hub, and confirm our LCR and NSFR ratios." |
+| Capital allocation, investment appraisal (NPV/IRR/MIRR/payback/PI), cost of capital (WACC/CAPM), hurdle rates, M&A valuation (DCF valuation/comparables/precedent/accretion dilution), buyback vs dividend, ROIC vs. WACC | `finance-capital-allocation-advisor-agent` | "Evaluate the capital allocation decision for the proposed $200M plant expansion using NPV and IRR. Compute our WACC under CAPM assumptions and compare against the corporate hurdle rate." |
+| Transfer pricing, arm's length principle, OECD TP Guidelines, CbCR (BEPS Action 13), Pillar Two GloBE (IIR/UTPR/QDMTT/safe harbors), GILTI/FDII | `finance-transfer-pricing-pillar-two-advisor-agent` | "Prepare intercompany transfer pricing documentation to demonstrate arm's length pricing under OECD guidelines, and calculate our Pillar Two GloBE top-up tax including the QDMTT safe harbor and CbCR data." |
+| FP&A, driver-based budgeting, rolling forecast, zero-based budgeting (ZBB), long-range plan, scenario analysis, Anaplan/Adaptive/OneStream/TM1 | `finance-fpa-forecasting-advisor-agent` | "Build a driver-based budgeting model with a rolling forecast for the next four quarters. Apply zero-based budgeting principles and produce a long-range plan through FY2030 using Anaplan." |
+| Debt & capital structure, leverage ratio, credit metrics (Net Debt to EBITDA, DSCR), debt instruments (RCF, TLA/TLB, high-yield bond, convertibles), debt covenant analysis, refinancing, credit rating, WACC optimization, Basel III/IV | `finance-debt-capital-structure-advisor-agent` | "Assess our capital structure and leverage ratio. Our Net Debt to EBITDA is approaching the debt covenant threshold and we need to evaluate refinancing options including a high-yield bond, considering the impact on our credit rating." |
+| Working capital management, cash conversion cycle (CCC), DSO/DPO optimization, factoring, supply chain finance/reverse factoring, accounts receivable financing, days payable, inventory, 13-week rolling cash forecasting, ABL | `finance-working-capital-advisor-agent` | "Optimize working capital by reducing DSO through improved collections and extending DPO via a supply chain finance program with reverse factoring. Analyze the full cash conversion cycle impact." |
+| Investor relations, earnings commentary, non-GAAP reconciliation | *(expand catalog)* | |
+
+## Boundary Resolution
+
+These boundaries prevent cross-domain routing confusion:
+
+- **Hedge accounting mechanics and FX statement translation belong to the ACCOUNTING maestro**, not treasury. `finance-treasury-liquidity-advisor-agent` owns FX exposure management, cash repatriation, and liquidity risk. It does NOT cover hedge accounting designation/effectiveness testing (ASC 815 / IFRS 9) nor functional-currency remeasurement or statement translation (ASC 830 / IAS 21) — those route to the accounting maestro's hedge-accounting and fx-translation specialists.
+- **Pillar Two GloBE / CbCR / TP computation → `finance-transfer-pricing-pillar-two-advisor-agent`.** Pillar Two deferred tax accounting (IAS 12.4A / ASC 740 amendments) routes to the accounting maestro's tax-provision agent, not here.
+- **Capital allocation = investment appraisal** (NPV, IRR, hurdle rate, DCF valuation, buyback vs dividend). **Debt & capital structure = financing and leverage decisions** (leverage ratio, Net Debt to EBITDA, refinancing, debt covenant, credit rating, high-yield bond). Both domains legitimately reference WACC: capital-allocation uses it for investment appraisal (cost-of-capital computation via CAPM); debt-capital-structure uses it for WACC optimization (capital structure mix decisions). When a request spans both investment appraisal and leverage/financing decisions, route in parallel to both agents.
+
+## When NOT to use
+
+Use Maestro only when you do not already know which specialist you need. Bypass Maestro when you already know the exact catalog agent ID.
+
+## Routing Rules
+
+- Single domain → one specialist; keep the routing header to 3 lines.
+- Multi-domain (2+ clear signals) → parallel specialists, hard ceiling of 3.
+- Any request implying write access to planning systems, ERP, or financial databases → live-guard gate (refuse; surface to human).
+- All questions are subject to routing. Never answer finance questions directly.
+- If no recognizable domain signals, ask one clarifying question. Do not answer directly.
+- Route only to agent IDs in `catalog/agents.json`.
+- Label claims as `documentation-based` or `inference`.
+- Never accept raw financial statements with company-identifying headers.
+
+## Response Shape
+
+```
+Route: <agent-name(s)>
+Reason: <one sentence>
+Mode: <single | parallel(N) | live-guard-gate>
+```
+
+Followed by: dispatched specialist output (synthesized), then recommended next actions and advisory note.
+
+## Safety Checklist
+
+Before every dispatch:
+- [ ] Agent ID exists in `catalog/agents.json`
+- [ ] Agent execution tier is `read-only-runtime`
+- [ ] No company-identifying financial data beyond classification minimum was accepted
+- [ ] All outputs will be labeled `advisory-draft`
+- [ ] No write-capable agent will be dispatched without explicit human confirmation

package/skills/finance/finance-maestro/metadata.json

@@ -0,0 +1,12 @@
+{
+  "id": "finance-maestro",
+  "name": "Finance Maestro Routing Skill",
+  "type": "skill",
+  "category": "finance",
+  "version": "0.1.0",
+  "author": "github: Raishin",
+  "lifecycle": "experimental",
+  "path": "skills/finance/finance-maestro",
+  "description": "Routing logic, domain map, and safety protocol for the finance domain maestro agent.",
+  "companion_agents": ["finance-maestro-agent"]
+}

package/skills/finance/fpa-forecasting-advisor/README.md

@@ -0,0 +1,21 @@
+# FP&A Forecasting & Budgeting Advisor Skill
+
+Reference framework for financial planning and analysis (FP&A) — driver-based budgeting, rolling forecasts, scenario and sensitivity analysis, zero-based budgeting (ZBB), budget-versus-actual variance analysis, long-range planning (LRP), integrated P&L/BS/CF modeling, xP&A, and FP&A technology platform selection.
+
+## Coverage
+
+- **Driver-based budgeting** — driver hierarchy design, revenue driver models by business model (SaaS ARR, manufacturing units × ASP, professional services utilization, retail basket size), model design principles, circularity risk, auditability, and US GAAP / IFRS / UK FRS 102 considerations (ASC 606 / IFRS 15 revenue recognition timing; ASC 842 / IFRS 16 lease treatment impact on EBITDA forecasts)
+- **Rolling forecasts** — configurations (monthly 12+0, quarterly 4+8, 6-quarter rolling), rolling vs. static budget comparison, forecast accuracy metrics (MAPE, bias, RMSE), lock-window discipline, driver ownership, and forecast vs. target separation governance
+- **Scenario and sensitivity analysis** — three-scenario framework (base / upside / downside), internal consistency requirements, tornado chart construction, two-variable sensitivity tables, Monte Carlo applicability and limitations, and ASC 606 / IFRS 15 variable consideration interaction
+- **Budget-vs-actual variance analysis** — revenue variance decomposition (volume / price / mix), expense variance decomposition (volume / rate), manufacturing standard cost variances (material price, material usage, labor rate, labor efficiency, overhead volume), MD&A materiality thresholds (SEC Reg S-K Item 303), and BvA vs. FvA governance distinction
+- **Long-range planning (LRP) and zero-based budgeting (ZBB)** — LRP construction sequence (strategic assumptions → revenue build → margin structure → integrated 3-statement model → WACC/terminal value → scenario overlay), ZBB decision-package methodology, cost classification (essential / value-adding / discretionary), ZBB variants (full / modified / rotational / mindset), and integrated P&L/BS/CF model validation checklist
+- **FP&A technology and xP&A** — platform landscape comparison (Anaplan, Adaptive Insights/Workday Adaptive Planning, OneStream XF, Vena, IBM Planning Analytics/TM1, Oracle EPM Cloud/EPBCS, SAP Analytics Cloud), platform selection evaluation criteria (functional, technical, TCO), xP&A integration dimensions (workforce/HR, sales/CRM, supply chain, marketing, capital planning), and data governance requirements (version control, access control, SOX audit trail)
+- **MD&A support and key risk flags** — MD&A narrative role of FP&A, forward-looking statement safe harbor (PSLRA), common modeling errors (circular references, unbalanced balance sheet, revenue timing mismatch, lease liability omission, forecast/target confusion, covenant breach risk)
+
+## Companion Agent
+
+`finance-fpa-forecasting-advisor-agent`
+
+## Standards and Frameworks Cited
+
+ASC 606, IFRS 15, ASC 842, IFRS 16, ASC 330, IAS 2, ASC 230, IAS 7, ASC 350-40, IAS 38, SEC Reg S-K Item 303 (17 CFR § 229.303), PSLRA (1995), UK FRS 102, CGMA Finance Business Partner Competency Framework, AFP Planning/Budgeting/Forecasting Guide, Gartner xP&A Research, Damodaran equity risk premium methodology

package/skills/finance/fpa-forecasting-advisor/SKILL.md

@@ -0,0 +1,428 @@
+---
+name: fpa-forecasting-advisor
+description: Reference framework for financial planning and analysis (FP&A) covering driver-based budgeting, rolling forecasts, zero-based budgeting (ZBB), scenario and sensitivity analysis, budget-versus-actual variance analysis, long-range planning (LRP), integrated P&L/balance sheet/cash flow modeling, xP&A (extended planning and analysis), FP&A technology platforms (Anaplan, Adaptive Insights/Workday Adaptive Planning, OneStream, Vena, IBM TM1/Planning Analytics), and MD&A narrative support. Applicable across US GAAP, IFRS, and UK FRS 102 reporting contexts. Advisory only — never writes to any planning system, ERP, or GL, and never accepts confidential forecast figures, MNPI, or company-identifying budget data.
+allowed-tools: Skill Read WebFetch Glob
+metadata:
+  author: "github: Raishin"
+  version: "0.1.0"
+  updated: "2026-06-03"
+  category: finance
+  lifecycle: experimental
+---
+
+# FP&A Forecasting & Budgeting Advisor Skill
+
+> Read-only reference framework. All conclusions are advisory. FP&A methodologies, platform capabilities,
+> and regulatory requirements evolve. Verify current best practices with qualified FP&A professionals and
+> auditors before implementing any forecast or budget process used in external reporting or board governance.
+
+---
+
+## Part 1 — Driver-Based Budgeting
+
+### 1.1 What Is Driver-Based Budgeting?
+
+Driver-based budgeting links financial line items to measurable operational or business drivers rather than building budgets from prior-year actuals with percentage increments. The core premise: if you control the drivers, you control the financial outcomes.
+
+**Key distinctions from traditional budgeting:**
+
+| Dimension | Traditional (Incremental) | Driver-Based |
+|---|---|---|
+| **Starting point** | Prior-year actuals | Operational drivers (units, headcount, capacity) |
+| **Update cadence** | Annual; rarely refreshed | Refreshable as drivers change |
+| **Accountability** | Finance owns line items | Operations owns driver assumptions |
+| **Variance analysis** | Unexplained variance buckets | Traceable to driver-level root causes |
+| **Scenario capability** | Limited; manual respinning | Embedded; drivers change → financials recompute |
+
+### 1.2 Driver Hierarchy
+
+A well-structured driver-based model follows a hierarchy:
+
+1. **External / macro drivers** — GDP growth, industry demand, commodity prices, FX rates (not controllable; modeled as assumptions).
+2. **Commercial drivers** — Volume (units sold, customers, ARR bookings), price (average selling price, discount rate), mix (product/channel/geography).
+3. **Operational drivers** — Headcount (by role, grade), utilization (capacity %), productivity (units per FTE), capital intensity (CapEx per unit of capacity).
+4. **Financial outputs** — Revenue (volume × price × mix), COGS (units × standard cost), OpEx (headcount × loaded cost per FTE), CapEx, working capital (DSO, DIO, DPO).
+
+### 1.3 Revenue Driver Design by Business Model
+
+| Business Model | Primary Revenue Driver | Supporting Drivers |
+|---|---|---|
+| **SaaS / subscription** | ARR (new bookings + expansion − churn) | Logo count, ARPU, NRR, churn rate |
+| **Manufacturing** | Units × ASP | Capacity utilization, yield, scrap rate, channel mix |
+| **Professional services** | Billable hours × bill rate | Utilization rate (%), headcount by grade, realization rate |
+| **Retail** | Transactions × basket size | Foot traffic, conversion rate, same-store sales growth |
+| **Financial services** | AUM × fee rate | AUM growth (net inflows + market performance), fee compression |
+| **Healthcare** | Patient visits × reimbursement rate | Payer mix, case mix, denial rate |
+
+### 1.4 Model Design Principles
+
+- **No circular references** without iterative calculation enabled; flag circularity risks (e.g., revenue-dependent bonuses feeding into SG&A).
+- **Single source of truth for each driver** — one input cell, referenced everywhere; no hardcoded repetition.
+- **Sensitivity flagging** — identify the top 5 drivers by model sensitivity (partial derivative of net income to each driver). These are the "model risk" levers.
+- **Auditability** — each financial output cell must be traceable to driver inputs through a documented formula chain.
+- **Version control** — freeze budget versions at board approval; maintain separate actuals-vs-budget overlay.
+
+### 1.5 US GAAP / IFRS / UK FRS 102 Considerations in Budget Design
+
+- **Revenue recognition timing (ASC 606 / IFRS 15):** Bookings or orders ≠ recognized revenue. Budget must incorporate recognition timing: percentage-of-completion, point-in-time delivery, variable consideration constraint (ASC 606-10-32-11 / IFRS 15.56). SaaS deferred revenue waterfall requires explicit modeling.
+- **Lease treatment (ASC 842 / IFRS 16 / FRS 102 Section 20):** Operating leases create ROU assets and lease liabilities on balance sheet under ASC 842 and IFRS 16; EBITDA impact differs (IFRS 16 removes rent from EBITDA, adding depreciation + interest). Budget and forecast models must reflect the correct standard.
+- **Revenue capitalization vs. expensing (ASC 350-40 / IAS 38):** Internal-use software costs: capitalize vs. expense decision affects R&D OpEx budget under both standards, with different criteria.
+
+---
+
+## Part 2 — Rolling Forecasts
+
+### 2.1 Rolling Forecast Defined
+
+A rolling forecast extends the planning horizon forward by one period each time a period closes, maintaining a fixed look-ahead window (typically 12 or 18 months). Unlike a static annual budget, the rolling forecast is continuously refreshed and does not expire at fiscal year-end.
+
+**Common configurations:**
+
+| Configuration | Re-forecast Frequency | Look-ahead Horizon | Best For |
+|---|---|---|---|
+| **Monthly 12+0** | Monthly | 12 months rolling | High-volatility businesses; SaaS, retail |
+| **Quarterly 4+8** | Quarterly | 12 months (4 quarters remaining) | Mid-market; moderate volatility |
+| **Quarterly rolling 6Q** | Quarterly | 6 quarters always visible | Companies requiring 18-month liquidity visibility |
+| **Monthly 18-month** | Monthly | 18 months rolling | Capital-intensive or project-based businesses |
+
+### 2.2 Rolling Forecast vs. Static Annual Budget
+
+| Characteristic | Static Annual Budget | Rolling Forecast |
+|---|---|---|
+| **Horizon** | Fixed 12 months (FY) | Always 12–18 months forward |
+| **Update trigger** | Annual; re-forecast mid-year optional | Monthly or quarterly; continuous |
+| **Decision relevance** | Decays as year progresses | Always decision-relevant |
+| **Gaming risk** | High (sandbagging, hockey sticking) | Reduced by continuous accountability |
+| **Management overhead** | Annual big-bang process | Ongoing; lighter per-cycle |
+| **Use as performance target** | Common | Separate target vs. forecast distinction required |
+
+**Critical governance point:** A rolling forecast should **describe what is expected**, not **what management wants**. Mixing target-setting into the forecast process reintroduces gaming. Best practice separates: (a) the rolling forecast (unbiased expectation), (b) annual targets (performance management), and (c) strategic plan (aspirational).
+
+### 2.3 Forecast Accuracy Metrics
+
+| Metric | Formula | What It Measures |
+|---|---|---|
+| **MAPE** | Mean(|Actual − Forecast| / Actual) × 100% | Average absolute percentage error; standard FP&A accuracy KPI |
+| **Bias** | Mean(Forecast − Actual) / Mean(Actual) × 100% | Systematic over- or under-forecasting tendency |
+| **RMSE** | √(Mean((Forecast − Actual)²)) | Penalizes large misses; useful for volatile line items |
+| **Forecast vs. Budget variance** | (Forecast − Budget) / |Budget| × 100% | Current forecast deviation from the locked annual budget |
+
+Gartner research (Finance Best Practices) suggests leading FP&A functions target MAPE < 5% for near-term (0–3 month) revenue forecasts and accept MAPE < 15% for 6–12 month horizons.
+
+### 2.4 Rolling Forecast Process Governance
+
+1. **Lock window:** Define which months/quarters are "locked" (no driver changes) vs. "open" (refresh window). Typical: current month + 1 locked; remaining horizon open.
+2. **Driver ownership:** Each driver has a named business owner responsible for the refresh assumption. Finance consolidates; operations provides driver inputs.
+3. **Materiality threshold:** Establish a materiality threshold for mandatory re-forecast triggers (e.g., >±5% variance in a key driver vs. last forecast triggers an out-of-cycle update).
+4. **Calendar discipline:** Set a consistent re-forecast close date (e.g., day 5 of each month) to enforce deadline adherence across business units.
+5. **Forecast vs. target separation:** Publish rolling forecast as a management information tool; maintain separate board-approved targets for incentive compensation.
+
+---
+
+## Part 3 — Scenario and Sensitivity Analysis
+
+### 3.1 Scenario Analysis Framework
+
+Scenario analysis tests the financial model under distinct, internally-consistent sets of assumptions representing plausible futures. Distinguish from sensitivity analysis (one-variable-at-a-time).
+
+**Standard three-scenario structure:**
+
+| Scenario | Characterization | Driver Posture |
+|---|---|---|
+| **Base case** | Most likely outcome; management's central expectation | Central driver assumptions |
+| **Upside case** | Favorable deviation; realistic optimistic outcome | Top-quartile driver performance |
+| **Downside case** | Adverse deviation; stress scenario; not worst-case | Adverse but plausible driver deterioration |
+| **Severe downside (optional)** | Stress test / going-concern assessment | Extreme but theoretically possible shock |
+
+**Scenario governance:** Each scenario must have a narrative ("what has to be true for this scenario to materialize") and be internally consistent (e.g., upside revenue without corresponding upside in COGS or headcount is not internally consistent).
+
+### 3.2 Sensitivity Analysis
+
+Sensitivity analysis varies one driver at a time while holding all others constant, measuring the impact on a target output (e.g., EBIT, EPS, free cash flow).
+
+**Tornado chart construction:**
+1. Define target output metric (e.g., annual EBIT).
+2. Identify top 8–12 drivers by model sensitivity.
+3. For each driver, compute output at +10% and −10% variation from base.
+4. Sort by absolute range of output change (widest bar = most sensitive driver).
+5. The tornado chart visualizes which drivers dominate model uncertainty.
+
+**Two-variable sensitivity table (data table):**
+Present output as a matrix (rows = driver 1 variation, columns = driver 2 variation). Common pairs: revenue growth rate × gross margin; headcount growth × attrition rate; ASP × volume.
+
+### 3.3 Monte Carlo Simulation Applicability
+
+Monte Carlo applies when:
+- Multiple drivers are uncertain and potentially correlated.
+- Management needs a probability distribution of outcomes (P10/P50/P90), not just point estimates.
+- Risk quantification is required for board, lenders, or auditors (e.g., for going-concern assessment, covenant compliance, or impairment testing).
+
+**Practical implementation:** Define probability distributions for top 5–10 uncertain drivers (triangular or PERT distributions for bounded variables; log-normal for positively skewed drivers). Run 1,000–10,000 simulations. Report P10 / P50 / P90 output distribution.
+
+**Limitation:** Monte Carlo requires driver correlation assumptions. Ignoring correlation (e.g., revenue and gross margin often decline together in a recession) understates downside tail risk.
+
+### 3.4 Revenue Scenario Modeling and ASC 606 / IFRS 15 Interaction
+
+Variable consideration (volume rebates, performance bonuses, clawbacks) must be constrained in revenue recognition: include only to the extent it is "highly probable" (IFRS 15.56) or "probable" (ASC 606-10-32-11) that a significant revenue reversal will not occur. In scenario models:
+- Upside revenue from volume bonuses may not be recognizable until threshold is met.
+- Downside scenarios triggering clawbacks require reversal of previously recognized variable consideration.
+- Forecast-to-actual variance analysis must separate recognized revenue from bookings and billings.
+
+---
+
+## Part 4 — Budget-vs-Actual Variance Analysis
+
+### 4.1 Variance Decomposition Framework
+
+A rigorous variance analysis decomposes the total budget-vs-actual (BvA) variance into attributable components. The classic decomposition for a P&L line item:
+
+**Revenue variance decomposition:**
+
+| Component | Formula | Interpretation |
+|---|---|---|
+| **Volume variance** | (Actual volume − Budget volume) × Budget price | Impact of selling more/fewer units than planned |
+| **Price/rate variance** | (Actual price − Budget price) × Actual volume | Impact of pricing higher/lower than budgeted |
+| **Mix variance** | Budget weighted average margin × (Actual mix − Budget mix) × Total actual volume | Impact of selling a different product/channel/geo mix |
+
+**Total variance = Volume + Price + Mix** (residual interaction terms are typically allocated to price or treated as a combined rate-volume variance).
+
+**Expense variance decomposition:**
+
+| Component | Formula | Interpretation |
+|---|---|---|
+| **Volume/activity variance** | (Actual activity − Budget activity) × Budget rate | Spending more/less because volume differed |
+| **Rate/efficiency variance** | (Actual rate − Budget rate) × Actual activity | Spending more/less per unit of activity than budgeted |
+
+### 4.2 Materiality Thresholds for Variance Reporting
+
+| Reporting Level | Typical Materiality Threshold | Escalation |
+|---|---|---|
+| **Operational (line-item)** | >±5% or >$[X] absolute | Business unit leader review |
+| **Segment / BU** | >±3% of segment revenue | CFO alert; corrective action plan |
+| **Consolidated** | >±2% of consolidated revenue | Board reporting; public guidance revision risk |
+| **MD&A disclosure (SEC Reg S-K Item 303)** | "Known trends or uncertainties that will have a material effect" | External disclosure required |
+
+**MD&A reference:** SEC Reg S-K Item 303 (17 CFR § 229.303) requires discussion of known trends, demands, commitments, events, or uncertainties reasonably likely to have a material effect on financial condition or results. Material BvA variances may trigger disclosure obligations for public companies.
+
+### 4.3 Standard Cost Variance (Manufacturing Contexts)
+
+For manufacturing entities, variance analysis extends to standard costing:
+
+| Variance | Formula | Standard | Interpretation |
+|---|---|---|---|
+| **Material price variance** | (Standard price − Actual price) × Actual quantity purchased | — | Purchasing efficiency vs. standard |
+| **Material usage variance** | (Standard quantity − Actual quantity) × Standard price | — | Production efficiency vs. standard bill of materials |
+| **Labor rate variance** | (Standard rate − Actual rate) × Actual hours | — | Payroll cost vs. standard |
+| **Labor efficiency variance** | (Standard hours − Actual hours) × Standard rate | — | Productivity vs. standard |
+| **Overhead volume variance** | Fixed overhead rate × (Budgeted volume − Actual volume) | — | Absorption impact of volume shortfall |
+
+Note: Standard costing and inventory valuation interact with ASC 330 (Inventory) and IAS 2 (Inventories). Abnormal production variances must be expensed as incurred under both standards (ASC 330-10-30-3; IAS 2.16).
+
+### 4.4 Forecast-vs-Actual vs. Budget-vs-Actual: Governance Distinction
+
+| Comparison | Purpose | Accountable Party | Review Cadence |
+|---|---|---|---|
+| **Budget vs. Actual (BvA)** | Performance vs. committed target | Business unit leaders; compensation-linked | Monthly; cumulative YTD |
+| **Forecast vs. Actual (FvA)** | Forecast accuracy / quality of prediction | FP&A team; model quality | Monthly; trailing 3–6 months |
+| **Prior-period actual vs. current actual** | Trend and organic growth analysis | Segment finance | Quarterly |
+
+---
+
+## Part 5 — Long-Range Planning (LRP) and Zero-Based Budgeting (ZBB)
+
+### 5.1 Long-Range Planning Framework
+
+A long-range plan (LRP) typically covers a 3–5 year horizon and serves as the bridge between the annual budget and the company's strategic plan. Key components:
+
+**LRP construction sequence:**
+1. **Strategic assumption setting** — top-down: market size (TAM/SAM), market share trajectory, pricing assumptions, macroeconomic inputs (GDP, inflation, FX).
+2. **Revenue build** — bottoms-up from commercial drivers (accounts, products, geographies) reconciled to top-down strategic assumptions.
+3. **Margin structure** — gross margin evolution (scale benefits, mix shift, input cost trajectory), operating leverage assumptions.
+4. **Integrated financial model** — P&L → working capital → CapEx → cash flow statement → balance sheet. Model must balance (∆Assets = ∆Liabilities + ∆Equity).
+5. **WACC and terminal value (for valuation-linked LRPs)** — CAPM-based equity cost (Damodaran equity risk premium methodology; Rf = current 10-year Treasury yield; β from comparable companies), plus cost of debt, target capital structure. Terminal value: Gordon Growth Model or EV/EBITDA exit multiple.
+6. **Sensitivity / scenario overlay** — LRP base, strategic upside, strategic downside.
+7. **LRP vs. budget reconciliation** — Year 1 of LRP should reconcile to the annual budget with documented variances.
+
+**LRP refresh cadence:** Typically annual (aligned with strategic planning cycle), with a mid-year "pulse check" for material assumption changes.
+
+### 5.2 Zero-Based Budgeting (ZBB)
+
+Zero-based budgeting requires each budget cycle to justify all expenditures from zero, rather than starting from prior-year actuals. Originally developed at Texas Instruments and popularized by Peter Pyhrr (1970s); widely re-adopted in private equity-backed portfolio companies and cost-optimization programs.
+
+**ZBB methodology:**
+
+1. **Decision package construction** — every cost center manager prepares packages describing activities, their costs, and their purpose, ranked by priority.
+2. **Cost classification** — classify all costs as: (a) essential / regulatory / contractual (must fund), (b) value-adding (fund if justified), (c) discretionary / nice-to-have (fund only after (a) and (b) satisfied).
+3. **Ranking and resource allocation** — management allocates funding across decision packages in priority order until budget envelope is exhausted.
+4. **Sunset rule** — every cost must be re-justified each cycle; no automatic carry-forward.
+
+**ZBB variants:**
+
+| Variant | Description | Best For |
+|---|---|---|
+| **Full ZBB** | All costs re-justified from zero annually | Turnaround / cost-crisis situations |
+| **Modified ZBB** | ZBB applied to discretionary spend only; fixed costs carry forward | Ongoing cost discipline without full re-justification overhead |
+| **Zero-based mindset** | Cultural orientation toward justifying every dollar; not a formal process | Embedded in rolling forecast governance |
+| **Rotational ZBB** | Different cost categories subjected to full ZBB on a rotating multi-year cycle | Sustainable long-term cost management |
+
+**ZBB vs. traditional budgeting:**
+
+| Dimension | Traditional (Incremental) | Zero-Based |
+|---|---|---|
+| **Starting point** | Prior-year actuals + ∆% | Zero |
+| **Time investment** | Lower (annual) | Higher (especially in first cycle) |
+| **Cost discovery** | Limited; stranded costs persist | High; surface hidden and stranded costs |
+| **Culture impact** | Reinforces existing spend patterns | Challenges assumptions; builds cost awareness |
+| **Risk** | Perpetuates inefficiencies | Operational disruption if poorly governed |
+
+### 5.3 Integrated P&L / Balance Sheet / Cash Flow Modeling
+
+A fully integrated financial model ensures the three statements are mechanically linked:
+
+- **P&L → Retained earnings** on balance sheet (Net income → Equity section).
+- **P&L → Cash flow statement** (Net income is the starting point for indirect method operating cash flows; ASC 230 / IAS 7).
+- **Working capital changes** (∆AR, ∆Inventory, ∆AP, ∆Deferred Revenue) flow from P&L assumptions to both the balance sheet and operating cash flows.
+- **CapEx** flows from the CapEx schedule to: (a) PP&E on the balance sheet, (b) investing activities on the cash flow statement.
+- **Depreciation** flows from the fixed asset schedule to: (a) COGS or SG&A on the P&L, (b) non-cash add-back in operating cash flows (indirect method).
+- **Debt / financing** — new borrowings / repayments flow through the balance sheet and financing activities; interest flows to P&L (and P&L → cash via interest paid in operating or financing activities per entity's accounting policy).
+- **Balance sheet check** — Total assets = Total liabilities + Total equity must hold every period. A persistent balance sheet imbalance indicates a modeling error.
+
+**Model validation checklist:**
+- [ ] Balance sheet balances every period
+- [ ] Cash per balance sheet ties to ending cash on cash flow statement
+- [ ] Retained earnings roll (Opening RE + Net income − Dividends = Closing RE) ties to equity section
+- [ ] Deferred revenue schedule reconciles to balance sheet deferred revenue line
+- [ ] Working capital drivers (DSO, DIO, DPO) are explicitly modeled and consistent with P&L assumptions
+
+---
+
+## Part 6 — FP&A Technology, xP&A, and Platform Selection
+
+### 6.1 Enterprise Planning Platform Landscape
+
+| Platform | Vendor | Architecture | Primary Strength | Typical User Profile |
+|---|---|---|---|---|
+| **Anaplan** | Anaplan Inc. | Cloud-native; Hyperblock in-memory calculation engine | Complex multi-dimensional connected planning; xP&A integration; large enterprise | Fortune 500; complex supply chain / workforce / financial integration |
+| **Adaptive Insights / Workday Adaptive Planning** | Workday | Cloud SaaS; sheet-based model structure | Ease of use; Workday HCM integration; mid-market to enterprise | Mid-market; Workday HCM customers |
+| **OneStream XF** | OneStream Software | Cloud; unified platform (consolidation + planning) | Combined CPM/EPM: closes the gap between consolidation and planning; single platform | Enterprises seeking to replace Hyperion suite |
+| **Vena Solutions** | Vena | Excel-based front-end; cloud database back-end | Excel familiarity; rapid time-to-value; mid-market | Mid-market; Excel-heavy FP&A teams |
+| **IBM Planning Analytics (TM1)** | IBM | On-premise or cloud; TM1 cube-based calculation engine | Complex allocations; custom logic; existing IBM ecosystem | Enterprises with complex allocation logic; IBM shops |
+| **Oracle EPM Cloud (EPBCS)** | Oracle | Cloud; Planning and Budgeting Cloud Service | Oracle ERP integration; existing Oracle EBS/Fusion customers | Oracle ERP customers; large enterprise |
+| **SAP Analytics Cloud (SAC)** | SAP | Cloud; integrated with SAP ERP/S/4HANA | SAP ERP native integration; real-time actuals | SAP ERP customers |
+
+### 6.2 Platform Selection Evaluation Criteria
+
+**Functional criteria:**
+- [ ] Driver-based modeling capability (formula flexibility vs. locked templates)
+- [ ] Scenario management (number of versions; scenario comparison views)
+- [ ] Rolling forecast support (horizon extension without rebuild)
+- [ ] Workflow and approval routing (budget submission, review, approval chains)
+- [ ] Reporting and visualization (self-service; board-quality output)
+- [ ] Writeback to ERP / GL (actuals pull; no-writeback to source required for advisory posture)
+
+**Technical criteria:**
+- [ ] Calculation performance at model scale (number of dimensions, data points, users)
+- [ ] ERP / source system integration (pre-built connectors vs. custom ETL)
+- [ ] Data governance (version control, audit trail, access controls)
+- [ ] Cloud architecture (SaaS vs. on-premise; disaster recovery)
+- [ ] API availability for xP&A integration
+
+**Total cost of ownership (TCO) factors:**
+- License cost (per user / per module / platform fee)
+- Implementation cost (internal FTE + system integrator)
+- Ongoing administration and model maintenance
+- Training and change management
+- ERP integration maintenance
+
+### 6.3 xP&A — Extended Planning and Analysis
+
+xP&A (extended planning and analysis), coined by Gartner (2020), extends financial planning to integrate operational plans across the enterprise into a unified, connected planning platform.
+
+**xP&A integration dimensions:**
+
+| Operational Domain | Integration with Financial Plan | Key Driver Link |
+|---|---|---|
+| **Workforce planning (HR)** | Headcount plan → SG&A, R&D, COGS (labor) | FTE additions/terminations × loaded cost per FTE |
+| **Sales planning (CRM)** | Pipeline → revenue forecast; quota → commissions | Win rate × pipeline by stage; ARR bookings |
+| **Supply chain / operations** | Production plan → COGS, inventory, CapEx | Units produced × standard cost; capacity CapEx |
+| **Marketing** | Campaign spend → demand generation → revenue | CAC, LTV, conversion rates by channel |
+| **Capital planning** | CapEx plan → PP&E, depreciation, cash flows | Project milestone payments; depreciation schedule |
+
+**xP&A governance requirements:**
+- Single definition of each shared driver (e.g., headcount: one authoritative source, not FP&A and HR maintaining separate counts).
+- Clear data lineage from operational system of record to planning platform.
+- Change management: operational business partners must understand how their inputs affect the financial model.
+
+### 6.4 FP&A Technology Data Governance
+
+- **Version control:** Lock budget and forecast versions at board approval; maintain read-only archive.
+- **Access control:** Role-based access; input access only to data owners; read-only for downstream consumers.
+- **Audit trail:** Log all model changes (who, when, what) — required for SOX-controlled entities (public companies subject to Sarbanes-Oxley Act, 15 U.S.C. § 7201 et seq.).
+- **Data validation rules:** Prevent logically impossible inputs (e.g., negative headcount, revenue without corresponding COGS for unit-based models).
+- **Actuals integration:** Pull actuals from ERP/GL on a defined schedule; avoid manual re-entry. Automated actuals feeds reduce reconciliation risk.
+
+---
+
+## Part 7 — MD&A Support, Best Practices, and Mandatory Advisory Note
+
+### 7.1 MD&A Narrative Support
+
+The Management's Discussion and Analysis (MD&A) section of public company filings (SEC Form 10-K / 10-Q; IFRS Management Commentary; UK Strategic Report) requires narrative explanation of financial results, including BvA comparisons, known trends, and forward-looking factors.
+
+**FP&A's role in MD&A:**
+- Provide the variance analysis narrative underlying the quantitative disclosures.
+- Identify "known trends or uncertainties" (SEC Reg S-K Item 303 / 17 CFR § 229.303) that are reasonably likely to have a material effect on financial condition.
+- Prepare the liquidity and capital resources section, including covenant compliance status and free cash flow reconciliation.
+- Draft the critical accounting estimate disclosures related to revenue recognition (ASC 606 variable consideration; IFRS 15.122) and impairment testing where forecast assumptions are key inputs.
+
+**Forward-looking statement safe harbor:** SEC Rule 10b-5 and the Private Securities Litigation Reform Act of 1995 (PSLRA) provide safe harbor for forward-looking statements accompanied by meaningful cautionary language identifying important factors that could cause actual results to differ materially. FP&A teams must coordinate with legal counsel before including forward-looking statements in public disclosures.
+
+### 7.2 Key FP&A Standards and Frameworks Reference
+
+| Standard / Framework | Organization | Relevance to FP&A |
+|---|---|---|
+| **ASC 606 / IFRS 15** | FASB / IASB | Revenue recognition timing — directly affects revenue forecast-to-actual comparison |
+| **ASC 842 / IFRS 16** | FASB / IASB | Lease treatment — affects EBITDA forecast; ROU asset in balance sheet model |
+| **ASC 350-40 / IAS 38** | FASB / IASB | Internal-use software / intangible capex vs. opex — affects R&D and CapEx budget |
+| **ASC 330 / IAS 2** | FASB / IASB | Inventory valuation — standard cost variances; abnormal cost expensing |
+| **ASC 230 / IAS 7** | FASB / IASB | Cash flow statement — direct vs. indirect method; classification of interest paid |
+| **SEC Reg S-K Item 303** | SEC | MD&A disclosure requirements — known trends; material variance disclosure |
+| **PSLRA (1995)** | US Congress | Safe harbor for forward-looking statements in public filings |
+| **CGMA Finance Business Partner Competency Framework** | CGMA / AICPA-CIMA | FP&A professional competency standards |
+| **AFP FP&A Guide** | Association for Financial Professionals | Best practices for planning, budgeting, and forecasting |
+| **Gartner xP&A Research** | Gartner | Extended planning and analysis platform selection and integration |
+| **UK FRS 102 Section 3 / Section 20** | FRC | Financial statement presentation; lease treatment for UK entities |
+
+### 7.3 Common FP&A Modeling Errors and Risk Flags
+
+| Error | Risk | Mitigation |
+|---|---|---|
+| **Circular references without iterative calculation** | Model crashes or returns incorrect values | Audit formula dependencies; use iterative calculation flag only where intentional |
+| **Hardcoded assumptions inside formula chains** | Driver change does not flow through to output | Enforce single-input-cell discipline; use named ranges or structured references |
+| **Balance sheet does not balance** | Model is mechanically broken; cash flow statement unreliable | Add balance check row; investigate imbalance before using model for decisions |
+| **Revenue recognized at booking date without recognition waterfall** | Overstates near-term revenue vs. ASC 606 / IFRS 15 | Model deferred revenue schedule; align recognized revenue to delivery milestones |
+| **Ignoring lease liability in cash flow model (ASC 842 / IFRS 16)** | Understates debt service and financing outflows | Include lease principal payments in financing activities; lease interest in operating |
+| **Confusing forecast with target** | Gaming; forecast bias; management mistrust | Separate forecast (expectation) from target (performance management) |
+| **Assuming prior-year growth rate without driver basis** | Incremental budgeting masquerading as driver-based | Require explicit driver decomposition for every major revenue and cost line |
+| **Not stress-testing covenant compliance in downside scenario** | Covenant breach risk undetected until too late | Model debt covenants explicitly; show headroom in downside scenario |
+
+### 7.4 Official Documentation URLs
+
+| Resource | URL | Access |
+|---|---|---|
+| **ASC 606** (Revenue from Contracts with Customers) | [asc.fasb.org](https://asc.fasb.org/) → search "606" | Free with registration |
+| **IFRS 15** (Revenue from Contracts with Customers) | [ifrs.org/issued-standards/list-of-standards/ifrs-15](https://www.ifrs.org/issued-standards/list-of-standards/ifrs-15-revenue-from-contracts-with-customers/) | Free with registration |
+| **ASC 842** (Leases) | [asc.fasb.org](https://asc.fasb.org/) → search "842" | Free with registration |
+| **IFRS 16** (Leases) | [ifrs.org/issued-standards/list-of-standards/ifrs-16](https://www.ifrs.org/issued-standards/list-of-standards/ifrs-16-leases/) | Free with registration |
+| **ASC 230** (Statement of Cash Flows) | [asc.fasb.org](https://asc.fasb.org/) → search "230" | Free with registration |
+| **IAS 7** (Statement of Cash Flows) | [ifrs.org/issued-standards/list-of-standards/ias-7](https://www.ifrs.org/issued-standards/list-of-standards/ias-7-statement-of-cash-flows/) | Free with registration |
+| **SEC Reg S-K Item 303** (MD&A) | [ecfr.gov/current/title-17/chapter-II/part-229/subpart-229.300/section-229.303](https://www.ecfr.gov/current/title-17/chapter-II/part-229/subpart-229.300/section-229.303) | Fully public |
+| **UK FRS 102** | [frc.org.uk — FRS 102](https://www.frc.org.uk/library/standards-codes-policy/accounting/uk-and-ireland-accounting-standards/standards-in-issue/frs-102-the-financial-reporting-standard-applicable-in-the-uk-and-republic-of-ireland/) | Fully public |
+| **CGMA Finance Business Partner Framework** | [cgma.org/resources/tools/essential-tools/budgeting-forecasting.html](https://www.cgma.org/resources/tools/essential-tools/budgeting-forecasting.html) | Free with registration |
+| **AFP Planning, Budgeting and Forecasting Guide** | [afponline.org](https://www.afponline.org/ideas-inspiration/resources/articles/Details/planning-budgeting-forecasting) | Member access / public summaries |
+
+---
+
+## Mandatory Advisory Note
+
+This analysis is advisory and based solely on the scenario described. FP&A methodologies, planning platform capabilities, accounting standards, and regulatory disclosure requirements evolve. Consult qualified FP&A professionals, external auditors, and legal counsel before implementing any forecast or budget process used in external reporting, board governance, or public disclosure. This skill does not constitute investment advice, financial advice, securities analysis, or an accountant-client relationship.

package/skills/finance/fpa-forecasting-advisor/metadata.json

@@ -0,0 +1,27 @@
+{
+  "id": "fpa-forecasting-advisor",
+  "name": "FP&A Forecasting & Budgeting Advisor",
+  "type": "skill",
+  "provider": "finance",
+  "category": "finance",
+  "summary": "Reference framework for financial planning and analysis (FP&A) covering driver-based budgeting, rolling forecasts, zero-based budgeting (ZBB), scenario and sensitivity analysis, budget-versus-actual variance analysis, long-range planning (LRP), integrated P&L/balance sheet/cash flow modeling, xP&A, FP&A technology platforms (Anaplan, Adaptive Insights/Workday Adaptive Planning, OneStream, Vena, IBM TM1/Planning Analytics, Oracle EPM), and MD&A narrative support. Applicable across US GAAP, IFRS, and UK FRS 102 reporting contexts.",
+  "source_type": "original",
+  "path": "skills/finance/fpa-forecasting-advisor",
+  "author": "github: Raishin",
+  "version": "0.1.0",
+  "last_verified": "2026-06-03",
+  "lifecycle": "experimental",
+  "execution_tier": "read-only-runtime",
+  "provider_coverage": ["gaap", "ifrs", "frs102", "asc606", "ifrs15", "asc842", "ifrs16", "cgma", "afp", "sec-md-a"],
+  "official_docs": [
+    "https://asc.fasb.org/",
+    "https://www.ifrs.org/issued-standards/list-of-standards/ifrs-15-revenue-from-contracts-with-customers/",
+    "https://www.ifrs.org/issued-standards/list-of-standards/ifrs-16-leases/",
+    "https://www.ifrs.org/issued-standards/list-of-standards/ias-7-statement-of-cash-flows/",
+    "https://www.ecfr.gov/current/title-17/chapter-II/part-229/subpart-229.300/section-229.303",
+    "https://www.frc.org.uk/library/standards-codes-policy/accounting/uk-and-ireland-accounting-standards/standards-in-issue/frs-102-the-financial-reporting-standard-applicable-in-the-uk-and-republic-of-ireland/",
+    "https://www.cgma.org/resources/tools/essential-tools/budgeting-forecasting.html",
+    "https://www.afponline.org/ideas-inspiration/resources/articles/Details/planning-budgeting-forecasting"
+  ],
+  "security_notes": "Advisory only — never writes to any planning system, ERP, or GL. Accepts only descriptive scenario inputs; never accepts confidential forecast figures, MNPI, internal budget data, or budget spreadsheets with company-identifying financial data. All conclusions are advisory. Does not constitute investment advice, financial advice, or an accountant-client relationship."
+}

package/skills/finance/transfer-pricing-pillar-two-advisor/README.md

@@ -0,0 +1,21 @@
+# Transfer Pricing & Pillar Two Advisor Skill
+
+Multi-jurisdiction reference framework for OECD transfer pricing and Pillar Two GloBE rules.
+
+## Coverage
+
+- **TP methods:** CUP, resale price, cost-plus, TNMM, profit split — selection criteria, comparability analysis, arm's length range / IQR
+- **BEPS Action 13 documentation:** Master file, local file, CbCR — €750M threshold, Form 8975 (US), constituent entity definition, penalty protection
+- **Special TP topics:** Low-value services safe harbor (5% markup), business restructurings / HTVI, financial transactions (intercompany loans, cash pooling, guarantees) per OECD 2020 Chapter X guidance
+- **GILTI / FDII:** §951A tested income and QBAI, §250 deduction, interaction with arm's length pricing
+- **Pillar Two GloBE:** IIR, UTPR, QDMTT charging rules; ETR computation (covered taxes / GloBE income); SBIE payroll and tangible asset carve-outs (5%–9.8% transitional rates); transitional CbCR safe harbor; QDMTT safe harbor; permanent de minimis
+- **Deferred tax divergence:** IAS 12.4A mandatory temporary exception (no Pillar Two DTA/DTL); ASC 740 (no exception); ETR and disclosure implications
+- **Jurisdiction-specific regimes:** US §482 / APA / GILTI / FDII; UK TIOPA 2010 / DPT; Germany § 1 AStG / FVerlV; Japan Articles 66-4; China SAT Announcement 2016 No.42; India Section 92-92F / Safe Harbour Rules
+
+## Companion Agent
+
+`finance-transfer-pricing-pillar-two-advisor-agent`
+
+## Standards Cited
+
+OECD Transfer Pricing Guidelines (2022), OECD GloBE Model Rules, BEPS Action 13, IRC §482, §951A (GILTI), §250 (FDII), TIOPA 2010, DPT (Finance Act 2016), § 1 AStG, FVerlV, STML Art. 66-4 (Japan), EITL Chapter 6 / SAT Announcement 2016 No.42 (China), IT Act §§92–92F / Rule 10TD (India), IAS 12.4A, ASC 740