Documents
Reference documents and standards for platform engineering and DevOps.
Azure Logic App Standards
Production standards for Azure Logic Apps: hosting model decision tree, Sentinel incident triggers, HTTP and KQL patterns, networking and outbound IPs, retries, error handling, Terraform configuration, dependency chains, and observability.
Azure Naming Convention
A policy set implementing the recommended Microsoft Azure resource abbreviations, enforcing consistent naming patterns across all Azure resource types.
Bash Standards
Production standards for Bash 4.4+: strict mode and safety, coding style and naming, quoting, functions, error handling and traps, structured logging, observability with otel-cli, Azure Monitor telemetry sync, ShellCheck and bats testing, and CI/CD.
CI/CD Standards
Enterprise CI/CD and secure SDLC: pipeline stages, trunk-based branching and PR gates, OIDC identity, secret scanning and git-leak prevention, SAST and dependency scanning, supply-chain hardening, build-once artifacts, and gated multi-environment deployment. Language-agnostic, with GitHub Actions as the worked example.
Copilot Agent Standards
Standards for building Microsoft Copilot agents: which Copilot is which, instructions versus knowledge, grounding and prompt injection handling, capability scoping, the autonomy ladder, identity and lifecycle governance, testing, and shipping agent definitions as reviewed code. With sections for Microsoft 365 Copilot, Security Copilot and GitHub Copilot.
Logging Standards
Enterprise, language-agnostic application logging: structured JSON over stdout, canonical levels and OTel severity mapping, ISO-8601 UTC timestamps, trace correlation, secret and PII hygiene, and exporting to OpenTelemetry, Azure Monitor / Application Insights, and AWS CloudWatch. With reference implementations in PowerShell, Bash, Python, C#, Go, and TypeScript.
PowerShell Standards
Production standards for PowerShell 7: coding style and approved verbs, strict mode and structured error handling, native and library-based logging, OpenTelemetry tracing, Azure Monitor telemetry sync, Pester testing, module publishing, and CI/CD.
Python Standards
Production standards for Python 3.12+: PEP 8 style and naming, type hints with mypy strict, error handling, structured logging and structlog, OpenTelemetry, Azure Monitor telemetry sync, pytest testing, packaging, and CI/CD.
Terraform Standards
Opinionated standards for file structure, provider pinning, variables, locals, outputs, dynamic blocks, check blocks, state management, testing, pipelines, and registry publishing. Grounded in HashiCorp’s official style guide.