🛡️ Safe Feature Addition: Ship Without Breaking

What This Does

This skill provides a Universal Safety Net for adding new features to production systems across any framework or language. It implements an "Additive Development" philosophy where new code lives alongside old code, protected by feature flags and gradual rollouts.

[!IMPORTANT] The Golden Rule: Always favor additive changes over destructive modifications. Existing code should remain untouched and functional.

🏗️ The Production Toolkit

This skill is powered by a unified safety engine compatible with JS, TS, Python, Go, Rust, and Ruby:

safe-feature verify

safe-feature audit

feature-flags.yml

🚀 Step 1: Additive Development (Universal)

Instead of changing an existing function, extend it or create a new one.

JavaScript / TypeScript

// ✅ ELITE & ADDITIVE - Backward compatible
function processPayment(amount, method = 'credit-card') {
  if (method === 'crypto') return crypto(amount);
  return legacyPayment(amount);
}

Python

# ✅ ELITE & ADDITIVE - Backward compatible
def process_payment(amount, method='credit_card'):
    if method == 'crypto': return crypto(amount)
    return legacy_payment(amount)

🚩 Step 2: Feature Flags (The Kill Switch)

Wrap all new logic in feature flags. This allows you to deploy code to production while it is still "dormant".

1. Define the Flag (YAML/JSON)

# feature-flags.yml
new_feature_v2:
  enabled: false
  rollout_percentage: 0  # Start at 0% traffic

2. Guard the Code

// Works in React, Vue, Svelte, etc.
if (flags.isEnabled('new-feature-v2', user.id)) {
  return <NewComponent />;
}
return <LegacyComponent />;

3. Verify Deployment

Before you ship, run the safety check to ensure config matches code:

python scripts/safe-feature.py verify --path ./src --config ./feature-flags.yml

🔍 Step 3: Git Safety Audit

Before merging your PR, run the Universal Safety Auditor to detect destructive changes that might break production.

# Audits your current branch against master/main
python scripts/safe-feature.py audit --base main

The Auditor detects:

• Modified function signatures without default values.
• New code blocks without feature flag guards.
• Potential "Big Bang" changes that increase risk.

📈 Step 4: Gradual Rollout (Canary Schedule)

Never switch a feature to 100% on Day 1. Use an industry-standard gradual schedule:

🛠️ Performance & Safety Checklist

• Is the change additive? (Yes/No)
• Is there a Feature Flag? (Yes/No)
• Did you run

  safe-feature verify

  ? (Yes/No)
• Is the Database Migration backward-compatible? (Yes/No)
• Is there a Kill Switch? (Yes/No)

Success = Zero Downtime + Instant Rollback. 🚀