agentleFS
terrene-foundationterrene-foundation/pact/.claude/skills/06-cheatsheets/SKILL.md

cheatsheets

Skill0 starsChanged 8 months agoApache-2.0View on GitHub

Quick reference cheatsheets for Kailash SDK patterns, nodes, workflows, and best practices. 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'.

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this skill when you need:

    line 137

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Kailash Patterns - Quick Reference Cheatsheets

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

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

RuleWhy
❌ NEVER use raw SQLUse DataFlow instead
✅ ALWAYS call .build()Before runtime.execute()
❌ NEVER use relative importsUse absolute imports
❌ NEVER mock in Tier 2-3Use real infrastructure

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
  • 07-development-guides - Detailed development guides
  • 08-nodes-reference - Node reference documentation
  • 09-workflow-patterns - Industry workflow patterns
  • 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

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.