sync-swift-package-guidance

What problem does it solve?

Bring an existing Swift Package Manager repository's maintainer guidance and AGENTS.md up to a shared baseline so contributors and automation have a consistent, documented workflow without accidentally bootstrapping or overwriting app-focused guidance.

Core Features & Use Cases

• Deterministic AGENTS.md management: create AGENTS.md from a managed template, append a bounded Swift package guidance section, or leave an already-managed file unchanged.
• Repo classification and guards: detect Package.swift and Xcode markers, block ambiguous roots, and enforce file-type and write-mode safety checks before mutating files.
• Tooling refresh and validation: refresh the swift-package repo-maintenance toolkit files, validate the synced guidance contains required anchors, and surface clear next steps for handoff to package build or testing workflows.
• Use Case: When a mono-repo or legacy Swift package drifts from the shared policy, run the skill to merge in guidance and keep the repo-maintenance scripts aligned.

Quick Start

Run the sync wrapper on the existing repository root to create or merge AGENTS.md, refresh the swift-package maintenance toolkit, and validate the guidance in one pass.