Skip to content

Commit ef37b8b

Browse files
author
Kristopher Turner
committed
chore(platform): complete Claude Code onboarding — CLAUDE.md, agent, settings, .gitignore AB#15
1 parent 56a659b commit ef37b8b

2 files changed

Lines changed: 173 additions & 6 deletions

File tree

‎.claude/agents/azurelocal-loadtools-engineer.md‎

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
---
2+
name: azurelocal-loadtools-engineer
3+
description: Expert agent for azurelocal-loadtools (GitHub / AzureLocal) — ![Azure Local Load Testing Framework](docs/assets/images/azurelocal-loadtools-banner.svg)
4+
model: sonnet
5+
tools:
6+
- Read
7+
- Write
8+
- Edit
9+
- Glob
10+
- Grep
11+
- WebFetch
12+
- WebSearch
13+
---
14+
15+
You are the dedicated engineer agent for azurelocal-loadtools, a GitHub repository in the AzureLocal organization.
16+
17+
![Azure Local Load Testing Framework](docs/assets/images/azurelocal-loadtools-banner.svg)
18+
19+
This is a MkDocs Material documentation site. Build with mkdocs build, preview with mkdocs serve. The nav structure is defined in mkdocs.yml. Follow the documentation standard at docs/standards/documentation.md in the Platform Engineering repo.
20+
21+
Repository structure:
22+
azurelocal-loadtools/
23+
├── .azuredevops/
24+
├── azure-pipelines-vmfleet.yml
25+
└── azure-pipelines.yml
26+
├── .claude/
27+
└── settings.json
28+
├── .github/
29+
├── workflows/
30+
└── CODEOWNERS
31+
├── common/
32+
├── ansible/
33+
├── bicep/
34+
├── helpers/
35+
└── modules/
36+
├── config/
37+
└── variables/
38+
├── docs/
39+
├── architecture/
40+
├── assets/
41+
├── getting-started/
42+
├── images/
43+
└── operations/
44+
├── logs/
45+
├── monitoring/
46+
├── pipeline/
47+
├── reports/
48+
└── .gitkeep
49+
├── repo-management/
50+
├── scripts/
51+
├── automation.md
52+
├── canonical-variable-migration.md
53+
├── README.md
54+
└── setup.md
55+
├── state/
56+
└── .gitkeep
57+
├── styles/
58+
└── Microsoft/
59+
├── tests/
60+
├── common/
61+
└── PSScriptAnalyzer.ps1
62+
├── tools/
63+
├── fio/
64+
├── hammerdb/
65+
├── iperf/
66+
├── stress-ng/
67+
└── vmfleet/
68+
├── .azurelocal-platform.yml
69+
├── .editorconfig
70+
├── .gitignore
71+
├── .psscriptanalyzer.psd1
72+
├── .release-please-manifest.json
73+
├── .vale.ini
74+
└── ...
75+
76+
Conventions and hard rules:
77+
- Follow all HCS platform standards (see Platform Engineering repo: docs/standards/)
78+
- No secrets, tokens, credentials, or subscription IDs in any committed file — ever
79+
- Commit format: type(scope): short description — types: feat, fix, docs, chore, refactor, test
80+
- Reference ADO work items as AB#<id> in commit messages
81+
- PowerShell scripts: #Requires -Version 7.0, Set-StrictMode -Version Latest, ErrorActionPreference Stop
82+
- All documentation in Markdown only — no Word documents
83+
- Always read and understand existing code before modifying it
84+
- Never commit .env, *.pfx, *.pem, *.key, credentials.json, or any file containing sensitive values

‎CLAUDE.md‎

Lines changed: 89 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,15 @@
22

33
## What this repo is
44

5-
MkDocs documentation site in the AzureLocal organization. This repo publishes technical documentation and is built with MkDocs Material.
5+
![Azure Local Load Testing Framework](docs/assets/images/azurelocal-loadtools-banner.svg)
66

77
---
88

99
## ADO project details
1010

1111
- **ADO org:** https://dev.azure.com/hybridcloudsolutions
12-
- **ADO project:** AzureLocal
12+
- **ADO project:** Azure Local
13+
- **Area path:** Platform Engineering\Onboarding
1314
- **Work item format:** `AB#<id>` in commit messages and PR descriptions
1415

