- Keep all code identifiers, comments, filenames, and documentation in English.
- Preserve the current visual layout unless a task explicitly asks for UI changes.
- Prefer React components for rendering and keep component files focused on one responsibility.
- Put pure business logic in
src/utilsand cover it with unit tests under the mirroredtests/utilspath. - Keep tests outside
src; thetestsfolder must sit at the repository root and mirror the relevantsrcstructure. - Do not mix unrelated refactors with feature work.
- Use TypeScript for new source files unless an existing JavaScript integration requires otherwise.
- Keep GitHub API and
ghCLI access behind server-side endpoints; do not expose tokens to the browser. - Run
npm testandnpm run buildafter behavior changes when dependencies are available.