docHub

Anti-patterns

INDEX.md §O is the canonical "do not do this again" list. Every entry on it is a mistake that has actually been made at least once.


The list


How to check

Before adding a new chip, layout, or workspace, ask:

  1. Is it really a chip, or is it a layer/sub-layout/workspace?
  2. Does the dock belong to it, or does the top bar?
  3. Am I using the canonical id (e.g., horizontal not 3-over-1)?
  4. Am I following the GZ-1 protocol if I'm touching a GOLD file?

If any of these is "I don't know," look it up before acting.


Adding to the list

The list grows by real mistake. When a Mavis (or operator) catches a violation, the violation gets added to INDEX.md §O and reflected here.

The list is append-only. Don't remove entries — even if a rule is later relaxed, the historical violation is still real.


Cross-references


← back to Dev docs