add-config

name	add-config
description	Add a new configuration property to SessionFlow with all required wiring (model, Codable, UI binding, onChange observer)

Add Config Property

Scaffold a new configuration property with all required wiring. This skill ensures nothing is missed when adding settings.

Required Information

When invoked, determine:

• Property name and type (Bool, Int, String, enum, etc.)
• Default value
• Which config model it belongs to (SchedulingEngine, DeepSessionConfig, Preset, SessionAwarenessConfig, etc.)
• Where the UI binding goes (SettingsPanel, AppSettingsView, etc.)
• Whether it affects scheduling (needs onChange observer and use in generateSchedule)

Checklist (all 4 steps from CLAUDE.md)

1. Add property to model with Codable support

• Add the property with a default value
• Add to CodingKeys enum
• Add decodeIfPresent in init(from decoder:) with fallback to default (NEVER use decode without IfPresent — breaks backwards compat)
• Add encode in encode(to encoder:)

2. Add UI binding

• Add the appropriate SwiftUI control in the relevant settings view
• Use Binding(get:set:) pattern consistent with surrounding code
• Add caption text explaining the setting

3. Add onChange observer in ContentView

This is the most commonly missed step.

• Add .onChange(of: engine.<path>.newProperty) { _, _ in trigger() } in ContentView.swift → SettingsChangeModifier → extraObservers1 or extraObservers2
• The modifier has @EnvironmentObject var calendarService and @Binding var selectedDate
• Skip this step ONLY if the property doesn't affect timeline/schedule

4. Use in SchedulingEngine

• Reference the property in generateSchedule() or relevant service
• Skip if it's a UI-only or awareness-only setting

After completion

Run ./build_app.sh to verify everything compiles.