# Analysis Request: [Insert Topic Here] **Status:** [Draft / Pending Analysis / Completed] **Date:** [YYYY-MM-DD] **Priority:** [Low / Medium / High] --- ## 1. User Description & Query *(User: Fill this section with your design ideas, questions, code snippets, or links to files/web resources. Be as specific as possible about the goal.)* ### Context * **Goal:** * **Current Behavior:** * **Desired Behavior:** ### References * **Files:** `[filename.py]`, `[path/to/module]` * **Links:** `[url]` ### Specific Questions / Hypothesis 1. 2. --- *(The sections below are to be filled by the AI Agent upon request)* ## 2. Agent Summary *(AI: Summarize the user's request to ensure alignment on the objective.)* * **Objective:** * **Key Constraints:** * **Scope:** ## 3. Main Analysis *(AI: Perform the deep dive here. Use codebase knowledge, logic, and simulations.)* ### 3.1 Codebase Investigation * **Affected Components:** * **Data Flow Analysis:** * **Current Limitation/Bug:** ### 3.2 Technical Options / Trade-offs | Option | Pros | Cons | Complexity | | :--- | :--- | :--- | :--- | | **A. [Strategy A]** | ... | ... | ... | | **B. [Strategy B]** | ... | ... | ... | ### 3.3 Proposed Solution Design * **Architecture:** * **Logic Changes:** * **Edge Cases Considered:** ## 4. Risk Assessment *(AI: What could go wrong? Performance, Security, or Stability impacts.)* * **Risk 1:** [Description] -> *Mitigation:* [Strategy] ## 5. Conclusion *(AI: Final verdict and recommendation.)* * **Recommendation:** ## 6. Implementation Plan *(AI: Step-by-step checklist to execute the recommendation.)* - [ ] Step 1: - [ ] Step 2: - [ ] Step 3: