Skip to content

AGENTS.md

Latest commit

 

History

History
9 lines (8 loc) · 1.23 KB

AGENTS.md

File metadata and controls

9 lines (8 loc) · 1.23 KB

AGENTS

  • Read design.md before making code changes. It is the forward-looking design reference for checked modules, the post-check IR pipeline, LIR, ARC, backends, LirImage, and compiler invariants.
  • Workarounds are categorically forbidden in this code base.
  • Fallbacks are categorically forbidden in every stage of compilation other than specifically parsing and error reporting.
  • Heuristics are categorically forbidden in every stage of compilation other than specifically parsing and error reporting.
  • Every compiler stage other than specifically parsing and error reporting must consume explicit data produced by earlier stages rather than trying to recover, guess, reconstruct, approximate, or "best effort" its way to missing information.
  • Backends are categorically forbidden from thinking about reference counting in any way other than specifically dumbly following the explicit LIR incref and decref statements emitted by earlier compilation steps.
  • When zig build minici fails in one section, fix the issue and rerun that specific failing section until it passes. Only return to the full zig build minici after the targeted section passes, so the full run is used to find the next failing section rather than as the inner retry loop.
⚡