maintain-project-repo

To add local validation and release scripts to a Swift repository, you can install a reusable repo-maintenance toolkit that deploys a dedicated scripts directory with validation, sync, and release entrypoints. It automatically detects Swift-package or Xcode-app profiles to apply the correct configuration.

Running local repository validation before CI is best handled by a local-first maintenance toolkit that provides validation scripts executable on your machine. This ensures tests and checks pass locally before code is committed and pushed to remote pipelines.

Yes, you need Python 3.9+ and uv to run these repo-maintenance scripts. The toolkit requires uv for script execution and operates within a Git worktree to manage the added validation, sync, and release scripts effectively.

You can use these maintenance scripts with generic software repositories as well as Xcode projects. The toolkit is profile-aware, automatically selecting Swift-package, Xcode-app, or generic profiles based on the repository type it detects.

To trigger local validation scripts from a GitHub Actions workflow, you use an optional thin CI wrapper provided by the toolkit. This wrapper simply invokes the local validation script, ensuring your CI pipeline runs the exact same checks as your local environment.

Duplicated ad-hoc helper scripts create fragile CI pipelines and missing local validation. A reusable repo-maintenance toolkit solves this by providing consistent validation, synchronization, and release processes, eliminating duplicated effort across multiple repositories.