# Adaptive Enforcement Lab Claude Skills Go CLI Architecture > Go CLI Architecture - Skill: `tomevault-io/adaptive-enforcement-lab-claude-skills-go-cli-architecture` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/adaptive-enforcement-lab-claude-skills-go-cli-architecture` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/adaptive-enforcement-lab-claude-skills-go-cli-architecture/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/adaptive-enforcement-lab-claude-skills-go-cli-architecture --- # Go CLI Architecture ## When to Use This Skill > **Go vs Shell Scripts** > > > Start with shell scripts for prototyping. Graduate to Go when you need type safety, testability, or complex orchestration logic. > **Use Go when you need:** - Direct Kubernetes API access with type-safe clients - Complex orchestration logic across multiple resources - Reusable tooling packaged as container images - Performance-critical operations (milliseconds matter) - Long-running controllers or operators **Use shell scripts when you need:** - Simple glue logic between existing tools - Quick prototypes or one-off operations - kubectl-based workflows without custom logic - CI/CD steps that primarily call other CLIs --- ## Implementation See the full implementation guide in the [source documentation](https://adaptive-enforcement-lab.com/build/go-cli-architecture/). ## Key Principles | Principle | Description | | ----------- | ------------- | | **[Separation of concerns](../../patterns/architecture/separation-of-concerns/index.md)** | Commands handle CLI logic; `pkg/` handles business logic | | **[Testable by default](testing/index.md)** | Interfaces for external dependencies enable fake clients | | **[Fail fast](../../patterns/error-handling/fail-fast/index.md)** | Validate configuration and connectivity before operations | | **[Structured output](command-architecture/io-contracts.md)** | JSON output for machine consumption, human-friendly by default | | **[Graceful degradation](../../patterns/error-handling/graceful-degradation/index.md)** | Clear error messages with actionable context | --- *Building CLIs that operators trust.* ## Examples See [examples.md](examples.md) for code examples. ## References - [Source Documentation](https://adaptive-enforcement-lab.com/build/go-cli-architecture/) - [AEL Build](https://adaptive-enforcement-lab.com/build/) --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/adaptive-enforcement-lab) — claim your Tome and manage your conversions.