### Initialize and Setup Project Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/cmd/team-cli/README.md A comprehensive example demonstrating project initialization, team member assignment, status check, and validation. ```bash # Create new project team init web-platform # Assign team members team assign -p web-platform -t 2 -r "Solution Architect" --person "Alice Johnson" team assign -p web-platform -t 2 -r "Domain Architect" --person "Bob Smith" team assign -p web-platform -t 4 -r "Cloud Architect" --person "Carol White" team assign -p web-platform -t 7 -r "Technical Lead" --person "David Brown" # Check status team status -p web-platform # Validate team sizes team validate -p web-platform ``` -------------------------------- ### Setup Agents Integration with Skill Install Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/MARKETPLACE.md Shows how to use the setup script to install a specific skill from the official marketplace for the Claude platform. ```bash python scripts/setup_agents.py --install-skill guardrails-enforcer@official --platform claude ``` -------------------------------- ### Bevy UI Example Setup Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/examples/rust/bevy-ui-example/README.md Commands to initialize a new Bevy project, add the Bevy dependency, and include the bytemuck crate for zero-copy operations. ```bash cd examples/rust/bevy-ui-example cargo init cargo add bevy@0.15 cargo add bytemuck cargo run ``` -------------------------------- ### Run TypeScript Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/examples/README.md Navigate to the TypeScript directory, install dependencies, and run tests. ```bash cd typescript npm install npm test ``` -------------------------------- ### Run Initial Setup Script Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/QUICK_SETUP.md Execute the setup script to install guardrails for your AI agent. Use the appropriate flags for your chosen AI tool. ```bash python scripts/setup_agents.py --claude --full ``` -------------------------------- ### Run Ruby Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/examples/README.md Navigate to the Ruby directory, install bundle dependencies, and execute RSpec tests. ```bash cd ruby bundle install bundle exec rspec ``` -------------------------------- ### Clone and Setup IDE Extension Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/ide/TESTING_GUIDE.md Follow these steps to clone the repository, switch to the IDE branch, install dependencies, compile the extension, and open it in VS Code. ```bash # 1. Clone repo git clone https://github.com/TheArchitectit/agent-guardrails-template.git cd agent-guardrails-template # 2. Switch to ide branch git checkout ide # 3. Install dependencies cd ide/vscode-extension npm install # 4. Compile npm run compile # 5. Open in VS Code code . ``` -------------------------------- ### Project Setup and Dependencies Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/examples/rust/egui-overlay/README.md Initializes a new Rust project and adds necessary dependencies for egui, eframe, rayon, and wgpu. This is the first step to running the example. ```bash cd examples/rust/egui-overlay cargo init cargo add egui@0.27 cargo add eframe@0.27 cargo add rayon cargo add wgpu@0.20 cargo run ``` -------------------------------- ### Go Project Setup and Dependencies Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/examples/go/htmx-patterns/README.md Commands to initialize a Go module, and fetch necessary libraries for an HTMX project. This is typically run once at the start of the project. ```bash cd examples/go/htmx-patterns go mod init htmx-patterns go get github.com/gorilla/mux go get github.com/yohox/go-htmx go run main.go ``` -------------------------------- ### Setup OpenCode Guardrails Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/QUICK_SETUP.md Run the setup script to integrate guardrails with OpenCode. The `--full` flag ensures all necessary components are installed. ```bash python scripts/setup_agents.py --opencode --full ``` -------------------------------- ### Run Python Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/examples/README.md Navigate to the Python directory, install the package with development dependencies, and run pytest. ```bash cd python pip install -e ".[dev]" pytest ``` -------------------------------- ### JetBrains Plugin Setup Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/ide/README.md Clone the repository, navigate to the JetBrains plugin directory, and build the plugin using Gradle. Install the plugin from the generated distribution. ```bash # Clone and setup git checkout ide cd ide/jetbrains-plugin ./gradlew buildPlugin # Install from build/distributions/ ``` -------------------------------- ### VS Code Extension Setup Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/ide/README.md Clone the repository, navigate to the VS Code extension directory, install dependencies, and compile the extension. Press F5 in VS Code to test. ```bash # Clone and setup git checkout ide cd ide/vscode-extension npm install npm run compile # Press F5 in VS Code to test ``` -------------------------------- ### Install WSL2 and Setup Guardrails on Windows Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/QUICK_SETUP.md Install the Windows Subsystem for Linux 2 (WSL2) with Ubuntu, then navigate to the project directory within WSL2 and run the setup script for Claude Code. ```powershell # Install WSL2 with Ubuntu wsl --install -d Ubuntu # Then follow the Linux instructions inside WSL2 wsl cd /mnt/c/Users/YourName/agent-guardrails-template python3 scripts/setup_agents.py --claude --full ``` -------------------------------- ### gRPC Server Setup Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/agentmcp/gRPC Service & Events.txt Initializes and starts a gRPC server on a specified port, including unary and stream authentication interceptors. ```Go func (s *SentinelGRPC) Serve(port int) error { lis, err := net.Listen("tcp", fmt.Sprintf(":%d", port)) if err != nil { return err } opts := []grpc.ServerOption{ grpc.UnaryInterceptor(s.UnaryAuthInterceptor), grpc.StreamInterceptor(s.StreamAuthInterceptor), } grpcServer := grpc.NewServer(opts...) // RegisterSentinelRPCServer(grpcServer, s) // Generated code hook fmt.Printf("[GRPC] Listening on :%d\n", port) return grpcServer.Serve(lis) } ``` -------------------------------- ### Install Dependency Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/agentmcp/Sentinel Profile - Go.txt Sentinel's dependency management includes an allowlist check against approved libraries and an indirect dependency vulnerability check. ```bash install_dep(package="github.com/gin-gonic/gin") ``` -------------------------------- ### Start Web UI Server and Access Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/RELEASE_v1.10.0.md Instructions to start the MCP server and access the Web UI in a browser. ```bash # Start the server ./mcp-server/cmd/server/server # Open browser open http://localhost:8080/web ``` -------------------------------- ### Install Skill Syntax Variations Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/MARKETPLACE.md Demonstrates different ways to install skills, including default installation, specifying a platform, targeting a specific marketplace, and installing to a particular project directory. ```bash # Install from default marketplace (auto-detects platform) python scripts/marketplace.py install guardrails-enforcer # Install for a specific platform python scripts/marketplace.py install guardrails-enforcer --platform cursor # Install from a specific marketplace python scripts/marketplace.py install guardrails-enforcer@official --platform claude # Install to a specific project python scripts/marketplace.py install guardrails-enforcer --target ~/myproject --platform claude ``` -------------------------------- ### Install All Platforms Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/AGENTS_AND_SKILLS_SETUP.md Use this command to install all available platforms and their default configurations. This is the quickest way to set up all guardrails. ```bash python scripts/setup_agents.py --install ``` -------------------------------- ### Platform Installer - setup_agents.py Source: https://context7.com/thearchitectit/agent-guardrails-template/llms.txt Installs generated native skill files for a specific platform into the current project. Supports installation, cloning from GitHub, and different modes like copy or symlink. ```bash # Install Claude Code files into current project python scripts/setup_agents.py --install --platform claude # Install multiple platforms at once python scripts/setup_agents.py --install --platform claude,cursor,opencode,windsurf,copilot ``` -------------------------------- ### Clone Repository and Install Dependencies Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/PYTHON_MIGRATION.md Steps to clone the repository and install Go dependencies using `make deps`. ```bash # Clone the repository git clone https://github.com/TheArchitectit/agent-guardrails-template.git cd agent-guardrails-template/mcp-server # Install Go dependencies make deps ``` -------------------------------- ### Install Dependencies Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/CONTRIBUTING.md Installs all necessary project dependencies. ```bash make deps ``` -------------------------------- ### Install Sentinel Script Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/PROJECT_PLAN.md Provide installation scripts for developers. A single command installs the sentinel CLI and initializes the project. ```bash curl https://releases.project-sentinel.io/install.sh | sh ``` ```bash sentinel init --root . ``` -------------------------------- ### Register, Search, and Install Skills Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/MARKETPLACE.md Commands to register the official marketplace, search for available skills, and install skills for specific platforms or projects. Includes an option for a dry run to preview installation without applying changes. ```bash # Register the official marketplace python scripts/marketplace.py add TheArchitectit/agent-guardrails-template # Search available skills python scripts/marketplace.py search guardrails python scripts/marketplace.py search --platform cursor # Install a skill for your platform python scripts/marketplace.py install guardrails-enforcer --platform claude python scripts/marketplace.py install guardrails-enforcer --platform cursor --target ~/myproject # Preview without installing python scripts/marketplace.py install guardrails-enforcer --platform claude --dry-run ``` -------------------------------- ### Install Team CLI from Source Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/cmd/team-cli/README.md Installs the Team CLI by building from source. Ensure you are in the correct directory. ```bash cd cmd/team-cli make install ``` -------------------------------- ### Preview installation without writing Source: https://context7.com/thearchitectit/agent-guardrails-template/llms.txt This command allows you to preview what would be installed without making any actual writes to the file system. It's a safe way to check installation plans. ```bash python scripts/setup_agents.py --install --platform cursor --dry-run ``` -------------------------------- ### Run Go Admin UI Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/examples/go/admin-ui/README.md Commands to initialize Go modules, fetch dependencies, and run the admin UI example applications. ```bash cd examples/go/admin-ui go mod init admin-ui go get github.com/gorilla/mux go get github.com/gorilla/websocket go get github.com/prometheus/client_golang/prometheus go run economy-monitor.go metrics-dashboard.go websocket-events.go ``` -------------------------------- ### Install Guardrail Plugin with packer.nvim Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/ide/neovim-plugin/README.md Configure packer.nvim to install the guardrail plugin, including its dependency and basic setup. ```lua use { "TheArchitectit/agent-guardrails-template", name = "guardrail.nvim", requires = { "nvim-lua/plenary.nvim" }, config = function() require("guardrail").setup({ server_url = "http://localhost:8095", api_key = "your-api-key", project_slug = "your-project", }) end, } ``` -------------------------------- ### Sentinel Kernel Main Entry Point Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/agentmcp/Sentinel Core Kernel.txt Sets up the Sentinel Kernel by detecting the environment, configuring paths, initializing the kernel, logging startup information, and starting the MCP loop. ```go // Main Entry Point Helper func RunKernel() { // 1. Detect Environment (Dev vs CI) isCI := os.Getenv("CI") != "" // 2. Setup Paths wd, _ := os.Getwd() dbPath := filepath.Join(wd, ".sentinel", "state.db") // 3. Initialize Kernel k, err := NewKernel(wd, dbPath) if err != nil { log.Fatalf("FATAL: Sentinel Boot Failed: %v", err) } // 4. Log Startup log.Printf("Sentinel Kernel v3.0.0 Online. Arch: %s/%s. Mode: %s", runtime.GOOS, runtime.GOARCH, func() string { if isCI { return "HEADLESS" } return "INTERACTIVE" }()) // 5. Start MCP Loop k.StartMCP() } ``` -------------------------------- ### Database Uncertainty Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/standards/TEST_PRODUCTION_SEPARATION.md Example of a user query regarding database connection uncertainty during test infrastructure setup. ```text "UNCERTAINTY QUESTION: I see database connection: DATABASE_URL=postgres://user:pass@db:5432/app CONTEXT: Creating test infrastructure UNCERTAINTY: Is this test database or production database? CURRENT ASSUMPTION: This is test database based on local host QUESTION: Should I use this database for tests, or is there a separate test DB? OPTIONS: 1. Use this database for tests (it's already isolated) 2. Create separate test database (need separate instance) 3. Other: please specify" ``` -------------------------------- ### Install Specific Platforms Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/AGENTS_AND_SKILLS_SETUP.md Install guardrails for a subset of platforms by specifying them with the --platform flag. This allows for a tailored setup. ```bash python scripts/setup_agents.py --install --platform claude,cursor,windsurf ``` -------------------------------- ### Start MCP Server Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/TROUBLESHOOTING.md Use these commands to start the MCP server if it is not running. Ensure the correct script or command is used based on your setup. ```bash python mcp_server.py ``` ```bash ./start-mcp-server.sh ``` -------------------------------- ### Manual Installation of Guardrail Plugin Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/ide/vim-plugin/INSTALL.md Manually install the plugin by cloning the repository into the start directory for Vim packages. This involves creating directories, cloning the repo, and copying files. ```bash mkdir -p ~/.vim/pack/plugins/start cd ~/.vim/pack/plugins/start git clone --depth 1 https://github.com/TheArchitectit/agent-guardrails-template.git guardrail cp -r guardrail/ide/vim-plugin/* guardrail/ rm -rf guardrail/ide guardrail/mcp-server guardrail/docs ``` -------------------------------- ### Run Java Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/examples/README.md Navigate to the Java directory and execute tests using the Gradle wrapper. ```bash cd java ./gradlew test ``` -------------------------------- ### Get Tasks by Status Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/agentmcp/Sentinel API Gateway.txt Retrieves a list of tasks filtered by their status. Example: 'in_progress'. ```APIDOC ## GET /v1/tasks ### Description Retrieves a list of tasks, filterable by status. ### Method GET ### Endpoint /v1/tasks ### Parameters #### Query Parameters - **status** (string) - Required - The status of the tasks to retrieve (e.g., "in_progress"). ``` -------------------------------- ### Run Go Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/examples/README.md Navigate to the Go directory and run tests using the go test command. ```bash cd go go test ./... ``` -------------------------------- ### Python Dockerfile Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/PYTHON_TO_GO_MIGRATION.md Example Dockerfile for the Python version, requiring a Python runtime and installing dependencies. ```dockerfile FROM gcr.io/distroless/python3-debian12 COPY scripts/ /app/scripts/ RUN pip install cryptography CMD ["/server"] ``` -------------------------------- ### Native Windows Setup for Claude Code Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/QUICK_SETUP.md On native Windows, ensure Python is installed, then run the setup script for Claude Code using PowerShell. This command configures the guardrails for your AI agent. ```powershell # Install Python from https://python.org or Microsoft Store python --version # Run setup python scripts/setup_agents.py --claude --full # Or for Cursor / VS Code python scripts/setup_agents.py --cursor --full ``` -------------------------------- ### Run Swift Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/examples/README.md Navigate to the Swift directory and run tests using swift test. ```bash cd swift swift test ``` -------------------------------- ### Get Failure API Response Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/mcp-server/API.md Example response for retrieving a specific failure registry entry by its ID. ```json { "id": "550e8400-e29b-41d4-a716-446655440004", "failure_id": "FAIL-001", "category": "deployment", "severity": "high", "error_message": "Production database overwritten", "root_cause": "Missing environment check", "affected_files": ["scripts/deploy.sh"], "status": "active", "project_slug": "my-project", "created_at": "2026-01-14T10:00:00Z" } ``` -------------------------------- ### Go Code Style Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/CONTRIBUTING.md Illustrates good practices for Go package naming, interface naming, struct and method naming, and constant naming. ```go // Good package name package team // Good interface name type Manager interface { AssignRole(project, team, role, person string) error GetStatus(project string) (Status, error) } // Good struct and method names type teamManager struct { db database.Store cache cache.Cache } func (tm *teamManager) AssignRole(project, team, role, person string) error { // implementation } ``` -------------------------------- ### Get Current Sprint Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/agentmcp/Sentinel API Gateway.txt Retrieves information about the currently active sprint, including its start time and aggregate metrics. ```APIDOC ## GET /v1/sprint/current ### Description Returns a JSON object containing details of the active sprint, including its start time and aggregate metrics. ### Method GET ### Endpoint /v1/sprint/current ### Response #### Success Response (200) - **sprint_details** (object) - JSON object of the active sprint, start time, and aggregate metrics. ``` -------------------------------- ### Make Script Executable and Run Setup Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/QUICK_SETUP.md Use this command to make the setup script executable and then run it. On Windows, ensure PowerShell is run as Administrator if needed. ```bash chmod +x scripts/setup_agents.py python scripts/setup_agents.py --claude --full ``` -------------------------------- ### Get Current Sprint Information Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/agentmcp/Sentinel API Gateway.txt Retrieves details about the active sprint, including its start time and aggregate metrics. ```http GET /v1/sprint/current ``` -------------------------------- ### Migrate Setup Script Commands Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/RELEASE_v2.9.0.md Update your setup script commands to reflect the removal of old flags (`--claude`, `--minimal`, `--full`) in favor of the new `--install` + `--platform` or `--install-skill` arguments. ```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 ``` -------------------------------- ### Preview Installation Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/AGENTS_AND_SKILLS_SETUP.md Use the --dry-run flag to see which files would be installed or modified without actually making any changes. This is useful for verification. ```bash python scripts/setup_agents.py --install --dry-run ``` -------------------------------- ### Run C# Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/examples/README.md Navigate to the C# directory and run tests using the dotnet test command. ```bash cd csharp dotnet test ``` -------------------------------- ### JSON Output for Scripting Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/cmd/team-cli/README.md Demonstrates how to get project status in JSON format and pipe it to 'jq' for further processing, useful for automation. ```bash # Get status in JSON format for automation team status -p web-platform -o json | jq '.teams[] | select(.phase == "Phase 1")' ``` -------------------------------- ### Get Agent Type Team Mapping Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/cmd/team-cli/README.md Retrieves the team and phase mapping for a given agent type. Examples include 'backend' and 'security'. ```bash team agent-map backend ``` ```bash team agent-map security ``` -------------------------------- ### Go Project Structure Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/CONTRIBUTING.md Illustrates a typical Go project structure for the MCP server, including package organization and dependency management. ```go // Package documentation // Package team provides team management functionality for MCP server. // This is a Go port of the Python team_manager.py core functionality. package team // Imports - grouped by: stdlib, third-party, internal import ( "context" "fmt" "github.com/some/lib" "github.com/thearchitectit/guardrail-mcp/internal/models" ) // Exported types start with capital letter type Manager struct { // fields... } // Constructor function func NewManager(projectName string, opts ...ManagerOption) (*Manager, error) { // implementation... } // Methods func (m *Manager) AssignRole(ctx context.Context, teamID int, role, person string) error { // implementation... } ``` -------------------------------- ### Run Elixir Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/examples/README.md Navigate to the Elixir directory, fetch dependencies, and run tests. ```bash cd elixir mix deps.get mix test ``` -------------------------------- ### Build and Deploy Application Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/RELEASE_v1.9.4.md Standard commands to build the application and deploy it using podman-compose. Ensure you have Make and Podman installed. ```bash make build podman-compose up -d ``` -------------------------------- ### Build Go Server from Source Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/PYTHON_MIGRATION.md Instructions for building the Go MCP server binary from source. This command compiles the server and outputs it to the `bin/server` path. ```bash cd mcp-server go build -o bin/server ./cmd/server ./bin/server ``` -------------------------------- ### Setup Guardrail VS Code Extension for Development Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/ide/vscode-extension/INSTALL.md Commands to set up the VS Code extension for development and testing. This includes installing dependencies and compiling the code. ```bash cd ide/vscode-extension npm install npm run compile ``` -------------------------------- ### Build and Test Go Server Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/sprints/SPRINT_002_WEB_UI_IMPLEMENTATION.md This bash script demonstrates how to build the Go server application, run tests, and list the contents of the web directory. Ensure you are in the 'mcp-server' directory before executing. ```bash # Build the server cd mcp-server go build ./cmd/server # Run tests go test ./... # Check web files are in place ls -la web/ ls -la web/js/ ``` -------------------------------- ### Go Dockerfile Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/PYTHON_TO_GO_MIGRATION.md Example Dockerfile for the Go version, using a minimal distroless image for a native binary. ```dockerfile FROM gcr.io/distroless/static:nonroot COPY server /server ENTRYPOINT ["/server"] ``` -------------------------------- ### Get Team Status Guardrail Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/reports/guardrail_mcp_test_report.md Retrieves the status of teams within a project, including counts of active, completed, and not started teams, as well as the overall progress percentage. ```bash guardrail_team_status ``` -------------------------------- ### Dockerfile Layer Cache Optimization Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/agentmcp/Sentinel Profile - Docker - DevOps.txt Highlights the best practice of copying dependency files and installing them before copying source code to leverage Docker's layer caching effectively. ```dockerfile COPY package.json RUN npm install COPY . . ``` -------------------------------- ### Queue-Based Integration Configuration Example (JSON) Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/standards/LOGGING_INTEGRATION.md Example configuration for sending logs to a message queue. Includes the message queue provider, connection details, topic name, and batch size for publishing. ```json { "type": "queue", "config": { "provider": "redis | rabbitmq | sqs", "connection": { "host": "localhost", "port": 6379 }, "topic": "agent-logs", "batch_size": 100 } } ``` -------------------------------- ### Check Python Installation Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/QUICK_SETUP.md Verify if Python is installed on your system. If not, follow the provided link to install it. ```bash python --version # or python3 --version ``` -------------------------------- ### Initialize New Project Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/cmd/team-cli/README.md Initializes a new project with the standard team structure. Replace 'my-project' with your desired project name. ```bash team init my-project ``` -------------------------------- ### Start Team Guardrail Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/reports/guardrail_mcp_test_report.md Starts a specific team, indicating that its work has begun. The response confirms the team that has been started. ```bash guardrail_team_start ``` -------------------------------- ### Install Python 3 Runtime Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/reports/guardrail_mcp_test_report.md Update your Dockerfile to install Python 3. After installation, verify the version using the command below. ```bash # Dockerfile update RUN apt-get update && apt-get install -y python3 ``` ```bash # Verify python3 --version ``` -------------------------------- ### Install Sentinel Background Service Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/agentmcp/Project Readme.txt Use this command to download and install the Sentinel background service. Ensure you have curl installed. ```bash curl -L https://releases.project-sentinel.io/install.sh | sh ``` -------------------------------- ### Initialize Sentinel Kernel Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/agentmcp/Sentinel Core Kernel.txt Sets up the VFS Jail and connects to the SQLite State DB. Initializes the database schema if necessary. Ensure the database is opened in WAL mode for concurrency. ```go func NewKernel(root string, dbPath string) (*Kernel, error) { absRoot, err := filepath.Abs(root) if err != nil { return nil, fmt.Errorf("failed to resolve root path: %v", err) } // Initialize SQLite in WAL mode for high concurrency dsn := fmt.Sprintf("%s?_pragma=journal_mode(WAL)&_pragma=busy_timeout(5000)", dbPath) db, err := sql.Open("sqlite", dsn) if err != nil { return nil, fmt.Errorf("database connection failed: %v", err) } k := &Kernel{ DB: db, Root: absRoot, CurrentState: StateIdle, AuditLogger: NewAuditLogger(db), } // Bootstrap Database Schema if err := k.migrate(); err != nil { return nil, err } return k, nil } ``` -------------------------------- ### Install Skill with Marketplace CLI Source: https://context7.com/thearchitectit/agent-guardrails-template/llms.txt Installs a specified skill into a target project for a given platform. The CLI fetches the skill from GitHub and generates the appropriate configuration file for the platform. ```bash # Install a skill into a target project for a specific platform python scripts/marketplace.py install guardrails-enforcer --platform claude --target ~/myproject # Fetches: skills/guardrails-enforcer/SKILL.md from GitHub # Generates: ~/myproject/.claude/skills/guardrails-enforcer.json # Done. Installed guardrails-enforcer for claude. ``` -------------------------------- ### Run Scala Examples Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/examples/README.md Navigate to the Scala functional UI directory and run specific Scala CLI applications. ```bash cd scala/functional-ui scala-cli run UI.scala scala-cli run data-pipeline-viz.scala scala-cli run procedural-gen.scala ``` -------------------------------- ### MCP Tool: Install Single Skill Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/AGENTS_AND_SKILLS_SETUP.md Install a single skill by name using the MCP tool, specifying the action as 'install' and the skill name. ```javascript guardrail_install_skills({ action: "install", skill: "guardrails-enforcer" }) ``` -------------------------------- ### OpenCode Agent and Skill Configuration Example Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/docs/OPENCODE_INTEGRATION.md Example of an OpenCode JSONC configuration file, demonstrating how to define agents with their models and prompts, and enable specific skills. ```jsonc { "$schema": "https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/master/assets/oh-my-opencode.schema.json", // Agent definitions "agents": { "guardrails-enforcer": { "model": "anthropic/claude-sonnet-4", "temperature": 0.1, "prompt_append": "Additional instructions..." } }, // Skill configuration "skills": { "enable": ["guardrails-enforcer", "commit-validator"] } } ``` -------------------------------- ### Execute Scala CLI Examples Source: https://github.com/thearchitectit/agent-guardrails-template/blob/main/examples/scala/functional-ui/README.md Provides commands to run the different Scala example files using the Scala CLI tool. ```bash cd examples/scala/functional-ui scala-cli run UI.scala scala-cli run data-pipeline-viz.scala scala-cli run procedural-gen.scala ```