# SpecLock README Badges
**Protected by SpecLock** — Show the world your AI coding tools respect your rules.
Add one (or all) of these to the top of your README.md. Every badge links back to SpecLock so visitors can learn why your repo can't be wrecked by a rogue prompt.
Browse live previews: https://sgroy10.github.io/speclock/badge.html
After running `speclock protect`, you can also run `speclock badge` to print these straight to your terminal.
---
## 1. Standard Shield
**Markdown**
```markdown
[](https://github.com/sgroy10/speclock)
```
**HTML**
```html
```
**reStructuredText**
```rst
.. image:: https://img.shields.io/badge/Protected_by-SpecLock-FF6B2C?style=flat&logo=lock
:target: https://github.com/sgroy10/speclock
:alt: Protected by SpecLock
```
*Where to put it:* Top of your README.md, right under the title.
---
## 2. Flat Square
**Markdown**
```markdown
[](https://github.com/sgroy10/speclock)
```
**HTML**
```html
```
**reStructuredText**
```rst
.. image:: https://img.shields.io/badge/Protected_by-SpecLock-FF6B2C?style=flat-square&logo=lock
:target: https://github.com/sgroy10/speclock
:alt: Protected by SpecLock
```
*Where to put it:* Alongside your other flat-square shields (npm, license, downloads).
---
## 3. For the Badge
**Markdown**
```markdown
[](https://github.com/sgroy10/speclock)
```
**HTML**
```html
```
**reStructuredText**
```rst
.. image:: https://img.shields.io/badge/PROTECTED_BY-SPECLOCK-FF6B2C?style=for-the-badge&logo=lock&logoColor=white
:target: https://github.com/sgroy10/speclock
:alt: Protected by SpecLock
```
*Where to put it:* Hero section of a landing-page README, or centerpiece under your project name.
---
## 4. Dynamic Version (auto-updates)
**Markdown**
```markdown
[](https://www.npmjs.com/package/speclock)
```
**HTML**
```html
```
**reStructuredText**
```rst
.. image:: https://img.shields.io/npm/v/speclock?label=SpecLock&color=FF6B2C&logo=lock
:target: https://www.npmjs.com/package/speclock
:alt: SpecLock
```
*Where to put it:* Next to your other npm version shields. Signals you track SpecLock releases.
---
## 5. Tests Passing
**Markdown**
```markdown
[](https://github.com/sgroy10/speclock)
```
**HTML**
```html
```
**reStructuredText**
```rst
.. image:: https://img.shields.io/badge/SpecLock_Tests-1043%20passing-success
:target: https://github.com/sgroy10/speclock
:alt: Tests
```
*Where to put it:* Build-status row alongside your own CI badges.
---
## 6. Downloads
**Markdown**
```markdown
[](https://www.npmjs.com/package/speclock)
```
**HTML**
```html
```
**reStructuredText**
```rst
.. image:: https://img.shields.io/npm/dm/speclock?label=SpecLock%20downloads&color=FF6B2C
:target: https://www.npmjs.com/package/speclock
:alt: Downloads
```
*Where to put it:* Social-proof row near the top of your README.
---
## Stack them all
```markdown
[](https://github.com/sgroy10/speclock)
[](https://www.npmjs.com/package/speclock)
[](https://github.com/sgroy10/speclock)
[](https://www.npmjs.com/package/speclock)
```
---
## Why add a badge?
- **Trust signal.** Visitors know your codebase is protected by an AI constraint engine, not vibes.
- **Marketing for the ecosystem.** Every badge helps other developers discover SpecLock and keep their own projects safe.
- **Proof you care.** You care enough about your rules to enforce them, not just document them.
If SpecLock saves your project from a 3am incident, please add a badge. It costs you nothing and helps the community.
---
*Generated by the SpecLock team. Developed by [Sandeep Roy](https://github.com/sgroy10).*