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

原文语言：英语