code-generation-developer

Code Generation Developer (Smart Router)

Purpose

Context-aware routing to code generation workflows: SwiftGen, Sourcery, Feature Flags, and Protobuf. Helps you navigate when and how to run generators.

When Auto-Activated

• Running or discussing make generate
• Adding feature flags
• Working with generated files
• Keywords: swiftgen, sourcery, feature flags, FeatureFlags, make generate

🚨 CRITICAL RULES (NEVER VIOLATE)

1. NEVER edit generated files - Files marked with // Generated using Sourcery/SwiftGen are auto-generated
2. ALWAYS run make generate after changes - When updating templates, flags, assets, or localization
3. Feature flags for all new features - Wrap experimental code for safe rollouts
4. Update source, not generated code - Edit templates/configurations, then regenerate

📋 Essential Commands

make generate        # Run all generators (SwiftGen, Sourcery, assets, localization)
make generate-middle # Regenerate middleware and protobuf (when dependencies change)
make setup-middle    # Initial middleware setup

🚩 Feature Flags Quick Workflow

1. Define Flag

File: /Modules/AnytypeCore/AnytypeCore/Utils/FeatureFlags/FeatureDescription+Flags.swift

extension FeatureDescription {
    static let newChatInterface = FeatureDescription(
        title: "New Chat Interface",
        type: .feature(author: "Your Name", releaseVersion: "0.42.0"),
        defaultValue: false,  // Off in production
        debugValue: true      // On in debug builds for testing
    )
}

2. Generate

make generate

This creates: Modules/AnytypeCore/AnytypeCore/Generated/FeatureFlags.swift

3. Use in Code

import AnytypeCore

if FeatureFlags.newChatInterface {
    NewChatView()
} else {
    LegacyChatView()
}

Flag Types

• .debug: Debug-only (not available in production)
• .feature(author:releaseVersion:): Production feature with metadata

Best Practices

• defaultValue: false for unreleased features
• debugValue: true for easier developer testing
• Remove flags after full rollout

🎯 When to Run make generate

You Did This	Run This	Why
Added/updated .xcstrings	make generate	Regenerate Loc constants
Added feature flag	make generate	Generate FeatureFlags enum
Added icon to Assets.xcassets	make generate	Generate Image asset constants
Modified Sourcery template	make generate	Regenerate code from templates
Updated middleware version	make generate-middle	Regenerate protobuf bindings

🎨 SwiftGen - Assets & Localization

Adding Icons

1. Export SVG from Figma (e.g., "32/qr code" → QRCode.svg)
2. Add to /Modules/Assets/.../Assets.xcassets/DesignSystem/x32/QRCode.imageset/
3. Run make generate
4. Use: Image(asset: .X32.qrCode)

Icon Sizes: x18, x24, x32, x40 (pt)

Localization

SwiftGen generates Loc constants from .xcstrings files.

See localization-developer skill for complete workflow.

🔧 Sourcery - Template-Based Generation

Sourcery generates Swift code from templates based on source file annotations.

Common uses:

• Protocol conformance
• Mock implementations
• Dependency injection
• Enum helpers

Workflow:

1. Add annotation to source file: // sourcery: AutoEquatable
2. Run make generate
3. Use generated code (don't edit generated files!)

🔌 Middleware & Protobuf

When to Regenerate

• Middleware version updated
• Dependencies/Middleware/Lib.xcframework missing binaries
• Build errors related to middleware symbols

Commands

make setup-middle    # Initial setup
make generate-middle # Regenerate middleware + protobuf

⚠️ Common Mistakes

Editing Generated Files

// In FeatureFlags.swift (GENERATED)
static let myFlag: Bool = true  // ❌ DON'T DO THIS
// Your changes will be overwritten

✅ Correct: Edit FeatureDescription+Flags.swift, then make generate

Forgetting to Generate

// Added FeatureDescription but didn't generate
if FeatureFlags.myNewFlag {  // ❌ Error: unresolved identifier
    ...
}

✅ Correct: Run make generate first

Missing Middleware Binaries

Symptoms: "Lib.xcframework missing binaries"

Solution: make setup-middle or make generate

📚 Complete Documentation

Full Guide: Modules/AnytypeCore/CODE_GENERATION_GUIDE.md

For comprehensive coverage of:

• Feature Flags lifecycle (Development → Beta → Rollout → Cleanup)
• SwiftGen configuration files and workflows
• Sourcery templates and annotations
• Protobuf splitting configuration
• Complete troubleshooting guide
• Generated file locations

✅ Checklist: Before Committing

• Ran make generate if you added/updated:
  • Feature flags
  • Icons/assets
  • Localization strings
  • Sourcery annotations
• Did NOT manually edit files with "// Generated using" header
• Committed both source AND generated files
• Verified build succeeds

🔗 Related Skills & Docs

• localization-developer → LOCALIZATION_GUIDE.md - Localization keys generated by SwiftGen
• ios-dev-guidelines → IOS_DEVELOPMENT_GUIDE.md - Never edit generated files
• design-system-developer → Icons generated by SwiftGen

---

Navigation: This is a smart router. For deep technical details, always refer to CODE_GENERATION_GUIDE.md.