Skip to content

Commit b9dd853

Browse files
kristopherjturnerkristopherjturner
committed
chore(platform): complete Claude Code onboarding — CLAUDE.md, agent, settings, .gitignore AB#15
1 parent a678e7c commit b9dd853

2 files changed

Lines changed: 129 additions & 6 deletions

File tree

‎.claude/agents/azurelocal-scom-mp-engineer.md‎

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
name: azurelocal-scom-mp-engineer
3+
description: Expert agent for azurelocal-scom-mp (GitHub / AzureLocal) — [![Platform Standards](https://img.shields.io/badge/standards-AzureLocal%2Fplatform-0078D4)](https://github.com/Azure...
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-scom-mp, a GitHub repository in the AzureLocal organization.
16+
17+
[![Platform Standards](https://img.shields.io/badge/standards-AzureLocal%2Fplatform-0078D4)](https://github.com/AzureLocal/platform)
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-scom-mp/
23+
├── .claude/
24+
└── settings.json
25+
├── .github/
26+
└── workflows/
27+
├── diagrams/
28+
└── drawio/
29+
├── docs/
30+
├── assets/
31+
├── azure-monitor/
32+
├── comparison/
33+
├── design/
34+
└── project/
35+
├── src/
36+
├── azure-monitor/
37+
├── scom-mp/
38+
└── squaredup/
39+
├── .azurelocal-platform.yml
40+
├── .editorconfig
41+
├── .gitignore
42+
├── .markdownlint.json
43+
├── .release-please-manifest.json
44+
├── .yamllint.yml
45+
├── CHANGELOG.md
46+
├── CLAUDE.md
47+
├── CODEOWNERS
48+
├── CONTRIBUTING.md
49+
├── LICENSE
50+
├── mkdocs.yml
51+
├── PLAN.md
52+
└── ...
53+
54+
Conventions and hard rules:
55+
- Follow all HCS platform standards (see Platform Engineering repo: docs/standards/)
56+
- No secrets, tokens, credentials, or subscription IDs in any committed file — ever
57+
- Commit format: type(scope): short description — types: feat, fix, docs, chore, refactor, test
58+
- Reference ADO work items as AB#<id> in commit messages
59+
- PowerShell scripts: #Requires -Version 7.0, Set-StrictMode -Version Latest, ErrorActionPreference Stop
60+
- All documentation in Markdown only — no Word documents
61+
- Always read and understand existing code before modifying it
62+
- Never commit .env, *.pfx, *.pem, *.key, credentials.json, or any file containing sensitive values

‎CLAUDE.md‎

Lines changed: 67 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+
[![Platform Standards](https://img.shields.io/badge/standards-AzureLocal%2Fplatform-0078D4)](https://github.com/AzureLocal/platform)
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,62 @@ 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-scom-mp/
72+
├── .claude/
73+
└── settings.json
74+
├── .github/
75+
└── workflows/
76+
├── diagrams/
77+
└── drawio/
78+
├── docs/
79+
├── assets/
80+
├── azure-monitor/
81+
├── comparison/
82+
├── design/
83+
└── project/
84+
├── src/
85+
├── azure-monitor/
86+
├── scom-mp/
87+
└── squaredup/
88+
├── .azurelocal-platform.yml
89+
├── .editorconfig
90+
├── .gitignore
91+
├── .markdownlint.json
92+
├── .release-please-manifest.json
93+
├── .yamllint.yml
94+
├── CHANGELOG.md
95+
├── CLAUDE.md
96+
├── CODEOWNERS
97+
├── CONTRIBUTING.md
98+
├── LICENSE
99+
├── mkdocs.yml
100+
├── PLAN.md
101+
└── ...
102+
```
103+
52104
---
53105

54106
## Claude Code actions
@@ -62,11 +114,20 @@ Load environment before starting a session:
62114
- `pip install` for MkDocs plugins
63115

64116
**Always confirm before:**
65-
- Any operation that modifies Azure resources
66-
- Installing or upgrading dependencies
117+
- Creating or deleting Azure resources
118+
- Any `az` CLI write operation that modifies Azure state
67119
- Running destructive operations
68120
- Making API calls to external services
69121

122+
123+
---
124+
125+
## Subagents available in this repo
126+
127+
- `azurelocal-scom-mp-engineer` (model: sonnet) — Expert in `azurelocal-scom-mp`: deep knowledge of this repo's structure, conventions, and development workflow.
128+
129+
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`.
130+
70131
---
71132

72133
## Owner

0 commit comments

Comments
 (0)