From ee2e45f833ad9c20c4b634d66a593f9edfacce92 Mon Sep 17 00:00:00 2001 From: antmikinka Date: Sun, 27 Jul 2025 12:31:34 -0700 Subject: [PATCH] Feat(Expansion Pack): Part 3 - Configuration Guide --- .../Complete AI Agent System - Flowchart.svg | 102 ++++++++++++++++ .../3.1.1 - Company-Specific Variables.yaml | 19 +++ ...3.1.2 - Agent Customization Variables.yaml | 14 +++ .../3.2.1 - Manufacturing Industry.yaml | 16 +++ .../3.2.2 - Software Development.yaml | 16 +++ .../3.2.3 - Healthcare Services.yaml | 16 +++ ...ase 3- Optimization & Scale (Month 4).yaml | 11 ++ .../README.md | 109 ++++++++++++++++++ 8 files changed, 303 insertions(+) create mode 100644 expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/Complete AI Agent System - Flowchart.svg create mode 100644 expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.1 Variable Configuration Guide/3.1.1 - Company-Specific Variables.yaml create mode 100644 expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.1 Variable Configuration Guide/3.1.2 - Agent Customization Variables.yaml create mode 100644 expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.2 Industry Adaptation Examples/3.2.1 - Manufacturing Industry.yaml create mode 100644 expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.2 Industry Adaptation Examples/3.2.2 - Software Development.yaml create mode 100644 expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.2 Industry Adaptation Examples/3.2.3 - Healthcare Services.yaml create mode 100644 expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.3 Implementation Roadmap Template/3.3.3 - Phase 3- Optimization & Scale (Month 4).yaml create mode 100644 expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md diff --git a/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/Complete AI Agent System - Flowchart.svg b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/Complete AI Agent System - Flowchart.svg new file mode 100644 index 00000000..ff58f38a --- /dev/null +++ b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/Complete AI Agent System - Flowchart.svg @@ -0,0 +1,102 @@ +

Complete AI Agent System

PART 3: Configuration & Customization

PART 2: Agent System Templates

PART 1: Google Cloud Vertex AI Setup

P3

Start

P1

P2

1.1 Google Cloud Project Setup

1.1.1 - Initial Project Configuration

1.1.2 - Service Account Setup

1.2 Agent Development Kit Installation

Environment Setup

Basic Project Structure

1.3 Core Configuration Files

1.3.1 - settings.py

1.3.2 - main.py

1.4 Deployment Configuration

1.4.1 - Dockerfile

1.4.2 - cloudbuild.yaml

2.1 Agent Team Configuration

2.1.1 - Blank Team Template

2.1.2 - Team Structures by Function

Strategic Leadership

Product Development

Operations

2.2 Individual Agent Definitions

2.2.1 - Master Agent

2.2.2 - Orchestrator Agent

2.2.3 - Specialist Agent

2.3 Task Templates

Generic Task

Analysis Task

Creation Task

2.4 Document Templates

Master Document

Strategic Planning

Technical Specification

2.5 Checklist Templates

Master Checklist

Quality Validation

2.6 Data Structure Templates

Knowledge Base

Standards Reference

2.7 Workflow Templates

Master Workflow

3.1 Variable Configuration

Company-Specific

Agent Customization

Workflow Variables

3.2 Industry Adaptation

Manufacturing

Software Development

Healthcare

3.3 Implementation Roadmap

Phase 1: Foundation

Phase 2: Core Implementation

