docs/README.md

# MeeTARA Documentation

Welcome to the MeeTARA documentation! This folder contains all technical documentation organized by category.

## 📁 Documentation Structure

```
docs/
├── README.md                           # This file
├── architecture/
│   └── core-vs-agent.md               # Core vs Agent architecture analysis
├── deployment/
│   └── huggingface-spaces.md          # HuggingFace Spaces deployment guide
├── features/
│   ├── domain-prompts.md              # Domain-specific system prompts
│   └── word-problems.md               # Word problem handling strategy
└── testing/
    └── test-questions.md              # Comprehensive test questions
```

## 📚 Documentation Index

### Architecture
- **[Core vs Agent Analysis](architecture/core-vs-agent.md)** - Detailed comparison of MeeTARA's two-layer architecture:
  - `meetara_lab_core.py` - Model interface layer (the "engine")
  - `meetara_agent.py` - Tool orchestration layer (the "orchestrator")

### Deployment
- **[HuggingFace Spaces](deployment/huggingface-spaces.md)** - Complete guide for deploying MeeTARA to HuggingFace Spaces:
  - Quick start options
  - Resource considerations
  - Troubleshooting

### Features
- **[Domain-Specific Prompts](features/domain-prompts.md)** - How MeeTARA handles domain-specific system prompts:
  - Current architecture
  - Domain mapping structure
  - Implementation recommendations

- **[Word Problem Strategy](features/word-problems.md)** - How MeeTARA handles different types of word problems:
  - Simple math → Calculator
  - Complex word problems → Model directly
  - Current events → Web search + Model

### Testing
- **[Test Questions](testing/test-questions.md)** - Comprehensive test questions covering:
  - Math & Calculator queries
  - Scientific functions & algorithms
  - Web search & current events
  - Combined queries
  - Edge cases

## 🔗 Quick Links

- [Main README](../README.md) - Project overview and features
- [Configuration](../config/) - Configuration files
- [Core Module](../core/) - Core model and agent code

---

*Last updated: January 2026*