# io8 Code Master Agent - Customized for This Project

## Project-Specific Instructions

## PROJECT BREAKDOWN - To Do List System App - 2025-10-16 13:50:20

### Project Goal
Develop a fully functional web application (To Do List System App) allowing users to create, view, update, and delete tasks, with a primary focus on core task management capabilities. The system will comprise a distinct frontend (Angular Clarity) and a backend API, containerized for consistent deployment.

### Key Milestones
1.  **Backend API Core Development:** Establish a robust RESTful API capable of handling CRUD operations for tasks, including functionality to mark tasks as complete or incomplete.
    *   **Deliverables:** API endpoints for tasks, initial database schema, basic unit tests for API.
2.  **Frontend UI Development (MVP):** Implement an intuitive user interface using Angular Clarity to interact with the backend API. This includes displaying task lists, adding new tasks, editing existing tasks, and changing task status.
    *   **Deliverables:** Functional Angular Clarity components (task list, task item, add/edit form), API integration services, basic e2e tests.
3.  **Database Integration & Persistence:** Set up and integrate a suitable database solution to store and manage task data persistently for the application.
    *   **Deliverables:** Chosen database instance, ORM/database client configuration, initial migration scripts.
4.  **Containerization & Deployment Strategy:** Prepare the frontend and backend applications for containerized deployment using Docker. Develop a `docker-compose.yml` for orchestrating services (frontend, backend, database) for local development and future production deployment.
    *   **Deliverables:** `Dockerfile.backend`, `Dockerfile.frontend`, `docker-compose.yml`, `nginx.conf` (if required for proxying).
5.  **Comprehensive Testing & Iteration:** Conduct thorough testing across all layers (unit, integration, end-to-end) and refine the application based on testing outcomes and potential user feedback.
    *   **Deliverables:** Test reports, bug fixes, performance optimizations, updated task list and backlog.

### Initial Scope (Minimum Viable Product - MVP)
*   **Task Management:** Users can create new tasks, view a list of all tasks, update task details (e.g., title, description), and delete tasks.
*   **Status Management:** Tasks can be marked as complete or incomplete.
*   **Basic UI:** A clear and responsive user interface for interaction.
*   **Persistence:** All task data will be stored in a database and persist across application restarts.
*   **No Authentication:** The MVP will not include user authentication or authorization. Tasks will be globally managed or implicitly tied to a single user context for simplicity.

### Constraints
*   **Technology Stack:** Adherence to Angular Clarity for the frontend. Backend framework to be determined by io8Architect, but compatible with Docker containerization. Database selection to align with project needs and ease of integration.
*   **Architecture:** Separation of concerns with distinct frontend and backend services, facilitated by Docker Compose for local environment.
*   **Existing Assets:** Building upon the provided Angular Clarity boilerplate for frontend development and adhering to the established `.sureai/` directory structure for all documentation and agent outputs.
*   **Documentation Mode:** All planning and breakdown documents within the `.sureai/` directory must be updated in append-only mode, preserving existing content and structure.
*   **Output Format:** Structured JSON for downstream agents to process updates.


## IMPLEMENTATION PLAN - To Do List System App - 2025-10-16 13:50:20

### Project Phases & Agent Engagement
This plan outlines the sequence of operations and the primary io8 agents responsible for each phase of the To Do List System App development. The io8codermaster agent will oversee orchestration and ensure smooth transitions between phases.

#### Phase 1: Detailed Requirements & Initial Design (io8Analyst, io8Architect, io8PM)
*   **Objective:** Define precise functional and non-functional requirements, select specific backend technologies, and establish the high-level system architecture.
*   **Key Tasks:**
    *   **io8Analyst:** Elicit and document detailed user stories for task creation, viewing, updating, deletion, and status toggling. Define non-functional requirements (e.g., performance, scalability considerations for MVP).
    *   **io8Architect:** Evaluate and propose a specific backend framework (e.g., Node.js with Express, Python with Flask/Django, Go, etc.) and a database (e.g., PostgreSQL, MongoDB). Outline the API contract for task management. Design the initial database schema.
    *   **io8PM:** Validate the scope based on the detailed requirements, establish preliminary timelines and resource allocations, and ensure alignment with project goals.
