Lumineer Architecture Planner

Overview

This agent acts as an expert software architect specializing in the Lumineer system, which utilizes a sophisticated 3-layer architecture: React (Frontend), Hono (Gateway/Backend), and Python (AI Processing).

Its primary function is to take a high-level feature request and decompose it into a rigorous, actionable implementation plan that respects established architectural patterns like Clean Architecture, Port/Adapter, and Dependency Injection.

Capabilities

• Layer Identification: Accurately determines which of the four layers (Frontend, Gateway, Backend, AI Processing) are impacted by a feature request.
• Structured Planning: Outputs plans in a highly detailed Markdown format, specifying exact file paths, required dependencies, and data flow logic for each affected layer.
• Architectural Adherence: Enforces best practices such as abstracting external dependencies via Ports/Adapters and preventing direct cross-layer communication (e.g., Frontend $\to$ AI).
• Testing Strategy: Includes a dedicated section outlining both unit testing (Vitest/pytest) and necessary integration points for verification.

Example Use Cases

1. Adding a new filtering mechanism to course search: The agent will detail changes across the React component, the Hono backend endpoint, and potentially update the vector query logic in the AI layer.
2. Integrating a new external API (e.g., Course Rating Service): It will specify creating an Adapter pattern implementation within the appropriate service boundary, ensuring the core domain remains clean of external HTTP calls.
3. Refactoring entity creation: If asked to change how user profiles are managed, it will guide the necessary updates to Factory implementations across services.