Skip to content

Commit 88c268a

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

2 files changed

Lines changed: 142 additions & 6 deletions

File tree

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

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
---
2+
name: hybridsolutionscloud.github.io-engineer
3+
description: Expert agent for hybridsolutionscloud.github.io (GitHub / hybridsolutionscloud) — Website for [Hybrid Cloud Solutions, LLC](https://hybridsolutionscloud.github.io) — founded by Microsoft MVP and MCT ...
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 hybridsolutionscloud.github.io, a GitHub repository in the hybridsolutionscloud organization.
14+
15+
Website for [Hybrid Cloud Solutions, LLC](https://hybridsolutionscloud.github.io) — founded by Microsoft MVP and MCT Kristopher Turner.
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+
hybridsolutionscloud.github.io/
21+
├── .claude/
22+
└── settings.json
23+
├── .frontmatter/
24+
└── database/
25+
├── .github/
26+
└── workflows/
27+
├── .vscode/
28+
├── astrowind/
29+
├── extensions.json
30+
├── launch.json
31+
└── settings.json
32+
├── nginx/
33+
└── nginx.conf
34+
├── public/
35+
├── decapcms/
36+
├── _headers
37+
└── robots.txt
38+
├── src/
39+
├── assets/
40+
├── components/
41+
├── content/
42+
├── data/
43+
└── layouts/
44+
├── vendor/
45+
├── integration/
46+
└── README.md
47+
├── .dockerignore
48+
├── .editorconfig
49+
├── .gitignore
50+
├── .npmrc
51+
├── .prettierignore
52+
├── .prettierrc.cjs
53+
├── .stackblitzrc
54+
├── astro.config.ts
55+
├── CLAUDE.md
56+
├── docker-compose.yml
57+
└── ...
58+
59+
Conventions and hard rules:
60+
- Follow all HCS platform standards (see Platform Engineering repo: docs/standards/)
61+
- No secrets, tokens, credentials, or subscription IDs in any committed file — ever
62+
- Commit format: type(scope): short description — types: feat, fix, docs, chore, refactor, test
63+
- Reference ADO work items as AB#<id> in commit messages
64+
- PowerShell scripts: #Requires -Version 7.0, Set-StrictMode -Version Latest, ErrorActionPreference Stop
65+
- All documentation in Markdown only — no Word documents
66+
- Always read and understand existing code before modifying it
67+
- Never commit .env, *.pfx, *.pem, *.key, credentials.json, or any file containing sensitive values

‎CLAUDE.md‎

Lines changed: 75 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 hybridsolutionscloud organization. Published via GitHub Pages.
5+
Website for [Hybrid Cloud Solutions, LLC](https://hybridsolutionscloud.github.io) — founded by Microsoft MVP and MCT Kristopher Turner.
66

77
---
88

99
## ADO project details
1010

1111
- **ADO org:** https://dev.azure.com/hybridcloudsolutions
12-
- **ADO project:** hybridsolutionscloud
12+
- **ADO project:** Hybrid Cloud Solutions
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,70 @@ 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+
hybridsolutionscloud.github.io/
73+
├── .claude/
74+
└── settings.json
75+
├── .frontmatter/
76+
└── database/
77+
├── .github/
78+
└── workflows/
79+
├── .vscode/
80+
├── astrowind/
81+
├── extensions.json
82+
├── launch.json
83+
└── settings.json
84+
├── nginx/
85+
└── nginx.conf
86+
├── public/
87+
├── decapcms/
88+
├── _headers
89+
└── robots.txt
90+
├── src/
91+
├── assets/
92+
├── components/
93+
├── content/
94+
├── data/
95+
└── layouts/
96+
├── vendor/
97+
├── integration/
98+
└── README.md
99+
├── .dockerignore
100+
├── .editorconfig
101+
├── .gitignore
102+
├── .npmrc
103+
├── .prettierignore
104+
├── .prettierrc.cjs
105+
├── .stackblitzrc
106+
├── astro.config.ts
107+
├── CLAUDE.md
108+
├── docker-compose.yml
109+
└── ...
110+
```
111+
52112
---
53113

54114
## Claude Code actions
@@ -61,11 +121,20 @@ Load environment before starting a session:
61121
- `npm` or `bundle` commands for local preview
62122

63123
**Always confirm before:**
64-
- Any operation that modifies Azure resources
65-
- Installing or upgrading dependencies
124+
- Creating or deleting Azure resources
125+
- Any `az` CLI write operation that modifies Azure state
66126
- Running destructive operations
67127
- Making API calls to external services
68128

129+
130+
---
131+
132+
## Subagents available in this repo
133+
134+
- `hybridsolutionscloud.github.io-engineer` (model: sonnet) — Expert in `hybridsolutionscloud.github.io`: deep knowledge of this repo's structure, conventions, and development workflow.
135+
136+
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`.
137+
69138
---
70139

71140
## Owner

0 commit comments

Comments
 (0)