Editorial Controls Split Migration

Migrate legacy depth_level to split editorial control fields across UI surfaces.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/JDL440/nfl-eval --skill editorial-controls-split-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Editorial Controls Split Migration
Source: https://github.com/JDL440/nfl-eval/tree/main/.squad/skills/editorial-controls-split-migration
Command: npx skills add https://github.com/JDL440/nfl-eval --skill editorial-controls-split-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This workflow helps teams migrate editorial controls from a legacy depth_level scalar to a richer split-field model (reader_profile, article_form, panel_shape, analytics_mode) without breaking existing articles or UI surfaces.

Core Features & Use Cases

  • Additive compatibility migration ensures legacy depth_level maps to new fields via canonical backfill (resolveEditorialControls) and preserves runtime behavior.
  • Phase-driven UI migration across schedules, new-idea, and home filter with tests to prevent data loss and user-facing regressions.
  • Backward-compat validation and per-surface rollout that keeps prompts and policy alignment in sync while supporting both old and new data paths.

Quick Start

Plan and execute an additive compatibility migration by validating the new fields against legacy depth and migrating UI surfaces sequentially.

Frequently Asked Questions about Editorial Controls Split Migration

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

FAQPage Schema
How do I migrate legacy scalar fields to a split-field model without breaking backward compatibility?

Migrate legacy scalar fields to a split-field model safely by using an additive compatibility migration that maps old values to new fields via a canonical backfill function, preserving runtime behavior for legacy data paths.

What is the best way to roll out editorial control changes across multiple UI surfaces?

Roll out editorial control changes across multiple UI surfaces using a phase-driven migration approach that sequentially updates schedules, new-idea, and home filters with targeted tests to prevent data loss and user-facing regressions.

How does a canonical resolveEditorialControls function handle both old and new data paths?

A canonical resolveEditorialControls function handles old and new data paths by mapping legacy depth_level values to the new split fields at runtime, ensuring prompts and runtime logic align with both data structures.

Can I update runtime policies and presets while supporting legacy article data?

You can update runtime policies and presets while supporting legacy article data by keeping EDITORIAL_PRESETS up to date and validating that backfill logic correctly resolves old depth_level values to the new field model.

When do I need an additive compatibility migration for editorial controls?

You need an additive compatibility migration for editorial controls when transitioning from a legacy depth_level scalar to a richer split-field model containing reader_profile, article_form, panel_shape, and analytics_mode without breaking existing articles.

What are the limitations of a phase-driven UI migration for editorial controls?

The limitation of a phase-driven UI migration is that prompts and runtime logic must continuously align with both old and new data paths throughout the rollout, requiring backward-compat validation at each surface to prevent regressions.