Skip to content

Commit 3ebdee4

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

2 files changed

Lines changed: 144 additions & 6 deletions

File tree

‎CLAUDE.md‎

Lines changed: 71 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 thisismydemo organization. Published via GitHub Pages.
5+
thisismydemo.github.io is a static site published via GitHub Pages for the thisismydemo organization.
66

77
---
88

99
## ADO project details
1010

1111
- **ADO org:** https://dev.azure.com/hybridcloudsolutions
12-
- **ADO project:** thisismydemo
12+
- **ADO project:** This Is My Demo
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,66 @@ 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+
# Check README for build instructions
63+
```
64+
65+
---
66+
67+
## Repo structure
68+
69+
```
70+
thisismydemo.github.io/
71+
├── .frontmatter/
72+
└── database/
73+
├── .github/
74+
├── chatmodes/
75+
├── workflows/
76+
└── copilot-instructions.md
77+
├── .vscode/
78+
├── settings.json
79+
└── tasks.json
80+
├── archetypes/
81+
└── default.md
82+
├── assets/
83+
└── css/
84+
├── content/
85+
├── post/
86+
└── about.md
87+
├── layouts/
88+
├── _default/
89+
├── partials/
90+
├── 404.html
91+
└── index.html
92+
├── static/
93+
└── img/
94+
├── themes/
95+
└── mainroad/
96+
├── .gitignore
97+
├── .gitmodules
98+
├── .hugo_build.lock
99+
├── blog-improvement-roadmap.md
100+
├── CLAUDE.md
101+
├── CNAME
102+
├── config.toml
103+
├── fact_check.md
104+
├── frontmatter.json
105+
└── ...
106+
```
107+
52108
---
53109

54110
## Claude Code actions
@@ -61,11 +117,20 @@ Load environment before starting a session:
61117
- `npm` or `bundle` commands for local preview
62118

63119
**Always confirm before:**
64-
- Any operation that modifies Azure resources
65-
- Installing or upgrading dependencies
120+
- Creating or deleting Azure resources
121+
- Any `az` CLI write operation that modifies Azure state
66122
- Running destructive operations
67123
- Making API calls to external services
68124

125+
126+
---
127+
128+
## Subagents available in this repo
129+
130+
- `thisismydemo.github.io-engineer` (model: sonnet) — Expert in `thisismydemo.github.io`: deep knowledge of this repo's structure, conventions, and development workflow.
131+
132+
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`.
133+
69134
---
70135

71136
## Owner

‎README.md‎

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
# thisismydemo.github.io
2+
3+
thisismydemo.github.io is a static site published via GitHub Pages for the thisismydemo organization.
4+
5+
---
6+
7+
## What this is
8+
9+
thisismydemo.github.io is a static site published via GitHub Pages for the thisismydemo organization.
10+
11+
---
12+
13+
## Prerequisites
14+
15+
Before using this project, you need:
16+
17+
- PowerShell 7+ (`winget install Microsoft.PowerShell`)
18+
- Azure CLI (`winget install Microsoft.AzureCLI`) — logged in as kris@hybridsolutions.cloud
19+
- GitHub CLI (`winget install GitHub.cli`) — authenticated via `hcs-github-org-pat`
20+
- {{Any other tools, runtimes, or SDKs this project requires}}
21+
22+
Load required environment variables before starting:
23+
24+
```powershell
25+
. E:\git\platform\scripts\Load-HCSEnvironment.ps1
26+
```
27+
28+
---
29+
30+
## Quick start
31+
32+
```powershell
33+
# {{Step 1 — clone or navigate to the repo}}
34+
cd E:\git\{{repo-name}}
35+
36+
# {{Step 2 — any setup steps}}
37+
38+
# {{Step 3 — the primary command to run or build}}
39+
```
40+
41+
---
42+
43+
## Documentation
44+
45+
{{If a doc site exists, link it here. Otherwise link to key Markdown files.}}
46+
47+
| Doc | Description |
48+
|---|---|
49+
| [{{doc name}}](docs/{{file}}.md) | {{what it covers}} |
50+
51+
---
52+
53+
## Contributing
54+
55+
1. Create a feature branch: `git checkout -b feature/short-description`
56+
2. Make changes following the [scripting](https://dev.azure.com/hybridcloudsolutions/Platform%20Engineering/_git/Platform%20Engineering?path=/docs/standards/scripting.md) and [documentation](https://dev.azure.com/hybridcloudsolutions/Platform%20Engineering/_git/Platform%20Engineering?path=/docs/standards/documentation.md) standards
57+
3. Commit with `type(scope): description` format and link an ADO work item (`AB#<id>`)
58+
4. Open a PR and link it to the ADO work item
59+
60+
---
61+
62+
## License
63+
64+
{{MIT / Proprietary — choose one and delete the other}}
65+
66+
MIT License — see [LICENSE](LICENSE)
67+
68+
*Proprietary — Hybrid Cloud Solutions LLC. All rights reserved.*
69+
70+
---
71+
72+
**Owner:** Kristopher Turner — kris@hybridsolutions.cloud
73+
Hybrid Cloud Solutions LLC — hybridsolutions.cloud

0 commit comments

Comments
 (0)