@jaguilar87/gaia-ops 1.4.0 → 2.2.0

package/CHANGELOG.md

@@ -7,6 +7,136 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [2.2.0] - 2025-11-10
+
+### Added - Unified Settings Template & Auto-Installation
+- **NEW:** Created unified `templates/settings.template.json` (214 lines)
+  - Merged functionality from `settings.json` + `settings.local.json`
+  - Includes all hooks (PreToolUse, PostToolUse, SubagentStop)
+  - Complete permissions (75+ allow, 9 deny, 27 ask entries)
+  - Full security tier definitions (T0-T3)
+  - Environment configuration
+
+- **Auto-Installation:** `gaia-init.js` now automatically generates `.claude/settings.json`
+  - Added `generateSettingsJson()` function
+  - Integrated into installation workflow (Step 6.5)
+  - Projects get complete settings from day 1
+
+### Removed - Dead Code Elimination
+- **CLAUDE.md** from package root (only template exists now)
+- **templates/code-examples/** (321 lines - never imported or executed)
+  - `commit_validation.py`
+  - `clarification_workflow.py`
+  - `approval_gate_workflow.py`
+- **templates/project-context.template.json** (126 lines - unused, installer generates programmatically)
+- **templates/project-context.template.aws.json** (128 lines - never used)
+- **package.json:** Removed `CLAUDE.md` from files array
+
+### Changed - Package Consistency
+- **templates/CLAUDE.template.md:**
+  - Updated all references: `.claude/docs/` → `.claude/config/`
+  - Updated package name: `@aaxis/claude-agents` → `@jaguilar87/gaia-ops`
+  - Removed code-examples reference (no longer exists)
+
+- **README.en.md:**
+  - Updated API examples to use `@jaguilar87/gaia-ops`
+  - Changed `getDocPath()` → `getConfigPath()` (correct function)
+
+- **index.js:**
+  - Updated header and JSDoc comments with new package name
+  - Updated example usage
+
+- **agents/claude-architect.md:**
+  - Updated system paths to reflect gaia-ops package structure
+  - Clarified symlink architecture and layout
+
+### Improved - Package Quality
+- **Reduced template bloat by 57%:** 882 lines → 378 lines (504 lines removed)
+- **Single source of truth:** One settings template instead of scattered config
+- **Cleaner architecture:** Only actual templates remain in `templates/`
+- **Better defaults:** Projects start with complete, production-ready settings
+
+### Benefits
+- ✅ **Unified configuration:** Everything in one settings.json file
+- ✅ **Automatic setup:** No manual settings configuration needed
+- ✅ **Smaller package:** 57% reduction in template code
+- ✅ **Flexibility maintained:** Users can still create `settings.local.json` for overrides
+- ✅ **Package consistency:** All references use correct package name
+
+### Final Template Structure
+```
+templates/
+├── CLAUDE.template.md         (164 lines) - Orchestrator instructions
+└── settings.template.json     (214 lines) - Complete Claude Code settings
+```
+
+---
+
+## [2.1.0] - 2025-11-10
+
+### Added - Provider-Specific Context Contracts
+- **NEW:** Created separate contract files per cloud provider
+  - `config/context-contracts.gcp.json` - GCP-specific contracts
+  - `config/context-contracts.aws.json` - AWS-specific contracts
+  - Ready for `context-contracts.azure.json` (future)
+
+- **Auto-Detection:** `context_provider.py` now automatically:
+  1. Detects cloud provider from `metadata.cloud_provider`
+  2. Falls back to inferring from field presence (`project_id` → GCP, `account_id` → AWS)
+  3. Loads the correct contract file
+  4. Validates against provider-specific requirements
+
+- **Test Fixtures:** Added sample contexts for testing
+  - `tests/fixtures/project-context.gcp.json`
+  - `tests/fixtures/project-context.aws.json`
+
+### Changed
+- **Context Provider:** Updated `tools/context_provider.py`
+  - Added `detect_cloud_provider()` function
+  - Added `load_provider_contracts()` function
+  - Updated `get_contract_context()` to accept provider contracts
+  - Legacy contracts remain for backward compatibility
+
+- **Field Names:** Standardized provider-specific fields
+  - GCP: `project_details.project_id` (no change)
+  - AWS: `project_details.account_id` (was `aws_account`)
+  - Installer updated to generate correct field names
+
+- **Templates:** Created AWS-specific template
+  - `templates/project-context.template.aws.json`
+  - Matches AWS naming conventions (EKS, RDS, ECR, etc.)
+
+- **Documentation:** Updated `config/context-contracts.md`
+  - Added "Provider-Specific Contracts" section
+  - Documented how provider detection works
+  - Explained benefits of provider-specific approach
+  - Version bumped to 2.1.0
+
+### Benefits
+- ✅ **Clarity:** Field names match cloud provider terminology
+- ✅ **Simplicity:** No complex conditional validation logic in agents
+- ✅ **Extensibility:** Adding Azure = create one JSON file (15 minutes)
+- ✅ **Agents Stay Agnostic:** Agents use pattern discovery, don't need provider logic
+- ✅ **Single Source of Truth:** Orchestrator selects the right contract
+
+### Backward Compatibility
+- **Legacy support maintained:** If provider-specific contracts don't exist, falls back to hardcoded contracts
+- **Existing projects:** Continue to work without changes
+- **Migration:** Optional, but recommended for clarity
+
+### Technical Details
+```python
+# Before (v2.0.0):
+contract_keys = AGENT_CONTRACTS[agent_name]  # Hardcoded
+
+# After (v2.1.0):
+cloud_provider = detect_cloud_provider(project_context)  # Auto-detect
+contracts = load_provider_contracts(cloud_provider)      # Load from JSON
+contract_keys = contracts["agents"][agent_name]["required"]  # Provider-specific
+```
+
+---
+
 ## [1.4.0] - 2025-11-10
 
 ### Changed - BREAKING: Complete Installer Redesign

package/README.en.md

@@ -14,6 +14,7 @@ Multi-agent orchestration system for Claude Code - DevOps automation toolkit.
 
 ### Features
 
+- **Multi-cloud support** - Works with GCP, AWS, and ready for Azure
 - **6 specialist agents** (terraform-architect, gitops-operator, gcp-troubleshooter, aws-troubleshooter, devops-developer, claude-architect)
 - **3 meta-agents** (Explore, Plan, claude-architect)
 - **Clarification engine** for ambiguity detection
@@ -160,17 +161,17 @@ If you need to programmatically access paths in the package:
 import {
   getAgentPath,
   getToolPath,
-  getDocPath
-} from '@aaxis/claude-agents';
+  getConfigPath
+} from '@jaguilar87/gaia-ops';
 
 const agentPath = getAgentPath('gitops-operator');
-// → /path/to/node_modules/@aaxis/claude-agents/agents/gitops-operator.md
+// → /path/to/node_modules/@jaguilar87/gaia-ops/agents/gitops-operator.md
 
 const toolPath = getToolPath('context_provider.py');
-// → /path/to/node_modules/@aaxis/claude-agents/tools/context_provider.py
+// → /path/to/node_modules/@jaguilar87/gaia-ops/tools/context_provider.py
 
-const docPath = getDocPath('orchestration-workflow.md');
-// → /path/to/node_modules/@aaxis/claude-agents/docs/orchestration-workflow.md
+const configPath = getConfigPath('orchestration-workflow.md');
+// → /path/to/node_modules/@jaguilar87/gaia-ops/config/orchestration-workflow.md
 ```
 
 ## Versioning

package/README.md

@@ -14,6 +14,7 @@ Sistema de orquestación multi-agente para Claude Code - Toolkit de automatizaci
 
 ### Características
 
+- **Soporte multi-cloud** - Funciona con GCP, AWS, y listo para Azure
 - **6 agentes especialistas** (terraform-architect, gitops-operator, gcp-troubleshooter, aws-troubleshooter, devops-developer, claude-architect)
 - **3 meta-agentes** (Explore, Plan, claude-architect)
 - **Motor de clarificación** para detección de ambigüedades
@@ -181,7 +182,7 @@ Este paquete sigue [Versionamiento Semántico](https://semver.org/):
 - **MINOR:** Nuevas características, agentes o mejoras
 - **PATCH:** Correcciones de bugs, clarificaciones, errores tipográficos
 
-Versión actual: **1.0.3**
+Versión actual: **2.1.0**
 
 Ver [CHANGELOG.md](./CHANGELOG.md) para el historial de versiones.
 

package/agents/claude-architect.md

@@ -15,16 +15,16 @@ You are a senior system architect and AI agent systems specialist. Your unique p
 2. **Locate & Read:** You know where EVERYTHING lives. Read only what you need for THIS request.
 3. **Analyze & Respond:** Provide comprehensive answer with evidence, examples, and actionable recommendations.
 
-**Where Everything Lives (You Know This By Heart):**
-- 🏗️ System: `/home/jaguilar/aaxis/rnd/repositories/.claude/`
-- 📋 Orchestrator: `CLAUDE.md` (workflow logic)
-- 🤖 Agents: `.claude/agents/` (5 specialists + you)
-- 🛠️ Tools: `.claude/tools/` (routing, context, validation)
-- 📊 Logs: `.claude/logs/` (JSONL audit trail)
-- ✅ Tests: `.claude/tests/` (55+ tests)
-- 🎯 Spec-Kit: `.claude/commands/speckit.*` (7 commands)
-- 💾 Sessions: `.claude/session/` (active + bundles)
-- 🔗 Multi-repo: `ops/` (symlinks: claude-rnd, claude-vtr)
+**Where Everything Lives (Package + Symlink Layout):**
+- 🏗️ Package root: `/home/jaguilar/aaxis/rnd/repositories/gaia-ops/` → mirrors `node_modules/@jaguilar87/gaia-ops/` when installed
+- 📋 Orchestrator: `CLAUDE.md` at the package root (templated into consuming repos)
+- 🤖 Agents: `agents/*.md` (6 specialists: terraform-architect, gitops-operator, gcp-troubleshooter, aws-troubleshooter, devops-developer, claude-architect)
+- 🛠️ Tools: `tools/` (context_provider.py, agent_router.py, clarify_engine.py, approval_gate.py, commit_validator.py, task_manager.py)
+- 📚 Config docs: `config/` (AGENTS, orchestration-workflow, git-standards, context-contracts, agent-catalog)
+- 🗂️ Commands: `commands/*.md` (`/architect`, `/save-session`, `/session-status`, `/speckit.*`)
+- 🎯 Spec-Kit assets: `speckit/README*.md`, `speckit/templates/`, `speckit/scripts/`, `speckit/governance.md`, `speckit/decisions/`
+- 🔧 Reference stacks: `terraform/`, `gitops/`, `app-services/` illustrate how agents interact with user IaC/App repos
+- 💾 Project data: consuming repos host `.claude/project-context.json`, `.claude/logs/`, `.claude/tests/`, while `ops/` carries shared symlink helpers
 
 **Your Superpowers:**
 - ✅ You understand the ENTIRE system (no one else does)
@@ -65,43 +65,51 @@ You have intrinsic knowledge of the system's structure. You know EXACTLY where t
 ### Core System Files (Always Available)
 
 ```
-Agent System Structure:
-├── CLAUDE.md                           # Master orchestrator logic (715 lines)
-├── .claude/
-│   ├── project-context.json           # Project SSOT (varies by project)
-│   ├── settings.json                  # System configuration
-│   ├── agents/                        # 5 specialized agents
-│   │   ├── gitops-operator.md         (340 lines)
-│   │   ├── terraform-architect.md     (270 lines)
-│   │   ├── gcp-troubleshooter.md      (305 lines)
-│   │   ├── aws-troubleshooter.md      (289 lines)
-│   │   └── devops-developer.md        (89 lines)
-│   ├── tools/                         # System intelligence
-│   │   ├── agent_router.py            # Semantic routing (92.7% accuracy target)
-│   │   ├── context_provider.py        # Deterministic context generation
-│   │   ├── context_section_reader.py  # Selective context loading
-│   │   ├── semantic_matcher.py        # Fallback routing
-│   │   ├── agent_invoker_helper.py    # Agent invocation utilities
-│   │   ├── tasks-richer.py            # Task enrichment
-│   │   └── generate_embeddings.py     # Embedding generation
-│   ├── hooks/                         # Security & audit layer
-│   │   ├── pre_tool_use.py           # Pre-execution validation
-│   │   ├── post_tool_use.py          # Post-execution audit
-│   │   └── subagent_stop.py          # Agent completion capture
-│   ├── commands/                      # 13 slash commands
-│   ├── session/                       # Session management
-│   │   ├── active/context.json       # Live session state
-│   │   ├── bundles/                  # Historical snapshots
-│   │   └── scripts/                  # Session tools
-│   ├── tests/                         # Test suite (55+ tests)
-│   │   ├── test_semantic_routing.py  # Routing accuracy tests
-│   │   ├── test_all_functionality.py # Core system tests
-│   │   └── test_ssot_policies.py     # SSOT validation
-│   ├── logs/                          # Audit trail (JSONL format)
-│   └── schemas/                       # JSON schemas
-└── improvement-ideas.md               # System improvement backlog
+gaia-ops/  (mirrors node_modules/@jaguilar87/gaia-ops/ and symlinks into project .claude/)
+├── CLAUDE.md                       # Master orchestrator logic + workflow (≈150 lines here, expanded in config/)
+├── agents/                         # 6 specialized agent prompts
+│   ├── terraform-architect.md
+│   ├── gitops-operator.md
+│   ├── gcp-troubleshooter.md
+│   ├── aws-troubleshooter.md
+│   ├── devops-developer.md
+│   └── claude-architect.md
+├── tools/                          # System intelligence + automation
+│   ├── context_provider.py         # Deterministic context generation
+│   ├── agent_router.py             # Semantic routing (92.7% target accuracy)
+│   ├── clarify_engine.py           # Ambiguity detection
+│   ├── approval_gate.py            # Tiered approval logic
+│   ├── commit_validator.py         # Conventional commits enforcement
+│   └── task_manager.py             # Large-plan chunking
+├── hooks/                          # Git + security hooks
+├── commands/                       # User-facing slash commands (architect/save-session/speckit.*)
+├── config/                         # Documentation bundle (AGENTS/orchestration-workflow/git-standards/context-contracts/agent-catalog)
+├── speckit/                        # Spec-Kit 2.0 framework (README*.md, governance.md, decisions/, templates/, scripts/)
+├── app-services/                   # Sample application services for reference
+├── gitops/                         # Reference GitOps manifests
+├── terraform/                      # Reference Terraform stacks
+├── templates/                      # CLAUDE + code templates
+├── tests/                          # Test suite (55+ cases referenced in README)
+├── CHANGELOG.md                    # Version history (Semantic Versioning)
+└── package.json / index.js         # NPM package metadata + helper exports
 ```
 
+When `npx @jaguilar87/gaia-ops init` (or `gaia-init` after a global install) runs in a consuming project it:
+1. Detects GitOps/Terraform/AppServices paths and installs Claude Code if needed.
+2. Creates `.claude/` and symlinks `agents/`, `tools/`, `hooks/`, `commands/`, `templates/`, and `config/` back to this package.
+3. Generates `CLAUDE.md`, links `AGENTS.md`, and seeds `.claude/project-context.json` (project SSOT). Project-owned items such as `.claude/logs/`, `.claude/tests/`, and session data remain local.
+
+### Installation & Project Layout (from README.md / README.en.md)
+- Quick start: `npx @jaguilar87/gaia-ops init` (or `npm install -g @jaguilar87/gaia-ops && gaia-init`) bootstraps everything; manual installs `npm install @jaguilar87/gaia-ops` + symlink commands from README.
+- Resulting structure: `your-project/.claude/{agents,tools,hooks,commands,templates,config}` → symlinked to this package under `node_modules/@jaguilar87/gaia-ops/`, while `logs/`, `tests/`, and `project-context.json` stay project-specific.
+- Reference directories `gitops/`, `terraform/`, and `app-services/` inside the package illustrate how specialized agents should reason about user IaC/App codebases.
+
+### Spec-Kit 2.0 Workflow Snapshot (from speckit/README*.md)
+- `speckit/` hosts bilingual docs, governance (`speckit/governance.md`), immutable ADRs (`speckit/decisions/ADR-*.md`), templates, and scripts backing `/speckit.*` commands.
+- Core flow: `/speckit.init` → `/speckit.specify` → `/speckit.plan` → `/speckit.tasks` → `/speckit.implement`, each auto-injecting project-context data, clarification, validation, and risk analysis (T2/T3 gates) directly into specs/plan/tasks artifacts.
+- Helper commands: `/speckit.add-task` adds enriched tasks mid-implementation, `/speckit.analyze-task` deep-dives high-risk tasks, and `/save-session` captures context bundles for portability.
+- Spec-Kit 2.0 removes standalone enrichers (`tasks-richer.py`), performs inline validation, and relies on `.claude/project-context.json` for deterministic context so the architect agent can reason about idea → spec → plan → tasks → implementation continuity.
+
 ### Key System Metrics (What to Track)
 
 - **Routing Accuracy:** Target 92.7% (from tests)
@@ -818,4 +826,3 @@ python3 -m pytest .claude/tests/ --cov=.claude/tools --cov-report=term
 ---
 
 **Remember:** You are not just analyzing files - you are understanding a living, evolving system. Your insights drive its continuous improvement.
-

package/bin/gaia-init.js

@@ -603,6 +603,29 @@ async function createClaudeDirectory() {
   }
 }
 
+/**
+ * Generate settings.json from template
+ */
+async function generateSettingsJson() {
+  const spinner = ora('Generating .claude/settings.json...').start();
+
+  try {
+    const settingsPath = join(CWD, '.claude', 'settings.json');
+    const templatePath = getTemplatePath('settings.template.json');
+
+    // Read template
+    const template = await fs.readFile(templatePath, 'utf-8');
+
+    // Write settings.json (no placeholders to replace)
+    await fs.writeFile(settingsPath, template, 'utf-8');
+
+    spinner.succeed('.claude/settings.json generated');
+  } catch (error) {
+    spinner.fail('Failed to generate settings.json');
+    throw error;
+  }
+}
+
 /**
  * Generate CLAUDE.md from template
  */