Phase 3: Optimization

 \ No newline at end of file diff --git a/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.1 Variable Configuration Guide/3.1.1 - Company-Specific Variables.yaml b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.1 Variable Configuration Guide/3.1.1 - Company-Specific Variables.yaml new file mode 100644 index 00000000..1f868f43 --- /dev/null +++ b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.1 Variable Configuration Guide/3.1.1 - Company-Specific Variables.yaml @@ -0,0 +1,19 @@ +# Company Information +COMPANY_NAME: "Your Company Name" +COMPANY_PREFIX: "yourcompany" # lowercase, no spaces +INDUSTRY: "Your Industry" +BUSINESS_TYPE: "Your Business Type" +PRIMARY_PRODUCT_TYPE: "Your Primary Product" +CORE_BUSINESS_PROCESS: "Your Core Process" + +# Google Cloud Configuration +PROJECT_ID: "your-project-id" +LOCATION: "us-central1" # or your preferred region +BUCKET_NAME: "your-company-ai-agents-storage" +DATABASE_NAME: "your-company-ai-agents-db" + +# Domain-Specific Configuration +PRIMARY_DOMAIN: "Your Primary Domain" +SECONDARY_DOMAIN: "Your Secondary Domain" +SPECIALTY_AREA: "Your Specialization" +TARGET_MARKET: "Your Target Market" \ No newline at end of file diff --git a/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.1 Variable Configuration Guide/3.1.2 - Agent Customization Variables.yaml b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.1 Variable Configuration Guide/3.1.2 - Agent Customization Variables.yaml new file mode 100644 index 00000000..8eb0f25b --- /dev/null +++ b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.1 Variable Configuration Guide/3.1.2 - Agent Customization Variables.yaml @@ -0,0 +1,14 @@ +# Agent Character Information +AGENT_CHARACTER_NAME: "Character Full Name" +AGENT_PROFESSIONAL_TITLE: "Professional Title" +YEARS_EXPERIENCE: "10" # number as string +DOMAIN_EXPERTISE: "Your Domain" +PRIMARY_SPECIALIZATION: "Primary Specialty" +COMMUNICATION_STYLE: "Communication Approach" + +# Agent Capabilities +PRIMARY_TASK: "main-task-name" +SECONDARY_TASK: "supporting-task-name" +ANALYSIS_TASK: "analysis-task-name" +PRIMARY_TEMPLATE: "main-template-name" +DOMAIN_SPECIFIC_UTILS: "domain-utils" \ No newline at end of file diff --git a/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.2 Industry Adaptation Examples/3.2.1 - Manufacturing Industry.yaml b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.2 Industry Adaptation Examples/3.2.1 - Manufacturing Industry.yaml new file mode 100644 index 00000000..761e70cf --- /dev/null +++ b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.2 Industry Adaptation Examples/3.2.1 - Manufacturing Industry.yaml @@ -0,0 +1,16 @@ +# Manufacturing-Specific Configuration +INDUSTRY: "Manufacturing" +BUSINESS_TYPE: "Product Manufacturing" +PRIMARY_PRODUCT_TYPE: "Physical Products" +CORE_BUSINESS_PROCESS: "Production Planning" + +# Manufacturing Agents +ORCHESTRATOR_TITLE: "Production Manager" +SPECIALIST_1_TITLE: "Quality Engineer" +SPECIALIST_2_TITLE: "Process Engineer" +SPECIALIST_3_TITLE: "Supply Chain Coordinator" + +# Manufacturing Workflows +PRIMARY_WORKFLOW: "product-development-to-production" +QUALITY_VALIDATION: "manufacturing-quality-control" +PROCESS_OPTIMIZATION: "production-efficiency" \ No newline at end of file diff --git a/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.2 Industry Adaptation Examples/3.2.2 - Software Development.yaml b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.2 Industry Adaptation Examples/3.2.2 - Software Development.yaml new file mode 100644 index 00000000..4d2ae432 --- /dev/null +++ b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.2 Industry Adaptation Examples/3.2.2 - Software Development.yaml @@ -0,0 +1,16 @@ +# Software-Specific Configuration +INDUSTRY: "Technology" +BUSINESS_TYPE: "Software Development" +PRIMARY_PRODUCT_TYPE: "Software Products" +CORE_BUSINESS_PROCESS: "Software Development Lifecycle" + +# Software Development Agents +ORCHESTRATOR_TITLE: "Technical Lead" +SPECIALIST_1_TITLE: "Software Architect" +SPECIALIST_2_TITLE: "Senior Developer" +SPECIALIST_3_TITLE: "QA Engineer" + +# Software Workflows +PRIMARY_WORKFLOW: "requirements-to-deployment" +QUALITY_VALIDATION: "code-quality-assurance" +PROCESS_OPTIMIZATION: "development-efficiency" \ No newline at end of file diff --git a/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.2 Industry Adaptation Examples/3.2.3 - Healthcare Services.yaml b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.2 Industry Adaptation Examples/3.2.3 - Healthcare Services.yaml new file mode 100644 index 00000000..b2e82580 --- /dev/null +++ b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.2 Industry Adaptation Examples/3.2.3 - Healthcare Services.yaml @@ -0,0 +1,16 @@ +# Healthcare-Specific Configuration +INDUSTRY: "Healthcare" +BUSINESS_TYPE: "Healthcare Services" +PRIMARY_PRODUCT_TYPE: "Patient Care Services" +CORE_BUSINESS_PROCESS: "Patient Care Delivery" + +# Healthcare Agents +ORCHESTRATOR_TITLE: "Clinical Director" +SPECIALIST_1_TITLE: "Clinical Specialist" +SPECIALIST_2_TITLE: "Quality Assurance Coordinator" +SPECIALIST_3_TITLE: "Compliance Officer" + +# Healthcare Workflows +PRIMARY_WORKFLOW: "patient-care-optimization" +QUALITY_VALIDATION: "clinical-quality-assurance" +PROCESS_OPTIMIZATION: "care-delivery-efficiency" \ No newline at end of file diff --git a/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.3 Implementation Roadmap Template/3.3.3 - Phase 3- Optimization & Scale (Month 4).yaml b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.3 Implementation Roadmap Template/3.3.3 - Phase 3- Optimization & Scale (Month 4).yaml new file mode 100644 index 00000000..69fce8df --- /dev/null +++ b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 3 - Configuration and Customization Guide/3.3 Implementation Roadmap Template/3.3.3 - Phase 3- Optimization & Scale (Month 4).yaml @@ -0,0 +1,11 @@ +optimization_focus: + - Performance monitoring and optimization + - User feedback integration and system improvements + - Advanced feature implementation + - Scaling preparation and capacity planning + +success_metrics: + - System performance meets targets + - User adoption and satisfaction metrics + - Quality improvements and efficiency gains + - Business value realization measurement \ No newline at end of file diff --git a/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md new file mode 100644 index 00000000..de0d4680 --- /dev/null +++ b/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md @@ -0,0 +1,109 @@ +# BMad Expansion Pack: Google Cloud Vertex AI Agent System + +[](https://opensource.org/licenses/MIT) +[](https://www.google.com/search?q=https://github.com/antmikinka/BMAD-METHOD) +[](https://cloud.google.com/) + +This expansion pack provides a complete, deployable starter kit for building and hosting sophisticated AI agent systems on Google Cloud Platform (GCP). It bridges the gap between the BMad Method's natural language framework and a production-ready cloud environment, leveraging Google Vertex AI, Cloud Run, and the Google Agent Development Kit (ADK). + +## Features + + * **Automated GCP Setup**: `gcloud` scripts to configure your project, service accounts, and required APIs in minutes. + * **Production-Ready Deployment**: Includes a `Dockerfile` and `cloudbuild.yaml` for easy, repeatable deployments to Google Cloud Run. + * **Rich Template Library**: A comprehensive set of BMad-compatible templates for Teams, Agents, Tasks, Workflows, Documents, and Checklists. + * **Pre-configured Agent Roles**: Includes powerful master templates for key agent archetypes like Orchestrators and Specialists. + * **Highly Customizable**: Easily adapt the entire system with company-specific variables and industry-specific configurations. + * **Powered by Google ADK**: Built on the official Google Agent Development Kit for robust and native integration with Vertex AI services. + +## Prerequisites + +Before you begin, ensure you have the following installed and configured: + + * A Google Cloud Platform (GCP) Account with an active billing account. + * The [Google Cloud SDK (`gcloud` CLI)](https://www.google.com/search?q=%5Bhttps://cloud.google.com/sdk/docs/install%5D\(https://cloud.google.com/sdk/docs/install\)) installed and authenticated. + * [Docker](https://www.docker.com/products/docker-desktop/) installed on your local machine. + * Python 3.11+ + +## Quick Start Guide + +Follow these steps to get your own AI agent system running on Google Cloud. + +### 1\. Configure Setup Variables + +The setup scripts use placeholder variables. Before running them, open the files in the `/scripts` directory and replace the following placeholders with your own values: + + * `{{PROJECT_ID}}`: Your unique Google Cloud project ID. + * `{{COMPANY_NAME}}`: Your company or project name (used for naming resources). + * `{{LOCATION}}`: The GCP region you want to deploy to (e.g., `us-central1`). + +### 2\. Run the GCP Setup Scripts + +Execute the setup scripts to prepare your Google Cloud environment. + +```bash +# Navigate to the scripts directory +cd scripts/ + +# Run the project configuration script +sh 1-initial-project-config.sh + +# Run the service account setup script +sh 2-service-account-setup.sh +``` + +These scripts will enable the necessary APIs, create a service account, assign permissions, and download a JSON key file required for authentication. + +### 3\. Install Python Dependencies + +Install the required Python packages for the application. + +```bash +# From the root of the expansion pack +pip install -r requirements.txt +``` + +### 4\. Deploy to Cloud Run + +Deploy the entire agent system as a serverless application using Cloud Build. + +```bash +# From the root of the expansion pack +gcloud builds submit --config deployment/cloudbuild.yaml . +``` + +This command will build the Docker container, push it to the Google Container Registry, and deploy it to Cloud Run. Your agent system is now live\! + +## How to Use + +Once deployed, the power of this system lies in its natural language templates. + +1. **Define Your Organization**: Go to `/templates/teams` and use the templates to define your agent teams (e.g., Product Development, Operations). +2. **Customize Your Agents**: In `/templates/agents`, use the `Master-Agent-Template.yaml` to create new agents or customize the existing Orchestrator and Specialist templates. Define their personas, skills, and commands in plain English. +3. **Build Your Workflows**: In `/templates/workflows`, link agents and tasks together to create complex, automated processes. + +The deployed application reads these YAML and Markdown files to dynamically construct and run your AI workforce. When you update a template, your live agents automatically adopt the new behaviors. + +## What's Included + +This expansion pack has a comprehensive structure to get you started: + +``` +/ +├── deployment/ # Dockerfile and cloudbuild.yaml for deployment +├── scripts/ # GCP setup scripts (project config, service accounts) +├── src/ # Python source code (main.py, settings.py) +├── templates/ +│ ├── agents/ # Master, Orchestrator, Specialist agent templates +│ ├── teams/ # Team structure templates +│ ├── tasks/ # Generic and specialized task templates +│ ├── documents/ # Document and report templates +│ ├── checklists/ # Quality validation checklists +│ ├── workflows/ # Workflow definition templates +│ └── ...and more +├── config/ # Customization guides and variable files +└── requirements.txt # Python package dependencies +``` + +## Contributing + +Contributions are welcome\! Please follow the main project's `CONTRIBUTING.md` guidelines. For major changes or new features for this expansion pack, please open an issue or discussion first. \ No newline at end of file