.github/instructions/updated.instructions.md

---
applyTo: '**'
---

# PyCatan AI Project Instructions

## 📋 Project Overview

**PyCatan_AI** is a Python implementation of the Settlers of Catan board game with a focus on AI agent development. The project consists of:

- **Core Game Engine**: Complete implementation of Catan game rules, board management, and resource mechanics
- **Game Management**: Turn-based coordination, action validation, and game state management
- **Player Types**: Support for both human players (CLI) and AI agents
- **Visualization**: Console and web-based game state visualization
- **AI Development**: Framework for building and testing LLM-based AI agents to play Catan

The primary goal is to create intelligent AI agents that can play Settlers of Catan autonomously, making strategic decisions about resource management, building placement, trading, and overall game strategy.

## 📚 Related Documentation

For detailed information about specific aspects of the project, refer to:

- **[AI_ARCHITECTURE.md](.github/instructions/AI_ARCHITECTURE.md)** - Architecture and design of the AI agent system
- **[AI_AGENT_PRINCIPLES.md](.github/instructions/AI_AGENT_PRINCIPLES.md)** - Core design principles and philosophy for AI agent implementation
- **[WORK_PLAN.md](.github/instructions/WORK_PLAN.md)** - Detailed development work plan and roadmap
- *(Additional documentation files will be referenced here as they are created)*

## 🎯 Project Context

This instruction file provides general coding guidelines and project context that AI assistants should follow when generating code, answering questions, or reviewing changes across the entire codebase.