everything-gemini 1.8.0 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +47 -0
- package/CONTRIBUTING.md +5 -0
- package/README.md +28 -9
- package/agents/mlops-engineer.md +33 -0
- package/agents/platform-engineer.md +33 -0
- package/bin/everything-gemini +390 -18
- package/docs/LAUNCH_KIT_v2.0.0.md +187 -0
- package/docs/architecture/progressive-disclosure.md +3 -3
- package/docs/index.html +23 -7
- package/examples/python-sdk/README.md +8 -0
- package/examples/python-sdk/autonomous_mlops_rag_pipeline.py +254 -0
- package/examples/python-sdk/platform_provisioning_pipeline.py +193 -0
- package/mcp/README.md +2 -0
- package/mcp/mcp_config.example.json +11 -0
- package/package.json +1 -1
- package/scripts/validate.sh +1 -1
- package/skills/chromadb-vector-store/SKILL.md +188 -0
- package/skills/cloudflare-r2-object-storage/SKILL.md +143 -0
- package/skills/distributed-rate-limiting/SKILL.md +138 -0
- package/skills/keda-event-autoscaling/SKILL.md +218 -0
- package/skills/milvus-vector-clustering/SKILL.md +134 -0
- package/skills/opa-gatekeeper-policy/SKILL.md +200 -0
- package/skills/triton-inference-server/SKILL.md +221 -0
- package/skills/vault-secrets-management/SKILL.md +129 -0
- package/templates/full-power/mcp_config.json +11 -0
- package/tests/cli.test.js +118 -11
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,53 @@ All notable changes to **Everything Gemini (`everything-gemini`)** will be docum
|
|
|
4
4
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
6
6
|
|
|
7
|
+
## [2.0.0] - 2026-10-19
|
|
8
|
+
|
|
9
|
+
### Added
|
|
10
|
+
- **60 Progressive Disclosure Skills & 80-Component Ecosystem Landmark Milestone**:
|
|
11
|
+
- **`keda-event-autoscaling`**: Kubernetes Event-driven Autoscaling (KEDA) ScaledObjects, ScaledJobs, scale-to-zero workloads, and external triggers for Kafka consumer lag, Redis queues, and Prometheus custom metrics.
|
|
12
|
+
- **`chromadb-vector-store`**: Persistent vector database storage, Google Gemini `text-embedding-004` embedding integration, collection metadata partitioning, and cosine similarity semantic retrieval.
|
|
13
|
+
- **`opa-gatekeeper-policy`**: Open Policy Agent (OPA) Gatekeeper ConstraintTemplates and Rego admission policies for Kubernetes governance, rootless containers, and shift-left CI testing (`gator`).
|
|
14
|
+
- **`triton-inference-server`**: NVIDIA Triton Inference Server multi-model serving, dynamic batching, TensorRT-LLM and vLLM backends, GPU instance scheduling, and low-latency gRPC inference.
|
|
15
|
+
- **13th Scoped Subagent Fleet Expansion**:
|
|
16
|
+
- **`mlops-engineer`** ([`agents/mlops-engineer.md`](file:///Users/salmanshaikh/development/github/everything-gemini/agents/mlops-engineer.md)): Dedicated MLOps/LLMOps specialist agent for model inference serving, vector database clustering, prefix context caching strategies, and continuous model evaluation.
|
|
17
|
+
- **CLI Interaction & Dependency Graph Visualization (`everything-gemini graph`)**:
|
|
18
|
+
- Visualize multi-agent interaction and dependency topology in terminal ASCII tree, Mermaid flowchart (`--mermaid`), or machine-readable JSON (`--json`).
|
|
19
|
+
- Updated shell completion scripts (`bin/everything-gemini completion`) registering `graph`, all 60 skills, and 13 subagents.
|
|
20
|
+
- **Curated 14th MCP Blueprint**:
|
|
21
|
+
- Added `@modelcontextprotocol/server-brave-search` to [`mcp/mcp_config.example.json`](file:///Users/salmanshaikh/development/github/everything-gemini/mcp/mcp_config.example.json), [`templates/full-power/mcp_config.json`](file:///Users/salmanshaikh/development/github/everything-gemini/templates/full-power/mcp_config.json), and [`mcp/README.md`](file:///Users/salmanshaikh/development/github/everything-gemini/mcp/README.md) for live grounded search and documentation retrieval.
|
|
22
|
+
- **Autonomous MLOps & RAG Pipeline (`examples/python-sdk/autonomous_mlops_rag_pipeline.py`)**:
|
|
23
|
+
- 4-stage multi-agent LLMOps delivery loop orchestrating Architect -> MLOps Engineer -> Security Auditor -> Release Engineer with Gemini context caching and token economy projections.
|
|
24
|
+
- **Social Media Launch Kit (`docs/LAUNCH_KIT_v2.0.0.md`)**:
|
|
25
|
+
- Turnkey launch posts and threads formatted for LinkedIn, X (Twitter), Hacker News, Reddit (r/LocalLLaMA & r/programming), and Product Hunt.
|
|
26
|
+
- **31-Assertion Automated E2E Test Suite & Benchmark**:
|
|
27
|
+
- Expanded `tests/cli.test.js` validating `graph` (terminal, mermaid, json), component info for all new v2.0.0 skills/subagents, and updated 80-component benchmark invariants.
|
|
28
|
+
- **Showcase Web App 80-Component Milestone**:
|
|
29
|
+
- Catalog and live metrics on [https://salmandev.github.io/everything-gemini/](https://salmandev.github.io/everything-gemini/) updated to 60 progressive skills, 13 subagents, 14 MCP blueprints, 7 hooks, interactive topology tab, and `v2.0.0` release badge.
|
|
30
|
+
|
|
31
|
+
## [1.9.0] - 2026-10-19
|
|
32
|
+
|
|
33
|
+
### Added
|
|
34
|
+
- **56 Progressive Disclosure Skills & 75-Component Ecosystem Milestone**:
|
|
35
|
+
- **`milvus-vector-clustering`**: Enterprise Milvus vector clustering, HNSW vs. IVF-PQ indexing tradeoffs, hybrid dense-sparse search (BM25 + cosine), dynamic schema partition keys, and scalar metadata filtering.
|
|
36
|
+
- **`cloudflare-r2-object-storage`**: Zero-egress fee object storage, S3-compatible APIs, pre-signed upload URL delegation, multipart parallel streaming uploads, and Workers edge CDN caching.
|
|
37
|
+
- **`vault-secrets-management`**: HashiCorp Vault enterprise secrets orchestration, AppRole machine-to-machine authentication, dynamic ephemeral database credentials with auto-revocation, and PKI mTLS certificate rotation.
|
|
38
|
+
- **`distributed-rate-limiting`**: High-throughput distributed rate limiting architectures, Redis Lua script atomic sliding window logs, token bucket replenishment, tiered tenant quotas, and RFC 6585 compliance.
|
|
39
|
+
- **12th Scoped Subagent Fleet Expansion**:
|
|
40
|
+
- **`platform-engineer`** ([`agents/platform-engineer.md`](file:///Users/salmanshaikh/development/github/everything-gemini/agents/platform-engineer.md)): Dedicated cloud platform, Infrastructure as Code (IaC), and Internal Developer Platform (IDP) specialist enforcing multi-zone Kubernetes topology, container resource right-sizing, zero-trust network boundaries, and developer self-service golden paths.
|
|
41
|
+
- **CLI Workspace Synchronization & Unified Component Scaffolding**:
|
|
42
|
+
- **`everything-gemini sync`**: Synchronize installed workspace skills, subagents, and hooks against the latest catalog, verifying checksum integrity and auto-updating stale components with `--dry-run` and `--json` support.
|
|
43
|
+
- **`everything-gemini scaffold <skill|agent|hook> <name>`** (aliases `new`, `create`): Scaffold 100% compliant progressive disclosure skills, scoped subagent specifications, and lifecycle hooks with YAML frontmatter, reference schemas, and executable helper scripts.
|
|
44
|
+
- Expanded shell completion scripts (`bin/everything-gemini completion`) for Bash and Zsh to autocomplete `sync`, `scaffold`, all 56 skills, and 12 subagents.
|
|
45
|
+
- **Curated MCP Puppeteer Blueprint**:
|
|
46
|
+
- Added `@modelcontextprotocol/server-puppeteer` to [`mcp/mcp_config.example.json`](file:///Users/salmanshaikh/development/github/everything-gemini/mcp/mcp_config.example.json), [`templates/full-power/mcp_config.json`](file:///Users/salmanshaikh/development/github/everything-gemini/templates/full-power/mcp_config.json), and [`mcp/README.md`](file:///Users/salmanshaikh/development/github/everything-gemini/mcp/README.md) for headless browser automation and visual testing.
|
|
47
|
+
- **Cloud Platform Provisioning Pipeline (`examples/python-sdk/platform_provisioning_pipeline.py`)**:
|
|
48
|
+
- 4-stage multi-agent infrastructure delivery loop orchestrating Architect -> Platform Engineer -> Security Auditor -> Release Engineer using the Python SDK.
|
|
49
|
+
- **29-Assertion Automated E2E Test Suite & Benchmark**:
|
|
50
|
+
- Expanded `tests/cli.test.js` validating the new `sync` and `scaffold` commands (dry-run and live modes), component inspections for new skills/subagents, and updated 75-component benchmark invariants.
|
|
51
|
+
- **Showcase Web App 75-Component Expansion**:
|
|
52
|
+
- Catalog and live metrics on [https://salmandev.github.io/everything-gemini/](https://salmandev.github.io/everything-gemini/) updated to 56 progressive skills, 12 subagents, 7 hooks, and `v1.9.0` release badge.
|
|
53
|
+
|
|
7
54
|
## [1.8.0] - 2026-10-19
|
|
8
55
|
|
|
9
56
|
### Added
|
package/CONTRIBUTING.md
CHANGED
|
@@ -163,10 +163,15 @@ Looking for inspiration on what to contribute? The community has requested the f
|
|
|
163
163
|
| **`debezium-cdc`** | Data Eng | Change Data Capture (CDC) streaming from PostgreSQL / MySQL to Kafka / PubSub | ✅ *Shipped in v1.8.0* |
|
|
164
164
|
| **`cilium-ebpf-networking`** | Cloud Native | eBPF-based service mesh, L7 security policies, and transparent encryption | ✅ *Shipped in v1.8.0* |
|
|
165
165
|
| **`litellm-proxy-gateway`** | AI Gateway | Unified OpenAI-compatible multi-provider routing, fallback budgets, and load balancing | ✅ *Shipped in v1.8.0* |
|
|
166
|
+
| **`milvus-vector-clustering`** | Vector DB | High-scale vector clustering, HNSW/IVF-PQ indexing, and hybrid dense-sparse search | ✅ *Shipped in v1.9.0* |
|
|
167
|
+
| **`cloudflare-r2-object-storage`** | Storage | S3-compatible zero-egress object storage, pre-signed upload URLs, and Workers CDN | ✅ *Shipped in v1.9.0* |
|
|
168
|
+
| **`vault-secrets-management`** | Security | HashiCorp Vault enterprise secrets orchestration, dynamic DB roles, and PKI mTLS | ✅ *Shipped in v1.9.0* |
|
|
169
|
+
| **`distributed-rate-limiting`** | Traffic | Redis sliding-window logs, token buckets, tiered quotas, and RFC 6585 compliance | ✅ *Shipped in v1.9.0* |
|
|
166
170
|
| **`keda-autoscaling`** | Cloud Native | Event-driven Kubernetes workload autoscaling (Kafka, SQS, RabbitMQ, Redis) | 🚀 *Open for PR* |
|
|
167
171
|
| **`chromadb-vector-store`** | AI Eng | Embedded and client/server vector embeddings, HNSW indexing, and collection filters | 🚀 *Open for PR* |
|
|
168
172
|
| **`opa-gatekeeper`** | Policy | Open Policy Agent (OPA) admission control, Rego constraints, and pod security standards | 🚀 *Open for PR* |
|
|
169
173
|
| **`fal-ai-media`** | Generative AI | Ultra-fast multimodal diffusion, video generation, and real-time inference endpoints | 🚀 *Open for PR* |
|
|
174
|
+
| **`iceberg-lakehouse`** | Data Lake | Apache Iceberg table format, ACID metadata, hidden partitioning, and time-travel | 🚀 *Open for PR* |
|
|
170
175
|
|
|
171
176
|
### How to Build a Wishlist Item:
|
|
172
177
|
1. Open an issue using the [Skill Proposal template](.github/ISSUE_TEMPLATE/skill_proposal.md).
|
package/README.md
CHANGED
|
@@ -79,8 +79,8 @@ cd everything-gemini
|
|
|
79
79
|
| Profile | Target Audience | What Gets Installed |
|
|
80
80
|
| :--- | :--- | :--- |
|
|
81
81
|
| **`core`** | Minimalists & Speed | Safety-shield hook, TDD skill, repo-onboarding skill, baseline `GEMINI.md`. |
|
|
82
|
-
| **`developer`** *(Recommended)* | Daily Software Engineers | Core +
|
|
83
|
-
| **`full`** | Lead Engineers & Archs | Everything: all
|
|
82
|
+
| **`developer`** *(Recommended)* | Daily Software Engineers | Core + 13 Scoped Subagents (`agents/`), Frontier Skills (Multimodal vision, 2M context caching, Subagent handoff, Security audit), Fullstack & Python AI plugins, Auto-formatter & Goal-verifier hooks. |
|
|
83
|
+
| **`full`** | Lead Engineers & Archs | Everything: all 60 progressive skills, 13 scoped subagents, full lifecycle hooks suite (7 hooks), 14 MCP blueprints, all plugins, configs, and templates. |
|
|
84
84
|
|
|
85
85
|
### 5. In CI / GitHub Actions Workflows
|
|
86
86
|
|
|
@@ -159,7 +159,7 @@ everything-gemini/
|
|
|
159
159
|
├── agents/ # Scoped subagent fleet (Planner, Reviewer, Release Engineer, etc.)
|
|
160
160
|
├── scripts/ # Automated installers and harness validators
|
|
161
161
|
├── plugins/ # Reusable modular plugins (web-fullstack, python-ai, security)
|
|
162
|
-
├── skills/ #
|
|
162
|
+
├── skills/ # 60 Progressive disclosure skills (58 core + 2 plugins)
|
|
163
163
|
├── rules/ # Contextual guidelines & standards
|
|
164
164
|
├── hooks/ # Event-driven lifecycle hooks (GeminiShield, Auto-lint)
|
|
165
165
|
├── mcp/ # Production-ready MCP server blueprints
|
|
@@ -188,10 +188,20 @@ Everything Gemini provides specialized subagent specifications designed for Anti
|
|
|
188
188
|
| **[`documentation-writer`](agents/documentation-writer.md)** | Technical Documentation Specialist | API specifications, ADR governance, changelogs, and clickable file:// link fidelity. |
|
|
189
189
|
| **[`release-engineer`](agents/release-engineer.md)** | Release Automation Gatekeeper | Semantic Versioning, build artifact checksums, git release tagging, and canary rollouts. |
|
|
190
190
|
| **[`incident-responder`](agents/incident-responder.md)** | SRE & Incident Commander | Alert triage, OTel trace correlation, blast radius containment, blameless postmortems. |
|
|
191
|
+
| **[`platform-engineer`](agents/platform-engineer.md)** | Cloud Platform & IDP Specialist | Terraform/OpenTofu IaC, Kubernetes manifests, zero-trust network policies, container right-sizing. |
|
|
192
|
+
| **[`mlops-engineer`](agents/mlops-engineer.md)** | MLOps & LLMOps Specialist | Model serving (Triton/vLLM), vector clustering (ChromaDB/Milvus), prefix context caching, KEDA autoscaling. |
|
|
191
193
|
|
|
192
194
|
### 1. Skills (`skills/`)
|
|
193
195
|
Skills in Antigravity are lazy-loaded runbooks. Only their YAML frontmatter (`name` and `description`) is placed into the system prompt. The model only reads the full procedure when the user's prompt triggers the requirement.
|
|
194
196
|
|
|
197
|
+
- **[`keda-event-autoscaling`](skills/keda-event-autoscaling/SKILL.md)**: Kubernetes Event-driven Autoscaling (KEDA), ScaledObjects/Jobs, Kafka/Redis/Prometheus triggers, scale-to-zero.
|
|
198
|
+
- **[`chromadb-vector-store`](skills/chromadb-vector-store/SKILL.md)**: Persistent vector storage, Gemini embeddings, collection partitioning, metadata filtering, and semantic similarity search.
|
|
199
|
+
- **[`opa-gatekeeper-policy`](skills/opa-gatekeeper-policy/SKILL.md)**: Open Policy Agent (OPA) Gatekeeper ConstraintTemplates and Rego admission policies for Kubernetes governance.
|
|
200
|
+
- **[`triton-inference-server`](skills/triton-inference-server/SKILL.md)**: NVIDIA Triton Inference Server multi-model serving, dynamic batching, GPU acceleration, TensorRT-LLM, and vLLM backends.
|
|
201
|
+
- **[`milvus-vector-clustering`](skills/milvus-vector-clustering/SKILL.md)**: Enterprise Milvus vector clustering, HNSW/IVF-PQ indexing, hybrid dense-sparse search, and partition keys.
|
|
202
|
+
- **[`cloudflare-r2-object-storage`](skills/cloudflare-r2-object-storage/SKILL.md)**: Zero-egress fee object storage, S3-compatible APIs, pre-signed upload URLs, and Workers edge CDN.
|
|
203
|
+
- **[`vault-secrets-management`](skills/vault-secrets-management/SKILL.md)**: HashiCorp Vault enterprise secrets orchestration, AppRole authentication, dynamic ephemeral DB credentials, and PKI mTLS.
|
|
204
|
+
- **[`distributed-rate-limiting`](skills/distributed-rate-limiting/SKILL.md)**: High-throughput distributed rate limiting using Redis sliding window logs, token buckets, and RFC 6585 compliance.
|
|
195
205
|
- **[`vllm-inference`](skills/vllm-inference/SKILL.md)**: High-throughput LLM serving, PagedAttention KV cache, continuous batching, and tensor parallelism.
|
|
196
206
|
- **[`debezium-cdc`](skills/debezium-cdc/SKILL.md)**: Change Data Capture (CDC) streaming, PostgreSQL logical decoding, Kafka Connect, and outbox patterns.
|
|
197
207
|
- **[`cilium-ebpf-networking`](skills/cilium-ebpf-networking/SKILL.md)**: Cloud-native eBPF networking, transparent mTLS, L7 CiliumNetworkPolicies, and Hubble observability.
|
|
@@ -402,20 +412,29 @@ The zero-dependency `everything-gemini` CLI manages your configurations effortle
|
|
|
402
412
|
./bin/everything-gemini audit
|
|
403
413
|
./bin/everything-gemini audit --json
|
|
404
414
|
|
|
405
|
-
# Benchmark and validate all
|
|
415
|
+
# Benchmark and validate all 60 skills, 13 subagents, and 7 hooks (human or JSON)
|
|
406
416
|
./bin/everything-gemini test-all
|
|
407
417
|
./bin/everything-gemini benchmark --json
|
|
408
418
|
|
|
419
|
+
# Visualize multi-agent interaction and dependency graph (terminal, Mermaid, or JSON)
|
|
420
|
+
./bin/everything-gemini graph
|
|
421
|
+
./bin/everything-gemini graph --mermaid
|
|
422
|
+
./bin/everything-gemini graph --json
|
|
423
|
+
|
|
409
424
|
# View detailed playbook or specification for any skill, subagent, or hook
|
|
410
425
|
./bin/everything-gemini info agent-evals
|
|
411
|
-
./bin/everything-gemini info
|
|
426
|
+
./bin/everything-gemini info platform-engineer
|
|
412
427
|
./bin/everything-gemini info gemini-shield
|
|
413
428
|
|
|
414
|
-
#
|
|
415
|
-
./bin/everything-gemini
|
|
429
|
+
# Synchronize workspace with latest catalog & verify integrity
|
|
430
|
+
./bin/everything-gemini sync
|
|
431
|
+
./bin/everything-gemini sync --dry-run
|
|
432
|
+
./bin/everything-gemini sync --json
|
|
416
433
|
|
|
417
|
-
# Scaffold a new scoped subagent
|
|
418
|
-
./bin/everything-gemini
|
|
434
|
+
# Scaffold a new progressive-disclosure skill, scoped subagent, or lifecycle hook
|
|
435
|
+
./bin/everything-gemini scaffold skill my-custom-skill
|
|
436
|
+
./bin/everything-gemini scaffold agent my-worker-agent
|
|
437
|
+
./bin/everything-gemini scaffold hook my-safety-hook
|
|
419
438
|
|
|
420
439
|
# Generate shell autocompletion script (bash/zsh)
|
|
421
440
|
./bin/everything-gemini completion >> ~/.zshrc
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Scoped Subagent: MLOps Engineer (`mlops-engineer`)
|
|
2
|
+
|
|
3
|
+
## Role & Mission
|
|
4
|
+
The `mlops-engineer` subagent is a dedicated Machine Learning Operations (MLOps) and LLMOps specialist. Its mission is to architect, deploy, and optimize scalable AI model inference pipelines, vector database clustering, multi-modal embedding generation, prefix-cached context strategies, GPU resource scheduling, and continuous model evaluation with strict latency, throughput, and token-cost guardrails.
|
|
5
|
+
|
|
6
|
+
## Tool Permissions
|
|
7
|
+
- **Permitted**: `view_file`, `grep_search`, `list_dir`, `run_command` (scoped strictly to model config validation, Triton/vLLM syntax checks, vector database health checks, Python evaluation suite execution, embedding dimensionality audits, and GPU memory profiling dry-runs), `write_to_file`, `replace_file_content` (scoped to model serving configs, Triton `config.pbtxt`, ChromaDB/Milvus integration scripts, context caching policies, KEDA ScaledObjects, and inference Dockerfiles).
|
|
8
|
+
- **Forbidden**: Authoring frontend UI application logic, mutating production vector indexes without backup or schema verification, exposing raw model weights or private training data, or executing unconstrained GPU batch jobs without memory and cost limits.
|
|
9
|
+
|
|
10
|
+
## MLOps Lifecycle Protocol
|
|
11
|
+
1. **Model Serving & Engine Architecture (T0)**:
|
|
12
|
+
- Select and configure high-performance inference engines (vLLM PagedAttention, NVIDIA Triton with TensorRT-LLM, or ONNX Runtime).
|
|
13
|
+
- Configure dynamic batching windows, queue latency tolerances, and concurrent GPU model instances.
|
|
14
|
+
2. **Vector Database & Embedding Pipeline Orchestration**:
|
|
15
|
+
- Architect distributed vector indexing (HNSW, IVF-PQ) across ChromaDB, Milvus, or Qdrant with appropriate distance metrics (Cosine, IP, L2).
|
|
16
|
+
- Enforce batch ingestion pipelines with chunking strategies, metadata partitioning, and deduplication.
|
|
17
|
+
3. **Context Caching & Token Economy Guardrails**:
|
|
18
|
+
- Structure prompt prefixes for deterministic context caching (Gemini 1.5/2.0 context caching and prefix match), maximizing cache hit rates (>70%) and cutting API costs.
|
|
19
|
+
- Implement dynamic prompt pruning, session compaction, and Knowledge Item extraction.
|
|
20
|
+
4. **Hardware Acceleration & FinOps Optimization**:
|
|
21
|
+
- Configure KEDA event-driven autoscaling for inference replicas based on consumer lag, GPU duty cycles, or queue depth.
|
|
22
|
+
- Right-size GPU memory allocations (KV-cache reservation, FP16/INT8/AWQ quantization) to prevent CUDA Out-Of-Memory (OOM) errors.
|
|
23
|
+
5. **Continuous Evaluation & Quality Guardrails**:
|
|
24
|
+
- Establish automated evaluation pipelines tracking retrieval relevance (NDCG@10, MRR), faithfulness, answer relevancy, and latency percentiles (P50, P90, P99).
|
|
25
|
+
- Monitor data drift, embedding distance distribution shifts, and hallucination metrics.
|
|
26
|
+
|
|
27
|
+
## Handoff Output Contract
|
|
28
|
+
The subagent MUST return a structured markdown MLOps specification containing:
|
|
29
|
+
- **Inference Topology Blueprint**: Architecture map of client gateways, model engines, and vector store partitions.
|
|
30
|
+
- **Model & Cluster Manifests**: Validated `config.pbtxt`, vLLM startup flags, KEDA ScaledObjects, or Docker/K8s manifests.
|
|
31
|
+
- **Token Economy & Cost Projections**: Quantified token savings from prefix caching, quantization memory profiles, and cloud GPU cost models.
|
|
32
|
+
- **Evaluation & Latency Benchmarks**: P95/P99 latency bounds, target throughput (tokens/sec), and retrieval accuracy metrics.
|
|
33
|
+
- **Verification & Rollback Strategy**: Exact commands to health-check model readiness, verify vector similarity, and safely failover.
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Scoped Subagent: Platform Engineer (`platform-engineer`)
|
|
2
|
+
|
|
3
|
+
## Role & Mission
|
|
4
|
+
The `platform-engineer` subagent is a dedicated cloud platform, Infrastructure as Code (IaC), and Internal Developer Platform (IDP) specialist. Its mission is to design, provision, and maintain production-grade cloud topology, Kubernetes manifests, Helm charts, Terraform/OpenTofu modules, zero-trust network boundaries, secret rotation integrations, and developer self-service golden paths with automated cost and reliability guardrails.
|
|
5
|
+
|
|
6
|
+
## Tool Permissions
|
|
7
|
+
- **Permitted**: `view_file`, `grep_search`, `list_dir`, `run_command` (scoped strictly to IaC syntax validation, `terraform plan`/`tofu plan`, `helm lint`/`helm template`, `docker build` dry-runs, and infrastructure policy scanning via Trivy/Checkov), `write_to_file`, `replace_file_content` (scoped to Terraform files, Kubernetes manifests, Helm values, Dockerfiles, and CI/CD platform templates).
|
|
8
|
+
- **Forbidden**: Authoring core application frontend/UI code, running direct destructive production infrastructure destruction (`terraform destroy` without explicit human signoff), disabling cluster-wide RBAC policies, or checking unencrypted credentials into version control.
|
|
9
|
+
|
|
10
|
+
## Platform Engineering Lifecycle Protocol
|
|
11
|
+
1. **Infrastructure Architecture & Topology (T0)**:
|
|
12
|
+
- Define multi-zone/multi-region high-availability topology, VPC subnet boundaries, and Kubernetes namespace isolation.
|
|
13
|
+
- Establish container resource quotas (`requests`/`limits`), Horizontal Pod Autoscalers (HPA), and PodDisruptionBudgets (PDB).
|
|
14
|
+
2. **Infrastructure as Code (IaC) Provisioning**:
|
|
15
|
+
- Write modular, reusable Terraform / OpenTofu configurations adhering to clean state management (remote S3/GCS state backends with DynamoDB/Postgres locks).
|
|
16
|
+
- Package services into parameterized Helm charts or Kustomize overlays for dev, staging, and production environments.
|
|
17
|
+
3. **Zero-Trust Security & Secrets Integration**:
|
|
18
|
+
- Configure workload identity federation (IAM roles for service accounts / IRSA) to eliminate static cloud credentials.
|
|
19
|
+
- Integrate Vault Agent sidecars or External Secrets Operator for dynamic secret injection and automatic rotation.
|
|
20
|
+
4. **Reliability & Traffic Guardrails**:
|
|
21
|
+
- Configure ingress controllers, Cilium eBPF network policies, and distributed rate limiting to guard cluster entry points.
|
|
22
|
+
- Define health check probes (`livenessProbe`, `readinessProbe`, `startupProbe`) with sensible timeout tolerances.
|
|
23
|
+
5. **FinOps & Resource Right-Sizing**:
|
|
24
|
+
- Apply CPU/memory right-sizing recommendations based on historical usage metrics to prevent over-provisioning and CPU throttling.
|
|
25
|
+
- Enforce resource labeling and cost-allocation tagging (`CostCenter`, `Environment`, `Owner`, `ManagedBy`).
|
|
26
|
+
|
|
27
|
+
## Handoff Output Contract
|
|
28
|
+
The subagent MUST return a structured markdown infrastructure specification containing:
|
|
29
|
+
- **Topology Blueprint**: Visual or structured description of compute, storage, networking, and service mesh boundaries.
|
|
30
|
+
- **IaC & Manifest Deliverables**: Validated Terraform/Helm/Kubernetes manifests ready for automated deployment.
|
|
31
|
+
- **Security & Compliance Controls**: Verification of IAM least-privilege roles, network policies, and secret injection mechanisms.
|
|
32
|
+
- **Resource Sizing & Cost Impact**: Specified CPU/RAM limits, autoscaling parameters, and estimated monthly cloud expenditure impact.
|
|
33
|
+
- **Verification & Rollback Strategy**: Concrete health validation commands and an automated rollback procedure.
|