feature-flag-checker

Detect and audit feature-flag wiring inconsistencies across Clean Architecture layers.

1|Updated Apr 3, 2026

Search Tags:#testing #architecture #audit #code-quality #analyze #feature-flag

Ready to run

npx skills add https://github.com/jrmatherly/shipit --skill feature-flag-checker

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: feature-flag-checker
Source: https://github.com/jrmatherly/shipit/tree/main/.claude/skills/feature-flag-checker
Command: npx skills add https://github.com/jrmatherly/shipit --skill feature-flag-checker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detect and audit cross-layer wiring of feature flags to prevent flags from being defined or wired inconsistently across TypeSpec, Domain, Settings, Use Case, and Presentation layers.

Core Features & Use Cases

Cross-layer verification ensures a flag is defined and wired in every layer from TypeSpec to Presentation.
Generates a gap report with actionable remediation steps to fix missing or mismatched flags.
Useful during code reviews, feature releases, and governance checks to maintain flag consistency.

Quick Start

Run the checker against your codebase to validate flag wiring and generate a gap report.

Frequently Asked Questions about feature-flag-checker

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

FAQPage Schema

How do I audit feature flags for inconsistencies across Clean Architecture layers?▼

To audit feature flags across a Clean Architecture stack, run a cross-layer verification tool to identify missing or mismatched flag wiring from TypeSpec to Presentation, generating a gap report with actionable remediation steps.

What is feature flag cross-layer verification and when do I need it?▼

Feature flag cross-layer verification detects inconsistent flag wiring across TypeSpec, Domain, Settings, Use Cases, and Presentation layers, needed during code reviews, feature releases, and governance checks to maintain flag consistency.

How do I fix missing feature flags in my TypeSpec and Domain layers?▼

Fix missing feature flags in your TypeSpec and Domain layers by running a gap report tool that identifies missing definitions and wiring, providing actionable remediation steps for each layer.

Can I integrate feature flag consistency checks into my CI pipeline?▼

You can integrate feature flag consistency checks into your CI pipeline by applying the checker against your codebase, validating flag wiring across all layers and outputting a gap report during automated CI checks.

Does the feature flag checker support automated code reviews?▼

The feature flag checker supports automated code reviews by validating flag definitions, wiring, and tests across the entire architecture stack, producing a gap report with actionable remediation steps for code reviewers.

What are the limitations of using a gap report for feature flag auditing?▼

A gap report for feature flag auditing is limited to detecting structural inconsistencies across TypeSpec, Domain, Settings, Use Case, and Presentation layers, and does not evaluate runtime flag evaluation logic or dynamic flag state management.