diff --git a/CHANGELOG.md b/CHANGELOG.md index 5797bb4..221428c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,13 @@ All notable changes to this project are documented in this file. +## [0.0.36] - 2026-10-09 + +### Added + +- Added SwiftUI animation guidance favoring purposeful native feedback, default SwiftUI animation, system transitions, and SF Symbol effects while keeping animations scoped and interactions responsive. +- Required an explicit task-prompt request before adding app-level Reduce Motion guards, while preserving accessibility behavior supplied automatically by native system components. + ## [0.0.35] - 2026-09-27 ### Changed diff --git a/Guidelines/Swift/SwiftUI.md b/Guidelines/Swift/SwiftUI.md index 82b7cbb..d97f427 100644 --- a/Guidelines/Swift/SwiftUI.md +++ b/Guidelines/Swift/SwiftUI.md @@ -50,6 +50,13 @@ With SDKs where `@State` is a macro, do not give a state property a declaration - For SDK-sensitive features, search current Apple documentation through Xcode rather than relying on remembered signatures. - Apply the current Xcode SwiftUI skill when a new SDK changes source behavior, builder resolution, state initialization, or modifier availability. +## Animation + +- Use native SwiftUI animation to make apps fluid rather than static. Apply it purposefully to buttons, transitions, interactions, selection, colors, and other visible state changes that benefit from feedback; do not animate every update or add motion for its own sake. +- Prefer the default SwiftUI animation, using `withAnimation { ... }` or `.animation(.default, value: ...)`, unless the task prompt explicitly requests a specific animation. Prefer system-provided transitions and SF Symbol effects when they fit the interaction instead of recreating them with custom timing, curves, or rendering. +- Scope animation to the relevant state change or view. Preserve responsive controls, stable layout, and uninterrupted user interaction; avoid blanket animations that also animate unrelated state changes. +- Do not introduce app-level Reduce Motion guards unless the task prompt explicitly requests them. This includes reading `accessibilityReduceMotion` to replace animation with `nil`, remove symbol effects, or otherwise suppress app-authored animation. Preserve any accessibility behavior provided automatically by native system components; this policy governs additional app-level overrides. + ## Previews - Put previews at the end of the file under `// MARK: - Preview`. diff --git a/README.md b/README.md index 7b82435..7fae99d 100644 --- a/README.md +++ b/README.md @@ -91,7 +91,7 @@ From the consumer repository root, install a tagged release: git subtree add \ --prefix=AgentGuidelines \ https://github.com/thatfactory/agent-guidelines.git \ - 0.0.35 \ + 0.0.36 \ --squash ``` @@ -147,7 +147,7 @@ Review the target release's changelog, then pull it deliberately: git subtree pull \ --prefix=AgentGuidelines \ https://github.com/thatfactory/agent-guidelines.git \ - 0.0.35 \ + 0.0.36 \ --squash ``` diff --git a/VERSION b/VERSION index 155069a..e85669f 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -0.0.35 +0.0.36