Initial commit

commands/ingest-pipeline.md

@@ -0,0 +1,33 @@
+---
+name: ingest-pipeline
+description: Aggregates CRM/MAP data, cleans records, and prepares forecast-ready pipeline views.
+usage: /revenue-forecasting-pipeline:ingest-pipeline --timeframe "Q1" --segments "enterprise,mm" --detail full
+---
+
+# Command: ingest-pipeline
+
+## Inputs
+- **timeframe** – forecast period (Q1, Q2, FY, rolling-90).
+- **segments** – comma-separated list of segments or regions.
+- **detail** – summary | full output verbosity.
+- **filters** – optional stage, product, or owner filters.
+- **refresh** – optional flag to force data refresh vs cached snapshot.
+
+## Workflow
+1. **Data Extraction** – pull CRM opportunities, bookings actuals, MAP signals, and enrichment fields by timeframe.
+2. **Normalization & QA** – dedupe, enforce stage definitions, check close dates, align currencies, and flag missing data.
+3. **Scoring & Cohorting** – compute coverage, velocity, win rate assumptions, and stage-based risk scores.
+4. **Segmentation** – split pipeline by segment, region, product, partner, and channel.
+5. **Packaging** – output structured tables + dashboards for forecast architect + finance partner review.
+
+## Outputs
+- Pipeline dataset (CSV/Sheets) with commit/upside/sandbag buckets.
+- Data quality log detailing issues resolved or pending.
+- Snapshot summary (coverage %, attainment, risk flags) per segment.
+
+## Agent/Skill Invocations
+- `revops-analyst` – runs extraction + QA steps.
+- `forecast-modeling` skill – provides scoring templates and coverage math.
+- `variance-analysis` skill – tags known risk cohorts for later tracking.
+
+---

commands/report-variance.md

@@ -0,0 +1,33 @@
+---
+name: report-variance
+description: Produces variance analysis, executive-ready narratives, and mitigation requests.
+usage: /revenue-forecasting-pipeline:report-variance --timeframe Q1 --audience exec --window 30d
+---
+
+# Command: report-variance
+
+## Inputs
+- **timeframe** – reporting period.
+- **audience** – exec | board | functional for tone/format.
+- **window** – lookback window for variance drivers.
+- **dimensions** – optional breakdown (segment, product, geo, channel).
+- **include_actions** – boolean to append mitigation plan.
+
+## Workflow
+1. **Data Synthesis** – combine actuals, forecast, and budget targets for selected timeframe.
+2. **Variance Attribution** – isolate drivers (volume, conversion, price, mix, churn) with supporting data.
+3. **Narrative Building** – craft storyline, highlight risks/opportunities, and cite owner insights.
+4. **Action Planning** – enumerate remediation or acceleration plays with due dates and impact estimates.
+5. **Distribution** – package slides/memos plus dashboard links for audience-specific channels.
+
+## Outputs
+- Variance table (actual vs forecast/budget) with driver notes.
+- Executive brief or board memo ready for delivery.
+- Action tracker summarizing owners, mitigation steps, and status.
+
+## Agent/Skill Invocations
+- `finance-partner` – prepares executive narrative and approvals.
+- `variance-analysis` skill – ensures methodical attribution.
+- `executive-briefs` skill – formats outputs for audience expectations.
+
+---

commands/run-forecast.md

@@ -0,0 +1,33 @@
+---
+name: run-forecast
+description: Generates revenue forecast scenarios, compares to targets, and highlights risks/opportunities.
+usage: /revenue-forecasting-pipeline:run-forecast --timeframe Q1 --scenario base --confidence 0.8
+---
+
+# Command: run-forecast
+
+## Inputs
+- **timeframe** – period to forecast (Q1, Q2, FY, rolling-90).
+- **scenario** – base | upside | downside | custom.
+- **confidence** – numeric (0-1) to tune risk weighting.
+- **drivers** – optional overrides for win rates, ASP, capacity, churn, expansion.
+- **notes** – optional context for scenario assumptions.
+
+## Workflow
+1. **Input Gathering** – pull pipeline snapshot, bookings actuals, macro assumptions, and overrides.
+2. **Driver Application** – adjust conversion rates, stage weightings, and coverage multipliers per scenario.
+3. **Model Execution** – compute bookings forecast, ARR impact, cash flow pacing, and contribution by segment.
+4. **Variance Comparison** – benchmark vs targets, prior forecast, and budget.
+5. **Insights & Actions** – flag risk areas, required pipeline creation, and mitigation plays.
+
+## Outputs
+- Scenario forecast table (segment → commit/upside/downside → delta vs goal).
+- Driver sheet summarizing assumptions and overrides.
+- Action plan for pipeline creation or acceleration.
+
+## Agent/Skill Invocations
+- `forecast-architect` – owns methodology and interpretation.
+- `forecast-modeling` skill – provides model templates + sensitivity analysis.
+- `revops-analyst` – validates inputs and risk tags.
+
+---