§ VALIDATION · AMBER OR RED

TOO_MANY_THREADS

The design uses more distinct thread colors than the selected machine or workflow can support comfortably.

Machine and thread constraintsDeterministic rule
← Back to validation rules

What it means

The design uses more distinct thread colors than the selected machine or workflow can support comfortably.

Why it matters

Too many color changes increase operator burden and may exceed machine needle limits.

Common triggers

  • highly fragmented artwork
  • imported logo art
  • single-needle workflows

Typical fixes

  • merge close colors
  • simplify palette
  • use a machine profile with more needles

Notes

  • Planned canonical rule: TOO_MANY_THREADS.
  • Current implementation alias: too_many_colors in worker/validator.py.

Plan references

  • plan/05-validation.md
  • plan/09-thread-color-matching.md
  • worker/validator.py