@@ -739,11 +762,12 @@ async function generateProjectContext(config) {
       cloud_provider: config.cloudProvider
     };
 
+    // Add provider-specific fields (matching contract expectations)
     if (config.gcpProjectId) {
-      projectDetails.project_id = config.gcpProjectId;
+      projectDetails.project_id = config.gcpProjectId;  // GCP contract expects project_id
     }
     if (config.awsAccountId) {
-      projectDetails.aws_account = config.awsAccountId;
+      projectDetails.account_id = config.awsAccountId;  // AWS contract expects account_id
     }
 
     // Build provider_credentials section
@@ -999,6 +1023,9 @@ async function main() {
     // Step 6: Create .claude/ directory with symlinks
     await createClaudeDirectory();
 
+    // Step 6.5: Generate settings.json
+    await generateSettingsJson();
+
     // Step 7: Generate CLAUDE.md
     await generateClaudeMd(config);
 

package/config/context-contracts.aws.json

@@ -0,0 +1,108 @@
+{
+  "$schema": "https://json-schema.org/draft-07/schema#",
+  "version": "2.0.0",
+  "cloud_provider": "aws",
+  "description": "Context contracts for AWS-based projects",
+  "last_updated": "2025-11-10",
+
+  "agents": {
+    "terraform-architect": {
+      "contract_version": "1.0",
+      "required": [
+        "project_details.account_id",
+        "project_details.region",
+        "project_details.environment",
+        "terraform_infrastructure.layout.base_path",
+        "terraform_infrastructure.provider_credentials.aws",
+        "operational_guidelines.commit_standards"
+      ],
+      "optional": [
+        "terraform_infrastructure.layout.modules_path",
+        "terraform_infrastructure.layout.environments_path",
+        "terraform_infrastructure.state.backend_type",
+        "terraform_infrastructure.state.backend_config"
+      ]
+    },
+
+    "gitops-operator": {
+      "contract_version": "1.0",
+      "required": [
+        "project_details.account_id",
+        "project_details.region",
+        "project_details.cluster_name",
+        "gitops_configuration.repository.path",
+        "gitops_configuration.flux_details",
+        "cluster_details.namespaces",
+        "operational_guidelines.commit_standards"
+      ],
+      "optional": [
+        "gitops_configuration.repository.remote_url",
+        "gitops_configuration.repository.branch",
+        "cluster_details.ingress_class",
+        "cluster_details.irsa_enabled",
+        "application_services"
+      ]
+    },
+
+    "aws-troubleshooter": {
+      "contract_version": "1.0",
+      "required": [
+        "project_details.account_id",
+        "project_details.region",
+        "terraform_infrastructure.layout.base_path",
+        "gitops_configuration.repository.path"
+      ],
+      "optional": [
+        "project_details.cluster_name",
+        "application_services",
+        "infrastructure_topology"
+      ]
+    },
+
+    "devops-developer": {
+      "contract_version": "1.0",
+      "required": [
+        "project_details.account_id",
+        "project_details.environment",
+        "operational_guidelines.commit_standards"
+      ],
+      "optional": [
+        "application_services",
+        "development_standards"
+      ]
+    }
+  },
+
+  "field_mappings": {
+    "project_details.account_id": {
+      "description": "AWS Account ID",
+      "example": "123456789012",
+      "type": "string",
+      "source": "metadata.aws_account or sections.project_details.aws_account"
+    },
+    "project_details.region": {
+      "description": "Primary AWS region",
+      "example": "us-east-1",
+      "type": "string"
+    },
+    "project_details.cluster_name": {
+      "description": "EKS cluster name",
+      "example": "non-prod-rnd-eks",
+      "type": "string"
+    },
+    "terraform_infrastructure.provider_credentials.aws": {
+      "description": "AWS authentication configuration",
+      "type": "object",
+      "fields": {
+        "account_id": "AWS account ID",
+        "region": "Default region",
+        "profile": "AWS CLI profile name (optional)"
+      }
+    },
+    "cluster_details.irsa_enabled": {
+      "description": "Whether EKS IAM Roles for Service Accounts (IRSA) is enabled",
+      "type": "boolean",
+      "default": true
+    }
+  }
+}

package/config/context-contracts.gcp.json

@@ -0,0 +1,108 @@
+{
+  "$schema": "https://json-schema.org/draft-07/schema#",
+  "version": "2.0.0",
+  "cloud_provider": "gcp",
+  "description": "Context contracts for GCP-based projects",
+  "last_updated": "2025-11-10",
+
+  "agents": {
+    "terraform-architect": {
+      "contract_version": "1.0",
+      "required": [
+        "project_details.project_id",
+        "project_details.region",
+        "project_details.environment",
+        "terraform_infrastructure.layout.base_path",
+        "terraform_infrastructure.provider_credentials.gcp",
+        "operational_guidelines.commit_standards"
+      ],
+      "optional": [
+        "terraform_infrastructure.layout.modules_path",
+        "terraform_infrastructure.layout.environments_path",
+        "terraform_infrastructure.state.backend_type",
+        "terraform_infrastructure.state.backend_config"
+      ]
+    },
+
+    "gitops-operator": {
+      "contract_version": "1.0",
+      "required": [
+        "project_details.project_id",
+        "project_details.region",
+        "project_details.cluster_name",
+        "gitops_configuration.repository.path",
+        "gitops_configuration.flux_details",
+        "cluster_details.namespaces",
+        "operational_guidelines.commit_standards"
+      ],
+      "optional": [
+        "gitops_configuration.repository.remote_url",
+        "gitops_configuration.repository.branch",
+        "cluster_details.ingress_class",
+        "cluster_details.workload_identity_enabled",
+        "application_services"
+      ]
+    },
+
+    "gcp-troubleshooter": {
+      "contract_version": "1.0",
+      "required": [
+        "project_details.project_id",
+        "project_details.region",
+        "terraform_infrastructure.layout.base_path",
+        "gitops_configuration.repository.path"
+      ],
+      "optional": [
+        "project_details.cluster_name",
+        "application_services",
+        "infrastructure_topology"
+      ]
+    },
+
+    "devops-developer": {
+      "contract_version": "1.0",
+      "required": [
+        "project_details.project_id",
+        "project_details.environment",
+        "operational_guidelines.commit_standards"
+      ],
+      "optional": [
+        "application_services",
+        "development_standards"
+      ]
+    }
+  },
+
+  "field_mappings": {
+    "project_details.project_id": {
+      "description": "GCP Project ID",
+      "example": "aaxis-rnd-non-prod",
+      "type": "string",
+      "source": "metadata.project_id or sections.project_details.project_id"
+    },
+    "project_details.region": {
+      "description": "Primary GCP region",
+      "example": "us-central1",
+      "type": "string"
+    },
+    "project_details.cluster_name": {
+      "description": "GKE cluster name",
+      "example": "non-prod-rnd-gke",
+      "type": "string"
+    },
+    "terraform_infrastructure.provider_credentials.gcp": {
+      "description": "GCP authentication configuration",
+      "type": "object",
+      "fields": {
+        "project": "GCP project ID",
+        "region": "Default region",
+        "credentials_path": "Path to service account JSON (optional)"
+      }
+    },
+    "cluster_details.workload_identity_enabled": {
+      "description": "Whether GKE Workload Identity is enabled",
+      "type": "boolean",
+      "default": true
+    }
+  }
+}

package/config/context-contracts.md

@@ -1,7 +1,7 @@
 # Context Contracts
 
-**Version:** 2.0.0
-**Last Updated:** 2025-11-07
+**Version:** 2.1.0
+**Last Updated:** 2025-11-10
 **Parent:** CLAUDE.md
 
 This document defines the **Context Contracts** for each specialized agent. A context contract specifies the minimum structured data that MUST be provided when invoking an agent.
@@ -28,6 +28,56 @@ A context contract is a schema that defines:
 
 ---
 
+## Provider-Specific Contracts (NEW in v2.1.0)
+
+**As of v2.1.0, contracts are defined per cloud provider:**
+
+```
+.claude/config/
+├── context-contracts.gcp.json      # GCP-specific contracts
+├── context-contracts.aws.json      # AWS-specific contracts
+└── context-contracts.azure.json    # Azure-specific contracts (future)
+```
+
+### How It Works
+
+1. **context_provider.py detects the cloud provider:**
+   - Reads `metadata.cloud_provider` from project-context.json
+   - Falls back to inferring from field presence (`project_id` → GCP, `account_id` → AWS)
+   - Defaults to GCP if undetected
+
+2. **Loads the correct contract file:**
+   - GCP projects → `context-contracts.gcp.json`
+   - AWS projects → `context-contracts.aws.json`
+   - Azure projects → `context-contracts.azure.json`
+
+3. **Validates against provider-specific requirements:**
+   - GCP contracts expect `project_details.project_id`
+   - AWS contracts expect `project_details.account_id`
+   - All other fields remain provider-agnostic
+
+### Benefits of Provider-Specific Contracts
+
+✅ **Clarity:** Field names match cloud provider terminology
+✅ **Simplicity:** No complex conditional validation logic
+✅ **Extensibility:** Adding Azure = create `context-contracts.azure.json` (15 minutes)
+✅ **Agents stay agnostic:** Agents use pattern discovery, don't care about provider
+✅ **Single source of truth:** Orchestrator selects the right contract
+
+### Example
+
+```python
+# context_provider.py automatically handles this:
+
+cloud_provider = detect_cloud_provider(project_context)  # → "gcp"
+contracts = load_provider_contracts(cloud_provider)      # → loads context-contracts.gcp.json
+payload = get_contract_context(project_context, "terraform-architect", contracts)
+```
+
+**Result:** Orchestrator validates GCP-specific fields, agents receive clean payload.
+
+---
+
 ## Contract Format
 
 Each contract section below follows this structure:

package/index.js

@@ -1,12 +1,13 @@
 /**
- * @aaxis/claude-agents
+ * @jaguilar87/gaia-ops
  *
- * Shared Claude Code agent system for Aaxis DevOps workflows
+ * Multi-agent orchestration system for Claude Code - DevOps automation toolkit
  *
  * Usage:
- *   import { getAgentPath, getToolPath } from '@aaxis/claude-agents';
+ *   import { getAgentPath, getToolPath, getConfigPath } from '@jaguilar87/gaia-ops';
  *   const agentPath = getAgentPath('gitops-operator');
  *   const toolPath = getToolPath('context_provider.py');
+ *   const configPath = getConfigPath('orchestration-workflow.md');
  */
 
 import { fileURLToPath } from 'url';