Skip to main content

Tutorials

Learning-oriented guides for newcomers

Available Guides​

This section contains tutorials documentation following the Diataxis framework.

Tutorials are learning-oriented and help newcomers get started:

  • Take the reader through a process step by step
  • Focus on learning by doing
  • Ensure the reader succeeds in accomplishing something
  • Build confidence through success

🔍 Research-Driven Architecture​

All tutorials now feature research-driven workflows that query your live environment instead of relying on static analysis alone:

  • Cascading Source Hierarchy: Project Files → Knowledge Graph → Environment Resources → Web Search
  • Confidence Scoring: Every result includes a 0-1 confidence score
  • Live Infrastructure Detection: Automatically discovers Docker, Kubernetes, OpenShift, Podman, Ansible
  • Red Hat Ecosystem Support: First-class support for OpenShift (oc), Podman, and Ansible
  • ADR Validation: Check if documented decisions match actual implementation

Key Research-Driven Tools​

  • perform_research: Ask questions about your project and get confidence-scored answers
  • validate_adr: Validate a single ADR against live infrastructure
  • validate_all_adrs: Batch validate all ADRs with environment checks
  • analyze_deployment_progress: Research-enhanced deployment readiness analysis
  • generate_deployment_guidance: Infrastructure-aware deployment recommendations

Contents​

Getting Started​

Specialized Workflows​

Example ADRs​