codebase-maintainability-guardrails

What problem does it solve?

This Skill eliminates codebase degradation from unstructured development practices, including oversized "god" files, unorganized utility dumps, global CSS sprawl, and accidental product behavior changes during refactoring.

Core Features & Use Cases

• Structured Code Enforcement: Mandates thin entrypoints, focused 250-400 LOC feature modules, separated pure domain logic, and centralized client-server type contracts to keep codebases easy to edit and review.
• Production Stability Protection: Preserves existing behavior, persisted state, database schemas, and API contracts during refactors, requiring compatibility normalizers and migrations instead of destructive resets.
• Built-in QA Guardrails: Includes pre-finish checklists, targeted testing for risky paths (migrations, reducers, API contracts), and visual viewport checks for UI changes to catch regressions early.
• Use Case: When refactoring a legacy frontend app, use this Skill to split oversized route files into feature-owned modules, ensure no existing user flows break, and keep styling consistent with centralized Tailwind tokens.

Quick Start

Use the codebase-maintainability-guardrails skill to refactor the existing user dashboard feature while preserving all current user behavior and splitting the oversized dashboard module into focused, testable files.