# io8 Code Master Agent - Customized for This Project

## Project-Specific Instructions


## Project Breakdown: Develop a Working Notes App - 2025-10-06 07:29:01

### I. Project Overview

**Project Goal:** To develop a functional Minimum Viable Product (MVP) of a notes application, enabling users to create, read, update, and delete notes with optional basic user authentication.

### II. Milestones

*   **Phase 1: Backend Foundation & API MVP (Target: Completion of core data logic)**
    *   **M1.1: Database Setup & Schema Design:** Define and implement the database schema for `Notes` and `Users` (if authentication is included).
    *   **M1.2: Note Management API (CRUD):** Implement API endpoints for creating, retrieving, updating, and deleting notes.
    *   **M1.3: User Authentication API (Optional MVP):** Implement API endpoints for user registration and login/logout, including token management if stateful.
    *   **M1.4: Basic Data Validation & Error Handling:** Ensure robust input validation for note data and user credentials.

*   **Phase 2: Frontend MVP & Integration (Target: Functional user interface)**
    *   **M2.1: Frontend Project Setup:** Initialize the frontend application within the `frontend/` directory.
    *   **M2.2: Notes List Display:** Develop UI to fetch and display a list of all notes from the backend.
    *   **M2.3: Note Detail View/Edit:** Implement UI for viewing a single note and forms for creating new notes or editing existing ones.
    *   **M2.4: User Authentication UI (if M1.3 is in scope):** Develop login and registration forms, and integrate with the authentication API.
    *   **M2.5: Frontend-Backend Integration:** Ensure seamless data exchange between the frontend UI and the backend API.

*   **Phase 3: Testing & Local Deployment (Target: End-to-end operability)**
    *   **M3.1: Unit/Integration Tests:** Implement basic tests for core backend API endpoints and critical frontend components.
    *   **M3.2: Containerization:** Create `Dockerfile.backend` and `Dockerfile.frontend` for the respective services.
    *   **M3.3: Local Orchestration:** Configure `docker-compose.yml` to run the entire notes app locally (backend, frontend, database).
    *   **M3.4: End-to-End Functional Test:** Verify that the entire application workflow (e.g., user registers, logs in, creates a note, edits it, deletes it, logs out) functions correctly.

### III. Key Constraints

*   **Scope Limitation:** The MVP focuses strictly on core note CRUD operations and optional basic user authentication. Advanced features (e.g., rich text editor, markdown support, tagging, search, sharing, real-time sync, attachments) are explicitly out of scope for this initial phase.
*   **Timeframe:** Assumed rapid development for MVP; detailed timeline to be specified by the PM Agent.
*   **Resource Allocation:** Limited to the automated io8 agent ecosystem for initial generation; human oversight for final development and refinement.
*   **Tech Stack:** Not defined by `io8codermaster`; selection delegated to the `io8architect` agent, ensuring compatibility with containerization.
*   **Base Project Adherence:** All modifications and new code must integrate within the `.sureai/`, `backend/`, and `frontend/` structure as defined by `io8directory_structure`.



## Implementation Plan: Develop a Working Notes App - 2025-10-06 07:29:01

### I. High-Level Workflow & Agent Engagement

This plan outlines the sequence of agent engagements and major tasks to develop the "Working Notes App," building upon the completed `io8project_builder` and `io8directory_structure` phases.

1.  **io8codermaster (Current Phase):**
    *   **Task:** Break down the user prompt, define initial milestones, identify constraints, and outline the high-level plan.
    *   **Output:** `.sureai/.io8codermaster_breakdown.md`, `.sureai/.io8codermaster_plan.md` (this document).

2.  **io8analyst Agent:**
    *   **Role:** Elicit and document detailed functional and non-functional requirements for the Notes App MVP.
    *   **Tasks:** Define user stories for note management, user authentication, and system interactions. Clarify specific data fields for notes.
    *   **Output:** `.sureai/requirements_document.md`, `.sureai/analysis_document.md`.

3.  **io8architect Agent:**
    *   **Role:** Design the technical architecture and select the technology stack.
    *   **Tasks:** Propose frontend framework, backend framework/language, and database system. Design API endpoints, data models, and overall system components. Consider scalability and security.
    *   **Output:** `.sureai/architecture_document.md`, `.sureai/tech_stack_document.md`.

4.  **io8pm Agent:**
    *   **Role:** Create and manage the overall project plan, including timeline, budget, and resource allocation.
    *   **Tasks:** Develop a Product Requirements Document (PRD). Refine the project timeline and estimate effort for each phase based on architectural design.
    *   **Output:** `.sureai/prd_document.md`, `.sureai/project_plan.md`.

5.  **io8sm Agent:**
    *   **Role:** Facilitate iterative development cycles (sprints).
    *   **Tasks:** Break down project plan into manageable sprint backlogs and facilitate sprint planning meetings. Track progress and manage impediments.
    *   **Output:** `.sureai/tasks_list.md`, `.sureai/sprint_plan.md`.

6.  **io8developer Agent:**
    *   **Role:** Implement the application's code for both backend and frontend.
    *   **Tasks:** Develop backend API endpoints (CRUD for notes, user auth). Build frontend UI components and integrate with the backend API. Write unit and integration tests.
    *   **Output:** Codebase within `backend/` and `frontend/` directories.

7.  **io8devops Agent:**
    *   **Role:** Define and implement the deployment strategy.
    *   **Tasks:** Create `Dockerfile.backend` and `Dockerfile.frontend`. Configure `docker-compose.yml` for local development and potential production deployment. Define `deployment_config.yml`.
    *   **Output:** Root-level deployment files: `Dockerfile.backend`, `Dockerfile.frontend`, `docker-compose.yml`, `deployment_config.yml`.

### II. Preliminary Timeline (Subject to PM Agent Refinement)

*   **Week 1:** Analysis & Initial Architecture (Analyst, Architect)
*   **Week 2-3:** Backend Development & Database Integration (Developer, Architect support)
*   **Week 3-4:** Frontend Development & API Integration (Developer)
*   **Week 5:** Testing, Refinement, and Local Deployment Setup (Developer, DevOps)

### III. Resources

*   **Human Resources:** io8 Agent ecosystem (Analyst, Architect, PM, SM, Developer, DevOps).
*   **Tools:** Existing development environment, version control (Git), Docker.
*   **Knowledge Base:** `.sureai/` directory documents and agent-specific prompts.


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