ship-preflight

Validate TypeScript feature branches for type safety, schema consistency, and code hygiene.

Updated Jan 10, 2026
One-click install
npx skills add https://github.com/dain-agency/mood-tracker --skill ship-preflight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship-preflight
Source: https://github.com/dain-agency/mood-tracker/tree/main/.claude/skills/ship-preflight
Command: npx skills add https://github.com/dain-agency/mood-tracker --skill ship-preflight

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the risk of shipping code with hidden technical regressions (like type errors, schema mismatches, or leftover test debugging code) that are easily missed during human code review, reducing production bugs and unnecessary rework.

Core Features & Use Cases

  • Pre-Review Type Safety Checks: Clears stale TypeScript build caches and validates compilation for both web and API codebases, including test files, to catch hidden type regressions that standard builds might miss.
  • Code Hygiene Validation: Detects forbidden patterns like any types, console.log statements, and .only() calls in test files that violate project coding standards.
  • Cross-Layer Consistency Guards: Verifies alignment between frontend mutation data shapes and backend validation schemas, plus matches Prisma migration foreign key constraints to schema definitions to prevent silent persistence failures.
  • Use Case: A developer finishing a new feature branch can run this Skill to automatically catch 10+ common pre-review issues in seconds, instead of relying on human reviewers to spot them during code review.

Quick Start

Use the ship-preflight skill to run all final technical checks on your current feature branch worktree before requesting human code review.

Frequently Asked Questions about ship-preflight

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

FAQPage Schema
How do I catch TypeScript build regressions and schema mismatches before code review?

You can run automated pre-flight checks to catch TypeScript build regressions and Prisma schema mismatches before requesting human code review. This validates type safety, test hygiene, and cross-layer consistency on feature branches.

What is pre-review code hygiene validation for full-stack TypeScript projects?

Pre-review code hygiene validation is an automated process that detects forbidden patterns like `any` types, `console.log` statements, and `.only()` test calls in full-stack TypeScript projects to enforce project-specific coding standards before review.

How do I verify frontend and backend data shape consistency in a TypeScript application?

Cross-layer consistency guards verify alignment between frontend mutation data shapes and backend Zod validation schemas. This automated check prevents silent persistence failures by ensuring both layers expect matching data structures.

Does this automated regression testing work with Prisma and Zod schemas?

Yes, automated regression testing works with Prisma and Zod schemas by matching migration foreign key constraints to Prisma schema definitions and validating backend Zod schemas against frontend data shapes across separated API and web layers.

Why does my TypeScript build pass but hidden type regressions still exist in test files?

Hidden type regressions exist because standard builds often use stale caches and skip test file compilation. Clearing caches and forcing TypeScript compilation across web, API, and test files exposes these regressions before review.

What's the best way to automate pre-flight checks for feature branches without manual reviewer effort?

Automating pre-flight checks via a dedicated validation process runs final technical checks on feature branches, catching over ten common issues including type errors and schema mismatches in seconds before a human reviewer is involved.