---
slug: "architectit-pi-guardrails"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/TheArchitectit/agent-guardrails-template@main/README.md"
repo: "https://github.com/TheArchitectit/agent-guardrails-template"
source_file: "README.md"
branch: "main"
---
# Agent Guardrails Template

> AI-first safety framework for agents building software at high velocity. Guardrails don't slow you down — they're your license to move fast.

[![Version](https://img.shields.io/badge/version-v3.2.0-blue.svg)](./CHANGELOG.md)
[![Go Implementation](https://img.shields.io/badge/Implementation-Go-blue.svg?style=flat&logo=go)](https://golang.org)
[![WCAG 3.0+](https://img.shields.io/badge/Accessibility-WCAG_3.0+_Silver-green.svg)](docs/accessibility/ACCESSIBILITY_GUIDE.md)
[![Spatial Computing](https://img.shields.io/badge/Spatial-XR/VR/AR-blue.svg)](docs/spatial/SPATIAL_COMPUTING_UI.md)

---

## What Is This?

**The Agent Guardrails Template** is a production-grade operating system for AI-assisted development. It turns "vibe coding" chaos into shipping software — giving AI agents explicit boundaries so they spend 100% of their context window on building, not on safety-checking.

### What You Actually Get

| Capability | What It Does |
|-----------|-------------|
| **Real-Time Guardrail Enforcement** | Go MCP server validates every bash command, file edit, git operation, and commit before execution |
| **CI/CD Policy Enforcement** | `POST /api/v1/policy/check` endpoint for gating PRs on guardrail violations — with line/column precision |
| **Webhook Notifications** | Real-time violation and halt event delivery via HMAC-signed webhooks with circuit breaker protection |
| **Token Budget Ledger** | Track AI API costs across Claude/GPT models, set team budgets, get alerts when thresholds are crossed |
| **Agent Lifecycle Management** | State machine (idle→planning→active→review→release) with transition validation and audit trails |
| **Multi-Agent Orchestration** | 10-part AI-Powered Development 2026 guide covering MoA (Mixture of Agents), swarm intelligence, and autonomous tool use |
| **Cross-Platform IDE Integration** | Native skills and rules for Claude Code, Cursor, OpenCode, Windsurf, and GitHub Copilot — not generic prompts |
| **3D Game Development Suite** | Engine-agnostic guardrails (Godot, Unity, Unreal), XR/VR/AR comfort zones, mathematical foundations, AI-debuggable architecture |
| **Token-Efficient Documentation** | 68+ modular docs (500-line max), INDEX_MAP keyword lookup, HEADER_MAP section navigation, `.claudeignore` for context savings |
| **Production Infrastructure** | PostgreSQL 16 + Redis 7, Docker Compose, CI/CD validation, 22-pattern secret scanning, regression prevention |
| **14 Language Examples** | Go, Rust, TypeScript, Python, Java, GDScript, Scala, R, C#, C++, PHP, Ruby, Swift, Dart/Flutter |
| **Ethical & Accessible by Default** | WCAG 3.0+ Silver compliance, dark pattern prevention, XR comfort zones, monetization ethics, multiplayer safety |

### Who This Is For

- **AI-First Teams** — Agents generate 80%+ of your code. You need them to move fast without breaking prod.
- **3D Game Developers** — AI-generated shaders, physics, NPCs, and assets need mathematical correctness and comfort-zone enforcement.
- **Platform Engineers** — Enforce infrastructure guardrails, prevent config drift, and maintain separation across environments.
- **Compliance & Security** — Documented safety processes that satisfy regulatory requirements.

### The Paradox: Constraints Enable Speed

Without guardrails, agents waste tokens on safety verification: *"Is this file safe to edit? Will this break something? Should I ask first?"* This constant self-checking burns context and slows output.

With guardrails, agents know the boundaries upfront. They spend tokens on building, not on doubt. The result: faster iteration, fewer rollbacks, and code that ships with confidence.

Think of guardrails like lane markers on a highway — they don't slow you down. They're the reason you can drive at full speed.

### The Four Laws of Agent Safety

1. **Read before editing** — Never modify code without reading it first
2. **Stay in scope** — Only touch files explicitly authorized
3. **Verify before committing** — Test and check all changes
4. **Halt when uncertain** — Ask for clarification instead of guessing

---

## Quick Start

```bash
# Clone the template
git clone https://github.com/TheArchitectit/agent-guardrails-template.git
cd agent-guardrails-template
```

Then see [QUICK_SETUP.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/QUICK_SETUP.md) for the 5-minute setup, or [HOW_TO_APPLY.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/HOW_TO_APPLY.md) to apply guardrails to an existing repo.

---

## What's Included

### Core Safety (Mandatory)

| Document | Purpose |
|----------|---------|
| [AGENT_GUARDRAILS.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/AGENT_GUARDRAILS.md) | The Four Laws, forbidden actions, halt conditions |
| [TEST_PRODUCTION_SEPARATION.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/standards/TEST_PRODUCTION_SEPARATION.md) | Mandatory test/production isolation |
| [four-laws.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/skills/shared-prompts/four-laws.md) | Canonical Four Laws prompt |
| [halt-conditions.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/skills/shared-prompts/halt-conditions.md) | When to stop and ask |

### AI-First Development 

| Document | Purpose |
|----------|---------|
| [AI_ASSISTED_DEV.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/ai-dev/AI_ASSISTED_DEV.md) | Vibe coding workflow, decision matrix (ask/decide/halt), design-intent preservation |
| [STATE_MANAGEMENT.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/state/STATE_MANAGEMENT.md) | State architecture decision tree, client/server/offline/CRDT patterns |
| [GENERATIVE_ASSET_SAFETY.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/generative/GENERATIVE_ASSET_SAFETY.md) | AI content disclosure, C2PA metadata, procedural generation safety |
| [vibe-coding.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/skills/shared-prompts/vibe-coding.md) | Canonical vibe coding principles |

### AI Tool Integration 

| Document | Purpose |
|----------|---------|
| [AGENTS_AND_SKILLS_SETUP.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/AGENTS_AND_SKILLS_SETUP.md) | Setup guide for Claude Code, Cursor, OpenCode, Windsurf, Copilot |
| [.claude/skills/](https://github.com/TheArchitectit/agent-guardrails-template/tree/HEAD/.claude/skills/) | 7 Claude Code skill files (guardrails-enforcer, commit-validator, etc.) |
| [.claude/hooks/](https://github.com/TheArchitectit/agent-guardrails-template/tree/HEAD/.claude/hooks/) | Pre/post execution shell hooks |
| [.cursor/rules/](https://github.com/TheArchitectit/agent-guardrails-template/tree/HEAD/.cursor/rules/) | 3 Cursor rules files |
| [.cursor/rules-3d/](https://github.com/TheArchitectit/agent-guardrails-template/tree/HEAD/.cursor/rules-3d/) | 3D game dev Cursor rules |
| [.windsurfrules](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/.windsurfrules) | Windsurf rules preamble |
| [.opencode/](https://github.com/TheArchitectit/agent-guardrails-template/tree/HEAD/.opencode/) | OpenCode agents and skills |
| [.opencode/skills/3d-game-dev/](https://github.com/TheArchitectit/agent-guardrails-template/tree/HEAD/.opencode/skills/3d-game-dev/) | 3D game dev OpenCode skill |
| [.claude/skills/](https://github.com/TheArchitectit/agent-guardrails-template/tree/HEAD/.claude/skills/) | 7 Claude Code skill files |
| [.claude/skills-3d/](https://github.com/TheArchitectit/agent-guardrails-template/tree/HEAD/.claude/skills-3d/) | 3D game dev Claude skill |
| [.github/copilot-instructions.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/.github/copilot-instructions.md) | GitHub Copilot repo-level instructions |
| [skills/shared-prompts/](https://github.com/TheArchitectit/agent-guardrails-template/tree/HEAD/skills/shared-prompts/) | 8 canonical shared prompts (3d-game-dev, error-recovery, three-strikes, production-first, scope-validation + existing) |

### Game Design & UI/UX (Agent-GDUI-2026)

| Document | Purpose |
|----------|---------|
| [2026_GAME_DESIGN.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/2026_GAME_DESIGN.md) | Game design guardrails, XR/VR comfort zones, performance budgets |
| [3D_GAME_DEVELOPMENT.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/3d/3D_GAME_DEVELOPMENT.md) | 3D game dev pipeline: assets, Godot conventions, AI workflow, scope, budgets |
| [3D_MATHEMATICAL_FOUNDATIONS.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/3d/3D_MATHEMATICAL_FOUNDATIONS.md) | Linear algebra, quaternions, collision math reference |
| [3D_MODULE_ARCHITECTURE.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/3d/3D_MODULE_ARCHITECTURE.md) | LLM-to-3D-engine bridging architecture |
| [AI_DEBUGGABLE_3D_ARCHITECTURE.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/3d/AI_DEBUGGABLE_3D_ARCHITECTURE.md) | Autonomous 3D troubleshooting patterns |
| [3D_GUARDREL_PROPOSALS_V1.2.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/3d/3D_GUARDREL_PROPOSALS_V1.2.md) | v1.2 proposed guardrails (neural radiance fields, AI NPCs) |
| [2026_UI_UX_STANDARD.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/ui-ux/2026_UI_UX_STANDARD.md) | UI component patterns, design tokens, responsive breakpoints |
| [ACCESSIBILITY_GUIDE.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/accessibility/ACCESSIBILITY_GUIDE.md) | WCAG 3.0+ compliance (Bronze/Silver/Gold) |
| [SPATIAL_COMPUTING_UI.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/spatial/SPATIAL_COMPUTING_UI.md) | XR/VR/AR UI patterns, comfort zones, latency requirements |
| [ETHICAL_ENGAGEMENT.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/ethical/ETHICAL_ENGAGEMENT.md) | Dark pattern taxonomy and automated prevention |

### AI-Powered Development 2026

| Document | Purpose |
|----------|---------|
| [AI_DEV_2026_PART01_INTRO_AND_FOUNDATIONS.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/AI_DEV_2026_PART01_INTRO_AND_FOUNDATIONS.md) | Introduction & Foundations (Ch 1–2) |
| [AI_DEV_2026_PART02_PROMPTING.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/AI_DEV_2026_PART02_PROMPTING.md) | Prompt Engineering for Code |
| [AI_DEV_2026_PART03_CONTEXT_AND_ITERATION.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/AI_DEV_2026_PART03_CONTEXT_AND_ITERATION.md) | Context & Iterative Development |
| [AI_DEV_2026_PART04_QUALITY_AND_ARCHITECTURE.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/AI_DEV_2026_PART04_QUALITY_AND_ARCHITECTURE.md) | Quality & Architecture |
| [AI_DEV_2026_PART05_LEGACY_AND_AGENTS.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/AI_DEV_2026_PART05_LEGACY_AND_AGENTS.md) | Legacy Refactoring & Agent Paradigm |
| [AI_DEV_2026_PART06_BUILDING_AGENTS.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/AI_DEV_2026_PART06_BUILDING_AGENTS.md) | Building Agents & Tool Use |
| [AI_DEV_2026_PART07_MULTI_AGENT_SYSTEMS.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/AI_DEV_2026_PART07_MULTI_AGENT_SYSTEMS.md) | Multi-Agent Systems |
| [AI_DEV_2026_PART08_SECURITY_ETHICS_FUTURE.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/AI_DEV_2026_PART08_SECURITY_ETHICS_FUTURE.md) | Security, Ethics & Future |
| [AI_DEV_2026_PART09_APPENDICES_ABC.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/AI_DEV_2026_PART09_APPENDICES_ABC.md) | Appendices A, B & C |
| [AI_DEV_2026_PART10_APPENDIX_D.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/AI_DEV_2026_PART10_APPENDIX_D.md) | Appendix D: Complete MoA Reference |

### Hermes 2026: AI in 3D Game Development

| Document | Purpose |
|----------|---------|
| [HERMES_2026_PART01_INTRO_AND_EXECUTIVE.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/3d/HERMES_2026_PART01_INTRO_AND_EXECUTIVE.md) | Introduction & Executive Summary |
| [HERMES_2026_PART02_ASSETS_AND_ENGINES.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/3d/HERMES_2026_PART02_ASSETS_AND_ENGINES.md) | 3D Asset Generation & Engine Integration |
| [HERMES_2026_PART03_WORLD_AND_RENDERING.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/3d/HERMES_2026_PART03_WORLD_AND_RENDERING.md) | World Generation & Neural Rendering |
| [HERMES_2026_PART04_NPCS_AND_ANIMATION.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/3d/HERMES_2026_PART04_NPCS_AND_ANIMATION.md) | NPCs, Dialogue & Animation |
| [HERMES_2026_PART05_CODE_AND_PHYSICS.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/3d/HERMES_2026_PART05_CODE_AND_PHYSICS.md) | Code Generation & Neural Physics |
| [HERMES_2026_PART06_QA_AND_BUSINESS.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/3d/HERMES_2026_PART06_QA_AND_BUSINESS.md) | QA, Testing & Business Landscape |
| [HERMES_2026_PART07_LEGAL_AND_CASES.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/3d/HERMES_2026_PART07_LEGAL_AND_CASES.md) | Legal, Ethics & Case Studies |
| [HERMES_2026_PART08_DEEP_DIVES_AND_FUTURE.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/3d/HERMES_2026_PART08_DEEP_DIVES_AND_FUTURE.md) | Technology Deep-Dives & Future Outlook |
| [HERMES_2026_PART09_APPENDICES.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/game-design/3d/HERMES_2026_PART09_APPENDICES.md) | Appendices |

### Commerce & Social Safety 

| Document | Purpose |
|----------|---------|
| [MONETIZATION_GUARDRAILS.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/monetization/MONETIZATION_GUARDRAILS.md) | IAP ethics, loot box transparency, virtual economy balance |
| [MULTIPLAYER_SAFETY.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/multiplayer/MULTIPLAYER_SAFETY.md) | Chat moderation, matchmaking fairness, CSAM detection |
| [ANALYTICS_ETHICS.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/analytics/ANALYTICS_ETHICS.md) | Consent tiers, data minimization, A/B testing ethics |
| [CROSS_PLATFORM_DEPLOYMENT.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/deployment/CROSS_PLATFORM_DEPLOYMENT.md) | App store compliance matrix, CI/CD, feature flags |

### Workflows & Standards

| Document | Purpose |
|----------|---------|
| [AGENT_EXECUTION.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/workflows/AGENT_EXECUTION.md) | Execution protocol, rollback, retry limits |
| [COMMIT_WORKFLOW.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/workflows/COMMIT_WORKFLOW.md) | When and how to commit |
| [CODE_REVIEW.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/workflows/CODE_REVIEW.md) | Review process and escalation |
| [GIT_PUSH_PROCEDURES.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/workflows/GIT_PUSH_PROCEDURES.md) | Push safety and verification |
| [REGRESSION_PREVENTION.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/workflows/REGRESSION_PREVENTION.md) | Failure registry, prevention rules |
| [All workflows →](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/workflows/INDEX.md) | 10 workflow documents |
| [All standards →](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/docs/standards/INDEX.md) | 11 standards documents |

### Token Efficiency

| Tool | Purpose |
|------|---------|
| [INDEX_MAP.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/INDEX_MAP.md) | Find docs by keyword — saves 60-80% tokens |
| [HEADER_MAP.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/HEADER_MAP.md) | Jump to specific sections with line numbers |
| [TOC.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/TOC.md) | Complete file listing |
| `.claudeignore` | Skip irrelevant files |

All documents follow the **500-line max** rule for fast context loading.

---

## MCP Server

The **Model Context Protocol Server** provides real-time guardrail enforcement — validating every bash command, file edit, git operation, and commit before execution.

**Implementation:** Go (`mcp-server/internal/`) | **Infra:** PostgreSQL 16 + Redis 7

| Feature | Details |
|---------|---------|
| **32 MCP Tools** | Session, bash/file/git validation, scope, regression, team, webhooks (5), budget (5), lifecycle (5) |
| **8 MCP Resources** | Quick reference, active rules, documentation access |
| **Web UI** | Dashboard, document browser, rules management, failure registry |
| **REST API** | 31 endpoints including `/api/v1/policy/check` for CI/CD enforcement |
| **API Docs** | OpenAPI 3.1 spec + Scalar explorer at `/docs` |
| **Endpoints** | SSE stream (`/mcp/v1/sse`), JSON-RPC (`/mcp/v1/message`), Web UI (`/web`) |

```bash
# Quick start with Docker Compose
cp .env.example .env  # Edit with your API keys
cd mcp-server && make compose-up

# Or deploy production
cd mcp-server && docker compose -f deploy/podman-compose.yml up -d

# Verify
curl http://localhost:8081/health/ready
curl http://localhost:8081/docs  # API explorer
```

See [mcp-server/README.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/mcp-server/README.md) for full setup, API docs, and troubleshooting.
See [DEPLOYMENT_GUIDE.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/mcp-server/DEPLOYMENT_GUIDE.md) for production deployment.

---

## Examples

Multi-language implementation examples demonstrating guardrails patterns:

| Language | Directory | Highlights |
|----------|-----------|------------|
| **Go** | `examples/go/` | Admin UI, HTMX patterns |
| **TypeScript** | `examples/typescript/` | Game UI, UI components |
| **Rust** | `examples/rust/` | Bevy UI, egui overlay |
| **Python** | `examples/python/` | Game tools, UI dashboard |
| **Java** | `examples/java/` | Compose UI |
| **Swift** | `examples/swift/` | SwiftUI game |
| **Dart/Flutter** | `examples/flutter/` | Cross-platform: ethical widgets, accessibility wrappers |
| **GDScript** | `examples/gdscript/` | Godot: comfort zones, ethical UI, accessibility |
| **Scala** | `examples/scala/` | Functional UI, type-safe CSS, DDA telemetry |
| **R** | `examples/r/` | Game analytics, ethics auditing |
| **C#** | `examples/csharp/` | Unity UI |
| **C++** | `examples/cpp/` | Unreal UI |
| **PHP** | `examples/php/` | Laravel UI |
| **Ruby** | `examples/ruby/` | Rails UI |

---

## Who Should Use This

- **AI-First Development Teams** — Practicing vibe coding where agents generate most of the code. Guardrails let agents build at full velocity without human bottlenecks.
- **3D Game Development Teams** — Building with Godot, Unity, Unreal, or custom engines. Mathematical correctness, asset safety, shader constraints, and AI-debuggable architecture.
- **Engineering Teams** — Deploying AI coding assistants safely across projects.
- **DevOps & Platform Teams** — Enforcing infrastructure guardrails and preventing configuration drift.
- **AI Agent Developers** — Building safer autonomous agents with real-time validation.
- **Compliance & Security Teams** — Meeting regulatory requirements with documented safety processes.

---

## Project Structure

```
agent-guardrails-template/
├── README.md                    ← You are here
├── QUICK_SETUP.md               ← 5-minute setup guide
├── PROMPTING_GUIDE.md           ← Effective prompting for AI development
├── INDEX_MAP.md / HEADER_MAP.md ← Token-efficient navigation
├── CLAUDE.md                    ← Claude Code CLI context
├── CHANGELOG.md                 ← Release notes
│
├── docs/
│   ├── AGENT_GUARDRAILS.md      # Core safety protocols (MANDATORY)
│   ├── HOW_TO_APPLY.md          # Apply template to your repo
│   ├── ai-dev/                  # AI-assisted development patterns 
│   ├── state/                   # State management patterns 
│   ├── generative/              # Generative asset safety 
│   ├── monetization/            # Monetization guardrails 
│   ├── multiplayer/             # Multiplayer safety 
│   ├── analytics/               # Analytics ethics 
│   ├── deployment/              # Cross-platform deployment 
│   ├── game-design/             # 2026 game design guardrails
│   │   └── 3d/                  # 3D game development docs (v3.0.0)
│   ├── ui-ux/                   # UI/UX component standards
│   ├── accessibility/           # WCAG 3.0+ compliance
│   ├── spatial/                 # XR/VR/AR patterns
│   ├── ethical/                 # Dark pattern prevention
│   ├── security/                # Security audit guides
│   ├── advisors/                # Cost, privacy, resilience advisors
│   ├── workflows/               # 10 operational procedure docs
│   ├── standards/               # 11 engineering standards docs
│   └── sprints/                 # Task framework and templates
│
├── mcp-server/                  ← Go MCP server (PostgreSQL + Redis)
│   ├── docs/openapi.yaml        # OpenAPI 3.1 spec (31 endpoints)
│   └── internal/budget/         # Token budget ledger
├── docker-compose.yml           ← Local dev stack (postgres, redis, mcp-server)
├── examples/                    ← 14 language implementations
├── skills/shared-prompts/       ← Four Laws, halt conditions, vibe coding
├── scripts/                     ← Setup and utility tools
└── .github/                     ← CI/CD, templates, secrets management
```

---

## Statistics

| Metric | Count |
|--------|-------|
| **Documentation Files** | 68+ |
| **Guardrail Categories** | 7 (safety, game design, commerce, social, analytics, deployment, generative) |
| **Workflows** | 10 documents |
| **Standards** | 11 documents |
| **Example Languages** | 14 (Go, TS, Rust, Python, Java, Swift, Dart, GDScript, Scala, R, C#, C++, PHP, Ruby) |
| **MCP Tools** | 17 |
| **MCP Resources** | 8 |
| **Supported AI Models** | 30+ LLM families |
| **Implementation** | Go 1.23+ |
| **Infrastructure** | PostgreSQL 16, Redis 7, Docker/Podman |

---

## Version History

**Current:** v3.1.0 (2026-05-12)

| Version | Date | Highlights |
|---------|------|------------|
| **v3.1.0** | 2026-05-12 | Structural reorganization: split docs into 3d/ subfolder, README link fixes, stats update |
| **v3.0.0** | 2026-05-12 | 3D game development suite, AI-Powered Development 2026 guide, Hermes 2026 dossier |
| **v2.9.0** | 2026-05-08 | AI tool integration suite (Claude Code, Cursor, Windsurf, Copilot, OpenCode) |
| **v2.8.0** | 2026-03-14 | AI-first reframe, 7 new guardrail docs, vibe coding, Flutter/Godot examples |
| **v2.7.0** | 2026-03-14 | Agent-GDUI-2026, game design suite, WCAG 3.0+, spatial computing |
| **v2.6.0** | 2026-02-15 | Python → Go migration complete |

See [CHANGELOG.md](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/CHANGELOG.md) for full history.

---

## License

BSD-3-Clause — See [LICENSE](https://github.com/TheArchitectit/agent-guardrails-template/tree/HEAD/LICENSE)

---

## Credits

- **Maintainer:** [TheArchitectit](https://github.com/TheArchitectit)
- **Built with:** Claude Code + Opus

### ☕ Support This Project

Help keep this project going — use a referral link below and both of us get credits!

| Service | Your Bonus | Details | Referral Code |
|---------|-----------|---------|---------------|
| [**Neuralwatt**](https://portal.neuralwatt.com/auth/register?ref=NW-ROGER-ET3Y) | $10 in credits | Spend $10+ → you get $10, we get $20 | `NW-ROGER-ET3Y` |
| [**Synthetic**](https://synthetic.new/?referral=UAWqkKQQLFkzMkY) | $10 in credits | Subscribe → both get $10 credit | `UAWqkKQQLFkzMkY` |
---

**v3.1.0** · AI-First Rapid Development Framework · [Get Started →](https://github.com/TheArchitectit/agent-guardrails-template/blob/HEAD/QUICK_SETUP.md)


## ☁️ Cloud Credits

Power your AI projects with [Ozore.com](https://ozore.com/?ref=cwe4kdx0) — use code **lundrog50** for 50% off your first month.

> `direct-pin` and `custom-router` are available on **Pro** and **Max** plans only.