golden-principles

Define the 10 core operating principles for AI agents in the Azure Agentic InfraOps Accelerator repository.

50|32|Updated Dec 8, 2025
One-click install
npx skills add https://github.com/jonathan-vella/azure-agentic-infraops-accelerator --skill golden-principles-jonathan-vella
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: golden-principles
Source: https://github.com/jonathan-vella/azure-agentic-infraops-accelerator/tree/main/.github/skills/golden-principles
Command: npx skills add https://github.com/jonathan-vella/azure-agentic-infraops-accelerator --skill golden-principles-jonathan-vella

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill defines the fundamental operating principles for AI agents within the repository, ensuring consistent, secure, and efficient infrastructure development.

Core Features & Use Cases

  • Governs Agent Behavior: Establishes rules for how agents should interact with the repository, manage context, and enforce invariants.
  • Promotes Best Practices: Encourages patterns like "Repository Is the System of Record," "Map, Not Manual," and "Mechanical Enforcement Over Documentation."
  • Use Case: When an agent needs to decide how to store new information, it consults these principles to ensure it follows the "Repository Is the System of Record" rule, storing the data in a designated file rather than relying on ephemeral chat history.

Quick Start

Use the golden-principles skill to understand the core operating philosophy for agents in this repository.

Frequently Asked Questions about golden-principles

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What are AI agent operating principles for infrastructure governance?

AI agent operating principles are rules that govern agent behavior, context management, and adherence to best practices like using the repository as the system of record to ensure secure infrastructure workflows.

How do I enforce mechanical enforcement over documentation for AI agents?

To enforce mechanical enforcement over documentation for AI agents, apply core operating principles that establish invariants and govern how agents interact with the repository, ensuring rules are executed systematically rather than just documented.

How should AI agents manage context when developing infrastructure?

AI agents manage context by consulting operating principles to store new information in designated repository files rather than relying on ephemeral chat history, ensuring the repository remains the system of record.

When do I need to define agent governance principles for Azure infrastructure workflows?

You need to define agent governance principles for Azure infrastructure workflows when you want to ensure consistent, secure, and efficient development by establishing rules for how agents interact with repository data and enforce invariants.

Can I use these agent operating principles with other infrastructure repositories?

These agent operating principles are designed for the Azure Agentic InfraOps Accelerator repository, but the core governance patterns like repository as system of record can be applied to infrastructure development workflows in other repositories.

Why use the repository as the system of record instead of chat history for AI agents?

Using the repository as the system of record instead of chat history ensures that AI agents store new information in designated files, maintaining persistent context management and consistent infrastructure development workflows.