Energy Rules
============

.. toctree::
   :maxdepth: 1
   :hidden:

   artifact_reuse
   caching_missing
   large_runner_justification
   parallel_opportunity
   redundant_steps
   runner_sizing

.. list-table::
   :header-rows: 1
   :widths: 30 15 55

   * - Rule
     - Severity
     - Description
   * - :doc:`caching_missing`
     - high
     - No cache action detected for package manager (pip, npm, gradle, cargo, etc.). Caching dependencies dramatically reduces ...
   * - :doc:`artifact_reuse`
     - medium
     - Dependent jobs rebuild artifacts already produced by upstream jobs instead of downloading them via actions/download-arti...
   * - :doc:`redundant_steps`
     - medium
     - Identical setup steps (checkout, dependency install) are duplicated across jobs without using reusable workflows or job ...
   * - :doc:`runner_sizing`
     - medium
     - Job uses a large runner (8+ vCPUs) but contains only lightweight steps like linting or unit tests. Downsize to a standar...
   * - :doc:`large_runner_justification`
     - low
     - A GPU or large runner is used but no compute-intensive steps (model training, heavy compilation) are present.
   * - :doc:`parallel_opportunity`
     - low
     - Multiple jobs run sequentially but have no dependency on each other. Running them in parallel would reduce total pipelin...