architecture-decisions

Guide Kailash framework, runtime, database, node, and test tier selection.

1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/terrene-foundation/kailash-coc-claude-rs --skill architecture-decisions-terrene-foundation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-decisions
Source: https://github.com/terrene-foundation/kailash-coc-claude-rs/tree/main/.claude/skills/13-architecture-decisions
Command: npx skills add https://github.com/terrene-foundation/kailash-coc-claude-rs --skill architecture-decisions-terrene-foundation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you navigate the complex choices involved in selecting the right frameworks, runtimes, databases, and testing strategies for your Kailash projects, ensuring optimal performance and maintainability.

Core Features & Use Cases

  • Framework Selection: Guides you between Core SDK, DataFlow, Nexus, and Kaizen based on your project's needs.
  • Runtime & Database Choice: Helps decide between PostgreSQL/SQLite and sync/async runtimes.
  • Node & Test Tier Selection: Recommends the best nodes for tasks and appropriate testing levels.
  • Use Case: When starting a new project, you can ask this Skill to recommend the best framework and database based on whether you're building a data-intensive application or an AI agent system.

Quick Start

Use the architecture-decisions skill to decide which framework to use for a new project.

Frequently Asked Questions about architecture-decisions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose the right Kailash framework for my application?

To choose the right Kailash framework, evaluate whether your project requires Core SDK, DataFlow, Nexus, or Kaizen based on if you are building a data-intensive application or an AI agent system. This decision framework matches your specific project needs to the appropriate architecture.

What is the best way to select a database for a Kailash project?

The best way to select a database for a Kailash project is to compare PostgreSQL and SQLite based on your application's data intensity and scale. Architecture guidance recommends matching the database choice to your specific runtime and performance requirements.

When should I use sync versus async runtimes in Kailash?

You should choose between sync and async runtimes in Kailash based on your application's concurrency and performance needs. Architecture decisions for runtime selection ensure optimal efficiency by matching the execution model to your workload.

How do I structure a testing strategy for Kailash applications?

To structure a testing strategy for Kailash applications, implement appropriate test tiers including unit, integration, and E2E tests. Selecting the correct testing strategy ensures robust application development and maintainability across your chosen nodes.

Which Kailash nodes should I use for specific data and AI tasks?

Selecting Kailash nodes for specific tasks involves matching node capabilities to your data processing or AI agent requirements. The architecture guidance recommends the best nodes based on your chosen framework and overall application architecture.

Does Kailash architecture support both data-intensive apps and AI agent systems?

Kailash architecture supports both data-intensive applications and AI agent systems by offering tailored frameworks like DataFlow and Nexus. You can ask for framework recommendations to ensure optimal performance for either project type.