golden-dataset

Builds idempotent, deterministic seeding tools for shared golden datasets in application replacement projects.

Updated Jul 24, 2026
One-click install
npx skills add https://github.com/shoji9x9/portfolio --skill golden-dataset-shoji9x9
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: golden-dataset
Source: https://github.com/shoji9x9/portfolio/tree/main/.agents/skills/golden-dataset
Command: npx skills add https://github.com/shoji9x9/portfolio --skill golden-dataset-shoji9x9

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve? When replacing an application without changing its specification, you cannot verify that the new side matches the current side unless both contain the same data. This Skill builds a shared golden dataset—specifically, an idempotent and deterministic seeding tool (TypeScript or SQL)—so current-vs-new comparisons compare values, not just structure. ## Core Features & Use Cases - Two-phase workflow: Phase A designs logical data and seeds the current test environment; Phase B maps that same logical data onto the new schema and verifies current-new parity per target. - Safety gates: Never touches production, requires both a config-derived gate (db.seedable / dataset_static_paths) and user confirmation before seeding, and keeps secrets out of logs and artifacts. - Versioned datasets: Bumps a dataset version whenever logical data changes so downstream parity baselines can detect staleness. - Use Case: During a legacy system rewrite, generate a seed tool that loads edge-case-rich, realistic test data into the current test DB, then later map and seed the same data into the new schema and verify that all differences match the declared intentional-diff registry. ## Quick Start Ask the AI to run golden-dataset to design and seed a deterministic test dataset for the current environment after replace-strategy setup is complete.

Frequently Asked Questions about golden-dataset

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

FAQPage Schema
How do I create a golden dataset for an application replacement project?▼

Run golden-dataset after completing replace-strategy setup. Phase A designs logical data from DDL constraints and the feature inventory, generates an idempotent seeding tool, and seeds the current test environment. Phase B later maps the same data to the new schema.

How do I seed test data into both legacy and new databases?▼

Use the two-phase approach: Phase A seeds the current side first since the new schema does not exist yet. Once parity-replace implements the new schema, run golden-dataset --phase b --feature <slug> --target <name> to map and seed the new side per target.

Can I use production data to build test datasets?▼

No. The Skill never references or seeds production environments and builds data from scratch with fixed IDs, sequences, UUIDs, and base times. Only non-production existing data may inform design, and only with a masking policy applied.

Why must seeding scripts be idempotent and deterministic?▼

Non-idempotent or random data breaks current-vs-new comparison because each run produces different values and states. The tool deletes then inserts in FK order with fixed values, so repeated runs always converge to the identical state on both sides.

What happens when parity testing finds missing test data?▼

parity-suite records data shortages in gaps.md, which routes back to this Skill for a Phase A re-run. The design is extended, the tool updated and re-seeded, the dataset version incremented, and affected baselines are flagged for re-capture.

Does golden-dataset work without a database?▼

Yes. With dataset_mode: static, the tool generates deterministic static data under dataset_static_paths in the repository instead of a database, so DB-less static sites still support the full Phase A and Phase B workflow.