1516
---
@@ -28,7 +29,7 @@ This repo follows all HCS platform standards defined in the Platform Engineering
2829
| Claude Code | [docs/standards/claude-code.md](https://dev.azure.com/hybridcloudsolutions/Platform%20Engineering/_git/Platform%20Engineering?path=/docs/standards/claude-code.md) |
2930

3031
Key rules:
31-
- All scripts: PowerShell 7+ only. `#Requires -Version 7.0`, `Set-StrictMode -Version Latest`, `\Stop = 'Stop'`.
32+
- All scripts: PowerShell 7+ only. `#Requires -Version 7.0`, `Set-StrictMode -Version Latest`, ` $ErrorActionPreference = 'Stop'`.
3233
- All docs: Markdown only. No Word documents in any repo.
3334
- Commit format: `type(scope): short description` — types: `feat`, `fix`, `docs`, `chore`, `refactor`, `test`
3435
- No secrets, tokens, or credentials committed to any file.
@@ -44,11 +45,84 @@ Key rules:
4445
| Azure login | kris@hybridsolutions.cloud |
4546
| Key Vault | kv-hcs-vault-01 |
4647

47-
Load environment before starting a session:
48+
### Environment variables expected
49+
50+
| Variable | Source | Purpose |
51+
|---|---|---|
52+
| `GITHUB_TOKEN` | kv-hcs-vault-01 via Load-HCSEnvironment.ps1 | GitHub CLI and git operations |
53+
| `AZURE_DEVOPS_EXT_PAT` | kv-hcs-vault-01 via Load-HCSEnvironment.ps1 | ADO CLI (`az boards`, `az devops`) |
54+
Load before starting a session:
4855
```powershell
4956
. E:\git\platform\scripts\Load-HCSEnvironment.ps1
5057
```
5158

59+
### Build and test commands
60+
61+
```
62+
mkdocs build
63+
mkdocs serve # http://127.0.0.1:8000
64+
```
65+
66+
---
67+
68+
## Repo structure
69+
70+
```
71+
azurelocal-loadtools/
72+
├── .azuredevops/
73+
├── azure-pipelines-vmfleet.yml
74+
└── azure-pipelines.yml
75+
├── .claude/
76+
└── settings.json
77+
├── .github/
78+
├── workflows/
79+
└── CODEOWNERS
80+
├── common/
81+
├── ansible/
82+
├── bicep/
83+
├── helpers/
84+
└── modules/
85+
├── config/
86+
└── variables/
87+
├── docs/
88+
├── architecture/
89+
├── assets/
90+
├── getting-started/
91+
├── images/
92+
└── operations/
93+
├── logs/
94+
├── monitoring/
95+
├── pipeline/
96+
├── reports/
97+
└── .gitkeep
98+
├── repo-management/
99+
├── scripts/
100+
├── automation.md
101+
├── canonical-variable-migration.md
102+
├── README.md
103+
└── setup.md
104+
├── state/
105+
└── .gitkeep
106+
├── styles/
107+
└── Microsoft/
108+
├── tests/
109+
├── common/
110+
└── PSScriptAnalyzer.ps1
111+
├── tools/
112+
├── fio/
113+
├── hammerdb/
114+
├── iperf/
115+
├── stress-ng/
116+
└── vmfleet/
117+
├── .azurelocal-platform.yml
118+
├── .editorconfig
119+
├── .gitignore
120+
├── .psscriptanalyzer.psd1
121+
├── .release-please-manifest.json
122+
├── .vale.ini
123+
└── ...
124+
```
125+
52126
---
53127

54128
## Claude Code actions
@@ -62,11 +136,20 @@ Load environment before starting a session:
62136
- `pip install` for MkDocs plugins
63137

64138
**Always confirm before:**
65-
- Any operation that modifies Azure resources
66-
- Installing or upgrading dependencies
139+
- Creating or deleting Azure resources
140+
- Any `az` CLI write operation that modifies Azure state
67141
- Running destructive operations
68142
- Making API calls to external services
69143

144+
145+
---
146+
147+
## Subagents available in this repo
148+
149+
- `azurelocal-loadtools-engineer` (model: sonnet) — Expert in `azurelocal-loadtools`: deep knowledge of this repo's structure, conventions, and development workflow.
150+
151+
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`.
152+
70153
---
71154

72155
## Owner

0 commit comments

Comments
 (0)