Skip to content

Commit 118138c

Browse files
authored
Merge pull request #3 from intility/feat/open-source-readiness
feat: rename plugin to ext-devplatform-plugin, drop customer terminology
2 parents 405506c + fdcaa2a commit 118138c

11 files changed

Lines changed: 24 additions & 24 deletions

File tree

.claude-plugin/marketplace.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
},
88
"plugins": [
99
{
10-
"name": "cust-devplatform-plugin",
10+
"name": "ext-devplatform-plugin",
1111
"source": "./",
1212
"description": "A friendly companion for getting an app running on the Intility Developer Platform. Helps you create a cluster, deploy a containerized app, expose it on a URL, and update it later — without needing prior Kubernetes experience."
1313
}

.claude-plugin/plugin.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
{
2-
"name": "cust-devplatform-plugin",
2+
"name": "ext-devplatform-plugin",
33
"displayName": "Intility Developer Platform",
44
"version": "0.1.0",
55
"description": "A friendly companion for getting an app running on the Intility Developer Platform. Helps you create a cluster, deploy a containerized app, expose it on a URL, and update it later — without needing prior Kubernetes experience.",
66
"author": {
77
"name": "Intility",
88
"email": "devinfra@intility.no"
99
},
10-
"homepage": "https://github.com/intility/cust-devplatform-plugin",
11-
"repository": "https://github.com/intility/cust-devplatform-plugin",
10+
"homepage": "https://github.com/intility/ext-devplatform-plugin",
11+
"repository": "https://github.com/intility/ext-devplatform-plugin",
1212
"license": "MIT",
1313
"keywords": ["intility", "kubernetes", "openshift", "beginner", "deploy"]
1414
}

AGENTS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Guidance for AI coding agents (and humans) working on this repository.
44

55
## What this is
66

7-
A Claude Code plugin: eight markdown skills that guide a customer from zero to a running, exposed app on the Intility Developer Platform. There is no application code — the "source" is SKILL.md prompts, YAML/JSON manifests, and reference docs.
7+
A Claude Code plugin: eight markdown skills that guide an external user from zero to a running, exposed app on the Intility Developer Platform. There is no application code — the "source" is SKILL.md prompts, YAML/JSON manifests, and reference docs.
88

99
## Layout
1010

CONTRIBUTING.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Thanks for helping make the Developer Platform plugin better. It's an early alph
44

55
## Found a bug? Have a wish?
66

7-
Open an [issue](https://github.com/intility/cust-devplatform-plugin/issues). Include what you asked Claude to do, what it tried (the failing command is the best clue), and the cluster name if relevant.
7+
Open an [issue](https://github.com/intility/ext-devplatform-plugin/issues). Include what you asked Claude to do, what it tried (the failing command is the best clue), and the cluster name if relevant.
88

99
## Making changes
1010

@@ -18,8 +18,8 @@ Open an [issue](https://github.com/intility/cust-devplatform-plugin/issues). Inc
1818
3. To try your changes live, add your local checkout as a marketplace in Claude Code:
1919

2020
```
21-
/plugin marketplace add /path/to/cust-devplatform-plugin
22-
/plugin install cust-devplatform-plugin@intility
21+
/plugin marketplace add /path/to/ext-devplatform-plugin
22+
/plugin install ext-devplatform-plugin@intility
2323
```
2424

2525
4. Open a PR against `main`. The `validate` check must pass before merging.

README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55

66

77

8-
> ⚠️ **Early alpha.** This is the first cut of customer-facing skills for the Intility Developer Platform. Skill names, prompts, defaults, and behaviours will change as we learn. Don't depend on it for anything critical yet — but please [open an issue](https://github.com/intility/cust-devplatform-plugin/issues) when something feels off, surprises you, or could be clearer. That feedback is the whole point of an alpha.
8+
> ⚠️ **Early alpha.** This is the first cut of external-facing skills for the Intility Developer Platform. Skill names, prompts, defaults, and behaviours will change as we learn. Don't depend on it for anything critical yet — but please [open an issue](https://github.com/intility/ext-devplatform-plugin/issues) when something feels off, surprises you, or could be clearer. That feedback is the whole point of an alpha.
99
1010

1111
## Features
@@ -22,8 +22,8 @@
2222
**1. Install this plugin**
2323

2424
```bash
25-
/plugin marketplace add intility/cust-devplatform-plugin
26-
/plugin install cust-devplatform-plugin@intility
25+
/plugin marketplace add intility/ext-devplatform-plugin
26+
/plugin install ext-devplatform-plugin@intility
2727
```
2828

2929
**2. Tell Claude what you want**
@@ -96,7 +96,7 @@ A few things that aren't obvious up front:
9696

9797
## Found a bug? Have a wish?
9898

99-
Open an issue: **[github.com/intility/cust-devplatform-plugin/issues](https://github.com/intility/cust-devplatform-plugin/issues)**
99+
Open an issue: **[github.com/intility/ext-devplatform-plugin/issues](https://github.com/intility/ext-devplatform-plugin/issues)**
100100

101101
Helpful to include:
102102

skills/create-cluster/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: create-cluster
3-
description: Creates a single cluster on the Intility Developer Platform for a customer. Use when the user asks to "create a cluster", "get me a cluster", "set up a cluster", or is being routed here by the getting-started skill. Creates ONE cluster with sensible defaults unless the user explicitly asks for more, since this plugin assumes a many-apps-on-one-cluster model.
3+
description: Creates a single cluster on the Intility Developer Platform for an external user. Use when the user asks to "create a cluster", "get me a cluster", "set up a cluster", or is being routed here by the getting-started skill. Creates ONE cluster with sensible defaults unless the user explicitly asks for more, since this plugin assumes a many-apps-on-one-cluster model.
44
allowed-tools:
55
- AskUserQuestion
66
- Bash(indev account show)

skills/expose-app/SKILL.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -24,9 +24,9 @@ End state: `curl http://<hostname>/` returns a non-error status code.
2424

2525
## Background (one paragraph, share with the user as needed)
2626

27-
The platform runs **Envoy Gateway**. Two pre-built gateways are typically available: `internal` (only reachable from inside the customer's network) and `public` (open to the internet). You don't create gateways — you just create an HTTPRoute that points at one. TLS is handled for you, so HTTPRoutes use plain HTTP on port 80; users still get HTTPS at the URL.
27+
The platform runs **Envoy Gateway**. Two pre-built gateways are typically available: `internal` (only reachable from inside the organization's own network) and `public` (open to the internet). You don't create gateways — you just create an HTTPRoute that points at one. TLS is handled for you, so HTTPRoutes use plain HTTP on port 80; users still get HTTPS at the URL.
2828

29-
The domain each gateway uses is the customer's own — not hardcoded in this skill. We read it from the gateway's listener config.
29+
The domain each gateway uses is the organization's own — not hardcoded in this skill. We read it from the gateway's listener config.
3030

3131
## Step 0 — Confirm access
3232

@@ -48,7 +48,7 @@ oc get gateways -n envoy-gateway-system
4848

4949
Look at the `PROGRAMMED` column. Only offer gateways that show `True`. If no gateway is programmed, stop and tell the user to reach out to the Developer Platform Admins via their collaboration channel (samhandlingskanal) — the cluster isn't ready for ingress.
5050

51-
For each programmed gateway, read its listener hostname template — that's the customer's domain. The pattern is usually a wildcard like `*.apps.example.com`:
51+
For each programmed gateway, read its listener hostname template — that's the organization's domain. The pattern is usually a wildcard like `*.apps.example.com`:
5252

5353
```bash
5454
oc get gateway <gateway-name> -n envoy-gateway-system \
@@ -79,7 +79,7 @@ Putting an app on the public gateway means anyone on the internet can hit it. Mo
7979
```
8080
Q: "Just to confirm — putting this on the public gateway means anyone on the internet can reach it. Are you sure?"
8181
Options:
82-
- "Yes, this is meant to be public (e.g. marketing site, public API, customer-facing app)"
82+
- "Yes, this is meant to be public (e.g. marketing site, public API, user-facing app)"
8383
- "No, switch to internal" — go back and use the internal gateway instead
8484
```
8585

@@ -182,7 +182,7 @@ curl -s -o /dev/null -w "%{http_code}\n" http://<hostname>/
182182

183183
- `200``399` → working
184184
- `502` / `503` → route is attached but the pod isn't responding. Check `oc get pods -n <namespace>` — is it `Running`? Are the ports right (`Service.targetPort` should match the container port)?
185-
- Timeout on the `internal` gateway from a remote machine → likely a network reachability issue. The internal hostname may only resolve from inside the customer's network or via VPN. Ask: "Are you connected to the network this cluster is normally reached from?"
185+
- Timeout on the `internal` gateway from a remote machine → likely a network reachability issue. The internal hostname may only resolve from inside the organization's network or via VPN. Ask: "Are you connected to the network this cluster is normally reached from?"
186186

187187
## Step 8 — Report
188188

skills/expose-app/references/httproute-templates.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,10 +26,10 @@ Substitute the `*` with the app's subdomain (default: the app name).
2626

2727
| Gateway | Reachable from |
2828
|---|---|
29-
| `internal` | Only the customer's internal network (the safe default for almost every app) |
29+
| `internal` | Only the organization's internal network (the safe default for almost every app) |
3030
| `public` | Anywhere on the internet — only when the app is meant to be public-facing |
3131

32-
The actual domain (`example.com` above) is the customer's own; this skill never assumes a specific domain.
32+
The actual domain (`example.com` above) is the organization's own; this skill never assumes a specific domain.
3333

3434
---
3535

skills/expose-app/references/usage-examples.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ You: Yes
2222
[curl http://shop.apps.example.com/ → 200]
2323
2424
Your app is live at: http://shop.apps.example.com/
25-
(Gateway: internal — only reachable on the customer network)
25+
(Gateway: internal — only reachable on your organization's network)
2626
```
2727

2828
---

skills/login/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ If `oc whoami` returns their username and `oc get nodes` lists nodes (any status
6767
- **`oc whoami` says "Unauthorized"**: token didn't get saved — re-run login
6868
- **`oc get nodes` says "Forbidden"**: the account was created but no roles attached yet. Tell the user to check with their cluster owner or reach out to the Developer Platform Admins via their collaboration channel (samhandlingskanal).
6969

70-
Do not go further down the troubleshooting tree than this. Customers should escalate; they shouldn't be debugging RBAC.
70+
Do not go further down the troubleshooting tree than this. External users should escalate; they shouldn't be debugging RBAC.
7171

7272
## Quick reference
7373

0 commit comments

Comments
 (0)