Agent-Driven Project Sample

This repository serves as a template and example for building projects driven by AI agents. It demonstrates a decoupled architecture between a core logic layer and a user interface, following strict operating guidelines for AI agents.

Core Concept

The project is designed to be explored, modified, and extended by AI agents. It includes:

• Strict Guidelines: An AGENTS.md file that defines how AI agents should interact with the codebase.
• Decoupled Architecture: Separation between business logic (src/core) and the presentation layer (src/web).
• Technical Documentation: Modular documentation focused on providing context to agents.

Getting Started

Prerequisites

• Python 3.10+
• (Optional) Streamlit for the web interface

Structure

• src/core/: Contains the main business logic and server.
• src/web/: Contains the web interface (Streamlit).
• docs/: Technical documentation and architecture principles.
• AGENTS.md: Mandatory guidelines for AI agents.

Usage

This project is intended to be used as a starting point for agentic workflows. Agents should start by reading AGENTS.md and the docs/TECHNICAL_OVERVIEW.md.