Skip to content

Contacts & RACI — commodity_hindcast

This page is a SCAFFOLD. Every cell marked [PLACEHOLDER] (abbreviated [PH] inside tables) must be filled in by the outgoing engineer in collaboration with the engineering lead before the handover sign-off page is countersigned. Do not assume any name, channel, or rotation listed here is authoritative until placeholders have been replaced. Scope is strictly the commodity_hindcast pipeline; crop_yield and weather pipelines have their own contacts pages.

Roles glossary

  • Responsible — does the work
  • Accountable — owns the outcome (single name, never a group)
  • Consulted — must be asked before deciding
  • Informed — kept in the loop after the fact
  • SME — subject matter expert (read-only authority on the area; consulted for correctness, not approval)

Active contributors (recent git history)

Source: git log --format="%an" market_insights_models/src/commodity_hindcast/ | sort -u | head -20

  • ai-tommytf
  • Miguel Boland
  • miguelboland-treefera

Note: these are git author handles only. Map each to a real person, current role, and current employment status when filling the RACI matrix below.

RACI matrix

Decision R A C I SME Notes
Production model deploy approval [PH] [PH] [PH] [PH] [PH] Triggered per-commodity release cut
Customer-facing CSV delivery sign-off [PH] [PH] [PH] [PH] [PH] Pre-delivery QA must pass first
Schema migrations to delivery [PH] [PH] [PH] [PH] [PH] Backwards-incompatible changes need broader Consulted set
DESIGN.md changes [PH] [PH] [PH] [PH] [PH] Architectural; record decision in decisions/
PR review for commodity_hindcast/ [PH] [PH] [PH] [PH] [PH] Default reviewers in CODEOWNERS [PH]
On-call escalation for delivery breaks [PH] [PH] [PH] [PH] [PH] See on-call section below
QA -> prod promotion (qa-test skill) [PH] [PH] [PH] [PH] [PH] Procedure lives in the qa-test skill, not duplicated here
MLflow DB backup / recovery [PH] [PH] [PH] [PH] [PH] Cf. mlruns.db.bak-YYYYMMDD-HHMMSS artefacts in repo root
Hindcast config changes (per-commodity YAML) [PH] [PH] [PH] [PH] [PH] E.g. corn_usa.yaml, soy, wheat
Diagnostics plot registry changes [PH] [PH] [PH] [PH] [PH] Affects every downstream report
Selection-bias correction methodology [PH] [PH] [PH] [PH] [PH] Open known bug; see MEMORY.md

Communication channels

No Slack or PagerDuty references were found inside commodity_hindcast/ documentation when this scaffold was generated; placeholders below must be filled from team knowledge.

Purpose Channel Owner Notes
Day-to-day eng discussion [PLACEHOLDER: e.g. #commodity-hindcast] [PH]
Delivery / customer-facing issues [PLACEHOLDER] [PH]
Pipeline alerts (automated) [PLACEHOLDER] [PH]
Cross-pipeline coordination (crop_yield, weather) [PLACEHOLDER] [PH]
Release announcements [PLACEHOLDER] [PH]
Incident war-room (ad hoc) [PLACEHOLDER] [PH] Convention for spinning one up

On-call

Component Rota Escalation chain Slack PagerDuty
Hindcast batch run [PH] [PH] -> [PH] -> [PH] [PH] [PH]
Delivery generation [PH] [PH] -> [PH] -> [PH] [PH] [PH]
MLflow tracking server [PH] [PH] -> [PH] -> [PH] [PH] [PH]
Upstream data feeds (NASS / WASDE / weather) [PH] [PH] -> [PH] -> [PH] [PH] [PH]

Stakeholders outside the engineering team

Stakeholder Role Email Notes
[PLACEHOLDER] Product [PH]
[PLACEHOLDER] Commercial / customer success [PH] Owns customer comms when delivery slips
[PLACEHOLDER] Domain / agronomy SME [PH]
[PLACEHOLDER] Data governance / compliance [PH]
[PLACEHOLDER] Finance (vendor invoices) [PH]

Vendor / external accounts

Account Purpose Owner Login URL
[PLACEHOLDER: AWS account] Compute, S3, ECR, ECS [PH] [PH]
[PLACEHOLDER: NASS API] US yield ground truth [PH] [PH]
[PLACEHOLDER: WASDE source] Reference forecasts [PH] [PH]
[PLACEHOLDER: weather provider] ERA5 / forecast feeds [PH] [PH]
[PLACEHOLDER: GitHub org] Source control [PH] [PH]
[PLACEHOLDER: MLflow host] Experiment tracking [PH] [PH]

Originating engineer

The engineer who initiated this handover scaffold is tommy.lees@treefera.com. They are listed here only for provenance; ownership of any decision above must be assigned explicitly via the RACI matrix and not inherited from this entry.

Action for the incoming engineer

  1. Read this page in full before contacting anyone.
  2. Schedule a 1:1 with each Accountable owner before assuming any decision is yours to make.
  3. Replace every [PLACEHOLDER] / [PH] cell with a real value, or explicitly mark "N/A — see " with a justification.
  4. Confirm the on-call rota with the named PagerDuty service before your first weekend on rotation.
  5. Cross-reference the qa-test skill for the QA -> prod promotion procedure rather than duplicating its steps here.
  6. Re-run git log --format="%an" market_insights_models/src/commodity_hindcast/ | sort -u | head -20 to refresh the contributors list before sign-off; people may have joined or left since this scaffold was written.