training-storage-architect

Design reproducible lakehouse storage for training data on Kubernetes with Iceberg, MinIO, and lineage.

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/Cloud-Byte-Consulting/plugins --skill training-storage-architect-cloud-byte-consulting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: training-storage-architect
Source: https://github.com/Cloud-Byte-Consulting/plugins/tree/main/research-data-platform/skills/training-storage-architect
Command: npx skills add https://github.com/Cloud-Byte-Consulting/plugins --skill training-storage-architect-cloud-byte-consulting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Training and evaluation data on Kubernetes often lacks reproducibility: teams cannot answer which exact bytes trained a given checkpoint months later. This Skill guides the design of a lakehouse storage substrate — zone layout, table format selection, snapshot retention, and dataset-to-checkpoint lineage — so training inputs remain byte-reproducible and auditable. ## Core Features & Use Cases - Zone architecture: Defines medallion zones (landing, raw, cleansed, curated) plus research-specific feature/training and frozen eval zones with per-zone retention and access policies. - Table format decision: Compares Iceberg, Delta Lake, and Hudi across schema evolution, partition evolution, time travel, and ecosystem criteria, with an ADR-ready decision rule. - Versioning and lineage: Specifies dataset pinning conventions, immutable materialized-input manifests with content hashes, snapshot retention SLOs, and eval isolation with contamination gates. - Deployment planning: Covers MinIO/S3 on Kubernetes, Iceberg REST catalog HA, Spark and Trino compute, throughput budgeting, and lifecycle jobs. - Use Case: A research platform team needs to guarantee that any model checkpoint can be traced back to its exact training bytes a year later; the Skill produces the zone map, format ADR, lineage spec, and a golden-path reproducibility test as acceptance criteria. ## Quick Start Use the training-storage-architect skill to design a reproducible lakehouse storage layout for our training corpora on Kubernetes with MinIO and Iceberg.

Frequently Asked Questions about training-storage-architect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make training data reproducible on a data lake?

Pin each training run to a dataset version, table snapshot ID, and an immutable materialized-input manifest containing ordered object paths, content hashes, transform code revision, image digest, loader version, and seed. Set explicit snapshot retention SLOs so time travel still works when you need to reproduce the run.

Iceberg vs Delta vs Hudi: which table format for training workloads?

Iceberg is the default for batch-heavy training pipelines on Kubernetes and MinIO due to partition evolution, multi-file-format support, and a vendor-neutral REST catalog. Choose Hudi for streaming/upsert-heavy ingestion and Delta when committed to a Databricks-centric stack.

How should eval datasets be isolated from training data?

Eval sets live in a physically separate prefix or bucket with a distinct access policy, are frozen at creation, and are never edited in place. A contamination scan runs before an eval snapshot is published, and any breach is fixed by publishing a new eval version.

Why did my pinned training snapshot stop being reproducible?

The most common cause is a default vacuum or snapshot-expiry job deleting history that a pinned read depends on. Retention must be an explicit contracted SLO, and compaction or expiry jobs must encode those retention values rather than ship with defaults.

Can Spark and Trino read the same lakehouse tables?

Yes. Both engines read the same Iceberg tables over one copy of data: Spark on Kubernetes handles curation jobs while Trino serves interactive SQL across all zones, connected through a shared Iceberg REST catalog backed by HA Postgres.