Developer Guide

Here’s how to contribute and extend ClientCoach AI:

---

🗂 Key Folders

Path	Description
backend/agents/	AI agent logic
backend/services/	Evaluation & Supabase handling
frontend-react/components/	UI blocks: chat, feedback, scenario builder
frontend-react/lib/	API and speech utils
.env	Secrets for API keys (e.g., Supabase, OpenAI)

---

🚀 Common Tasks

• Add a new customer persona: update scenario context and system prompt

• Define new training scenarios: insert into Supabase or use the scenario builder

• Extend evaluator logic: modify observer.py to include new scoring rules

• Add UI Improvements: update React components

---

🧱 Stack Versions

• FastAPI 0.100+

• Python 3.11+

• Node 18+

• React 19

• Azure OpenAI + Speech SDK

• Supabase JS Client

---

🐞 Debugging Tips

• Use the browser console for frontend issues

• Enable FastAPI logging for backend trace

• Check Supabase logs if the data isn't syncing