Synchronize AI configuration files (CLAUDE.md, .claude/agents/, .claude/skills/, .claude/settings/) across your GitHub organization. Define templates once in a central repo, then distribute them via pull requests.

1. Create a central repo (e.g. your-org/steerspec-config)
2. Add a steerspec-sync.yml config and your templates (see docs/quickstart/ for examples)
3. Add a workflow to sync on push:

name: SteerSpec Sync
on:
  push:
    branches: [main]
    paths:
      - 'templates/**'
      - 'steerspec-sync.yml'

jobs:
  sync:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: SteerSpec/strspc-sync/sync@v1
        with:
          dry-run: false
        env:
          GITHUB_TOKEN: ${{ secrets.STEERSPEC_TOKEN }}

Use the composite actions directly from the Marketplace:

# Full action (specify command)
- uses: SteerSpec/strspc-sync@v1
  with:
    command: sync

# Convenience sub-actions
- uses: SteerSpec/strspc-sync/sync@v1
- uses: SteerSpec/strspc-sync/monitor@v1
- uses: SteerSpec/strspc-sync/conflict@v1

Download from Releases:

# macOS / Linux
curl -fsSL https://github.com/SteerSpec/strspc-sync/releases/latest/download/strspc_<version>_<os>_<arch>.tar.gz | tar xz
sudo mv strspc /usr/local/bin/

Render templates and open PRs in target repositories.

strspc sync --config steerspec-sync.yml
strspc sync --config steerspec-sync.yml --dry-run
strspc sync --config steerspec-sync.yml --target-filter "my-org/api-*"
strspc sync --config steerspec-sync.yml --template-filter claude-md --force

Action usage:

- uses: SteerSpec/strspc-sync/sync@v1
  with:
    dry-run: true
    target-filter: 'my-org/api-*'

Outputs: prs-created, prs-updated, repos-skipped, errors, summary

Check target repositories for configuration drift and create issues.

strspc monitor --config steerspec-sync.yml

Action usage:

- uses: SteerSpec/strspc-sync/monitor@v1

Outputs: repos-in-sync, repos-drifted, issues-created, issues-closed, summary

Detect conflicts across AI configuration files in target repositories.

strspc conflict --config steerspec-sync.yml
strspc conflict --config steerspec-sync.yml --tiers 1,2,3

Action usage:

- uses: SteerSpec/strspc-sync/conflict@v1
  with:
    tiers: '1,2'

Outputs: conflicts-found, critical-count, warning-count, info-count, summary

All configuration lives in steerspec-sync.yml. See docs/quickstart/steerspec-sync.yml for an example and the full specification for the schema reference.

This tool implements the SteerSpec Sync specification.

MIT -- see LICENSE.