Leeks

A PaaS platform for managing Kubernetes clusters and applications.

Overview

Leeks provides a streamlined 3-step workflow for deploying and managing Kubernetes infrastructure:

1. OpenTofu/Terraform - Cloud provider setup and infrastructure provisioning
2. k3s - Lightweight Kubernetes cluster setup on nodes
3. Flux - GitOps bootstrap and application deployment

Central Configuration

The k8s.yaml file serves as the central artifact defining all cluster components. Code generation for OpenTofu (Step 1) and Flux (Step 3) is driven by this configuration.

Project Structure

leeks/
├── docs/
│   └── k8s/
│       ├── opentofu/    # Infrastructure decisions and logs
│       ├── k3s/         # Cluster setup decisions and logs
│       └── flux/        # GitOps/deployment decisions and logs
├── CLAUDE.md            # AI assistant memory protocols
├── AGENTS.md            # Cross-tool AI compatibility
└── README.md            # This file

Documentation

• CLAUDE.md - Memory system and protocols for AI assistants
• AGENTS.md - Instructions for various AI coding tools

Domain Documentation

Each domain directory contains:

• decisions.md - Architectural Decision Records (ADRs)
• bugs.md - Bug log with root causes and solutions
• key_facts.md - Reference configurations and conventions
• issues.md - Work log with ticket tracking