/context-load-talos

allowed-tools: Read, WebFetch, Bash(fd:*), Bash(rg:*), Bash(kubectl:*), Bash(talosctl:*), Bash(jq:*), Bash(gdate:*)
name: "Context Load Talos"
description: "Load comprehensive Talos Linux Kubernetes documentation with environment-specific optimization"
author: "wcygan"
tags: ["context","k8s"]
version: "1.0.0"
created_at: "2025-07-14T00:00:00Z"
updated_at: "2025-07-14T00:00:00Z"

Context

• Session ID: !`gdate +%s%N`
• Current directory: !`pwd`
• Kubernetes configs: !`fd "(kubeconfig|config)" ~/.kube /etc/kubernetes . | head -3 || echo "No K8s configs found"`
• Talos configs: !`fd "talosconfig" ~ . | head -3 || echo "No Talos configs found"`
• Container runtimes: !`which docker podman containerd 2>/dev/null || echo "No container runtimes detected"`
• Kubernetes tools: !`which kubectl talosctl helm flux 2>/dev/null || echo "No K8s tools detected"`
• Infrastructure files: !`fd "(terraform|pulumi|ansible)" . -t d | head -3 || echo "No IaC detected"`
• Cluster info: !`kubectl cluster-info 2>/dev/null | head -2 || echo "No active K8s cluster"`
• Talos nodes: !`talosctl config info 2>/dev/null || echo "No Talos config found"`
• GitOps configs: !`fd "(flux|argocd|gitops)" . -t d | head -3 || echo "No GitOps configs found"`

Your Task

STEP 1: Initialize context loading session

• CREATE session state file: `/tmp/talos-context-$SESSION_ID.json`
• SET initial state:

  {
    "sessionId": "$SESSION_ID",
    "phase": "discovery",
    "environment_type": "unknown",
    "context_sources": [],
    "loaded_topics": [],
    "talos_features_detected": [],
    "documentation_cache": {}
  }

• ANALYZE current environment from Context section
• DETERMINE Talos deployment scenario and context priorities

STEP 2: Environment-specific context strategy

Think deeply about optimal Talos documentation loading strategies based on detected environment and infrastructure patterns.

IF Talos cluster detected:

• FOCUS on operational management, troubleshooting, and upgrade procedures
• PRIORITIZE cluster maintenance, monitoring, and GitOps integration
• INCLUDE disaster recovery and backup strategies

ELSE IF Kubernetes cluster detected (non-Talos):

• FOCUS on Talos migration strategies and compatibility assessment
• PRIORITIZE comparison guides and migration procedures
• INCLUDE cluster replacement and transition planning

ELSE:

• LOAD comprehensive getting-started and installation documentation
• EMPHASIZE initial setup, configuration, and cluster bootstrap
• INCLUDE hardware requirements and deployment planning

STEP 3: Strategic documentation loading with parallel sub-agents

Use parallel sub-agents for comprehensive context loading:

• **Agent 1**: Core Talos fundamentals and installation procedures
• **Agent 2**: Configuration management and machine setup
• **Agent 3**: Networking, security, and cluster operations
• **Agent 4**: Upgrades, maintenance, and troubleshooting
• **Agent 5**: GitOps integration and automation patterns

TRY:

• EXECUTE systematic context loading from prioritized sources
• USE WebFetch tool for each documentation URL
• PROCESS and organize information by functional area
• SAVE loaded context to session state

**Core Documentation Sources:**

FOR EACH priority source:

1. **Talos Core Documentation**

• URL: `https://www.talos.dev/latest/`
• FETCH: Architecture overview, getting started, core concepts
• FOCUS: Installation methods, cluster bootstrap, basic operations
• EXTRACT: Best practices and deployment patterns

2. **Machine Configuration Reference**

• URL: `https://www.talos.dev/latest/reference/configuration/`
• FETCH: Complete configuration schema and options
• FOCUS: Network configuration, storage setup, security policies
• EXTRACT: Configuration examples and validation patterns

3. **Talos API Reference**

• URL: `https://www.talos.dev/latest/reference/api/`
• FETCH: Machine API, cluster API, service management interfaces
• FOCUS: API operations, automation capabilities, integration patterns
• EXTRACT: API usage examples and authentication methods

4. **Guides and Tutorials**

• URL: `https://www.talos.dev/latest/talos-guides/`
• FETCH: Deployment scenarios, use cases, integration guides
• FOCUS: Cloud provider setup, bare metal deployment, troubleshooting
• EXTRACT: Step-by-step procedures and configuration examples

5. **Upgrade and Maintenance Guide**

• URL: `https://www.talos.dev/latest/talos-guides/upgrading-talos/`
• FETCH: Upgrade procedures, rollback strategies, maintenance tasks
• FOCUS: Version compatibility, upgrade planning, disaster recovery
• EXTRACT: Upgrade automation and validation procedures

6. **Kubernetes Integration**

• URL: `https://www.talos.dev/latest/kubernetes-guides/`
• FETCH: Kubernetes-specific configuration and integration patterns
• FOCUS: CNI setup, storage classes, ingress controllers
• EXTRACT: Kubernetes workload deployment and management

CATCH (documentation_fetch_failed):

• LOG failed sources to session state
• CONTINUE with available documentation
• PROVIDE manual context loading instructions
• SAVE fallback documentation references

STEP 4: Context organization and environment optimization

• ORGANIZE loaded context by functional area:
• Installation and machine configuration
• Cluster bootstrap and networking setup
• Security policies and certificate management
• Storage configuration and persistent volumes
• Cluster operations and maintenance
• Upgrade procedures and rollback strategies
• Troubleshooting and debugging techniques
• GitOps integration and automation
• Monitoring and observability
• Disaster recovery and backup

• SYNTHESIZE environment-specific guidance:
• Integration with detected infrastructure tools
• Migration strategies from existing Kubernetes distributions
• Best practices for detected deployment scenario
• Security hardening for specific environment type

STEP 5: Advanced context loading