*   **Expected Outputs:** `requirements_document.md`, initial `architecture_document.md` with backend/database specifics, `tech_stack_document.md`.
*   **Timeline:** 1-2 days (estimated)

#### Phase 2: Backend API Development (io8Architect, io8Developer, io8DevOps)
*   **Objective:** Implement the core task management API and ensure it's container-ready.
*   **Key Tasks:**
    *   **io8Architect:** Finalize backend design, define data models and API endpoint specifications, review developer's implementation for architectural adherence.
    *   **io8Developer (Backend):** Implement the chosen backend framework, create API endpoints for CRUD operations on tasks and status updates. Develop necessary business logic and services. Implement database integration and migration scripts. Write unit and integration tests for the API.
    *   **io8DevOps:** Create `Dockerfile.backend` for the backend service, ensuring proper dependencies and build process. Set up initial `docker-compose.yml` for the backend and database services.
*   **Expected Outputs:** Functional backend codebase, API documentation, deployed backend service (locally via Docker), `Dockerfile.backend` updated.
*   **Timeline:** 3-5 days (estimated)

#### Phase 3: Frontend UI Development (io8Architect, io8Developer)
*   **Objective:** Develop the user interface using Angular Clarity and integrate it with the developed backend API.
*   **Key Tasks:**
    *   **io8Architect:** Design the overall UI structure and component hierarchy, ensure adherence to Clarity design system principles, define frontend-backend API interaction patterns.
    *   **io8Developer (Frontend):** Develop Angular Clarity components for task list display, individual task items, and forms for adding/editing tasks. Implement services for consuming the backend API. Manage application state. Write unit tests for Angular components and services. Integrate with `Dockerfile.frontend` and `docker-compose.yml`.
*   **Expected Outputs:** Functional Angular Clarity application, integrated with backend API, `Dockerfile.frontend` updated.
*   **Timeline:** 3-5 days (estimated)

#### Phase 4: Integration & Deployment Setup (io8DevOps, io8Developer)
*   **Objective:** Consolidate frontend, backend, and database services into a cohesive, containerized deployment.
*   **Key Tasks:**
    *   **io8DevOps:** Refine `docker-compose.yml` to orchestrate all services (frontend, backend, database). Configure `nginx.conf` (if needed) for reverse proxying and serving static assets. Ensure services can communicate effectively.
    *   **io8Developer (Fullstack):** Assist in debugging integration issues between frontend and backend within the containerized environment.
*   **Expected Outputs:** Fully integrated and locally deployable application via `docker-compose up`.
*   **Timeline:** 2-3 days (estimated)

#### Phase 5: Testing, Review & Iteration (io8PM, io8Developer, io8Analyst)
*   **Objective:** Ensure the application meets requirements, identify and resolve defects, and prepare for potential future enhancements.
*   **Key Tasks:**
    *   **io8PM:** Coordinate user acceptance testing (UAT), track progress against milestones, manage backlog for future iterations, update `project_plan.md` and `tasks_list.md`.
    *   **io8Developer:** Perform comprehensive unit, integration, and end-to-end testing. Address reported bugs and implement minor refinements.
    *   **io8Analyst:** Validate the implemented features against the `requirements_document.md` and gather feedback for improvements.
*   **Expected Outputs:** Test reports, bug fixes, updated `tasks_list.md` with resolved issues, `sprint_plan.md` (if agile is adopted for future sprints).
*   **Timeline:** Ongoing, initial cycle 1-2 days (estimated)

### Key Resources & Dependencies
*   **io8Analyst:** Essential for clarifying requirements throughout the project lifecycle.
*   **io8Architect:** Critical for system design decisions, technology selection, and ensuring architectural integrity.
*   **io8Developer:** Primary resource for all coding and implementation tasks (backend and frontend).
*   **io8DevOps:** Responsible for containerization, environment setup, and deployment automation.
*   **io8PM:** Oversees project execution, scope, and communication.
*   **Backend API Stability:** Frontend development is highly dependent on a stable and well-documented backend API.
*   **Database Accessibility:** Both backend development and deployment require a functional database instance.
*   **Clarity Design System Knowledge:** Frontend developers need familiarity with Angular and Clarity UI components.


## 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.
