| name | a2ui-swift-development |
| description | Grounding, coding standards, testing practices, and verification workflows for developing in the A2UI Swift codebase (under the swift/ directory). Use whenever implementing features, modifying state logic, creating SwiftUI views, or writing tests in Swift. |
Swift development skill
This skill guides AI agents and contributors working in the swift/ directory. It outlines target
boundaries, coding standards, testing patterns, and mandatory verification steps.
1. Specification and blueprint grounding
Before modifying or implementing Swift code, inspect the authoritative specifications:
- Protocol envelopes and schemas:
specification/v0_9_1/json/ defines wire-format types
and validation schemas.
- Component catalog schema:
basic/catalog.json defines
components, properties, and function signatures.
- Core module blueprint:
a2ui_core.blueprint.md specifies state
handling, JSON pointer rules, auto-vivification, and error semantics.
- Framework adapter blueprint:
a2ui_framework_adapter.blueprint.md specifies view mapping,
reactive subscription lifecycles, and layout behavior.
- Reference implementation:
renderers/web_core/ serves as
the canonical behavioral reference for edge-case resolution.
2. Swift target architecture
The Swift implementation uses targets defined in root Package.swift:
