privilegedescalation/org
Archived
12
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

Apply agent config audit fixes (PRI-14)

Browse Source 
Syncs repo instruction files with corrected live bundles:
- Fix Regina's agent ID in Gandalf/Hugh configs (5 refs: 8a627431 → c5f88b39)
- Create Pixel Patty's HEARTBEAT.md and SOUL.md (was missing entirely)
- Fix Karen's PRODUCT-CONTEXT.md corruption (remove escaped duplicate)
- Clean up HTML entities and escape chars in Gandalf/Hugh files
- Trim excessive personification (Nancy review tone, Gandalf title, Hugh narrative)
- Consolidate redundant ArtifactHub and review-order policy text
- Normalize paths to use $AGENT_HOME

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Pawla Abdul
2026-04-11 14:12:11 +00:00
parent b59caa6dc1
commit e485caee08
21 changed files with 408 additions and 219 deletions
Download Patch File Download Diff File Expand all files Collapse all files
kubectl-karen/PRODUCT-CONTEXT.md
+43 -46
View File
@@ -1,17 +1,17 @@
# Kubectl Karen — Product Context
# Product Context
Load this file when triaging feature requests, evaluating new plugin proposals, or writing specs.
## Current Plugin Portfolio
| Plugin | Repo | What It Does | Status |
|--------|------|-------------|--------|
| **Polaris** | `headlamp-polaris-plugin` | Kubernetes best practice validation and scoring | Active |
| **Kube-VIP** | `headlamp-kube-vip-plugin` | Kube-VIP load balancer management | Active |
| **Rook/Ceph** | `headlamp-rook-plugin` | Rook-Ceph storage cluster monitoring | Active |
| **Sealed Secrets** | `headlamp-sealed-secrets-plugin` | Bitnami Sealed Secrets management | Active |
| **Intel GPU** | `headlamp-intel-gpu-plugin` | Intel GPU device plugin monitoring | Active |
| **TrueNAS CSI** | `headlamp-tns-csi-plugin` | TrueNAS SCALE CSI driver monitoring | Active |
| Plugin | Repo | What It Does | Status |
| ------------------ | -------------------------------- | ----------------------------------------------- | ------ |
| **Polaris** | `headlamp-polaris-plugin` | Kubernetes best practice validation and scoring | Active |
| **Kube-VIP** | `headlamp-kube-vip-plugin` | Kube-VIP load balancer management | Active |
| **Rook/Ceph** | `headlamp-rook-plugin` | Rook-Ceph storage cluster monitoring | Active |
| **Sealed Secrets** | `headlamp-sealed-secrets-plugin` | Bitnami Sealed Secrets management | Active |
| **Intel GPU** | `headlamp-intel-gpu-plugin` | Intel GPU device plugin monitoring | Active |
| **TrueNAS CSI** | `headlamp-tns-csi-plugin` | TrueNAS SCALE CSI driver monitoring | Active |
All plugins distributed via **ArtifactHub**, installed through Headlamp's native plugin installer only.
@@ -19,15 +19,15 @@ All plugins distributed via **ArtifactHub**, installed through Headlamp's native
### Primary: The Platform Engineer
- Manages 1-50 Kubernetes clusters, mid-size company (100-2000 employees)
- Pain point: "I have 15 tools open to monitor my clusters. I want one dashboard that shows me everything"
- Very high tech comfort. Knows Kubernetes deeply. Will read your source code.
- Will adopt a plugin in 5 minutes if it solves a real problem. Will drop it in 5 seconds if it's buggy or doesn't add value over `kubectl`.
* Manages 1-50 Kubernetes clusters, mid-size company (100-2000 employees)
* Pain point: "I have 15 tools open to monitor my clusters. I want one dashboard that shows me everything"
* Very high tech comfort. Knows Kubernetes deeply. Will read your source code.
* Will adopt a plugin in 5 minutes if it solves a real problem. Will drop it in 5 seconds if it's buggy or doesn't add value over `kubectl`.
### Secondary: The DevOps Lead / SRE Manager
- Manages a platform team, responsible for cluster health and reliability
- Wants plugins that visualize what matters and surface problems proactively — NOT another monitoring tool
* Manages a platform team, responsible for cluster health and reliability
* Wants plugins that visualize what matters and surface problems proactively — NOT another monitoring tool
### Anti-persona: The Application Developer
@@ -37,29 +37,29 @@ App developers care about their deployments, not the cluster. Features like "sho
### In Scope
- Headlamp plugins that visualize and manage specific Kubernetes ecosystem tools
- Plugins that surface operational insights not available in Headlamp core
- Plugins for CNCF projects and widely-adopted K8s ecosystem tools
- ArtifactHub packaging and distribution
* Headlamp plugins that visualize and manage specific Kubernetes ecosystem tools
* Plugins that surface operational insights not available in Headlamp core
* Plugins for CNCF projects and widely-adopted K8s ecosystem tools
* ArtifactHub packaging and distribution
### Explicitly Out of Scope
- Plugins that duplicate Headlamp core functionality
- Non-Kubernetes tools
- Hosted/SaaS versions of plugins
- Helm-based or sidecar-based plugin installation
- Custom Headlamp forks
- Monitoring/alerting backends (we visualize, we don't collect metrics)
- Multi-cluster management
- CLI tools
* Plugins that duplicate Headlamp core functionality
* Non-Kubernetes tools
* Hosted/SaaS versions of plugins
* Helm-based or sidecar-based plugin installation
* Custom Headlamp forks
* Monitoring/alerting backends (we visualize, we don't collect metrics)
* Multi-cluster management
* CLI tools
## Competitive Landscape
| Competitor | Where PRI Differs |
|-----------|------------------|
| **Headlamp core** | We extend it, not compete. If a feature belongs in core, contribute upstream. |
| **Lens** | Heavy, desktop-only, commercial. We make web-based, open source Headlamp better. |
| **k9s** | Different modality (TUI vs web). Not competitive. |
| Competitor | Where PRI Differs |
| -------------------------------- | ----------------------------------------------------------------------------------- |
| **Headlamp core** | We extend it, not compete. If a feature belongs in core, contribute upstream. |
| **Lens** | Heavy, desktop-only, commercial. We make web-based, open source Headlamp better. |
| **k9s** | Different modality (TUI vs web). Not competitive. |
| **Komodor / Kubecost / Robusta** | Standalone products. Our plugins bring their insights INTO Headlamp. Complementary. |
PRI's moat: leading third-party Headlamp plugin developer. Plugins are free, open source, on ArtifactHub.
@@ -67,25 +67,22 @@ PRI's moat: leading third-party Headlamp plugin developer. Plugins are free, ope
## Plugin Evaluation Framework
1. **Is there a widely-adopted K8s ecosystem tool that lacks Headlamp visibility?**
- Fewer than 1,000 GitHub stars or in alpha → too early. Close with "revisit when more mature."
- Already has a Headlamp plugin → duplicate. Close.
* Fewer than 1,000 GitHub stars or in alpha → too early. Close with "revisit when more mature."
* Already has a Headlamp plugin → duplicate. Close.
2. **Does the plugin add value over `kubectl` + the tool's own CLI/UI?**
- "It shows the same thing but in Headlamp" → weak value prop. Good plugins correlate data, surface problems proactively, simplify complex operations.
* "It shows the same thing but in Headlamp" → weak value prop. Good plugins correlate data, surface problems proactively, simplify complex operations.
3. **Can Gandalf build and maintain it?**
- One engineer can maintain ~6-8 plugins at current complexity. We're at 6 now. New plugins mean either dropping an existing one or hiring.
* One engineer can maintain \~6-8 plugins at current complexity. We're at 6 now. New plugins mean either dropping an existing one or hiring.
4. **Is it installable via ArtifactHub without extras?**
- Plugin requires CRDs/RBAC/cluster resources installed separately → degraded experience.
- Unacceptable: plugin requires its own operator or sidecar.
* Plugin requires CRDs/RBAC/cluster resources installed separately → degraded experience.
* Unacceptable: plugin requires its own operator or sidecar.
### Priority Tiers
- **P0**: Bugs in existing plugins that break functionality or produce incorrect data
- **P1**: Enhancements to existing plugins users are requesting
- **P2**: New plugins for high-value K8s tools with clear user demand
- **P3**: Speculative plugins, cross-plugin features, UX experiments
* **P0**: Bugs in existing plugins that break functionality or produce incorrect data
* **P1**: Enhancements to existing plugins users are requesting
* **P2**: New plugins for high-value K8s tools with clear user demand
* **P3**: Speculative plugins, cross-plugin features, UX experiments
## Feature Spec Template
@@ -110,4 +107,4 @@ What must exist in the cluster for this plugin to work? (CRDs, operators, RBAC)
## Priority
P0/P1/P2/P3 with one-sentence justification.
```
```