Skip to content

HCS Platform Engineering

Welcome to the central platform hub for all projects under Hybrid Cloud Solutions (HCS) and associated work by Kristopher Turner.

This is not a product repo. Every other HCS repo references this one for standards, identity management, and Claude Code configuration.

What lives here

Identity and secrets

The registry of every service principal, managed identity, Key Vault secret, GitHub PAT, and ADO variable group across all HCS projects. No sensitive values are stored here — only documentation of what exists, where it lives, who or what uses it, and when it expires.

Go to identity overview →

Standards

The authoritative definition of every standard enforced across all HCS repos. When a standard changes, it changes here first.

Standard Description
Governance Naming conventions, required files, branch strategy, PR requirements, issue management
Scripting PowerShell 7 conventions, config-driven scripting, Resolve-KeyVaultRef, Invoke- pattern
Automation Pipeline-first principle, ADO vs GitHub Actions, multi-tool interoperability
Infrastructure IaC tool selection, deployment phases, Bicep/Terraform conventions
Testing Unit, contract, scenario, and drift-audit test classes
Variables and naming Azure resource names, keyvault:// URIs, config YAML naming
Documentation Markdown, draw.io, MkDocs Material admonitions, badges
Claude Code CLAUDE.md standard, two-scope model, agent definitions

Claude Code configuration

The canonical reference for how Claude Code is configured at the user level and the repo level across all projects.

User environment → | Repo settings → | Agents → | Hooks →

Templates and scripts

  • templates/CLAUDE.md.template — starting point for every new repo's CLAUDE.md
  • templates/repo-scaffold/ — baseline file structure for new repos
  • scripts/Load-HCSEnvironment.ps1 — pulls secrets from Key Vault into the local session

Getting started with a new project

  1. Create the repo following the naming conventions in governance
  2. Copy templates/repo-scaffold/ into the new repo
  3. Fill in templates/CLAUDE.md.template and commit it as CLAUDE.md
  4. Register any new secrets or SPNs in the appropriate identity doc

Owner

Kristopher Turner — kris@hybridsolutions.cloud Senior Product Technology Architect, TierPoint | Microsoft MVP (Azure) | MCT Owner, Hybrid Cloud Solutions LLC — hybridsolutions.cloud | thisismydemo.cloud