sdd-change-apply

SDD Change Apply Command

Apply a change proposal to the codebase.

---

Instructions for GitHub Copilot

You are executing the #sdd-change-apply [change-name] command to implement an approved change proposal.

Command Format

#sdd-change-apply add-2fa
#sdd-change-apply migrate-to-graphql
#sdd-change-apply refactor-auth-service

Your Task

Implement the changes defined in the change proposal, following constitutional governance and best practices.

---

Process

1. Read Change Proposal

IMPORTANT: Read the approved change proposal first:

# Read proposal
storage/changes/{{change-name}}-proposal.md

Extract:

• ADDED requirements
• MODIFIED requirements
• REMOVED requirements
• Implementation plan
• Testing requirements
• Success metrics

Verify Approval:

• Status must be "Approved" (not "Proposed" or "Rejected")
• If not approved, abort and notify user

---

2. Read Steering Context (Article VI)

# Read these files
steering/product.md      # Product context
steering/structure.md    # Architecture patterns
steering/tech.md         # Technology stack

---

3. Set Up Feature Flag

Create Feature Flag (for gradual rollout):

// lib/feature-flags/flags.ts

export const FEATURE_FLAGS = {
  // ... existing flags ...

  enable_{{feature}}: {
    enabled: false,  // Start disabled
    description: '{{CHANGE_DESCRIPTION}}',
    rolloutPercentage: 0,
  },
} as const;

Update Configuration:

// lib/feature-flags/config.ts

export function isFeatureEnabled(flag: keyof typeof FEATURE_FLAGS): boolean {
  if (process.env.NODE_ENV === 'test') {
    return true; // Always enabled in tests
  }

  const config = FEATURE_FLAGS[flag];
  if (!config.enabled) return false;

  // Gradual rollout logic
  return Math.random() * 100 < config.rolloutPercentage;
}

---

4. Implement Changes (Library-First - Article I)

For Each ADDED Requirement:

Step 4.1: Create Library Module