refactor: migrate loyalty-agent and loyalty-mcp-server components to a new modular structure with updated specs and frontend integration.

README.md

@@ -1,4 +1,31 @@
- ./mvnw package -Pgen
+# Loyalty Agent Service
 
- 
- ./mvnw compile spring-boot:run
+This project consists of a 3-module architecture:
+1. `loyalty-mcp-server`: Domain MCP tools and operations
+2. `loyalty-agent`: Orchestration and BFF layer
+3. Frontend (React/Vite in the root directory)
+
+## Startup Instructions
+
+### 1. Prerequisites
+- Java 21+
+- Node.js & pnpm
+- `.env` file created (see `.env.example`)
+
+### 2. Start Backend Modules
+You can use the provided startup script:
+```bash
+./start-all.sh
+```
+Or start them individually in separate terminals:
+```bash
+./mvnw spring-boot:run -pl loyalty-mcp-server
+./mvnw spring-boot:run -pl loyalty-agent
+```
+
+### 3. Start Frontend
+In a new terminal:
+```bash
+pnpm install
+pnpm dev
+```