Skip to content

Commit 369e88e

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

2 files changed

Lines changed: 178 additions & 6 deletions

File tree

‎.claude/agents/azurelocal.github.io-engineer.md‎

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
name: azurelocal.github.io-engineer
3+
description: Expert agent for azurelocal.github.io (GitHub / AzureLocal) — [![Deploy](https://github.com/AzureLocal/azurelocal.github.io/actions/workflows/deploy.yml/badge.svg)](https://github...
4+
model: sonnet
5+
tools:
6+
- Read
7+
- Write
8+
- Edit
9+
- Glob
10+
- Grep
11+
---
12+
13+
You are the dedicated engineer agent for azurelocal.github.io, a GitHub repository in the AzureLocal organization.
14+
15+
[![Deploy](https://github.com/AzureLocal/azurelocal.github.io/actions/workflows/deploy.yml/badge.svg)](https://github.com/AzureLocal/azurelocal.github.io/actions/workflows/deploy.yml)
16+
17+
This is a static site published via GitHub Pages. Check for Jekyll (Gemfile) or npm-based (package.json) tooling.
18+
19+
Repository structure:
20+
azurelocal.github.io/
21+
├── .claude/
22+
└── settings.json
23+
├── .frontmatter/
24+
└── database/
25+
├── .github/
26+
├── workflows/
27+
├── CODEOWNERS
28+
├── labels.yml
29+
└── repo-standard.md
30+
├── blog/
31+
├── 2025-04-01-welcome/
32+
├── authors.yml
33+
└── tags.yml
34+
├── demos/
35+
└── 2025-04-01-welcome/
36+
├── docs/
37+
├── assets/
38+
├── automation/
39+
├── azure-services/
40+
├── design/
41+
└── implementation/
42+
├── repo-management/
43+
├── plans/
44+
├── scripts/
45+
├── automation.md
46+
├── README.md
47+
└── setup.md
48+
├── src/
49+
├── components/
50+
├── css/
51+
└── pages/
52+
├── standards/
53+
├── automation.mdx
54+
├── documentation.mdx
55+
├── examples.mdx
56+
├── index.mdx
57+
└── infrastructure.mdx
58+
├── static/
59+
├── img/
60+
├── .nojekyll
61+
├── BingSiteAuth.xml
62+
├── CNAME
63+
└── robots.txt
64+
├── styles/
65+
└── Microsoft/
66+
├── versioned_docs/
67+
└── version-2411/
68+
├── versioned_sidebars/
69+
└── version-2411-sidebars.json
70+
├── .gitignore
71+
├── .prettierrc
72+
├── .release-please-manifest.json
73+
├── .vale.ini
74+
├── azurelocal-github-io.code-workspace
75+
└── ...
76+
77+
Conventions and hard rules:
78+
- Follow all HCS platform standards (see Platform Engineering repo: docs/standards/)
79+
- No secrets, tokens, credentials, or subscription IDs in any committed file — ever
80+
- Commit format: type(scope): short description — types: feat, fix, docs, chore, refactor, test
81+
- Reference ADO work items as AB#<id> in commit messages
82+
- PowerShell scripts: #Requires -Version 7.0, Set-StrictMode -Version Latest, ErrorActionPreference Stop
83+
- All documentation in Markdown only — no Word documents
84+
- Always read and understand existing code before modifying it
85+
- Never commit .env, *.pfx, *.pem, *.key, credentials.json, or any file containing sensitive values

‎CLAUDE.md‎

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

33
## What this repo is
44

5-
Static site / blog in the AzureLocal organization. Published via GitHub Pages.
5+
[![Deploy](https://github.com/AzureLocal/azurelocal.github.io/actions/workflows/deploy.yml/badge.svg)](https://github.com/AzureLocal/azurelocal.github.io/actions/workflows/deploy.yml)
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,88 @@ 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+
npm install
63+
npm run build
64+
npm run dev
65+
```
66+
67+
---
68+
69+
## Repo structure
70+
71+
```
72+
azurelocal.github.io/
73+
├── .claude/
74+
└── settings.json
75+
├── .frontmatter/
76+
└── database/
77+
├── .github/
78+
├── workflows/
79+
├── CODEOWNERS
80+
├── labels.yml
81+
└── repo-standard.md
82+
├── blog/
83+
├── 2025-04-01-welcome/
84+
├── authors.yml
85+
└── tags.yml
86+
├── demos/
87+
└── 2025-04-01-welcome/
88+
├── docs/
89+
├── assets/
90+
├── automation/
91+
├── azure-services/
92+
├── design/
93+
└── implementation/
94+
├── repo-management/
95+
├── plans/
96+
├── scripts/
97+
├── automation.md
98+
├── README.md
99+
└── setup.md
100+
├── src/
101+
├── components/
102+
├── css/
103+
└── pages/
104+
├── standards/
105+
├── automation.mdx
106+
├── documentation.mdx
107+
├── examples.mdx
108+
├── index.mdx
109+
└── infrastructure.mdx
110+
├── static/
111+
├── img/
112+
├── .nojekyll
113+
├── BingSiteAuth.xml
114+
├── CNAME
115+
└── robots.txt
116+
├── styles/
117+
└── Microsoft/
118+
├── versioned_docs/
119+
└── version-2411/
120+
├── versioned_sidebars/
121+
└── version-2411-sidebars.json
122+
├── .gitignore
123+
├── .prettierrc
124+
├── .release-please-manifest.json
125+
├── .vale.ini
126+
├── azurelocal-github-io.code-workspace
127+
└── ...
128+
```
129+
52130
---
53131

54132
## Claude Code actions
@@ -61,11 +139,20 @@ Load environment before starting a session:
61139
- `npm` or `bundle` commands for local preview
62140

63141
**Always confirm before:**
64-
- Any operation that modifies Azure resources
65-
- Installing or upgrading dependencies
142+
- Creating or deleting Azure resources
143+
- Any `az` CLI write operation that modifies Azure state
66144
- Running destructive operations
67145
- Making API calls to external services
68146

147+
148+
---
149+
150+
## Subagents available in this repo
151+
152+
- `azurelocal.github.io-engineer` (model: sonnet) — Expert in `azurelocal.github.io`: deep knowledge of this repo's structure, conventions, and development workflow.
153+
154+
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`.
155+
69156
---
70157

71158
## Owner

0 commit comments

Comments
 (0)