AI configuration as code — versioned, templated, and synchronized across your entire org.
Why · Architecture · Repositories · Status · Get started
Your CLAUDE.md drifts. .claude/agents/ mutates. New repos miss critical setup. SteerSpec treats
AI configuration files like infrastructure: define once in a central manifest, propagate everywhere
by pull request, detect drift on a schedule.
Because vibe coding without a spec is just vibing.
flowchart LR
R["<b>strspc-rules</b><br/>rule format and schemas"]
M["<b>strspc-manager</b><br/>enforcement engine"]
C["<b>strspc-CLI</b><br/>command line"]
K["<b>strspc-cloud</b><br/>hosted service, planned"]
R -->|consumed by| M
M -->|imported by| C
M -.->|imported by| K
classDef shipped fill:#1f6feb,stroke:#1f6feb,color:#ffffff
classDef planned fill:#6e7781,stroke:#6e7781,color:#ffffff
class R,M,C shipped
class K planned
Dependencies point one way and releases land in the same order. The rules are defined in strspc-spec, a SteerSpec realm of its own.
| Repo | What it does | Lang |
|---|---|---|
| strspc-rules | Canonical rule format — self-referential rule definitions and schemas | Python |
| strspc-manager | Core enforcement engine — rule-lint, rule-diff, rule-eval, rule-resolve | Go |
| strspc-CLI | User-facing CLI — render, validate and manage rule files | Go |
| strspc-sync | GitHub Action & CLI — template distribution by PR, drift monitoring, conflict detection | Go |
| strspc-pr-review | GitHub Action — auto-approve PRs on Copilot's review verdict | JavaScript |
| strspc-spec | Platform specification — the cross-cutting rules every repo follows | JSON |
| .claude | Shared Claude Code agents, skills and settings — installable plugin marketplace | Markdown |
| homebrew-tap | Homebrew tap for installing the strspc CLI on macOS |
Ruby |
SteerSpec is under active development, and much of it ships today.
| Component | State |
|---|---|
| Rule format and core engine | Published |
strspc-sync |
Template distribution by PR, drift monitoring, fleet-wide conflict flags |
strspc-pr-review |
On the GitHub Marketplace |
| CLI | Renders, lints and diffs rule files; AI evaluation of changes is planned |
| Hosted API | Planned, not yet built |
Things will change. Feedback welcome.
brew tap SteerSpec/tap
brew trust --cask steerspec/tap/strspc
brew install --cask strspc
strspc initRecent Homebrew refuses casks from untrusted taps, so the brew trust step is needed once. See
Tap Trust.
Full docs and guides live at steerspec.dev.
Everything public here is Apache 2.0.