Skip to content

Instantly share code, notes, and snippets.

@turlockmike

turlockmike/migration-plan-gist.md

Last active June 20, 2025 20:41
Show Gist options
  • Save turlockmike/334e7a56710cb89d0ad44d20468e53e8 to your computer and use it in GitHub Desktop.
Save turlockmike/334e7a56710cb89d0ad44d20468e53e8 to your computer and use it in GitHub Desktop.
Download ZIP
Extend CLI Agent Migration Plan - Executive Summary
Raw
migration-plan-gist.md

Extend CLI Agent Migration Plan - Detailed Command Mapping

🎯 Goal

Migrate all Extend CLI commands to agent-based interfaces. Complete command-by-command breakdown below.

📊 Coverage Summary

  • Original Commands: ~95 total
  • Removed/Deprecated: 31 commands
  • Migrating to Agents: 64 commands
  • Agent Coverage: 100% ✅

🏗️ Agent Architecture: 14 Total Agents

ExtendAgent (Primary Orchestration Hub)

  • Role: THE main agent users interact with
  • Purpose: Coordinates all other agents, unified interface
  • Commands: Meta-operations (routing, orchestration, monitoring)

📋 Detailed Command Mapping

1. AtlassianAgent ✅ (Complete - No Changes)

Commands: Jira and Confluence operations via MCP

  • All Jira/Confluence functionality through existing MCP integration

2. AwsAgent ⚠️ (Enhanced - Resource Management + CodeArtifact)

Current Commands: CloudFormation, CloudWatch, CodePipeline, DynamoDB, Lambda, S3 (read-only)

Commands to Add (6):

  • aws pipelines list - List CodePipeline pipelines
  • aws pipelines outdated - Check for outdated pipelines
  • aws pipelines transitions - View pipeline stage transitions
  • aws quotas - View AWS service quotas
  • yarn package copy - Copy packages between registries (via CodeArtifact)
  • yarn package versions - View package version information (via CodeArtifact)

3. CoralogixAgent ✅ (Complete - No Changes)

Commands: Log and trace queries

  • All observability operations through existing tools

4. DocsAgent ✅ (Complete - No Changes)

Commands: Documentation generation

  • All documentation operations through existing tools

5. GitHubAgent ⚠️ (Major Enhancement - Full MCP Integration)

Commands to Add (9):

  • gh repos list - List repositories
  • gh repos view - View repository details
  • gh packages stats - Package statistics
  • gh files stats - File statistics
  • gh search - Search GitHub repositories/code/issues
  • gh topics - Manage repository topics
  • repo add - Add repository to local tracking
  • repo code - Open repository in code editor
  • repo delete - Delete repository reference

6. SnowflakeAgent ✅ (Complete - No Changes)

Commands: Data warehouse operations

  • All Snowflake operations through existing tools

New Agents (8)

7. DeveloperAuthAgent 🔴 (High Priority - 8 Commands)

Active Commands (8):

  • aws assume - Assume AWS IAM role
  • aws code-artifact login - Authenticate with AWS CodeArtifact
  • aws iic console - Open IIC console
  • aws iic login - Login to AWS IIC
  • aws iic logout - Logout from AWS IIC
  • aws iic request - Make IIC access request
  • aws iic groups list - List available IIC groups
  • pip login - Authenticate with pip repositories (analytics)

8. DeploymentAgent 🔴 (High Priority - 7 Commands)

Commands (7):

  • service approve - Approve service deployment
  • service deploy status - Check deployment status
  • service deploy rollback-pipeline - Rollback entire pipeline
  • service deploy rollback-stage - Rollback specific deployment stage
  • service deploy-sandbox - Deploy service to sandbox environment
  • service direct-deploy - Perform direct deployment bypassing pipeline
  • protokit deploy - Deploy using Protokit framework

9. FeatureFlagsAgent 🟡 (Medium Priority - LaunchDarkly MCP)

Commands (1 + MCP tools):

  • featureflags get - Retrieve feature flag values
  • Plus LaunchDarkly MCP Tools:
    • list-feature-flags, create-feature-flag, get-feature-flag
    • update-feature-flag, delete-feature-flag

10. KafkaAgent 🟡 (Medium Priority - 3 Commands)

Commands (3):

  • admin find-kafka-consumer - Locate Kafka consumers
  • admin kafka-consumer-state-change - Modify consumer state
  • admin kafka-set-offset - Set consumer group offsets

11. ProductAdminAgent 🟡 (Medium Priority - 2 Commands)

