Skip to content

docs(policies): pivot to the rules registry as the primary install flow#47

Merged
knhn1004 merged 1 commit intomainfrom
docs/policies-pivot-to-registry
May 3, 2026
Merged

docs(policies): pivot to the rules registry as the primary install flow#47
knhn1004 merged 1 commit intomainfrom
docs/policies-pivot-to-registry

Conversation

@knhn1004
Copy link
Copy Markdown
Collaborator

@knhn1004 knhn1004 commented May 3, 2026

Summary

  • Per user feedback ("this shouldn't be saying gates are fixed but rather refer to the rules things we have and let them know how to set it up"), the policies guide page now leads with the openagentlock/rules install flow instead of the five hard-coded baseline gates.
  • The five built-ins are still documented but now framed as "what ships out of the box" — the typical operator's workflow is now `agentlock rules sync && agentlock rules install `.
  • Schema example updated to match the registry's `gate.match` / `gate.evaluate` shape and calls out the RE2 lookahead limitation explicitly.
  • Page renamed in docs nav: "Policies and the five gates" → "Policies and rules".
  • Cross-references the openagentlock/skills toolkit for the agent-authored-rule path.

Test plan

  • Markdown only — mkdocs renders fine locally.
  • Reviewer: confirm the new ordering matches the operator journey we want to shape.

🤖 Generated with Claude Code

@knhn1004 knhn1004 enabled auto-merge (squash) May 3, 2026 01:39
…l flow

The page previously described the five built-in gates as the
canonical surface. With the openagentlock/rules registry shipped,
the typical operator no longer hand-edits policy YAML — they install
community rules with `agentlock rules install <id>`. Restructured to
match:

- Lead with the registry: how to sync, search, install, uninstall;
  how to register a private registry alongside; how to ask the
  openagentlock/skills toolkit to author a new rule.
- Demote the five baseline gates to "what ships out of the box";
  point readers at registry variants for tighter / opinionated takes.
- Update the schema example to match the registry's gate shape
  (gate.match + gate.evaluate) and call out the RE2 lookahead
  limitation explicitly.
- Renamed the page from "Policies and the five gates" to "Policies
  and rules" in the docs nav.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@knhn1004 knhn1004 force-pushed the docs/policies-pivot-to-registry branch from 8fe359b to 2c11937 Compare May 3, 2026 02:20
@knhn1004 knhn1004 merged commit ae1b203 into main May 3, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant