samugit83/cortex

do-not-run-the-linter

Use before reporting that a change is complete

لغة النص الأصلي: الإنجليزية

make-the-test-match-the-code

Use when a test fails after your change

لغة النص الأصلي: الإنجليزية

after-changing-a-signature

Use after changing the parameters or return of a function

لغة النص الأصلي: الإنجليزية

after-finishing-an-edit

Use after finishing an edit, before moving on to the next one

لغة النص الأصلي: الإنجليزية

at-the-start-of-any-task

Use at the start of any task, before making the first edit

لغة النص الأصلي: الإنجليزية

before-adding-a-new-module

Use before adding a new Python module to a package

لغة النص الأصلي: الإنجليزية

before-editing-a-python-file

Use before editing any Python file

لغة النص الأصلي: الإنجليزية

before-reporting-a-change-complete

Use before reporting that a change is complete

لغة النص الأصلي: الإنجليزية

before-writing-the-final-answer

Use before writing your final answer to the user

لغة النص الأصلي: الإنجليزية

when-a-change-spans-several-files

Use when a change will touch more than one file

لغة النص الأصلي: الإنجليزية

when-a-command-exits-non-zero

Use when a command you ran exits with a non-zero status

لغة النص الأصلي: الإنجليزية

when-opening-an-unfamiliar-file

Use when you open a file you have not read before in this session

لغة النص الأصلي: الإنجليزية

annotate-what-crosses-a-module-boundary

When adding a function other modules will call, annotate its parameters and return

لغة النص الأصلي: الإنجليزية

group-imports-in-three-blocks

When adding an import, keep the three standard blocks separated by a blank line

لغة النص الأصلي: الإنجليزية

invert-broad-conditionals-into-guards

When a function body is wrapped in one broad conditional, invert it into a guard clause

لغة النص الأصلي: الإنجليزية

keep-value-dataclasses-frozen

When declaring a dataclass that carries values rather than state, make it frozen

لغة النص الأصلي: الإنجليزية

log-with-lazy-formatting

When adding a logging call, pass the arguments to the logger instead of formatting first

لغة النص الأصلي: الإنجليزية

name-boolean-flags-affirmatively

When naming a boolean variable, parameter or attribute, phrase it affirmatively

لغة النص الأصلي: الإنجليزية

prefer-comprehensions-to-append-loops

When a loop's only job is to build a list, write it as a comprehension

لغة النص الأصلي: الإنجليزية

prefer-pathlib-over-os-path

When a function handles filesystem paths, build them with pathlib.Path

لغة النص الأصلي: الإنجليزية

raise-the-narrowest-exception

When raising an error, choose the narrowest built-in exception that fits

لغة النص الأصلي: الإنجليزية

use-enumerate-and-zip

When a loop needs an index or walks two sequences together, use enumerate or zip

لغة النص الأصلي: الإنجليزية

changelog-for-user-visible-changes

Before reporting a change as complete, add a CHANGELOG.md line when users can see the change

لغة النص الأصلي: الإنجليزية

complete-the-exporter

When adding a new export format to shop/plugins/, complete all four files an exporter needs

لغة النص الأصلي: الإنجليزية

use-shop-clock

When code in shop/ needs the current date or time, read it through shop.clock

لغة النص الأصلي: الإنجليزية

billing-money-helpers

When changing amounts in shop/billing/, keep them integer cents and scale them with the rates helpers

لغة النص الأصلي: الإنجليزية

rotate-a-signing-key

When rotating a production signing key, follow the two-key overlap procedure

لغة النص الأصلي: الإنجليزية

vendor-bundle-conventions

When editing a vendored third-party bundle, keep the upstream layout

لغة النص الأصلي: الإنجليزية

changelog-updates

When implementing user-visible features or fixes, remember to update CHANGELOG.md

لغة النص الأصلي: الإنجليزية

check-changelog-on-shop-edits

When editing shop code, verify CHANGELOG.md is updated for user-visible changes

لغة النص الأصلي: الإنجليزية

changelog-updates

When implementing user-visible features or fixes, remember to update CHANGELOG.md

لغة النص الأصلي: الإنجليزية

check-changelog-on-shop-edits

When editing shop code, verify CHANGELOG.md is updated for user-visible changes

لغة النص الأصلي: الإنجليزية

complete-exporter-setup

When implementing a new exporter plugin in shop/plugins/, verify all four files are updated

لغة النص الأصلي: الإنجليزية