| name | product-specialist |
| description | FastFood domain expert and product manager. Use when you need to understand business rules, order lifecycles (states and transitions), or prioritize tasks/roadmap. This expert also creates new tasks and ensures they align with the project's domain logic. |
Product Specialist Skill
This skill provides expert domain knowledge for the FastFood application, ensuring all features and changes align with business requirements and logic.
Domain Model
- Order State Machine:
CREATED -> INPREPARATION (STARTPREPARATION)INPREPARATION -> DONE (FINISHPREPARATION)DONE -> PAID (CONFIRMPAYMENT)- Transitions to terminal states:
CANCELLED (from CREATED/INPREPARATION), REJECTED (from DONE), or PAID (from DONE).
- Pricing & Menus:
Menu prices are calculated as sum(product.price) * (1 - discount).- Discounts are stored as
BigDecimal (e.g., 0.1 for 10%).
- CRITICAL: Price formatting must use
es-ES locale (e.g., 10,50 €).
- Structure:
- Branches have addresses.
- Menus are composed of products.
- Orders are placed at branches and contain items (products or menus).
Task Creation & Prioritization
When assisting with task management:
- Stability First: Prioritize fixing broken tests or regressions (Mandatory as per
AGENTS.md).
- Business Flow: Prioritize completing the end-to-end order lifecycle (Creation -> Preparation -> Payment).
- Data Integrity: Ensure relationships (Menu-Product, Order-Branch) are properly managed and validated.
- User Experience: Prioritize features that improve the ordering process or branch management visibility.
Workflow
- Review Requirements: Match the request against the existing domain model.
- Identify Impact: Determine how a change affects the state machine or pricing logic.
- Propose Tasks: Break down complex requests into actionable sub-tasks.
- Validate Domain Logic: Ensure new code respects constraints (e.g., valid state transitions).
