# io8 Code Master Agent - Customized for This Project

## Project-Specific Instructions


## E-commerce Application Project Breakdown - 2025-10-15 12:12:20

### Project Title: E-commerce Application ('ecom app')

### High-Level Goal:
To develop a fully functional e-commerce platform providing product browsing, shopping cart, user account management, and a secure checkout process.

### Major Milestones:

1.  **Phase 1: Discovery & Definition (Completion by io8Analyst, io8Architect)**
    *   **M1.1:** Detailed Requirements Document for 'ecom app' (Functional & Non-functional).
    *   **M1.2:** Comprehensive Architectural Design & Technology Stack Selection.
    *   **M1.3:** Initial Project Plan and PRD (Product Requirements Document).
    *   **Constraints:** Utilize the existing `cloned base project` (Angular Clarity boilerplate) for the frontend, requiring careful integration planning. Focus on core e-commerce features for MVP.

2.  **Phase 2: Core Backend Development (Completion by io8Developer, io8Architect)**
    *   **M2.1:** User Authentication & Profile Management API.
    *   **M2.2:** Product Catalog Management API (CRUD operations for products, categories, inventory).
    *   **M2.3:** Shopping Cart & Order Processing API.
    *   **M2.4:** Payment Gateway Integration Setup (e.g., Stripe, PayPal).
    *   **Constraints:** Robust data modeling, secure API endpoints, performance considerations for product searches.

3.  **Phase 3: Core Frontend Development (Completion by io8Developer)**
    *   **M3.1:** User Interface for Product Listing & Search.
    *   **M3.2:** Product Detail Pages.
    *   **M3.3:** Shopping Cart UI & Functionality.
    *   **M3.4:** User Account & Profile Management UI.
    *   **M3.5:** Checkout Flow UI (Address, Payment selection).
    *   **Constraints:** Ensure responsive design, integrate seamlessly with the `cloned base project` structure, provide intuitive user experience.

4.  **Phase 4: Integration, Testing & Deployment (Completion by io8Developer, io8Analyst, io8DevOps, io8SM)**
    *   **M4.1:** Full System Integration (Frontend-Backend, Payment Gateway).
    *   **M4.2:** Comprehensive Unit, Integration, and End-to-End Testing.
    *   **M4.3:** Setup CI/CD pipeline and Production Deployment.
    *   **M4.4:** User Acceptance Testing (UAT) and initial feedback loop.
    *   **Constraints:** Ensure data consistency across services, robust error handling, secure deployment practices.

### Key Constraints & Considerations for 'ecom app':

*   **Base Project Integration:** The `cloned base project` (Angular Clarity) must be preserved and extended, not replaced. New e-commerce specific features will be integrated into its structure.
*   **Security:** High priority for user data, payment information, and API access.
*   **Scalability:** Design for potential growth in product catalog, users, and transactions.
*   **Performance:** Optimize for fast page loads and responsive interactions.
*   **Payment Gateway:** Selection and integration complexity.
*   **Data Consistency:** Maintaining synchronized state across different services (e.g., inventory, orders).
*   **Development Environment:** Establishment of consistent local and deployment environments using Docker as outlined in the `directory_structure` (`Dockerfile.backend`, `Dockerfile.frontend`, `docker-compose.yml`).



## E-commerce Application Implementation Plan - 2025-10-15 12:12:20

### Project Title: E-commerce Application ('ecom app')

### Overall Approach:
This project will follow an agile, iterative development methodology, leveraging the specialized `io8` agents to move from high-level requirements to a deployed e-commerce application. Emphasis will be placed on modular design and clear separation of concerns, especially between the `backend/` and `frontend/` layers. The `cloned base project` will serve as the foundation, with new functionalities integrated or appended.

### Agent Engagement Workflow:

1.  **io8codermaster (Current Phase):**
    *   Define initial breakdown, high-level plan, and customize agent prompts.
    *   Ensure alignment with the project vision for an `ecom app`.

