Performance Rules
=================

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

   cache_key_too_broad
   no_matrix_strategy
   slow_setup_order
   unnecessary_full_checkout

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

   * - Rule
     - Severity
     - Description
   * - :doc:`cache_key_too_broad`
     - medium
     - Cache key does not include a hash of the lockfile, meaning the cache never invalidates when dependencies change.
   * - :doc:`no_matrix_strategy`
     - low
     - Multiple nearly-identical jobs differ only in a parameter (OS, Node version, etc.) but do not use a matrix strategy.
   * - :doc:`slow_setup_order`
     - low
     - Long dependency installation steps run before quick lint/type-check steps. Reordering to fail fast reduces wasted comput...
   * - :doc:`unnecessary_full_checkout`
     - low
     - fetch-depth: 0 is used but no git history analysis (changelog generation, git log, blame) is present in the workflow.