# Concepts

> Deep explanations of StackQL design decisions, best practices, and the reasoning behind the architecture.

Source: https://stackql.io/ai/concepts

Pages here explain *why* StackQL works the way it does, and what good usage patterns look like. Combines what would elsewhere be called best practices and conceptual deep-dives.

## Pages

- [Why State Files Break Down for AI Agents](/ai/concepts/why-state-files-break-down-for-ai-agents) - the assumptions agents violate
- [Why SQL is a Strong Interface for Cloud APIs](/ai/concepts/why-sql-is-a-strong-interface-for-cloud-apis) - the design rationale for the SQL surface