90 lines
3.1 KiB
Markdown
90 lines
3.1 KiB
Markdown
# Agent Guardrails Template — v2.9.0
|
|
|
|
**Release Date:** 2026-05-08
|
|
**Theme:** Core Skill Systems for All Coding Platforms
|
|
|
|
---
|
|
|
|
## What's New
|
|
|
|
### Pre-Committed Skill Configs (No More Generation)
|
|
|
|
Skill configurations for Claude Code, Cursor, OpenCode, Windsurf, and GitHub Copilot now ship **pre-committed** in the repository. Setup is a file copy or symlink — no Python code generation at install time.
|
|
|
|
**New files:**
|
|
- `.claude/skills/` — 7 JSON skill files (guardrails-enforcer, commit-validator, env-separator, scope-validator, production-first, three-strikes, error-recovery)
|
|
- `.claude/hooks/` — 3 shell hooks (pre-commit, pre-execution, post-execution)
|
|
- `.cursor/rules/` — 3 Cursor rules files
|
|
- `.windsurfrules` — Windsurf rules preamble
|
|
- `.opencode/` — OpenCode config, skills, and 2 agents
|
|
- `.github/copilot-instructions.md` — GitHub Copilot repo-level instructions
|
|
- `skills/shared-prompts/` — 4 new canonical prompts: error-recovery, three-strikes, production-first, scope-validation
|
|
|
|
### New `guardrail_install_skills` MCP Tool
|
|
|
|
Headless skill installation via MCP. Supports:
|
|
- Full platform install (`platforms: "claude,cursor"`)
|
|
- Per-skill install by name (`skill: "guardrails-enforcer"`)
|
|
- Single-file clone from GitHub (`action: "clone"`, `path: ".claude/skills/guardrails-enforcer.json"`)
|
|
- List skills and platforms (`list_skills: true`)
|
|
|
|
### Refactored `scripts/setup_agents.py`
|
|
|
|
The setup script switched from "generate" to "install" mode:
|
|
|
|
```bash
|
|
# Clone a single skill file (no repo clone needed)
|
|
python scripts/setup_agents.py --clone .claude/skills/guardrails-enforcer.json
|
|
|
|
# Install a specific skill by name
|
|
python scripts/setup_agents.py --install-skill guardrails-enforcer
|
|
|
|
# List all 23 available skills
|
|
python scripts/setup_agents.py --list-skills
|
|
|
|
# Full platform install
|
|
python scripts/setup_agents.py --install --platform claude,cursor,windsurf
|
|
```
|
|
|
|
### Merged from Main
|
|
|
|
This release also includes all work merged from `main`:
|
|
- PR #3: SSE timeout resilience fix
|
|
- Sprint 005: Pre-Commit Safety Suite
|
|
- Sprint 006: Custom Advisor Roles System
|
|
- v2.0.0 / v2.7.0 / v2.8.0 releases
|
|
- IDE extensions (VS Code, JetBrains, Neovim, Vim)
|
|
- Team management tools (Python → Go migration)
|
|
- Document ingest system
|
|
|
|
---
|
|
|
|
## Migration
|
|
|
|
**Upgrading from v2.8.0:** No breaking changes. The setup script flags (`--claude`, `--minimal`, `--full`) are removed in favor of `--install` + `--platform` or `--install-skill`.
|
|
|
|
If you use the setup script, update your commands:
|
|
```bash
|
|
# Old
|
|
python scripts/setup_agents.py --claude --minimal
|
|
|
|
# New
|
|
python scripts/setup_agents.py --install --platform claude
|
|
python scripts/setup_agents.py --install-skill guardrails-enforcer # for minimal
|
|
```
|
|
|
|
---
|
|
|
|
## Breaking Changes
|
|
|
|
| Change | Description |
|
|
|--------|-------------|
|
|
| `--claude`, `--opencode`, `--minimal`, `--full` flags removed | Replaced by `--install` + `--platform` or `--install-skill` |
|
|
| Setup script no longer generates from templates | Installs pre-committed files via copy or symlink |
|
|
|
|
---
|
|
|
|
## Contributors
|
|
|
|
Built with [Claude Code](https://claude.com/claude-code) using the Agent Guardrails framework.
|