2.  **io8Analyst:**
    *   **Task:** Conduct detailed requirements gathering for e-commerce features (user stories, functional/non-functional requirements). Define key user flows (e.g., product search, add to cart, checkout).
    *   **Output:** `requirements_document.md`, `analysis_document.md` (in `.sureai/`).

3.  **io8Architect:**
    *   **Task:** Design the system architecture (e.g., API structure, database schemas, service decomposition for `backend/`). Select specific technologies for backend (Node.js/Express, Python/Django, etc.) while leveraging the existing Angular Clarity `cloned base project` for the `frontend/`. Define integration strategy.
    *   **Output:** `architecture_document.md`, `tech_stack_document.md` (in `.sureai/`).

4.  **io8PM:**
    *   **Task:** Create a detailed project timeline, resource allocation plan, and budget estimation. Develop the Product Requirements Document (PRD).
    *   **Output:** `prd_document.md`, `project_plan.md` (in `.sureai/`).

5.  **io8ScrumMaster:**
    *   **Task:** Break down architectural components and requirements into actionable tasks and user stories. Facilitate sprint planning and manage the backlog.
    *   **Output:** `tasks_list.md`, `sprint_plan.md` (in `.sureai/`).

6.  **io8Developer:**
    *   **Task:** Implement both `backend/` (API services, database interactions, business logic for products, users, orders, payments) and `frontend/` (UI components, pages, state management, API integration, adapting `cloned base project` components). Write unit and integration tests.
    *   **Output:** Codebase in `backend/` and `frontend/` directories. Updates to `tasks_list.md`.

7.  **io8DevOps:**
    *   **Task:** Establish CI/CD pipelines. Configure and manage infrastructure components as defined in `directory_structure` (e.g., `Dockerfile.backend`, `Dockerfile.frontend`, `docker-compose.yml`, `deployment_config.yml`, `nginx.conf`). Ensure secure and scalable deployments.
    *   **Output:** Configured infrastructure files at project root.

8.  **io8QualityAssurance (io8Analyst / io8Developer):**
    *   **Task:** Oversee and execute unit, integration, and end-to-end tests for all implemented e-commerce features.
    *   **Output:** Test reports and updated `tasks_list.md`.

9.  **io8Monitoring & Maintenance (io8DevOps / io8codermaster):**
    *   **Task:** Establish monitoring tools. Oversee ongoing maintenance and future iterations based on feedback.
    *   **Output:** Monitoring configurations and incident logs.

### Key Resources:

*   **Existing Base Project:** `cloned base project/` provides the foundational Angular Clarity frontend.
*   **Documentation:** All `.sureai/` documents (`.directory_structure_*.md`, `analysis_document.md`, `architecture_document.md`, etc.) will serve as single sources of truth.
*   **IO8 Agent Ecosystem:** Leveraging specialized agents for distinct phases.

### Success Criteria:

*   A functional e-commerce application demonstrating core features (product display, cart, checkout, user accounts).
*   Adherence to defined architectural patterns and coding standards.
*   Successful deployment to a target environment.
*   Meeting performance and security benchmarks for an `ecom app`.

### Timeline Estimates (High-Level, subject to change):

*   **Discovery & Definition:** 1-2 weeks
*   **Core Backend Development:** 3-5 weeks
*   **Core Frontend Development:** 3-5 weeks (parallel with backend where possible)
*   **Integration & Testing:** 1-2 weeks
*   **Deployment & Go-Live:** 1 week

### Risk Mitigation:

*   **Scope Creep:** Strictly adhere to MVP features initially, deferring advanced features (e.g., recommendations, complex promotions) to future iterations.
*   **Integration Challenges:** Early definition of API contracts between frontend and backend.
*   **Security Vulnerabilities:** Implement security best practices from the start, conduct regular security reviews.
*   **Performance Bottlenecks:** Stress testing, database indexing, caching strategies.
*   **Base Project Compatibility:** Careful review by io8Architect and io8Developer to ensure new e-commerce features can integrate smoothly with the existing Angular Clarity structure.


## Base Agent Prompt Reference

This agent is based on the standard io8codermaster agent with project-specific customizations above.
Refer to the base io8codermaster agent prompt for general principles and workflow instructions.
