cross-layer-drift-sweep

Detect stale fields, defaults, and contracts across storage, runtime, adapters, and documentation layers.

1.3k|142|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/MiniMax-AI/minimax-code --skill cross-layer-drift-sweep-minimax-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cross-layer-drift-sweep
Source: https://github.com/MiniMax-AI/minimax-code/tree/main/.agents/skills/cross-layer-drift-sweep
Command: npx skills add https://github.com/MiniMax-AI/minimax-code --skill cross-layer-drift-sweep-minimax-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Type checking alone misses manual mappings, serialized fields, and assertions hidden behind casts, so cross-layer changes like renames or contract updates often leave stale references behind. This Skill systematically sweeps every layer that consumes a changed value before you report the work as complete. ## Core Features & Use Cases - Change Axis Classification: Records whether the change is a type narrowing, field rename, configuration default, contract evolution, or display wording update, with a gap checklist per axis. - Paired Old/New Search: Searches both old and new expressions across source, comments, tests, fixtures, snapshots, and documentation to reveal layers that adopted only part of a change. - End-to-End Verification: Requires an assertion at the final observable layer, such as rendered text, serialized output, or a database-backed read, plus affected tests and type checks. - Use Case: After renaming a configuration field that flows from storage through a local service to the TUI, use this Skill to find stale schema entries, outdated fixtures, and old labels in docs, then verify the rendered output reflects the new name. ## Quick Start After completing a rename or contract change, ask the agent to run a cross-layer drift sweep over the affected data flow and report any stale references.

Frequently Asked Questions about cross-layer-drift-sweep

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

FAQPage Schema
How do I find stale references after renaming a field across layers?

Search for both the old and new expressions across source, comments, tests, fixtures, snapshots, and documentation. Paired searches reveal layers that adopted only part of the rename, such as schemas, migrations, fixtures, and user-visible labels.

Why does type checking miss cross-layer drift after a contract change?

Type checking cannot catch manual mappings, serialized fields, or assertions hidden behind casts. These gaps appear in runtime writers, filesystem reads with casts, serializers, and adapter mappings that the compiler never validates.

When should I run a cross-layer drift sweep?

Run it after a rename or contract change that has downstream consumers across storage, runtime, adapters, TUI, or documentation. It is not intended for unrelated single-file edits with no cross-layer data flow.

What are common gaps when changing a configuration default?

Common gaps include stale defaults, thresholds, examples, log messages, status output, and documentation that still reference the old value. Check each layer that actually consumes the changed configuration rather than searching the whole repo blindly.

How do I verify a change reached the final consumer layer?

Assert behavior at the final observable layer, such as rendered text, serialized output, a local-service result, or a database-backed read. Reuse an existing assertion when it covers the behavior, and add one only when a meaningful regression gap exists.