Skip to content

CLAUDE.md

Latest commit

 

History

History
146 lines (114 loc) · 4.78 KB

CLAUDE.md

File metadata and controls

146 lines (114 loc) · 4.78 KB

azurelocal-vm-conversion-toolkit — Claude Code Context

What this repo is

Azure Local VM Conversion Toolkit

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

azurelocal-vm-conversion-toolkit/
├── .claude/
    └── settings.json
├── .github/
    ├── workflows/
    └── CODEOWNERS
├── config/
    └── variables/
├── docs/
    ├── _archived_adoc/
    ├── assets/
    ├── reference/
    ├── contributing.md
    └── gen1-vs-gen2.md
├── repo-management/
    ├── scripts/
    ├── automation.md
    ├── canonical-variable-migration.md
    ├── README.md
    └── setup.md
├── scripts/
    ├── azurelocal/
    ├── common/
    └── hyperv/
├── styles/
    └── Microsoft/
├── .azurelocal-platform.yml
├── .gitignore
├── .release-please-manifest.json
├── .vale.ini
├── azurelocal-vm-conversion-toolkit.code-workspace
├── CHANGELOG.md
├── CLAUDE.md
├── CONTRIBUTING.md
├── LICENSE
├── mkdocs.yml
├── README.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

  • azurelocal-vm-conversion-toolkit-engineer (model: sonnet) — Expert in azurelocal-vm-conversion-toolkit: 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