Skip to content

docs(readme): refresh the README and add contributing, security and conduct guides - #7

Merged
loveneeshdhir merged 2 commits into
mainfrom
docs/readme
Oct 6, 2026
Merged

loveneeshdhir merged 2 commits into
mainfrom
docs/readme

Conversation

@loveneeshdhir

Copy link
Copy Markdown
Contributor

What this does

  • README: reformatted for developers and search, with a quick start, a recording of Guard
    blocking a real database reset, linked packs, and links to the guardrail library on
    agenttrail.sh. The rules, counts and behavior it describes are unchanged.
  • CONTRIBUTING.md, SECURITY.md, CODE_OF_CONDUCT.md: GitHub shows these as tabs next to the
    README. Security reports go to security@agenttrail.sh. Also adds a pull request template.
  • __tests__/readme.test.ts: fails the build if a rule is added or removed without updating
    the README's total and per-pack counts.

Getting it onto npmjs.com

npm shows the README from the published package, so it needs a release. The docs commit is
docs(readme):, which releases a patch under the rule added in #6.

The recording renders on npm too, because npm rewrites relative image paths to
raw.githubusercontent.com/agenttrailhq/guardrails/HEAD/….

Checked

Spelling, typecheck, Biome, all 311 tests (including the new README test) and commitlint pass
locally.

🤖 Generated with Claude Code

loveneeshdhir and others added 2 commits October 6, 2026 01:38
…onduct guides

- README: reformatted for developers and search, with a quick start, a recording
  of Guard blocking a real database reset, linked packs and the guardrail library
  on agenttrail.sh. The rules, counts and behavior it describes are unchanged.
- CONTRIBUTING.md, SECURITY.md and CODE_OF_CONDUCT.md, which GitHub shows as tabs
  next to the README, plus a pull request template.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The README states the total and a per-pack count. This fails the build if a rule
is added or removed without updating them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@loveneeshdhir
loveneeshdhir requested a review from samc621 as a code owner October 5, 2026 20:08
@loveneeshdhir
loveneeshdhir merged commit 7cced10 into main Oct 6, 2026
4 of 6 checks passed
@github-actions

github-actions Bot commented Oct 6, 2026

Copy link
Copy Markdown

🎉 This PR is included in version 0.2.2 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants