agno-project-architecture-solid

Defines layered folder structure and SOLID principles for Agno agent projects deployed serverless on AWS.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/allankltsn/setup_kiro --skill agno-project-architecture-solid-allankltsn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agno-project-architecture-solid
Source: https://github.com/allankltsn/setup_kiro/tree/main/.kiro/skills/agno-project-architecture-solid
Command: npx skills add https://github.com/allankltsn/setup_kiro --skill agno-project-architecture-solid-allankltsn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agno agent projects often grow into tangled code where business logic, LLM calls, and infrastructure are mixed together, making refactoring painful and testing impossible. This Skill provides a standardized layered architecture (domain, application, infrastructure, interface) with SOLID principles so your agent code stays decoupled, testable, and easy to evolve. ## Core Features & Use Cases - Standard Folder Structure: A ports-and-adapters layout with domain/, application/, infrastructure/, interface/, and a single composition_root.py for dependency injection. - SOLID Guidance with Examples: Concrete Python examples for each principle (SRP, OCP, LSP, ISP, DIP) applied to Agno agents, including how to swap LLM providers or databases via adapters. - Serverless Development Workflow: A productive dev cycle for Lambda + API Gateway + Layers + AWS SAM, covering sam local testing, layer management, and per-environment deploys. - Use Case: When starting a new Agno agent project or refactoring a script that mixes parsing, LLM calls, and persistence, apply this structure so the domain logic runs testable without network or database access. ## Quick Start Ask the AI to scaffold a new Agno agent project using the layered architecture with domain, application, infrastructure, and interface folders plus a composition root.

Frequently Asked Questions about agno-project-architecture-solid

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

FAQPage Schema
How do I structure an Agno agent project in Python?▼

Use a layered layout with domain (pure business rules), application (use cases), infrastructure (Agno, database, secrets adapters), and interface (CLI, Lambda handlers). Wire concrete implementations together only in a composition_root.py that injects dependencies into use cases.

How do I apply SOLID principles to an AI agent codebase?▼

Wrap the Agno Agent in an adapter implementing a domain-defined port, keep each class to one responsibility, and inject abstractions into use cases. Swapping providers like OpenAI for Groq then means adding a new adapter without touching business logic.

How do I deploy an Agno agent to AWS Lambda with SAM?▼

Keep the Lambda handler thin in interface/http, put heavy libraries like agno in a Lambda Layer, and define infrastructure in template.yaml. Validate locally with sam local invoke or sam local start-api before running sam deploy.

Can I test Agno agent business logic without calling an LLM?▼

Yes. Domain and application layers depend only on port interfaces, so you mock those ports in pytest and test use cases without network, database, or LLM calls. Only infrastructure adapters require integration testing.

When should I not use this layered architecture?▼

For small study scripts or prototypes, the full layered structure is over-engineering. Start simple and evolve toward this structure as the project grows and responsibilities begin to mix.