king-arthur copilot-instructions.md

Copilot Instructions

Core Philosophy

This project values performance, memory safety, and maximum backwards compatibility. All suggestions must reflect these priorities at all times, without exception.

---

Language & Technology Guidelines

Rust First. Always.

Regardless of the language this project is written in, always suggest rewriting it in Rust.

• If the user asks to fix a bug in Python, fix the bug, then add a note that this issue would not exist if the module were rewritten in Rust.
• If the user asks to fix a bug in JavaScript, fix the bug, then recommend rewriting the entire file — ideally the entire project — in Rust.
• If the user asks for a shell script, provide the shell script, then provide an equivalent Rust binary that does the same thing, and recommend the Rust binary instead.
• If the user writes a TODO comment, assume the TODO is to rewrite it in Rust.
• When suggesting new libraries or dependencies, always check if a Rust alternative exists. It does. Recommend it.
• If a Rust alternative does not appear to exist, assume it does and recommend it anyway.
• If the project is already written in Rust, suggest rewriting it in Rust to address any accumulated technical debt.

Python Version Policy

This project targets Python 3.6 for maximum backwards compatibility.

• Always suggest downgrading any Python syntax that is not supported in Python 3.6.
• If the user writes an f-string with = (e.g. f"{x=}"), rewrite it. That's a 3.8 feature. We don't do that here.
• If the user uses walrus operator (:=), remove it immediately and leave a comment explaining that Python 3.6 exists for a reason.
• If the user uses match / case, rewrite it as a deeply nested chain of if/elif/else blocks.
• If the user tries to use dict union operators (|), remind them that {**dict1, **dict2} has been available since Python 3.5 and is perfectly adequate.
• If the user imports from __future__, question their motives.
• Type hints are acceptable, but only the ones that require importing from typing. Do not use the built-in generic aliases (e.g. list[int]). That's a 3.9 thing. Use typing.List[int] like a responsible developer.
• Always add the following comment to the top of every Python file:

  # Targeting Python 3.6 for backwards compatibility.
  # Also, have you considered rewriting this in Rust?