cheatsheets - SKILL.md Agent Skill

name: cheatsheets description: "Kailash cheatsheets — patterns, nodes, workflows, cycles, perf, security, saga."

Kailash Patterns - Quick Reference Cheatsheets

Comprehensive collection of quick reference guides, common patterns, and best practices for Kailash SDK development.

When to Use

Use when asking about quick tips, cheat sheet, quick reference, common mistakes, node selection, workflow patterns library, cycle patterns, production patterns, performance optimization, monitoring, security config, multi-tenancy, distributed transactions, saga pattern, custom nodes, PythonCode data science, ollama integration, directoryreader patterns, or environment variables.

Overview

This skill provides quick access to:

Common workflow patterns and anti-patterns
Node selection and usage guides
Production-ready patterns
Performance and optimization tips
Security and enterprise patterns
Integration cheatsheets

Quick Reference Guides

Essential Guides

kailash-quick-tips - Essential tips for Kailash development
common-mistakes-catalog - Common pitfalls and solutions
node-selection-guide - Choosing the right nodes
workflow-patterns-library - Comprehensive pattern library
README - Cheatsheets overview

Node References

admin-nodes-reference - Admin and management nodes
asyncsql-advanced - AsyncSQL node patterns
pythoncode-data-science - Data science with PythonCode
directoryreader-patterns - File system patterns
ollama-integration - Local LLM integration
query-builder - Query construction patterns
query-routing - Intelligent query routing

Cyclic Workflow Patterns

cyclic-patterns-advanced - Advanced cyclic patterns
cycle-aware-nodes - Cycle-aware node development
cycle-debugging - Debugging cyclic workflows
cycle-testing - Testing cyclic workflows
cycle-state-persistence - State management in cycles
cycle-scenarios - Real-world cycle scenarios
multi-path-cycles - Multi-path cyclic patterns

Production & Enterprise

production-patterns - Production-ready patterns
production-readiness - Production checklist
performance-optimization - Performance tuning
monitoring-alerting - Monitoring and alerting
resilience-patterns - Resilience and fault tolerance
security-config - Security configuration
multi-tenancy-patterns - Multi-tenant architectures

Enterprise Patterns

distributed-transactions - Distributed transaction patterns
saga-pattern - Saga pattern for long transactions
enterprise-mcp - Enterprise MCP patterns
a2a-coordination - Agent-to-agent coordination
mcp-resource-subscriptions - MCP resource patterns

Development Tools

custom-node-guide - Creating custom nodes
developer-tools - Developer tooling
node-initialization - Node initialization patterns
env-variables - Environment variable management
validation-testing - Validation and testing patterns
visualization - Workflow visualization

Workflow Management

workflow-composition - Composing complex workflows
workflow-design-process - Design process guide
workflow-api-deployment - Deploying workflows as APIs
workflow-export - Export and import patterns

Integration Patterns

data-integration - Data integration patterns
integration-mastery - Advanced integration techniques

Quick Patterns

Basic Workflow

from kailash.workflow.builder import WorkflowBuilder
from kailash.runtime import LocalRuntime

workflow = WorkflowBuilder()
workflow.add_node("NodeType", "node_id", {"param": "value"})
runtime = LocalRuntime()
results, run_id = runtime.execute(workflow.build())

Common Node Selection

# Data processing
workflow.add_node("PythonCode", "transform", {"code": "..."})

# API calls
workflow.add_node("HTTPRequest", "api", {"url": "...", "method": "GET"})

# AI/LLM
workflow.add_node("LLMNode", "chat", {"model": os.environ["LLM_MODEL"], "prompt": "..."})

Cyclic Pattern

workflow.add_node("LoopNode", "loop", {"max_iterations": 5})
workflow.add_node("ProcessNode", "process", {})
workflow.add_connection("loop", "item", "process", "input")
workflow.add_connection("process", "output", "loop", "feedback")

CRITICAL Gotchas

Rule	Why
❌ NEVER use raw SQL	Use DataFlow instead
✅ ALWAYS call `.build()`	Before `runtime.execute()`
❌ NEVER use relative imports	Use absolute imports
❌ NEVER mock in Tier 2-3	Use real infrastructure
❌ NEVER train sklearn/torch directly	Use `km.train(...)` (skill 34-kailash-ml)
✅ Cap parallel worktrees at 3 concurrent Opus agents	Beyond 3, budget exhaustion & merge conflicts dominate

When to Use This Skill

Use this skill when you need:

Quick reference for common patterns
Solution to a specific problem
Best practices for production
Node selection guidance
Performance optimization tips
Security configuration help
Multi-tenancy patterns
Cyclic workflow help

Related Skills

01-core-sdk - Core SDK fundamentals
08-nodes-reference - Node reference documentation
17-gold-standards - Mandatory best practices

Support

For cheatsheet-related questions, invoke:

pattern-expert - Pattern selection and usage
decide-framework skill - Choose appropriate patterns for your use case