**Author(s):** Zach Lin
**Date:** 2025/08/08
**Project/Object:** Lakr/Thermal

---

# Abstract
_A quick TL;DR of what bug was investigated, how you tested/fixed it, and the outcome._

---
# Topology & Architecture

%% Flowchart – visualize workflows or decision logic
graph TD
  A[Start] --> B{Is bug reproducible?}
  B -->|Yes| C[Run test suite]
  B -->|No| D[Review logs]
  C --> E[Collect metrics]
  D --> E
  E --> F[End]

%% Sequence Diagram – show message flows over time
sequenceDiagram
  participant Dev
  participant CI
  participant Prod
  Dev->>CI: Push code
  CI->>CI: Run tests
  CI-->>Dev: Report status
  CI->>Prod: Deploy if green

%% Mindmap – brainstorm or map debugging ideas (if supported)
mindmap
  root((Debugging Ideas))
    Tools
      Logs
      Debugger
    Tests
      Unit
      Integration
    Automation
      CI
      Monitoring

%% State Diagram – model system or bug-state transitions
stateDiagram
  [*] --> Idle
  Idle --> Testing
  Testing --> Fixed
  Fixed --> [*]
  Testing --> Failed
  Failed --> Testing

# Introduction & Background
- Context: What system or module the bug appeared in
- Symptoms & motivation: Why this bug matters (crash, data corruption, latency spike…)
- Related work or prior incidents in similar environments

---

# Objectives & Hypothesis
- **Objective:** What you aimed to validate or fix
- **Hypothesis:** Example—“If I isolate the IRQ handler on core 2 under 800 MHz, latency drop will disappear.”

---

# Environment Configuration
| Component | Details |
|------------------|----------------------------------------------|
| **Hardware** | CPU, RAM, Board, Sensors, Peripherals, etc. |
| **Firmware** | Bootloader version, BIOS/UEFI revisions |
| **OS & Kernel** | Distribution, Kernel version, patches |
| **Drivers** | Custom or upstream drivers and versions |
| **Toolchain** | Compiler versions, build flags |
| **Network/Storage** | Versions, configs, load conditions |
| **Other dependencies** | Middleware, DBs, VMs, containers |

*(Add notes on reproducibility, snapshots, rollback snapshots, etc.)*

---

# Variables & Controls
| Type | Variable | Definition / Control Condition |
|------------------|-----------------------|------------------------------------------|
| Independent | (e.g., clock rate) | Values tested (300 MHz, 600 MHz, etc.) |
| Dependent | (e.g., error rate) | Measured output or failure mode |
| Controlled | (e.g., ambient temp) | Kept constant or mitigated |

---

# Methods & Procedure
Narrative-style enumeration, e.g.:

1. Set system to *Env A*
2. Trigger bug with input sequence X via tool Y
3. Record output, logs, metrics
4. Modify variable—repeat for each control condition
5. Log reproducibility, triggers, regression tests

---

# Results & Observations
- **Quantitative data:** Insert tables, perhaps:

| Column 1 | Column 2 | Column 3 |
| -------- | -------- | -------- |
| Text | Text | Text |