.gitignore

# ========== CANONICAL (auto-synced, do not edit) ==========
# Source: swift-institute/Scripts/sync-gitignore.sh

*~
.DS_Store

Package.resolved
DerivedData/
Thumbs.db

# Top-level entries (opt-in only)
# First ignore everything at root; then whitelist specific folders,
# files, and dotfiles. Whitelists come AFTER /* so they take effect.
/*
!/Sources/
!/Tests/
!/Benchmarks/
!/Experiments/
!/Research/
!/Skills/
!/Scripts/
!/.github/
!/Package.swift
!/Package@swift-*.swift
!/Lint.swift
!/Lint/
!/LICENSE
!/LICENSE.md
!/README.md
!/.gitignore
!/.spi.yml
!/.swift-format
!/.swiftformat
!/.swiftlint.yml
!/.swiftlint/

# Documentation (opt-in for whitelisted .md files and .docc catalogs only)
# Blocks all .md files by default to prevent AI-generated content from being committed
*.md
!README.md
!LICENSE
!LICENSE.md
!CHANGELOG.md
!CONTRIBUTING.md
!CODE_OF_CONDUCT.md
!SECURITY.md
!CLAUDE.md
!**/*.docc/**/*.md
!**/Research/**/*.md
!**/Experiments/**/*.md
!**/Skills/**/*.md
!**/.github/**/*.md

# Package insights are non-normative working logs accumulating through
# reflections-processing. They stay on disk for the author but do not ship.
**/_Package-Insights.md

# Research working-artifact prevention: underscore-prefixed and prompt dirs
# are non-canonical and must not ship. _archived/ is the one allowed
# exception (holds SUPERSEDED research per [META-005]).
/Research/_*/
!/Research/_archived/
/Research/prompts/

*.pdf

# SwiftLint
**/.swiftlint/RemoteConfigCache

# Swift Package Manager
.build/
.swiftpm/
.benchmarks/

# DocC build artifacts (generated by docc convert/preview)
.docc-build/

# ========== END CANONICAL ==========

# ========== LOCAL OVERRIDES ==========
# Package-specific rules below (managed by sync-gitignore.sh)