Skip to content

CLAUDE.md

Latest commit

 

History

History
157 lines (125 loc) · 5.15 KB

CLAUDE.md

File metadata and controls

157 lines (125 loc) · 5.15 KB

platform — Claude Code Context

What this repo is

License: MIT Docs

ADO project details

Standards

This repo follows all HCS platform standards defined in the Platform Engineering repo:

Standard Reference
Governance docs/standards/governance.md
Scripting (PowerShell 7) docs/standards/scripting.md
Automation docs/standards/automation.md
Variables and naming docs/standards/variables.md
Documentation docs/standards/documentation.md
Claude Code docs/standards/claude-code.md

Key rules:

  • All scripts: PowerShell 7+ only. #Requires -Version 7.0, Set-StrictMode -Version Latest, $ErrorActionPreference = 'Stop'.
  • All docs: Markdown only. No Word documents in any repo.
  • Commit format: type(scope): short description — types: feat, fix, docs, chore, refactor, test
  • No secrets, tokens, or credentials committed to any file.

Key facts

Fact Value
Primary language Markdown / Python (MkDocs)
GitHub org AzureLocal
Azure login kris@hybridsolutions.cloud
Key Vault kv-hcs-vault-01

Environment variables expected

Variable Source Purpose
GITHUB_TOKEN kv-hcs-vault-01 via Load-HCSEnvironment.ps1 GitHub CLI and git operations
AZURE_DEVOPS_EXT_PAT kv-hcs-vault-01 via Load-HCSEnvironment.ps1 ADO CLI (az boards, az devops)
Load before starting a session: 
. E:\git\platform\scripts\Load-HCSEnvironment.ps1

Build and test commands

mkdocs build
mkdocs serve  # http://127.0.0.1:8000

Repo structure

platform/
├── .claude/
    ├── platform-epic-issue-body.md
    ├── scheduled_tasks.lock
    └── settings.json
├── .github/
    └── workflows/
├── decisions/
    ├── 0001-create-platform-repo.md
    ├── 0002-standards-single-source.md
    ├── 0003-maproom-iic-canon.md
    ├── 0004-testing-toolset-classification.md
    └── 0005-reusable-workflow-split.md
├── docs/
    ├── contributing/
    ├── getting-started/
    ├── governance/
    ├── maproom/
    └── modules/
├── modules/
    └── powershell/
├── repo-management/
    ├── org-scripts/
    └── README.md
├── scripts/
    ├── README.md
    └── Seed-DocStubs.ps1
├── templates/
    ├── _common/
    ├── iac-solution/
    ├── migration-runbook/
    ├── ps-module/
    └── training-site/
├── testing/
    ├── iic-canon/
    ├── maproom/
    ├── trailhead/
    └── README.md
├── .azurelocal-platform.yml
├── .editorconfig
├── .gitignore
├── .markdownlint.json
├── .release-please-manifest.json
├── .yamllint.yml
├── azurelocal-platform.code-workspace
├── CHANGELOG.md
├── CLAUDE.md
└── ...

Claude Code actions

Run autonomously:

  • Read, search, and grep any file in this repo
  • Write and edit files in this repo
  • git add, git commit, git push
  • gh issue, gh pr, gh run CLI commands
  • mkdocs build and mkdocs serve
  • pip install for MkDocs plugins

Always confirm before:

  • Creating or deleting Azure resources
  • Any az CLI write operation that modifies Azure state
  • Running destructive operations
  • Making API calls to external services

Subagents available in this repo

  • platform-engineer (model: sonnet) — Expert in platform: deep knowledge of this repo's structure, conventions, and development workflow.

User-level agents (available in every repo session): triage-lookup, markdown-prose-editor, azurelocal-domain-expert, mkdocs-material-doctor, turner-module-scaffold-engineer, mms-2026-demo-presenter.

Owner

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