@intentsolutionsio/jeremy-gcp-starter-examples 2.1.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/.claude-plugin/plugin.json +21 -0
- package/LICENSE +21 -0
- package/README.md +295 -0
- package/agents/gcp-starter-kit-expert.md +688 -0
- package/package.json +42 -0
- package/skills/gcp-examples-expert/SKILL.md +81 -0
- package/skills/gcp-examples-expert/references/ARD.md +72 -0
- package/skills/gcp-examples-expert/references/PRD.md +68 -0
- package/skills/gcp-examples-expert/references/best-practices-applied.md +38 -0
- package/skills/gcp-examples-expert/references/code-example-categories.md +160 -0
- package/skills/gcp-examples-expert/references/errors.md +54 -0
- package/skills/gcp-examples-expert/references/example-interactions.md +53 -0
- package/skills/gcp-examples-expert/references/examples.md +477 -0
- package/skills/gcp-examples-expert/references/workflow.md +38 -0
- package/skills/gcp-examples-expert/scripts/create-example.sh +93 -0
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "jeremy-gcp-starter-examples",
|
|
3
|
+
"version": "2.1.0",
|
|
4
|
+
"description": "Google Cloud starter kits and example code aggregator with ADK samples",
|
|
5
|
+
"author": {
|
|
6
|
+
"name": "Jeremy Longshore",
|
|
7
|
+
"email": "jeremy@intentsolutions.io"
|
|
8
|
+
},
|
|
9
|
+
"repository": "https://github.com/jeremylongshore/claude-code-plugins",
|
|
10
|
+
"license": "MIT",
|
|
11
|
+
"keywords": [
|
|
12
|
+
"google-cloud",
|
|
13
|
+
"adk-samples",
|
|
14
|
+
"genkit-examples",
|
|
15
|
+
"vertex-ai",
|
|
16
|
+
"agent-starter-pack",
|
|
17
|
+
"code-examples",
|
|
18
|
+
"starter-kits",
|
|
19
|
+
"templates"
|
|
20
|
+
]
|
|
21
|
+
}
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Jeremy Longshore
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,295 @@
|
|
|
1
|
+
# Jeremy GCP Starter Examples
|
|
2
|
+
|
|
3
|
+
Comprehensive Google Cloud starter kit examples aggregator. Expert in ADK samples, Genkit templates, Agent Starter Pack, Vertex AI examples, and production-ready code from official Google Cloud repositories.
|
|
4
|
+
|
|
5
|
+
## Overview
|
|
6
|
+
|
|
7
|
+
This plugin provides instant access to production-ready code examples from 6 official Google Cloud repositories, helping developers quickly implement AI agents, workflows, and applications on Google Cloud Platform.
|
|
8
|
+
|
|
9
|
+
## Installation
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
/plugin install jeremy-gcp-starter-examples@claude-code-plugins-plus
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Features
|
|
16
|
+
|
|
17
|
+
✅ **ADK Sample Code**: Agent creation, Code Execution Sandbox, Memory Bank
|
|
18
|
+
✅ **Agent Starter Pack**: Production templates with monitoring and security
|
|
19
|
+
✅ **Genkit Flows**: RAG, multi-step workflows, tool calling patterns
|
|
20
|
+
✅ **Vertex AI Samples**: Model training, batch prediction, deployment
|
|
21
|
+
✅ **Gemini Examples**: Multimodal analysis, function calling, structured output
|
|
22
|
+
✅ **AgentSmithy Patterns**: Multi-agent orchestration and coordination
|
|
23
|
+
|
|
24
|
+
## Components
|
|
25
|
+
|
|
26
|
+
### Agent
|
|
27
|
+
- **gcp-starter-kit-expert**: Aggregates code examples from official Google Cloud repos
|
|
28
|
+
|
|
29
|
+
### Skills (Auto-Activating)
|
|
30
|
+
- **gcp-examples-expert**: Triggers on "show adk example", "genkit starter template", "vertex ai code sample"
|
|
31
|
+
- **Tool Permissions**: Read, Write, Edit, Grep, Glob, Bash
|
|
32
|
+
- **Version**: 1.0.0 (2026 schema compliant)
|
|
33
|
+
|
|
34
|
+
## Quick Start
|
|
35
|
+
|
|
36
|
+
### Natural Language Activation
|
|
37
|
+
|
|
38
|
+
Simply mention what you need:
|
|
39
|
+
|
|
40
|
+
```
|
|
41
|
+
"Show me ADK sample code for creating an agent"
|
|
42
|
+
"I need a Genkit starter template for RAG"
|
|
43
|
+
"How do I implement Gemini function calling?"
|
|
44
|
+
"Show me Agent Starter Pack production template"
|
|
45
|
+
"Vertex AI code example for model training"
|
|
46
|
+
"Multi-agent orchestration pattern with AgentSmithy"
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
The skill auto-activates and provides production-ready code examples.
|
|
50
|
+
|
|
51
|
+
## Code Example Categories
|
|
52
|
+
|
|
53
|
+
### 1. ADK (Agent Development Kit) Samples
|
|
54
|
+
|
|
55
|
+
**Source**: google/adk-samples
|
|
56
|
+
|
|
57
|
+
- Basic agent creation with Code Execution Sandbox (14-day state persistence)
|
|
58
|
+
- Memory Bank configuration for persistent conversation memory
|
|
59
|
+
- A2A protocol implementation for inter-agent communication
|
|
60
|
+
- Multi-tool agent configuration
|
|
61
|
+
- VPC Service Controls integration
|
|
62
|
+
- IAM least privilege patterns
|
|
63
|
+
|
|
64
|
+
**Example Request**:
|
|
65
|
+
```
|
|
66
|
+
"Show me how to create an ADK agent with Code Execution and Memory Bank"
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### 2. Agent Starter Pack Templates
|
|
70
|
+
|
|
71
|
+
**Source**: GoogleCloudPlatform/agent-starter-pack
|
|
72
|
+
|
|
73
|
+
- Production agent with comprehensive monitoring
|
|
74
|
+
- Auto-scaling configuration (min/max instances)
|
|
75
|
+
- Security best practices (Model Armor, VPC-SC, IAM)
|
|
76
|
+
- Cloud Monitoring dashboards
|
|
77
|
+
- Alerting policies for errors and latency
|
|
78
|
+
- Error tracking and distributed tracing
|
|
79
|
+
|
|
80
|
+
**Example Request**:
|
|
81
|
+
```
|
|
82
|
+
"Give me the Agent Starter Pack production template"
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
### 3. Firebase Genkit Flows
|
|
86
|
+
|
|
87
|
+
**Source**: genkit-ai/genkit
|
|
88
|
+
|
|
89
|
+
- RAG flows with vector search and embeddings
|
|
90
|
+
- Multi-step workflows with tool calling
|
|
91
|
+
- Prompt templates and evaluation frameworks
|
|
92
|
+
- Deployment patterns (Cloud Run, Cloud Functions)
|
|
93
|
+
- Node.js, Python, and Go examples
|
|
94
|
+
|
|
95
|
+
**Example Request**:
|
|
96
|
+
```
|
|
97
|
+
"I need a Genkit RAG flow template with vector search"
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
### 4. Vertex AI Training & Deployment
|
|
101
|
+
|
|
102
|
+
**Source**: GoogleCloudPlatform/vertex-ai-samples
|
|
103
|
+
|
|
104
|
+
- Custom model fine-tuning with Gemini
|
|
105
|
+
- Batch prediction jobs for bulk inference
|
|
106
|
+
- Hyperparameter tuning with Vertex AI
|
|
107
|
+
- Model evaluation and monitoring
|
|
108
|
+
- Endpoint deployment with auto-scaling
|
|
109
|
+
- A/B testing and traffic splitting
|
|
110
|
+
|
|
111
|
+
**Example Request**:
|
|
112
|
+
```
|
|
113
|
+
"Show me how to fine-tune Gemini on custom data"
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
### 5. Gemini API Integration
|
|
117
|
+
|
|
118
|
+
**Source**: GoogleCloudPlatform/generative-ai
|
|
119
|
+
|
|
120
|
+
- Multimodal analysis (text, images, video)
|
|
121
|
+
- Function calling with live API integration
|
|
122
|
+
- Structured output generation with schemas
|
|
123
|
+
- Grounding with Google Search
|
|
124
|
+
- Safety filters and content moderation
|
|
125
|
+
- Token counting and cost optimization
|
|
126
|
+
|
|
127
|
+
**Example Request**:
|
|
128
|
+
```
|
|
129
|
+
"How do I analyze video content with Gemini multimodal?"
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
### 6. Multi-Agent Orchestration
|
|
133
|
+
|
|
134
|
+
**Source**: GoogleCloudPlatform/agentsmithy
|
|
135
|
+
|
|
136
|
+
- Multi-agent system coordination
|
|
137
|
+
- Supervisory agent patterns
|
|
138
|
+
- Agent-to-agent communication (A2A protocol)
|
|
139
|
+
- Workflow strategies (sequential, parallel, conditional)
|
|
140
|
+
- Task delegation and error handling
|
|
141
|
+
- Retry logic with exponential backoff
|
|
142
|
+
|
|
143
|
+
**Example Request**:
|
|
144
|
+
```
|
|
145
|
+
"I want to build a multi-agent system with AgentSmithy"
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
## Use Cases
|
|
149
|
+
|
|
150
|
+
### Quick Prototyping
|
|
151
|
+
Get production-ready code to start building immediately without searching through documentation.
|
|
152
|
+
|
|
153
|
+
### Learning Best Practices
|
|
154
|
+
See how Google Cloud engineers implement security, monitoring, and scalability in official examples.
|
|
155
|
+
|
|
156
|
+
### Production Templates
|
|
157
|
+
Use battle-tested patterns from Agent Starter Pack for production deployments.
|
|
158
|
+
|
|
159
|
+
### Framework Comparison
|
|
160
|
+
Compare ADK, Genkit, and Vertex AI implementations to choose the right framework.
|
|
161
|
+
|
|
162
|
+
### Infrastructure as Code
|
|
163
|
+
Get Terraform templates for deploying agents and infrastructure.
|
|
164
|
+
|
|
165
|
+
## Integration with Other Plugins
|
|
166
|
+
|
|
167
|
+
### jeremy-genkit-pro
|
|
168
|
+
- Provides Genkit code examples
|
|
169
|
+
- Complements Genkit flow architect agent
|
|
170
|
+
- Shares production best practices
|
|
171
|
+
|
|
172
|
+
### jeremy-adk-orchestrator
|
|
173
|
+
- Provides ADK sample code
|
|
174
|
+
- Shows A2A protocol implementation
|
|
175
|
+
- Demonstrates multi-agent patterns
|
|
176
|
+
|
|
177
|
+
### jeremy-vertex-validator
|
|
178
|
+
- Provides code that passes production validation
|
|
179
|
+
- Follows security and performance best practices
|
|
180
|
+
- Includes monitoring from the start
|
|
181
|
+
|
|
182
|
+
### jeremy-*-terraform plugins
|
|
183
|
+
- Provides infrastructure code examples
|
|
184
|
+
- Shows Terraform module patterns
|
|
185
|
+
- Demonstrates resource configuration
|
|
186
|
+
|
|
187
|
+
## Example Workflows
|
|
188
|
+
|
|
189
|
+
### Workflow 1: Build ADK Agent
|
|
190
|
+
|
|
191
|
+
```
|
|
192
|
+
User: "Show me ADK code for an agent with Code Execution"
|
|
193
|
+
|
|
194
|
+
Plugin provides:
|
|
195
|
+
1. Agent creation code from google/adk-samples
|
|
196
|
+
2. Code Execution Sandbox configuration (14-day TTL)
|
|
197
|
+
3. Security best practices (IAM, VPC-SC)
|
|
198
|
+
4. Monitoring setup
|
|
199
|
+
5. Deployment commands
|
|
200
|
+
```
|
|
201
|
+
|
|
202
|
+
### Workflow 2: Implement Genkit RAG
|
|
203
|
+
|
|
204
|
+
```
|
|
205
|
+
User: "I need a Genkit RAG flow template"
|
|
206
|
+
|
|
207
|
+
Plugin provides:
|
|
208
|
+
1. RAG flow code from genkit-ai/genkit
|
|
209
|
+
2. Vector search integration
|
|
210
|
+
3. Embedding generation
|
|
211
|
+
4. Context retrieval logic
|
|
212
|
+
5. Deployment to Cloud Run
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
### Workflow 3: Production Agent Deployment
|
|
216
|
+
|
|
217
|
+
```
|
|
218
|
+
User: "How do I deploy a production agent?"
|
|
219
|
+
|
|
220
|
+
Plugin provides:
|
|
221
|
+
1. Agent Starter Pack template
|
|
222
|
+
2. Auto-scaling configuration
|
|
223
|
+
3. Monitoring dashboard code
|
|
224
|
+
4. Alerting policy setup
|
|
225
|
+
5. Terraform deployment code
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
## Best Practices Included
|
|
229
|
+
|
|
230
|
+
### Security
|
|
231
|
+
- IAM least privilege service accounts
|
|
232
|
+
- VPC Service Controls for enterprise isolation
|
|
233
|
+
- Model Armor for prompt injection protection
|
|
234
|
+
- Encrypted data at rest and in transit
|
|
235
|
+
- No hardcoded credentials (Secret Manager)
|
|
236
|
+
|
|
237
|
+
### Performance
|
|
238
|
+
- Auto-scaling (min/max instances)
|
|
239
|
+
- Appropriate machine types and accelerators
|
|
240
|
+
- Caching strategies
|
|
241
|
+
- Batch processing
|
|
242
|
+
- Token optimization
|
|
243
|
+
|
|
244
|
+
### Observability
|
|
245
|
+
- Cloud Monitoring dashboards
|
|
246
|
+
- Alerting policies
|
|
247
|
+
- Structured logging
|
|
248
|
+
- Distributed tracing
|
|
249
|
+
- Error tracking
|
|
250
|
+
|
|
251
|
+
### Reliability
|
|
252
|
+
- Multi-region deployment
|
|
253
|
+
- Circuit breaker patterns
|
|
254
|
+
- Retry logic with exponential backoff
|
|
255
|
+
- Health check endpoints
|
|
256
|
+
- Graceful degradation
|
|
257
|
+
|
|
258
|
+
### Cost Optimization
|
|
259
|
+
- Gemini 2.5 Flash for simple tasks
|
|
260
|
+
- Gemini 2.5 Pro for complex reasoning
|
|
261
|
+
- Batch predictions for bulk processing
|
|
262
|
+
- Preemptible instances
|
|
263
|
+
- Token counting
|
|
264
|
+
|
|
265
|
+
## Official Repositories Referenced
|
|
266
|
+
|
|
267
|
+
This plugin aggregates code from these official Google Cloud repositories:
|
|
268
|
+
|
|
269
|
+
1. **google/adk-samples** - ADK agent examples and patterns
|
|
270
|
+
2. **GoogleCloudPlatform/agent-starter-pack** - Production agent templates
|
|
271
|
+
3. **genkit-ai/genkit** - Genkit flows and integrations
|
|
272
|
+
4. **GoogleCloudPlatform/vertex-ai-samples** - Vertex AI notebooks and code
|
|
273
|
+
5. **GoogleCloudPlatform/generative-ai** - Gemini API examples
|
|
274
|
+
6. **GoogleCloudPlatform/agentsmithy** - Multi-agent orchestration
|
|
275
|
+
|
|
276
|
+
## Requirements
|
|
277
|
+
|
|
278
|
+
- Google Cloud Project with Vertex AI enabled
|
|
279
|
+
- Appropriate IAM permissions for agent creation
|
|
280
|
+
- gcloud CLI configured (for deployment)
|
|
281
|
+
- Node.js 20+ (for Genkit examples)
|
|
282
|
+
- Python 3.10+ (for ADK/Vertex AI examples)
|
|
283
|
+
|
|
284
|
+
## License
|
|
285
|
+
|
|
286
|
+
MIT
|
|
287
|
+
|
|
288
|
+
## Support
|
|
289
|
+
|
|
290
|
+
- Issues: https://github.com/jeremylongshore/claude-code-plugins/issues
|
|
291
|
+
- Discussions: https://github.com/jeremylongshore/claude-code-plugins/discussions
|
|
292
|
+
|
|
293
|
+
## Version
|
|
294
|
+
|
|
295
|
+
2.1.0 (2026) - Accuracy audit: fixed imports, updated repo references, expanded error docs
|