Mirror the shared Swift rules canon (rules-swift, commit 4ebb892) into docs/rules-swift/ as a read-only reference alongside the repo's tailored docs/rules/. PROVENANCE.md records the source, commit, and what was included or excluded; the upstream repo's own VCS, CI, and lint tooling is omitted as machinery rather than rule content. Exclude the vendored tree from the style gate (scripts/check-style.sh) and the pre-commit hook: the canon's enforcement docs quote the forbidden attribution phrases to define them, the same reason the repo's own enforcement files are already excluded.
2.1 KiB
2.1 KiB
Changelog
All notable changes to this rule set are documented here. This project follows Semantic Versioning.
[1.0.0] - 2026-06-15
Initial public release of the Swift domain rules, built on the engineering-discipline core spine (vendored in core/).
Added
- Where an app starts:
business-rules-and-constraints(MANDATORY first artifact: business rules as explicit checkable statements, plus the constraints that bound them, which REST services, what compliance, which auth model) anddomain-first(MANDATORY: start at the domain and business rules, framework-free and headless-provable; the UI framework is the last, reversible, and plural choice). - Swift craft:
code-style,namespacing,dependency-injection,concurrency,cross-platform,linux-server,testing,formatting-and-linting,documentation,documentation-search,package-structure,package-architecture,package-import-contract,shared-protocols. - UI (
ui/):pre-ui-layer(the display-less model seam, MANDATORY: Domain + Surface, oneperform(Intent)channel, renderers the only UI import; one model drives the SwiftUI, AppKit, and UIKit renderers at once, both the architecture's payoff and a comparison instrument),pom(Page Object Model for UI tests),flowspec(declarative UI scenarios via the FlowSpec package), plus three renderers over the one model (swiftui-views,uikit-views,appkit-views),view-models,components,colors,fonts. - Parsing and validation:
parsing-rulesandvalidation-rules(the OpenAPIKit idiom). Validation requires every public type to be validated or excluded with a reason, enforced mechanically. - Apple-platform stance:
framework-policy(Apple-only mandate),openapi-generated. - Drop-in kit:
.gitignore,.swiftformat,.swiftlint.yml,.pre-commit-config.yaml, and.githooks/(apre-commitformat-and-lint hook and acommit-msgattribution/em-dash check). - Vendored
core/spine: the cross-cutting engineering-discipline rules (incl.round-trip-transformation). - Dual license: prose under CC BY 4.0, code under MIT.