Commands (2):

  • admin lambda-change-log-level - Modify Lambda function log levels
  • admin shopify-trigger-token-refresh - Trigger Shopify API token refresh

12. DevelopmentToolsAgent 🟡 (Medium Priority - 5 Commands)

Commands (5):

  • branch - Git branch management and operations
  • pr - Pull request creation and management
  • start - Initialize development environment
  • update - Update CLI (external command only)
  • utilities generate-secret - Generate cryptographic secrets

13. EnvironmentBrokerAgent 🟡 (Medium Priority - 5 Commands)

Commands (5):

  • environmentbroker environments create - Create new environment
  • environmentbroker environments list - List available environments
  • environmentbroker environments update - Update environment configuration
  • environmentbroker jobs list - List environment jobs
  • environmentbroker jobs cancel - Cancel running environment job

14. [Removed] PackageManagementAgent

Status: Eliminated - commands moved to AwsAgent via CodeArtifact integration

🚫 Commands Removed from Migration (31 Total)

Not Supported (3 commands):

  • calendar events - Calendar integration
  • calendar reset - Calendar operations
  • gmail emails - Email operations

Not Prioritized - Local Development (10 commands):

  • local mock - Local development mocking
  • local dynamodb database start - Start local DynamoDB
  • local dynamodb database stop - Stop local DynamoDB
  • local dynamodb database restart - Restart local DynamoDB
  • local dynamodb database console - Open local DynamoDB console
  • local dynamodb table create - Create local table
  • local dynamodb table delete - Delete local table
  • local dynamodb table reset - Reset local table
  • local dynamodb table backup - Backup local table
  • local dynamodb table restore - Restore local table

Removed Completely (2 commands):

  • pre-commit-checks - Pre-commit validation (no longer needed)
  • build - Build operations (external to EC now)

Deprecated Authentication (6 commands):

  • aws creds init - Legacy credential initialization
  • aws creds login - Legacy credential login
  • aws creds assume - Legacy role assumption
  • aws creds clear - Legacy credential clearing
  • okta login - Okta authentication
  • yarn login - Yarn registry authentication

Agent-Handled (10 commands):

  • config list - Configuration listing (handled by individual agents)
  • config set - Configuration setting (handled by individual agents)
  • config user update - User configuration (handled by auth agent)
  • actionflags create - Action flags (handled by individual agents)
  • actionflags get - Action flags (handled by individual agents)
  • actionflags delete - Action flags (handled by individual agents)
  • ai jsdocs - AI operations (part of regular agent functionality)
  • agent - Agent management (handled by ExtendAgent)
  • mcp - MCP operations (handled by ExtendAgent)
  • prompts - Prompt management (handled by ExtendAgent)

🔧 Key Technical Integrations

LaunchDarkly MCP Server

  • Integration: FeatureFlagsAgent uses LaunchDarkly MCP Server
  • Setup: Requires LaunchDarkly API token with Writer/Developer permissions
  • Tools: Full CRUD operations for feature flags

GitHub MCP Server

  • Integration: GitHubAgent uses GitHub MCP Server
  • Tools: 50+ GitHub operations (repos, issues, PRs, workflows, security)

✅ Implementation Checklist

Phase 1: Core Infrastructure

  • ExtendAgent - Primary orchestration agent
  • DeveloperAuthAgent - 8 authentication commands
  • DeploymentAgent - 7 deployment commands

Phase 2: Enhanced Existing

  • GitHubAgent Enhancement - Add 9 GitHub/repo commands
  • AwsAgent Enhancement - Add 6 pipeline/package commands

Phase 3: Specialized Agents

  • FeatureFlagsAgent - LaunchDarkly MCP integration
  • KafkaAgent - 3 Kafka commands
  • ProductAdminAgent - 2 admin commands
  • DevelopmentToolsAgent - 5 development commands
  • EnvironmentBrokerAgent - 5 environment commands

📊 Final Command Count Summary

Agent Category Commands Percentage
Existing Agents (Enhanced) 15 commands 23.4%
New Agents 49 commands 76.6%
Total Migrating 64 commands 100%
Removed/Deprecated 31 commands -

🎯 Success Criteria

  • ✅ 100% Coverage of active/relevant commands
  • ✅ ExtendAgent as primary user interface
  • ✅ MCP Integration for enterprise services
  • ✅ Clean Architecture with proper domain separation
  • ✅ Deprecated Command Cleanup removing legacy auth

Repository: extend-cli
Architecture: 14 agents (6 existing + 8 new)
Primary Agent: ExtendAgent (orchestration hub)
Command Coverage: 64/64 active commands (100%)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment