{"generated":"2026-08-21T19:43:01Z","count":5424,"site":"https://awesomereviewers.com","domains":[{"slug":"ai-agents","title":"AI Agents & Assistants","count":838,"updated":"2026-08-11","bundle":"https://awesomereviewers.com/raw/bundles/ai-agents.md"},{"slug":"llm-infra","title":"LLM Serving & Gateways","count":335,"updated":"2026-07-29","bundle":"https://awesomereviewers.com/raw/bundles/llm-infra.md"},{"slug":"ml-systems","title":"ML Frameworks & Platforms","count":343,"updated":"2026-04-28","bundle":"https://awesomereviewers.com/raw/bundles/ml-systems.md"},{"slug":"orchestration","title":"Containers & Orchestration","count":279,"updated":"2026-08-09","bundle":"https://awesomereviewers.com/raw/bundles/orchestration.md"},{"slug":"cloud-infra","title":"Cloud, IaC & Networking","count":435,"updated":"2026-08-05","bundle":"https://awesomereviewers.com/raw/bundles/cloud-infra.md"},{"slug":"data-systems","title":"Databases & Data Platforms","count":432,"updated":"2026-07-26","bundle":"https://awesomereviewers.com/raw/bundles/data-systems.md"},{"slug":"observability","title":"Observability & Telemetry","count":204,"updated":"2025-09-03","bundle":"https://awesomereviewers.com/raw/bundles/observability.md"},{"slug":"security","title":"Security & Access Control","count":225,"updated":"2026-08-09","bundle":"https://awesomereviewers.com/raw/bundles/security.md"},{"slug":"runtimes","title":"Language Runtimes & Compilers","count":406,"updated":"2025-10-23","bundle":"https://awesomereviewers.com/raw/bundles/runtimes.md"},{"slug":"devtools","title":"Developer Tooling","count":685,"updated":"2026-05-08","bundle":"https://awesomereviewers.com/raw/bundles/devtools.md"},{"slug":"app-frameworks","title":"Application Frameworks & UI","count":1179,"updated":"2026-08-12","bundle":"https://awesomereviewers.com/raw/bundles/app-frameworks.md"},{"slug":"docs","title":"Documentation & Knowledge","count":63,"updated":"2026-07-22","bundle":"https://awesomereviewers.com/raw/bundles/docs.md"}],"entries":[{"slug":"bmad-method-api-contract-clarity","title":"API contract clarity","description":"Define and document the interface contract for requests/commands so the system’s behavior is unambiguous, deterministic, and consistent across call paths and modes.","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2026-08-12","comments":3,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-api-contract-clarity.md"},{"slug":"pr-agent-config-precedence-consistency","title":"Config precedence consistency","description":"For configuration-driven code (especially anything that affects user-facing URLs, published links, secrets, or server startup), centralize resolution and make precedence explicit.","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2026-08-11","comments":5,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-config-precedence-consistency.md"},{"slug":"pr-agent-config-scope-and-hygiene","title":"Config Scope And Hygiene","description":"Treat configuration as a product surface: make it correct, discoverable, and safe. Practical rules: 1) Document scope/precedence explicitly: If an override is ineffective for certain commands due to caching/initialization order, state that clearly and point users to the effective setting (global config or env var).","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"Configurations","language":"Toml","updated":"2026-08-10","comments":7,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-config-scope-and-hygiene.md"},{"slug":"pr-agent-isolated-deterministic-tests","title":"Isolated, Deterministic Tests","description":"Tests should be deterministic and non-leaky: any test that depends on (or mutates) global state, environment variables, or import-time configuration must isolate that impact and restore it afterward.","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2026-08-10","comments":5,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-isolated-deterministic-tests.md"},{"slug":"pdf-inspector-evidence-gated-heuristics","title":"Evidence-Gated Heuristics","description":"When implementing content extraction/layout algorithms, treat “heuristics” as *probabilistic classifiers*: constrain them with invariants, gate them with evidence, and lock behavior with targeted regression tests.","repository":"firecrawl/pdf-inspector","domain":"app-frameworks","topic":"Algorithms","language":"Rust","updated":"2026-08-09","comments":13,"stars":13696,"raw":"https://awesomereviewers.com/raw/pdf-inspector-evidence-gated-heuristics.md"},{"slug":"container-validate-untrusted-inputs","title":"Validate untrusted inputs","description":"Treat CLI args, config, and IPC payloads as untrusted. Enforce semantic invariants at the boundary, then again during decoding/parsing (defense in depth), and add targeted negative tests.","repository":"apple/container","domain":"orchestration","topic":"Security","language":"Swift","updated":"2026-08-09","comments":6,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-validate-untrusted-inputs.md"},{"slug":"herdr-concurrency-bookkeeping-and-cancel","title":"Concurrency bookkeeping and cancel","description":"When concurrency involves async tasks, cross-thread messaging, or callbacks from other components, prefer *explicit bookkeeping* and *bounded, non-blocking communication* so correctness doesn’t rely on timing.","repository":"ogulcancelik/herdr","domain":"app-frameworks","topic":"Concurrency","language":"Rust","updated":"2026-08-09","comments":6,"stars":26924,"raw":"https://awesomereviewers.com/raw/herdr-concurrency-bookkeeping-and-cancel.md"},{"slug":"herdr-accurate-error-propagation","title":"Accurate Error Propagation","description":"In error-prone paths, do not “pretend success.” Always make the failure mode explicit to callers, and ensure any returned/serialized status reflects what actually happened.","repository":"ogulcancelik/herdr","domain":"app-frameworks","topic":"Error Handling","language":"Rust","updated":"2026-08-09","comments":5,"stars":26924,"raw":"https://awesomereviewers.com/raw/herdr-accurate-error-propagation.md"},{"slug":"herdr-constrain-ui-rule-matching","title":"Constrain UI Rule Matching","description":"When building text-based state detectors (e.g., parsing a live UI/pane), treat each rule like an algorithmic classifier: make matches precise by localizing the search, anchoring invariants, and gating multi-step prompts.","repository":"ogulcancelik/herdr","domain":"app-frameworks","topic":"Algorithms","language":"Toml","updated":"2026-08-09","comments":3,"stars":26924,"raw":"https://awesomereviewers.com/raw/herdr-constrain-ui-rule-matching.md"},{"slug":"herdr-explicit-absence-handling","title":"Explicit Absence Handling","description":"Handle absence/unsupported data explicitly and defensively: return `None` (or a clear error) when a value cannot be produced faithfully, and don’t “auto-fix” by inventing defaults, creating missing prerequisites, or silently dropping problematic entries. This prevents misleading “success” states and subtle contract violations.","repository":"ogulcancelik/herdr","domain":"app-frameworks","topic":"Null Handling","language":"Rust","updated":"2026-08-09","comments":3,"stars":26924,"raw":"https://awesomereviewers.com/raw/herdr-explicit-absence-handling.md"},{"slug":"herdr-precise-selection-logic","title":"Precise Selection Logic","description":"When implementing any selection algorithm (lookup/search/pick-next based on state or identifiers), make the selection rule precise and the state transitions intentional.","repository":"ogulcancelik/herdr","domain":"app-frameworks","topic":"Algorithms","language":"Rust","updated":"2026-08-09","comments":2,"stars":26924,"raw":"https://awesomereviewers.com/raw/herdr-precise-selection-logic.md"},{"slug":"herdr-sanitize-unicode-controls","title":"Sanitize Unicode Controls","description":"Any dynamically generated text that will be displayed (e.g., status/tab text from command output, runtime data, or user/config input) must be sanitized to prevent rendering-based attacks (bidi overrides, zero-width/invisible manipulations).","repository":"ogulcancelik/herdr","domain":"security","topic":"Security","language":"Rust","updated":"2026-08-09","comments":1,"stars":26924,"raw":"https://awesomereviewers.com/raw/herdr-sanitize-unicode-controls.md"},{"slug":"container-error-handling-without-silence","title":"Error handling without silence","description":"Treat errors as first-class: don’t blanket-suppress them with `try?`, `try!`, `_ =` result discards, or `2>/dev/null` unless you can prove the failure is expected and harmless. For unexpected failures, either propagate (`throw`) or explicitly log and recover in a deterministic way.","repository":"apple/container","domain":"orchestration","topic":"Error Handling","language":"Swift","updated":"2026-08-07","comments":13,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-error-handling-without-silence.md"},{"slug":"bmad-method-deterministic-prompt-contracts","title":"Deterministic Prompt Contracts","description":"Write AI prompt/workflow steps as deterministic contracts: remove ambiguity, force required lookups, gate behavior by mode, and make unattended/automation outputs schema-correct.","repository":"bmad-code-org/bmad-method","domain":"ai-agents","topic":"AI","language":"Markdown","updated":"2026-08-07","comments":8,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-deterministic-prompt-contracts.md"},{"slug":"pdf-inspector-optimize-with-correctness","title":"Optimize With Correctness","description":"When optimizing for performance, first determine whether the computation truly depends only on the requested subset or on document-wide/global evidence.","repository":"firecrawl/pdf-inspector","domain":"app-frameworks","topic":"Performance Optimization","language":"Rust","updated":"2026-08-07","comments":2,"stars":13696,"raw":"https://awesomereviewers.com/raw/pdf-inspector-optimize-with-correctness.md"},{"slug":"pdf-inspector-specific-test-coverage","title":"Specific Test Coverage","description":"When tests target a particular guard, ordering, or threshold, ensure the test inputs actually exercise that exact logic (and not an earlier rejection/acceptance). Also pin threshold behavior with both sides.","repository":"firecrawl/pdf-inspector","domain":"app-frameworks","topic":"Testing","language":"Rust","updated":"2026-08-07","comments":2,"stars":13696,"raw":"https://awesomereviewers.com/raw/pdf-inspector-specific-test-coverage.md"},{"slug":"pdf-inspector-consistent-binding-apis","title":"Consistent Binding APIs","description":"When exposing a Rust library through multi-language bindings, treat the binding surface as a single canonical API: mirror the underlying Rust types/surfaces instead of reshaping them differently per client, and ensure exported classes/functions are actually registered so clients can import them.","repository":"firecrawl/pdf-inspector","domain":"app-frameworks","topic":"API","language":"Rust","updated":"2026-08-06","comments":2,"stars":13696,"raw":"https://awesomereviewers.com/raw/pdf-inspector-consistent-binding-apis.md"},{"slug":"codex-security-effective-auth-propagation","title":"Effective Auth Propagation","description":"Security-sensitive behavior must be correct *in the real execution boundary*: resolve the effective security configuration (including profile overrides) and then propagate/enforce it through packaged subprocesses and trust-boundary validations.","repository":"openai/codex-security","domain":"security","topic":"Security","language":"TypeScript","updated":"2026-08-05","comments":6,"stars":9394,"raw":"https://awesomereviewers.com/raw/codex-security-effective-auth-propagation.md"},{"slug":"herdr-effective-config-validation","title":"Effective Config Validation","description":"When configuration has multiple sources (env vars, CLI flags, socket overrides) and/or platform-specific test compilation, treat only the *effective* configuration as authoritative.","repository":"ogulcancelik/herdr","domain":"cloud-infra","topic":"Configurations","language":"Rust","updated":"2026-08-05","comments":3,"stars":26924,"raw":"https://awesomereviewers.com/raw/herdr-effective-config-validation.md"},{"slug":"codex-security-public-api-contract-completeness","title":"Public API Contract Completeness","description":"When adding or extending an API/CLI surface that routes to backend providers, ensure the *public contract* is fully implemented end-to-end and that the payloads you generate for downstream systems are deterministic.","repository":"openai/codex-security","domain":"security","topic":"API","language":"TypeScript","updated":"2026-08-05","comments":2,"stars":9394,"raw":"https://awesomereviewers.com/raw/codex-security-public-api-contract-completeness.md"},{"slug":"aidlc-workflows-deterministic-boundary-modeling","title":"Deterministic Boundary Modeling","description":"When an algorithm’s correctness depends on what “exactly” was bound/parsed/scanned, never rely on lossy representations (timestamps, ambiguous regex slices, quoted/escaped strings, overlapping recursion). Instead:","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Algorithms","language":"TypeScript","updated":"2026-08-04","comments":8,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-deterministic-boundary-modeling.md"},{"slug":"aidlc-workflows-secure-scope-and-input-validation","title":"Secure Scope and Input Validation","description":"All security-relevant authorization/receipt logic must be (1) scope-correct and precondition-correct, and (2) fed only strictly validated/sanitized inputs—especially when values are used to render/parse audit logs, build regexes, or mutate the filesystem.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Security","language":"TypeScript","updated":"2026-08-04","comments":6,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-secure-scope-and-input-validation.md"},{"slug":"aidlc-workflows-single-transaction-locking","title":"Single-Transaction Locking","description":"For any shared mutable system state (receipts/ledgers, stage files + sidecars, and derived artifacts), treat the operation as one transaction: acquire a single shared lock, perform all read/validate/merge/emit/write steps (and any dependent compile/derivation) while holding it, then release.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Concurrency","language":"TypeScript","updated":"2026-08-04","comments":5,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-single-transaction-locking.md"},{"slug":"codex-security-defensive-security-validation","title":"Defensive Security Validation","description":"Apply defensive validation rules anywhere code derives security decisions from paths, filesystem objects, executables, or integrity metadata. Guidelines","repository":"openai/codex-security","domain":"security","topic":"Security","language":"Python","updated":"2026-08-04","comments":5,"stars":9394,"raw":"https://awesomereviewers.com/raw/codex-security-defensive-security-validation.md"},{"slug":"codex-security-error-handling-guardrails","title":"Error Handling Guardrails","description":"Adopt a small set of guardrails for failures so recovery is predictable, repeatable, and doesn’t deadlock or mask outcomes: 1) Classify errors into “retryable” vs “permanent,” then apply a bounded retry budget.","repository":"openai/codex-security","domain":"security","topic":"Error Handling","language":"TypeScript","updated":"2026-08-04","comments":5,"stars":9394,"raw":"https://awesomereviewers.com/raw/codex-security-error-handling-guardrails.md"},{"slug":"codex-security-stream-and-exclude-for-speed","title":"Stream and Exclude for Speed","description":"Optimize scan/diff/hash pipelines by (1) preventing large in-memory buffering and (2) shrinking the input set early. Apply these rules: - Measure first: when changing digest/patch handling, record memory/size deltas on realistic fixtures (e.g., large binary diffs) and use deterministic comparisons (streaming output must match buffered output).","repository":"openai/codex-security","domain":"security","topic":"Performance Optimization","language":"Python","updated":"2026-08-04","comments":2,"stars":9394,"raw":"https://awesomereviewers.com/raw/codex-security-stream-and-exclude-for-speed.md"},{"slug":"codex-security-validate-persisted-selections","title":"Validate persisted selections","description":"When accepting previously recorded state (digests, coverage manifests, etc.), revalidate it against the current computed/authoritative data before proceeding. If the value no longer matches, fail fast with a message that tells the user exactly what to do next. If you tighten validation rules, preserve backward compatibility by versioning the stricter...","repository":"openai/codex-security","domain":"security","topic":"Error Handling","language":"Python","updated":"2026-08-04","comments":2,"stars":9394,"raw":"https://awesomereviewers.com/raw/codex-security-validate-persisted-selections.md"},{"slug":"herdr-optimize-without-guessing","title":"Optimize Without Guessing","description":"When performance-critical code interacts with OS/process state or remote services, optimize by reducing unnecessary work *only when correctness is preserved*.","repository":"ogulcancelik/herdr","domain":"app-frameworks","topic":"Performance Optimization","language":"Rust","updated":"2026-08-04","comments":2,"stars":26924,"raw":"https://awesomereviewers.com/raw/herdr-optimize-without-guessing.md"},{"slug":"aidlc-workflows-secure-by-default-integrations","title":"Secure-by-default integrations","description":"When adding configurable external services/integrations (e.g., registries, MCP servers, plugins), apply security-by-default and supply-chain controls—especially when the integration can access credentials.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Security","language":"Json","updated":"2026-08-04","comments":1,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-secure-by-default-integrations.md"},{"slug":"aidlc-workflows-use-scoped-consistent-names","title":"Use scoped, consistent names","description":"When naming identifiers (results, commands, spaces) in shared systems, make names **unambiguous, consistent, and context-aware**. Apply these rules: 1) **Qualify by namespace/scope to avoid collisions**","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Naming Conventions","language":"TypeScript","updated":"2026-08-03","comments":3,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-use-scoped-consistent-names.md"},{"slug":"agentcore-samples-enforce-boundary-least-privilege","title":"Enforce Boundary Least-Privilege","description":"Security-sensitive controls must be enforced at the boundary (before business logic) and granted with the minimum required scope. Avoid designs where access is only checked after the request reaches handlers or where automation receives broad credentials.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Security","language":"Yaml","updated":"2026-08-03","comments":2,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-enforce-boundary-least-privilege.md"},{"slug":"aidlc-workflows-use-correct-null-semantics","title":"Use Correct Null Semantics","description":"Treat “missing/unknown” differently from “present/true” and from “known false”. Two common pitfalls: 1) CLI flags: frameworks may represent valueless options as the string `\"true\"`, which breaks guards that only check truthiness.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Null Handling","language":"TypeScript","updated":"2026-08-03","comments":2,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-use-correct-null-semantics.md"},{"slug":"container-api-versioning-and-semantics","title":"API Versioning And Semantics","description":"Define and document your public API contract with two guarantees: (1) versioning/compatibility rules, and (2) unambiguous parameter semantics (source of truth and precedence).","repository":"apple/container","domain":"orchestration","topic":"API","language":"Markdown","updated":"2026-08-03","comments":2,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-api-versioning-and-semantics.md"},{"slug":"herdr-consistent-ui-formatting","title":"Consistent UI formatting","description":"When formatting UI text for alignment (padding/truncation like `{position:<N}`), keep the visual rules consistent across all related components and validate against the actual available width. If the change would alter the product’s visual language/layout rules (e.g., needing new rules to display a dot for 100+), treat it as a design/discussion item rather...","repository":"ogulcancelik/herdr","domain":"app-frameworks","topic":"Code Style","language":"Rust","updated":"2026-08-03","comments":2,"stars":26924,"raw":"https://awesomereviewers.com/raw/herdr-consistent-ui-formatting.md"},{"slug":"codex-security-redact-all-logs","title":"Redact All Logs","description":"Security diagnostic output must not leak sensitive data. If you enable verbose modes (e.g., `--verbose`) or change log sinks (stdout vs stderr), ensure (and document) that *all* emitted diagnostic streams are actually redacted.","repository":"openai/codex-security","domain":"security","topic":"Security","language":"Markdown","updated":"2026-08-03","comments":1,"stars":9394,"raw":"https://awesomereviewers.com/raw/codex-security-redact-all-logs.md"},{"slug":"herdr-enforce-sensitive-file-permissions","title":"Enforce Sensitive File Permissions","description":"When creating or updating files that persist user-controlled commands/state for later execution (hooks, observer/session forwarding, etc.), treat the contents as sensitive and enforce least-privilege permissions at install/write time. Verify the permissions in an automated install/integration test so regressions are caught early.","repository":"ogulcancelik/herdr","domain":"security","topic":"Security","language":"Shell","updated":"2026-08-03","comments":1,"stars":26924,"raw":"https://awesomereviewers.com/raw/herdr-enforce-sensitive-file-permissions.md"},{"slug":"pdf-inspector-pin-github-actions","title":"Pin GitHub Actions","description":"In CI/CD workflows, mitigate supply-chain risk by ensuring every `uses:` action (first- and third-party) is pinned to an immutable full commit SHA, not a moving tag/branch. Optionally preserve the intended human version in a trailing comment. Also, set critical inputs explicitly when supported (e.g., toolchain selection) to keep builds deterministic.","repository":"firecrawl/pdf-inspector","domain":"security","topic":"Security","language":"Yaml","updated":"2026-08-03","comments":1,"stars":13696,"raw":"https://awesomereviewers.com/raw/pdf-inspector-pin-github-actions.md"},{"slug":"herdr-behavioral-regression-tests","title":"Behavioral Regression Tests","description":"Write regression tests that (1) are portable across platforms where behavior is shared and (2) are “behaviorally decisive,” meaning they must fail if the real logic is removed.","repository":"ogulcancelik/herdr","domain":"app-frameworks","topic":"Testing","language":"Rust","updated":"2026-08-02","comments":2,"stars":26924,"raw":"https://awesomereviewers.com/raw/herdr-behavioral-regression-tests.md"},{"slug":"openmontage-idempotency-key-normalization","title":"Idempotency key normalization","description":"When implementing caching/idempotency for tools that generate external media, make cache keys stable and semantically accurate. **Rules** 1. **Normalize before hashing:** Resolve optional fields through `input_schema` defaults; treat an explicit `None` as “unset”, so omitted and defaulted inputs produce the same key.","repository":"calesthio/OpenMontage","domain":"app-frameworks","topic":"Caching","language":"Python","updated":"2026-08-01","comments":2,"stars":46544,"raw":"https://awesomereviewers.com/raw/openmontage-idempotency-key-normalization.md"},{"slug":"openmontage-safe-static-parsing","title":"Safe Static Parsing","description":"When parsing configuration or design-token files from external/untrusted sources, never execute their contents as part of scanning. Default to static, deterministic extraction and “fail closed” (e.g., return `null`/empty) when the config requires evaluation.","repository":"calesthio/OpenMontage","domain":"security","topic":"Security","language":"Python","updated":"2026-08-01","comments":1,"stars":46544,"raw":"https://awesomereviewers.com/raw/openmontage-safe-static-parsing.md"},{"slug":"azure-sentinel-use-stable-api-versions","title":"Use Stable API Versions","description":"When defining or calling APIs (including Azure Sentinel/Microsoft Security connector artifacts), always use a stable, supported `apiVersion` and keep it consistent across all related files. Avoid “preview”/older `apiVersion` values unless there is an explicit, documented need.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"API","language":"Json","updated":"2026-07-31","comments":11,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-use-stable-api-versions.md"},{"slug":"mcp-safety-first-documentation","title":"Safety-First Documentation","description":"Any technical documentation that includes operational steps (especially schema changes, data deletion, bucket/table cleanup, or “fix by deleting”) must be both safe and unambiguous.","repository":"awslabs/mcp","domain":"ai-agents","topic":"Documentation","language":"Markdown","updated":"2026-07-31","comments":7,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-safety-first-documentation.md"},{"slug":"mcp-secure-auth-and-secrets","title":"Secure Auth and Secrets","description":"Apply these rules whenever implementing auth, tokens, or security-modes: 1) Never leak tokens/secrets - Don’t print full-privilege tokens to stdout, shell history, CI logs, or transcripts.","repository":"awslabs/mcp","domain":"ai-agents","topic":"Security","language":"Markdown","updated":"2026-07-31","comments":4,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-secure-auth-and-secrets.md"},{"slug":"mcp-accurate-config-guidance","title":"Accurate Config Guidance","description":"When documenting configuration (env vars, parameters, tuning knobs, maintenance windows), ensure the guidance is actionable and operationally accurate—not just descriptive. In particular:","repository":"awslabs/mcp","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2026-07-31","comments":3,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-accurate-config-guidance.md"},{"slug":"mcp-data-model-guardrails","title":"Data model guardrails","description":"Default schemas should be designed for (a) correct capacity/performance assumptions and (b) efficient, queryable storage. 1) Use correct cardinality math for sizing","repository":"awslabs/mcp","domain":"ai-agents","topic":"Database","language":"Markdown","updated":"2026-07-31","comments":3,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-data-model-guardrails.md"},{"slug":"azure-sentinel-deterministic-sorting","title":"Deterministic sorting","description":"When your code builds collections or performs comparisons, normalize inputs to a consistent representation and enforce a deterministic order before iterating/outputting.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Algorithms","language":"Python","updated":"2026-07-31","comments":2,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-deterministic-sorting.md"},{"slug":"pdf-inspector-ecosystem-version-hygiene","title":"Ecosystem Version Hygiene","description":"When automating builds and publishing, apply two rules for version metadata correctness: 1) Keep registry ecosystems independent unless you’re doing an explicit coordinated migration. If crates.io/PyPI/npm/WASM have separate release cadences, don’t force matching numbers across them—bump based on the target registry’s current release state and workflow.","repository":"firecrawl/pdf-inspector","domain":"orchestration","topic":"CI/CD","language":"Toml","updated":"2026-07-31","comments":2,"stars":13696,"raw":"https://awesomereviewers.com/raw/pdf-inspector-ecosystem-version-hygiene.md"},{"slug":"mcp-avoid-silent-error-masking","title":"Avoid silent error masking","description":"Establish a team-wide error-handling contract: 1) Never swallow exceptions in production paths - Avoid bare `except: pass` / broad exception fallbacks that hide the real failure.","repository":"awslabs/mcp","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2026-07-30","comments":14,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-avoid-silent-error-masking.md"},{"slug":"container-optional-safe-null-handling","title":"Optional-Safe Null Handling","description":"Adopt a consistent null/absence policy: 1) Model absence explicitly - If a value may be missing (older on-disk configs, optional server fields, optional UI inputs), represent it with an optional type (e.g., `String?`) and make the corresponding `Codable` field tolerant of omission.","repository":"apple/container","domain":"orchestration","topic":"Null Handling","language":"Swift","updated":"2026-07-30","comments":11,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-optional-safe-null-handling.md"},{"slug":"codex-security-gated-deterministic-releases","title":"Gated deterministic releases","description":"All release/publishing workflows must be deterministic, serialized safely, and strictly gated so that user-facing artifacts are published only after the release candidate has passed the final checks.","repository":"openai/codex-security","domain":"security","topic":"CI/CD","language":"Yaml","updated":"2026-07-30","comments":8,"stars":9394,"raw":"https://awesomereviewers.com/raw/codex-security-gated-deterministic-releases.md"},{"slug":"mcp-document-behavior-accurately","title":"Document Behavior Accurately","description":"Ensure all agent-facing documentation (tool descriptions, docstrings, help text, and auto-enriched descriptions) is factually aligned with the actual implementation and is structured consistently.","repository":"awslabs/mcp","domain":"ai-agents","topic":"Documentation","language":"Python","updated":"2026-07-30","comments":7,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-document-behavior-accurately.md"},{"slug":"mcp-safe-async-resource-handling","title":"Safe Async Resource Handling","description":"Shared resources (connections, clients, caches) must be concurrency-safe across async tool invocations. **Standard** 1. **Validate before publish**: never put a resource into a shared cache/map until it is known-good. This prevents race windows where other coroutines can use an unvalidated handle.","repository":"awslabs/mcp","domain":"ai-agents","topic":"Concurrency","language":"Python","updated":"2026-07-30","comments":7,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-safe-async-resource-handling.md"},{"slug":"last30days-skill-deterministic-failure-semantics","title":"Deterministic Failure Semantics","description":"Treat error handling as deterministic control flow: classify outcomes precisely, set gating flags/budgets before the expensive/remote work, and use those classifications to decide whether to fall back/retry.","repository":"mvanhorn/last30days-skill","domain":"app-frameworks","topic":"Error Handling","language":"Python","updated":"2026-07-30","comments":6,"stars":57799,"raw":"https://awesomereviewers.com/raw/last30days-skill-deterministic-failure-semantics.md"},{"slug":"last30days-skill-sanitize-untrusted-boundaries","title":"Sanitize Untrusted Boundaries","description":"Treat every externally sourced value (API results, URLs, cached artifacts, filesystem-derived error strings, CLI/config inputs) as untrusted at the boundary, and apply **context-specific hardening** before it can be rendered, logged, persisted, or used in a subprocess.","repository":"mvanhorn/last30days-skill","domain":"security","topic":"Security","language":"Python","updated":"2026-07-30","comments":6,"stars":57799,"raw":"https://awesomereviewers.com/raw/last30days-skill-sanitize-untrusted-boundaries.md"},{"slug":"mcp-enforce-resource-caps","title":"Enforce Resource Caps","description":"For MCP/agent tools, aggressively bound both *inputs* and *outputs* and always clean up on timeout/eviction. This prevents runaway memory, long-held locks, LLM context blow-ups, and leaked connections / consumed service concurrency.","repository":"awslabs/mcp","domain":"ai-agents","topic":"Performance Optimization","language":"Python","updated":"2026-07-30","comments":6,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-enforce-resource-caps.md"},{"slug":"mcp-test-isolation-and-assertions","title":"Test isolation and assertions","description":"When code under test uses shared mutable state (module globals, singletons, tool registrations) or introduces new public behaviors, unit tests must (1) assert meaningful outcomes/calls and (2) isolate themselves by resetting/restoring that shared state.","repository":"awslabs/mcp","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2026-07-30","comments":5,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-test-isolation-and-assertions.md"},{"slug":"codex-security-fail-closed-release-security","title":"Fail-Closed Release Security","description":"Any security-sensitive release/publish workflow must be deterministic, run only on trusted code, validate against authoritative data, and fail closed.","repository":"openai/codex-security","domain":"security","topic":"Security","language":"Yaml","updated":"2026-07-30","comments":4,"stars":9394,"raw":"https://awesomereviewers.com/raw/codex-security-fail-closed-release-security.md"},{"slug":"mcp-null-safe-input-normalization","title":"Null-Safe Input Normalization","description":"Always treat nullable/optional fields and parsed payloads as untrusted at boundaries: normalize `None`/missing values to the expected type before iterating/indexing, validate the parsed shape immediately (fail fast with a clear error), and explicitly handle sentinel/unknown states instead of “silently succeeding” with wrong assumptions.","repository":"awslabs/mcp","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2026-07-30","comments":4,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-null-safe-input-normalization.md"},{"slug":"iptv-graceful-stream-validation","title":"Graceful stream validation","description":"When adding or updating playlist entries, treat common failure causes explicitly: validate identifiers and supported URL/source formats up front, and gracefully degrade for expected runtime failures.","repository":"iptv-org/iptv","domain":"app-frameworks","topic":"Error Handling","language":"Other","updated":"2026-07-30","comments":3,"stars":135586,"raw":"https://awesomereviewers.com/raw/iptv-graceful-stream-validation.md"},{"slug":"qwen-code-secure-boundary-enforcement","title":"Secure Boundary Enforcement","description":"Standard: at every trust boundary, enforce security invariants in a way that cannot be skipped by flags, parsing edge cases, alternate code paths, or serialization differences.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2026-07-29","comments":20,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-secure-boundary-enforcement.md"},{"slug":"qwen-code-test-critical-branches","title":"Test critical branches","description":"When code adds/changes behavior (UI logic, URL rewriting, state-merge rules, keyboard/pointer guards, or error-recovery flows), ensure tests cover (1) the behavior itself (not just indirectly), (2) the negative guard cases that prevent regressions, and (3) the full interaction path users trigger.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Testing","language":"TSX","updated":"2026-07-29","comments":20,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-test-critical-branches.md"},{"slug":"azure-sentinel-null-safe-filters","title":"Null-safe Filters","description":"Ensure queries and ASIM parsers handle nullable/optional fields safely by (1) using type-correct null checks, (2) guarding references to optional/missing columns with `column_ifexists` (and using the same guarded form in both `summarize` and `project`), and (3) gating filters/fields that the source cannot provide so they don’t unintentionally exclude all...","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Null Handling","language":"Yaml","updated":"2026-07-29","comments":12,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-null-safe-filters.md"},{"slug":"qwen-code-branch-exact-test-coverage","title":"Branch-Exact Test Coverage","description":"Make workflow/test suites “branch-complete and predicate-exact”: every reachable `case` arm and every required gating condition must be exercised and asserted, with environment-correct shims/guards.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Testing","language":"JavaScript","updated":"2026-07-29","comments":12,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-branch-exact-test-coverage.md"},{"slug":"qwen-code-keep-docs-accurate","title":"Keep Docs Accurate","description":"Adopt a rule that comments/JSDoc/API docs must be both *correct* and *useful at the point of use*—never misleading, stale, or attached to the wrong symbol.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Documentation","language":"TypeScript","updated":"2026-07-29","comments":11,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-keep-docs-accurate.md"},{"slug":"qwen-code-defense-in-depth-security-guardrails","title":"Defense-in-depth Security Guardrails","description":"When handling security-sensitive interactions (authz/ownership, network callbacks, and untrusted execution), apply defense-in-depth at the boundaries: be precise about guarantees, bind authorization to explicit identities at creation time, validate inbound payloads before side effects, and isolate both execution and filesystem writes.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Security","language":"Markdown","updated":"2026-07-29","comments":9,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-defense-in-depth-security-guardrails.md"},{"slug":"qwen-code-consistent-config-gates","title":"Consistent Config Gates","description":"When behavior is driven by config/flags (timeouts, scopes, feature gates, safe-mode), ensure every code path uses the same authoritative inputs and does not silently degrade.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2026-07-29","comments":8,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-consistent-config-gates.md"},{"slug":"qwen-code-contract-driven-workflow-testing","title":"Contract-Driven Workflow Testing","description":"Workflow logic changes can silently ship if tests don’t observe the exact contract your users/ops depend on. Adopt this checklist when writing/modifying tests around GitHub Actions scripts/workflows:","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Testing","language":"Yaml","updated":"2026-07-29","comments":8,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-contract-driven-workflow-testing.md"},{"slug":"qwen-code-avoid-drift-constants","title":"Avoid Drift Constants","description":"When code relies on values or logic that can diverge from the rest of the system (CSS/layout, shared pagination sizes, status-to-UI rules, helper behavior), prefer a single source of truth.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Code Style","language":"TSX","updated":"2026-07-29","comments":7,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-avoid-drift-constants.md"},{"slug":"qwen-code-mutation-effective-testing","title":"Mutation-Effective Testing","description":"Ensure your tests are *mutation-effective*: they must fail when the implementation changes in ways that break intended behavior. Avoid vacuous assertions, and don’t confuse “a test exists” with “the test would catch the real bug.”","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Testing","language":"TypeScript","updated":"2026-07-29","comments":7,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-mutation-effective-testing.md"},{"slug":"azure-sentinel-schema-first-dcr-kql","title":"Schema-First DCR KQL","description":"For data connector definitions (DCR + KQL transforms), treat the DCR `streamDeclarations.columns` as the schema contract and ensure KQL transforms match that contract:","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Database","language":"Json","updated":"2026-07-29","comments":6,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-schema-first-dcr-kql.md"},{"slug":"last30days-skill-distinguish-unknown-values","title":"Distinguish Unknown Values","description":"When data fields can be missing, placeholder, or truly empty, never collapse them into the same falsy value. Explicitly represent and branch on “unknown vs empty” (or verified vs unverified), and avoid `if x:` checks that treat `0`/`\"\"`/`None` equivalently.","repository":"mvanhorn/last30days-skill","domain":"app-frameworks","topic":"Null Handling","language":"Python","updated":"2026-07-29","comments":6,"stars":57799,"raw":"https://awesomereviewers.com/raw/last30days-skill-distinguish-unknown-values.md"},{"slug":"axonhub-consistent-authorization-and-auth","title":"Consistent Authorization and Auth","description":"When changing or adding security-sensitive functionality, keep authorization semantics stable and use project-wide shared validation/auth plumbing. Apply this standard:","repository":"looplj/axonhub","domain":"llm-infra","topic":"Security","language":"Go","updated":"2026-07-29","comments":5,"stars":4808,"raw":"https://awesomereviewers.com/raw/axonhub-consistent-authorization-and-auth.md"},{"slug":"last30days-skill-consistent-guarded-ranking","title":"Consistent, Guarded Ranking","description":"When implementing sorting/ranking or token-based relevance in retrieval pipelines, treat the algorithm as a system with strict contracts: 1) Keep ranking features consistent across stages","repository":"mvanhorn/last30days-skill","domain":"app-frameworks","topic":"Algorithms","language":"Python","updated":"2026-07-29","comments":5,"stars":57799,"raw":"https://awesomereviewers.com/raw/last30days-skill-consistent-guarded-ranking.md"},{"slug":"qwen-code-capability-aware-interface-contracts","title":"Capability-Aware Interface Contracts","description":"When designing client-facing interfaces (request payloads, component props, or render-slot “host action” APIs), treat optional features and host-provided children as contracts—not assumptions.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"API","language":"TSX","updated":"2026-07-29","comments":5,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-capability-aware-interface-contracts.md"},{"slug":"qwen-code-api-call-correctness","title":"API Call Correctness","description":"When automating GitHub (or similar) APIs from CI/workflows, treat API access like production client code: make it correct, complete, and safely reconcilable.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"API","language":"Yaml","updated":"2026-07-29","comments":4,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-api-call-correctness.md"},{"slug":"qwen-code-warn-on-silent-failures","title":"Warn on silent failures","description":"In automation scripts/workflows, never fail or skip important work silently. If a condition decides to omit a capability/flag, or if a command fails with diagnostics discarded or a sentinel fallback is used, emit an explicit warning (or notice) that includes the relevant inputs and captured error output.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Logging","language":"Yaml","updated":"2026-07-29","comments":3,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-warn-on-silent-failures.md"},{"slug":"codex-security-race-safe-concurrency","title":"Race-safe concurrency","description":"When multiple workflow runs mutate or publish to the same shared external resource (labels, registries, “latest”), make synchronization explicit and resource-scoped, and handle conflicts by re-verifying state before proceeding.","repository":"openai/codex-security","domain":"security","topic":"Concurrency","language":"Yaml","updated":"2026-07-29","comments":2,"stars":9394,"raw":"https://awesomereviewers.com/raw/codex-security-race-safe-concurrency.md"},{"slug":"qwen-code-ensure-ci-tested-workflows","title":"Ensure CI-tested Workflows","description":"All CI/CD-related script/workflow tests must be executed in CI, and they must assert the behaviors that matter in production—especially fail-closed security gates and correct step ordering.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"CI/CD","language":"JavaScript","updated":"2026-07-29","comments":2,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-ensure-ci-tested-workflows.md"},{"slug":"qwen-code-fail-safe-error-handling","title":"Fail-safe Error Handling","description":"Use fail-safe error handling everywhere in long-running / retrying flows: cleanup must be guaranteed, state/cursors must follow the intended retry semantics, and errors must remain diagnosable.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2026-07-28","comments":24,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-fail-safe-error-handling.md"},{"slug":"qwen-code-trusted-error-handling","title":"Trusted Error Handling","description":"Use strict, non-silent error handling and evidence gating across CI scripts and publish steps—especially when untrusted inputs and reruns are involved.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Error Handling","language":"Yaml","updated":"2026-07-28","comments":20,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-trusted-error-handling.md"},{"slug":"hermes-agent-doc-accuracy-and-conformance","title":"Doc accuracy and conformance","description":"Require every documentation change to pass two gates: (1) strict doc-schema conformance, and (2) factual/behavioral accuracy against the implementation and shipped artifacts.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Documentation","language":"Markdown","updated":"2026-07-28","comments":18,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-doc-accuracy-and-conformance.md"},{"slug":"hermes-agent-boundary-hardening-rules","title":"Boundary Hardening Rules","description":"Treat every transition from “untrusted / scoped data” into a sensitive sink (shell execution, subprocess credentials, HTTP fetch, filesystem writes, and API-triggered work) as a security seam. Enforce fail-closed policy at that seam:","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Security","language":"Python","updated":"2026-07-28","comments":15,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-boundary-hardening-rules.md"},{"slug":"hermes-agent-nonblocking-concurrency-rules","title":"Nonblocking Concurrency Rules","description":"Establish a single concurrency standard: in async code, never block the event loop; in multi-thread/state-machine code, make ownership and cancellation atomic; and in cleanup/shutdown, use bounded, interrupt-friendly paths.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Concurrency","language":"Python","updated":"2026-07-28","comments":14,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-nonblocking-concurrency-rules.md"},{"slug":"qwen-code-security-invariants-testing","title":"Security Invariants Testing","description":"Treat CI/workflow security like production security code: define explicit invariants, enforce them defensively, and lock them with executable regression tests—especially in workflows that run in privileged contexts (e.g., pull_request_target) or execute untrusted PR code.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Security","language":"Yaml","updated":"2026-07-28","comments":14,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-security-invariants-testing.md"},{"slug":"bmad-method-narrow-catches-log-context","title":"Narrow catches, log context","description":"When handling errors, avoid two failure modes: (a) false-success/zero-signal outcomes and (b) silent data loss. Apply these rules consistently: 1) Fail loudly when correctness is impossible","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Error Handling","language":"JavaScript","updated":"2026-07-28","comments":12,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-narrow-catches-log-context.md"},{"slug":"azure-sentinel-identifier-naming-rules","title":"Identifier Naming Rules","description":"Use a single, deterministic naming scheme for every content identifier, and follow the validator’s allowed formats. Apply these rules: 1) Follow exact format/allowed-value rules for metadata/ids","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Naming Conventions","language":"Json","updated":"2026-07-28","comments":11,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-identifier-naming-rules.md"},{"slug":"qwen-code-single-source-helpers","title":"Single Source Helpers","description":"When code review finds duplicated logic or repeated formatting/constants, treat it as a “single source of truth” violation. Factor shared logic into a helper/module and reuse it everywhere; avoid hardcoded literals where an existing helper/constant exists; and keep established idioms consistent.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2026-07-28","comments":11,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-single-source-helpers.md"},{"slug":"qwen-code-workflow-state-hygiene","title":"Workflow State Hygiene","description":"CI/CD workflows should enforce *state invariants* across steps, runs, and runners: later steps must only execute when earlier phases truly produced a valid outcome, and all per-run state must be cleaned/flushed and permission-safe—especially on persistent self-hosted runners.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"CI/CD","language":"Yaml","updated":"2026-07-28","comments":11,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-workflow-state-hygiene.md"},{"slug":"bifrost-immutable-snapshots-and-gates","title":"Immutable Snapshots And Gates","description":"When concurrency crosses subsystem boundaries (HTTP handlers, streaming, background workers, plugin hooks), treat shared state as immutable and coordinate lifecycle explicitly.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Concurrency","language":"Go","updated":"2026-07-28","comments":10,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-immutable-snapshots-and-gates.md"},{"slug":"goose-accurate-recovery-error-handling","title":"Accurate Recovery Error Handling","description":"Coding standard for recovery/error paths: make failure and recovery behavior truthful, gated, and user-consistent. Apply this rule set: 1) Ground messages and state on authoritative runtime outcomes (avoid predicates/flags that can drift from behavior). If the only way to know is to attempt (e.g., reset/clear), attempt and then report based on the result.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Error Handling","language":"Rust","updated":"2026-07-28","comments":10,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-accurate-recovery-error-handling.md"},{"slug":"goose-explicit-api-contracts","title":"Explicit API Contracts","description":"When API behavior depends on client/provider capabilities, request-field validity, or protocol ordering, implement it via explicit contracts—not heuristics—and ensure the exposed responses match the runtime’s effective configuration.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"API","language":"Rust","updated":"2026-07-28","comments":10,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-explicit-api-contracts.md"},{"slug":"hermes-agent-config-source-alignment","title":"Config source alignment","description":"Behavioral configuration must be documented and wired through the supported config system, with examples matching the actual runtime resolution. Apply these rules:","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2026-07-28","comments":10,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-config-source-alignment.md"},{"slug":"qwen-code-bound-hot-loop-work","title":"Bound Hot-Loop Work","description":"Default to explicit resource budgets and ensure they’re actually enforced. Apply these rules in code review: 1) **Bound inputs and remote pagination**","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Performance Optimization","language":"TypeScript","updated":"2026-07-28","comments":10,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-bound-hot-loop-work.md"},{"slug":"goose-bound-async-waits","title":"Bound async waits","description":"In async/concurrent code, always make cancellation/timeout behavior correct, deterministic, and safe against stale work. **Coding standard** 1) **Bound the full operation**: put `tokio::time::timeout` around the *entire* request/handshake/startup sequence that must not hang (including setup/config/mode steps).","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Concurrency","language":"Rust","updated":"2026-07-28","comments":9,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-bound-async-waits.md"},{"slug":"hermes-agent-behavioral-regression-testing","title":"Behavioral Regression Testing","description":"When adding or modifying tests, favor *behavioral contract* coverage over brittle implementation/shape checks. Apply these rules: - **Test the outcome, not the shape**: drive the code through the real wiring/dispatch path and assert the externally observable behavior (e.g., callback fires once after a cap; command output path rewrites; retry-after falls...","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2026-07-28","comments":9,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-behavioral-regression-testing.md"},{"slug":"mcp-fail-closed-input-sanitization","title":"Fail-Closed Input Sanitization","description":"All externally supplied values must be validated/escaped for the *exact* security-sensitive context they’re interpolated into, and security checks must be fail-closed (no bypass via fallbacks, parse differences, redirects, caches, or policy typos).","repository":"awslabs/mcp","domain":"ai-agents","topic":"Security","language":"Python","updated":"2026-07-28","comments":9,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-fail-closed-input-sanitization.md"},{"slug":"qwen-code-null-safe-parsing","title":"Null-Safe Parsing","description":"Enforce null/optional safety at every boundary: treat external API data and persisted JSON as untrusted, validate before dereferencing, and ensure normalization/parsing preserves only values that satisfy the declared type contract. Never let invalid optional fields “leak through” via `...raw` spreads or falsy-based numeric checks; degraded modes must remain...","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2026-07-28","comments":9,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-null-safe-parsing.md"},{"slug":"qwen-code-correct-dedup-cache-keys","title":"Correct Dedup Cache Keys","description":"When implementing cursor-based dedup/caching for event dispatch, ensure the dedup “key space” matches the real uniqueness of what you’re trying to prevent:","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Caching","language":"TypeScript","updated":"2026-07-28","comments":8,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-correct-dedup-cache-keys.md"},{"slug":"qwen-code-hot-path-efficiency","title":"Hot Path Efficiency","description":"Default to “do the minimum possible work per hot-path update.” Apply these checks: 1) Early-exit before side effects - If a piece of async work is no longer relevant (stale session, unmounted view, toggled-away state), return before starting the network call/timer/observer.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Performance Optimization","language":"TSX","updated":"2026-07-28","comments":8,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-hot-path-efficiency.md"},{"slug":"bifrost-deterministic-db-semantics","title":"Deterministic DB Semantics","description":"Make database changes (queries, migrations, and tests) explicit about shape and semantics: don’t rely on driver defaults, cached plan inference, or “looks right” reads when the DB can mask the truth.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Database","language":"Go","updated":"2026-07-28","comments":7,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-deterministic-db-semantics.md"},{"slug":"hermes-agent-cache-scope-and-keys","title":"Cache Scope and Keys","description":"When adding or modifying caching/deduplication, ensure the cache identity (routing + key + scope) matches the exact contract where reuse is valid. Key rules:","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Caching","language":"Python","updated":"2026-07-28","comments":7,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-cache-scope-and-keys.md"},{"slug":"qwen-code-atomic-exact-run-cancellation","title":"Atomic Exact-Run Cancellation","description":"When implementing concurrent async workflows with callbacks (Stop/Submit/Cancel, permission settlement, card actions), make the operation safe against stale/foreign/parallel events by using atomic identity validation plus a synchronous “claim” before any awaited side effects.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Concurrency","language":"Markdown","updated":"2026-07-28","comments":7,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-atomic-exact-run-cancellation.md"},{"slug":"qwen-code-atomic-reservation-and-recheck","title":"Atomic Reservation And Recheck","description":"When adding concurrency behavior (locks, in-flight guards, timeouts, retries, sampling), ensure three properties: 1) Atomic “check-and-act” before any await (avoid TOCTOU)","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Concurrency","language":"TypeScript","updated":"2026-07-28","comments":7,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-atomic-reservation-and-recheck.md"},{"slug":"qwen-code-scoped-api-contract","title":"Scoped API Contract","description":"When implementing API-facing features, ensure request/response contracts are consistent across all code paths, correctly shaped for the upstream/downstream API, and complete under pagination/time-windowing.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2026-07-28","comments":7,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-scoped-api-contract.md"},{"slug":"azure-sentinel-arm-escape-in-configs","title":"Arm Escape In Configs","description":"When authoring Sentinel solution/connector configuration JSON (especially CCF/CCP connector `*_PollerConfig.json` and embedded/packaged `mainTemplate.json` content templates), treat `[[ ...` as a configuration-time escape—do not “simplify” it.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Configurations","language":"Json","updated":"2026-07-28","comments":6,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-arm-escape-in-configs.md"},{"slug":"bmad-method-normalize-generated-output","title":"Normalize Generated Output","description":"When generating files/metadata, make output deterministic and cross-platform by normalizing both *paths* and *text line endings*, and by keeping shared formatting rules/filters centralized.","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Code Style","language":"JavaScript","updated":"2026-07-28","comments":6,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-normalize-generated-output.md"},{"slug":"qwen-code-action-slot-invariants","title":"Action slot invariants","description":"When building React “action slot” containers (inline vs overflow menus, responsive headers, hold/click controls), enforce these invariants: 1) **Preserve host mount semantics**","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"React","language":"TSX","updated":"2026-07-28","comments":6,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-action-slot-invariants.md"},{"slug":"qwen-code-ci-verification-contracts","title":"CI Verification Contracts","description":"CI/CD verification steps must produce *truthful, reproducible, human-visible* evidence under hard environment constraints (time, filesystem, available tools, git history). Concretely:","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"CI/CD","language":"Markdown","updated":"2026-07-28","comments":6,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-ci-verification-contracts.md"},{"slug":"qwen-code-error-semantics-invariants","title":"Error semantics invariants","description":"When handling failures, treat “what happened” as a precise, testable contract—not an interpretation. Ensure (1) classification predicates are exact and consistent across docs+code, (2) failure causes are not overloaded, (3) cleanup/settlement invariants prevent stranded states, and (4) adapter/step contracts are enforced with safe fallbacks.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Error Handling","language":"Markdown","updated":"2026-07-28","comments":6,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-error-semantics-invariants.md"},{"slug":"qwen-code-sorted-selection-safety","title":"Sorted Selection Safety","description":"When code decides “latest/first/anchor” behavior (events, schedule steps, URL/mention parsing), it must be deterministic by construction: sort inputs by the relevant timestamp/field before using positional selection (e.g., findLast), use dedup keys at the correct granularity to avoid permanent suppression, and make regex/parsers unambiguous with correct...","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Algorithms","language":"TypeScript","updated":"2026-07-28","comments":6,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-sorted-selection-safety.md"},{"slug":"qwen-code-typed-api-contracts","title":"Typed API Contracts","description":"When introducing or changing an API seam (hooks, callback payloads, lifecycle state transitions), require an explicit, end-to-end, type-safe contract that matches implementation and documentation.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"API","language":"Markdown","updated":"2026-07-28","comments":6,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-typed-api-contracts.md"},{"slug":"bifrost-null-semantics-and-safety","title":"Null semantics and safety","description":"Define and enforce null/optional semantics consistently: (1) treat nil/zero/empty/absent as distinct states, (2) clear stale state when nil means “remove”, (3) never rely on plain `interfaceValue != nil` when the underlying value may be a typed-nil pointer, and (4) when using `omitempty`, only set pointer fields when the value is actually present.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Null Handling","language":"Go","updated":"2026-07-28","comments":5,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-null-semantics-and-safety.md"},{"slug":"qwen-code-deterministic-set-reconciliation","title":"Deterministic Set Reconciliation","description":"When you correlate agent outputs, commit history, or prior workflow state across time, avoid fuzzy matching and “best-effort” heuristics. Instead: 1) Associate via stable identifiers (IDs), not text substrings.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Algorithms","language":"Yaml","updated":"2026-07-28","comments":5,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-deterministic-set-reconciliation.md"},{"slug":"azure-sentinel-solution-package-versioning","title":"Solution package versioning","description":"When releasing Sentinel solutions, treat version fields (e.g., `_solutionVersion`) and packaging outputs as contracts with CI/CD validators and external certification/release systems.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"CI/CD","language":"Json","updated":"2026-07-28","comments":4,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-solution-package-versioning.md"},{"slug":"hermes-agent-success-contract-error-handling","title":"Success Contract Error Handling","description":"Define a single “success contract” for each step: only report ok/success if the operation is actually accepted; for optional steps, convert failures into a structured soft-skip (but still record a diagnostic reason).","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Error Handling","language":"Other","updated":"2026-07-28","comments":4,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-success-contract-error-handling.md"},{"slug":"qwen-code-configuration-drift-prevention","title":"Configuration drift prevention","description":"Prevent inconsistencies between configuration sources of truth (build config, extension manifests, and package metadata) that cause IDE/runtime surprises.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Configurations","language":"Json","updated":"2026-07-28","comments":4,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-configuration-drift-prevention.md"},{"slug":"qwen-code-documentation-consistency","title":"Documentation consistency","description":"Documentation and doc-driven instructions must stay truthful and self-consistent with the underlying code and the document’s structure. **Apply this checklist when writing or editing docs/specs/templates:**","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Documentation","language":"Markdown","updated":"2026-07-28","comments":4,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-documentation-consistency.md"},{"slug":"qwen-code-explicit-null-fallbacks","title":"Explicit null fallbacks","description":"When handling `null`/`undefined`, be explicit about intent: - **Choose the correct fallback source**: if a variable is `undefined`, ensure `??` falls back to the intended “truth” (not a stale previous value).","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Null Handling","language":"TSX","updated":"2026-07-28","comments":4,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-explicit-null-fallbacks.md"},{"slug":"qwen-code-guard-async-reentry","title":"Guard Async Reentry","description":"Any UI/logic that performs async work must be resilient to rapid user actions and intermediate async states: prevent re-entry, ensure callbacks use the latest intended state, and avoid losing results/errors when components unmount.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Concurrency","language":"TSX","updated":"2026-07-28","comments":4,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-guard-async-reentry.md"},{"slug":"qwen-code-publish-safe-dependency-ranges","title":"Publish-safe dependency ranges","description":"When CI/CD builds and release automation publish or test packages from a monorepo, inter-workspace dependency specs and lockfile contents must stay publish-safe and CI-consistent.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"CI/CD","language":"Json","updated":"2026-07-28","comments":4,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-publish-safe-dependency-ranges.md"},{"slug":"agentcore-samples-consent-secrets-least-privilege","title":"Consent, Secrets, Least Privilege","description":"Agentic systems that can spend money, handle credentials, or call AWS APIs must enforce three controls: 1) **Require explicit user consent before spending or creating payment sessions**","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Security","language":"Markdown","updated":"2026-07-28","comments":3,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-consent-secrets-least-privilege.md"},{"slug":"axonhub-error-handling-consistency","title":"Error Handling Consistency","description":"When handling failures, make error semantics explicit and consistent across the stack: - Define retryability precisely: only treat errors as retryable when you can guarantee it won’t duplicate already-delivered output (e.g., transport ended before a usable response). Add regression tests for each retry branch (positive + negative cases).","repository":"looplj/axonhub","domain":"llm-infra","topic":"Error Handling","language":"Go","updated":"2026-07-28","comments":3,"stars":4808,"raw":"https://awesomereviewers.com/raw/axonhub-error-handling-consistency.md"},{"slug":"hermes-agent-config-defaults-and-overrides","title":"Config Defaults And Overrides","description":"When introducing or changing configuration options, treat the canonical config defaults and override policy as the single source of truth across runtime and provisioning.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Configurations","language":"Other","updated":"2026-07-28","comments":3,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-config-defaults-and-overrides.md"},{"slug":"qwen-code-minimize-expensive-api-calls","title":"Minimize expensive API calls","description":"When your code depends on GitHub (or other remote) APIs, pagination and per-item mutations are often the dominant performance cost. Structure workflows/scripts to avoid redundant full scans and to prevent N+1 API patterns unless the workload is provably small.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Performance Optimization","language":"Yaml","updated":"2026-07-28","comments":3,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-minimize-expensive-api-calls.md"},{"slug":"qwen-code-single-source-config","title":"Single Source Config","description":"Ensure workflow configuration (env vars, inputs, config lists) has a single authoritative definition and a clearly documented consumer. Apply this when editing GitHub Actions/workflow configs or config-driven automation:","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Configurations","language":"Yaml","updated":"2026-07-28","comments":3,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-single-source-config.md"},{"slug":"goose-api-config-consistency","title":"API Config Consistency","description":"Declarative API/provider configurations must be internally consistent with (a) the canonical identifiers used by the model registry/discovery layer and (b) the request-building logic that actually emits fields for the selected engine/path. This prevents mismatches, silent capability drops, and confusing “it’s configured but doesn’t work” behavior.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"API","language":"Json","updated":"2026-07-28","comments":2,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-api-config-consistency.md"},{"slug":"last30days-skill-cache-scope-and-identity","title":"Cache Scope And Identity","description":"Ensure caching is both lifecycle-correct and identity-safe. - Lifecycle: Cache invalidation/reset must match the intended scope (e.g., “run” not “process”). If long-lived workers exist, reset at deterministic pipeline boundaries (e.g., external pipeline entry) and not in internal sub-runs.","repository":"mvanhorn/last30days-skill","domain":"app-frameworks","topic":"Caching","language":"Python","updated":"2026-07-28","comments":2,"stars":57799,"raw":"https://awesomereviewers.com/raw/last30days-skill-cache-scope-and-identity.md"},{"slug":"last30days-skill-use-atomic-ownership","title":"Use Atomic Ownership","description":"When coordinating concurrent work (threads or processes), make “ownership” explicit and authoritative, and ensure every consumer uses the same claimed/produced result.","repository":"mvanhorn/last30days-skill","domain":"app-frameworks","topic":"Concurrency","language":"Python","updated":"2026-07-28","comments":2,"stars":57799,"raw":"https://awesomereviewers.com/raw/last30days-skill-use-atomic-ownership.md"},{"slug":"qwen-code-deterministic-set-logic","title":"Deterministic Set Logic","description":"When implementing set-based selection/reconciliation algorithms, ensure **(1) deterministic outcomes** and **(2) invariant-preserving persisted state** across runs.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Algorithms","language":"Other","updated":"2026-07-28","comments":2,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-deterministic-set-logic.md"},{"slug":"qwen-code-graceful-failure-handling","title":"Graceful Failure Handling","description":"When an action depends on daemon capabilities or other availability checks, never fail silently or hard-fail the whole UI. Instead: (1) gate capability-dependent parameters/requests so missing capabilities degrade gracefully, and (2) treat dependency outcomes as real failures—don’t return “handled/success” if the operation wasn’t actually performed; surface...","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Error Handling","language":"TSX","updated":"2026-07-28","comments":2,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-graceful-failure-handling.md"},{"slug":"qwen-code-i18n-translation-policy","title":"I18n Translation Policy","description":"Treat every newly added user-facing string key as a documentation/UX contract for all supported locales. When you add `t()` keys: 1) Classify the keys against the project’s translation policy (e.g., `MUST_TRANSLATE_KEYS`).","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Documentation","language":"JavaScript","updated":"2026-07-28","comments":2,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-i18n-translation-policy.md"},{"slug":"qwen-code-validate-configuration-contracts","title":"Validate Configuration Contracts","description":"Configuration docs/examples and runtime behavior must stay aligned, and configuration must be explicit and validated. Apply two rules: 1) **No silent no-ops:** If a config field is accepted by schema/docs, it must actually affect runtime behavior—or be removed from examples and clearly documented as unused/ignored. Add validation/tests that cover example...","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2026-07-28","comments":2,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-validate-configuration-contracts.md"},{"slug":"qwen-code-scrub-tokens-from-urls","title":"Scrub Tokens From URLs","description":"Sensitive authentication tokens must not remain in the browser URL after they are consumed. Tokens in query parameters (`?token=`) will leak via browser history, server access logs, and `Referer` headers when users navigate away; removing URL fragments alone is insufficient if `?token=` is supported.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Security","language":"TSX","updated":"2026-07-28","comments":1,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-scrub-tokens-from-urls.md"},{"slug":"mcp-centralize-shared-utilities","title":"Centralize shared utilities","description":"When code has repeated “plumbing” (string templating/formatting, pagination/envelopes, client setup, session/ctx extraction, embedding serialization, etc.), move it into a shared helper/utility and keep stable imports/constants at module scope. This reduces drift, improves readability, and keeps formatting behavior consistent across tools.","repository":"awslabs/mcp","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2026-07-27","comments":11,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-centralize-shared-utilities.md"},{"slug":"bifrost-prevent-secret-leakage","title":"Prevent Secret Leakage","description":"Apply strict trust boundaries to authentication/credential state: - **Reset per-request sensitive fields on reuse** (especially pooled request/contexts). Never let prior request overrides (keys, base URLs, auth headers) bleed into later requests.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Security","language":"Go","updated":"2026-07-27","comments":10,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-prevent-secret-leakage.md"},{"slug":"hermes-agent-bounded-hot-path-work","title":"Bounded Hot-Path Work","description":"In performance-sensitive hot paths, ensure you (1) don’t repeat expensive work, (2) keep async/event-loop paths non-blocking, (3) bound external operations with finite timeouts, and (4) avoid unnecessary computation/materialization by prefiltering queries and projecting only what’s needed.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Performance Optimization","language":"Python","updated":"2026-07-27","comments":9,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-bounded-hot-path-work.md"},{"slug":"apisix-cache-validity-contracts","title":"Cache Validity Contracts","description":"When caching derived state, you must define (and encode) a validity contract: *what exact changes make the cached data incorrect*, and how that change is detected (keying and/or TTL/refresh).","repository":"apache/apisix","domain":"cloud-infra","topic":"Caching","language":"Other","updated":"2026-07-27","comments":8,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-cache-validity-contracts.md"},{"slug":"bifrost-deterministic-test-hygiene","title":"Deterministic Test Hygiene","description":"Adopt a consistent testing standard that prevents flaky behavior, leaked goroutines, and false positives. **1) Always register cleanup for started resources**","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Testing","language":"Go","updated":"2026-07-27","comments":8,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-deterministic-test-hygiene.md"},{"slug":"qwen-code-robust-error-propagation","title":"Robust error propagation","description":"When handling failures, ensure you (a) don’t lose the real root cause, (b) never introduce new exceptions while trying to report one, and (c) keep graceful degradation both implemented and tested.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Error Handling","language":"JavaScript","updated":"2026-07-27","comments":7,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-robust-error-propagation.md"},{"slug":"azure-powershell-validate-security-inputs","title":"Validate Security Inputs","description":"Apply security validation and gating at the boundaries of security-sensitive behavior: - Validate identifiers and API-version-like parameters during cmdlet/argument binding (e.g., GUIDs, strict date patterns) so malformed inputs can’t flow into authorization/resource construction.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Security","language":"C#","updated":"2026-07-27","comments":6,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-validate-security-inputs.md"},{"slug":"azure-powershell-null-safe-inputs-and-mapping","title":"Null-Safe Inputs And Mapping","description":"When a value is optional (or can differ by feature/region/constructor), never assume it’s present or non-empty. Apply consistent null/empty/whitespace handling, gate context-dependent logic, and validate after any transform (e.g., JSON/model conversion) so missing fields don’t silently change behavior.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Null Handling","language":"C#","updated":"2026-07-27","comments":5,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-null-safe-inputs-and-mapping.md"},{"slug":"goose-deterministic-normalization-predicates","title":"Deterministic normalization predicates","description":"When transforming, sorting, deduplicating, or merging structured data, ensure comparisons use domain-correct semantics and identity signals are preserved.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Algorithms","language":"Rust","updated":"2026-07-27","comments":5,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-deterministic-normalization-predicates.md"},{"slug":"bifrost-null-and-omission-safety","title":"Null and Omission Safety","description":"When a config field is optional/nullable (or has multiple shapes), never rely on “default” or presence quirks. Make absence vs presence explicit, align schema rules with runtime parsing/normalization, and validate the structural inputs that runtime can actually interpret.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Null Handling","language":"Json","updated":"2026-07-27","comments":4,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-null-and-omission-safety.md"},{"slug":"goose-graceful-error-recovery","title":"Graceful Error Recovery","description":"When handling failures in async, remote, or multi-step flows, make the system degrade safely and keep UI/state consistent with what the server actually persisted.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2026-07-27","comments":4,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-graceful-error-recovery.md"},{"slug":"goose-semantic-merges-and-sorts","title":"Semantic merges and sorts","description":"When implementing algorithms that merge incremental updates and compute ordering (grouping/sorting), ensure the algorithm matches the *producer semantics* and uses *semantically correct keys*—don’t rely on heuristic fixes.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Algorithms","language":"TypeScript","updated":"2026-07-27","comments":3,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-semantic-merges-and-sorts.md"},{"slug":"hermes-agent-bounded-consistent-extras","title":"Bounded, Consistent Extras","description":"Whenever you change feature extras or dependency constraints in config (e.g., `pyproject.toml`), apply the same compatible version range everywhere that dependency is installed or resolved, and follow the dependency policy: bounded ranges only (no bare lower bounds; no conflicting exact pins). Regenerate the lockfile after the update.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Configurations","language":"Toml","updated":"2026-07-27","comments":3,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-bounded-consistent-extras.md"},{"slug":"hermes-agent-safe-configuration-handling","title":"Safe Configuration Handling","description":"When configuration affects scripts (env vars, dotenv files, compatibility gates), treat it as serialized input/output and enforce correctness at three points: (1) safe encoding, (2) correct source scoping, and (3) declared bounds.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Configurations","language":"Shell","updated":"2026-07-27","comments":3,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-safe-configuration-handling.md"},{"slug":"pi-harden-auth-and-output","title":"Harden auth and output","description":"Security-sensitive data and sinks must be hardened before use. Concretely: 1) Auth/token validity guarantees - When returning or printing OAuth/bearer tokens, ensure the token is proactively refreshed if it’s close to expiring.","repository":"earendil-works/pi","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2026-07-27","comments":3,"stars":79783,"raw":"https://awesomereviewers.com/raw/pi-harden-auth-and-output.md"},{"slug":"qwen-code-normalize-selection-keys","title":"Normalize selection keys","description":"When selecting a “preferred” item (via `find`, `filter`, pagination anchors, etc.) or deciding based on a computed threshold, ensure two things: 1) **Compare like with like:** normalize/parse inputs so the keys you compare are in the same canonical form.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Algorithms","language":"TSX","updated":"2026-07-27","comments":3,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-normalize-selection-keys.md"},{"slug":"azure-cli-canonical-naming-semantics","title":"Canonical naming semantics","description":"When configuring or referencing named entities, use the *canonical identifier* required by the consuming system and ensure the identifier’s *semantic type* matches what the field expects (e.g., “team” vs “label”). If a system normalizes names, reference the normalized form—not the on-disk/path form—and don’t substitute a label for a team.","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Naming Conventions","language":"Yaml","updated":"2026-07-27","comments":2,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-canonical-naming-semantics.md"},{"slug":"bifrost-explicit-react-ui-behavior","title":"Explicit React UI Behavior","description":"When building React components, make user interaction and lifecycle behavior explicit—particularly for accessibility and ref/state initialization. - Tooltips + disabled controls: If a disabled element can’t receive focus, put the focusable/hoverable semantics on a wrapper inside `TooltipTrigger asChild`, and use conditional `tabIndex` to avoid adding extra...","repository":"maximhq/bifrost","domain":"llm-infra","topic":"React","language":"TSX","updated":"2026-07-27","comments":2,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-explicit-react-ui-behavior.md"},{"slug":"goose-bound-parallel-async-lifecycle","title":"Bound parallel async lifecycle","description":"For any async workflow that fans out (e.g., Promise.all over providers) or mutates shared session state, apply two rules: 1) Bound/cancel all external async work (timeouts must abort the underlying operation, not only the awaiting caller).","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Concurrency","language":"TypeScript","updated":"2026-07-27","comments":2,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-bound-parallel-async-lifecycle.md"},{"slug":"azure-cli-actionable-error-propagation","title":"Actionable Error Propagation","description":"When handling failures, ensure your code (a) raises the right exception to control exit code/automation, (b) doesn’t silently ignore user intent or skip required checks, and (c) produces parameter-aware, actionable messages.","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Error Handling","language":"Python","updated":"2026-07-26","comments":18,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-actionable-error-propagation.md"},{"slug":"azure-cli-secure-untrusted-boundaries","title":"Secure Untrusted Boundaries","description":"When code crosses security boundaries (subprocess/PowerShell execution, network URLs, filesystem writes, or auth/TLS), treat user/environment input as untrusted and enforce safety rules:","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Security","language":"Python","updated":"2026-07-26","comments":8,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-secure-untrusted-boundaries.md"},{"slug":"azure-cli-scoped-accurate-warning-logs","title":"Scoped, Accurate Warning Logs","description":"When adding warnings/logs, treat them as part of the user experience: only emit warnings when they are actionable, accurate, and non-noisy—especially when runtime feature detection changes behavior.","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Logging","language":"Python","updated":"2026-07-26","comments":7,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-scoped-accurate-warning-logs.md"},{"slug":"bifrost-semantic-naming-consistency","title":"Semantic Naming Consistency","description":"Adopt naming rules that accurately reflect meaning, routing behavior, and established codebase conventions. Apply these checks when adding/changing code:","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Naming Conventions","language":"Go","updated":"2026-07-26","comments":6,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-semantic-naming-consistency.md"},{"slug":"iptv-validate-tvg-id-in-database","title":"Validate tvg-id In Database","description":"Whenever you edit an M3U/M3U8 playlist entry with a `#EXTINF` line, ensure the `tvg-id` is consistent with the canonical channel database. If the `tvg-id` you intend to use does not exist in the database, either (a) leave `tvg-id` empty to avoid invalid metadata, or (b) submit/add the missing channel to the database first. Also, don’t assume one feed...","repository":"iptv-org/iptv","domain":"data-systems","topic":"Database","language":"Other","updated":"2026-07-26","comments":5,"stars":135586,"raw":"https://awesomereviewers.com/raw/iptv-validate-tvg-id-in-database.md"},{"slug":"qwen-code-evidence-grade-testing","title":"Evidence-grade Testing","description":"When adding or updating test/verification logic, treat the harness setup as part of the test and ensure the evidence is causally attributable and non-vacuous.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Testing","language":"Markdown","updated":"2026-07-26","comments":5,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-evidence-grade-testing.md"},{"slug":"qwen-code-concurrency-synchronization-rules","title":"Concurrency synchronization rules","description":"Design GitHub Actions concurrency so overlapping runs can’t corrupt multi-step outcomes. Rules: 1) Don’t assume `concurrency` is a durable multi-stage queue. If stage A and stage B must be serialized as one logical transaction, either:","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Concurrency","language":"Yaml","updated":"2026-07-26","comments":4,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-concurrency-synchronization-rules.md"},{"slug":"qwen-code-fail-closed-security-hygiene","title":"Fail-Closed Security Hygiene","description":"Security gates and cleanup must be *fail-closed* and *boundary-proven*. Apply these rules when implementing/adjusting secure workflows: 1) **Authorization must not degrade**","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Security","language":"JavaScript","updated":"2026-07-26","comments":4,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-fail-closed-security-hygiene.md"},{"slug":"goose-resilient-ui-failure-handling","title":"Resilient UI Failure Handling","description":"Make UI behavior robust to failure scenarios by aligning (a) what you validate, (b) what you treat as success, and (c) how state is updated when partial failures happen.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Error Handling","language":"TSX","updated":"2026-07-26","comments":3,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-resilient-ui-failure-handling.md"},{"slug":"goose-versioned-cache-coherence","title":"Versioned cache coherence","description":"When a cache is invalidated asynchronously, ensure *coherence* between (a) the invalidation/version signal and (b) the cached payload/derived artifacts.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Caching","language":"Rust","updated":"2026-07-26","comments":3,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-versioned-cache-coherence.md"},{"slug":"bifrost-concurrency-safe-retries","title":"Concurrency-safe retries","description":"When concurrency is involved, ensure two things: (1) your tests/operations can’t accidentally contend on shared resources, and (2) any concurrency-handling you add (e.g., retrying on 409) is only applied to errors that are truly reachable from the concurrent scenario you’re mitigating.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Concurrency","language":"TypeScript","updated":"2026-07-26","comments":2,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-concurrency-safe-retries.md"},{"slug":"bifrost-deterministic-test-setupteardown","title":"Deterministic test setup/teardown","description":"E2E tests should be deterministic by (1) registering mocks/fixtures before any action that triggers network calls (e.g., `goto()`), and (2) handling cleanup failures in a way that doesn’t skip subsequent tests/hooks.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Testing","language":"TypeScript","updated":"2026-07-26","comments":2,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-deterministic-test-setupteardown.md"},{"slug":"bifrost-prefer-safe-tag-invalidation","title":"Prefer safe tag invalidation","description":"When a server mutation (e.g., model discovery refresh) changes data that feeds multiple cached selectors/queries, use RTK Query tag invalidation to refresh all dependent caches—especially indirect ones.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Caching","language":"TypeScript","updated":"2026-07-26","comments":2,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-prefer-safe-tag-invalidation.md"},{"slug":"goose-use-width-safe-strings","title":"Use width-safe strings","description":"When implementing string operations that depend on the environment (terminal/UI rendering or filesystem paths), avoid naive `.length`/single-separator logic. Use algorithms that are correct for Unicode/code points and for the actual width/splitting rules of the runtime.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Algorithms","language":"TSX","updated":"2026-07-26","comments":2,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-use-width-safe-strings.md"},{"slug":"herdr-consistent-event-contracts","title":"Consistent Event Contracts","description":"When a single user action or state transition can be reached via multiple entrypoints (e.g., tab close vs workspace close), the externally observable behavior (especially emitted events) must be consistent with the actual underlying changes.","repository":"ogulcancelik/herdr","domain":"app-frameworks","topic":"API","language":"Rust","updated":"2026-07-26","comments":2,"stars":26924,"raw":"https://awesomereviewers.com/raw/herdr-consistent-event-contracts.md"},{"slug":"last30days-skill-behavioral-ci-workflow-tests","title":"Behavioral CI workflow tests","description":"CI/CD workflow and release-automation checks must be deterministic and behavior-based. - Never “soft-skip” critical validations due to missing dev tooling; declare the needed test dependency (e.g., YAML parser) so the check always runs in CI.","repository":"mvanhorn/last30days-skill","domain":"orchestration","topic":"CI/CD","language":"Python","updated":"2026-07-25","comments":3,"stars":57799,"raw":"https://awesomereviewers.com/raw/last30days-skill-behavioral-ci-workflow-tests.md"},{"slug":"aidlc-workflows-behavior-correct-versionless-docs","title":"Behavior-Correct, Versionless Docs","description":"Documentation and inline comments should be (1) strictly aligned with what the code actually does and (2) resilient to future version bumps. Actionable standards:","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Documentation","language":"TypeScript","updated":"2026-07-25","comments":2,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-behavior-correct-versionless-docs.md"},{"slug":"azure-cli-deterministic-recorded-testing","title":"Deterministic recorded testing","description":"For scenario/recording tests, keep behavior deterministic between record and replay, and ensure assertions cover defaults, required inputs, and optional fields.","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Testing","language":"Python","updated":"2026-07-24","comments":8,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-deterministic-recorded-testing.md"},{"slug":"goose-normalize-missing-values","title":"Normalize Missing Values","description":"When handling optional/missing inputs, **normalize and guard early** so “missing” can’t accidentally become a real value or clobber existing state. Rules:","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Null Handling","language":"Rust","updated":"2026-07-24","comments":6,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-normalize-missing-values.md"},{"slug":"azure-powershell-cicd-build-artifact-rules","title":"CI/CD Build Artifact Rules","description":"Treat autogenerated content as build artifacts owned by CI/CD, and handle breaking changes through the release system (not ad-hoc edits). Do: - Edit the source-of-truth inputs (e.g., custom folder content and autorest README.md/autorest configuration) and place human-authored examples under the dedicated “examples” directory.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"CI/CD","language":"Markdown","updated":"2026-07-24","comments":5,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-cicd-build-artifact-rules.md"},{"slug":"azure-powershell-generated-artifacts-in-ci","title":"Generated Artifacts in CI","description":"Treat anything under build/generated locations (including auto-generated test stubs and generated module mirrors) as write-protected CI outputs: update only the custom source files / AutoRest config / build inputs, not the generated artifacts themselves. When CI tests fail due to missing environment (e.g., Azure context/SubscriptionId in playback),...","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"CI/CD","language":"Other","updated":"2026-07-24","comments":5,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-generated-artifacts-in-ci.md"},{"slug":"container-dns-and-timeout-rules","title":"DNS and Timeout Rules","description":"When implementing networking features (DNS, proxies, RPC/XPC), make behavior consistent with the correct layer and avoid imposing policy that breaks end-to-end semantics.","repository":"apple/container","domain":"orchestration","topic":"Networking","language":"Swift","updated":"2026-07-24","comments":4,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-dns-and-timeout-rules.md"},{"slug":"goose-null-safe-early-guards","title":"Null-safe early Guards","description":"Always handle nullable/optional state explicitly before executing logic that can mutate state, clear user input, or drop data. Use early returns or dedicated “disabled” props driven by well-defined nullable/flag conditions, and preserve intentional empty values instead of treating all falsy/empty inputs as “missing.”","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2026-07-24","comments":4,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-null-safe-early-guards.md"},{"slug":"last30days-skill-deterministic-release-gating","title":"Deterministic Release Gating","description":"When automating CI/CD releases, make “release vs non-release” and downstream publishing deterministic by (1) gating on explicit signals and (2) explicitly triggering the next workflow step.","repository":"mvanhorn/last30days-skill","domain":"orchestration","topic":"CI/CD","language":"Yaml","updated":"2026-07-24","comments":2,"stars":57799,"raw":"https://awesomereviewers.com/raw/last30days-skill-deterministic-release-gating.md"},{"slug":"last30days-skill-secure-actions-inputs","title":"Secure Actions Inputs","description":"In GitHub Actions, treat workflow inputs/expressions as potentially unsafe and follow two rules: (1) avoid interpolating `${{ ... }}` directly inside shell-script logic, and (2) do not persist Git credentials from `checkout`; instead, scope tokens to only the step that needs to push.","repository":"mvanhorn/last30days-skill","domain":"security","topic":"Security","language":"Yaml","updated":"2026-07-24","comments":2,"stars":57799,"raw":"https://awesomereviewers.com/raw/last30days-skill-secure-actions-inputs.md"},{"slug":"omniroute-explicit-undefined-handling","title":"Explicit Undefined Handling","description":"When a value is intentionally absent (e.g., an optional callback prop or required classification fields), represent that absence explicitly and don’t let missing/nullable data silently pass as “valid”.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Null Handling","language":"TSX","updated":"2026-07-24","comments":2,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-explicit-undefined-handling.md"},{"slug":"bifrost-bounded-targeted-performance","title":"Bounded, Targeted Performance","description":"When optimizing performance, avoid whole-object work and unbounded resource growth. Apply these standards: 1) Targeted extraction/rewrites (no full parsing)","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Performance Optimization","language":"Go","updated":"2026-07-23","comments":8,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-bounded-targeted-performance.md"},{"slug":"bifrost-preserve-aggregation-invariants","title":"Preserve Aggregation Invariants","description":"When transforming/aggregating streamed or ranged data, explicitly define the invariants your algorithm depends on (index meaning, ownership/copy semantics, boundary semantics, and ordering), then implement collision- and edge-case-safe logic with targeted tests.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Algorithms","language":"Go","updated":"2026-07-23","comments":8,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-preserve-aggregation-invariants.md"},{"slug":"container-avoid-repeated-hot-path-work","title":"Avoid repeated hot-path work","description":"In performance-sensitive code, avoid doing expensive operations repeatedly inside loops (repeated flattening/sorting, repeated filesystem attribute resolution, repeated regex/compiler/formatter construction, repeated list+search scans). Also ensure your tree/hierarchy logic uses consistent keys for both ordering and relationship detection.","repository":"apple/container","domain":"orchestration","topic":"Performance Optimization","language":"Swift","updated":"2026-07-23","comments":7,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-avoid-repeated-hot-path-work.md"},{"slug":"azure-powershell-explicit-null-safety-checks","title":"Explicit Null Safety Checks","description":"Ensure null-safety is precise: guard against $null *and* empty results *and* blank strings (including blank entries inside arrays/hashtables). Also treat “omitted optional/switch parameters” as meaningful (absence != explicit value), and structure conditions so short-circuiting prevents null dereferences.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Null Handling","language":"Other","updated":"2026-07-23","comments":5,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-explicit-null-safety-checks.md"},{"slug":"goose-canonicalize-and-disambiguate-identifiers","title":"Canonicalize and Disambiguate Identifiers","description":"Ensure every place that *stores, looks up, validates, or returns* provider/model/function identifiers uses a clear internal naming contract: - **Canonicalize before lookup:** strip known version/date/suffix patterns from externally supplied model ids before querying registries (so variants like `-latest`, `-0709`, or Bedrock `-vN(:M)?` resolve to the same...","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Naming Conventions","language":"Rust","updated":"2026-07-23","comments":5,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-canonicalize-and-disambiguate-identifiers.md"},{"slug":"agentcore-samples-config-source-alignment","title":"Config source alignment","description":"When using configuration via `.env`/config files, make the notebook’s behavior match what the docs and environment files claim—and ensure fresh environments can run the notebook reliably.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Configurations","language":"Other","updated":"2026-07-23","comments":4,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-config-source-alignment.md"},{"slug":"qwen-code-enforce-policy-parity","title":"Enforce Policy Parity","description":"When changing CI routing/guardrails (workflows, CODEOWNERS, rulesets), ensure the *policy intent* is still enforced in the same way. **Standard** 1) **Never replace enforced approvals with “request reviewers”**: reviewer requests do not block merges. If your repo relies on `require_code_owner_review: true`, keep CODEOWNERS entries (or explicitly update the...","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"CI/CD","language":"Other","updated":"2026-07-23","comments":4,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-enforce-policy-parity.md"},{"slug":"agentcore-samples-consistent-env-config","title":"Consistent env config","description":"For scripts and tests, load configuration consistently and safely, and make any expensive/external prerequisite behavior opt-in. Apply these rules: 1) Source the same env file(s) across related scripts (deploy/destroy/test) with a guarded “missing file” behavior.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Configurations","language":"Shell","updated":"2026-07-23","comments":3,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-consistent-env-config.md"},{"slug":"agentcore-samples-idempotent-safe-errors","title":"Idempotent, Safe Errors","description":"Handle errors in a way that (a) doesn’t hide real bugs, (b) supports reruns after interruptions, and (c) degrades gracefully when data/operations are incomplete.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2026-07-23","comments":3,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-idempotent-safe-errors.md"},{"slug":"pi-null-safe-value-handling","title":"Null-safe value handling","description":"Make null/undefined (and “invalid/unknown”) states explicit and prevent them from flowing into non-null/non-optional operations. Apply these rules: 1) Enforce compiler null safety: enable `strictNullChecks` so the typechecker blocks `x?.foo()`/`x.foo()` on `string | null`-like values.","repository":"earendil-works/pi","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2026-07-23","comments":3,"stars":79783,"raw":"https://awesomereviewers.com/raw/pi-null-safe-value-handling.md"},{"slug":"qwen-code-test-regex-alternations","title":"Test regex alternations","description":"When unit tests depend on filename/path classification via regex (e.g., routing maintainers, detecting test files), add explicit test cases that exercise *every alternation token and mapping entry* in the regex/table. Uncovered alternations can fail silently if someone introduces a typo or refactors part of the pattern.","repository":"QwenLM/qwen-code","domain":"ai-agents","topic":"Testing","language":"Other","updated":"2026-07-23","comments":2,"stars":26407,"raw":"https://awesomereviewers.com/raw/qwen-code-test-regex-alternations.md"},{"slug":"agentcore-samples-ignore-secrets-in-images","title":"Ignore secrets in images","description":"When building container images, never copy the entire build context blindly. Add a `.dockerignore` (and/or use targeted `COPY` paths) to ensure sensitive files and local artifacts can’t be baked into the image—especially when using `COPY . .`.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Security","language":"Dockerfile","updated":"2026-07-23","comments":1,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-ignore-secrets-in-images.md"},{"slug":"agentcore-samples-least-privilege-secret-scoping","title":"Least-privilege secret scoping","description":"When granting IAM access to Secrets Manager, avoid broad resource wildcards (e.g., `arn:aws:secretsmanager:...:secret:*`). Prefer narrowing by the exact secret ARN(s) or by a well-known secret-name prefix for the specific service/feature. Also remove redundant policy constraints that don’t add additional security beyond what the ARN already enforces.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Security","language":"Shell","updated":"2026-07-23","comments":1,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-least-privilege-secret-scoping.md"},{"slug":"bmad-method-contract-first-documentation","title":"Contract-First Documentation","description":"All documentation should behave like an interface: precise contracts, unambiguous rule precedence, and resilient references. Apply this standard by:","repository":"bmad-code-org/bmad-method","domain":"docs","topic":"Documentation","language":"Markdown","updated":"2026-07-22","comments":9,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-contract-first-documentation.md"},{"slug":"mcp-credential-aware-caching","title":"Credential-Aware Caching","description":"When caching heavyweight clients or connections, treat authentication identity (tokens/secret_arn/derived ARN) as part of cache correctness—not just cache performance.","repository":"awslabs/mcp","domain":"ai-agents","topic":"Caching","language":"Python","updated":"2026-07-22","comments":6,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-credential-aware-caching.md"},{"slug":"bifrost-stable-backward-compatible-migrations","title":"Stable Backward-Compatible Migrations","description":"When adding schema/config fields, design migrations to be stable across upgrade/downgrade boundaries: - Handle “unset vs default” explicitly in config-store: store a sentinel/unset value (commonly `0`), ensure getters apply the real default (e.g., 15), and ensure config hashing only incorporates the field when it is explicitly set (non-zero). Add a test...","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Migrations","language":"Go","updated":"2026-07-22","comments":5,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-stable-backward-compatible-migrations.md"},{"slug":"bmad-method-treat-inputs-as-untrusted","title":"Treat Inputs as Untrusted","description":"Apply a consistent security posture to every workflow/prompt-controlled value and to any derived content that will be rendered or linked: 1) Validate untrusted paths *before* cleanup/normalization","repository":"bmad-code-org/bmad-method","domain":"security","topic":"Security","language":"Markdown","updated":"2026-07-22","comments":5,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-treat-inputs-as-untrusted.md"},{"slug":"goose-explicit-null-semantics","title":"Explicit Null Semantics","description":"When handling optional/nullable values in TypeScript/React, make “unset/default” distinct from “legitimate empty/zero” and avoid truthiness-based guards.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Null Handling","language":"TSX","updated":"2026-07-22","comments":4,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-explicit-null-semantics.md"},{"slug":"goose-context-aware-react-state","title":"Context-aware React State","description":"In React components, make UI state transitions and DOM identity depend on the *current* rendered context (route/view/filter) and the *current component instance*. This prevents stale navigation, incorrect optimistic updates, and broken label/control associations.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"React","language":"TSX","updated":"2026-07-22","comments":3,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-context-aware-react-state.md"},{"slug":"axonhub-semantic-merge-and-deep-copy","title":"Semantic Merge And Deep Copy","description":"When your code incrementally merges or inherits structured data (JSON payloads, rule trees, settings), correctness should be enforced by (a) semantic, lossless reconciliation and (b) deep-copying every nested mutable component.","repository":"looplj/axonhub","domain":"llm-infra","topic":"Algorithms","language":"Go","updated":"2026-07-22","comments":2,"stars":4808,"raw":"https://awesomereviewers.com/raw/axonhub-semantic-merge-and-deep-copy.md"},{"slug":"bmad-method-single-writer-parallel-join","title":"Single-writer parallel join","description":"When using concurrency/parallel subagents, enforce synchronization and determinism: 1) Parallelize independent work - Start independent steps concurrently (e.g., multiple subagents), each operating on immutable inputs.","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Concurrency","language":"Markdown","updated":"2026-07-22","comments":2,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-single-writer-parallel-join.md"},{"slug":"container-deterministic-integration-tests","title":"Deterministic Integration Tests","description":"When modifying integration-test execution or environment setup, prioritize determinism and behavioral equivalence. 1) Don’t assume test-runner flags are interchangeable","repository":"apple/container","domain":"orchestration","topic":"Testing","language":"Other","updated":"2026-07-22","comments":2,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-deterministic-integration-tests.md"},{"slug":"pi-minimize-resource-churn","title":"Minimize Resource Churn","description":"Prefer designs that avoid unnecessary resource usage—especially filesystem churn and redundant persistence/reload. - For temporary artifacts, use the OS-managed temp directory (so cleanup is automatic) rather than creating long-lived app-specific temp folders.","repository":"earendil-works/pi","domain":"ai-agents","topic":"Performance Optimization","language":"TypeScript","updated":"2026-07-22","comments":2,"stars":79783,"raw":"https://awesomereviewers.com/raw/pi-minimize-resource-churn.md"},{"slug":"bmad-method-file-based-command-safety","title":"File-Based Command Safety","description":"When invoking CLI/shell or external tools, treat all generated/ingested content (LLM output, web research, imported facts) as untrusted and never embed it directly into command-line strings.","repository":"bmad-code-org/bmad-method","domain":"security","topic":"Security","language":"Toml","updated":"2026-07-22","comments":1,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-file-based-command-safety.md"},{"slug":"apisix-accurate-semantic-naming","title":"Accurate Semantic Naming","description":"Use names that reflect the external meaning and documented behavior—not internal implementation details or misleading assumptions. **Rules** 1. **Match the public/schema concept**: For headers, config flags, schema fields, provider values, and any user-visible identifiers, use names aligned to the schema wording and intent (avoid internal library terms).","repository":"apache/apisix","domain":"cloud-infra","topic":"Naming Conventions","language":"Other","updated":"2026-07-21","comments":8,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-accurate-semantic-naming.md"},{"slug":"azure-sentinel-document-packaging-conventions","title":"Document Packaging Conventions","description":"When updating Sentinel solution documentation artifacts (workbooks metadata, UI definitions, and connector table schemas), treat them as schema- and regeneration-driven. Ensure values match platform conventions and that any generated text will be correct after regeneration.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Documentation","language":"Json","updated":"2026-07-21","comments":7,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-document-packaging-conventions.md"},{"slug":"azure-sentinel-null-safety-patterns","title":"Null Safety Patterns","description":"When fields or parameters are optional (may be missing, null, or empty-string), code must be defensive so queries/playbooks/parsers don’t fail and so “unknown” stays unknown.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Null Handling","language":"Json","updated":"2026-07-21","comments":7,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-null-safety-patterns.md"},{"slug":"azure-sentinel-stable-scoped-query-outputs","title":"Stable, Scoped Query Outputs","description":"When writing KQL for Sentinel (parsers, analytic rules, hunts), make\\ \\ query outputs and intermediate datasets stable and correct: \\n\\n- Prefer **explicit\\ \\ `project`** of the expected/normalized columns (avoid `project-away`) so newly\\ \\ added source columns won’t change the published schema.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Database","language":"Yaml","updated":"2026-07-21","comments":7,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-stable-scoped-query-outputs.md"},{"slug":"bifrost-preserve-api-contracts","title":"Preserve API Contracts","description":"Maintain deterministic, provider-compatible API contracts by (1) applying overrides explicitly and attempt-scoped (no hidden side effects), and (2) preserving exact request/response serialization expectations—especially where providers are sensitive to JSON schema structure/order or where passthrough/raw modes must not be rewritten.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"API","language":"Go","updated":"2026-07-21","comments":7,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-preserve-api-contracts.md"},{"slug":"bifrost-backend-enforcement-ui-validation","title":"Backend Enforcement, UI Validation","description":"Treat the frontend as an *UX layer*, not an authorization or confidentiality enforcement boundary. Any access control (licensing, revoke/re-auth, hidden-content guarantees, RBAC) must be enforced by the backend/data layer; the UI may be redundant or fail-open without granting access. Separately, whenever the UI must render untrusted values into...","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Security","language":"TSX","updated":"2026-07-21","comments":5,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-backend-enforcement-ui-validation.md"},{"slug":"pi-respect-config-precedence","title":"Respect config precedence","description":"When configuration can vary by user/environment, resolve it deterministically (following documented precedence), keep it configurable instead of hardcoded, and apply it dynamically if it may change at runtime.","repository":"earendil-works/pi","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2026-07-21","comments":5,"stars":79783,"raw":"https://awesomereviewers.com/raw/pi-respect-config-precedence.md"},{"slug":"pi-spec-driven-parsing","title":"Spec-Driven Parsing","description":"For any code that parses/normalizes strings or aggregates structured events, require deterministic, complete, and bounded logic: - **Complete inputs:** When computing stats/metrics, include every event type that can contribute (including newly added variants like tool/compaction usage, memory, etc.).","repository":"earendil-works/pi","domain":"ai-agents","topic":"Algorithms","language":"TypeScript","updated":"2026-07-21","comments":4,"stars":79783,"raw":"https://awesomereviewers.com/raw/pi-spec-driven-parsing.md"},{"slug":"axonhub-explicit-config-overrides","title":"Explicit Config Overrides","description":"Implement configuration in a way that is predictable: define defaults centrally, keep early rollout scope narrow (prefer deployment-level defaults), and make override semantics explicit.","repository":"looplj/axonhub","domain":"llm-infra","topic":"Configurations","language":"Go","updated":"2026-07-21","comments":3,"stars":4808,"raw":"https://awesomereviewers.com/raw/axonhub-explicit-config-overrides.md"},{"slug":"azure-sentinel-portable-network-identity","title":"Portable network identity","description":"When implementing networking-related configuration or telemetry parsing, avoid brittle assumptions about IP/host formats and instead use portable defaults plus canonical resolution.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Networking","language":"Yaml","updated":"2026-07-21","comments":3,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-portable-network-identity.md"},{"slug":"pi-explicit-failure-state-machine","title":"Explicit failure state machine","description":"When code has multi-step lifecycle operations (spawn/register/sync/stop) or user/config-driven behavior, make failures explicit and recoverable: model the lifecycle with a small state machine, track which resources were acquired so teardown can always run safely in reverse, and degrade gracefully with validated fallbacks and user-visible diagnostics. Also...","repository":"earendil-works/pi","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2026-07-21","comments":3,"stars":79783,"raw":"https://awesomereviewers.com/raw/pi-explicit-failure-state-machine.md"},{"slug":"bifrost-graceful-config-validation","title":"Graceful config validation","description":"When configuration has conditional dependencies, make the system fail fast only for cases that break invariants (correctness/safety), but allow secure graceful degradation for “optional feature” toggles when prerequisites may be missing.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Error Handling","language":"Json","updated":"2026-07-21","comments":2,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-graceful-config-validation.md"},{"slug":"bifrost-strict-auth-schema-validation","title":"Strict auth schema validation","description":"Security-related Helm/config schemas should fail fast on invalid or unintended authentication settings. Apply: - Close security-sensitive objects with `additionalProperties: false` so typos/mistyped fields are rejected at `helm template`/validation time (instead of silently producing insecure runtime behavior).","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Security","language":"Json","updated":"2026-07-21","comments":2,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-strict-auth-schema-validation.md"},{"slug":"hermes-agent-collision-safe-identifier-mapping","title":"Collision-Safe Identifier Mapping","description":"Treat every identifier (tool name, command name, provider slug, theme name, thread key) as a runtime contract: you must generate, transform, and resolve it consistently, and preserve an unambiguous mapping between any emitted/sanitized UI value and the backend identity.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Naming Conventions","language":"Python","updated":"2026-07-20","comments":11,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-collision-safe-identifier-mapping.md"},{"slug":"hermes-agent-use-null-safe-config-reads","title":"Use Null-Safe Config Reads","description":"Treat every potentially-null/nullable config subsection and external payload field as untrusted: normalize it before accessing deeper keys or calling methods.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2026-07-20","comments":9,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-use-null-safe-config-reads.md"},{"slug":"mcp-accurate-api-contracts","title":"Accurate API Contracts","description":"For API/tool-facing code, treat the external API contract as non-negotiable: validate parameter bounds against the upstream model/docs, handle pagination only when the API is actually paginated, and ensure your client/tool surface (operation routing, errors, and side-effect metadata) is explicit and consistent.","repository":"awslabs/mcp","domain":"ai-agents","topic":"API","language":"Python","updated":"2026-07-20","comments":9,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-accurate-api-contracts.md"},{"slug":"bifrost-stability-first-caching","title":"Stability-First Caching","description":"When caching affects externally visible payloads (prompts, auth/JWT inputs, token summaries), ensure the *serialized representation used for cache identity is deterministic* and the cache has an *explicit validity boundary*.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Caching","language":"Go","updated":"2026-07-20","comments":7,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-stability-first-caching.md"},{"slug":"mcp-semantic-identifier-consistency","title":"Semantic Identifier Consistency","description":"Use names that (a) match the authoritative contract and (b) truthfully describe what the code does—consistently across upstream, models, and outputs.","repository":"awslabs/mcp","domain":"ai-agents","topic":"Naming Conventions","language":"Python","updated":"2026-07-20","comments":7,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-semantic-identifier-consistency.md"},{"slug":"mcp-llm-interface-contracts","title":"LLM Interface Contracts","description":"When exposing APIs/tools to an LLM, treat docstrings, parameter semantics, and output size as an interface contract: make it unambiguous, match callable tool names exactly, structure “what to do” for reliable parsing, and cap context/token growth.","repository":"awslabs/mcp","domain":"ai-agents","topic":"AI","language":"Python","updated":"2026-07-20","comments":6,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-llm-interface-contracts.md"},{"slug":"hermes-agent-config-contract-consistency","title":"Config contract consistency","description":"Apply a “configuration as a contract” standard: when behavior depends on environment/profile/feature flags (remote vs local, active management profile, accessibility mode, client/server timing), wire that configuration into *all* relevant code paths and keep its semantics consistent across layers.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2026-07-20","comments":4,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-config-contract-consistency.md"},{"slug":"omniroute-follow-test-constraints","title":"Follow test constraints","description":"When adding UI logic or tests, align with the repository’s existing CI/test guardrails—especially global checks and test discovery conventions. - **Respect cross-cutting test rules (e.g., i18n parity):** Don’t introduce changes that require mass updates across all locales/fixtures unless you’re prepared to complete them. If full compliance is out of scope,...","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Testing","language":"TSX","updated":"2026-07-20","comments":2,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-follow-test-constraints.md"},{"slug":"hermes-agent-wire-contract-enforcement","title":"Wire Contract Enforcement","description":"External API boundaries must enforce the *final wire contract*: only supported parameters, only provider-accepted content shapes, and only schema-valid payloads.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"API","language":"Python","updated":"2026-07-19","comments":7,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-wire-contract-enforcement.md"},{"slug":"hermes-agent-configyaml-first-policy","title":"Config.yaml First Policy","description":"Behavioral configuration must be owned by `config.yaml` (and documented), while environment variables must be limited to secrets or internal backward-compatibility bridges. Also ensure any filesystem default paths are profile-safe via `get_hermes_home()`.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2026-07-19","comments":6,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-configyaml-first-policy.md"},{"slug":"hermes-agent-generation-guarded-async-side-effects","title":"Generation-guarded async side effects","description":"When async work can overlap (navigation changes, optimistic updates, multiple handler invocations, or speech interruption), treat post-`await` mutations as conditional on the original intent. Capture (1) the state/identity you’re operating on and (2) a monotonically increasing generation/token before any `await` or long-running step. Only apply...","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Concurrency","language":"TypeScript","updated":"2026-07-19","comments":6,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-generation-guarded-async-side-effects.md"},{"slug":"azure-powershell-self-documenting-calls-models","title":"Self-Documenting Calls & Models","description":"When reviewing code, enforce two style rules: 1) **Make complex calls self-documenting**: prefer **named arguments** over positional parameters, and pass **intent variables** instead of literals when the value is logically derived.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Code Style","language":"C#","updated":"2026-07-19","comments":3,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-self-documenting-calls-models.md"},{"slug":"hermes-agent-enforce-api-contracts","title":"Enforce API Contracts","description":"Client and UI code must explicitly follow the real API/component contract—both for *what state transitions are allowed* and *which side effects/transport paths are actually executed*.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"API","language":"TSX","updated":"2026-07-19","comments":3,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-enforce-api-contracts.md"},{"slug":"hermes-agent-integration-tests-for-focus","title":"Integration tests for focus","description":"When behavior depends on library primitives (e.g., Radix) and real browser focus/pointer flows (including `document.body` portals), unit tests that reimplement internal handlers are not enough. Write tests that render the actual component tree and assert user-observable outcomes.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Testing","language":"TSX","updated":"2026-07-19","comments":2,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-integration-tests-for-focus.md"},{"slug":"hermes-agent-secure-rendering-and-fetch","title":"Secure Rendering And Fetch","description":"All untrusted inputs must be hardened at their security boundaries: (1) for network calls, validate the destination on every redirect hop (and ideally after DNS resolution), and (2) for any rendered or embedded output, sanitize/encode for the exact output context to prevent XSS and script-breaking.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Security","language":"Other","updated":"2026-07-18","comments":9,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-secure-rendering-and-fetch.md"},{"slug":"omniroute-fail-safe-error-propagation","title":"Fail Safe Error Propagation","description":"Establish an error-handling standard that prevents crashes/hangs, preserves root errors, and makes recovery bounded and verifiable. Guidelines: - Catch safely: prefer `catch (err: unknown)` and narrow before reading fields.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Error Handling","language":"TypeScript","updated":"2026-07-18","comments":9,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-fail-safe-error-propagation.md"},{"slug":"hermes-agent-profile-scoped-api-routing","title":"Profile-scoped API routing","description":"All profile-scoped routing must use the mechanism your IPC/bridge/router actually consumes (e.g., an outer request field or a `...profileScoped()` wrapper). Do not attempt to “scope” routing by placing `profile` inside nested request bodies that the backend simply binds/forwards, or by passing `profile` only as a query param unless the bridge explicitly...","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2026-07-18","comments":7,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-profile-scoped-api-routing.md"},{"slug":"hermes-agent-precise-matching-rules","title":"Precise Matching Rules","description":"When implementing parsing/classification logic, treat the input grammar as a contract: (1) constrain pattern matches to the intended envelope/boundaries/character sets (avoid prefix/superset regexes and overly broad Unicode ranges), (2) ensure every computed signal/metric is actually used in the final decision, and (3) add targeted regression tests for each...","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Algorithms","language":"Python","updated":"2026-07-18","comments":6,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-precise-matching-rules.md"},{"slug":"hermes-agent-explicit-trust-and-consent","title":"Explicit Trust and Consent","description":"When a security-related skill or script causes any external effect (sending data to third parties, spending funds, changing auth, or modifying security config), the implementation and docs must be explicit about (a) trust boundaries, (b) user-controlled/bounded authorization, and (c) safe, targeted, verifiable changes.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Security","language":"Markdown","updated":"2026-07-18","comments":5,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-explicit-trust-and-consent.md"},{"slug":"agentcore-samples-use-canonical-api-contracts","title":"Use Canonical API Contracts","description":"When integrating with platform services (SDKs or cloud APIs), treat the SDK/API surface as the source of truth: prefer built-in batch and “create-or-get” methods, consolidate overlapping client interfaces, and use structured configuration objects rather than ad-hoc parsing.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"API","language":"Python","updated":"2026-07-18","comments":4,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-use-canonical-api-contracts.md"},{"slug":"axonhub-deterministic-cache-keys","title":"Deterministic Cache Keys","description":"Cache keys must be built only from inputs that truly change model output, and must be deterministic, complete, and cheap to compute. **Rules** 1. **Derive keys from a stable message “anchor”.** If using conversation head hashing, explicitly define which roles and how many bytes you consider (e.g., contiguous leading `system`/`developer`, plus first...","repository":"looplj/axonhub","domain":"llm-infra","topic":"Caching","language":"Go","updated":"2026-07-18","comments":3,"stars":4808,"raw":"https://awesomereviewers.com/raw/axonhub-deterministic-cache-keys.md"},{"slug":"agentcore-samples-avoid-brittle-ai-heuristics","title":"Avoid brittle AI heuristics","description":"When building agent evaluation and agent runtime logic, avoid ad-hoc, brittle inference from unstructured strings or hardcoded scenario lists. Instead:","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"AI","language":"Python","updated":"2026-07-18","comments":2,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-avoid-brittle-ai-heuristics.md"},{"slug":"hermes-agent-enforce-security-end-to-end","title":"Enforce Security End-to-End","description":"When implementing security controls, treat them as end-to-end requirements across *all* navigation paths and *all* auth/transport interfaces. Two common failure modes are (1) hidden/aux renderer windows that still allow unintended credential/WebAuthn UI via a fallback path, and (2) security-sensitive flows that accept security context but some callers pass...","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2026-07-18","comments":2,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-enforce-security-end-to-end.md"},{"slug":"hermes-agent-failure-safe-state-handling","title":"Failure-Safe State Handling","description":"When error handling affects control-flow invariants (dedupe keys, stale-session guards, correctness checks), make failures safe and reversible: - Cleanup on every failure path: If you “remember”/lock/dedupe before completing the operation, ensure that early returns and catch blocks restore the pre-operation state (e.g., remove the remembered key).","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2026-07-18","comments":2,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-failure-safe-state-handling.md"},{"slug":"bifrost-low-noise-instance-safe-logs","title":"Low-noise, instance-safe logs","description":"When adding or modifying logging, follow these rules: 1) **Attribute logs to the right component/instance** - Avoid process-global logging hooks/state when a per-instance logger exists.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Logging","language":"Go","updated":"2026-07-17","comments":6,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-low-noise-instance-safe-logs.md"},{"slug":"axonhub-enforce-api-contracts","title":"Enforce API Contracts","description":"When designing or extending APIs, ensure the request/response schema and behavior strictly preserve invariants and provider compatibility. Apply these rules:","repository":"looplj/axonhub","domain":"llm-infra","topic":"API","language":"Go","updated":"2026-07-17","comments":5,"stars":4808,"raw":"https://awesomereviewers.com/raw/axonhub-enforce-api-contracts.md"},{"slug":"azure-sentinel-error-handled-api-calls","title":"Error-handled API Calls","description":"For every external API/data-store call, enforce a consistent error-handling contract: 1) Validate inputs up front (fail fast for predictable bad requests)","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Error Handling","language":"Python","updated":"2026-07-17","comments":5,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-error-handled-api-calls.md"},{"slug":"goose-contract-first-api-design","title":"Contract-first API design","description":"When designing or consuming client/server APIs, keep the contract explicit and prevent duplicate logic/types from drifting. Apply this standard: - **Single source of truth:** If the backend persists/owns a value, the UI should display it directly—avoid re-adding client fallbacks that recreate the same logic.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2026-07-17","comments":5,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-contract-first-api-design.md"},{"slug":"bifrost-config-aware-startup-failures","title":"Config-Aware Startup Failures","description":"When adding startup preflight checks (permissions, filesystem writeability, required directories), treat failure as part of error-handling policy: be precise, actionable, and configuration-aware.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Error Handling","language":"Shell","updated":"2026-07-17","comments":3,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-config-aware-startup-failures.md"},{"slug":"bifrost-document-behavior-precisely","title":"Document behavior precisely","description":"When updating documentation, ensure every statement about requirements, capabilities, and behavior is (1) correct for the current implementation, (2) explicit about when the requirement matters (e.g., render-time vs apply-time vs run-time), (3) consistent across related doc artifacts, and (4) does not imply unsupported configuration paths. Follow house...","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Documentation","language":"Other","updated":"2026-07-17","comments":2,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-document-behavior-precisely.md"},{"slug":"bifrost-auth-config-documentation","title":"Auth config documentation","description":"When Helm (or other config) controls authentication for a protected endpoint, treat credential source, key names, and auth enablement paths as security-sensitive behavior. Ensure both the implementation and the accompanying docs/changelog precisely describe:","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Security","language":"Other","updated":"2026-07-17","comments":1,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-auth-config-documentation.md"},{"slug":"container-meaningful-test-level-correctness","title":"Meaningful, Test-Level Correctness","description":"Tests should be aligned with what they claim to validate, and placed at the right layer (unit vs integration). Concretely: - **Don’t rely on system side effects in unit tests.** If the test depends on vmnet/network/kernel/fs behavior, prefer **integration** coverage; unit tests should focus on pure logic.","repository":"apple/container","domain":"orchestration","topic":"Testing","language":"Swift","updated":"2026-07-16","comments":13,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-meaningful-test-level-correctness.md"},{"slug":"azure-powershell-reliable-integration-testing","title":"Reliable Integration Testing","description":"Write integration/recorded tests so they are deterministic, efficient in playback, and self-cleaning. Apply these rules: 1) Deterministic errors → unit tests with mocks","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Testing","language":"Other","updated":"2026-07-16","comments":6,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-reliable-integration-testing.md"},{"slug":"goose-fail-safe-input-handling","title":"Fail Safe Input Handling","description":"When processing security-relevant external inputs (URIs/hosts, file paths/content, auth tokens, and tool-call metadata), validate and constrain early, then ensure failure modes are non-recoverable in ways that could cause retries or duplicate effects.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Security","language":"Rust","updated":"2026-07-16","comments":6,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-fail-safe-input-handling.md"},{"slug":"azure-powershell-api-versioning-and-client-methods","title":"API versioning and client methods","description":"When changing API clients, keep API versioning and HTTP operation semantics explicit and isolated. **Do** - **Scope ApiVersion changes** to only the new operation(s). If a shared client is used by many cmdlets, either (a) split the client, (b) wrap the new operation in a dedicated client/operation class, or (c) prove all affected cmdlets are covered.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"API","language":"C#","updated":"2026-07-16","comments":5,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-api-versioning-and-client-methods.md"},{"slug":"omniroute-validate-config-inputs","title":"Validate Config Inputs","description":"Any configuration derived from environment variables or external config must be (1) wired to the correct runtime fields, (2) normalized/validated with safe defaults, and (3) applied with deterministic precedence.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Configurations","language":"TypeScript","updated":"2026-07-16","comments":5,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-validate-config-inputs.md"},{"slug":"bifrost-group-aware-pagination","title":"Group-aware Pagination","description":"When the client needs a logical unit (run/history group, full resource state), the API must paginate and update in a way that preserves that unit across requests.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"API","language":"TSX","updated":"2026-07-16","comments":3,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-group-aware-pagination.md"},{"slug":"hermes-agent-assert-behavior-inject-inputs","title":"Assert behavior; inject inputs","description":"When code changes affect what the app *sends* (RPC/HTTP payloads/options) or what the app *decides* based on the environment, add targeted tests that (1) assert the exact externally observable behavior and (2) make the inputs deterministic.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Testing","language":"TypeScript","updated":"2026-07-16","comments":3,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-assert-behavior-inject-inputs.md"},{"slug":"azure-powershell-unit-tests-for-cmdlet-paths","title":"Unit tests for cmdlet paths","description":"Add isolated unit tests for cmdlet production paths using mocked client operations. Tests must validate more than a “happy path” scenario run: - Verify exact client call arguments (including resource identifiers and IDs).","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Testing","language":"C#","updated":"2026-07-16","comments":2,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-unit-tests-for-cmdlet-paths.md"},{"slug":"bifrost-explicit-null-safety","title":"Explicit Null Safety","description":"When templating, explicitly distinguish three states: **missing**, **explicit false**, and **null**. Relying on truthiness can silently drop intended configuration.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Null Handling","language":"Yaml","updated":"2026-07-16","comments":2,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-explicit-null-safety.md"},{"slug":"hermes-agent-collision-safe-keys","title":"Collision-Safe Keys","description":"When an algorithm derives a decision key (dedupe) or signal (parsed config) that can suppress/merge data, make that derivation collision- and normalization-safe, and define precedence explicitly.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Algorithms","language":"TypeScript","updated":"2026-07-16","comments":2,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-collision-safe-keys.md"},{"slug":"hermes-agent-preserve-signing-entitlements","title":"Preserve signing entitlements","description":"On macOS, treat re-signing (including ad-hoc re-sign after quarantine stripping) as a security-sensitive operation: preserve the app’s entitlements for the main bundle and any helper apps. Otherwise, macOS TCC access (mic/screen audio) may break or continuously prompt because the re-signed artifacts no longer carry the expected entitlements. Also ensure...","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Security","language":"Shell","updated":"2026-07-16","comments":1,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-preserve-signing-entitlements.md"},{"slug":"opencut-validate-imported-payloads","title":"Validate imported payloads","description":"When ingesting untrusted data (e.g., JSON pasted/uploaded by users), validate the *entire* payload against a schema (including nested structures) before writing to storage or otherwise trusting it. Avoid relying on top-level presence checks or unsafe type casts; these can let malformed nested content persist and only fail later.","repository":"opencut-app/opencut","domain":"security","topic":"Security","language":"TypeScript","updated":"2026-07-16","comments":1,"stars":81817,"raw":"https://awesomereviewers.com/raw/opencut-validate-imported-payloads.md"},{"slug":"apisix-security-invariants-guardrails","title":"Security Invariants Guardrails","description":"When changing auth/secret/TLS/validation code, treat existing security semantics as invariants: refactors must not weaken them, and config defaults/warnings must be applied after schema normalization.","repository":"apache/apisix","domain":"cloud-infra","topic":"Security","language":"Other","updated":"2026-07-15","comments":9,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-security-invariants-guardrails.md"},{"slug":"omniroute-efficient-hot-path-discipline","title":"Efficient hot-path discipline","description":"Adopt a performance-safety standard: prevent unbounded state growth in monitoring, and keep critical-path CPU/memory work linear and avoidable. Apply these rules:","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Performance Optimization","language":"TypeScript","updated":"2026-07-15","comments":8,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-efficient-hot-path-discipline.md"},{"slug":"hermes-agent-robust-error-paths","title":"Robust error paths","description":"When handling errors, ensure you don’t (1) mask the original failure, (2) violate the intended timeout/retry/cleanup boundaries, or (3) make recovery decisions without explicit evidence.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2026-07-15","comments":7,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-robust-error-paths.md"},{"slug":"omniroute-lifecycle-aligned-cancellation","title":"Lifecycle-aligned Cancellation","description":"When handling concurrent async work (streaming, tees, semaphores/limits, watchdogs), ensure cancellation, timeouts, and accounting are tied to the *actual* consumer lifecycle—release/decrement/teardown at the point where the work is truly finished, and don’t block on cancellation promises that can’t resolve until another branch drains.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Concurrency","language":"TypeScript","updated":"2026-07-15","comments":6,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-lifecycle-aligned-cancellation.md"},{"slug":"omniroute-null-safe-validation-standard","title":"Null-Safe Validation Standard","description":"Always validate `null`/`undefined` (and malformed shapes) before dereferencing, filtering, or merging—treat `null` as an explicit, documented input rather than “missing”.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Null Handling","language":"TypeScript","updated":"2026-07-15","comments":6,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-null-safe-validation-standard.md"},{"slug":"apisix-semantics-correct-algorithms","title":"Semantics-Correct Algorithms","description":"When implementing or choosing an algorithm (scoring, aggregation, throttling, parsing), ensure it matches the domain semantics and behaves predictably under edge cases.","repository":"apache/apisix","domain":"cloud-infra","topic":"Algorithms","language":"Other","updated":"2026-07-15","comments":4,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-semantics-correct-algorithms.md"},{"slug":"apisix-wire-format-contract-tests","title":"Wire-Format Contract Tests","description":"When implementing or modifying any API-facing behavior (endpoint URL construction, request/response mappings, routing encodings, capability expansion), treat the final wire format as the contract. Prevent silent mismatches by combining schema validation, explicit documentation of any byte-exact normalization rules, and end-to-end tests that assert the exact...","repository":"apache/apisix","domain":"cloud-infra","topic":"API","language":"Other","updated":"2026-07-15","comments":4,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-wire-format-contract-tests.md"},{"slug":"omniroute-contract-first-api-validation","title":"Contract-First API Validation","description":"Treat every API endpoint as a contract: - Validate all request inputs (query params, body fields) with shared schemas (e.g., Zod) instead of manual parsing.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"API","language":"TypeScript","updated":"2026-07-15","comments":4,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-contract-first-api-validation.md"},{"slug":"omniroute-real-regression-tests","title":"Real Regression Tests","description":"When you fix behavior (especially edge/boundary cases), add regression tests that are: - **Reachable** (not unexported/inaccessible without refactors that make them testable).","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Testing","language":"TypeScript","updated":"2026-07-15","comments":4,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-real-regression-tests.md"},{"slug":"agentcore-samples-tracing-schema-and-continuity","title":"Tracing schema and continuity","description":"When adding or integrating agent frameworks/invocation paths, ensure observability works end-to-end by meeting BOTH requirements: (1) the emitted telemetry conforms to the documented OpenTelemetry/OpenInference schema (not merely “OTLP transport”), and (2) trace context is propagated across boundaries (e.g., Lambda → AgentCore) so traces are continuous and...","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Observability","language":"Markdown","updated":"2026-07-15","comments":3,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-tracing-schema-and-continuity.md"},{"slug":"hermes-agent-guard-async-state-updates","title":"Guard Async State Updates","description":"When multiple async operations can be in flight (polling, optimistic mutations, React effects, REST hydration + live WebSocket deltas), older responses may arrive last and overwrite newer state. Standardize a pattern that makes each async result apply only if it is still the current/owned operation.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Concurrency","language":"TSX","updated":"2026-07-15","comments":3,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-guard-async-state-updates.md"},{"slug":"hermes-agent-canonical-identifier-semantics","title":"Canonical Identifier Semantics","description":"When code maps or normalizes external identifiers (tool names, locale tags, etc.), it must preserve the identifier’s real semantics and use canonical names.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2026-07-15","comments":2,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-canonical-identifier-semantics.md"},{"slug":"hermes-agent-localize-configuration-ui","title":"Localize configuration UI","description":"In configuration/settings UI (including timezone, system defaults, and messaging), do not introduce or hardcode user-visible text. Always source strings from the appropriate i18n catalog/keys so all locales (e.g., desktop Japanese/Chinese) get consistent wording.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Configurations","language":"TSX","updated":"2026-07-15","comments":2,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-localize-configuration-ui.md"},{"slug":"hermes-agent-lock-and-retry-rules","title":"Lock and Retry Rules","description":"When coordinating async work with shared resources, (1) tie lock/flag state transitions to the real lifecycle of the work (e.g., confirmed detached handoff or confirmed error) rather than to generic function scope, and (2) treat resource contention as transient by using bounded retry + backoff for cleanup/claims.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Concurrency","language":"Other","updated":"2026-07-15","comments":2,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-lock-and-retry-rules.md"},{"slug":"hermes-agent-stop-infinite-error-polling","title":"Stop Infinite Error Polling","description":"In long-running UI workflows that poll (e.g., QR status, task panels, gateway actions), treat failures as **transient vs permanent**, and ensure your state transitions **cannot loop forever**.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Error Handling","language":"TSX","updated":"2026-07-15","comments":2,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-stop-infinite-error-polling.md"},{"slug":"iptv-avoid-tokenized-stream-urls","title":"Avoid Tokenized Stream URLs","description":"Do not include ephemeral authentication parameters (e.g., `session=`, `tkn=`, `hash=`, `sign=`) or other provider-specific auth wrappers in static `.m3u` entries. These links commonly expire (“timebomb”) and/or may be IP-locked, causing playback failures and turning the playlist into a security-sensitive artifact. Also, reject/omit link types your system...","repository":"iptv-org/iptv","domain":"security","topic":"Security","language":"Other","updated":"2026-07-14","comments":9,"stars":135586,"raw":"https://awesomereviewers.com/raw/iptv-avoid-tokenized-stream-urls.md"},{"slug":"apisix-harden-errors-and-cleanup","title":"Harden Errors And Cleanup","description":"Treat any external input (HTTP headers, JSON bodies, provider responses, dynamic config) as untrusted: validate its type/shape before indexing or string operations, and ensure errors don’t turn into uncontrolled 500s or leak state/resources.","repository":"apache/apisix","domain":"cloud-infra","topic":"Error Handling","language":"Other","updated":"2026-07-14","comments":7,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-harden-errors-and-cleanup.md"},{"slug":"bifrost-validate-security-context","title":"Validate security context","description":"Define and enforce security-context behavior as a clear contract, then implement CI/runtime logic to match it without brittle assumptions. Apply this in two places:","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Security","language":"Shell","updated":"2026-07-14","comments":5,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-validate-security-context.md"},{"slug":"azure-powershell-avoid-manual-sdk-edits","title":"Avoid manual SDK edits","description":"When working on CI/CD pipelines, treat anything under `*Management.Sdk/Generated/*` (or similarly generated folders) as read-only. **Standard** - **Do not manually edit generated SDK/model files.** CI may fail and changes will be overwritten on the next regen.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"CI/CD","language":"C#","updated":"2026-07-14","comments":3,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-avoid-manual-sdk-edits.md"},{"slug":"azure-powershell-pinned-spec-configuration","title":"Pinned Spec Configuration","description":"When configuration files drive code generation (e.g., AutoRest README YAML), pin the exact spec snapshot and use the correct configuration semantics.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Configurations","language":"Markdown","updated":"2026-07-14","comments":3,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-pinned-spec-configuration.md"},{"slug":"hermes-agent-secure-boundary-enforcement","title":"Secure boundary enforcement","description":"When code crosses security boundaries (HTTP auth, subprocess execution, or policy-driven external side effects), it must follow the established secure path and validate before acting.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Security","language":"JavaScript","updated":"2026-07-14","comments":3,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-secure-boundary-enforcement.md"},{"slug":"goose-validate-model-limits","title":"Validate model limits","description":"When integrating LLM providers, don’t assume the provider’s model spec equals what the specific API endpoint will actually accept. Enforce two checks in your model configuration: (1) set `context_limit` to a safe upper bound that matches the endpoint’s effective cap, and (2) restrict model selection to a curated allowlist of chat-capable models instead of...","repository":"aaif-goose/goose","domain":"ai-agents","topic":"AI","language":"Json","updated":"2026-07-14","comments":2,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-validate-model-limits.md"},{"slug":"hermes-agent-accessible-react-state-handling","title":"Accessible React State Handling","description":"In React components and hooks, changes to focus/interaction state or derived UI state must preserve correct behavior for all users and reflect the actual semantic state transitions.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"React","language":"TSX","updated":"2026-07-14","comments":2,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-accessible-react-state-handling.md"},{"slug":"hermes-agent-deterministic-algorithm-workflows","title":"Deterministic algorithm workflows","description":"When you describe an algorithm (retrieval pipeline, scoring, ranking, etc.), ensure the implementation includes the complete promised workflow and produces deterministic outputs.","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Algorithms","language":"Markdown","updated":"2026-07-14","comments":2,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-deterministic-algorithm-workflows.md"},{"slug":"mcp-validated-observability-guidance","title":"Validated Observability Guidance","description":"When updating observability docs, dashboards, or diagnostic query packs, ensure the guidance is both actionable and correct: 1) Add critical alerting/scale guidance","repository":"awslabs/mcp","domain":"ai-agents","topic":"Observability","language":"Markdown","updated":"2026-07-14","comments":2,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-validated-observability-guidance.md"},{"slug":"goose-separate-auth-and-routing","title":"Separate auth and routing","description":"When using OpenAI-compatible providers/proxies, treat authentication and endpoint routing as separate concerns: - **Auth comes only from the API key** (e.g., `OPENAI_API_KEY`). If the key is missing/unloaded, requests may be sent with no auth and you’ll typically see `401` (e.g., `No api key passed in`).","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Security","language":"Markdown","updated":"2026-07-14","comments":1,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-separate-auth-and-routing.md"},{"slug":"bifrost-streaming-error-invariants","title":"Streaming error invariants","description":"Adopt a single, consistent error-handling strategy for streaming (and other multi-step flows): define retry semantics, tolerate isolated decode/parse errors, enforce terminal/completion invariants, and preserve the failure context needed by downstream billing/logging.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Error Handling","language":"Go","updated":"2026-07-13","comments":8,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-streaming-error-invariants.md"},{"slug":"apisix-test-isolation-and-determinism","title":"Test isolation and determinism","description":"Tests should be deterministic, isolated, and assert the intended behavior (not just a coincidence or shared prior state). Concretely: - Reset external/shared state for every test (especially Redis, quotas, counters). Do not rely on the order tests run.","repository":"apache/apisix","domain":"cloud-infra","topic":"Testing","language":"Other","updated":"2026-07-13","comments":7,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-test-isolation-and-determinism.md"},{"slug":"azure-sentinel-arm-escaping-and-diff-hygiene","title":"arm escaping and diff hygiene","description":"When editing Azure Sentinel solution artifacts (ARM templates + nested CCF connector templates), treat ARM escaping and packaging output as correctness-critical formatting:","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Code Style","language":"Json","updated":"2026-07-13","comments":6,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-arm-escaping-and-diff-hygiene.md"},{"slug":"goose-readable-maintainable-code","title":"Readable Maintainable Code","description":"Write Rust code so its intent is clear at a glance and responsibilities are placed correctly. Apply this checklist: - Remove redundant comments when the code is already self-explanatory.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Code Style","language":"Rust","updated":"2026-07-13","comments":5,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-readable-maintainable-code.md"},{"slug":"bifrost-secret-aware-schema-contracts","title":"Secret-Aware Schema Contracts","description":"When updating configuration schemas (and related env/test fixtures), treat the schema as a contract with runtime unmarshalling and deployment timing.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Configurations","language":"Json","updated":"2026-07-13","comments":4,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-secret-aware-schema-contracts.md"},{"slug":"azure-powershell-consistent-identifier-naming","title":"Consistent Identifier Naming","description":"Use naming rules that keep identifiers consistent, unambiguous, and resilient to change: - Centralize repeated string keys/labels used as identifiers (e.g., dictionary/property-bag keys) into named constants so the same literal can’t drift across methods.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Naming Conventions","language":"C#","updated":"2026-07-13","comments":2,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-consistent-identifier-naming.md"},{"slug":"last30days-skill-deterministic-config-handling","title":"Deterministic Config Handling","description":"Treat configuration inputs as a deterministic contract: normalize/parsing should be robust and centralized, and config-file reading must use an explicit encoding matching the write path.","repository":"mvanhorn/last30days-skill","domain":"cloud-infra","topic":"Configurations","language":"Python","updated":"2026-07-12","comments":2,"stars":57799,"raw":"https://awesomereviewers.com/raw/last30days-skill-deterministic-config-handling.md"},{"slug":"last30days-skill-non-brittle-contract-tests","title":"Non-brittle Contract Tests","description":"When writing tests, assert the real behavioral contract (the thing that could regress), not incidental formatting or brittle implementation details. Practical rules:","repository":"mvanhorn/last30days-skill","domain":"app-frameworks","topic":"Testing","language":"Python","updated":"2026-07-11","comments":6,"stars":57799,"raw":"https://awesomereviewers.com/raw/last30days-skill-non-brittle-contract-tests.md"},{"slug":"goose-canonical-model-capabilities","title":"Canonical Model Capabilities","description":"When integrating LLM providers/models, derive capability flags and limits from canonical model metadata (catalog) and apply deterministic compatibility rules with explicit fallbacks—avoid brittle name-based heuristics and keep user overrides authoritative.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"AI","language":"Rust","updated":"2026-07-10","comments":8,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-canonical-model-capabilities.md"},{"slug":"pr-agent-model-safe-parameter-validation","title":"Model-Safe Parameter Validation","description":"Adopt a model/provider-aware configuration standard: before sending requests to LLM APIs, validate that every model-specific parameter (reasoning effort, thinking features, temperature constraints, system support) is supported for that exact model/provider, and apply overrides safely without accidentally changing unrelated limits.","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"AI","language":"Python","updated":"2026-07-10","comments":8,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-model-safe-parameter-validation.md"},{"slug":"apisix-schema-consistent-config","title":"Schema-consistent config","description":"When implementing configuration-driven features, make validation/forwarding/runtime consumption strictly follow the schema and any shared capability wrapper. Avoid plugin-specific special casing for generic capabilities, avoid manual per-branch field copying that can silently drop accepted config, and ensure environment-variable access uses the project’s...","repository":"apache/apisix","domain":"cloud-infra","topic":"Configurations","language":"Other","updated":"2026-07-10","comments":7,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-schema-consistent-config.md"},{"slug":"azure-powershell-spec-fidelity-directives","title":"Spec fidelity directives","description":"When using AutoRest (or similar) to generate PowerShell/SDK surfaces, enforce that the generated cmdlets and types preserve the intended REST API contract—especially around nullability, required parameters, and unintended extra parameter-set variants.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"API","language":"Markdown","updated":"2026-07-10","comments":7,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-spec-fidelity-directives.md"},{"slug":"azure-sentinel-early-filter-and-cache","title":"Early Filter and Cache","description":"When writing KQL (hunting queries or ASIM parsers), optimize for fewer rows and fewer expensive computations: 1) Prefilter early (before parse/branch work)","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Performance Optimization","language":"Yaml","updated":"2026-07-10","comments":7,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-early-filter-and-cache.md"},{"slug":"openmontage-idempotency-key-completeness","title":"Idempotency Key Completeness","description":"When implementing API endpoints/clients that use idempotency keys, ensure the idempotency key includes **all request fields that can change the output** (including aliases/variants). Otherwise, different calls can collide and incorrectly deduplicate.","repository":"calesthio/OpenMontage","domain":"app-frameworks","topic":"API","language":"Python","updated":"2026-07-10","comments":2,"stars":46544,"raw":"https://awesomereviewers.com/raw/openmontage-idempotency-key-completeness.md"},{"slug":"goose-secure-extension-install","title":"Secure extension install","description":"When publishing extension/server install options (especially deep-links or Install buttons), default to a secure-by-default path: require explicit/manual installation for binary-first or otherwise security-sensitive extensions. Only enable an automated install/deeplink if the target is explicitly allowlisted.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Security","language":"Json","updated":"2026-07-10","comments":1,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-secure-extension-install.md"},{"slug":"hermes-agent-enforce-auth-preconditions","title":"Enforce auth preconditions","description":"Security-sensitive state (e.g., creating/persisting a profile that assumes a working remote connection) must not be created when required authentication material is missing or invalid. If downstream token-auth/config saving will reject empty/placeholder tokens, block the flow up front or use a staged/OAuth flow so the local profile is only finalized after...","repository":"nousresearch/hermes-agent","domain":"ai-agents","topic":"Security","language":"TSX","updated":"2026-07-10","comments":1,"stars":221948,"raw":"https://awesomereviewers.com/raw/hermes-agent-enforce-auth-preconditions.md"},{"slug":"apisix-null-safety-contracts","title":"Null Safety Contracts","description":"When handling optional/nil values, treat nil as a real input only if it’s reachable; otherwise remove dead checks. More importantly, enforce clear contracts for types/shapes so nil never reaches code paths that assume a table/string.","repository":"apache/apisix","domain":"cloud-infra","topic":"Null Handling","language":"Other","updated":"2026-07-09","comments":7,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-null-safety-contracts.md"},{"slug":"apisix-observability-semantic-contract","title":"Observability semantic contract","description":"Establish an explicit observability contract in code: tracing spans must be finished centrally with correct semantics; trace context inputs must be validated/formatted to standards; metrics must not mix different meanings across streaming vs non-streaming.","repository":"apache/apisix","domain":"cloud-infra","topic":"Observability","language":"Other","updated":"2026-07-09","comments":7,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-observability-semantic-contract.md"},{"slug":"aidlc-workflows-defensive-observable-error-handling","title":"Defensive Observable Error Handling","description":"Coding standard for hook/compose-style tooling: never fail silently; parse defensively; gate writes by installed compatibility; and make transient failures self-healing. Diagnostics must only fail on real faults (e.g., stale markers), not normal in-flight states.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Error Handling","language":"TypeScript","updated":"2026-07-09","comments":6,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-defensive-observable-error-handling.md"},{"slug":"aidlc-workflows-executable-documentation-accuracy","title":"Executable Documentation Accuracy","description":"All technical documentation in this repo (stage protocols, stage bodies, templates, plugin authoring docs, READMEs that describe operational steps) must be mechanically consistent with the actual engine/tools/sensors—and must state conditions as explicit, checkable constraints.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Documentation","language":"Markdown","updated":"2026-07-09","comments":6,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-executable-documentation-accuracy.md"},{"slug":"apisix-avoid-hot-path-work","title":"Avoid Hot-Path Work","description":"When optimizing performance, ensure hot paths do only the minimum required work and never block while holding scarce resources. Apply these rules: - Gate expensive resolution/processing behind cheap checks (e.g., only resolve secrets if references exist; only buffer/scan when blocking is requested).","repository":"apache/apisix","domain":"cloud-infra","topic":"Performance Optimization","language":"Other","updated":"2026-07-09","comments":6,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-avoid-hot-path-work.md"},{"slug":"agentcore-samples-region-configuration-standard","title":"Region Configuration Standard","description":"Do not hard-code AWS region (or other environment-specific settings) inside scripts or service logic. Instead, make region resolution consistent, configurable, and source-of-truth driven.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2026-07-09","comments":4,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-region-configuration-standard.md"},{"slug":"aidlc-workflows-explicit-environment-contracts","title":"Explicit Environment Contracts","description":"When code depends on runtime configuration (tooling paths, IDE/CLI context, feature flags), treat environment variables as an explicit contract and don’t rely on implicit process state.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Configurations","language":"TypeScript","updated":"2026-07-09","comments":2,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-explicit-environment-contracts.md"},{"slug":"aidlc-workflows-no-silent-null-artifacts","title":"No Silent Null Artifacts","description":"When a workflow stage can legitimately have missing data, treat the missing artifact as an explicit, validated state—not as an absent file/implicit default.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Null Handling","language":"Markdown","updated":"2026-07-09","comments":2,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-no-silent-null-artifacts.md"},{"slug":"bifrost-config-contract-validation","title":"Config Contract Validation","description":"Ensure API configuration endpoints (e.g., `PUT /api/config`) define and enforce a precise request/response contract across schema shape, merge semantics, validation behavior, and persistence.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"API","language":"Json","updated":"2026-07-09","comments":2,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-config-contract-validation.md"},{"slug":"bifrost-graceful-degradation-policy","title":"Graceful Degradation Policy","description":"For external dependencies that are *additive* (e.g., mirrors/archives) rather than required for correctness, prefer **fail-open** behavior: log errors and continue operating using the primary source of truth. Reserve **fail-fast** for dependencies that are *hard requirements* for correctness or API functionality.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Error Handling","language":"Other","updated":"2026-07-09","comments":2,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-graceful-degradation-policy.md"},{"slug":"apisix-actionable-logging-rules","title":"Actionable logging rules","description":"Adopt consistent logging practices: - **Never allow correctness-affecting failures to be silent**, especially inside OpenResty async callbacks (e.g., `ngx.timer.at`, log phase). Log each error path *inside* the callback.","repository":"apache/apisix","domain":"cloud-infra","topic":"Logging","language":"Other","updated":"2026-07-08","comments":11,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-actionable-logging-rules.md"},{"slug":"apisix-concurrency-safe-state-ownership","title":"Concurrency-Safe State Ownership","description":"In code that runs across multiple concurrent requests/workers (OpenResty/Nginx), make state ownership and lifecycle explicit: use one writer/immutable shared snapshots, keep request/per-plugin state per-instance or per-request, and design timer/event flows to avoid race windows.","repository":"apache/apisix","domain":"cloud-infra","topic":"Concurrency","language":"Other","updated":"2026-07-08","comments":11,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-concurrency-safe-state-ownership.md"},{"slug":"azure-powershell-generated-help-consistency","title":"Generated Help Consistency","description":"When changing cmdlet behavior or parameter semantics, treat help/examples as generated artifacts: update the source definitions/config (custom folder, README.md, autorest options/directives, APIspec where applicable) and then regenerate. Avoid hand-editing generated help/stubs, because edits will be overwritten and may desync parameter sets or requiredness.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Documentation","language":"Markdown","updated":"2026-07-08","comments":8,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-generated-help-consistency.md"},{"slug":"azure-powershell-consistent-error-handling","title":"Consistent error handling","description":"Apply a single, predictable error-handling strategy across cmdlets and SDK wrappers: - **Make existence semantics consistent**: if a method supports `throwIfNotExists` (or callers rely on it), every related “read/modify” path must honor it the same way (return `null` vs throw), and callers should not silently diverge between Get/With* operations.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Error Handling","language":"C#","updated":"2026-07-08","comments":5,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-consistent-error-handling.md"},{"slug":"bifrost-consistent-ui-formatting","title":"Consistent UI Formatting","description":"Apply consistent, presentation-focused code style to UI components: - Preserve flex/height semantics on “fill” containers: when a layout depends on full-viewport panels, ensure the relevant containers keep the same flex height/overflow utilities (e.g., `flex`, `flex-col`, `h-full`, `min-h-0`, and the intended `overflow-*` behavior).","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Code Style","language":"TSX","updated":"2026-07-08","comments":3,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-consistent-ui-formatting.md"},{"slug":"omniroute-database-safe-atomic-updates","title":"Database-safe atomic updates","description":"When writing/reading sensitive or destructive data, make the database do the work safely and atomically: - Prefer SQL-side filtering to avoid broad in-memory fetch/processing (e.g., add `authType` filtering in the query rather than filtering afterward).","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Database","language":"TypeScript","updated":"2026-07-07","comments":3,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-database-safe-atomic-updates.md"},{"slug":"aidlc-workflows-scoped-hash-based-idempotency","title":"Scoped Hash-Based Idempotency","description":"When implementing idempotency or caching via markers/ledger “done” signals, treat cached state as valid only if (a) the key reflects the content/version being applied and (b) the signal is scoped to the current execution context.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Caching","language":"TypeScript","updated":"2026-07-07","comments":2,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-scoped-hash-based-idempotency.md"},{"slug":"apisix-avoid-duplication-extract-helpers","title":"Avoid Duplication, Extract Helpers","description":"Keep code readable and maintainable by (1) extracting complex or phase-specific logic into dedicated helper functions, (2) removing duplicated logic/schema/label definitions in favor of shared helpers or a single source of truth, and (3) following existing project idioms/utilities to stay consistent.","repository":"apache/apisix","domain":"cloud-infra","topic":"Code Style","language":"Other","updated":"2026-07-06","comments":12,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-avoid-duplication-extract-helpers.md"},{"slug":"bifrost-cohesive-converters-organization","title":"Cohesive Converters Organization","description":"Keep Go files cohesive by responsibility, and make branching/conversion logic easy to extend. **1) Put types where they belong** - Move request/response structs (and their `GetExtraParams` helpers) into `types.go`.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Code Style","language":"Go","updated":"2026-07-06","comments":11,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-cohesive-converters-organization.md"},{"slug":"pr-agent-trust-boundaries-and-safe-parsing","title":"Trust Boundaries And Safe Parsing","description":"Treat any repo-controlled config, external webhook payload, or model-generated text as untrusted. Enforce trust boundaries and use safe parsing/validation to prevent SSRF/exfiltration, arbitrary file writes, and unsafe deserialization.","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"Security","language":"Python","updated":"2026-07-06","comments":8,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-trust-boundaries-and-safe-parsing.md"},{"slug":"aidlc-workflows-fail-loudly-degrade-safely","title":"Fail Loudly, Degrade Safely","description":"In session/install hooks, never hide failures. Avoid OS/tool-specific command forms and exit-code-dependent fallbacks, and when an error occurs either (1) stop with a clear message or (2) degrade gracefully while recording structured diagnostics so `--doctor`/health checks can surface what broke.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Error Handling","language":"Shell","updated":"2026-07-06","comments":3,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-fail-loudly-degrade-safely.md"},{"slug":"aidlc-workflows-check-mode-must-mirror","title":"Check mode must mirror","description":"When a pipeline script supports `--check`, it must validate *all* artifacts that the corresponding “write” path generates, using deterministic comparisons, and it must cover the full, intended target scope (prefer discovery over hardcoding).","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"CI/CD","language":"TypeScript","updated":"2026-07-06","comments":2,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-check-mode-must-mirror.md"},{"slug":"aidlc-workflows-security-trust-boundaries","title":"Security Trust Boundaries","description":"When software ingests extensions (plugins) or external artifacts (actions/images/deps), security standards must explicitly state the trust model and maintenance cadence.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Security","language":"Markdown","updated":"2026-07-06","comments":2,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-security-trust-boundaries.md"},{"slug":"bmad-method-naming-contracts-enforcement","title":"Naming contracts enforcement","description":"Treat IDs, artifact filenames, and command invocation strings as part of a naming contract: they must be deterministic for dispatch, glob matching, and resume/compatibility.","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Naming Conventions","language":"Markdown","updated":"2026-07-05","comments":5,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-naming-contracts-enforcement.md"},{"slug":"omniroute-network-payload-safety","title":"Network payload safety","description":"When implementing HTTP/SSE adapters or transforming network responses/streams, enforce three rules: (1) preserve required response headers/trace metadata while normalizing body-related headers, (2) respect protocol framing so streamed events can’t merge, and (3) prevent hanging outbound calls with timeouts.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Networking","language":"TypeScript","updated":"2026-07-05","comments":3,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-network-payload-safety.md"},{"slug":"9router-isolate-errors-avoid-cascades","title":"Isolate errors, avoid cascades","description":"When a feature depends on multiple probes/loads, ensure that failures in secondary/best-effort steps don’t corrupt primary state or cause cascading failures.","repository":"decolua/9router","domain":"llm-infra","topic":"Error Handling","language":"JavaScript","updated":"2026-07-05","comments":2,"stars":23951,"raw":"https://awesomereviewers.com/raw/9router-isolate-errors-avoid-cascades.md"},{"slug":"iptv-use-adaptive-load-balanced-streams","title":"Use adaptive load-balanced streams","description":"When adding/updating HLS stream URLs, pick the network endpoint that is most likely to work reliably: - Prefer adaptive HLS entrypoints (e.g., `master.m3u8`, `playlist.m3u8`, `manifest.m3u8`, `index.m3u8`) instead of redirect chains or single-bitrate links.","repository":"iptv-org/iptv","domain":"cloud-infra","topic":"Networking","language":"Other","updated":"2026-07-04","comments":9,"stars":135586,"raw":"https://awesomereviewers.com/raw/iptv-use-adaptive-load-balanced-streams.md"},{"slug":"bifrost-secure-configs-across-environments","title":"Secure configs across environments","description":"When making security-related changes, ensure the configuration is (1) least-privilege/scoped, (2) actually enforced by the platform, and (3) consistent across code/docs.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Security","language":"Yaml","updated":"2026-07-04","comments":4,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-secure-configs-across-environments.md"},{"slug":"bifrost-harden-build-time-paths","title":"Harden build-time paths","description":"When Dockerfile (or build scripts) use build-args/variables to choose target directories for `chown`/`chmod`, validate those paths at build time and fail if they target sensitive directories. This prevents overly-permissive ownership (e.g., group 0 write access) from becoming reachable via undocumented/override knobs.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Security","language":"Dockerfile","updated":"2026-07-04","comments":1,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-harden-build-time-paths.md"},{"slug":"azure-sentinel-deterministic-kql-pipelines","title":"Deterministic KQL Pipelines","description":"Treat each analytics/hunting query as a deterministic algorithm: parse based on the actual encoded input, collapse repeated events by key, and use correct expand/join/re-aggregate patterns so results are complete and non-duplicative.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Algorithms","language":"Yaml","updated":"2026-07-02","comments":5,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-deterministic-kql-pipelines.md"},{"slug":"mcp-correct-pagination-ordering","title":"Correct Pagination Ordering","description":"Ensure algorithmic results (ordering, counts, and pagination) remain correct after filtering/slicing and that sorting/dedup logic is both efficient and deterministic.","repository":"awslabs/mcp","domain":"ai-agents","topic":"Algorithms","language":"Python","updated":"2026-07-02","comments":4,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-correct-pagination-ordering.md"},{"slug":"goose-harden-packaged-inputs","title":"Harden Packaged Inputs","description":"Apply a production/packaged hardening rule: in release builds, only use trusted origins and trusted code/resources. Treat environment variables, URLs, and “implicit” host paths as untrusted inputs, and explicitly gate/validate them so they cannot redirect critical behavior.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2026-07-02","comments":2,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-harden-packaged-inputs.md"},{"slug":"mcp-consistent-configuration-wiring","title":"Consistent Configuration Wiring","description":"Configuration must be internally consistent: what you declare in `pyproject.toml` and document (e.g., env vars) must match what the code actually does, and dependency/tooling choices must align with the project’s toolchain.","repository":"awslabs/mcp","domain":"ai-agents","topic":"Configurations","language":"Toml","updated":"2026-07-02","comments":2,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-consistent-configuration-wiring.md"},{"slug":"omniroute-cache-correctness-rules","title":"Cache correctness rules","description":"Adopt a “cache correctness” checklist for all in-memory/DB caches: 1) Explicit bypass must be honored - If the caller passes a disable value (commonly `ttlMs === 0`), bypass both lookup and inflight coalescing. Don’t treat `0` as “use default TTL”.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Caching","language":"TypeScript","updated":"2026-07-01","comments":7,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-cache-correctness-rules.md"},{"slug":"container-require-download-digests","title":"Require Download Digests","description":"When downloading remote security-sensitive artifacts (e.g., kernels, binaries, containers), require an expected cryptographic digest (e.g., `sha256:<hex>`) and verify it before use. Treat missing digests for custom/variable URLs as a policy violation (fail closed) to prevent unverified or tampered downloads.","repository":"apple/container","domain":"orchestration","topic":"Security","language":"Markdown","updated":"2026-07-01","comments":1,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-require-download-digests.md"},{"slug":"omniroute-idempotent-normalization-pipelines","title":"Idempotent normalization pipelines","description":"When code must normalize or classify structured data (messages, request bodies, model/provider selection, metrics), implement it as deterministic, *idempotent*, and *non-mutating* transformations.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Algorithms","language":"TypeScript","updated":"2026-06-30","comments":7,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-idempotent-normalization-pipelines.md"},{"slug":"axonhub-hot-path-cost-controls","title":"Hot Path Cost Controls","description":"In performance-sensitive paths, actively control hidden costs: cap buffering, reuse expensive compiled primitives, and avoid full serialization/large allocations.","repository":"looplj/axonhub","domain":"llm-infra","topic":"Performance Optimization","language":"Go","updated":"2026-06-30","comments":3,"stars":4808,"raw":"https://awesomereviewers.com/raw/axonhub-hot-path-cost-controls.md"},{"slug":"azure-cli-avoid-editing-generated-history","title":"Avoid editing generated history","description":"If a file is explicitly documented (or implied by the repo’s process) as auto-generated—such as changelog/history files—do not manually edit it in code changes. Instead, revert those edits and update the upstream inputs that drive generation (e.g., PR release-note metadata, templates, or generator configuration), then confirm the regenerated output contains...","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Documentation","language":"Other","updated":"2026-06-30","comments":2,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-avoid-editing-generated-history.md"},{"slug":"9router-sanitize-upstream-stream-errors","title":"Sanitize Upstream Stream Errors","description":"When handling upstream streaming responses (SSE/streaming APIs), treat any non-stream payload (e.g., HTML error pages) as untrusted input: do not pipe it through streaming transforms, and do not reflect raw upstream text/HTML into client errors.","repository":"decolua/9router","domain":"llm-infra","topic":"Security","language":"JavaScript","updated":"2026-06-30","comments":1,"stars":23951,"raw":"https://awesomereviewers.com/raw/9router-sanitize-upstream-stream-errors.md"},{"slug":"bifrost-consistent-test-id-naming","title":"Consistent Test ID Naming","description":"When adding or modifying UI elements, ensure their test/automation identifiers follow the existing naming conventions and remain stable. Apply these rules:","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Naming Conventions","language":"TSX","updated":"2026-06-29","comments":2,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-consistent-test-id-naming.md"},{"slug":"goose-unified-configuration-semantics","title":"Unified configuration semantics","description":"Coding standard: Centralize configuration/credential semantics and never “re-derive” them in multiple places. Read from the real sources (env/config and provider-specific runtime credential caches), preserve provider identity during legacy interop, and let canonical normalizers own final resolution.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Configurations","language":"Rust","updated":"2026-06-28","comments":6,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-unified-configuration-semantics.md"},{"slug":"goose-enforce-security-boundaries-early","title":"Enforce Security Boundaries Early","description":"Apply security controls at the controlling layer and before triggering any side effects. - **Iframe/sandbox:** Treat `sandbox` on ancestor iframes as the effective policy for descendants. Ensure the default sandbox includes any permissions required by the hosted app (otherwise functionality may break or be silently over-restricted).","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Security","language":"TSX","updated":"2026-06-28","comments":2,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-enforce-security-boundaries-early.md"},{"slug":"azure-cli-null-safe-data-access","title":"Null-safe Data Access","description":"Across CLI/API payload handling, treat nullable fields and missing keys as first-class: normalize None before iterating/len’ing, use safe access for nested structures, and validate prerequisites early with clear user errors.","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Null Handling","language":"Python","updated":"2026-06-26","comments":8,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-null-safe-data-access.md"},{"slug":"container-atomic-concurrency-contracts","title":"Atomic Concurrency Contracts","description":"All concurrency-sensitive code must follow an “atomic + lifecycle-valid” contract. **Rules** 1. **Make check-then-act atomic.** If you verify a precondition and then mutate shared state (e.g., “volume not in use => delete”), do both while holding the same synchronization boundary (actor/lock). Prefer closure-based helpers that keep the lock for the whole...","repository":"apple/container","domain":"orchestration","topic":"Concurrency","language":"Swift","updated":"2026-06-26","comments":8,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-atomic-concurrency-contracts.md"},{"slug":"apisix-protocol-phase-correctness","title":"Protocol phase correctness","description":"When writing networking plugins/adapters, make behavior consistent with the request/stream lifecycle and the actual protocol/runtime semantics—then lock it with targeted regression tests.","repository":"apache/apisix","domain":"cloud-infra","topic":"Networking","language":"Other","updated":"2026-06-26","comments":7,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-protocol-phase-correctness.md"},{"slug":"pr-agent-provider-aware-api-contracts","title":"Provider-aware API contracts","description":"External API calls must be routed and shaped using provider/version-aware logic derived from immutable inputs (before any mutation), and idempotency keys must use stable identifiers.","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"API","language":"Python","updated":"2026-06-26","comments":5,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-provider-aware-api-contracts.md"},{"slug":"azure-sentinel-backcompatible-migration-contract","title":"Backcompatible Migration Contract","description":"When making schema/connector changes that can affect existing customer deployments (e.g., new CCF/CL tables, changed table generation behavior), you must preserve backward compatibility as an explicit migration contract: (1) keep stable customer-facing identifiers, (2) provide a compatibility access layer for both old and new schemas, and (3) validate the...","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Migrations","language":"Json","updated":"2026-06-26","comments":4,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-backcompatible-migration-contract.md"},{"slug":"azure-sentinel-align-rbac-and-identity","title":"Align RBAC and Identity","description":"When defining permissions or identities in IaC (ARM/CloudFormation/templates), ensure the security configuration matches the actual runtime auth path and the provider’s supported identity types—avoid “declared-but-unused” privileges and avoid “wrong-scope” resources that create authorization or authentication drift.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Security","language":"Json","updated":"2026-06-26","comments":3,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-align-rbac-and-identity.md"},{"slug":"goose-deterministic-docs-pipelines","title":"Deterministic Docs Pipelines","description":"For CI/CD that builds/publishes documentation (or any release-time artifacts),\\ \\ ensure two things: \\n1) **Correct trigger coverage**: docs-only changes must run\\ \\ the docs build via an explicit workflow path (don’t assume upstream jobs will\\ \\ run). If you use `paths-ignore` to skip heavy pipelines on doc changes, add a\\ \\ separate workflow (or separate trigger) that...","repository":"aaif-goose/goose","domain":"ai-agents","topic":"CI/CD","language":"Yaml","updated":"2026-06-26","comments":2,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-deterministic-docs-pipelines.md"},{"slug":"azure-powershell-standardize-powershell-naming","title":"Standardize PowerShell Naming","description":"Apply consistent, semantic naming to generated cmdlets, parameters, and help/docs. - Cmdlet verb semantics: name sync operations with `Invoke-*` rather than `Start-*`/job-style verbs.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Naming Conventions","language":"Markdown","updated":"2026-06-25","comments":11,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-standardize-powershell-naming.md"},{"slug":"azure-cli-naming-convention-alignment","title":"Naming convention alignment","description":"When adding/adjusting commands, options, helpers, or telemetry, ensure names are (1) semantically accurate and (2) consistent with existing CLI/module conventions.","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Naming Conventions","language":"Python","updated":"2026-06-25","comments":9,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-naming-convention-alignment.md"},{"slug":"azure-powershell-follow-generated-naming","title":"Follow Generated Naming","description":"Use naming-and-identifier rules that match what AutoRest PowerShell generates, and make flag-style parameter typing consistent with the name. Apply these rules when editing custom cmdlets:","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Naming Conventions","language":"Other","updated":"2026-06-25","comments":7,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-follow-generated-naming.md"},{"slug":"azure-sentinel-parameterize-config-values","title":"Parameterize Config Values","description":"When authoring queries/parsers and deployment templates, ensure all environment- or customer-specific values are configurable via parameters (e.g., `let`, `ParserParams`, CloudFormation `Parameters`), and avoid unsafe sample/environment defaults. Also, if you introduce or rely on a standard configuration flag (e.g., additional-fields “pack”), make sure it’s...","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Configurations","language":"Yaml","updated":"2026-06-25","comments":6,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-parameterize-config-values.md"},{"slug":"azure-powershell-align-sdk-contract-types","title":"Align SDK contract types","description":"When updating generated PowerShell/SDK clients (e.g., AutoRest v3 → v4), treat the generated model contract as authoritative: match namespaces/types and ensure request serialization shape matches what the REST service expects.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"API","language":"Other","updated":"2026-06-25","comments":5,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-align-sdk-contract-types.md"},{"slug":"azure-sentinel-cross-service-permission-hardening","title":"Cross-service Permission Hardening","description":"When granting permissions across AWS services (S3→SQS, EventBridge→Lambda, etc.), use the correct permission model and apply least-privilege constraints to prevent confused-deputy and silent authorization failures.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Security","language":"Yaml","updated":"2026-06-25","comments":4,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-cross-service-permission-hardening.md"},{"slug":"azure-powershell-generated-docs-truth","title":"Generated docs truth","description":"When documentation or module metadata files are produced by a generator (e.g., AutoRest), treat those outputs as **generated artifacts**, not as the place to apply fixes. Instead:","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Documentation","language":"Other","updated":"2026-06-25","comments":2,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-generated-docs-truth.md"},{"slug":"azure-sentinel-match-template-parameter-names","title":"Match Template Parameter Names","description":"When documenting or wiring configuration inputs for infrastructure/templates, use the *exact* identifier names from the underlying template (including casing and punctuation), and keep descriptions semantically aligned with the producing service.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Naming Conventions","language":"Markdown","updated":"2026-06-25","comments":2,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-match-template-parameter-names.md"},{"slug":"last30days-skill-secure-env-lookup","title":"Secure env lookup","description":"When writing security-sensitive shell hooks/scripts, resolve credential *presence* safely: don’t read or print secret values, avoid `eval` for variable indirection, and enforce a deterministic, documented precedence order between `ENV_<KEY>` and raw env vars, falling back to OS keychain presence checks.","repository":"mvanhorn/last30days-skill","domain":"security","topic":"Security","language":"Shell","updated":"2026-06-25","comments":1,"stars":57799,"raw":"https://awesomereviewers.com/raw/last30days-skill-secure-env-lookup.md"},{"slug":"bmad-method-graceful-error-recovery","title":"Graceful Error Recovery","description":"Design review/orchestration flows so failures, missing dependencies, and partial automation never corrupt state or silently drop work. Apply these standards:","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Error Handling","language":"Markdown","updated":"2026-06-22","comments":5,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-graceful-error-recovery.md"},{"slug":"bmad-method-automation-mode-ci-contract","title":"Automation Mode CI Contract","description":"When authoring/editing CI-driven “step” scripts for automation, treat `{auto_mode}` as a strict, schema-driven contract: - **No interactive dead-ends:** In `{auto_mode}`, avoid halting/asking. If the invocation (e.g., spec file or staged changes context) lets you infer intent, select the correct option automatically; only prompt if inference truly fails.","repository":"bmad-code-org/bmad-method","domain":"orchestration","topic":"CI/CD","language":"Markdown","updated":"2026-06-22","comments":3,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-automation-mode-ci-contract.md"},{"slug":"omniroute-config-precedence-and-canonical-sources","title":"Config precedence and canonical sources","description":"Establish a single, explicit source-of-truth approach for configuration resolution: (1) honor user-supplied overrides first, (2) otherwise derive from the active context/environment, and (3) only then fall back to defaults; additionally, treat repository-level configuration/lock files as canonical entrypoints for developer tooling.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Configurations","language":"Other","updated":"2026-06-22","comments":2,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-config-precedence-and-canonical-sources.md"},{"slug":"container-stable-api-contracts","title":"Stable API Contracts","description":"When designing or evolving API surfaces (including XPC/wire formats and CLI-to-client contracts), treat the request/response shape as a long-lived contract: keep it semantically high-level, strongly typed, and backward/forward compatible.","repository":"apple/container","domain":"orchestration","topic":"API","language":"Swift","updated":"2026-06-21","comments":6,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-stable-api-contracts.md"},{"slug":"bmad-method-preserve-and-structure-failures","title":"Preserve and Structure Failures","description":"When errors occur—especially in multi-step operations—avoid accidental data loss and avoid “leaking” raw failures. Instead, preserve rollback artifacts and convert errors into documented, structured outcomes.","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Error Handling","language":"Other","updated":"2026-06-21","comments":2,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-preserve-and-structure-failures.md"},{"slug":"bmad-method-containment-and-install-policy","title":"Containment and Install Policy","description":"For security-sensitive filesystem and dependency-install flows, treat any path/ref derived from CLI input or manifests as untrusted: (1) parse/validate it, and (2) strictly contain it to the intended root before any filesystem mutation (copy/swap/delete). Also, keep security posture consistent across equivalent install mechanisms.","repository":"bmad-code-org/bmad-method","domain":"security","topic":"Security","language":"Other","updated":"2026-06-20","comments":4,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-containment-and-install-policy.md"},{"slug":"bifrost-await-connection-drains","title":"Await Connection Drains","description":"When async work depends on a connection that may still be resolving, prevent startup race conditions by (1) deferring the work to an “early” queue instead of silently skipping, and (2) awaiting the connection setup promises before concluding/awaiting the deferred work.","repository":"maximhq/bifrost","domain":"llm-infra","topic":"Concurrency","language":"JavaScript","updated":"2026-06-20","comments":2,"stars":6862,"raw":"https://awesomereviewers.com/raw/bifrost-await-connection-drains.md"},{"slug":"bmad-method-deterministic-file-operations","title":"Deterministic File Operations","description":"When implementing concurrent or bulk filesystem operations, ensure deterministic execution and atomicity: avoid async wrappers/behavior that introduce retry queues or event-loop interleaving that can reorder unlinks/overwrites.","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Concurrency","language":"JavaScript","updated":"2026-06-20","comments":2,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-deterministic-file-operations.md"},{"slug":"supermemory-prefer-react-patterns","title":"Prefer React Patterns","description":"Write React components so state and events are handled using standard React patterns (hooks/state setters correctly, pending/loading comes from React/Form hooks, and key events don’t accidentally trigger default browser behavior). Also, pick the right navigation strategy when component-scoped data must be reset.","repository":"supermemoryai/supermemory","domain":"app-frameworks","topic":"React","language":"TSX","updated":"2026-06-18","comments":4,"stars":28844,"raw":"https://awesomereviewers.com/raw/supermemory-prefer-react-patterns.md"},{"slug":"azure-cli-ci-coverage-and-scope","title":"CI coverage and scope","description":"When changing CI/CD (and related policy configs), ensure your pipeline enforces the expected scope end-to-end: correct review routing, test/version coverage, and validation against the full change set.","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"CI/CD","language":"Yaml","updated":"2026-06-18","comments":3,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-ci-coverage-and-scope.md"},{"slug":"azure-cli-cap-retries-cache-calls","title":"Cap retries, cache calls","description":"For performance-critical code paths, prevent wasted work and unbounded waits: (1) fetch/cache expensive data once (e.g., registry lookups/credentials, repeated GETs) and pass it into helpers; (2) bound polling/retry time with explicit per-attempt and total worst-case limits; (3) add timeouts for slow infrastructure operations.","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Performance Optimization","language":"Python","updated":"2026-06-17","comments":4,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-cap-retries-cache-calls.md"},{"slug":"container-document-config-semantics","title":"Document Config Semantics","description":"When adding/changing configuration, make the meaning and lifecycle of defaults explicit and consistent. Apply this standard: - **Unset vs default:** If a value should be optional, represent it as *unset* by default and ensure all code paths preserve that (avoid implicit backstop defaults that change generated behavior, e.g., DNS records).","repository":"apple/container","domain":"orchestration","topic":"Configurations","language":"Markdown","updated":"2026-06-17","comments":3,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-document-config-semantics.md"},{"slug":"bmad-method-deterministic-parse-merge-rules","title":"Deterministic Parse-Merge Rules","description":"When writing parsing or data-merge algorithms, ensure the logic is context-aware and unambiguous: - Scope semantics to the correct regions. If a formatter/markup has “non-semantic” contexts (e.g., fenced code blocks), your parser must ignore content inside them and only interpret the intended regions.","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Algorithms","language":"Python","updated":"2026-06-17","comments":2,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-deterministic-parse-merge-rules.md"},{"slug":"supermemory-normalize-host-ips","title":"Normalize host IPs","description":"When performing security checks on hosts/IPs (e.g., blocking private/loopback access), don’t rely on brittle string equality. Normalize `URL.hostname` first, because IPv6 literals are often returned in bracket form (e.g., `\"[::1]\"`, `\"[::]\"`), causing dead-code comparisons like `hostname === \"::1\"`.","repository":"supermemoryai/supermemory","domain":"security","topic":"Security","language":"TypeScript","updated":"2026-06-17","comments":1,"stars":28844,"raw":"https://awesomereviewers.com/raw/supermemory-normalize-host-ips.md"},{"slug":"aidlc-workflows-secure-path-confinement","title":"Secure Path Confinement","description":"Enforce security boundaries using robust validation and least-privilege isolation. - For filesystem access restricted to a base directory (e.g., a “run folder”), never use string prefix checks like `str(path).startswith(...)` to prevent `../` traversal or sibling-dir prefix bypasses. Instead, use `Path.is_relative_to`.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Security","language":"Python","updated":"2026-06-16","comments":3,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-secure-path-confinement.md"},{"slug":"bmad-method-deterministic-script-error-handling","title":"Deterministic script error handling","description":"Treat IO and parse failures as first-class outcomes, with behavior that is (a) deterministic, (b) contract-respecting, and (c) strict about “malformed but present” config.","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Error Handling","language":"Python","updated":"2026-06-14","comments":3,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-deterministic-script-error-handling.md"},{"slug":"goose-idempotent-async-initialization","title":"Idempotent Async Initialization","description":"When async flows drive UI state (events, config reads, resume/load), never assume timing/order will be favorable. Make initialization idempotent and conditionally applied so missed/early events or late async completions can’t leave the UI stuck or clobber user intent.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Concurrency","language":"TSX","updated":"2026-06-14","comments":2,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-idempotent-async-initialization.md"},{"slug":"pr-agent-exception-handling-policy","title":"Exception Handling Policy","description":"Adopt an exception-handling standard that distinguishes **critical control-flow** from **non-critical side effects**, while enforcing safe, observable exception patterns.","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2026-06-12","comments":13,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-exception-handling-policy.md"},{"slug":"mcp-region-configuration-consistency","title":"Region configuration consistency","description":"Ensure configuration-dependent behavior (region/profile) is applied consistently from resolution through client creation through every API call. Rules:","repository":"awslabs/mcp","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2026-06-11","comments":6,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-region-configuration-consistency.md"},{"slug":"pi-intentful-comments-and-limits","title":"Intentful Comments And Limits","description":"Add comments that explain *why* the code behaves as it does—especially for platform-specific/terminal/UI quirks—and explicitly document any partial implementation.","repository":"earendil-works/pi","domain":"ai-agents","topic":"Documentation","language":"TypeScript","updated":"2026-06-11","comments":2,"stars":79783,"raw":"https://awesomereviewers.com/raw/pi-intentful-comments-and-limits.md"},{"slug":"azure-cli-readable-lint-safe-code","title":"Readable Lint-Safe Code","description":"When changing code, prioritize readable structure that also passes linters with minimal formatting churn: - Keep formatting linter-safe: avoid re-indenting/alignment that triggers flake8 (e.g., E127). Apply the smallest reformat needed to satisfy style rules.","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Code Style","language":"Python","updated":"2026-06-10","comments":7,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-readable-lint-safe-code.md"},{"slug":"supermemory-sync-api-contracts","title":"Sync API contracts","description":"Ensure API interfaces are trustworthy and API calls fail safely. - Keep typed client contracts aligned with backend reality: if an endpoint exists but is missing from the typed client, prefer updating the contract (or generating client types) over using `disableValidation`. If you must bypass validation temporarily, add a tracked justification.","repository":"supermemoryai/supermemory","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2026-06-10","comments":2,"stars":28844,"raw":"https://awesomereviewers.com/raw/supermemory-sync-api-contracts.md"},{"slug":"iptv-validate-url-query-secrets","title":"Validate URL Query Secrets","description":"When accepting user-provided stream URLs, treat them as security-sensitive input: parse the URL and reject links that appear to contain expiring-session credentials or secrets in the query string. These are typically short/unsigned tokens, hashes, or random identifiers (e.g., nimblesessionid, authid, key, secret, hmac, token, e, ip, st). Such URLs are...","repository":"iptv-org/iptv","domain":"security","topic":"Security","language":"Markdown","updated":"2026-06-07","comments":1,"stars":135586,"raw":"https://awesomereviewers.com/raw/iptv-validate-url-query-secrets.md"},{"slug":"pr-agent-deterministic-safe-clipping","title":"Deterministic Safe Clipping","description":"When collecting, deduplicating, and truncating algorithm outputs (e.g., “top N” items, merged references, ranked suggestions), enforce determinism and configuration-consistent clipping.","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"Algorithms","language":"Python","updated":"2026-06-06","comments":4,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-deterministic-safe-clipping.md"},{"slug":"container-semantic-naming-rules","title":"Semantic Naming Rules","description":"Adopt a “meaning-first” naming standard: identifiers must communicate semantics, representation, and units—so readers can’t guess. Apply: - Match behavior: rename helpers/methods when behavior changes (avoid names like `installDefaultKernel()` if it no longer does “install default”).","repository":"apple/container","domain":"orchestration","topic":"Naming Conventions","language":"Swift","updated":"2026-06-05","comments":8,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-semantic-naming-rules.md"},{"slug":"azure-cli-respect-wire-contracts","title":"Respect Wire Contracts","description":"When calling REST endpoints, ensure the client request/response payload exactly matches the endpoint’s wire contract—especially when GET and PUT/PATCH shapes differ (nested ARM-canonical vs flat service payload) or when envelope fields must be consistent.","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"API","language":"Python","updated":"2026-06-05","comments":6,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-respect-wire-contracts.md"},{"slug":"azure-sentinel-prefer-explicit-projection","title":"Prefer Explicit Projection","description":"When normalizing/querying, keep output schemas deterministic and readable: - Prefer explicit output selection (`project` / `project-keep`) over `project-away`, so adding new columns later won’t accidentally change results.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Code Style","language":"Yaml","updated":"2026-06-05","comments":3,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-prefer-explicit-projection.md"},{"slug":"omniroute-harden-client-url-fetches","title":"Harden Client URL Fetches","description":"Any client-controlled URL (including OpenAI image_url) must be treated as SSRF-/DoS-/parsing-risk input and validated *at every transition* before connecting.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Security","language":"TypeScript","updated":"2026-06-03","comments":8,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-harden-client-url-fetches.md"},{"slug":"azure-cli-concise-correct-cli-help","title":"Concise, Correct CLI Help","description":"CLI help (per-flag short summaries, long summaries, and examples) must be readable, consistent, and executable. Apply these rules: - **Keep per-flag short text short:** Use a single, accurate sentence (with the default when appropriate). Do not exceed the short-help “lane” (avoid overflow).","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Documentation","language":"Python","updated":"2026-06-02","comments":8,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-concise-correct-cli-help.md"},{"slug":"pr-agent-budget-aware-performance","title":"Budget-Aware Performance","description":"When code builds prompts, traverses trees, calls external APIs, or processes many items, make performance predictable by enforcing budgets, preventing pathological inputs, and removing redundant work.","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"Performance Optimization","language":"Python","updated":"2026-06-02","comments":7,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-budget-aware-performance.md"},{"slug":"supermemory-use-robust-error-contracts","title":"Use Robust Error Contracts","description":"Handle errors in a predictable, maintainable way by (1) ensuring all failure-path variables are defined, (2) handling exceptions at one layer (no redundant try/catch), (3) validating external data at boundaries with Zod, and (4) using stable structured error fields instead of brittle string message matching.","repository":"supermemoryai/supermemory","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2026-06-02","comments":4,"stars":28844,"raw":"https://awesomereviewers.com/raw/supermemory-use-robust-error-contracts.md"},{"slug":"azure-quickstart-templates-explicit-api-contracts","title":"Explicit API Contracts","description":"When authoring templates or clients that call/describe APIs (Graph, resource providers, etc.), treat the “API contract” as a first-class design artifact:","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"API","language":"Json","updated":"2026-06-01","comments":7,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-explicit-api-contracts.md"},{"slug":"apisix-deterministic-scoped-ci","title":"Deterministic, scoped CI","description":"CI jobs that build artifacts must be deterministic and guarded, and CI tests must be scoped to avoid unnecessary heavy work. **Apply these rules** 1) **Guard CI assumptions (fail loudly):** If a build-time tweak is required (e.g., removing -march=native leakage), make the script error when the expected input/state isn’t found—never allow a “no-op” edit...","repository":"apache/apisix","domain":"cloud-infra","topic":"CI/CD","language":"Shell","updated":"2026-06-01","comments":2,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-deterministic-scoped-ci.md"},{"slug":"mcp-version-pre-bump-for-releases","title":"Version pre-bump for releases","description":"When your release workflow automatically bumps versions (e.g., increments the patch number), do not set the manifest version to the final release you want. Instead, set it to the documented pre-bump “magic” value so the workflow transforms it into the intended release.","repository":"awslabs/mcp","domain":"ai-agents","topic":"CI/CD","language":"Toml","updated":"2026-05-31","comments":2,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-version-pre-bump-for-releases.md"},{"slug":"omniroute-secure-postmessage-handling","title":"Secure postMessage handling","description":"When handling cross-window `postMessage`, don’t rely on a single `window.location.origin` check—loopback flows (e.g., `localhost` vs `127.0.0.1`) can be legitimate but have different origins. For security, combine: (1) strict message type checking, (2) a whitelist of allowed origins that includes known legitimate loopback variants, and (3) a correlation ID...","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Security","language":"TSX","updated":"2026-05-31","comments":1,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-secure-postmessage-handling.md"},{"slug":"omniroute-regex-guardrails-for-filters","title":"Regex Guardrails for Filters","description":"When implementing CLI output filters (regex/pattern matchers), make the match logic algorithmically safe: add explicit bypass guards for structured/machine-readable output and use precise patterns for command variants, then lock behavior with include/exclude regression tests.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Algorithms","language":"Json","updated":"2026-05-28","comments":3,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-regex-guardrails-for-filters.md"},{"slug":"aidlc-workflows-ci-security-defaults","title":"CI Security Defaults","description":"Default CI/security configuration to minimize risk while keeping automated findings meaningful. Apply these rules: 1) Enforce least-privilege GitHub Actions permissions","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Security","language":"Yaml","updated":"2026-05-28","comments":2,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-ci-security-defaults.md"},{"slug":"goose-immutable-setup-pinning","title":"Immutable Setup Pinning","description":"When your tooling downloads/execut es external installers or scripts, treat both the *source* and the *workspace* as security-sensitive: - **Pin remote code to an immutable reference** (tag/commit SHA) before executing it, so the fetched content can’t change between reviews/runs.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Security","language":"Yaml","updated":"2026-05-28","comments":2,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-immutable-setup-pinning.md"},{"slug":"container-config-resolution-discipline","title":"Config Resolution Discipline","description":"When adding/updating configuration handling, resolve configuration once into a single immutable runtime context, and make precedence/fallback behavior explicit.","repository":"apple/container","domain":"orchestration","topic":"Configurations","language":"Swift","updated":"2026-05-27","comments":5,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-config-resolution-discipline.md"},{"slug":"container-document-invariants-and-changes","title":"Document invariants and changes","description":"When introducing/altering API fields, parsing rules, or behavior, ensure documentation makes the code’s correctness contract explicit. Apply this standard:","repository":"apple/container","domain":"orchestration","topic":"Documentation","language":"Swift","updated":"2026-05-27","comments":5,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-document-invariants-and-changes.md"},{"slug":"omniroute-disable-install-scripts","title":"Disable install scripts","description":"In security-sensitive build environments (e.g., Docker/CI), prevent dependency install/postinstall hooks from executing arbitrary code. Use `npm ci` with `--ignore-scripts` to reduce supply-chain risk, but explicitly rebuild and validate any known native/runtime dependency that truly must compile/bind for the target platform.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Security","language":"Dockerfile","updated":"2026-05-27","comments":1,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-disable-install-scripts.md"},{"slug":"axonhub-type-safe-query-contracts","title":"Type-safe query contracts","description":"When a UI route consumes or produces URL search/query parameters, treat those parameters as a contract: validate and type them at the route boundary, update them through typed helpers (no `as any`), and normalize/omit default-derived fields so the resulting query set is consistent.","repository":"looplj/axonhub","domain":"llm-infra","topic":"API","language":"TSX","updated":"2026-05-26","comments":2,"stars":4808,"raw":"https://awesomereviewers.com/raw/axonhub-type-safe-query-contracts.md"},{"slug":"azure-cli-deterministic-external-testing","title":"Deterministic External Testing","description":"When external services are flaky or untestable, make CI deterministic by (1) pruning recorded interactions to the stable outcomes your playback will actually match, and (2) using narrowly-scoped linter/test exclusions only when a dependency prevents meaningful coverage.","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Testing","language":"Yaml","updated":"2026-05-26","comments":2,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-deterministic-external-testing.md"},{"slug":"kong-consistent-error-propagation","title":"Consistent Error Propagation","description":"When handling failures, choose behavior intentionally: either propagate a real error in a consistent format, or gracefully degrade only for *explicitly non-error* cases (e.g., notifications, permission edge cases). Avoid masking, asserting, or continuing after validation/parsing fails.","repository":"Kong/kong","domain":"cloud-infra","topic":"Error Handling","language":"Other","updated":"2026-05-25","comments":11,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-consistent-error-propagation.md"},{"slug":"bmad-method-strict-input-validation","title":"Strict Input Validation","description":"Always validate and constrain any user-controlled or data-driven strings (IDs, slugs, CLI flags, manifest/CSV fields) before using them to build paths, filenames, or subprocess commands, and apply defense-in-depth against common classes of attacks.","repository":"bmad-code-org/bmad-method","domain":"security","topic":"Security","language":"JavaScript","updated":"2026-05-25","comments":6,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-strict-input-validation.md"},{"slug":"bmad-method-single-source-config","title":"Single Source Config","description":"Ensure configuration is maintainable and compatible by (1) using a single authoritative field and deriving dependent values at runtime, and (2) pinning configuration-relevant dependency versions when they enforce runtime compatibility (e.g., CommonJS vs ESM) until you intentionally migrate.","repository":"bmad-code-org/bmad-method","domain":"cloud-infra","topic":"Configurations","language":"Json","updated":"2026-05-25","comments":2,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-single-source-config.md"},{"slug":"apisix-verify-download-integrity","title":"Verify Download Integrity","description":"When your code/CI downloads third-party binaries or packages and then installs them, verify integrity before installation (preferably SHA256/SHA256+signature). Store the expected checksum in versioned configuration keyed by the artifact/runtime version, and update it whenever you bump that version. Fail closed on mismatch.","repository":"apache/apisix","domain":"cloud-infra","topic":"Security","language":"Shell","updated":"2026-05-25","comments":1,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-verify-download-integrity.md"},{"slug":"azure-cli-avoid-glob-file-mutation","title":"Avoid glob file mutation","description":"When automation modifies local files, don’t use broad filename globs that could match unexpected or attacker-controlled artifacts. Prefer deterministic, explicit paths/filenames (or fail closed). If a glob is unavoidable, validate that the matched file is exactly the expected artifact (e.g., match a known versioned filename pattern) before changing it.","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Security","language":"Other","updated":"2026-05-25","comments":1,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-avoid-glob-file-mutation.md"},{"slug":"pi-explicit-extensible-apis","title":"Explicit, Extensible APIs","description":"When designing/adjusting API surfaces, ensure (1) consumers can clearly understand what they’re setting and what defaults apply, (2) implementation-only details don’t leak into public types, and (3) variant-specific behavior is routed through dedicated abstractions/resolvers rather than embedded special-cases.","repository":"earendil-works/pi","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2026-05-22","comments":4,"stars":79783,"raw":"https://awesomereviewers.com/raw/pi-explicit-extensible-apis.md"},{"slug":"apisix-fail-fast-artifact-downloads","title":"Fail-fast artifact downloads","description":"For required build/CI artifacts, make the reference configurable (with a sensible default) and fetch them with fail-fast settings so HTTP errors, missing files, or bad refs stop the build immediately.","repository":"apache/apisix","domain":"cloud-infra","topic":"Error Handling","language":"Shell","updated":"2026-05-21","comments":2,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-fail-fast-artifact-downloads.md"},{"slug":"omniroute-externalize-config-copy","title":"Externalize config copy","description":"Treat user-facing UI text (help text, labels, descriptions, toggle text) as configuration: do not hardcode it in components. Instead, source it from the appropriate translation/config namespace using the team’s i18n helpers. Keep only upstream/system-provided constants (e.g., IDs, template metadata) as raw values when they are not user copy.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Configurations","language":"TSX","updated":"2026-05-21","comments":2,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-externalize-config-copy.md"},{"slug":"apisix-config-contract-accuracy","title":"Config Contract Accuracy","description":"Ensure configuration documentation and validation rules match the real runtime contract: types/structures, default values, actual scope, and when validation happens.","repository":"apache/apisix","domain":"cloud-infra","topic":"Configurations","language":"Markdown","updated":"2026-05-19","comments":4,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-config-contract-accuracy.md"},{"slug":"pi-reliable-integration-tests","title":"Reliable integration tests","description":"Integration/E2E tests should be structured and isolated: use consistent fixture setup/teardown to avoid flakiness and leftover files, and organize higher-level tests using reusable helpers and known-good inputs/models.","repository":"earendil-works/pi","domain":"ai-agents","topic":"Testing","language":"TypeScript","updated":"2026-05-19","comments":2,"stars":79783,"raw":"https://awesomereviewers.com/raw/pi-reliable-integration-tests.md"},{"slug":"container-use-structured-logger-consistently","title":"Use structured logger consistently","description":"Adopt a single logging approach across commands and services: - **Never use `print`/direct `FileHandle.standardError.write` in production code** for user-facing or diagnostic messages. Use `Logger`.","repository":"apple/container","domain":"orchestration","topic":"Logging","language":"Swift","updated":"2026-05-17","comments":10,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-use-structured-logger-consistently.md"},{"slug":"pi-prefer-cohesive-modules","title":"Prefer cohesive modules","description":"Keep the repository’s module structure and implementations cohesive and non-redundant. Apply these rules: - **Don’t add “single-purpose” files for trivial helpers**: if a function belongs next to its call site (or in an existing utility module), move it there instead of creating a standalone file.","repository":"earendil-works/pi","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2026-05-17","comments":5,"stars":79783,"raw":"https://awesomereviewers.com/raw/pi-prefer-cohesive-modules.md"},{"slug":"bmad-method-defensive-null-handling","title":"Defensive Null Handling","description":"When values are optional (undefined/null), external data can be malformed, or runtime internals may not exist, code should *guard first* and choose safe, backward-compatible defaults instead of relying on truthiness.","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Null Handling","language":"JavaScript","updated":"2026-05-16","comments":4,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-defensive-null-handling.md"},{"slug":"apisix-secure-examples-correctness","title":"Secure examples correctness","description":"When implementing or documenting security-related plugins/features, ensure examples are both *secure* and *operationally correct*: avoid leaking sensitive data, match cookie/transport settings, use the correct authentication header formats, and ensure authentication happens before authorization/restriction.","repository":"apache/apisix","domain":"cloud-infra","topic":"Security","language":"Markdown","updated":"2026-05-15","comments":5,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-secure-examples-correctness.md"},{"slug":"goose-migration-consistency-rules","title":"Migration consistency rules","description":"When changing config schemas, treat migrations as part of the API contract: migrations must be safe under partial/legacy states and must not cause read/write skew that overwrites migrated data.","repository":"aaif-goose/goose","domain":"ai-agents","topic":"Migrations","language":"Rust","updated":"2026-05-14","comments":5,"stars":51876,"raw":"https://awesomereviewers.com/raw/goose-migration-consistency-rules.md"},{"slug":"omniroute-local-clarity-standards","title":"Local Clarity Standards","description":"When updating code, optimize for local clarity and correctness, not “cleanup” by indirection. Apply these rules: 1) Prefer locality over forced DRY - If a constant/abstraction is used once, keep it local. Don’t add module-scope indirection unless it materially improves maintainability.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Code Style","language":"TypeScript","updated":"2026-05-13","comments":9,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-local-clarity-standards.md"},{"slug":"azure-quickstart-templates-environment-driven-parameters","title":"Environment-Driven Parameters","description":"When a template needs configuration that varies by environment/cloud/region or depends on real resource identifiers, do not hardcode endpoints/locations or fabricate subscription/RG paths. Instead:","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Configurations","language":"Json","updated":"2026-05-13","comments":8,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-environment-driven-parameters.md"},{"slug":"azure-quickstart-templates-semantic-and-stable-naming","title":"Semantic And Stable Naming","description":"Use names that clearly convey intent, keep them consistent across related resources, and ensure deterministic uniqueness. **1) Make names/intents self-explanatory**","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Naming Conventions","language":"Other","updated":"2026-05-13","comments":7,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-semantic-and-stable-naming.md"},{"slug":"bmad-method-escape-and-whitelist","title":"Escape and whitelist","description":"When rendering HTML (or HTML-like outputs) from structured data, treat every field as potentially hostile—even if produced internally. Apply two layers:","repository":"bmad-code-org/bmad-method","domain":"security","topic":"Security","language":"Python","updated":"2026-05-13","comments":1,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-escape-and-whitelist.md"},{"slug":"container-prefer-readable-conditionals","title":"Prefer Readable Conditionals","description":"When updating or adding code, keep control flow and non-trivial expressions easy to reason about. Rules of thumb: - Avoid nested ternary operators; use `switch` (or equivalent) for branching decisions.","repository":"apple/container","domain":"orchestration","topic":"Code Style","language":"Swift","updated":"2026-05-11","comments":5,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-prefer-readable-conditionals.md"},{"slug":"azure-powershell-production-safe-configuration","title":"Production-Safe Configuration","description":"When changing build/test/configuration files, ensure they are (1) platform-correct and (2) production-safe. Apply this standard: 1) Platform-correct environment/config updates","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Configurations","language":"Yaml","updated":"2026-05-11","comments":2,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-production-safe-configuration.md"},{"slug":"celery-semantic-ordering-guards","title":"Semantic ordering guards","description":"When code depends on ordering/selection (scheduling, routing, matching), implement it using *semantic* state and *explicit* guard windows—avoid brittle string checks and avoid guards that assume “typical” transition times.","repository":"celery/celery","domain":"orchestration","topic":"Algorithms","language":"Python","updated":"2026-05-10","comments":4,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-semantic-ordering-guards.md"},{"slug":"redis-improve-readability-style","title":"Improve Readability Style","description":"Adopt a “review-first” style for complex C code: keep control flow and conditions small, make side effects explicit, and avoid duplication. Key rules:","repository":"redis/redis","domain":"data-systems","topic":"Code Style","language":"C","updated":"2026-05-09","comments":8,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-improve-readability-style.md"},{"slug":"apisix-api-contract-consistency","title":"API contract consistency","description":"When defining or documenting APIs/plugins, ensure the declared contract matches how the system actually resolves requests and config fields. Validate examples and client expectations against these checks:","repository":"apache/apisix","domain":"cloud-infra","topic":"API","language":"Markdown","updated":"2026-05-09","comments":5,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-api-contract-consistency.md"},{"slug":"langchain-harden-untrusted-inputs","title":"Harden Untrusted Inputs","description":"When code uses externally influenced data (URLs, hostnames, user-provided strings, identifiers) across trust boundaries, treat it as hostile and apply layered defenses:","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"Security","language":"Python","updated":"2026-05-09","comments":5,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-harden-untrusted-inputs.md"},{"slug":"ragflow-http-timeout-strategy","title":"HTTP Timeout Strategy","description":"Standardize how you apply timeouts for outbound HTTP requests. - If the shared `http.Client` already sets `Timeout`, do **not** also wrap each request with `context.WithTimeout` (it’s redundant and can make behavior harder to reason about).","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Networking","language":"Go","updated":"2026-05-09","comments":4,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-http-timeout-strategy.md"},{"slug":"ragflow-strict-external-api-validation","title":"Strict External API Validation","description":"When integrating with external AI/HTTP APIs, treat both transport errors and payload validity as first-class failures. Validate inputs, verify provider/HTTP status, and enforce response invariants—never silently accept partial or malformed data.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Error Handling","language":"Go","updated":"2026-05-09","comments":4,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-strict-external-api-validation.md"},{"slug":"omniroute-shared-api-contracts","title":"Shared API Contracts","description":"Design API endpoints so they orchestrate transport only, and keep domain logic + contract identifiers centralized. Apply these rules: 1) **Don’t couple libraries to route handlers**: HTTP-specific code (request/response/headers/params) stays in `route.ts`; core behavior (embeddings, memory indexing, etc.) lives in shared services used by both the API route...","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"API","language":"TSX","updated":"2026-05-09","comments":2,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-shared-api-contracts.md"},{"slug":"ragflow-api-contract-verification","title":"API Contract Verification","description":"When adding/updating model-to-endpoint configuration, verify it against the provider’s official API docs and enforce the expected request/response contract.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"API","language":"Json","updated":"2026-05-09","comments":2,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-api-contract-verification.md"},{"slug":"redis-explicit-build-flags","title":"Explicit Build Flags","description":"Ensure build configuration explicitly sets (1) include paths and (2) required language/toolchain modes to prevent environment-dependent header resolution and compiler-mode breakages.","repository":"redis/redis","domain":"data-systems","topic":"Configurations","language":"Other","updated":"2026-05-09","comments":2,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-explicit-build-flags.md"},{"slug":"freecodecamp-documentation-clarity-rules","title":"Documentation clarity rules","description":"When writing technical curriculum/docs, ensure the content is (a) accurate, (b) unambiguous about what learners must do and what the expected output/input is, and (c) consistent in formatting and tone.","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"Documentation","language":"Markdown","updated":"2026-05-08","comments":10,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-documentation-clarity-rules.md"},{"slug":"ragflow-bound-work-and-queries","title":"Bound Work and Queries","description":"When improving performance, make sure code neither (a) fetches too much data, nor (b) does the same expensive work repeatedly, nor (c) runs unbounded workloads.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Performance Optimization","language":"Python","updated":"2026-05-08","comments":9,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-bound-work-and-queries.md"},{"slug":"warp-structured-meaningful-tests","title":"Structured, Meaningful Tests","description":"Tests should follow consistent structure and provide high-signal coverage. Apply these rules: 1) Put tests in dedicated files - Follow the repo convention: place unit tests in separate `*_tests.rs` (or `*_test.rs`) files, not inline `#[cfg(test)] mod tests { ... }` blocks.","repository":"warpdotdev/warp","domain":"devtools","topic":"Testing","language":"Rust","updated":"2026-05-08","comments":9,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-structured-meaningful-tests.md"},{"slug":"freecodecamp-consistent-snippet-style","title":"Consistent Snippet Style","description":"All code snippets, hints, seed code, and automated checks must follow a single, consistent formatting and style contract—especially around quote usage and basic JS/TS syntax.","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"Code Style","language":"Markdown","updated":"2026-05-08","comments":8,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-consistent-snippet-style.md"},{"slug":"freecodecamp-express-error-handling","title":"Express error handling","description":"For Express apps, standardize error handling as follows: - Define error-handling middleware with the correct signature: `(err, req, res, next)`. - Register it last in the middleware chain (after routes). If you add a 404 handler, place it after routes but before the error handler.","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"Error Handling","language":"Markdown","updated":"2026-05-08","comments":7,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-express-error-handling.md"},{"slug":"warp-config-gating-and-validation","title":"Config Gating And Validation","description":"When behavior depends on platform features, build features, feature flags, or user-provided configuration, keep it explicitly scoped and validated. Apply this checklist:","repository":"warpdotdev/warp","domain":"devtools","topic":"Configurations","language":"Rust","updated":"2026-05-08","comments":7,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-config-gating-and-validation.md"},{"slug":"warp-extract-shared-helpers","title":"Extract Shared Helpers","description":"When review finds repeated or “very similar” logic patterns, don’t leave copy-paste growth—refactor into a shared helper, and follow local file conventions so future edits don’t diverge.","repository":"warpdotdev/warp","domain":"devtools","topic":"Code Style","language":"Rust","updated":"2026-05-08","comments":7,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-extract-shared-helpers.md"},{"slug":"warp-explicit-missing-state-handling","title":"Explicit Missing-State Handling","description":"When data is optional/unknown, handle it intentionally and explicitly—either skip the feature (return `None`) or fall back to a safe default—never via implicit drop or placeholder sentinel values.","repository":"warpdotdev/warp","domain":"devtools","topic":"Null Handling","language":"Rust","updated":"2026-05-08","comments":6,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-explicit-missing-state-handling.md"},{"slug":"warp-purpose-driven-documentation","title":"Purpose-Driven Documentation","description":"When adding or modifying code, ensure comments/doc comments are written to explain meaning and rationale—not just what the code does or where it’s mutated.","repository":"warpdotdev/warp","domain":"devtools","topic":"Documentation","language":"Rust","updated":"2026-05-08","comments":6,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-purpose-driven-documentation.md"},{"slug":"warp-semantic-contract-revealing-names","title":"Semantic, Contract-Revealing Names","description":"Use naming that matches the code’s actual semantics and data contracts—avoid misleading terms and generic parameter names. Apply these rules: - Behavior-accurate wording: don’t use terms like “unset” when the implementation “restores”/“replaces” a previous value.","repository":"warpdotdev/warp","domain":"devtools","topic":"Naming Conventions","language":"Rust","updated":"2026-05-08","comments":6,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-semantic-contract-revealing-names.md"},{"slug":"freecodecamp-middleware-and-status-semantics","title":"Middleware and Status Semantics","description":"When building API endpoints with Express, make request lifecycle control-flow and response semantics explicit and consistent: - Middleware chaining: only call `next()` when you intend to continue to the next middleware/handler; if you don’t call `next()`, the request-response cycle will stop.","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"API","language":"Markdown","updated":"2026-05-08","comments":5,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-middleware-and-status-semantics.md"},{"slug":"freecodecamp-middleware-ordering-and-chaining","title":"Middleware ordering and chaining","description":"When using Express, treat middleware registration as an HTTP request-processing pipeline: middleware executes in the order you add it, and the chain advances only if your middleware calls `next()`.","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"Networking","language":"Markdown","updated":"2026-05-08","comments":5,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-middleware-ordering-and-chaining.md"},{"slug":"warp-deterministic-matching-invariants","title":"Deterministic Matching Invariants","description":"When implementing algorithms for pairing/alignment, matching/routing, search, or event fan-out, require a clearly stated invariant and explicit boundary/edge-case behavior, then back it with targeted tests.","repository":"warpdotdev/warp","domain":"devtools","topic":"Algorithms","language":"Markdown","updated":"2026-05-08","comments":5,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-deterministic-matching-invariants.md"},{"slug":"warp-type-safe-api-boundaries","title":"Type-Safe API Boundaries","description":"APIs that cross module boundaries, wire formats, or event streams should be designed so callers can’t accidentally construct invalid requests or rely on unstable semantics.","repository":"warpdotdev/warp","domain":"devtools","topic":"API","language":"Rust","updated":"2026-05-08","comments":5,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-type-safe-api-boundaries.md"},{"slug":"warp-secret-and-inert-safety","title":"Secret and Inert Safety","description":"When handling auth secrets, user directory/path-based configuration, or shell-generated code, treat any value that could reveal identity/organization or execute code as *sensitive* and *untrusted by default*.","repository":"warpdotdev/warp","domain":"devtools","topic":"Security","language":"Markdown","updated":"2026-05-08","comments":4,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-secret-and-inert-safety.md"},{"slug":"omniroute-fail-closed-security-invariants","title":"Fail-Closed Security Invariants","description":"Default to secure behavior when you can’t verify. If a security-relevant check (e.g., whether encrypted credentials exist) or its dependencies (e.g., DB access) fails, treat the state as unsafe and stop or require explicit recovery—never assume “nothing to decrypt.” Also, preserve cross-component encryption/decryption invariants (prefix/salt/format) so that...","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Security","language":"Other","updated":"2026-05-08","comments":3,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-fail-closed-security-invariants.md"},{"slug":"warp-bounded-recovery-with-timeouts","title":"Bounded Recovery With Timeouts","description":"Implement failure handling so recovery is (1) bounded, (2) never hangs indefinitely, and (3) has explicit validation + deterministic fallback. Apply this when adding retries, polling for readiness, or supporting boundary-specific execution paths:","repository":"warpdotdev/warp","domain":"devtools","topic":"Error Handling","language":"Markdown","updated":"2026-05-08","comments":3,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-bounded-recovery-with-timeouts.md"},{"slug":"warp-cache-invalidation-rules","title":"Cache invalidation rules","description":"Any cached value must have an explicit, testable “when does it become stale?” policy, plus a fallback path when updates may be missed. Apply this as a checklist:","repository":"warpdotdev/warp","domain":"devtools","topic":"Caching","language":"Markdown","updated":"2026-05-08","comments":3,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-cache-invalidation-rules.md"},{"slug":"deepseek-tui-normalize-security-inputs","title":"Normalize security inputs","description":"For any security-sensitive policy/matching logic (authZ/exec policies, allow/deny rules, pattern matching), always canonicalize the relevant inputs before matching, and ensure edge cases like absolute-path `..` are handled safely to prevent bypass.","repository":"Hmbown/DeepSeek-TUI","domain":"ai-agents","topic":"Security","language":"Rust","updated":"2026-05-08","comments":1,"stars":21278,"raw":"https://awesomereviewers.com/raw/deepseek-tui-normalize-security-inputs.md"},{"slug":"warp-bound-large-work","title":"Bound Large Work","description":"When code performs expensive IO/compute or reacts to frequent events, (1) gate side effects to meaningful state changes, (2) bound or chunk large inputs/outputs before allocation or heavy processing, and (3) cache/share to avoid repeated recomputation and deep clones.","repository":"warpdotdev/warp","domain":"devtools","topic":"Performance Optimization","language":"Rust","updated":"2026-05-07","comments":8,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-bound-large-work.md"},{"slug":"redis-correct-fast-path-semantics","title":"Correct Fast-Path Semantics","description":"When implementing algorithmic optimizations (fast paths, binary search vs linear, prefetch/slot routing, realloc/compaction shortcuts), require *semantic correctness* and *invariant preservation* before performance.","repository":"redis/redis","domain":"data-systems","topic":"Algorithms","language":"C","updated":"2026-05-07","comments":7,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-correct-fast-path-semantics.md"},{"slug":"warp-graceful-error-semantics","title":"Graceful Error Semantics","description":"Define and implement explicit, user- and operator-facing error semantics for async/protocol code: handle recoverable/expected mismatches without panicking, make failure outcomes observable, and ensure recovery/retry behavior is bounded and well-specified.","repository":"warpdotdev/warp","domain":"devtools","topic":"Error Handling","language":"Rust","updated":"2026-05-07","comments":6,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-graceful-error-semantics.md"},{"slug":"warp-doc-exactness-standard","title":"Doc exactness standard","description":"Adopt a “docs must be executable-accurate” standard: treat technical docs/specs/changelogs as part of the product contract, and ensure they exactly match current behavior, supported formats, and rendering constraints.","repository":"warpdotdev/warp","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2026-05-07","comments":5,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-doc-exactness-standard.md"},{"slug":"warp-cache-key-consistency","title":"Cache Key Consistency","description":"When you cache UI/model state, make the cache key and lifecycle unambiguous: - **Key boundary:** Perform the cache lookup using the exact key form the cache was populated with. Apply normalization/transformation *after* the lookup (only when constructing the output key/label), unless you also normalize consistently when inserting.","repository":"warpdotdev/warp","domain":"devtools","topic":"Caching","language":"Rust","updated":"2026-05-07","comments":4,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-cache-key-consistency.md"},{"slug":"warp-sse-and-sync-eligibility","title":"SSE and Sync Eligibility","description":"When implementing networking/event-streaming and bidirectional sync, make event delivery correctness explicit: who owns the subscription, who owns cursor advancement, and whether an event should be echoed back.","repository":"warpdotdev/warp","domain":"devtools","topic":"Networking","language":"Rust","updated":"2026-05-07","comments":4,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-sse-and-sync-eligibility.md"},{"slug":"agent-zero-endpoint-auth-validation","title":"Endpoint Auth Validation","description":"For security-sensitive flows (WS/API, authenticated cloning, token/API-key auth), don’t rely on generic or heuristic validation. Apply these rules: 1) Validate with explicit allow/deny semantics","repository":"agent0ai/agent-zero","domain":"ai-agents","topic":"Security","language":"Python","updated":"2026-05-07","comments":3,"stars":17612,"raw":"https://awesomereviewers.com/raw/agent-zero-endpoint-auth-validation.md"},{"slug":"tradingagents-null-and-empty-handling","title":"Null and Empty Handling","description":"Apply a consistent null/empty handling pattern for configuration and user-provided values: - Treat “present but empty” inputs (e.g., env vars set to `\"\"`) as invalid rather than silently falling back. Prefer behavior that surfaces a clear configuration error.","repository":"TauricResearch/TradingAgents","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2026-05-07","comments":3,"stars":71953,"raw":"https://awesomereviewers.com/raw/tradingagents-null-and-empty-handling.md"},{"slug":"warp-deterministic-ci-gates","title":"Deterministic CI Gates","description":"All CI/CD automation should be deterministic, machine-independent, and enforced via failing gates—never relying on “latest tag,” unstated baselines, or author-local tooling.","repository":"warpdotdev/warp","domain":"devtools","topic":"CI/CD","language":"Markdown","updated":"2026-05-07","comments":3,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-deterministic-ci-gates.md"},{"slug":"azure-quickstart-templates-enforce-security-prereqs","title":"Enforce Security Prereqs","description":"Ensure infrastructure/code templates explicitly and correctly handle the two most common security failure points: (1) required authorization for identities to perform discovery/monitoring, and (2) strict validation of user-supplied parameters.","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Security","language":"Markdown","updated":"2026-05-07","comments":2,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-enforce-security-prereqs.md"},{"slug":"redis-failclamp-error-contracts","title":"Fail/Clamp Error Contracts","description":"When implementing commands with numeric failure modes (overflow, out-of-range, NaN/Inf) or multi-option parsing, define an explicit error contract and enforce it end-to-end:","repository":"redis/redis","domain":"data-systems","topic":"Error Handling","language":"C","updated":"2026-05-06","comments":8,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-failclamp-error-contracts.md"},{"slug":"warp-secure-input-and-secret-handling","title":"Secure Input and Secret Handling","description":"Adopt a consistent rule: anything coming from persistence, other platforms/accounts, terminal escape sequences, or secret-managed inputs must be validated/normalized and handled with collision-safe, non-injectable, non-leaky logic.","repository":"warpdotdev/warp","domain":"devtools","topic":"Security","language":"Rust","updated":"2026-05-06","comments":8,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-secure-input-and-secret-handling.md"},{"slug":"warp-serialize-async-per-key","title":"Serialize async per-key","description":"Ensure async/stateful flows are race-free by avoiding overlapping work for the same logical key and by handling events that arrive before the relevant state is ready.","repository":"warpdotdev/warp","domain":"devtools","topic":"Concurrency","language":"Rust","updated":"2026-05-06","comments":5,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-serialize-async-per-key.md"},{"slug":"azure-cli-normalize-before-compare","title":"Normalize Before Compare","description":"When implementing validation, duplicate detection, or search over structured inputs, first canonicalize (normalize) the representations and make comparisons match the domain semantics (case-insensitive, order-insensitive, whitespace-tolerant, etc.). Never compare raw strings/fields directly when the same meaning can be represented in multiple equivalent...","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Algorithms","language":"Python","updated":"2026-05-06","comments":4,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-normalize-before-compare.md"},{"slug":"warp-invariant-diff-matching","title":"Invariant Diff Matching","description":"When implementing matching/diff logic (especially for code/entities), define and test the algorithmic invariants you rely on, and avoid fragile heuristics.","repository":"warpdotdev/warp","domain":"devtools","topic":"Algorithms","language":"Rust","updated":"2026-05-06","comments":4,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-invariant-diff-matching.md"},{"slug":"deepseek-tui-explicitly-initialize-inputs","title":"Explicitly Initialize Inputs","description":"Ensure every required value is explicitly initialized/propagated across both configuration variants and process boundaries. Do not rely on “it will be set implicitly” behavior—new fields or external inputs can end up effectively undefined/empty.","repository":"Hmbown/DeepSeek-TUI","domain":"ai-agents","topic":"Null Handling","language":"Rust","updated":"2026-05-06","comments":2,"stars":21278,"raw":"https://awesomereviewers.com/raw/deepseek-tui-explicitly-initialize-inputs.md"},{"slug":"python-docstring-standards","title":"Docstring Standards","description":"Apply a single documentation rule set across the codebase: - **Module/file docstring:** Each file should have a clear module-level docstring **before any imports**.","repository":"TheAlgorithms/Python","domain":"docs","topic":"Documentation","language":"Python","updated":"2026-05-05","comments":19,"stars":220912,"raw":"https://awesomereviewers.com/raw/python-docstring-standards.md"},{"slug":"python-validate-inputs-explicitly","title":"Validate Inputs Explicitly","description":"Enforce each function’s documented input contract with early, explicit checks; raise specific exceptions with accurate messages (avoid asserts, silent fallbacks/defaults, and misleading error paths after normalization). Keep try/except blocks as narrow as possible—only around the operations that can fail.","repository":"TheAlgorithms/Python","domain":"docs","topic":"Error Handling","language":"Python","updated":"2026-05-05","comments":11,"stars":220912,"raw":"https://awesomereviewers.com/raw/python-validate-inputs-explicitly.md"},{"slug":"redis-bounded-prefetch-batches","title":"Bounded Prefetch Batches","description":"When adding performance optimizations (prefetch/batching/fast paths), make them bounded, gated, and semantics-correct: - **Bound the work**: use fixed small batch sizes (e.g., 16) and stack-backed buffers with a safe default cap; avoid strategies where user-controlled sizes can force huge allocations (e.g., `vecReserve(count)` without a ceiling).","repository":"redis/redis","domain":"data-systems","topic":"Performance Optimization","language":"C","updated":"2026-05-05","comments":9,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-bounded-prefetch-batches.md"},{"slug":"redis-fail-fast-input-validation","title":"Fail Fast Input Validation","description":"Apply a single security rule: validate arity, lengths, ranges, and invariants before using inputs to index arrays, dereference pointers, compute derived pointers, or persist/serialize into security-sensitive targets.","repository":"redis/redis","domain":"data-systems","topic":"Security","language":"C","updated":"2026-05-05","comments":8,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-fail-fast-input-validation.md"},{"slug":"python-algorithm-correctness-standards","title":"Algorithm Correctness Standards","description":"When implementing algorithms, enforce correctness and reliability by following this checklist: 1) Validate stated preconditions (and document them) - If the algorithm only works for certain input ranges/shapes (e.g., cyclic sort requires values in 1..n with no duplicates), explicitly check those conditions and fail fast with a clear error.","repository":"TheAlgorithms/Python","domain":"docs","topic":"Algorithms","language":"Python","updated":"2026-05-05","comments":6,"stars":220912,"raw":"https://awesomereviewers.com/raw/python-algorithm-correctness-standards.md"},{"slug":"agent-skills-explicit-vercel-configuration","title":"Explicit Vercel Configuration","description":"Treat Vercel deployment as a configuration contract: declare dependency/version/runtime settings explicitly and align your code layout with Vercel’s discovery (or override it explicitly).","repository":"vercel-labs/agent-skills","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2026-05-05","comments":5,"stars":26385,"raw":"https://awesomereviewers.com/raw/agent-skills-explicit-vercel-configuration.md"},{"slug":"warp-explicit-build-configuration","title":"Explicit build configuration","description":"Build-time behavior that depends on versions, paths, or external metadata should be configured explicitly and reproducibly—never implicitly via network calls or brittle patching.","repository":"warpdotdev/warp","domain":"devtools","topic":"Configurations","language":"Other","updated":"2026-05-05","comments":3,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-explicit-build-configuration.md"},{"slug":"warp-explicit-logging-for-channels","title":"Explicit logging for channels","description":"When log behavior depends on configuration (e.g., `WARP_CHANNEL`) or when scripts auto-select an environment/tool (e.g., which Xcode app to use), make the behavior explicit and observable:","repository":"warpdotdev/warp","domain":"devtools","topic":"Logging","language":"Other","updated":"2026-05-05","comments":2,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-explicit-logging-for-channels.md"},{"slug":"warp-workflow-safety-defaults","title":"Workflow safety defaults","description":"When authoring CI/CD workflows, make configuration choices that (1) match the actual capabilities required by downstream steps and (2) use conservative, contributor-safe defaults for automated cleanup.","repository":"warpdotdev/warp","domain":"devtools","topic":"CI/CD","language":"Yaml","updated":"2026-05-05","comments":2,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-workflow-safety-defaults.md"},{"slug":"openai-python-standardize-typed-errors","title":"Standardize Typed Errors","description":"Use consistent, typed exceptions at the point of failure, with structured context, and never rely on unchecked/bypassed paths that convert errors into later crashes.","repository":"openai/openai-python","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2026-05-04","comments":9,"stars":30731,"raw":"https://awesomereviewers.com/raw/openai-python-standardize-typed-errors.md"},{"slug":"freecodecamp-consistent-identifier-naming","title":"Consistent Identifier Naming","description":"When updating curriculum challenges or UI code, ensure all identifiers are spelled, cased, and named consistently across: the prompt, hints, and what tests/DOM queries expect. Also use framework-correct attribute names (e.g., JSX `className`) and semantic, descriptive labels for user-facing accessibility (e.g., informative `alt` text).","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"Naming Conventions","language":"Markdown","updated":"2026-05-04","comments":8,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-consistent-identifier-naming.md"},{"slug":"openai-python-secure-auth-and-logging","title":"Secure Auth and Logging","description":"Security-sensitive code must ensure (1) the correct auth path is used without accidental overrides, (2) sensitive auth material is never leaked in logs, and (3) auth-mode “sentinels” and provider handles can’t be accidentally triggered or misused.","repository":"openai/openai-python","domain":"ai-agents","topic":"Security","language":"Python","updated":"2026-05-04","comments":8,"stars":30731,"raw":"https://awesomereviewers.com/raw/openai-python-secure-auth-and-logging.md"},{"slug":"redis-api-contracts-and-compatibility","title":"API Contracts And Compatibility","description":"When adding or evolving APIs (commands, module interfaces, persistence callbacks), make the contract explicit and stable: define lifecycle rules, invariants, grammar, and compatibility boundaries, and ensure implementations preserve existing behavior (including error/return types) across encodings and versions.","repository":"redis/redis","domain":"data-systems","topic":"API","language":"C","updated":"2026-05-04","comments":8,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-api-contracts-and-compatibility.md"},{"slug":"openai-python-behavior-first-pytest-testing","title":"Behavior-First Pytest Testing","description":"Write tests that are pytest-native, high-signal, and behavior-focused. Apply these rules: - Prefer observable behavior over internal plumbing: assert what the client uses during the request lifecycle (e.g., what headers are present when a request is made or when `auth_headers` is accessed), not just that a helper method mutates a field.","repository":"openai/openai-python","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2026-05-04","comments":6,"stars":30731,"raw":"https://awesomereviewers.com/raw/openai-python-behavior-first-pytest-testing.md"},{"slug":"warp-explicit-partial-success-semantics","title":"Explicit Partial-Success Semantics","description":"When an API operation can be “partially successful” (or yields an empty but non-error outcome), encode that distinction explicitly in the response/protocol so callers can take correct next actions.","repository":"warpdotdev/warp","domain":"devtools","topic":"API","language":"Markdown","updated":"2026-05-04","comments":3,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-explicit-partial-success-semantics.md"},{"slug":"query-consistent-readable-patterns","title":"Consistent readable patterns","description":"Apply consistent, type-safe idioms and keep logic/formatting easy to\\ \\ scan.\\n\\n- Prefer the established guard/pattern style:\\n  ```ts\\n  // preferred\\ \\ if the surrounding code uses boolean guards","repository":"tanstack/query","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2026-05-03","comments":5,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-consistent-readable-patterns.md"},{"slug":"tradingagents-actionable-troubleshooting-docs","title":"Actionable Troubleshooting Docs","description":"Technical documentation—especially troubleshooting guides—must let contributors go from symptom to reproducible diagnosis with minimal guesswork. Apply these rules:","repository":"TauricResearch/TradingAgents","domain":"ai-agents","topic":"Documentation","language":"Markdown","updated":"2026-05-03","comments":3,"stars":71953,"raw":"https://awesomereviewers.com/raw/tradingagents-actionable-troubleshooting-docs.md"},{"slug":"tradingagents-configuration-source-of-truth","title":"Configuration Source of Truth","description":"Maintain configuration in a single, consistent way across the codebase: - **Use explicit defaults + safe fallbacks:** If function parameters accept `None`, resolve them via config defaults (and document why). Prefer provider-specific keys so changing one provider doesn’t silently alter another.","repository":"TauricResearch/TradingAgents","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2026-05-03","comments":3,"stars":71953,"raw":"https://awesomereviewers.com/raw/tradingagents-configuration-source-of-truth.md"},{"slug":"tradingagents-regression-tests-with-parametrization","title":"Regression Tests With Parametrization","description":"When changing business logic that affects output shape/order or resolution rules, add regression tests that assert observable outcomes for edge cases, and keep the suite maintainable by parameterizing repeated mock/assert patterns.","repository":"TauricResearch/TradingAgents","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2026-05-03","comments":3,"stars":71953,"raw":"https://awesomereviewers.com/raw/tradingagents-regression-tests-with-parametrization.md"},{"slug":"tradingagents-cache-deterministic-results","title":"Cache deterministic results","description":"When an operation is deterministic and expensive (often due to external IO like `yfinance`), avoid doing the same work twice. Use bounded memoization for repeated lookups and explicitly short-circuit cases where two inputs resolve to the same underlying entity. Also ensure caches don’t leak between tests.","repository":"TauricResearch/TradingAgents","domain":"ai-agents","topic":"Caching","language":"Python","updated":"2026-05-03","comments":2,"stars":71953,"raw":"https://awesomereviewers.com/raw/tradingagents-cache-deterministic-results.md"},{"slug":"python-automate-all-behavior-tests","title":"Automate All Behavior Tests","description":"For every algorithmic change (and every public function/class), require automated tests that lock in both correctness and failure modes. Minimum standard:","repository":"TheAlgorithms/Python","domain":"docs","topic":"Testing","language":"Python","updated":"2026-05-02","comments":10,"stars":220912,"raw":"https://awesomereviewers.com/raw/python-automate-all-behavior-tests.md"},{"slug":"tradingagents-graceful-specific-error-handling","title":"Graceful, Specific Error Handling","description":"When handling failures, prefer predictable, safe behavior over broad or crash-prone exception handling—especially around filesystem, JSON parsing, network calls, and user/CLI boundaries.","repository":"TauricResearch/TradingAgents","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2026-05-02","comments":7,"stars":71953,"raw":"https://awesomereviewers.com/raw/tradingagents-graceful-specific-error-handling.md"},{"slug":"python-performance-sensitive-efficiency","title":"Performance-Sensitive Efficiency","description":"When optimizing, watch for *hidden* inefficiencies: avoid O(n) per-step operations, don’t duplicate expensive work, and don’t eagerly materialize/convert data unless needed.","repository":"TheAlgorithms/Python","domain":"docs","topic":"Performance Optimization","language":"Python","updated":"2026-05-02","comments":6,"stars":220912,"raw":"https://awesomereviewers.com/raw/python-performance-sensitive-efficiency.md"},{"slug":"redis-targeted-non-bloated-tests","title":"Targeted, Non-Bloated Tests","description":"When adding/modifying tests, ensure they are (a) semantically aligned to the behavior under test, (b) precise enough to prove the intended code path was executed, and (c) not bloated or duplicated.","repository":"redis/redis","domain":"data-systems","topic":"Testing","language":"Other","updated":"2026-05-02","comments":6,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-targeted-non-bloated-tests.md"},{"slug":"warp-robust-config-handling","title":"Robust config handling","description":"Treat configuration as a stable, privacy-safe contract: it must load without breaking the whole file, resolve safely at apply-time, use platform-correct paths, and (for significant changes) be shipped behind feature flags with explicitly defined non-lossy toggle behavior.","repository":"warpdotdev/warp","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2026-05-02","comments":5,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-robust-config-handling.md"},{"slug":"redis-atomic-contracts-enforcement","title":"Atomic Contracts Enforcement","description":"Define and enforce atomicity as an explicit contract: if correctness depends on thread/writer invariants, encode it in the API name/docs and validate it at usage sites; if a value can be concurrently updated, read/write it exclusively via atomic operations (no non-atomic peeking into parts of an atomic container).","repository":"redis/redis","domain":"data-systems","topic":"Concurrency","language":"Other","updated":"2026-05-02","comments":4,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-atomic-contracts-enforcement.md"},{"slug":"tradingagents-align-mount-paths","title":"Align Mount Paths","description":"When configuring Docker bind mounts (or any persistence paths), set the container mount target to exactly where the application writes at runtime—especially when code uses relative paths like `Path.cwd() / \"...\"`. Don’t pick mount targets by convention; derive them from the actual path resolution logic.","repository":"TauricResearch/TradingAgents","domain":"ai-agents","topic":"Configurations","language":"Yaml","updated":"2026-05-02","comments":2,"stars":71953,"raw":"https://awesomereviewers.com/raw/tradingagents-align-mount-paths.md"},{"slug":"python-self-documenting-naming-rules","title":"Self-Documenting Naming Rules","description":"Use self-documenting identifiers: variable/function/class names should explain intent without relying on comments, and avoid confusing or ambiguous abbreviations.","repository":"TheAlgorithms/Python","domain":"docs","topic":"Naming Conventions","language":"Python","updated":"2026-05-01","comments":9,"stars":220912,"raw":"https://awesomereviewers.com/raw/python-self-documenting-naming-rules.md"},{"slug":"langchain-boundary-api-format-enforcement","title":"Boundary API Format Enforcement","description":"When building provider requests or consuming provider responses, enforce that all intermediate representations match the provider’s expected wire format *at the boundary*—including IDs, message/content blocks, and versioned behavior.","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"API","language":"Python","updated":"2026-05-01","comments":8,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-boundary-api-format-enforcement.md"},{"slug":"langchain-semantic-naming-for-schemas","title":"Semantic naming for schemas","description":"Use names that communicate intent and framework semantics—especially for (a) schemas and (b) callback parameters whose names are used for injection/dispatch.","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"Naming Conventions","language":"Python","updated":"2026-05-01","comments":8,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-semantic-naming-for-schemas.md"},{"slug":"archon-error-precedence-and-degradation","title":"Error precedence and degradation","description":"When implementing error handling, ensure (1) failures are validated early or handled explicitly, (2) optional steps degrade gracefully, (3) cancellation/abort prevents unnecessary work, and (4) cleanup never masks the true result.","repository":"coleam00/Archon","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2026-05-01","comments":7,"stars":21089,"raw":"https://awesomereviewers.com/raw/archon-error-precedence-and-degradation.md"},{"slug":"langchain-safe-caching-practices","title":"Safe caching practices","description":"Apply caching only when it is safe, bounded, and correct: 1) Avoid unbounded method memoization - Don’t use `functools.lru_cache/cache` directly on methods whose arguments can grow without a tight bound (risk of memory leaks). If you must cache, use a bounded cache (`maxsize=...`) or a different lifecycle.","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"Caching","language":"Python","updated":"2026-05-01","comments":7,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-safe-caching-practices.md"},{"slug":"openai-python-avoid-event-loop-blocking","title":"Avoid event-loop blocking","description":"Do not perform blocking I/O or other long-running synchronous work on asyncio’s event loop (especially in async client construction). Offload to worker threads (e.g., `asyncio.to_thread`) and prefer lazy credential/platform resolution protected by an async lock.","repository":"openai/openai-python","domain":"ai-agents","topic":"Concurrency","language":"Python","updated":"2026-05-01","comments":7,"stars":30731,"raw":"https://awesomereviewers.com/raw/openai-python-avoid-event-loop-blocking.md"},{"slug":"archon-guard-optional-values","title":"Guard Optional Values","description":"Treat any value that may be undefined/null (environment globals, optional stream handles, user config fields, optional IDs) as untrusted at the boundary. Use explicit checks/type guards instead of non-null assertions, and either omit invalid fields or return a deterministic safe failure—never let missing data crash module load or runtime.","repository":"coleam00/Archon","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2026-05-01","comments":6,"stars":21089,"raw":"https://awesomereviewers.com/raw/archon-guard-optional-values.md"},{"slug":"container-copy-paste-safe-docs","title":"Copy-Paste Safe Docs","description":"Ensure documentation command examples and command reference sections are accurate and safe to copy/paste. Apply these rules: - Code fences: use a `bash` (or relevant shell) code fence for blocks that contain only shell commands.","repository":"apple/container","domain":"orchestration","topic":"Documentation","language":"Markdown","updated":"2026-05-01","comments":6,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-copy-paste-safe-docs.md"},{"slug":"archon-safe-spawn-and-permission-validation","title":"Safe spawn and permission validation","description":"Enforce security for any code that turns user/config inputs into subprocess execution or permission settings. Apply these rules: 1) Spawn safely - Use `spawn(binary, args, ...)` with an args array.","repository":"coleam00/Archon","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2026-05-01","comments":5,"stars":21089,"raw":"https://awesomereviewers.com/raw/archon-safe-spawn-and-permission-validation.md"},{"slug":"redis-consistent-ttl-pre-check","title":"Consistent TTL Pre-check","description":"When handling TTL/expiration, decide “already expired?” (and validate expiry inputs) before performing DB mutations or expensive work, and then keep DB changes, stats/counters, and keyspace notifications consistent with the real outcome. For conditional variants (NX/XX, ENX/FNX/FXX), short-circuit behavior must match the condition.","repository":"redis/redis","domain":"data-systems","topic":"Caching","language":"C","updated":"2026-05-01","comments":5,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-consistent-ttl-pre-check.md"},{"slug":"archon-defensive-config-handling","title":"Defensive config handling","description":"Configuration should be treated as untrusted input: validate and normalize it, ignore unknown/invalid fields, and ensure user misconfiguration can’t crash initialization or produce misleading warnings. Also gate checks by what’s actually configured and implement a clear precedence order (env → explicit config → user paths → canonical defaults → PATH lookup)...","repository":"coleam00/Archon","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2026-05-01","comments":3,"stars":21089,"raw":"https://awesomereviewers.com/raw/archon-defensive-config-handling.md"},{"slug":"archon-subprocess-stream-lifecycle","title":"Subprocess stream lifecycle","description":"When you stream a subprocess’s stdout/stderr into an async generator, treat process exit, stream end/close, abort, and timeout escalation as concurrent events that can race.","repository":"coleam00/Archon","domain":"ai-agents","topic":"Concurrency","language":"TypeScript","updated":"2026-05-01","comments":2,"stars":21089,"raw":"https://awesomereviewers.com/raw/archon-subprocess-stream-lifecycle.md"},{"slug":"python-pure-functions-and-main-guard","title":"Pure Functions and Main Guard","description":"Keep reusable code clean and production-ready: reusable/algorithmic functions should be side-effect free (no `print()`), and all executable/demo/driver code must be under an `if __name__ == \"__main__\":` guard. Also keep imports at the top and sorted/PEP8-compliant.","repository":"TheAlgorithms/Python","domain":"docs","topic":"Code Style","language":"Python","updated":"2026-04-30","comments":8,"stars":220912,"raw":"https://awesomereviewers.com/raw/python-pure-functions-and-main-guard.md"},{"slug":"redis-cicd-workflow-guardrails","title":"CI/CD Workflow Guardrails","description":"When building or modifying CI/CD GitHub Actions workflows, structure them as an explicit DAG of artifact-driven jobs and guard execution to prevent fork/irrelevant-context failures.","repository":"redis/redis","domain":"data-systems","topic":"CI/CD","language":"Yaml","updated":"2026-04-30","comments":7,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-cicd-workflow-guardrails.md"},{"slug":"ragflow-centralized-input-guards","title":"Centralized input guards","description":"Require a shared, spec-aligned “guard” step for any untrusted input used in security-sensitive contexts (SQL construction, dynamic table names, outbound URL fetch). Fail closed (raise a safe exception) before interpolation/requests, and reuse a single utility to avoid security-policy drift.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Security","language":"Python","updated":"2026-04-30","comments":6,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-centralized-input-guards.md"},{"slug":"agentcore-samples-decision-first-documentation","title":"Decision-First Documentation","description":"When publishing code samples/notebooks, write documentation that is (a) decision-first, (b) API-current, and (c) goal-focused. 1) Add “when to use” differentiation for competing interfaces","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Documentation","language":"Other","updated":"2026-04-30","comments":3,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-decision-first-documentation.md"},{"slug":"archon-token-precedence-safety","title":"Token Precedence Safety","description":"When multiple authentication tokens are supported (e.g., generic GitHub tokens vs Copilot-specific tokens), enforce a deterministic, documented precedence and require explicit opt-in for fallback behavior.","repository":"coleam00/Archon","domain":"ai-agents","topic":"Security","language":"Yaml","updated":"2026-04-30","comments":1,"stars":21089,"raw":"https://awesomereviewers.com/raw/archon-token-precedence-safety.md"},{"slug":"redis-doc-semantics-consistency","title":"Doc Semantics Consistency","description":"Ensure comments and public-facing documentation precisely match the actual behavior and contract. Apply this standard by checking: - **No doc/behavior drift**: If you add/adjust command options (e.g., STRICT/PERSIST) or state transitions (e.g., TTL handling), update all descriptions (PR text, command docs, inline comments) to reflect the implemented...","repository":"redis/redis","domain":"data-systems","topic":"Documentation","language":"C","updated":"2026-04-29","comments":8,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-doc-semantics-consistency.md"},{"slug":"bmad-method-explicit-override-correctness","title":"Explicit override correctness","description":"When handling configuration from CLI/UI (e.g., `--set`, channel flags, migration prompts), treat user-provided values as explicit assertions that must (a) be seeded into the same data pipeline that prompts/templates use, (b) survive any schema-strict filtering only because the user asserted them, and (c) not be overwritten later by default/template/prompt...","repository":"bmad-code-org/bmad-method","domain":"cloud-infra","topic":"Configurations","language":"JavaScript","updated":"2026-04-29","comments":6,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-explicit-override-correctness.md"},{"slug":"python-explicit-optional-nulls","title":"Explicit Optional Nulls","description":"When a value can be absent, represent that absence explicitly and consistently. **Do** - Use `Optional[...]`/`T | None` in type hints for nullable inputs, outputs, and pointers.","repository":"TheAlgorithms/Python","domain":"docs","topic":"Null Handling","language":"Python","updated":"2026-04-29","comments":6,"stars":220912,"raw":"https://awesomereviewers.com/raw/python-explicit-optional-nulls.md"},{"slug":"openai-python-config-resolution-consistency","title":"Config resolution consistency","description":"When adding or extending client/provider integrations, enforce a single, predictable configuration-resolution contract: - **Args → env fallbacks:** For each required setting (e.g., `api_version`, `region`), accept an explicit argument, otherwise fall back to the corresponding environment variable(s). Only raise a clear error when *neither* is provided.","repository":"openai/openai-python","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2026-04-29","comments":4,"stars":30731,"raw":"https://awesomereviewers.com/raw/openai-python-config-resolution-consistency.md"},{"slug":"bmad-method-validate-and-scope-cache","title":"Validate and Scope Cache","description":"When using cached data/artifacts, treat the cache as ephemeral and potentially stale/corrupt. Apply three rules: 1) Make cache scope explicit (and CI-safe)","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Caching","language":"Markdown","updated":"2026-04-29","comments":3,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-validate-and-scope-cache.md"},{"slug":"warp-canonical-naming-sources","title":"Canonical Naming Sources","description":"Use canonical, source-verified naming for identifiers and for artifact locations. Avoid guesses, stale references, or incidental structure (like username folders).","repository":"warpdotdev/warp","domain":"devtools","topic":"Naming Conventions","language":"Markdown","updated":"2026-04-29","comments":2,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-canonical-naming-sources.md"},{"slug":"warp-optional-fallback-discipline","title":"Optional Fallback Discipline","description":"When working with nullable/optional values or external/runtime-provided fields, never assume presence or a specific concrete type/spelling. Instead: (1) explicitly treat inputs as optional, (2) provide deterministic fallbacks (often empty string/None/previous-state), (3) avoid dereferencing missing values, and (4) add tests for both “value present” and...","repository":"warpdotdev/warp","domain":"devtools","topic":"Null Handling","language":"Markdown","updated":"2026-04-29","comments":2,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-optional-fallback-discipline.md"},{"slug":"warp-use-sudo-helper","title":"Use Sudo Helper","description":"When writing shell scripts that run privileged operations, never call `sudo` directly or execute such commands silently. Centralize privilege escalation in a helper that (1) prints the exact command being run, (2) prompts for confirmation by default, and (3) provides an explicit, documented non-interactive escape hatch for CI (e.g., an env var like...","repository":"warpdotdev/warp","domain":"devtools","topic":"Security","language":"Other","updated":"2026-04-29","comments":1,"stars":56893,"raw":"https://awesomereviewers.com/raw/warp-use-sudo-helper.md"},{"slug":"zod-preserve-and-map-errors","title":"Preserve and Map Errors","description":"Standardize error handling so failures remain diagnosable and user-facing messages are complete. Apply these rules: 1) Preserve diagnostic context when propagating/rethrowing","repository":"colinhacks/zod","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2026-04-28","comments":8,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-preserve-and-map-errors.md"},{"slug":"freecodecamp-null-safe-defaults","title":"Null-Safe Defaults","description":"Write code assuming inputs (arrays, objects, DOM nodes) may contain `undefined`, `null`, or “empty slots/holes”, and normalize them early with explicit defaults.","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"Null Handling","language":"Markdown","updated":"2026-04-28","comments":5,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-null-safe-defaults.md"},{"slug":"openai-python-cache-validity-and-bounds","title":"Cache validity and bounds","description":"When adding caching, ensure **(1) correctness via validity/refresh** and **(2) safety via bounds/staleness resistance**. ### 1) Align cache lifetime with real validity","repository":"openai/openai-python","domain":"ai-agents","topic":"Caching","language":"Python","updated":"2026-04-28","comments":5,"stars":30731,"raw":"https://awesomereviewers.com/raw/openai-python-cache-validity-and-bounds.md"},{"slug":"nanochat-keep-config-minimal","title":"Keep config minimal","description":"Avoid “config monsters” by limiting new runtime knobs and centralizing stable defaults. Only add CLI/config parameters when they materially change behavior across experiments; otherwise, bake them into the existing config (or the run script) and reuse current config locations rather than introducing new config modules for a few constants. For...","repository":"karpathy/nanochat","domain":"ml-systems","topic":"Configurations","language":"Python","updated":"2026-04-28","comments":4,"stars":53189,"raw":"https://awesomereviewers.com/raw/nanochat-keep-config-minimal.md"},{"slug":"bmad-method-stable-interface-normalization","title":"Stable Interface Normalization","description":"Define and enforce normalization rules for all user/client-facing inputs (CLI flags, request fields, option keys) so matching behavior is consistent with the documented interface contract—then harden implementations against dependency/API drift.","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"API","language":"JavaScript","updated":"2026-04-28","comments":2,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-stable-interface-normalization.md"},{"slug":"redis-intentional-error-handling","title":"Intentional Error Handling","description":"Handle errors based on intent: make operations idempotent for known conflicts, and explicitly classify/propagate errors for known transient conditions.","repository":"redis/redis","domain":"data-systems","topic":"Error Handling","language":"Other","updated":"2026-04-28","comments":2,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-intentional-error-handling.md"},{"slug":"ragflow-centralize-input-bounds","title":"Centralize input bounds","description":"When validating user-controlled numeric inputs, define allowed min/max values in one place and reuse them across both the UI/component props and the validation schema. Prevent mismatches where the UI permits one range but the schema enforces another (or vice versa), since this breaks input validation guarantees.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Security","language":"TSX","updated":"2026-04-28","comments":1,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-centralize-input-bounds.md"},{"slug":"apisix-docs-match-implementation","title":"Docs Match Implementation","description":"Docs must be verifiable against the actual plugin/runtime behavior: schemas (fields/types/requiredness), defaults, and example outputs. Additionally, follow the repo’s established doc formatting conventions for things like canonical tags and secret-value prefixes.","repository":"apache/apisix","domain":"cloud-infra","topic":"Documentation","language":"Markdown","updated":"2026-04-27","comments":16,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-docs-match-implementation.md"},{"slug":"ragflow-test-isolation-and-tiers","title":"Test isolation and tiers","description":"When adding or changing behavior, require unit tests that are (a) comprehensive for the logic contract, (b) correctly prioritized/selected via pytest markers, and (c) isolated from global state to avoid cross-suite flakiness.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Testing","language":"Python","updated":"2026-04-27","comments":7,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-test-isolation-and-tiers.md"},{"slug":"ragflow-null-safe-input-handling","title":"Null-safe input handling","description":"Apply null-safety consistently for request payloads, optional dict keys, and nullable fields. Specifically: - Guard `None` before doing comparisons/logic that assumes a value exists.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Null Handling","language":"Python","updated":"2026-04-27","comments":6,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-null-safe-input-handling.md"},{"slug":"ragflow-deterministic-mapping-pipeline","title":"Deterministic Mapping Pipeline","description":"When implementing parsing/storage/retrieval logic (or any pipeline with downstream queries), design the algorithm so that *representations, keys, and batching decisions are stable and consistent*:","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Algorithms","language":"Python","updated":"2026-04-27","comments":5,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-deterministic-mapping-pipeline.md"},{"slug":"redis-maintain-algorithmic-invariants","title":"Maintain algorithmic invariants","description":"When implementing algorithms that depend on “current state” (client context, cached slot/client, etc.) or on custom data structures (stack/heap modes), make the invariant explicit and ensure all computations are derived from the specific operand/object being processed—not from incidental outer execution context.","repository":"redis/redis","domain":"data-systems","topic":"Algorithms","language":"Other","updated":"2026-04-27","comments":3,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-maintain-algorithmic-invariants.md"},{"slug":"agent-zero-single-source-error-logic","title":"Single Source Error Logic","description":"When handling failures or optional data, make the decision exactly once and reuse the result everywhere. Apply two concrete rules: 1) **Normalize once, then use the normalized values for both validation and execution.** Don’t validate one set of fields and execute using separately-fallbacked canonical fields.","repository":"agent0ai/agent-zero","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2026-04-27","comments":2,"stars":17612,"raw":"https://awesomereviewers.com/raw/agent-zero-single-source-error-logic.md"},{"slug":"query-consistent-dependency-config","title":"Consistent dependency config","description":"Maintain configuration consistency and compatibility by using a single, intentional strategy for dependency declarations, peer ranges, and script runtimes.","repository":"tanstack/query","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2026-04-26","comments":12,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-consistent-dependency-config.md"},{"slug":"langchain-deterministic-algorithm-correctness","title":"Deterministic Algorithm Correctness","description":"When implementing non-trivial algorithms (graph ordering, batching under constraints, multi-pass transformations), apply four requirements: 1) **Guarantee termination with explicit guards/invariants**","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"Algorithms","language":"Python","updated":"2026-04-26","comments":7,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-deterministic-algorithm-correctness.md"},{"slug":"bmad-method-correct-matching-and-parsing","title":"Correct Matching And Parsing","description":"When writing installers/transformers/validators that search, rewrite, or regenerate files, require *matching/parsing correctness*: only operate on the exact structure you intend, and avoid ambiguous substring/position matches.","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Algorithms","language":"JavaScript","updated":"2026-04-26","comments":6,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-correct-matching-and-parsing.md"},{"slug":"query-minimize-hot-path-work","title":"Minimize Hot-Path Work","description":"When working on performance-sensitive code (query observers, hydration, render-triggering state, hot utilities), ensure you only do the necessary work and no redundant allocations/wrappers, while also preventing leaks.","repository":"tanstack/query","domain":"app-frameworks","topic":"Performance Optimization","language":"TypeScript","updated":"2026-04-26","comments":6,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-minimize-hot-path-work.md"},{"slug":"celery-stable-ci-workflow-policy","title":"Stable CI Workflow Policy","description":"When modifying CI workflows, keep pipelines deterministic, resource-efficient, and transparent: - **Gate expensive jobs:** Run integration (and other heavyweight suites) only after unit tests succeed to save resources. Use job dependencies (e.g., `needs: unit-tests`).","repository":"celery/celery","domain":"orchestration","topic":"CI/CD","language":"Yaml","updated":"2026-04-26","comments":4,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-stable-ci-workflow-policy.md"},{"slug":"apisix-trace-semconv-and-completeness","title":"Trace semconv and completeness","description":"Make observability outputs standards-compliant and fully observable. Apply this when writing instrumentation and when publishing tracing/telemetry examples:","repository":"apache/apisix","domain":"cloud-infra","topic":"Observability","language":"Markdown","updated":"2026-04-26","comments":2,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-trace-semconv-and-completeness.md"},{"slug":"archon-isolate-process-global-mocks","title":"Isolate process-global mocks","description":"When a test uses process-global/irreversible module mocking, prevent cross-test contamination by isolating the affected test files into separate `bun test` runs (batch isolation). Keep mocks narrowly scoped so tests don’t need to mock large dependency graphs, and avoid importing “config/provider” chains in units where tests shouldn’t require them.","repository":"coleam00/Archon","domain":"ai-agents","topic":"Testing","language":"TypeScript","updated":"2026-04-26","comments":2,"stars":21089,"raw":"https://awesomereviewers.com/raw/archon-isolate-process-global-mocks.md"},{"slug":"azure-quickstart-templates-idempotent-rbac-assignments","title":"Idempotent RBAC Assignments","description":"When using Bicep to assign Azure RBAC roles, make roleAssignments deterministic and correct by: - Use the target principal’s **principalId** (e.g., managed identity principalId) rather than resourceId, and include it in the roleAssignment name seed.","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Security","language":"Other","updated":"2026-04-25","comments":9,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-idempotent-rbac-assignments.md"},{"slug":"azure-cli-configuration-contract-enforcement","title":"Configuration Contract Enforcement","description":"When behavior depends on configuration (files/flags/subscriptions), do three things: (1) derive values from the active runtime context (including any overrides), (2) gate feature behavior on validated completeness of required config inputs, and (3) eliminate hidden defaults/implicit selections.","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Configurations","language":"Python","updated":"2026-04-25","comments":4,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-configuration-contract-enforcement.md"},{"slug":"ragflow-unified-error-handling","title":"Unified Error Handling","description":"Adopt a single error-handling standard across LLM/provider layers: 1) Retry only transient failures (including connection jitter) with bounded, classified backoff","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Error Handling","language":"Python","updated":"2026-04-24","comments":8,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-unified-error-handling.md"},{"slug":"azure-powershell-documentation-source-and-tone","title":"Documentation Source And Tone","description":"When updating documentation (assembly metadata, cmdlet HelpMessage, generated stubs, etc.), ensure (1) you change the correct source of truth and (2) the text is written for users, not for internal implementation.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Documentation","language":"C#","updated":"2026-04-24","comments":2,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-documentation-source-and-tone.md"},{"slug":"query-api-typing-parity","title":"API typing parity","description":"When evolving public API/TypeScript types, ensure the **type surface exactly matches runtime behavior and intended layering**, and reuse existing signature/overload patterns.","repository":"tanstack/query","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2026-04-23","comments":10,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-api-typing-parity.md"},{"slug":"redis-clear-semantic-identifier-naming","title":"Clear Semantic Identifier Naming","description":"Adopt naming conventions that are (1) case-consistent by identifier kind and (2) semantically self-documenting (what it represents/includes/excludes, and what the function returns).","repository":"redis/redis","domain":"data-systems","topic":"Naming Conventions","language":"C","updated":"2026-04-23","comments":10,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-clear-semantic-identifier-naming.md"},{"slug":"langchain-preserve-ai-structure-invariants","title":"Preserve AI Structure Invariants","description":"When working with LLM/chat “auxiliary” content (reasoning, tool calls/results, structured content blocks, and usage/metadata), enforce structural invariants so provider/streaming/truncation logic can’t silently corrupt meaning.","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"AI","language":"Python","updated":"2026-04-23","comments":8,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-preserve-ai-structure-invariants.md"},{"slug":"container-deterministic-parsing-and-matching","title":"Deterministic Parsing And Matching","description":"When implementing parsing and lookup/diff algorithms on strings/filesystems, guarantee determinism and correctness by (1) normalizing inputs into a canonical form before comparison/keying, (2) explicitly handling ambiguity instead of silently choosing an arbitrary match, and (3) deduping by semantic change keys while keeping a stable order.","repository":"apple/container","domain":"orchestration","topic":"Algorithms","language":"Swift","updated":"2026-04-23","comments":7,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-deterministic-parsing-and-matching.md"},{"slug":"ragflow-use-clear-identifiers","title":"Use Clear Identifiers","description":"Use semantically meaningful, convention-compliant names everywhere (parameters, variables, fields, classes, constants), and avoid ad-hoc renaming/mapping that can create ambiguity or incorrect field exposure.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Naming Conventions","language":"Python","updated":"2026-04-23","comments":6,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-use-clear-identifiers.md"},{"slug":"ragflow-extract-shared-validation","title":"Extract Shared Validation","description":"Prefer small shared helpers for repeated request parsing/validation, and use modern, consistent type annotations to keep code readable and uniform. Apply this when you see the same “get field → type-check → return error” logic duplicated across endpoints or functions.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Code Style","language":"Python","updated":"2026-04-23","comments":5,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-extract-shared-validation.md"},{"slug":"query-consistent-unique-package-names","title":"Consistent Unique Package Names","description":"Use stable naming conventions that match repo/tooling expectations and avoid identifier collisions. **Rules** 1. **Keep script names consistent across packages**: if CI/tooling expects specific npm/pnpm script keys, use the same keys in every package (don’t rename per-package).","repository":"tanstack/query","domain":"app-frameworks","topic":"Naming Conventions","language":"Json","updated":"2026-04-23","comments":3,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-consistent-unique-package-names.md"},{"slug":"query-standardize-monorepo-linting","title":"Standardize monorepo linting","description":"Use shared root configuration for formatting and apply consistent ESLint rule severities across the monorepo, allowing only narrowly scoped exceptions.","repository":"tanstack/query","domain":"app-frameworks","topic":"Code Style","language":"JavaScript","updated":"2026-04-23","comments":3,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-standardize-monorepo-linting.md"},{"slug":"query-type-safe-scripted-tests","title":"Type-Safe, Scripted Tests","description":"Ensure your testing approach covers both runtime behavior and public API types, and that the test scripts you expose are correct, documented, and preserve any packaging-specific smoke checks.","repository":"tanstack/query","domain":"app-frameworks","topic":"Testing","language":"Json","updated":"2026-04-23","comments":3,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-type-safe-scripted-tests.md"},{"slug":"celery-meaningful-tests-for-guards","title":"Meaningful Tests For Guards","description":"When adding tests for new behavior, deprecations, or environment-dependent code paths, ensure the test actually exercises the intended branch (avoid vacuous passing) and assert the concrete observable effect.","repository":"celery/celery","domain":"orchestration","topic":"Testing","language":"Python","updated":"2026-04-22","comments":8,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-meaningful-tests-for-guards.md"},{"slug":"celery-explicit-none-semantics","title":"Explicit None Semantics","description":"When handling optional/nullable inputs, treat “missing” and “explicitly set to None” as different semantic states. Practical rules: - Provide safe fallbacks at the boundary: if a config/input can be `None`, use a default that keeps the value non-null.","repository":"celery/celery","domain":"orchestration","topic":"Null Handling","language":"Python","updated":"2026-04-22","comments":6,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-explicit-none-semantics.md"},{"slug":"ragflow-use-shared-ui-primitives","title":"Use Shared UI Primitives","description":"When building UI, follow the project’s existing design-system components and tokens instead of creating bespoke patterns. **Standards** 1. **Prefer shared form/UI building blocks**: Use existing components like `RAGFlowFormItem`, `SimilaritySliderFormField`, and `SearchInput` rather than re-implementing the same UI logic/styling.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Code Style","language":"TSX","updated":"2026-04-22","comments":6,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-use-shared-ui-primitives.md"},{"slug":"ragflow-centralize-api-interfaces","title":"Centralize API Interfaces","description":"Enforce consistent API client construction: (1) centralize all REST endpoint paths and interface definitions in a shared module (e.g., `api.ts`) to prevent scattered string literals, and (2) when reading/writing request inputs like query params, use the correct standard APIs and keep TypeScript types aligned.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"API","language":"TypeScript","updated":"2026-04-22","comments":2,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-centralize-api-interfaces.md"},{"slug":"ragflow-typed-api-contracts","title":"Typed API Contracts","description":"For each API endpoint, treat the request as a strict contract: define a dedicated typed request model for the exact payload shape, validate required inputs early, and keep auth/tenant scoping and client URL construction consistent.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"API","language":"Python","updated":"2026-04-21","comments":5,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-typed-api-contracts.md"},{"slug":"freecodecamp-concurrency-safe-async-flows","title":"Concurrency-safe async flows","description":"When UI actions can occur rapidly or in parallel (double-clicks, retries, rapid test submissions), treat them as concurrency problems: synchronize the triggering and centralize the side effects.","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"Concurrency","language":"TSX","updated":"2026-04-21","comments":3,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-concurrency-safe-async-flows.md"},{"slug":"apisix-self-contained-secure-networking","title":"Self-Contained Secure Networking","description":"Ensure networking-related docs/examples and configurations are both runnable and secure: (1) every referenced endpoint/service/backend in an example manifest must be defined so the config works when copied, and (2) TLS-related defaults (e.g., certificate verification) must default to secure behavior and be treated as potentially breaking—clearly...","repository":"apache/apisix","domain":"cloud-infra","topic":"Networking","language":"Markdown","updated":"2026-04-21","comments":2,"stars":16922,"raw":"https://awesomereviewers.com/raw/apisix-self-contained-secure-networking.md"},{"slug":"bmad-method-structural-config-merge-rules","title":"Structural config merge rules","description":"When adding or modifying skill/workflow customization, treat configuration resolution as a deterministic contract with (a) exact merge semantics and (b) clear config ownership/lifecycle.","repository":"bmad-code-org/bmad-method","domain":"cloud-infra","topic":"Configurations","language":"Markdown","updated":"2026-04-20","comments":6,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-structural-config-merge-rules.md"},{"slug":"bmad-method-deterministic-resolution-with-confidence","title":"Deterministic Resolution With Confidence","description":"When your system combines configurations or routes control flow, make the “resolution function” semantics explicit and safe: (1) define merge/override behavior precisely to prevent silent data loss, and (2) treat any heuristic inference from evidence as tentative—gate it with confidence and require explicit confirmation.","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Algorithms","language":"Markdown","updated":"2026-04-19","comments":3,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-deterministic-resolution-with-confidence.md"},{"slug":"ragflow-pascalcase-constants","title":"PascalCase constants","description":"Use a consistent PascalCase naming convention for constants (especially exported ones). Avoid mixed styles like snake_case, and keep acronym casing consistent (e.g., API).","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Naming Conventions","language":"TypeScript","updated":"2026-04-19","comments":2,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-pascalcase-constants.md"},{"slug":"freecodecamp-mock-only-what-matters","title":"Mock Only What Matters","description":"When writing tests, avoid introducing unnecessary fakes/mocks that hide real integration behavior. - If your goal is to validate how code interacts with DOM dependencies, don’t “fake” core event/data shapes more than needed; use the real DOM/events interface (or a higher-fidelity fixture) so failures reflect real breakage.","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"Testing","language":"TSX","updated":"2026-04-17","comments":2,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-mock-only-what-matters.md"},{"slug":"redis-consistent-clear-naming","title":"Consistent Clear Naming","description":"Use naming that is (1) safe per language rules, (2) semantically explicit, and (3) consistent with existing symbol families. Practical checklist: - Avoid reserved/unsafe identifier patterns. In C/C++, don’t introduce names starting with `_[A-Z]` (rename instead).","repository":"redis/redis","domain":"data-systems","topic":"Naming Conventions","language":"Other","updated":"2026-04-16","comments":5,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-consistent-clear-naming.md"},{"slug":"pi-align-ai-interfaces","title":"Align AI interfaces","description":"When coding against LLM providers, treat model capabilities and prompt/tool formats as *spec-driven interfaces*: match upstream expectations exactly, and avoid ad-hoc mappings or manual edits that can drift.","repository":"earendil-works/pi","domain":"ai-agents","topic":"AI","language":"TypeScript","updated":"2026-04-16","comments":3,"stars":79783,"raw":"https://awesomereviewers.com/raw/pi-align-ai-interfaces.md"},{"slug":"redis-null-safe-free-wrappers","title":"Null-safe Free Wrappers","description":"When a free/cleanup API may receive NULL (or an invalid handle), don’t rely on ad-hoc checks at call sites. Instead, define a NULL-safe wrapper/helper that:","repository":"redis/redis","domain":"data-systems","topic":"Null Handling","language":"Other","updated":"2026-04-16","comments":3,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-null-safe-free-wrappers.md"},{"slug":"azure-powershell-fail-fast-input-validation","title":"Fail Fast Input Validation","description":"Validate customer-supplied, security-relevant settings up front and fail deterministically with explicit errors when values/config combinations are invalid. Add tests that cover most customer-input parameters and assert the expected provisioning/result behavior and returned properties.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Security","language":"Other","updated":"2026-04-16","comments":2,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-fail-fast-input-validation.md"},{"slug":"redis-nullable-contracts-enforcement","title":"Nullable Contracts Enforcement","description":"Adopt explicit, consistent nullability contracts for pointer/optional-field parameters and honor them at every call site. Practical rules: - **Document/decide whether a parameter may be NULL**. If it can’t, keep the check out; if it can, guard and define behavior.","repository":"redis/redis","domain":"data-systems","topic":"Null Handling","language":"C","updated":"2026-04-15","comments":9,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-nullable-contracts-enforcement.md"},{"slug":"archon-organize-and-clean-imports","title":"Organize and Clean Imports","description":"Keep codebase structure and import usage aligned with the intended architecture and boundaries. - **Place files in the correct feature/module directory** (e.g., shared UI utilities under `src/features/shared/`), rather than leaving them in a generic `utils/` folder when the architecture expects otherwise.","repository":"coleam00/Archon","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2026-04-15","comments":3,"stars":21089,"raw":"https://awesomereviewers.com/raw/archon-organize-and-clean-imports.md"},{"slug":"ragflow-config-contracts-and-defaults","title":"Config Contracts And Defaults","description":"Treat environment variables and configuration flags as a documented contract: the code must (1) read settings from the correct source with safe defaults, (2) make feature-flag behavior explicit (including what becomes a true no-op when disabled), and (3) validate any external runtime dependency that the integration relies on.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Configurations","language":"Python","updated":"2026-04-14","comments":5,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-config-contracts-and-defaults.md"},{"slug":"langchain-avoid-shared-mutable-state","title":"Avoid shared mutable state","description":"When working with concurrency (threads/async), ensure code is safe under parallel invocations and does not block or re-enter running event loops. Rules:","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"Concurrency","language":"Python","updated":"2026-04-13","comments":9,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-avoid-shared-mutable-state.md"},{"slug":"bmad-method-behavior-focused-test-hygiene","title":"Behavior-Focused Test Hygiene","description":"Write tests that are (1) behavior-focused rather than implementation-coupled, and (2) use safe, consistently cleaned fixtures. Do - Assert externally observable outcomes/invariants, not “incidental” implementation details. If changing internals wouldn’t break the contract, don’t make the test fail on that internal change.","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Testing","language":"JavaScript","updated":"2026-04-13","comments":4,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-behavior-focused-test-hygiene.md"},{"slug":"nanochat-pytorch-compatibility-guards","title":"PyTorch Compatibility Guards","description":"Adopt explicit compatibility guards in PyTorch code to prevent silent numeric issues and runtime failures across devices, PyTorch versions, and compilation modes.","repository":"karpathy/nanochat","domain":"ml-systems","topic":"Pytorch","language":"Python","updated":"2026-04-13","comments":4,"stars":53189,"raw":"https://awesomereviewers.com/raw/nanochat-pytorch-compatibility-guards.md"},{"slug":"langchain-keep-helpers-small","title":"Keep Helpers Small","description":"Favor readability and maintainability by keeping functions/methods short, extracting complex logic into well-named helpers, and avoiding duplicated or closure-based implementations in constructors.","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2026-04-12","comments":8,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-keep-helpers-small.md"},{"slug":"archon-api-contract-regression","title":"API contract regression","description":"When adding or changing API-like functions (parsers, clients, helpers), treat them as having a stable contract: define the accepted inputs and exact output shape, cover tricky edge cases with regression tests, and remove/deprecate superseded code paths so the API surface stays unambiguous.","repository":"coleam00/Archon","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2026-04-12","comments":2,"stars":21089,"raw":"https://awesomereviewers.com/raw/archon-api-contract-regression.md"},{"slug":"iptv-canonical-stream-naming","title":"Canonical Stream Naming","description":"When editing M3U `#EXTINF` metadata, treat `tvg-id` (and related fields) as a canonical identifier: it must be valid, correctly aligned with the displayed channel name, and consistent across variants.","repository":"iptv-org/iptv","domain":"app-frameworks","topic":"Naming Conventions","language":"Other","updated":"2026-04-11","comments":12,"stars":135586,"raw":"https://awesomereviewers.com/raw/iptv-canonical-stream-naming.md"},{"slug":"query-maintain-docs-integrity","title":"Maintain Docs Integrity","description":"Documentation should be kept correct and maintainable like code: ensure pages are registered, links are stable/valid, and shared doc sections follow the adapter conventions.","repository":"tanstack/query","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2026-04-11","comments":9,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-maintain-docs-integrity.md"},{"slug":"ragflow-safe-configuration-changes","title":"Safe configuration changes","description":"When updating configuration/env logic, treat it as compatibility-sensitive: preserve existing default behavior and env var formats, avoid enabling config blocks that silently change runtime semantics, and ensure config typing and dependent settings stay consistent.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Configurations","language":"Other","updated":"2026-04-11","comments":5,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-safe-configuration-changes.md"},{"slug":"axonhub-nil-safe-assignment","title":"Nil-safe assignment","description":"When fields/items are optional, treat `nil`/empty as a first-class state: guard against nil dereferences, sanitize outputs, and never overwrite meaningful non-nil data with `nil`.","repository":"looplj/axonhub","domain":"llm-infra","topic":"Null Handling","language":"Go","updated":"2026-04-11","comments":4,"stars":4808,"raw":"https://awesomereviewers.com/raw/axonhub-nil-safe-assignment.md"},{"slug":"query-stable-lifecycle-correct-hooks","title":"Stable, lifecycle-correct hooks","description":"Ensure React hooks and query integrations remain correct across renders, SSR/hydration, and subscriptions. Rules: 1) Keep QueryClient stable in React components","repository":"tanstack/query","domain":"app-frameworks","topic":"React","language":"TypeScript","updated":"2026-04-10","comments":9,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-stable-lifecycle-correct-hooks.md"},{"slug":"ragflow-non-blocking-async-recovery","title":"Non-Blocking Async Recovery","description":"Concurrency standard: (1) keep async code non-blocking, (2) don’t change sync/async boundaries unless callers support it, and (3) make recovery/state transitions race-safe.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Concurrency","language":"Python","updated":"2026-04-10","comments":6,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-non-blocking-async-recovery.md"},{"slug":"query-deterministic-concurrent-state","title":"Deterministic Concurrent State","description":"When code runs with concurrent rendering and async workflows, ensure any async/derived value that can affect what gets rendered (or how consumers behave) is deterministic per concurrent “world”, and make promise behavior explicit.","repository":"tanstack/query","domain":"app-frameworks","topic":"Concurrency","language":"TSX","updated":"2026-04-10","comments":4,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-deterministic-concurrent-state.md"},{"slug":"celery-logging-correctness-rules","title":"Logging Correctness Rules","description":"When adding or modifying logging: 1) **Match logging intent to behavior (level + visibility)** - If a user-supplied config or runtime option fails and a fallback happens, log at an appropriate user-visible level (often `warning`)—don’t silently continue.","repository":"celery/celery","domain":"orchestration","topic":"Logging","language":"Python","updated":"2026-04-09","comments":7,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-logging-correctness-rules.md"},{"slug":"langchain-treat-jinja2-as-unsafe","title":"Treat Jinja2 as Unsafe","description":"Don’t trust “sandboxed” templating when any part of template text (or dangerous expressions) can be influenced by an untrusted party. For security-sensitive code, assume Jinja2 (and similar template engines) is dangerous with untrusted inputs and enforce strict trust boundaries.","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"Security","language":"Markdown","updated":"2026-04-09","comments":1,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-treat-jinja2-as-unsafe.md"},{"slug":"celery-avoid-unnecessary-work","title":"Avoid Unnecessary Work","description":"Prefer eliminating work that can’t affect observable behavior and prevent resource retention in hot paths. Apply this as a checklist: 1) Guard mode-dependent logic: if the subsystem doesn’t propagate updates (or the surrounding condition is false), skip the computation/action entirely.","repository":"celery/celery","domain":"orchestration","topic":"Performance Optimization","language":"Python","updated":"2026-04-08","comments":10,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-avoid-unnecessary-work.md"},{"slug":"freecodecamp-validate-block-json","title":"Validate Block JSON","description":"Ensure every `curriculum/structure/blocks/*.json` file matches the CI-validated schema and constraints. - Remove deprecated/unused fields (e.g., `name`)—CI may reject these.","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"CI/CD","language":"Json","updated":"2026-04-07","comments":10,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-validate-block-json.md"},{"slug":"redis-version-compatibility-first","title":"Version Compatibility First","description":"When changing serialized/wire formats (RDB/DUMP/RESTORE or module metadata), treat it as a data migration: define compatibility behavior and make encoding placement deterministic.","repository":"redis/redis","domain":"data-systems","topic":"Migrations","language":"Other","updated":"2026-04-07","comments":3,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-version-compatibility-first.md"},{"slug":"celery-test-canvas-edge-cases","title":"Test Canvas Edge Cases","description":"When changing Celery task dispatch semantics (especially Canvas: chains/groups/chords, unroll/freeze, and composed workflows), add regression tests that:","repository":"celery/celery","domain":"orchestration","topic":"Celery","language":"Python","updated":"2026-04-06","comments":4,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-test-canvas-edge-cases.md"},{"slug":"celery-document-version-annotations","title":"Document version annotations","description":"When a doc section introduces a new configuration option or feature, include accurate version metadata (Celery and, when relevant, the dependency/library version). Missing or incorrect `.. versionadded::` causes confusion about availability.","repository":"celery/celery","domain":"orchestration","topic":"Documentation","language":"Other","updated":"2026-04-03","comments":10,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-document-version-annotations.md"},{"slug":"azure-powershell-powershell-style-hygiene","title":"PowerShell style hygiene","description":"Adopt consistent PowerShell coding patterns to improve correctness and readability, and keep project definitions clean. - Boolean parameter syntax: pass boolean parameters using the idiomatic form for the context.","repository":"Azure/azure-powershell","domain":"cloud-infra","topic":"Code Style","language":"Other","updated":"2026-04-03","comments":5,"stars":4762,"raw":"https://awesomereviewers.com/raw/azure-powershell-powershell-style-hygiene.md"},{"slug":"freecodecamp-deterministic-array-algorithm-contracts","title":"Deterministic Array Algorithm Contracts","description":"For algorithm-heavy code that transforms arrays (multi-step pipelines, scheduling, deduping, cyclic traversal), require clear, testable function contracts and deterministic behavior:","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"Algorithms","language":"Markdown","updated":"2026-04-02","comments":4,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-deterministic-array-algorithm-contracts.md"},{"slug":"aidlc-workflows-cicd-workflow-predictability","title":"CI/CD Workflow Predictability","description":"When configuring GitHub Actions for CI/CD, keep workflow outputs and triggers predictable: 1) Use safe, stable identifiers for artifacts/reports. Don’t build artifact names from values that can be invalid (e.g., raw branch/ref names). Prefer constants or explicitly sanitized values.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"CI/CD","language":"Yaml","updated":"2026-04-01","comments":2,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-cicd-workflow-predictability.md"},{"slug":"aidlc-workflows-secret-scan-baselines","title":"Secret scan baselines","description":"When using secret-scanning tools (e.g., gitleaks) ignore or baseline files, treat those artifacts as sensitive because they may contain previously detected secret text.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Security","language":"Other","updated":"2026-04-01","comments":1,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-secret-scan-baselines.md"},{"slug":"tradingagents-sdk-aware-api-clients","title":"SDK-aware API clients","description":"When building or calling API client code, follow the SDK’s actual request/response types and conventions instead of assuming REST/dict semantics. Apply these rules:","repository":"TauricResearch/TradingAgents","domain":"ai-agents","topic":"API","language":"Python","updated":"2026-03-31","comments":3,"stars":71953,"raw":"https://awesomereviewers.com/raw/tradingagents-sdk-aware-api-clients.md"},{"slug":"query-precise-api-contracts","title":"Precise API Contracts","description":"When designing or documenting API options and callbacks, ensure the contract is exact, unambiguous, and type-safe. - **Specify true behavior and defaults**: If an option affects multiple behaviors, document what it does *exactly* (including defaults). Prefer the control mechanism that precisely matches intent (e.g., stop polling by returning `false` from...","repository":"tanstack/query","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2026-03-30","comments":7,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-precise-api-contracts.md"},{"slug":"query-explicit-staletime-policy","title":"Explicit StaleTime Policy","description":"For every query, define a clear staleness/refetch policy—especially for SSR/hydration—rather than relying on defaults or assumptions. **Standards** - **Always choose `staleTime` deliberately** (default is `0`, which means cached data is treated as stale).","repository":"tanstack/query","domain":"app-frameworks","topic":"Caching","language":"Markdown","updated":"2026-03-30","comments":6,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-explicit-staletime-policy.md"},{"slug":"celery-accurate-auto-config","title":"Accurate, Auto Config","description":"User-facing configuration should be correct, self-contained, and hard to misuse. Apply these rules: 1) **Document the exact scope of each setting/env var**: the description must match the code paths that actually enforce the behavior (what calls it affects, and what it does *not* affect).","repository":"celery/celery","domain":"orchestration","topic":"Configurations","language":"Other","updated":"2026-03-30","comments":4,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-accurate-auto-config.md"},{"slug":"redis-secure-workflow-permissions","title":"Secure Workflow Permissions","description":"Apply two security practices to GitHub Actions workflows: 1) Enforce least privilege - Set `permissions: {}` at the workflow level (or default deny) and only add the minimal scopes required for each job/step.","repository":"redis/redis","domain":"data-systems","topic":"Security","language":"Yaml","updated":"2026-03-30","comments":2,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-secure-workflow-permissions.md"},{"slug":"openai-python-preserve-api-contracts","title":"Preserve API Contracts","description":"When transforming data to/from the API, always implement the backend’s explicit contract: ordering invariants, exact serialization, correct parsing by response format/content-type, endpoint-appropriate headers, and backend-specific URL/auth/version rules.","repository":"openai/openai-python","domain":"ai-agents","topic":"API","language":"Python","updated":"2026-03-28","comments":9,"stars":30731,"raw":"https://awesomereviewers.com/raw/openai-python-preserve-api-contracts.md"},{"slug":"redis-performance-first-structure","title":"Performance-first Structure","description":"When optimizing, treat performance as a design constraint: prevent contention/cache inefficiency, ensure server-side work is bounded per call, and keep tests from becoming slow bottlenecks.","repository":"redis/redis","domain":"data-systems","topic":"Performance Optimization","language":"Other","updated":"2026-03-27","comments":5,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-performance-first-structure.md"},{"slug":"python-ci-workflow-correctness","title":"CI workflow correctness","description":"All CI workflows must be syntactically valid, reliably triggered, and logically non-redundant. Apply these rules: 1) Every step must be valid: each `- name:` entry must include either `uses:` or `run:` (never both missing).","repository":"TheAlgorithms/Python","domain":"docs","topic":"CI/CD","language":"Yaml","updated":"2026-03-26","comments":12,"stars":220912,"raw":"https://awesomereviewers.com/raw/python-ci-workflow-correctness.md"},{"slug":"mermaid-cicd-release-hygiene","title":"CI/CD release hygiene","description":"For any PR that affects the build/release pipeline (scripts, manifests like package.json, or release tooling), require: 1) Pipeline must be green before requesting/continuing review","repository":"mermaid-js/mermaid","domain":"devtools","topic":"CI/CD","language":"Json","updated":"2026-03-26","comments":3,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-cicd-release-hygiene.md"},{"slug":"redis-validate-security-critical-data","title":"Validate security-critical data","description":"When code consumes security-critical data—either to perform privileged state changes at runtime or to download/execute external artifacts—it must validate integrity/invariants before proceeding.","repository":"redis/redis","domain":"data-systems","topic":"Security","language":"Other","updated":"2026-03-26","comments":2,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-validate-security-critical-data.md"},{"slug":"celery-deterministic-exception-handling","title":"Deterministic exception handling","description":"When handling errors, ensure (1) you don’t accidentally change which exception path fires, (2) recovery/cleanup is deterministic, and (3) any wrapping/aggregation preserves context and remains actionable.","repository":"celery/celery","domain":"orchestration","topic":"Error Handling","language":"Python","updated":"2026-03-25","comments":10,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-deterministic-exception-handling.md"},{"slug":"query-contract-accurate-testing","title":"Contract-Accurate Testing","description":"Tests should assert the behavior contract precisely, include the missing coverage for changed code, and stay isolated/noisy-control friendly. Key rules:","repository":"tanstack/query","domain":"app-frameworks","topic":"Testing","language":"TypeScript","updated":"2026-03-25","comments":10,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-contract-accurate-testing.md"},{"slug":"anthropic-sdk-python-async-concurrency-practices","title":"Async Concurrency Practices","description":"When working in async-capable code, ensure correctness and concurrency safety: 1) Keep async code truly async (no accidental sync calls) - If a branch is meant for async transformation, it must call/await async functions (e.g., use `await _async_transform_recursive(...)`, not the synchronous equivalent).","repository":"anthropics/anthropic-sdk-python","domain":"ai-agents","topic":"Concurrency","language":"Python","updated":"2026-03-25","comments":4,"stars":3392,"raw":"https://awesomereviewers.com/raw/anthropic-sdk-python-async-concurrency-practices.md"},{"slug":"tradingagents-concise-consistent-state","title":"Concise, Consistent State","description":"Adopt a style rule that keeps code (1) concise in data derivation, (2) consistent in input normalization, and (3) correct in conditional logic by using the right source of state.","repository":"TauricResearch/TradingAgents","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2026-03-25","comments":2,"stars":71953,"raw":"https://awesomereviewers.com/raw/tradingagents-concise-consistent-state.md"},{"slug":"redis-header-organization-and-comments","title":"Header Organization And Comments","description":"Keep header edits readable and durable: 1) Don’t write brittle comments - Avoid referencing exact line numbers or file offsets (they drift and become misleading). Prefer describing the behavior/why, not where it currently is.","repository":"redis/redis","domain":"data-systems","topic":"Code Style","language":"Other","updated":"2026-03-24","comments":4,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-header-organization-and-comments.md"},{"slug":"ruflo-harden-installation-security","title":"Harden installation security","description":"Any install/setup instructions and scripts must avoid common supply-chain and remote execution risks, and must clearly communicate the security posture.","repository":"ruvnet/ruflo","domain":"ai-agents","topic":"Security","language":"Other","updated":"2026-03-24","comments":1,"stars":47002,"raw":"https://awesomereviewers.com/raw/ruflo-harden-installation-security.md"},{"slug":"redis-clear-api-contracts","title":"Clear API Contracts","description":"Public APIs must make their guarantees and caller responsibilities explicit—especially around encapsulation, lifecycle/ownership, and callback semantics.","repository":"redis/redis","domain":"data-systems","topic":"API","language":"Other","updated":"2026-03-23","comments":5,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-clear-api-contracts.md"},{"slug":"tradingagents-tool-loop-output-contract","title":"Tool Loop Output Contract","description":"When implementing tool-using LLM agent nodes (e.g., LangGraph/LangChain multi-agent flows), standardize a “tool loop → finalize only when tools are done” contract.","repository":"TauricResearch/TradingAgents","domain":"ai-agents","topic":"AI","language":"Python","updated":"2026-03-23","comments":3,"stars":71953,"raw":"https://awesomereviewers.com/raw/tradingagents-tool-loop-output-contract.md"},{"slug":"agentcore-samples-safe-diagnostic-logging","title":"Safe diagnostic logging","description":"When adding logs or debug output, use them to improve traceability and\\ \\ troubleshooting without leaking secrets. \\n\\n**Do**\\n- Log **correlation identifiers**\\ \\ (e.g., `session_id`) in a **consistent, known format** (e.g., UUID) so issues\\ \\ can be followed end-to-end.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Logging","language":"Python","updated":"2026-03-23","comments":2,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-safe-diagnostic-logging.md"},{"slug":"anthropic-sdk-python-actionable-normalized-errors","title":"Actionable normalized errors","description":"When adding error handling for failure scenarios (infinite/looping behavior, retries, or other unbounded processes), ensure two things: 1) Normalize/validate error-relevant inputs before they affect control flow.","repository":"anthropics/anthropic-sdk-python","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2026-03-23","comments":2,"stars":3392,"raw":"https://awesomereviewers.com/raw/anthropic-sdk-python-actionable-normalized-errors.md"},{"slug":"redis-thread-ownership-discipline","title":"Thread Ownership Discipline","description":"When code can run on both main and IO threads, require an explicit ownership + synchronization rule for every shared piece of state (flags, counters, refcounts, pending lists, and memory frees). Concretely:","repository":"redis/redis","domain":"data-systems","topic":"Concurrency","language":"C","updated":"2026-03-22","comments":9,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-thread-ownership-discipline.md"},{"slug":"anthropic-sdk-python-deterministic-api-contracts","title":"Deterministic API Contracts","description":"When designing API client/runner behavior, ensure the contract is explicit, state-driven, and aligned with what the server actually supports. Apply these rules:","repository":"anthropics/anthropic-sdk-python","domain":"ai-agents","topic":"API","language":"Python","updated":"2026-03-20","comments":4,"stars":3392,"raw":"https://awesomereviewers.com/raw/anthropic-sdk-python-deterministic-api-contracts.md"},{"slug":"redis-semantic-naming-accuracy","title":"Semantic Naming Accuracy","description":"Ensure names and naming-related metadata are semantically accurate and unambiguous. - Don’t reuse a helper/identifier whose name is tied to a specific command if it creates confusion. Prefer a dedicated, clearly named function per command.","repository":"redis/redis","domain":"data-systems","topic":"Naming Conventions","language":"Json","updated":"2026-03-20","comments":2,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-semantic-naming-accuracy.md"},{"slug":"azure-quickstart-templates-infer-dependencies","title":"Infer Dependencies","description":"When modeling Bicep resources, prefer symbolic references and proper parent/child wiring so ARM/Bicep can infer ordering automatically. This improves readability (fewer manual `dependsOn`/hand-built IDs) and reduces dependency bugs.","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Code Style","language":"Other","updated":"2026-03-19","comments":9,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-infer-dependencies.md"},{"slug":"langchain-prefer-robust-testing-assertions","title":"Prefer Robust Testing Assertions","description":"When adding/changing tests, optimize for (1) clear intent, (2) stability against refactors, and (3) determinism. Practical rules: - Assert observable behavior, not intermediate implementation details. If you need to validate a request payload, mock the SDK client and inspect what was actually sent (not private helpers/step-by-step logic).","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2026-03-19","comments":9,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-prefer-robust-testing-assertions.md"},{"slug":"azure-quickstart-templates-nested-network-resource-ids","title":"Nested Network Resource IDs","description":"When working with Azure networking in Bicep, avoid “stringly” nested resource references built from `resourceId()` plus `dependsOn`. Instead: 1) **Define subnets idempotently**: create subnets inside the `virtualNetworks` resource via `properties.subnets`.","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Networking","language":"Other","updated":"2026-03-19","comments":7,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-nested-network-resource-ids.md"},{"slug":"gemini-skills-documentation-lookup-rules","title":"Documentation lookup rules","description":"When writing or updating API skill docs, treat documentation as an operational dependency: prefer the most up-to-date source, keep docs self-contained, and make examples unambiguous.","repository":"google-gemini/gemini-skills","domain":"ai-agents","topic":"Documentation","language":"Markdown","updated":"2026-03-19","comments":4,"stars":3451,"raw":"https://awesomereviewers.com/raw/gemini-skills-documentation-lookup-rules.md"},{"slug":"gemini-skills-prefer-up-to-date-docs","title":"Prefer up-to-date docs","description":"When building Gemini/LLM integrations, always use the most current and indexed API documentation/spec first, and avoid inefficient fallback behaviors.","repository":"google-gemini/gemini-skills","domain":"ai-agents","topic":"AI","language":"Markdown","updated":"2026-03-19","comments":2,"stars":3451,"raw":"https://awesomereviewers.com/raw/gemini-skills-prefer-up-to-date-docs.md"},{"slug":"aidlc-workflows-sandbox-config-boundary","title":"Sandbox config boundary","description":"When a feature flag like `use_sandbox` changes where code runs (host vs container), treat it as a configuration boundary: (1) explicitly provide the container environment your tools expect, and (2) remove/recreate any stateful artifacts created on the other side.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Configurations","language":"Python","updated":"2026-03-18","comments":3,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-sandbox-config-boundary.md"},{"slug":"freecodecamp-use-canonical-invariants","title":"Use canonical invariants","description":"When implementing algorithmic parsing/validation, base ordering/state on the canonical structured source, and keep validation logic split by invariant (local vs global) with explicit intent.","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"Algorithms","language":"JavaScript","updated":"2026-03-18","comments":2,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-use-canonical-invariants.md"},{"slug":"mermaid-consistent-naming-rules","title":"Consistent Naming Rules","description":"Adopt consistent, explicit identifier naming across diagrams and TypeScript APIs. **Rules** 1) **Diagram ids/syntax keywords** - Use **lower-case** diagram identifiers.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Naming Conventions","language":"TypeScript","updated":"2026-03-17","comments":10,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-consistent-naming-rules.md"},{"slug":"mermaid-prefer-grammar-over-regex","title":"Prefer Grammar Over Regex","description":"Use the language parser/grammar (e.g., Langium/Jison) for diagram syntax instead of hand-rolled regex parsing. Regex is allowed only for small, well-bounded token-level helpers when (a) it precisely matches the intended grammar slice (e.g., remove only *outer* quotes), (b) it doesn’t destructively change user content or semantics, and (c) it preserves...","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Algorithms","language":"TypeScript","updated":"2026-03-17","comments":7,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-prefer-grammar-over-regex.md"},{"slug":"omniroute-consistent-accessible-ui","title":"Consistent Accessible UI","description":"When adding expandable/conditional UI in React/TSX, keep the structure consistent within the surrounding component *and* ensure accessibility attributes are applied uniformly.","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Code Style","language":"TSX","updated":"2026-03-16","comments":2,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-consistent-accessible-ui.md"},{"slug":"celery-document-behavior-changes","title":"Document Behavior Changes","description":"Update documentation every time code behavior changes or new public APIs are introduced. Apply this checklist: 1) Docstring accuracy: If you change semantics (error handling, return values, shutdown behavior, etc.), update the docstring to match reality.","repository":"celery/celery","domain":"orchestration","topic":"Documentation","language":"Python","updated":"2026-03-15","comments":8,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-document-behavior-changes.md"},{"slug":"omniroute-fail-closed-credential-checks","title":"Fail-Closed Credential Checks","description":"When validating security state (e.g., whether credentials are encrypted, authorized sessions exist, tokens exist, etc.), treat any inability to inspect sensitive data as a security failure—don’t silently default to a permissive/incorrect outcome. In practice:","repository":"diegosouzapw/OmniRoute","domain":"llm-infra","topic":"Security","language":"JavaScript","updated":"2026-03-14","comments":2,"stars":33162,"raw":"https://awesomereviewers.com/raw/omniroute-fail-closed-credential-checks.md"},{"slug":"aidlc-workflows-pinned-releases-for-ci","title":"Pinned Releases For CI","description":"Ensure release and versioning behavior is deterministic and pipeline-owned. - For CI/CD workflows/rules: if it’s experimental, tracking the “head” is acceptable; for anything users rely on in production, pin to an explicit release (tag/zip/release branch) rather than “always latest” via submodule auto-update.","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"CI/CD","language":"Markdown","updated":"2026-03-13","comments":2,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-pinned-releases-for-ci.md"},{"slug":"celery-thread-safe-lifecycle-isolation","title":"Thread-safe lifecycle isolation","description":"When changing concurrency/background execution, ensure (a) state is isolated per thread/consumer/instance, and (b) shutdown/cleanup and exception signaling are coordinated with explicit synchronization.","repository":"celery/celery","domain":"orchestration","topic":"Concurrency","language":"Python","updated":"2026-03-12","comments":9,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-thread-safe-lifecycle-isolation.md"},{"slug":"freecodecamp-prefer-clear-semantic-code","title":"Prefer clear, semantic code","description":"Write code that’s easy to read and matches intent (mutability, string composition, UI semantics), and remove obvious clutter. Apply these rules: 1) Avoid reassignable variables","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"Code Style","language":"TSX","updated":"2026-03-11","comments":6,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-prefer-clear-semantic-code.md"},{"slug":"aidlc-workflows-portable-configuration-standards","title":"Portable Configuration Standards","description":"All configuration-driven setup and workflow behavior must be (a) convention-based and unambiguous, and (b) portable across environments. Apply this standard:","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"Configurations","language":"Markdown","updated":"2026-03-11","comments":3,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-portable-configuration-standards.md"},{"slug":"celery-readable-formatting-and-idioms","title":"Readable formatting and idioms","description":"Prioritize readability through consistent formatting and modern, simple idioms. For code style changes, ensure multiline constructs are formatted cleanly, complex conditions are made understandable (via extracted “effective” variables or small helpers), repeated patterns are factored out, and modern Python conventions are used.","repository":"celery/celery","domain":"orchestration","topic":"Code Style","language":"Python","updated":"2026-03-10","comments":12,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-readable-formatting-and-idioms.md"},{"slug":"freecodecamp-use-config-safely","title":"Use Config Safely","description":"Treat configuration/feature-flag-driven logic as potentially different between tests and runtime, and standardize how you branch on it. Apply this by:","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"Configurations","language":"TSX","updated":"2026-03-10","comments":2,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-use-config-safely.md"},{"slug":"celery-cache-only-after-inputs","title":"Cache Only After Inputs","description":"When adding or using caching (e.g., @cached_property, sys.modules-dependent behavior, or internal resolution caches), ensure the cached value depends only on inputs that are already stable.","repository":"celery/celery","domain":"orchestration","topic":"Caching","language":"Python","updated":"2026-03-09","comments":4,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-cache-only-after-inputs.md"},{"slug":"celery-semantic-naming-must","title":"Semantic Naming Must","description":"Use naming conventions that are both tooling-correct and behavior-semantic: - **Tooling-sensitive identifiers:** If a subsystem matches by name (e.g., test discovery), ensure the identifier follows the project’s configured pattern—otherwise tests may be skipped silently.","repository":"celery/celery","domain":"orchestration","topic":"Naming Conventions","language":"Python","updated":"2026-03-08","comments":6,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-semantic-naming-must.md"},{"slug":"agent-zero-prefer-imports-not-globals","title":"Prefer Imports, Not Globals","description":"When wiring state/functions, avoid implicit access through `window.*`/`globalThis`. Use explicit ES module imports so code is deterministic and loads correctly, and keep code in the module/plugin that owns it.","repository":"agent0ai/agent-zero","domain":"ai-agents","topic":"Code Style","language":"JavaScript","updated":"2026-03-08","comments":4,"stars":17612,"raw":"https://awesomereviewers.com/raw/agent-zero-prefer-imports-not-globals.md"},{"slug":"openai-python-preserve-null-semantics","title":"Preserve Null Semantics","description":"When inputs or response fields are optional/nullable, preserve their semantics explicitly and avoid unsafe coercion or indexing. Apply these rules: 1) Don’t coerce `None` with `bool(...)` when `None` has distinct meaning. If you mean “unset,” omit the field/parameter rather than converting it.","repository":"openai/openai-python","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2026-03-08","comments":4,"stars":30731,"raw":"https://awesomereviewers.com/raw/openai-python-preserve-null-semantics.md"},{"slug":"bmad-method-consistent-identifier-naming","title":"Consistent Identifier Naming","description":"Use deterministic, normalized identifiers everywhere. Apply two rules: 1) Single source of truth: derive canonical identifiers from one stable place (e.g., directory name), and don’t trust optional/conflicting metadata fields.","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Naming Conventions","language":"JavaScript","updated":"2026-03-08","comments":2,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-consistent-identifier-naming.md"},{"slug":"langchain-docstrings-with-intent","title":"Docstrings With Intent","description":"Adopt a single documentation standard: every docstring/comment should (1) explain intent and observable behavior, (2) make responsibility/ownership explicit, (3) be traceable when tied to external or non-obvious defaults, (4) be safe when examples could do harm, and (5) follow established docstring conventions without duplicating type annotations.","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"Documentation","language":"Python","updated":"2026-03-06","comments":15,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-docstrings-with-intent.md"},{"slug":"agentcore-samples-use-valid-api-contracts","title":"Use Valid API Contracts","description":"When calling SDK/toolkit APIs, always adhere to the documented method signatures and request/response shapes. Don’t pass guessed or stale keyword arguments, and prefer the project’s canonical starter toolkit abstractions for common lifecycle operations.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"API","language":"Other","updated":"2026-03-06","comments":3,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-use-valid-api-contracts.md"},{"slug":"ncnn-use-exact-math-semantics","title":"Use exact math semantics","description":"When implementing performance-critical algorithms (e.g., pooling, math kernels, SIMD/ISA code), preserve the algorithm’s true numeric semantics and parameterization:","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Algorithms","language":"Other","updated":"2026-03-06","comments":2,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-use-exact-math-semantics.md"},{"slug":"bmad-method-consistent-markdown-formatting","title":"Consistent Markdown Formatting","description":"Make Markdown generation deterministic and parser-safe. 1) Quote frontmatter/template variables - When using placeholders like `{{description}}` in Markdown frontmatter, wrap the value in quotes to prevent Antigravity/CLI parsing from breaking on special character sequences (e.g., ` #`, `: `).","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Code Style","language":"Markdown","updated":"2026-03-05","comments":3,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-consistent-markdown-formatting.md"},{"slug":"axonhub-enforce-layered-reuse","title":"Enforce Layered Reuse","description":"When changing or adding code, keep logic and dependencies clean: - Centralize invariants in the owning function: if you need to clamp/validate values, apply it inside the core method that produces/returns them (the “source of truth”) rather than at every call site.","repository":"looplj/axonhub","domain":"llm-infra","topic":"Code Style","language":"Go","updated":"2026-03-04","comments":3,"stars":4808,"raw":"https://awesomereviewers.com/raw/axonhub-enforce-layered-reuse.md"},{"slug":"bmad-method-graceful-null-checks","title":"Graceful Null Checks","description":"Always treat null/empty/missing required values as first-class cases: validate early, and either stop with a clear “HALT-and-ask” (for inputs needed to proceed) or conditionally render safe output (to avoid blank placeholders).","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Null Handling","language":"Markdown","updated":"2026-03-02","comments":2,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-graceful-null-checks.md"},{"slug":"openai-python-code-style-typing-dry","title":"Code Style, Typing, DRY","description":"Adopt a “type-safe, clean, DRY” style for readability and maintainability. - Prefer module-scope imports: don’t re-import a module inside a function if it already exists at file scope.","repository":"openai/openai-python","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2026-03-01","comments":9,"stars":30731,"raw":"https://awesomereviewers.com/raw/openai-python-code-style-typing-dry.md"},{"slug":"anthropic-sdk-python-prefer-precise-typing","title":"Prefer precise typing","description":"Use precise types instead of `Any`, and avoid unnecessary `typing.cast` by relying on type-guard utilities and existing type narrowing. In tests, prefer the concrete pytest types/fixtures (e.g., `pytest.MonkeyPatch`) over broad `Any`.","repository":"anthropics/anthropic-sdk-python","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2026-02-27","comments":5,"stars":3392,"raw":"https://awesomereviewers.com/raw/anthropic-sdk-python-prefer-precise-typing.md"},{"slug":"agentcore-samples-manage-session-lifecycles","title":"Manage Session Lifecycles","description":"To optimize performance and avoid wasted compute (vCPU/memory), ensure AgentCore sessions end promptly—either by setting an appropriate idle timeout or by explicitly stopping the session when work is complete.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Performance Optimization","language":"Other","updated":"2026-02-27","comments":2,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-manage-session-lifecycles.md"},{"slug":"agentcore-samples-async-status-over-loops","title":"Async status over loops","description":"When using AgentCore Runtime for long-running/async jobs, manage concurrency by relying on the runtime’s status mechanisms rather than blocking or implementing unbounded wait loops. Clients should start the async job, return immediately, and then use the provided status API/methods or the /ping health signal to determine progress.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Concurrency","language":"Other","updated":"2026-02-26","comments":2,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-async-status-over-loops.md"},{"slug":"anthropic-sdk-python-high-signal-testing-practices","title":"High-signal Testing Practices","description":"Write tests that are (a) high-signal and not fragile, and (b) structured with standard pytest mechanisms. Apply: - Use fixtures instead of module/global clients, so each test has clean, controllable dependencies.","repository":"anthropics/anthropic-sdk-python","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2026-02-25","comments":6,"stars":3392,"raw":"https://awesomereviewers.com/raw/anthropic-sdk-python-high-signal-testing-practices.md"},{"slug":"nanochat-deterministic-selection-parsing","title":"Deterministic selection parsing","description":"When implementing algorithmic “pick/keep/max” logic, make the selected set deterministic and the ordering explicit—then compute sort/max keys using robust parsing.","repository":"karpathy/nanochat","domain":"ml-systems","topic":"Algorithms","language":"Python","updated":"2026-02-25","comments":3,"stars":53189,"raw":"https://awesomereviewers.com/raw/nanochat-deterministic-selection-parsing.md"},{"slug":"agent-zero-unified-extension-api-contracts","title":"Unified extension API contracts","description":"When building WebUI plugin/extension systems, treat the backend as the source of truth for (1) resolving extension contents and (2) providing a stable context schema to JS extensions.","repository":"agent0ai/agent-zero","domain":"ai-agents","topic":"API","language":"JavaScript","updated":"2026-02-25","comments":2,"stars":17612,"raw":"https://awesomereviewers.com/raw/agent-zero-unified-extension-api-contracts.md"},{"slug":"langchain-consistent-none-handling","title":"Consistent None Handling","description":"When a value can be missing/null, reflect it in the type system and handle it explicitly at the boundary—never leak `None` into observable outputs (yields, dict keys, metadata, merged content) and don’t “paper over” missing invariants with synthetic placeholders.","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2026-02-24","comments":7,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-consistent-none-handling.md"},{"slug":"nanochat-guard-and-narrow-exceptions","title":"Guard and narrow exceptions","description":"When an operation can fail in a known way (edge-case inputs, risky math, I/O/parsing, optional capabilities), handle it explicitly: - Add targeted guards before risky computations (e.g., avoid dividing/normalizing by an empty denominator).","repository":"karpathy/nanochat","domain":"ml-systems","topic":"Error Handling","language":"Python","updated":"2026-02-24","comments":7,"stars":53189,"raw":"https://awesomereviewers.com/raw/nanochat-guard-and-narrow-exceptions.md"},{"slug":"nanochat-idiomatic-readable-formatting","title":"Idiomatic Readable Formatting","description":"When touching code that formats output or builds paths, keep it idiomatic and repo-consistent: - Avoid inline conditionals inside large f-strings; precompute conditional fragments and interpolate them.","repository":"karpathy/nanochat","domain":"ml-systems","topic":"Code Style","language":"Python","updated":"2026-02-20","comments":5,"stars":53189,"raw":"https://awesomereviewers.com/raw/nanochat-idiomatic-readable-formatting.md"},{"slug":"nanochat-capability-aware-fast-paths","title":"Capability-Aware Fast Paths","description":"When optimizing for speed, make the fast path both *correct for the actual hardware* and *lightweight in implementation*. 1) Keep kernel support documentation accurate and capability-aware","repository":"karpathy/nanochat","domain":"ml-systems","topic":"Performance Optimization","language":"Python","updated":"2026-02-18","comments":3,"stars":53189,"raw":"https://awesomereviewers.com/raw/nanochat-capability-aware-fast-paths.md"},{"slug":"mcp-least-privilege-ci-permissions","title":"Least Privilege CI Permissions","description":"In CI/CD (e.g., GitHub Actions), follow least-privilege for the built-in `GITHUB_TOKEN`. Avoid granting broad, workflow-wide permissions. Default to no permissions at the top level, then explicitly grant only what a specific job needs.","repository":"awslabs/mcp","domain":"ai-agents","topic":"Security","language":"Yaml","updated":"2026-02-17","comments":1,"stars":9545,"raw":"https://awesomereviewers.com/raw/mcp-least-privilege-ci-permissions.md"},{"slug":"nanochat-deterministic-ci-runs","title":"Deterministic CI Runs","description":"Ensure GitHub Actions CI runs are repeatable, targeted, and don’t rely on brittle hacks. 1) Run tests using the environment you just prepared - If you use `uv sync`, run pytest using the created venv/python (or otherwise guarantee `uv run` uses the synced environment without re-installing).","repository":"karpathy/nanochat","domain":"ml-systems","topic":"CI/CD","language":"Yaml","updated":"2026-02-16","comments":9,"stars":53189,"raw":"https://awesomereviewers.com/raw/nanochat-deterministic-ci-runs.md"},{"slug":"bmad-method-fail-fast-validation-gates","title":"Fail-Fast Validation Gates","description":"When performing checklist-style validations (or any structured verification), implement error handling that is fail-fast, deterministic, and human-actionable:","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Error Handling","language":"Xml","updated":"2026-02-14","comments":3,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-fail-fast-validation-gates.md"},{"slug":"bmad-method-deterministic-validation-aggregation","title":"Deterministic Validation Aggregation","description":"When implementing checklist/workflow validation, treat the process like a deterministic algorithm: - **Total coverage**: execute steps in order; evaluate **every** checklist item/section; never skip.","repository":"bmad-code-org/bmad-method","domain":"app-frameworks","topic":"Algorithms","language":"Xml","updated":"2026-02-14","comments":2,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-deterministic-validation-aggregation.md"},{"slug":"ncnn-consistency-and-readability","title":"Consistency And Readability","description":"Apply a single, repeatable style checklist across all new/modified code: 1) Remove unused/redundant code - Drop unused `#include`s and unused variables.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Code Style","language":"C++","updated":"2026-02-13","comments":14,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-consistency-and-readability.md"},{"slug":"agent-zero-centralize-shared-fields","title":"Centralize shared fields","description":"When multiple modules need the same state/config/schema (e.g., context variables like timezone, or prompt search paths), do not replicate those fields or the logic that derives them in several places. Instead, funnel access through a single abstraction and reuse shared utilities.","repository":"agent0ai/agent-zero","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2026-02-12","comments":4,"stars":17612,"raw":"https://awesomereviewers.com/raw/agent-zero-centralize-shared-fields.md"},{"slug":"agent-zero-namespace-plugin-apis","title":"Namespace plugin APIs","description":"When exposing data to the client, treat shared/global values and plugin routes as explicit API surface: 1) Don’t publish global client/window state by sprinkling ad-hoc dictionaries into multiple unrelated API handlers. Instead, use one centralized mechanism:","repository":"agent0ai/agent-zero","domain":"ai-agents","topic":"API","language":"Python","updated":"2026-02-12","comments":4,"stars":17612,"raw":"https://awesomereviewers.com/raw/agent-zero-namespace-plugin-apis.md"},{"slug":"heretic-use-clear-names","title":"Use clear names","description":"Rule: choose concise, semantically accurate, and responsibility-respecting names for identifiers (variables, functions, classes, modules). Motivation: clear names reduce cognitive load, avoid ambiguity, and prevent leaking responsibilities across layers.","repository":"p-e-w/heretic","domain":"ml-systems","topic":"Naming Conventions","language":"Python","updated":"2026-02-11","comments":11,"stars":5002,"raw":"https://awesomereviewers.com/raw/heretic-use-clear-names.md"},{"slug":"celery-explicit-dependency-constraints","title":"Explicit dependency constraints","description":"In configuration/requirements files, make compatibility explicit: bound versions to prevent silent breakage across Python/platform build environments, and use environment markers for dependencies that differ by Python version, OS, implementation, or wheel availability.","repository":"celery/celery","domain":"orchestration","topic":"Configurations","language":"Txt","updated":"2026-02-10","comments":8,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-explicit-dependency-constraints.md"},{"slug":"celery-environment-consistent-builds","title":"Environment-consistent builds","description":"When building/installing Python dependencies in Docker/CI for multiple Python versions, keep the environment deterministic and aligned across interpreters: use the same dependency constraint/lock inputs everywhere and ensure the packaging toolchain is consistent per interpreter.","repository":"celery/celery","domain":"orchestration","topic":"Configurations","language":"Dockerfile","updated":"2026-02-10","comments":3,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-environment-consistent-builds.md"},{"slug":"query-use-angular-v19-strictness","title":"Use Angular v19+ Strictness","description":"When targeting Angular v19+ (or modernizing to it), align your package peer/dependency baselines and update tsconfig to the corresponding strict compiler settings—then apply the same policy across all Angular examples.","repository":"tanstack/query","domain":"app-frameworks","topic":"Angular","language":"Json","updated":"2026-02-09","comments":5,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-use-angular-v19-strictness.md"},{"slug":"freecodecamp-minimize-api-roundtrips","title":"Minimize API Roundtrips","description":"When the client performs a state-changing action, design the API contract so it can be completed in as few requests as possible—prefer batch-capable endpoints and responses that include what the client needs to update UI/state without additional “refresh” calls. Also, for one-way boolean updates where the server can infer intent, avoid unnecessary request...","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"API","language":"TSX","updated":"2026-02-09","comments":3,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-minimize-api-roundtrips.md"},{"slug":"anthropic-sdk-python-explicit-none-checks","title":"Explicit None Checks","description":"When working with nullable/optional values, treat `None` (absence) differently from other falsy values like `\"\"` (empty string) or `0` (zero). Use explicit `is not None` checks when empty values are valid, and avoid repeating null checks after you’ve already established a non-null invariant via an early return/guard.","repository":"anthropics/anthropic-sdk-python","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2026-02-09","comments":2,"stars":3392,"raw":"https://awesomereviewers.com/raw/anthropic-sdk-python-explicit-none-checks.md"},{"slug":"skills-keep-secrets-out","title":"Keep secrets out","description":"Do not commit secret keys, credentials, or signing material to source code or public repos. Store secrets in environment variables or a managed secret store, load them at runtime, and ensure they are not present in repository history. Design signed tokens so that the server validates them and they are short-lived, and have a plan to rotate/revoke keys if...","repository":"openai/skills","domain":"ai-agents","topic":"Security","language":"Python","updated":"2026-02-09","comments":1,"stars":7991,"raw":"https://awesomereviewers.com/raw/skills-keep-secrets-out.md"},{"slug":"axonhub-deep-copy-cached-state","title":"Deep-copy cached state","description":"When cached data (e.g., `row.settings`) is used to initialize mutable UI state (forms, editors, draft objects), do not pass cached object references directly. Always deep-clone cached objects on entry to editable state to prevent unintended cache mutations and ensure copied/duplicated initialization is isolated.","repository":"looplj/axonhub","domain":"llm-infra","topic":"Caching","language":"TSX","updated":"2026-02-07","comments":2,"stars":4808,"raw":"https://awesomereviewers.com/raw/axonhub-deep-copy-cached-state.md"},{"slug":"ragflow-document-stable-api-contracts","title":"Document Stable API Contracts","description":"All API reference docs (and examples) must clearly define the *public* contract vs *temporary/hidden* behavior, and keep endpoint paths/query params and response fields consistent.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"API","language":"Markdown","updated":"2026-02-05","comments":5,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-document-stable-api-contracts.md"},{"slug":"free-programming-books-canonical-documentation-entries","title":"Canonical Documentation Entries","description":"When adding or updating documentation entries (e.g., course/resource lists), use canonical metadata and URLs so links don’t break, don’t leak tracking, and render correctly.","repository":"EbookFoundation/free-programming-books","domain":"docs","topic":"Documentation","language":"Markdown","updated":"2026-02-03","comments":47,"stars":388003,"raw":"https://awesomereviewers.com/raw/free-programming-books-canonical-documentation-entries.md"},{"slug":"freecodecamp-avoid-unnecessary-type-assertions","title":"Avoid Unnecessary Type Assertions","description":"In route/controller code, don’t rely on repeated `as` casts to satisfy TypeScript—normalize/validate types once, then keep the rest of the logic strongly typed.","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"Code Style","language":"TypeScript","updated":"2026-02-03","comments":2,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-avoid-unnecessary-type-assertions.md"},{"slug":"freecodecamp-restful-endpoint-responses","title":"RESTful endpoint responses","description":"When designing API routes, make the HTTP method and response contract match the operation’s intent and the client’s needs. - Pick the correct verb: use DELETE for destructive/reset-like removal semantics when appropriate, and reserve POST for creation/processing actions.","repository":"freeCodeCamp/freeCodeCamp","domain":"docs","topic":"API","language":"TypeScript","updated":"2026-02-03","comments":2,"stars":444449,"raw":"https://awesomereviewers.com/raw/freecodecamp-restful-endpoint-responses.md"},{"slug":"aidlc-workflows-concise-factual-instructions","title":"Concise Factual Instructions","description":"When writing AI rules or workflow instructions, keep the language concise and unambiguous, and for any factual/time-sensitive output require the model to derive it from runtime results (never placeholders or estimates). Overusing high-salience markers (e.g., many `MANDATORY/CRITICAL` tags) can reduce compliance; instead, make requirements explicit via...","repository":"awslabs/aidlc-workflows","domain":"orchestration","topic":"AI","language":"Markdown","updated":"2026-02-02","comments":2,"stars":3849,"raw":"https://awesomereviewers.com/raw/aidlc-workflows-concise-factual-instructions.md"},{"slug":"heretic-configuration-ownership-and-determinism","title":"Configuration ownership and determinism","description":"Summary - Ensure configuration is explicit, owned by the correct component (application vs plugin), and deterministic so behavior is predictable and resumable.","repository":"p-e-w/heretic","domain":"ml-systems","topic":"Configurations","language":"Python","updated":"2026-02-01","comments":25,"stars":5002,"raw":"https://awesomereviewers.com/raw/heretic-configuration-ownership-and-determinism.md"},{"slug":"heretic-model-integration-rules","title":"Model integration rules","description":"When adding or changing model loading, quantization, LoRA/abliteration logic, or merging behavior, follow these explicit rules to ensure correctness, compatibility and reproducibility.","repository":"p-e-w/heretic","domain":"ml-systems","topic":"AI","language":"Python","updated":"2026-02-01","comments":16,"stars":5002,"raw":"https://awesomereviewers.com/raw/heretic-model-integration-rules.md"},{"slug":"nanochat-safe-configuration-defaults","title":"Safe configuration defaults","description":"When writing run/config scripts, prefer *local, opt-in* environment changes and *guarded* defaults. **Rules** 1. **Don’t mutate persistent user config** (e.g., appending to `~/.bashrc`/`~/.profile`). If you need PATH changes, set them for the current process only (e.g., `export PATH=...` inside the script).","repository":"karpathy/nanochat","domain":"ml-systems","topic":"Configurations","language":"Shell","updated":"2026-02-01","comments":3,"stars":53189,"raw":"https://awesomereviewers.com/raw/nanochat-safe-configuration-defaults.md"},{"slug":"pi-domain-aligned-identifier-naming","title":"Domain-aligned Identifier Naming","description":"When introducing identifiers that represent external/domain data (e.g., tool calls, event payloads) and shared utilities, keep naming and placement semantically aligned and avoid redundant typing.","repository":"earendil-works/pi","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2026-02-01","comments":2,"stars":79783,"raw":"https://awesomereviewers.com/raw/pi-domain-aligned-identifier-naming.md"},{"slug":"query-scoped-cache-reset-rules","title":"Scoped cache reset rules","description":"When code triggers cache reset/refetch or relies on cached freshness, make the behavior intentionally scoped and snapshot-correct: - Scope reset-triggered refetches to the intended cache region:","repository":"tanstack/query","domain":"app-frameworks","topic":"Caching","language":"TSX","updated":"2026-01-31","comments":5,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-scoped-cache-reset-rules.md"},{"slug":"heretic-manage-tensors-proactively","title":"Manage tensors proactively","description":"Motivation: Large models and matrix ops can produce big ephemeral tensors, cross-device copies, and temporary allocations that lead to excessive memory use or OOMs. Adopt consistent, device-aware tensor handling, prefer built-in ops, and free large temporaries at clear boundaries.","repository":"p-e-w/heretic","domain":"ml-systems","topic":"Performance Optimization","language":"Python","updated":"2026-01-30","comments":8,"stars":5002,"raw":"https://awesomereviewers.com/raw/heretic-manage-tensors-proactively.md"},{"slug":"container-check-privilege-early","title":"Check Privilege Early","description":"When a script performs privileged or security-sensitive actions (e.g., deleting/installing application files in system directories), explicitly enforce the required authorization before proceeding.","repository":"apple/container","domain":"orchestration","topic":"Security","language":"Shell","updated":"2026-01-30","comments":1,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-check-privilege-early.md"},{"slug":"heretic-plugin-contract-api","title":"plugin contract API","description":"Define a clear, minimal plugin contract and loader API for all external/ built-in plugins. Motivation: plugins (taggers/scorers) are the public extension points of the system and must declare what data they need, how they initialize, and be loadable from arbitrary modules so users can provide custom implementations without modifying the project.","repository":"p-e-w/heretic","domain":"ml-systems","topic":"API","language":"Python","updated":"2026-01-29","comments":9,"stars":5002,"raw":"https://awesomereviewers.com/raw/heretic-plugin-contract-api.md"},{"slug":"mermaid-changeset-release-hygiene","title":"Changeset release hygiene","description":"Ensure changeset PRs produce correct and minimal release automation output. Apply these rules before submitting: - **Create changesets only for user/release-relevant changes.** If it’s documentation-only, **do not** add a changeset.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"CI/CD","language":"Markdown","updated":"2026-01-29","comments":8,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-changeset-release-hygiene.md"},{"slug":"mermaid-comprehensive-test-coverage","title":"Comprehensive Test Coverage","description":"When implementing or extending functionality, ensure tests (primarily unit tests for non-renderer code) cover the full supported behavior surface—not just a subset.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Testing","language":"Markdown","updated":"2026-01-29","comments":2,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-comprehensive-test-coverage.md"},{"slug":"query-resolve-predicates-seed-reducers","title":"Resolve predicates, seed reducers","description":"When building or extending algorithmic pipelines (streaming, reduction, conditional processing), ensure two correctness points: 1) Resolve dynamic conditions before acting","repository":"tanstack/query","domain":"app-frameworks","topic":"Algorithms","language":"TSX","updated":"2026-01-29","comments":2,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-resolve-predicates-seed-reducers.md"},{"slug":"heretic-consistent-module-organization","title":"Consistent module organization","description":"Keep code organized by responsibility and centralize reusable logic. Concretely: - Centralize helpers: move shared implementations (plugin loading, dataset parsing, prompt helpers, is_notebook, prompt wrappers, etc.) into a single utils or plugin package and import them from one place. Avoid copy-pasting variations of the same logic across files — this...","repository":"p-e-w/heretic","domain":"ml-systems","topic":"Code Style","language":"Python","updated":"2026-01-26","comments":16,"stars":5002,"raw":"https://awesomereviewers.com/raw/heretic-consistent-module-organization.md"},{"slug":"heretic-config-schema-conventions","title":"Config schema conventions","description":"Provide a clear, stable, and discoverable configuration schema. Apply the following rules to all TOML/environment configs: 1) Use self-documenting values","repository":"p-e-w/heretic","domain":"ml-systems","topic":"Configurations","language":"Toml","updated":"2026-01-26","comments":8,"stars":5002,"raw":"https://awesomereviewers.com/raw/heretic-config-schema-conventions.md"},{"slug":"query-configurable-tooling-rules","title":"Configurable tooling rules","description":"Specialized tooling (lint rules, dev-only packages, docs navigation) must be explicitly enabled and driven by configuration so it won’t misfire in the wrong project context.","repository":"tanstack/query","domain":"app-frameworks","topic":"Configurations","language":"Markdown","updated":"2026-01-25","comments":3,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-configurable-tooling-rules.md"},{"slug":"agent-skills-effect-cleanup-and-subscriptions","title":"Effect cleanup and subscriptions","description":"When using React hooks that interact with external systems (browser events, subscriptions, async requests), write code so it cannot leak resources or update state after the component unmounts.","repository":"vercel-labs/agent-skills","domain":"ai-agents","topic":"React","language":"Markdown","updated":"2026-01-25","comments":2,"stars":26385,"raw":"https://awesomereviewers.com/raw/agent-skills-effect-cleanup-and-subscriptions.md"},{"slug":"axonhub-scoped-provider-transformations","title":"Scoped Provider Transformations","description":"When implementing AI/LLM request transformers (especially for proxies), make provider-specific shaping: 1) **Scoped and structured**: Clone the incoming `llm.Request` and apply provider/CLI-specific changes via existing structured fields **before** delegating to the shared/base transformer whenever possible. Avoid raw `[]byte` request-body manipulation...","repository":"looplj/axonhub","domain":"llm-infra","topic":"AI","language":"Go","updated":"2026-01-24","comments":2,"stars":4808,"raw":"https://awesomereviewers.com/raw/axonhub-scoped-provider-transformations.md"},{"slug":"ragflow-token-and-prompt-fidelity","title":"Token and Prompt Fidelity","description":"When implementing LLM/AI APIs (including streaming), treat three things as contract-critical: (1) compute token usage with a real tokenizer, (2) ensure the intended system/user context is actually passed through every planning/tool stage, and (3) emit only the events your client expects.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"AI","language":"Python","updated":"2026-01-22","comments":4,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-token-and-prompt-fidelity.md"},{"slug":"query-deterministic-ci-gates","title":"Deterministic CI Gates","description":"Ensure CI/CD is deterministic and comprehensive: pin versions when dependencies/tooling have drifted, make the same checks run on PRs as on main, and test against the full supported toolchain/version range.","repository":"tanstack/query","domain":"app-frameworks","topic":"CI/CD","language":"Json","updated":"2026-01-21","comments":3,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-deterministic-ci-gates.md"},{"slug":"heretic-surface-errors-clearly","title":"Surface errors clearly","description":"Rule: Fail fast, validate assumptions, and distinguish user cancellation. Motivation - Hidden or silently handled errors lead to incorrect behavior, confusing UX, and hard-to-debug failures (e.g., silently ignoring invalid saved study settings, treating Ctrl+C as a legitimate choice, or swallowing invalid split specs).","repository":"p-e-w/heretic","domain":"ml-systems","topic":"Error Handling","language":"Python","updated":"2026-01-20","comments":11,"stars":5002,"raw":"https://awesomereviewers.com/raw/heretic-surface-errors-clearly.md"},{"slug":"heretic-handle-nullable-values","title":"Handle nullable values","description":"Treat None/absent values explicitly and guard attribute access. Motivation: user input, storage APIs, optional configuration, and runtime objects can all produce None or lack expected attributes. Implicitly assuming presence leads to data loss (e.g., deleting checkpoints on a cancelled prompt), brittle logic, and runtime errors.","repository":"p-e-w/heretic","domain":"ml-systems","topic":"Null Handling","language":"Python","updated":"2026-01-20","comments":7,"stars":5002,"raw":"https://awesomereviewers.com/raw/heretic-handle-nullable-values.md"},{"slug":"heretic-optimization-algorithm-compatibility","title":"Optimization algorithm compatibility","description":"When implementing or changing optimization code (samplers, objectives, and result selection), ensure algorithmic correctness, preserve sampler assumptions, and prefer explicit post-processing over ad‑hoc objective hacks.","repository":"p-e-w/heretic","domain":"ml-systems","topic":"Algorithms","language":"Python","updated":"2026-01-20","comments":5,"stars":5002,"raw":"https://awesomereviewers.com/raw/heretic-optimization-algorithm-compatibility.md"},{"slug":"heretic-sanitize-filesystem-inputs","title":"sanitize filesystem inputs","description":"When constructing filesystem paths or filenames from external input (model names, user-provided identifiers, etc.), treat those strings as untrusted. Whitelist allowed characters, disallow dots and path separators, and verify the final path stays inside the intended directory to prevent path traversal or accidental file access/deletion.","repository":"p-e-w/heretic","domain":"ml-systems","topic":"Security","language":"Python","updated":"2026-01-19","comments":1,"stars":5002,"raw":"https://awesomereviewers.com/raw/heretic-sanitize-filesystem-inputs.md"},{"slug":"zod-guard-nullable-inputs","title":"Guard nullable inputs","description":"When a value can be `undefined`/`null`, do not assume it exists—guard it before access and keep the type model consistent. **Rules** - Use optional chaining / nullish guards when reading fields from optional params:","repository":"colinhacks/zod","domain":"app-frameworks","topic":"Null Handling","language":"TypeScript","updated":"2026-01-18","comments":7,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-guard-nullable-inputs.md"},{"slug":"agent-skills-prefer-nonmutating-multiset-checks","title":"Prefer nonmutating multiset checks","description":"When doing algorithmic equality checks for arrays where order doesn’t matter (multiset equality), avoid (a) mutating the input with `.sort()` and (b) sort+join/stringify approaches when a linear-time counting strategy is available. Use a non-mutating sort (`toSorted`) only if sorting is truly the chosen approach; otherwise prefer counting maps (expected...","repository":"vercel-labs/agent-skills","domain":"ai-agents","topic":"Algorithms","language":"Markdown","updated":"2026-01-18","comments":2,"stars":26385,"raw":"https://awesomereviewers.com/raw/agent-skills-prefer-nonmutating-multiset-checks.md"},{"slug":"celery-split-dependency-installs","title":"Split Dependency Installs","description":"When building Docker images, optimize dependency installation for both caching and resource limits. Apply these rules: 1) **Maximize layer caching:** install Python requirements *before* copying your application source.","repository":"celery/celery","domain":"orchestration","topic":"Performance Optimization","language":"Dockerfile","updated":"2026-01-17","comments":3,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-split-dependency-installs.md"},{"slug":"agentcore-samples-redact-secrets-in-logs","title":"Redact Secrets in Logs","description":"When adding logging/debug output for authentication/authorization, apply two rules: 1) Auth configuration metadata is OK - Safe to print non-sensitive authorization configuration (e.g., allowed OAuth flows, explicit auth flows, client name) since it does not expose credentials.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Security","language":"Python","updated":"2026-01-16","comments":4,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-redact-secrets-in-logs.md"},{"slug":"nanochat-determinism-and-compatibility","title":"Determinism and compatibility","description":"When working on LLM inference/engines, ensure (1) determinism tests actually test the intended invariants, (2) optional GPU-accelerated kernels are only loaded when the hardware supports them (with a safe fallback), and (3) KV-cache shape assumptions are documented accurately.","repository":"karpathy/nanochat","domain":"ml-systems","topic":"AI","language":"Python","updated":"2026-01-16","comments":3,"stars":53189,"raw":"https://awesomereviewers.com/raw/nanochat-determinism-and-compatibility.md"},{"slug":"mermaid-document-api-changes","title":"Document API Changes","description":"When you change an exported/non-trivial API (or add new function parameters), update JSDoc so it is complete and directly helpful: - For every added/changed parameter: include a `{type}` and a short description of what the parameter controls.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Documentation","language":"JavaScript","updated":"2026-01-16","comments":2,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-document-api-changes.md"},{"slug":"pi-no-console-logging","title":"No Console Logging","description":"Avoid direct `console.log`/`console.warn` (and other `console.*`) in application code—especially in TUI/interactive flows—because it can break rendering and other runtime behavior. Route all log/diagnostic output through the project’s logging/UI abstraction so messages are formatted and displayed consistently.","repository":"earendil-works/pi","domain":"ai-agents","topic":"Logging","language":"TypeScript","updated":"2026-01-16","comments":2,"stars":79783,"raw":"https://awesomereviewers.com/raw/pi-no-console-logging.md"},{"slug":"mermaid-config-driven-theming","title":"Config-driven theming","description":"When rendering/layout is affected by configuration or theming, avoid magic numbers and ad-hoc config handling. Instead: - Use a centralized “effective config” helper for all config-derived decisions, including correct type coercion (e.g., treat `\"false\"` the same as `false`).","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Configurations","language":"JavaScript","updated":"2026-01-15","comments":5,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-config-driven-theming.md"},{"slug":"ragflow-transactional-delete-and-upsert","title":"Transactional delete and upsert","description":"For database writes that can partially succeed (multi-step deletes/updates, bulk upserts with conflict handling), enforce invariants with **atomic transactions**, **explicit outcome validation**, and **engine-specific SQL encapsulation**.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Database","language":"Python","updated":"2026-01-15","comments":3,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-transactional-delete-and-upsert.md"},{"slug":"bmad-method-control-agent-context-budgets","title":"Control Agent Context Budgets","description":"Always cap and actively prevent generative-agent context bloat. 1) Enforce explicit context/prompt budgets in code (hard max + warning threshold) so inputs never silently grow.","repository":"bmad-code-org/bmad-method","domain":"ai-agents","topic":"AI","language":"JavaScript","updated":"2026-01-15","comments":2,"stars":51859,"raw":"https://awesomereviewers.com/raw/bmad-method-control-agent-context-budgets.md"},{"slug":"ragflow-useeffect-dependency-correctness","title":"UseEffect Dependency Correctness","description":"Side effects must be written with the correct React lifecycle mental model: `useEffect` runs after render/commit, not at the place the code is written. Always include a dependency array and make the effect’s inputs explicit so state resets (e.g., initializing defaults when a dialog opens) happen at the right time and without stale reads.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"React","language":"TSX","updated":"2026-01-14","comments":4,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-useeffect-dependency-correctness.md"},{"slug":"heretic-consistent-identifier-naming","title":"consistent identifier naming","description":"Prefer clear, consistent, and semantic names for variables, classes,\\ \\ config keys, and section labels. Use these concrete rules when naming: \\n\\n- Use\\ \\ nouns for metrics/objects and verbs for actions. Prefer semantically meaningful\\ \\ units (e.g., use RefusalRate rather than CountRefusals) so scales are interpretable\\ \\ and independent of context:","repository":"p-e-w/heretic","domain":"ml-systems","topic":"Naming Conventions","language":"Toml","updated":"2026-01-14","comments":3,"stars":5002,"raw":"https://awesomereviewers.com/raw/heretic-consistent-identifier-naming.md"},{"slug":"azure-sentinel-avoid-logging-sensitive-data","title":"Avoid Logging Sensitive Data","description":"Do not log raw function parameters (e.g., `kwargs`, request bodies, headers, tokens, credentials, or any data that could include PII). Logging can expose sensitive information via application logs, monitoring systems, or log sharing.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Security","language":"Python","updated":"2026-01-14","comments":1,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-avoid-logging-sensitive-data.md"},{"slug":"agent-zero-lock-writes-snapshot-reads","title":"Lock Writes, Snapshot Reads","description":"Use the lock to protect shared mutable state during mutations, but avoid holding it for read-side convenience/field-by-field getters. **Rules** 1. **Lock only for writes:** Acquire the mutex only around code that mutates shared collections/fields (e.g., `logs[]`, `updates[]`, `notifications[]`).","repository":"agent0ai/agent-zero","domain":"ai-agents","topic":"Concurrency","language":"Python","updated":"2026-01-10","comments":3,"stars":17612,"raw":"https://awesomereviewers.com/raw/agent-zero-lock-writes-snapshot-reads.md"},{"slug":"celery-maintain-api-backward-compatibility","title":"Maintain API Backward Compatibility","description":"When changing code that affects a public interface (method signatures, CLI command arguments, plugin discovery, type/subscriptable behavior), treat it as an API contract: keep existing call patterns working, and ensure runtime semantics match the intended contract.","repository":"celery/celery","domain":"orchestration","topic":"API","language":"Python","updated":"2026-01-09","comments":5,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-maintain-api-backward-compatibility.md"},{"slug":"mermaid-precise-scenario-based-testing","title":"Precise Scenario-Based Testing","description":"When writing tests, ensure they (1) match the scenario name and input data, (2) exercise behavior through the appropriate layer (prefer public/high-level APIs so defaults/precedence are covered), (3) use the project’s DOM test helpers/fixtures and avoid unnecessary mocks/polyfills, and (4) assert specific outcomes (including exact error messages) rather...","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Testing","language":"TypeScript","updated":"2026-01-08","comments":10,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-precise-scenario-based-testing.md"},{"slug":"mermaid-doc-examples-must-render","title":"Doc Examples Must Render","description":"All documentation examples/configs must be compatible with the docs build/render pipeline and current Mermaid configuration conventions. **Apply this checklist when touching documentation:**","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2026-01-08","comments":7,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-doc-examples-must-render.md"},{"slug":"mermaid-config-must-be-consistent","title":"Config must be consistent","description":"Ensure every rendering/utility path uses the correct configuration *namespace* and that config values are passed explicitly (not implicitly via global getters or captured/stale variables).","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Configurations","language":"TypeScript","updated":"2026-01-08","comments":5,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-config-must-be-consistent.md"},{"slug":"mermaid-explicit-null-handling","title":"Explicit Null Handling","description":"Null/undefined safety should prevent crashes *and* preserve correct semantics. Don’t hide missing required inputs with optional chaining or weak fallbacks.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Null Handling","language":"TypeScript","updated":"2026-01-08","comments":5,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-explicit-null-handling.md"},{"slug":"mermaid-null-safe-input-contracts","title":"Null-safe Input Contracts","description":"When handling possibly-null/undefined/empty inputs, be explicit about nullability and keep code aligned with the promised types/semantics. Practical rules:","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Null Handling","language":"JavaScript","updated":"2026-01-08","comments":5,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-null-safe-input-contracts.md"},{"slug":"mermaid-versioned-api-change-contracts","title":"Versioned API Change Contracts","description":"When changing a user-facing interface (API/config/grammar or externally consumed resources), treat it as a versioned contract: 1) Classify change severity and reflect it in release artifacts","repository":"mermaid-js/mermaid","domain":"devtools","topic":"API","language":"Markdown","updated":"2026-01-08","comments":3,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-versioned-api-change-contracts.md"},{"slug":"mermaid-prefer-fast-paths-and-caching","title":"Prefer fast-paths and caching","description":"When performance matters, structure code to avoid unnecessary work: (1) keep cheap fast-paths first for short-circuiting, (2) cache expensive global lookups (like config) instead of repeatedly calling them, (3) reuse costly parser/services/stateful objects, (4) lazy-load heavy dependencies only when required, and (5) remove redundant rendering/computation...","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Performance Optimization","language":"TypeScript","updated":"2026-01-07","comments":7,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-prefer-fast-paths-and-caching.md"},{"slug":"mermaid-short-circuit-and-cache","title":"Short-circuit and cache","description":"Optimize performance-sensitive code by eliminating unnecessary work: - **Short-circuit expensive calls:** order conditions so cheap checks run first and prevent calling costly functions.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Performance Optimization","language":"JavaScript","updated":"2026-01-07","comments":3,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-short-circuit-and-cache.md"},{"slug":"agentcore-samples-deterministic-dependency-sourcing","title":"Deterministic dependency sourcing","description":"All CI/CD build environments must be reproducible and based on reliable dependency sources. Standards: 1) Prefer official published packages/artifacts","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"CI/CD","language":"Other","updated":"2026-01-07","comments":2,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-deterministic-dependency-sourcing.md"},{"slug":"mermaid-consistent-style-and-diffs","title":"Consistent Style And Diffs","description":"Apply a consistent, tool-friendly coding style to reduce formatting churn and improve readability. **Rules** - **Keep diffs stable:** Don’t apply formatting-only changes to existing tests/cases unless the PR’s purpose is explicitly formatting coverage. Revert incidental alignment/whitespace changes; add new focused cases instead.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Code Style","language":"JavaScript","updated":"2026-01-05","comments":8,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-consistent-style-and-diffs.md"},{"slug":"waveterm-include-context-rich-logs","title":"Include context-rich logs","description":"Ensure logs are actionable: always include relevant context identifiers (e.g., full connection name, user or request id) and log any returned errors so failures are visible and debuggable. Mask or redact sensitive fields when necessary and choose an appropriate log level (info for status changes, warn/error for failures).","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Logging","language":"Go","updated":"2026-01-04","comments":2,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-include-context-rich-logs.md"},{"slug":"ncnn-capability-guarded-configuration","title":"Capability-Guarded Configuration","description":"When code depends on environment/build features (SIMD/FP16 availability, OpenCV versioned APIs, packing layout support, OS/ABI-specific macros), you must (1) gate the code at compile time with the correct macros and (2) reflect the real capability in the backend’s `support_*` flags so the framework won’t select an unsupported execution path.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Configurations","language":"C++","updated":"2026-01-03","comments":6,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-capability-guarded-configuration.md"},{"slug":"mermaid-avoid-duplication-magic","title":"Avoid Duplication Magic","description":"When updating code, prioritize maintainability and readability by removing duplicated blocks, eliminating magic numbers, and keeping formatting/imports tooling-friendly.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Code Style","language":"TypeScript","updated":"2026-01-02","comments":9,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-avoid-duplication-magic.md"},{"slug":"nanochat-justify-dependency-and-build-pins","title":"Justify dependency and build pins","description":"Any config change that affects build/runtime behavior (dependency version pins, feature flags, build backend settings, tool/target sources like GPU wheels) must include a concrete compatibility rationale and align with the build tooling or runtime environment.","repository":"karpathy/nanochat","domain":"ml-systems","topic":"Configurations","language":"Toml","updated":"2026-01-01","comments":4,"stars":53189,"raw":"https://awesomereviewers.com/raw/nanochat-justify-dependency-and-build-pins.md"},{"slug":"query-explicit-undefined-invariants","title":"Explicit undefined invariants","description":"When handling query/mutation results, treat `undefined` (and `null`) as semantically distinct and enforce that distinction in both runtime checks and TypeScript types.","repository":"tanstack/query","domain":"app-frameworks","topic":"Null Handling","language":"TypeScript","updated":"2025-12-30","comments":10,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-explicit-undefined-invariants.md"},{"slug":"pi-intentional-cache-design","title":"Intentional Cache Design","description":"Cache behavior should be justified by real reuse and measured impact. Apply this standard: 1) Scope the cache correctly: for per-process/per-session data, prefer in-memory caching and avoid disk persistence unless it measurably reduces recomputation time on restart/resume.","repository":"earendil-works/pi","domain":"ai-agents","topic":"Caching","language":"TypeScript","updated":"2025-12-30","comments":2,"stars":79783,"raw":"https://awesomereviewers.com/raw/pi-intentional-cache-design.md"},{"slug":"zod-hot-path-performance-rules","title":"Hot-Path Performance Rules","description":"Default to the cheapest behavior: gate expensive work behind explicit options or conditions, and keep the parsing “fast path” strictly minimal. Practical rules:","repository":"colinhacks/zod","domain":"app-frameworks","topic":"Performance Optimization","language":"TypeScript","updated":"2025-12-29","comments":8,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-hot-path-performance-rules.md"},{"slug":"agent-zero-ai-boundary-compatibility","title":"AI Boundary Compatibility","description":"When building AI/LLM-related tooling (tool-calls, background execution, inference/image generation), enforce compatibility at the boundaries: 1) Use team-standard LLM-friendly IDs","repository":"agent0ai/agent-zero","domain":"ai-agents","topic":"AI","language":"Python","updated":"2025-12-29","comments":2,"stars":17612,"raw":"https://awesomereviewers.com/raw/agent-zero-ai-boundary-compatibility.md"},{"slug":"query-centralize-stale-invalidation","title":"Centralize Stale Invalidation","description":"When implementing or modifying caching/fetch decisions, treat “fresh vs stale” as a single source of truth derived from the query’s invalidation + stale-time logic. Avoid adding ad-hoc fetch conditions at the observer/queryClient level that bypass (or redefine) TTL semantics.","repository":"tanstack/query","domain":"app-frameworks","topic":"Caching","language":"TypeScript","updated":"2025-12-28","comments":8,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-centralize-stale-invalidation.md"},{"slug":"query-deterministic-ci-practices","title":"Deterministic CI Practices","description":"When touching CI/CD workflows, keep execution deterministic and CI stable: - **Don’t duplicate steps**: if a publish script already runs tests, avoid running `test:ci` again in the workflow.","repository":"tanstack/query","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2025-12-28","comments":7,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-deterministic-ci-practices.md"},{"slug":"langchain-avoid-hidden-performance-traps","title":"Avoid Hidden Performance Traps","description":"Default rule: in performance-sensitive code, prevent hidden blowups and avoid expensive work being executed repeatedly in hot paths or on import. Apply this checklist:","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"Performance Optimization","language":"Python","updated":"2025-12-28","comments":5,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-avoid-hidden-performance-traps.md"},{"slug":"langchain-fail-fast-dependency-errors","title":"Fail Fast Dependency Errors","description":"When resolving dependencies or other derived configuration, never “log-and-continue” into an inconsistent internal state. Apply this standard: 1. **Validate at the source (fail fast):** validate `depends_on` (types/contents) in `AgentMiddleware.__init__()` so errors point to the middleware that provided bad input.","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2025-12-28","comments":3,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-fail-fast-dependency-errors.md"},{"slug":"query-type-safe-option-consistency","title":"Type-safe option consistency","description":"Typed “options” objects (e.g. `queryOptions`, `infiniteQueryOptions`, `mutationOptions`) should round-trip cleanly across *all* API entrypoints that accept them (hooks, suspense/non-suspense hooks, and `QueryClient` methods).","repository":"tanstack/query","domain":"app-frameworks","topic":"API","language":"TSX","updated":"2025-12-27","comments":4,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-type-safe-option-consistency.md"},{"slug":"query-persist-only-settled-queries","title":"Persist Only Settled Queries","description":"When using async/concurrent flows (streaming, dehydration/rehydration, optimistic updates), ensure you never persist “in-flight” async state and you always return promises from async callbacks.","repository":"tanstack/query","domain":"app-frameworks","topic":"Concurrency","language":"Markdown","updated":"2025-12-26","comments":4,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-persist-only-settled-queries.md"},{"slug":"langchain-maintainable-documentation-hygiene","title":"Maintainable documentation hygiene","description":"Documentation should be kept authoritative and maintainable: use stable links, avoid recommending deprecated APIs, and remove misleading/ineffective documentation details.","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"Documentation","language":"Other","updated":"2025-12-26","comments":3,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-maintainable-documentation-hygiene.md"},{"slug":"ragflow-maintain-dependency-lockfiles","title":"Maintain dependency lockfiles","description":"When changing dependency declarations in configuration files like `pyproject.toml`, treat group placement and lockfile updates as part of the change.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Configurations","language":"Toml","updated":"2025-12-19","comments":2,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-maintain-dependency-lockfiles.md"},{"slug":"db-gpt-stable-interface-contracts","title":"Stable Interface Contracts","description":"When designing or extending APIs, treat existing “core” interface contracts as stable and enforce exact compatibility (method signature + parameter semantics + return shapes) across base classes and all implementations. If you need different inputs/behavior for a subset of modules, add an adapter/compatibility layer in the business layer instead of changing...","repository":"eosphoros-ai/DB-GPT","domain":"ai-agents","topic":"API","language":"Python","updated":"2025-12-17","comments":6,"stars":18703,"raw":"https://awesomereviewers.com/raw/db-gpt-stable-interface-contracts.md"},{"slug":"mermaid-use-supported-documentation-formats","title":"Use supported documentation formats","description":"When updating documentation, examples, or config-related code: 1) Follow the source of truth for generated artifacts - **Do** change the upstream schema/config file.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Documentation","language":"TypeScript","updated":"2025-12-17","comments":6,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-use-supported-documentation-formats.md"},{"slug":"heretic-preserve-dtype-and-shapes","title":"preserve dtype and shapes","description":"When writing PyTorch code, preserve tensor dtypes and devices and be explicit about vector/matrix shapes to avoid precision loss, incorrect broadcasting, and unnecessary CPU allocations.","repository":"p-e-w/heretic","domain":"ml-systems","topic":"Pytorch","language":"Python","updated":"2025-12-14","comments":6,"stars":5002,"raw":"https://awesomereviewers.com/raw/heretic-preserve-dtype-and-shapes.md"},{"slug":"agent-zero-config-source-precedence","title":"Config source precedence","description":"When configuration is moved/renamed or when settings are derived from environment variables, ensure (1) the dotenv loader points to the correct file path/name and (2) there is an explicit precedence order for derived settings (env-provided values override generated/default values).","repository":"agent0ai/agent-zero","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2025-12-11","comments":2,"stars":17612,"raw":"https://awesomereviewers.com/raw/agent-zero-config-source-precedence.md"},{"slug":"azure-sentinel-triage-ready-telemetry","title":"Triage-Ready Telemetry","description":"When implementing observability detections/parsers, ensure alerts/fields are (1) schema-correct and vendor-correct, and (2) triage-ready with the exact raw context that triggered the signal.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Observability","language":"Yaml","updated":"2025-12-11","comments":2,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-triage-ready-telemetry.md"},{"slug":"ragflow-semantic-identifier-naming","title":"Semantic identifier naming","description":"Use semantic, unambiguous names for every externally visible identifier (API parameters/endpoints, config/env vars, and build/version tags). Names must reflect meaning and supported behavior; if an operation is not supported, document that constraint next to the relevant field/behavior.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Naming Conventions","language":"Markdown","updated":"2025-12-09","comments":2,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-semantic-identifier-naming.md"},{"slug":"likec4-explicit-api-contracts","title":"Explicit API contracts","description":"Require API types and public interfaces to express clear, enforceable contracts: guarantee invariants, normalize variant shapes, and make compatibility choices explicit.","repository":"likec4/likec4","domain":"devtools","topic":"API","language":"TypeScript","updated":"2025-12-06","comments":5,"stars":2582,"raw":"https://awesomereviewers.com/raw/likec4-explicit-api-contracts.md"},{"slug":"likec4-prefer-utility-reuse","title":"Prefer utility reuse","description":"When changing or adding code prefer existing helpers, language-idiomatic constructs, and small well-maintained libraries to keep code DRY, readable, and consistent.","repository":"likec4/likec4","domain":"devtools","topic":"Code Style","language":"TypeScript","updated":"2025-12-06","comments":4,"stars":2582,"raw":"https://awesomereviewers.com/raw/likec4-prefer-utility-reuse.md"},{"slug":"likec4-type-safe-focused-tests","title":"Type-safe focused tests","description":"Write tests that are both type-safe and narrowly focused on supported behavior. Use small, typed test helpers or fixtures to eliminate repeated casts and noisy \"as any\"/\"as T\" in tests, and ensure test cases reflect the product's validation rules (don’t test unsupported scenarios).","repository":"likec4/likec4","domain":"devtools","topic":"Testing","language":"TypeScript","updated":"2025-12-06","comments":2,"stars":2582,"raw":"https://awesomereviewers.com/raw/likec4-type-safe-focused-tests.md"},{"slug":"ragflow-documentation-precision","title":"Documentation Precision","description":"All documentation must accurately reflect product/API behavior, use exact feature names, and be unambiguous about constraints, defaults, and unsupported scenarios. Also ensure Markdown renders cleanly.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Documentation","language":"Markdown","updated":"2025-12-03","comments":8,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-documentation-precision.md"},{"slug":"mermaid-define-error-recovery-policy","title":"Define Error Recovery Policy","description":"When handling failures, classify them as **recoverable** vs **unrecoverable**, then apply a consistent rule: log with enough context, **continue only for recoverable side-effects**, and **fail fast with explicit (prefer custom) errors** for invalid/unknown inputs or internal invariants.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Error Handling","language":"TypeScript","updated":"2025-12-03","comments":5,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-define-error-recovery-policy.md"},{"slug":"ragflow-documentation-wiring-accuracy","title":"Documentation Wiring Accuracy","description":"Ensure technical documentation is both semantically correct and operationally precise: (1) use the exact product terms for what a setting applies to (scope/terminology), and (2) when describing component internals/graphs, specify the exact wiring rule for references (use the internal managing node, not an external component), aligned with the documented...","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Documentation","language":"Other","updated":"2025-12-03","comments":2,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-documentation-wiring-accuracy.md"},{"slug":"heretic-limit-ci-tokens","title":"limit CI tokens","description":"Always prefer the built-in GITHUB_TOKEN, explicitly document why it’s needed, and grant it only the minimum permissions required. For third‑party actions that call the GitHub API, pin them and justify token usage in the workflow so reviewers can verify scope and intent.","repository":"p-e-w/heretic","domain":"ml-systems","topic":"Security","language":"Yaml","updated":"2025-12-03","comments":1,"stars":5002,"raw":"https://awesomereviewers.com/raw/heretic-limit-ci-tokens.md"},{"slug":"query-test-error-propagation","title":"Test error propagation","description":"When changing error handling, add/maintain tests that: - Cover all supported configuration shapes (e.g., `useErrorBoundary: true` and `useErrorBoundary: (err) => boolean`).","repository":"tanstack/query","domain":"app-frameworks","topic":"Error Handling","language":"TSX","updated":"2025-11-30","comments":5,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-test-error-propagation.md"},{"slug":"ragflow-use-enum-constants","title":"Use enum constants","description":"When a value represents a named domain concept (e.g., Theme), use the corresponding enum type/constant (e.g., `ThemeEnum`) instead of duplicating raw string literals (`'light'`, `'dark'`). This keeps identifier naming consistent across schema definitions and UI/component logic.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Naming Conventions","language":"TSX","updated":"2025-11-28","comments":2,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-use-enum-constants.md"},{"slug":"query-vue-example-correctness","title":"Vue example correctness","description":"When writing Vue (including Nuxt) code snippets or API docs, ensure the example is correct for the shapes the API truly supports and for the Nuxt/Vue environment.","repository":"tanstack/query","domain":"app-frameworks","topic":"Vue","language":"Markdown","updated":"2025-11-26","comments":2,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-vue-example-correctness.md"},{"slug":"query-prefer-inferred-clear-async","title":"Prefer inferred, clear async","description":"When writing code and tests, optimize for clarity and idiomatic TypeScript: 1) Prefer `async/await` when the async function includes a side effect. ```ts","repository":"tanstack/query","domain":"app-frameworks","topic":"Code Style","language":"TSX","updated":"2025-11-23","comments":4,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-prefer-inferred-clear-async.md"},{"slug":"nx-clean-ci-configurations","title":"Clean CI configurations","description":"Maintain clean and well-documented CI configurations by removing dead code and properly documenting temporary changes. Avoid leaving commented-out code in CI files - either remove unused configurations entirely or add proper TODO comments with context when temporarily disabling features.","repository":"nrwl/nx","domain":"devtools","topic":"CI/CD","language":"Yaml","updated":"2025-11-19","comments":2,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-clean-ci-configurations.md"},{"slug":"ragflow-use-exec-form-commands","title":"Use exec-form commands","description":"When configuring container commands (e.g., Docker Compose), pass commands in exec/array form for any arguments that include secrets or externally provided values. This prevents shell parsing/whitespace issues and reduces the risk of injection via malformed values (including empty credentials).","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Security","language":"Yaml","updated":"2025-11-19","comments":1,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-use-exec-form-commands.md"},{"slug":"tradingagents-use-authenticated-env-tokens","title":"Use authenticated env tokens","description":"Any service exposed to the network (e.g., via Docker `ports`) must be protected with authentication, and any secret used for that auth (e.g., Jupyter token/password) must come from environment variables (e.g., `.env`) rather than being hardcoded in versioned files. If a compose file uses placeholder defaults, treat them as non-production scaffolding and...","repository":"TauricResearch/TradingAgents","domain":"ai-agents","topic":"Security","language":"Yaml","updated":"2025-11-19","comments":1,"stars":71953,"raw":"https://awesomereviewers.com/raw/tradingagents-use-authenticated-env-tokens.md"},{"slug":"iptv-m3u-metadata-and-links","title":"M3U metadata and links","description":"When editing M3U playlist configuration, treat each `#EXTINF` block as configuration data that must be (1) internally consistent, (2) externally valid, and (3) quality/behavior-preserving.","repository":"iptv-org/iptv","domain":"cloud-infra","topic":"Configurations","language":"Other","updated":"2025-11-18","comments":4,"stars":135586,"raw":"https://awesomereviewers.com/raw/iptv-m3u-metadata-and-links.md"},{"slug":"sdk-python-explicit-null-checks","title":"explicit null checks","description":"Use explicit existence checks rather than value-based null checks, and be intentional about failing fast versus providing defaults for missing data. When checking for optional data, prefer checking for key/attribute existence rather than checking if values are truthy or greater than zero. This prevents subtle bugs where legitimate zero values or empty...","repository":"strands-agents/sdk-python","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2025-11-17","comments":5,"stars":4044,"raw":"https://awesomereviewers.com/raw/sdk-python-explicit-null-checks.md"},{"slug":"nx-avoid-runtime-api-calls","title":"Avoid runtime API calls","description":"Components should not make external API calls for data that can be pre-generated at build time. Instead of fetching dynamic data during component rendering, inject pre-computed values as props to improve performance and reduce external dependencies.","repository":"nrwl/nx","domain":"devtools","topic":"API","language":"TSX","updated":"2025-11-17","comments":2,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-avoid-runtime-api-calls.md"},{"slug":"sdk-python-use-descriptive-names","title":"Use descriptive names","description":"Choose names that clearly convey purpose and intent rather than generic or ambiguous terms. Names should be specific enough to understand functionality without requiring additional context.","repository":"strands-agents/sdk-python","domain":"ai-agents","topic":"Naming Conventions","language":"Python","updated":"2025-11-14","comments":19,"stars":4044,"raw":"https://awesomereviewers.com/raw/sdk-python-use-descriptive-names.md"},{"slug":"nx-validate-configuration-values","title":"validate configuration values","description":"Always validate configuration values at runtime and provide clear, actionable error messages when invalid combinations are detected. This prevents runtime failures and guides users toward correct configuration.","repository":"nrwl/nx","domain":"devtools","topic":"Configurations","language":"TypeScript","updated":"2025-11-14","comments":6,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-validate-configuration-values.md"},{"slug":"ragflow-portable-config-management","title":"Portable Config Management","description":"When changing configuration, treat runtime configuration as the source of truth and avoid embedding/duplicating settings. Apply these rules: 1) Prefer `.env` + `env_file: .env` and avoid duplicating the same variables in multiple places.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Configurations","language":"Yaml","updated":"2025-11-13","comments":5,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-portable-config-management.md"},{"slug":"sdk-python-complete-docstring-documentation","title":"Complete docstring documentation","description":"Ensure all classes, methods, and properties have comprehensive docstrings that clearly explain their purpose, behavior, and usage. Docstrings should be preferred over inline comments for method descriptions and should include:","repository":"strands-agents/sdk-python","domain":"ai-agents","topic":"Documentation","language":"Python","updated":"2025-11-12","comments":5,"stars":4044,"raw":"https://awesomereviewers.com/raw/sdk-python-complete-docstring-documentation.md"},{"slug":"celery-protocol-safe-encoding","title":"Protocol-Safe Encoding","description":"Any data placed into connection URIs or transmitted over the network (e.g., JSON payloads/headers) must be encoded/serialized according to the protocol’s rules.","repository":"celery/celery","domain":"orchestration","topic":"Networking","language":"Other","updated":"2025-11-12","comments":2,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-protocol-safe-encoding.md"},{"slug":"ragflow-config-documentation-constraints","title":"Config Documentation Constraints","description":"When adding or updating configuration-related docs (env vars, config files, feature/transport flags, and deployment commands), ensure the guidance is (1) context-correct, (2) compatibility-checked, and (3) explicit about defaults/overrides.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Configurations","language":"Markdown","updated":"2025-11-11","comments":10,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-config-documentation-constraints.md"},{"slug":"mermaid-deterministic-grammar-changes","title":"Deterministic Grammar Changes","description":"When updating diagram parsers (Jison/Langium/Chevrotain), treat lexer/tokenization precedence as a compatibility contract: ensure changes don’t break existing inputs and that intended tokens are unambiguously chosen.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Algorithms","language":"Other","updated":"2025-11-10","comments":5,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-deterministic-grammar-changes.md"},{"slug":"sdk-python-ensure-deterministic-resume-behavior","title":"Ensure deterministic resume behavior","description":"When implementing persistence and resume functionality in durable execution systems, ensure that state is persisted at consistent event boundaries and that resume logic handles all execution states explicitly to maintain deterministic behavior.","repository":"strands-agents/sdk-python","domain":"ai-agents","topic":"Temporal","language":"Python","updated":"2025-11-10","comments":4,"stars":4044,"raw":"https://awesomereviewers.com/raw/sdk-python-ensure-deterministic-resume-behavior.md"},{"slug":"agentcore-samples-explicit-memory-disabling","title":"Explicit memory disabling","description":"When building LLM agents for AgentCore/runtime environments, don’t rely on framework defaults for memory. If your agent does not use conversational/session memory, explicitly disable it (e.g., set `memory_mode='NO_MEMORY'`) to prevent the runtime/framework from automatically creating/using STM.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"AI","language":"Other","updated":"2025-11-10","comments":2,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-explicit-memory-disabling.md"},{"slug":"agentcore-samples-use-otel-env-overrides","title":"Use OTEL Env Overrides","description":"When configuring OTLP tracing exporters in observability code, rely on the runtime-provided `OTEL_EXPORTER_OTLP_ENDPOINT` and `OTEL_EXPORTER_OTLP_HEADERS` environment variables, rather than hardcoding or redundantly passing `endpoint=` and `headers=` into `OTLPSpanExporter`. This prevents configuration drift and duplicated settings.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Observability","language":"Other","updated":"2025-11-10","comments":2,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-use-otel-env-overrides.md"},{"slug":"free-programming-books-lint-compliant-markdown-links","title":"Lint-Compliant Markdown Links","description":"When adding/updating entries in markdown lists, follow the repository’s lint-safe formatting and platform/link conventions. Checklist: - Escape special markdown characters in titles/labels: use `\\|` instead of `|`.","repository":"EbookFoundation/free-programming-books","domain":"docs","topic":"Code Style","language":"Markdown","updated":"2025-11-07","comments":12,"stars":388003,"raw":"https://awesomereviewers.com/raw/free-programming-books-lint-compliant-markdown-links.md"},{"slug":"sdk-python-choose-appropriate-synchronization","title":"Choose appropriate synchronization","description":"Select the correct synchronization mechanism based on your execution context and avoid unnecessary synchronization overhead. In async contexts with coroutines, locks are often unnecessary since coroutines run cooperatively in a single thread. Use `asyncio.Lock()` for async contexts and `threading.Lock()` for multi-threaded scenarios. When bridging sync and...","repository":"strands-agents/sdk-python","domain":"ai-agents","topic":"Concurrency","language":"Python","updated":"2025-11-07","comments":7,"stars":4044,"raw":"https://awesomereviewers.com/raw/sdk-python-choose-appropriate-synchronization.md"},{"slug":"nx-user-centric-documentation-practices","title":"User-centric documentation practices","description":"Documentation should prioritize user needs and experience over technical convenience. This means using appropriate link types (guides over API docs for user-facing content), organizing content to avoid overwhelming newcomers, providing necessary context, and ensuring links work correctly with tooling.","repository":"nrwl/nx","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2025-11-06","comments":7,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-user-centric-documentation-practices.md"},{"slug":"likec4-normalize-config-sources","title":"normalize config sources","description":"Ensure all runtime and project configuration is explicit, type-safe, and machine-independent. Motivation - Implicit or ad-hoc config (raw process.env usage, feature flags only in local env, or file:///absolute asset paths) causes type errors, unresolved imports, and “works on my machine” failures in CI and collaborators’ environments.","repository":"likec4/likec4","domain":"devtools","topic":"Configurations","language":"TypeScript","updated":"2025-11-06","comments":3,"stars":2582,"raw":"https://awesomereviewers.com/raw/likec4-normalize-config-sources.md"},{"slug":"openai-python-config-accurate-dependency-management","title":"Config-Accurate Dependency Management","description":"When updating project configuration (e.g., `pyproject.toml`), ensure dependency declarations match how packages are actually used: align `requires-python` with dependency-supported Python versions, keep dev-only tooling in `dev-dependencies`, and use `extras` for optional features instead of adding new required runtime deps. Also, set minimum versions based...","repository":"openai/openai-python","domain":"ai-agents","topic":"Configurations","language":"Toml","updated":"2025-11-05","comments":4,"stars":30731,"raw":"https://awesomereviewers.com/raw/openai-python-config-accurate-dependency-management.md"},{"slug":"container-ci-workflow-safety-check","title":"CI Workflow Safety Check","description":"When reviewing GitHub Actions used for CI/CD automation, verify three things: 1) Repo context is available - If the workflow reads files from the repository (e.g., `.github/labeler.yml`), ensure `actions/checkout` is present.","repository":"apple/container","domain":"orchestration","topic":"CI/CD","language":"Yaml","updated":"2025-11-05","comments":2,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-ci-workflow-safety-check.md"},{"slug":"sdk-python-configuration-default-handling","title":"Configuration default handling","description":"Use clean, simple patterns when accessing configuration values with defaults. Avoid redundant fallback operations and overly complex boolean conversions that reduce code readability.","repository":"strands-agents/sdk-python","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2025-11-04","comments":3,"stars":4044,"raw":"https://awesomereviewers.com/raw/sdk-python-configuration-default-handling.md"},{"slug":"zod-assert-meaningful-outcomes","title":"Assert meaningful outcomes","description":"When writing tests, validate the *actual user-visible behavior and structured error data*, not just a substring or a indirectly implied result. Make failures unambiguous (no swallow-pass patterns) and keep tests easy to debug.","repository":"colinhacks/zod","domain":"app-frameworks","topic":"Testing","language":"TypeScript","updated":"2025-11-03","comments":8,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-assert-meaningful-outcomes.md"},{"slug":"sdk-python-comprehensive-test-assertions","title":"comprehensive test assertions","description":"Write robust test assertions that verify complete objects and behaviors rather than individual properties. Use pytest's built-in features for exception testing and mock verification to make tests more reliable and maintainable.","repository":"strands-agents/sdk-python","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2025-11-03","comments":5,"stars":4044,"raw":"https://awesomereviewers.com/raw/sdk-python-comprehensive-test-assertions.md"},{"slug":"sdk-python-maintain-backwards-compatibility","title":"maintain backwards compatibility","description":"When modifying public APIs, always preserve backwards compatibility to avoid breaking existing consumers. Public methods, even if rarely used directly, must maintain their existing signatures and behavior.","repository":"strands-agents/sdk-python","domain":"ai-agents","topic":"API","language":"Python","updated":"2025-11-01","comments":8,"stars":4044,"raw":"https://awesomereviewers.com/raw/sdk-python-maintain-backwards-compatibility.md"},{"slug":"waveterm-platform-specific-config","title":"platform-specific config","description":"Centralize OS-specific configuration and modifier mappings in a dedicated config/adapter module and document global declaration files. Motivation: key modifiers (Cmd/Meta/Alt/Option), global shortcuts, and shared types behave differently across platforms; putting the logic in one place avoids inconsistent handling, duplicate OS checks, and brittle startup...","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Configurations","language":"TypeScript","updated":"2025-11-01","comments":4,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-platform-specific-config.md"},{"slug":"nx-synchronize-declared-versions","title":"synchronize declared versions","description":"Ensure that version declarations in configuration files accurately reflect the versions actually being used in runtime environments. Configuration drift occurs when declared versions diverge from deployed versions, leading to inconsistent environments and potential deployment issues.","repository":"nrwl/nx","domain":"devtools","topic":"Configurations","language":"Toml","updated":"2025-11-01","comments":2,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-synchronize-declared-versions.md"},{"slug":"db-gpt-centralized-config-standards","title":"Centralized Config Standards","description":"When implementing new behavior behind feature flags or configuration (paths, env vars, index dimensions, toggles like text2gql), use centralized, documented config instead of hardcoded values or scattered env access.","repository":"eosphoros-ai/DB-GPT","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2025-10-30","comments":13,"stars":18703,"raw":"https://awesomereviewers.com/raw/db-gpt-centralized-config-standards.md"},{"slug":"nanochat-cache-keys-drive-rebuilds","title":"Cache keys drive rebuilds","description":"When using uv to build Python extensions via PEP 517 (e.g., maturin), ensure cache invalidation is keyed to the actual build inputs. Configure `tool.uv.cache-keys` so builds rerun only when the underlying sources for the compiled artifact change—especially Rust sources and Cargo manifests—rather than rebuilding whatever project owns the root...","repository":"karpathy/nanochat","domain":"ml-systems","topic":"Caching","language":"Toml","updated":"2025-10-30","comments":2,"stars":53189,"raw":"https://awesomereviewers.com/raw/nanochat-cache-keys-drive-rebuilds.md"},{"slug":"sdk-python-configurable-security-controls","title":"configurable security controls","description":"Design security mechanisms with configurable behavior to handle different threat scenarios and use cases. Avoid rigid, one-size-fits-all security implementations that may not suit all deployment contexts.","repository":"strands-agents/sdk-python","domain":"ai-agents","topic":"Security","language":"Python","updated":"2025-10-30","comments":1,"stars":4044,"raw":"https://awesomereviewers.com/raw/sdk-python-configurable-security-controls.md"},{"slug":"supermemory-prefer-typed-themed-styles","title":"Prefer typed themed styles","description":"Adopt maintainable UI code style rules: 1) Avoid explicit `any` / lint ignores—use real types - Don’t rely on `any` and don’t silence type linting unless you provide a typed alternative.","repository":"supermemoryai/supermemory","domain":"app-frameworks","topic":"Code Style","language":"TSX","updated":"2025-10-28","comments":3,"stars":28844,"raw":"https://awesomereviewers.com/raw/supermemory-prefer-typed-themed-styles.md"},{"slug":"nx-thread-ownership-clarity","title":"Thread ownership clarity","description":"When designing concurrent systems, ensure data ownership is explicit and clear at thread boundaries. Avoid passing references across threads or using indirect access patterns that obscure ownership responsibilities.","repository":"nrwl/nx","domain":"devtools","topic":"Concurrency","language":"Rust","updated":"2025-10-24","comments":2,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-thread-ownership-clarity.md"},{"slug":"sdk-python-ci-blocking-with-overrides","title":"CI blocking with overrides","description":"When implementing CI checks that can block pull request merges, always provide clear override mechanisms for exceptional cases. Hard-failing CI checks should be strong signals to developers, but teams need escape hatches when legitimate exceptions arise.","repository":"strands-agents/sdk-python","domain":"ai-agents","topic":"CI/CD","language":"Yaml","updated":"2025-10-24","comments":2,"stars":4044,"raw":"https://awesomereviewers.com/raw/sdk-python-ci-blocking-with-overrides.md"},{"slug":"servo-use-semantically-accurate-names","title":"Use semantically accurate names","description":"Variable, method, and type names should accurately reflect their actual purpose, content, and behavior. Avoid generic or misleading names that don't match the underlying functionality.","repository":"servo/servo","domain":"runtimes","topic":"Naming Conventions","language":"Rust","updated":"2025-10-23","comments":13,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-use-semantically-accurate-names.md"},{"slug":"servo-avoid-unnecessary-work","title":"avoid unnecessary work","description":"Identify and eliminate computational work that serves no purpose, particularly for inactive, hidden, or irrelevant elements. This includes early returns for non-visible components, lazy initialization of expensive resources, and preventing work during inappropriate timing.","repository":"servo/servo","domain":"runtimes","topic":"Performance Optimization","language":"Rust","updated":"2025-10-23","comments":8,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-avoid-unnecessary-work.md"},{"slug":"servo-avoid-unsafe-unwrapping","title":"avoid unsafe unwrapping","description":"Replace `.unwrap()` calls and sentinel values with safe null handling patterns to prevent runtime panics and improve code robustness. **Key Issues:**","repository":"servo/servo","domain":"runtimes","topic":"Null Handling","language":"Rust","updated":"2025-10-23","comments":8,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-avoid-unsafe-unwrapping.md"},{"slug":"nx-configuration-documentation-clarity","title":"Configuration documentation clarity","description":"Configuration changes and examples should be documented with clear formatting, proper context, and helpful references to aid developer understanding.","repository":"nrwl/nx","domain":"devtools","topic":"Configurations","language":"Other","updated":"2025-10-23","comments":4,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-configuration-documentation-clarity.md"},{"slug":"nx-documentation-metadata-consistency","title":"Documentation metadata consistency","description":"Ensure documentation uses consistent structural elements and proper metadata to optimize user experience and content discoverability. Use platform-native components (like `aside` instead of `callout` for Astro docs), include appropriate sidebar labels, and leverage weight/filter properties to control search result prominence.","repository":"nrwl/nx","domain":"devtools","topic":"Documentation","language":"Other","updated":"2025-10-23","comments":4,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-documentation-metadata-consistency.md"},{"slug":"servo-optimize-algorithmic-complexity","title":"optimize algorithmic complexity","description":"Prioritize algorithmic efficiency by choosing operations and data structures that minimize computational complexity. Look for opportunities to replace O(n) operations with O(1) alternatives, select appropriate data structures for the use case, and avoid unnecessary algorithmic overhead.","repository":"servo/servo","domain":"runtimes","topic":"Algorithms","language":"Rust","updated":"2025-10-22","comments":11,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-optimize-algorithmic-complexity.md"},{"slug":"servo-avoid-unwrap-and-panic","title":"avoid unwrap and panic","description":"Replace `.unwrap()` and `panic!()` calls with proper error handling to prevent crashes and improve robustness. When encountering potential failures, choose one of three approaches:","repository":"servo/servo","domain":"runtimes","topic":"Error Handling","language":"Rust","updated":"2025-10-22","comments":9,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-avoid-unwrap-and-panic.md"},{"slug":"nx-avoid-code-duplication","title":"Avoid code duplication","description":"Before implementing new functionality, check if similar utilities or patterns already exist in the codebase. Reuse existing code rather than duplicating logic, and organize shared types and constants in centralized locations to prevent circular dependencies and maintain consistency.","repository":"nrwl/nx","domain":"devtools","topic":"Code Style","language":"TypeScript","updated":"2025-10-22","comments":7,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-avoid-code-duplication.md"},{"slug":"nx-use-explicit-consistent-names","title":"Use explicit, consistent names","description":"Variable and parameter names should be explicit about their purpose and consistent with established naming patterns in the codebase. Avoid ambiguous or generic names that could be confusing in context.","repository":"nrwl/nx","domain":"devtools","topic":"Naming Conventions","language":"TypeScript","updated":"2025-10-22","comments":6,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-use-explicit-consistent-names.md"},{"slug":"nx-use-nullish-coalescing-operators","title":"Use nullish coalescing operators","description":"Prefer modern JavaScript nullish coalescing (`??`) and optional chaining (`?.`) operators over verbose conditional logic for handling null and undefined values. These operators provide cleaner, more readable code while maintaining null safety.","repository":"nrwl/nx","domain":"devtools","topic":"Null Handling","language":"TypeScript","updated":"2025-10-22","comments":5,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-use-nullish-coalescing-operators.md"},{"slug":"servo-reduce-complexity-for-readability","title":"reduce complexity for readability","description":"Prioritize code readability by reducing complexity through better organization and clearer patterns. Use early returns to avoid deep nesting, extract methods to break down large functions, and choose appropriate data structures over generic ones.","repository":"servo/servo","domain":"runtimes","topic":"Code Style","language":"Rust","updated":"2025-10-21","comments":20,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-reduce-complexity-for-readability.md"},{"slug":"waveterm-manage-bindings-and-state","title":"Manage bindings and state","description":"Ensure components explicitly initialize reactive state, manage input/keybinding lifecycle, and decide whether children should subscribe to live atoms or use a stable snapshot.","repository":"wavetermdev/waveterm","domain":"devtools","topic":"React","language":"TSX","updated":"2025-10-21","comments":9,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-manage-bindings-and-state.md"},{"slug":"container-workflow-least-privilege","title":"Workflow least-privilege","description":"When writing GitHub Actions workflows, apply security best practices for (1) permissions scope and (2) trust boundaries around PR data. **1) Use least-permissive permissions**","repository":"apple/container","domain":"orchestration","topic":"Security","language":"Yaml","updated":"2025-10-21","comments":2,"stars":48787,"raw":"https://awesomereviewers.com/raw/container-workflow-least-privilege.md"},{"slug":"nx-api-documentation-accuracy","title":"API documentation accuracy","description":"Ensure API documentation examples use types, interfaces, and imports that actually exist in the documented versions. Verify that code examples can be successfully imported and executed before publishing documentation.","repository":"nrwl/nx","domain":"devtools","topic":"API","language":"Other","updated":"2025-10-21","comments":2,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-api-documentation-accuracy.md"},{"slug":"servo-algorithm-edge-case-validation","title":"Algorithm edge case validation","description":"Ensure algorithmic implementations properly handle edge cases and boundary conditions before considering them complete. Many algorithm failures stem from insufficient consideration of special inputs, parameter combinations, or state transitions that occur at the boundaries of normal operation.","repository":"servo/servo","domain":"runtimes","topic":"Algorithms","language":"Other","updated":"2025-10-21","comments":2,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-algorithm-edge-case-validation.md"},{"slug":"servo-comprehensive-api-documentation","title":"comprehensive API documentation","description":"All public items, struct fields, and methods must have comprehensive documentation. When implementing web specifications, include the actual specification text in comments rather than just links, as specifications can change over time.","repository":"servo/servo","domain":"runtimes","topic":"Documentation","language":"Rust","updated":"2025-10-20","comments":11,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-comprehensive-api-documentation.md"},{"slug":"sdk-python-eliminate-code-duplication","title":"eliminate code duplication","description":"Identify and consolidate duplicate code patterns by extracting common logic into reusable functions and unifying similar code blocks. This improves maintainability, reduces bugs, and enhances readability.","repository":"strands-agents/sdk-python","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2025-10-20","comments":7,"stars":4044,"raw":"https://awesomereviewers.com/raw/sdk-python-eliminate-code-duplication.md"},{"slug":"sdk-python-fail-fast-explicitly","title":"Fail fast explicitly","description":"Always throw exceptions for error conditions rather than silently failing, logging warnings, or attempting fallback behavior that masks underlying problems. When encountering unexpected states, missing required data, or configuration errors, raise descriptive exceptions immediately rather than continuing execution with degraded functionality.","repository":"strands-agents/sdk-python","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2025-10-20","comments":5,"stars":4044,"raw":"https://awesomereviewers.com/raw/sdk-python-fail-fast-explicitly.md"},{"slug":"servo-conditional-ci-execution","title":"conditional CI execution","description":"Use appropriate conditional statements in CI workflows to ensure steps execute under the right circumstances and handle different environments gracefully.","repository":"servo/servo","domain":"runtimes","topic":"CI/CD","language":"Yaml","updated":"2025-10-20","comments":5,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-conditional-ci-execution.md"},{"slug":"agentcore-samples-parameterized-runtime-configuration","title":"Parameterized Runtime Configuration","description":"Ensure configuration is explicit, supported, and environment-specific values are parameterized. Apply these rules: - Use non-deprecated minimum runtime versions in setup docs (e.g., prefer Python 3.10+ over 3.8/3.9).","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2025-10-20","comments":3,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-parameterized-runtime-configuration.md"},{"slug":"dyad-simplify-and-organize-code","title":"Simplify and organize code","description":"Keep code simple, direct, and well-organized by avoiding unnecessary complexity and properly structuring components. Remove redundant implementations when existing mechanisms already handle the functionality. Avoid indirect approaches when more straightforward solutions exist. Extract large components into separate files when they become unwieldy.","repository":"dyad-sh/dyad","domain":"ai-agents","topic":"Code Style","language":"TSX","updated":"2025-10-20","comments":3,"stars":16903,"raw":"https://awesomereviewers.com/raw/dyad-simplify-and-organize-code.md"},{"slug":"servo-configuration-parameter-handling","title":"configuration parameter handling","description":"When working with configuration parameters and values, follow these best practices to ensure maintainable and correct configuration handling: 1. **Use collections for multiple related values**: When checking against multiple related configuration values, use the `in` operator with a list or set rather than chaining multiple OR conditions. This makes the...","repository":"servo/servo","domain":"runtimes","topic":"Configurations","language":"Python","updated":"2025-10-20","comments":2,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-configuration-parameter-handling.md"},{"slug":"developer-roadmap-never-edit-generated-json","title":"Never edit generated JSON","description":"Treat any build/CI-generated JSON (and files under similar “public/…-content” paths) as read-only. Don’t patch them directly in PRs—changes will be overwritten or won’t propagate.","repository":"kamranahmedse/developer-roadmap","domain":"docs","topic":"CI/CD","language":"Json","updated":"2025-10-19","comments":3,"stars":354523,"raw":"https://awesomereviewers.com/raw/developer-roadmap-never-edit-generated-json.md"},{"slug":"free-programming-books-stateful-parsing-correctness","title":"Stateful Parsing Correctness","description":"When implementing stateful parsing (e.g., direction/context tracking with stacks), treat correctness as a property of the whole scan loop—not just the “main” match.","repository":"EbookFoundation/free-programming-books","domain":"docs","topic":"Algorithms","language":"Python","updated":"2025-10-19","comments":2,"stars":388003,"raw":"https://awesomereviewers.com/raw/free-programming-books-stateful-parsing-correctness.md"},{"slug":"servo-implement-security-validation","title":"implement security validation","description":"Ensure all security-related functionality includes complete validation checks and proper testing. This applies to both cryptographic operations and security policy configurations.","repository":"servo/servo","domain":"runtimes","topic":"Security","language":"Other","updated":"2025-10-19","comments":2,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-implement-security-validation.md"},{"slug":"jj-use-type-specific-variable-names","title":"Use type-specific variable names","description":"Use distinct variable names that reflect their types to avoid confusion and make code intent clearer. Avoid reusing the same variable name for different types within the same scope or related functions.","repository":"jj-vcs/jj","domain":"devtools","topic":"Naming Conventions","language":"Rust","updated":"2025-10-18","comments":5,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-use-type-specific-variable-names.md"},{"slug":"serena-use-proper-logging-practices","title":"Use proper logging practices","description":"Always use logging instead of print statements, and choose appropriate log levels to avoid log spam. Print statements can contaminate the stdio buffer and break system functionality, especially in server environments.","repository":"oraios/serena","domain":"ai-agents","topic":"Logging","language":"Python","updated":"2025-10-17","comments":4,"stars":14465,"raw":"https://awesomereviewers.com/raw/serena-use-proper-logging-practices.md"},{"slug":"serena-use-semantically-meaningful-names","title":"Use semantically meaningful names","description":"Choose names that clearly convey purpose and intent rather than generic or ambiguous terms. Prefer specific, descriptive terminology that makes code self-documenting and reduces cognitive load for readers.","repository":"oraios/serena","domain":"ai-agents","topic":"Naming Conventions","language":"Python","updated":"2025-10-17","comments":4,"stars":14465,"raw":"https://awesomereviewers.com/raw/serena-use-semantically-meaningful-names.md"},{"slug":"jj-use-safe-optional-defaults","title":"Use safe optional defaults","description":"When working with optional values, prefer safe extraction methods that provide defaults rather than methods that can panic. Use `unwrap_or()`, `unwrap_or_default()`, or `unwrap_or_else()` instead of `unwrap()` to handle `None` cases gracefully.","repository":"jj-vcs/jj","domain":"devtools","topic":"Null Handling","language":"Rust","updated":"2025-10-17","comments":3,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-use-safe-optional-defaults.md"},{"slug":"opencode-validate-ai-model-configurations","title":"validate AI model configurations","description":"When adding or modifying AI model configurations, ensure proper validation through both pattern-based matching and functional testing. Avoid hardcoding specific model IDs when existing patterns can handle multiple models generically. Always test model functionality before adding to production configurations.","repository":"sst/opencode","domain":"ai-agents","topic":"AI","language":"TypeScript","updated":"2025-10-17","comments":2,"stars":28213,"raw":"https://awesomereviewers.com/raw/opencode-validate-ai-model-configurations.md"},{"slug":"servo-network-request-configuration","title":"Network request configuration","description":"When creating network requests, ensure all security-sensitive parameters are properly configured including origin, referrer, CORS mode, and destination. Incomplete request configuration can lead to test failures, security vulnerabilities, and incorrect cross-origin behavior.","repository":"servo/servo","domain":"runtimes","topic":"Networking","language":"Rust","updated":"2025-10-17","comments":2,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-network-request-configuration.md"},{"slug":"waveterm-defensive-null-handling","title":"defensive null handling","description":"Always handle nullable values explicitly and defensively to prevent runtime null/undefined errors and to make intent clear. Why: Nulls and undefined values cause intermittent runtime exceptions and unclear state transitions. Being explicit—both when clearing values and when checking inputs—reduces bugs and documents intent.","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Null Handling","language":"TypeScript","updated":"2025-10-17","comments":2,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-defensive-null-handling.md"},{"slug":"mermaid-use-contextual-sanitization","title":"Use Contextual Sanitization","description":"Any diagram text/config that can originate from users (node labels, tooltips, markdown, theme/style tokens, and link targets) must be treated as untrusted. Apply **context-appropriate** escaping/sanitization and avoid security-by-regex.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Security","language":"TypeScript","updated":"2025-10-16","comments":7,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-use-contextual-sanitization.md"},{"slug":"nx-ensure-configuration-consistency","title":"Ensure configuration consistency","description":"Configuration files should maintain consistency in patterns, use correct paths and values, and follow established conventions across the codebase. This includes proper output paths, consistent dependency versioning patterns, and appropriate dependency categorization.","repository":"nrwl/nx","domain":"devtools","topic":"Configurations","language":"Json","updated":"2025-10-16","comments":4,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-ensure-configuration-consistency.md"},{"slug":"anthropic-sdk-python-manage-network-resources","title":"Manage network resources","description":"When working with streaming or TCP options, be explicit and defensive: 1) Closing streams: If you terminate a stream early (e.g., you don’t fully consume an HTTP/SSE iterator), ensure you close the underlying network resource—not just a wrapper/decoder that may not implement `close()`.","repository":"anthropics/anthropic-sdk-python","domain":"ai-agents","topic":"Networking","language":"Python","updated":"2025-10-16","comments":2,"stars":3392,"raw":"https://awesomereviewers.com/raw/anthropic-sdk-python-manage-network-resources.md"},{"slug":"opencode-maintain-json-response-consistency","title":"maintain JSON response consistency","description":"When designing API responses that need to handle different data types or display states, maintain consistent JSON structure and use established encoding standards to preserve backward compatibility. Avoid changing response schemas that would break existing client integrations.","repository":"sst/opencode","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2025-10-16","comments":2,"stars":28213,"raw":"https://awesomereviewers.com/raw/opencode-maintain-json-response-consistency.md"},{"slug":"servo-validate-external-system-inputs","title":"validate external system inputs","description":"When integrating with external systems that receive repository or organizational information, always implement server-side validation to ensure the provided data belongs to authorized organizations or repositories. This prevents potential abuse where attackers could exploit organizational resources by spoofing repository information.","repository":"servo/servo","domain":"runtimes","topic":"Security","language":"Yaml","updated":"2025-10-16","comments":1,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-validate-external-system-inputs.md"},{"slug":"jj-consistent-command-flag-design","title":"consistent command flag design","description":"Design command-line interfaces with consistent flag semantics and leverage framework features for validation. Avoid ambiguous syntax that can be interpreted multiple ways, use explicit conflict declarations instead of manual validation, and ensure flag combinations have clear, predictable behavior.","repository":"jj-vcs/jj","domain":"devtools","topic":"API","language":"Rust","updated":"2025-10-15","comments":11,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-consistent-command-flag-design.md"},{"slug":"jj-choose-efficient-data-structures","title":"Choose efficient data structures","description":"Select data structures and algorithms based on their performance characteristics and expected usage patterns. Consider the size of collections, access patterns, and computational complexity when making implementation choices.","repository":"jj-vcs/jj","domain":"devtools","topic":"Algorithms","language":"Rust","updated":"2025-10-15","comments":6,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-choose-efficient-data-structures.md"},{"slug":"serena-simple-explicit-interfaces","title":"Simple explicit interfaces","description":"Design API interfaces to be simple and explicit rather than hiding complexity behind elaborate fallbacks or conditional logic. When core functionality is unavailable, fail explicitly with clear error messages instead of implementing complex workarounds. Push complexity and decision-making to the caller rather than embedding it within the API implementation.","repository":"oraios/serena","domain":"ai-agents","topic":"API","language":"Python","updated":"2025-10-15","comments":3,"stars":14465,"raw":"https://awesomereviewers.com/raw/serena-simple-explicit-interfaces.md"},{"slug":"opencode-contextualize-documentation-decisions","title":"Contextualize documentation decisions","description":"Documentation should provide contextual guidance about when and why to use features, not just how to configure them. Additionally, strategically link to external documentation rather than duplicating content to reduce maintenance overhead.","repository":"sst/opencode","domain":"ai-agents","topic":"Documentation","language":"Other","updated":"2025-10-15","comments":2,"stars":28213,"raw":"https://awesomereviewers.com/raw/opencode-contextualize-documentation-decisions.md"},{"slug":"query-dependency-aware-changesets","title":"Dependency-Aware Changesets","description":"When using CI/CD release automation based on Changesets, declare only the minimal packages that drive the release (so CI/CD doesn’t process redundant package updates), and ensure the release workflow is documented in an operationally explicit way.","repository":"tanstack/query","domain":"app-frameworks","topic":"CI/CD","language":"Markdown","updated":"2025-10-15","comments":2,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-dependency-aware-changesets.md"},{"slug":"servo-enhance-testing-interfaces","title":"enhance testing interfaces","description":"Design testing tool interfaces to be both flexible and discoverable. Support multiple keyword variations for test-related functionality and provide pass-through parameter options to enable advanced debugging scenarios.","repository":"servo/servo","domain":"runtimes","topic":"Testing","language":"Python","updated":"2025-10-15","comments":2,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-enhance-testing-interfaces.md"},{"slug":"jj-prioritize-documentation-clarity","title":"prioritize documentation clarity","description":"Write documentation that prioritizes user understanding over technical precision. Avoid unclear phrases, overly technical explanations, and unhelpful references. When in doubt, choose clarity over brevity, especially for user-facing documentation that may be someone's first encounter with a feature.","repository":"jj-vcs/jj","domain":"devtools","topic":"Documentation","language":"Rust","updated":"2025-10-14","comments":7,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-prioritize-documentation-clarity.md"},{"slug":"query-stable-react-rendering","title":"Stable React Rendering","description":"Write React components and tests so they don’t depend on React’s internal render/callback sequencing, and so Suspense boundaries capture the work that actually suspends.","repository":"tanstack/query","domain":"app-frameworks","topic":"React","language":"TSX","updated":"2025-10-14","comments":7,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-stable-react-rendering.md"},{"slug":"sdk-python-ai-provider-normalization","title":"AI provider normalization","description":"When integrating multiple AI model providers, implement proper abstraction layers to normalize differences in APIs, data formats, and behaviors. Different providers often have inconsistent interfaces that require careful handling to maintain application consistency.","repository":"strands-agents/sdk-python","domain":"ai-agents","topic":"AI","language":"Python","updated":"2025-10-14","comments":5,"stars":4044,"raw":"https://awesomereviewers.com/raw/sdk-python-ai-provider-normalization.md"},{"slug":"servo-avoid-borrow-hazards","title":"avoid borrow hazards","description":"Prevent borrow conflicts by collecting or cloning data before operations that may trigger garbage collection, call into JavaScript, or create additional borrows. This is especially critical when holding mutable borrows (`borrow_mut()`) that could conflict with operations that need to access the same data.","repository":"servo/servo","domain":"runtimes","topic":"Concurrency","language":"Rust","updated":"2025-10-14","comments":3,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-avoid-borrow-hazards.md"},{"slug":"nx-context-aware-configuration-logic","title":"Context-aware configuration logic","description":"Configuration logic should adapt based on environmental context rather than using static values. Examine the current environment state (file system, process hierarchy, feature flags) and adjust configuration accordingly to ensure optimal behavior in different scenarios.","repository":"nrwl/nx","domain":"devtools","topic":"Configurations","language":"Rust","updated":"2025-10-14","comments":2,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-context-aware-configuration-logic.md"},{"slug":"nx-scope-ci-access-tokens","title":"scope CI access tokens","description":"Configure CI pipelines to use appropriately scoped access tokens based on branch protection status. Use read-write tokens only for protected branches (branches that don't allow direct push) and read-only tokens for all other branches and environments.","repository":"nrwl/nx","domain":"devtools","topic":"CI/CD","language":"Markdown","updated":"2025-10-13","comments":6,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-scope-ci-access-tokens.md"},{"slug":"dyad-maintain-naming-consistency","title":"Maintain naming consistency","description":"Ensure naming follows consistent patterns within the codebase and adheres to official framework conventions. When creating related types or functions, use matching naming schemes to maintain clarity and prevent synchronization issues. Prefer established conventions over custom variations unless there's a compelling reason to deviate.","repository":"dyad-sh/dyad","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2025-10-13","comments":2,"stars":16903,"raw":"https://awesomereviewers.com/raw/dyad-maintain-naming-consistency.md"},{"slug":"jj-consistent-naming-conventions","title":"Consistent naming conventions","description":"Maintain consistent naming and terminology throughout code and documentation. This includes proper capitalization of product names, technical terms, and consistent use of domain-specific vocabulary.","repository":"jj-vcs/jj","domain":"devtools","topic":"Naming Conventions","language":"Markdown","updated":"2025-10-12","comments":5,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-consistent-naming-conventions.md"},{"slug":"serena-exact-assertion-testing","title":"exact assertion testing","description":"Tests should verify exact expected results rather than generic existence checks. Avoid assertions like `isinstance()`, `len() > 0`, `is not None`, or `any()` that only confirm something exists without validating correctness. Instead, assert for specific expected values, names, and properties.","repository":"oraios/serena","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2025-10-12","comments":5,"stars":14465,"raw":"https://awesomereviewers.com/raw/serena-exact-assertion-testing.md"},{"slug":"serena-ensure-complete-documentation-quality","title":"Ensure complete documentation quality","description":"Documentation should be comprehensive, clear, and provide all necessary context for understanding and using the code effectively. This includes several key aspects:","repository":"oraios/serena","domain":"ai-agents","topic":"Documentation","language":"Python","updated":"2025-10-12","comments":4,"stars":14465,"raw":"https://awesomereviewers.com/raw/serena-ensure-complete-documentation-quality.md"},{"slug":"serena-exception-chaining-practices","title":"Exception chaining practices","description":"Always use exception chaining with `raise ... from e` when re-raising or wrapping exceptions to preserve the original error context and stack trace. This maintains debugging information and follows Python best practices for error propagation.","repository":"oraios/serena","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2025-10-12","comments":4,"stars":14465,"raw":"https://awesomereviewers.com/raw/serena-exception-chaining-practices.md"},{"slug":"serena-prefer-marketplace-actions","title":"prefer marketplace actions","description":"Before implementing custom tool installation steps in GitHub Actions workflows, check if there's an existing setup action available on the GitHub Actions marketplace. Marketplace actions are typically more reliable, better maintained, and reduce workflow complexity compared to custom installation scripts.","repository":"oraios/serena","domain":"ai-agents","topic":"CI/CD","language":"Yaml","updated":"2025-10-12","comments":2,"stars":14465,"raw":"https://awesomereviewers.com/raw/serena-prefer-marketplace-actions.md"},{"slug":"jj-define-technical-terms-clearly","title":"Define technical terms clearly","description":"Always define technical terms and concepts explicitly in documentation rather than assuming reader knowledge. Avoid ambiguous phrasing that could be interpreted multiple ways.","repository":"jj-vcs/jj","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2025-10-11","comments":10,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-define-technical-terms-clearly.md"},{"slug":"jj-optimize-remote-fetch-operations","title":"optimize remote fetch operations","description":"When implementing network operations that fetch data from remote sources, configure specific refspecs or patterns to fetch only the required data rather than everything available. This reduces network bandwidth usage, improves performance, and ensures future operations remain efficient.","repository":"jj-vcs/jj","domain":"devtools","topic":"Networking","language":"Rust","updated":"2025-10-11","comments":2,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-optimize-remote-fetch-operations.md"},{"slug":"jj-eliminate-redundant-code","title":"eliminate redundant code","description":"Remove unnecessary code, operations, and annotations that don't add value. This includes redundant type annotations when types are already constrained, unnecessary conditional checks, redundant operations like path normalization in multiple places, and overly complex patterns that can be simplified.","repository":"jj-vcs/jj","domain":"devtools","topic":"Code Style","language":"Rust","updated":"2025-10-10","comments":9,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-eliminate-redundant-code.md"},{"slug":"jj-config-file-naming-clarity","title":"Config file naming clarity","description":"Use descriptive, unambiguous names for configuration files to clearly indicate their scope and prevent user confusion about configuration hierarchy. When introducing new configuration files, especially in systems with multiple configuration layers (user, repo, workspace), choose names that explicitly indicate the scope rather than generic names that could...","repository":"jj-vcs/jj","domain":"devtools","topic":"Configurations","language":"Rust","updated":"2025-10-10","comments":3,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-config-file-naming-clarity.md"},{"slug":"servo-api-design-patterns","title":"API design patterns","description":"Design APIs with appropriate parameter types, place conversion functions as trait implementations in the correct modules, and reuse existing patterns instead of creating new abstractions.","repository":"servo/servo","domain":"runtimes","topic":"API","language":"Rust","updated":"2025-10-09","comments":9,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-api-design-patterns.md"},{"slug":"free-programming-books-canonical-ids-and-titles","title":"Canonical IDs and Titles","description":"Adopt canonical naming rules for both **identifiers (anchors/ids)** and **display names (titles)** to prevent broken links and inconsistent labeling.","repository":"EbookFoundation/free-programming-books","domain":"docs","topic":"Naming Conventions","language":"Markdown","updated":"2025-10-09","comments":5,"stars":388003,"raw":"https://awesomereviewers.com/raw/free-programming-books-canonical-ids-and-titles.md"},{"slug":"supermemory-scope-401-logout","title":"Scope 401 Logout","description":"Avoid triggering sensitive auth actions (like logout) based solely on a generic HTTP status (e.g., “any 401”). Instead, logout only when the 401 is clearly an authentication/session failure for known auth endpoints.","repository":"supermemoryai/supermemory","domain":"security","topic":"Security","language":"TSX","updated":"2025-10-09","comments":1,"stars":28844,"raw":"https://awesomereviewers.com/raw/supermemory-scope-401-logout.md"},{"slug":"nx-robust-algorithm-implementation","title":"robust algorithm implementation","description":"Implement algorithms that handle edge cases and avoid brittle assumptions about input data or structure formats. Instead of relying on simple string manipulation or assuming data structure behavior, use comprehensive approaches that account for various scenarios.","repository":"nrwl/nx","domain":"devtools","topic":"Algorithms","language":"TypeScript","updated":"2025-10-08","comments":4,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-robust-algorithm-implementation.md"},{"slug":"query-keep-api-types-synced","title":"Keep API Types Synced","description":"Any runtime API you expect developers to use must be discoverable and accurate in the public contract: update README/API docs and ensure the method is declared in the shipped `.d.ts`. Avoid “hiding” APIs behind missing typings or relying on long-lived `@ts-expect-error` type suppressions; fix the types/integration so the typed contract matches runtime...","repository":"tanstack/query","domain":"app-frameworks","topic":"API","language":"JavaScript","updated":"2025-10-08","comments":2,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-keep-api-types-synced.md"},{"slug":"nx-externalize-configuration-values","title":"externalize configuration values","description":"Configuration values should be externalized from code and read from standard locations like package.json or environment variables. Implement environment-aware validation that fails fast in production when required configuration is missing, while providing sensible defaults for development environments.","repository":"nrwl/nx","domain":"devtools","topic":"Configurations","language":"JavaScript","updated":"2025-10-07","comments":2,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-externalize-configuration-values.md"},{"slug":"shaders-modern-react-mounting","title":"Modern React Mounting","description":"When building React components that wrap external resources (e.g., WebGL/canvas), follow these rules: - Forward refs for React 18+ compatibility: use `forwardRef` rather than custom ref plumbing.","repository":"paper-design/shaders","domain":"app-frameworks","topic":"React","language":"TSX","updated":"2025-10-06","comments":4,"stars":3286,"raw":"https://awesomereviewers.com/raw/shaders-modern-react-mounting.md"},{"slug":"shaders-avoid-redundant-expensive-work","title":"Avoid redundant expensive work","description":"For performance-sensitive React code, prevent unnecessary recomputation and avoid “clever” micro-optimizations that add complexity without measurable benefit.","repository":"paper-design/shaders","domain":"app-frameworks","topic":"Performance Optimization","language":"TSX","updated":"2025-10-06","comments":3,"stars":3286,"raw":"https://awesomereviewers.com/raw/shaders-avoid-redundant-expensive-work.md"},{"slug":"nx-organize-testing-documentation-clearly","title":"organize testing documentation clearly","description":"Ensure testing documentation is properly categorized and uses precise terminology to maintain clarity and accessibility. Testing concepts should be organized into appropriate sections (e.g., \"Testing Tools\" rather than generic categories) and described with accurate language that clearly conveys the intended meaning.","repository":"nrwl/nx","domain":"devtools","topic":"Testing","language":"Other","updated":"2025-10-06","comments":2,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-organize-testing-documentation-clearly.md"},{"slug":"free-programming-books-encode-international-urls","title":"Encode International URLs","description":"When adding or modifying external URLs, ensure international/non-ASCII URLs are **percent-encoded** (UTF-8 → percent-encoding). Do not treat “escape” as a vague idea—use proper URL encoding so links render correctly across clients and avoid malformed/ambiguous URL behavior.","repository":"EbookFoundation/free-programming-books","domain":"docs","topic":"Security","language":"Markdown","updated":"2025-10-04","comments":1,"stars":388003,"raw":"https://awesomereviewers.com/raw/free-programming-books-encode-international-urls.md"},{"slug":"jj-verify-test-assertions","title":"Verify test assertions","description":"Always use appropriate assertion methods in tests to ensure proper verification of command behavior. When you don't need to examine command output, use `.success()` to verify the command completed without errors. When the output content is meaningful for testing the functionality, capture and snapshot it for verification.","repository":"jj-vcs/jj","domain":"devtools","topic":"Testing","language":"Rust","updated":"2025-10-03","comments":2,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-verify-test-assertions.md"},{"slug":"nx-document-ci-configuration-clearly","title":"Document CI configuration clearly","description":"Always include file path comments in CI configuration code blocks and use officially recommended setup actions for CI tools. This improves documentation clarity and ensures reliable CI pipeline configuration.","repository":"nrwl/nx","domain":"devtools","topic":"CI/CD","language":"Other","updated":"2025-10-02","comments":6,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-document-ci-configuration-clearly.md"},{"slug":"jj-precise-algorithmic-terminology","title":"precise algorithmic terminology","description":"When documenting or describing algorithmic operations, use precise, unambiguous terminology that clearly distinguishes between different types of operations. Avoid reusing terms that already have specific meanings in the domain, as this can lead to confusion about the actual algorithmic behavior.","repository":"jj-vcs/jj","domain":"devtools","topic":"Algorithms","language":"Markdown","updated":"2025-10-01","comments":2,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-precise-algorithmic-terminology.md"},{"slug":"servo-handle-unsafe-code-properly","title":"Handle unsafe code properly","description":"Methods that access raw memory buffers, perform pointer operations, or interact with foreign function interfaces must be explicitly marked as `unsafe` to prevent memory safety vulnerabilities. Conversely, remove unnecessary `unsafe` blocks when calling safe functions to maintain code clarity and prevent masking actual unsafe operations.","repository":"servo/servo","domain":"runtimes","topic":"Security","language":"Rust","updated":"2025-09-29","comments":3,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-handle-unsafe-code-properly.md"},{"slug":"query-configuration-version-isolation","title":"Configuration Version Isolation","description":"When changing package/tooling configuration (peer deps, TS/ESLint parser versions, tsup/esbuild settings, or feature/behavior flags), make version and behavior control explicit and isolated so CI/build/tests don’t break unexpectedly.","repository":"tanstack/query","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2025-09-28","comments":5,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-configuration-version-isolation.md"},{"slug":"router-validate-before-accessing","title":"validate before accessing","description":"Always validate that values exist and have expected properties before accessing them, especially when removing non-null assertions or performing type casting. Avoid making assumptions about value presence or type safety without explicit checks.","repository":"TanStack/router","domain":"app-frameworks","topic":"Null Handling","language":"TypeScript","updated":"2025-09-26","comments":5,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-validate-before-accessing.md"},{"slug":"sdk-python-balance-configuration-practicality","title":"Balance configuration practicality","description":"When making configuration changes, balance technical best practices with developer workflow requirements and real-world usage scenarios. Configuration decisions should not only be technically sound but also support practical development needs.","repository":"strands-agents/sdk-python","domain":"ai-agents","topic":"Configurations","language":"Toml","updated":"2025-09-26","comments":2,"stars":4044,"raw":"https://awesomereviewers.com/raw/sdk-python-balance-configuration-practicality.md"},{"slug":"ncnn-spec-aligned-algorithm-correctness","title":"Spec-aligned Algorithm Correctness","description":"All algorithm implementations must be spec-aligned for the exact operator variant, tensor shapes/axes, and boundary conditions. Before merging, developers should explicitly verify that special cases and out-of-bound behavior follow the framework/ONNX semantics; avoid “one-size-fits-all” code paths that silently produce wrong results.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Algorithms","language":"C++","updated":"2025-09-24","comments":8,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-spec-aligned-algorithm-correctness.md"},{"slug":"jj-document-test-configurations","title":"document test configurations","description":"When modifying test configurations or tooling settings, provide clear explanations of what the changes actually do and why specific options were chosen. Test configuration changes can be confusing without proper context.","repository":"jj-vcs/jj","domain":"devtools","topic":"Testing","language":"Toml","updated":"2025-09-24","comments":2,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-document-test-configurations.md"},{"slug":"jj-use-intuitive-descriptive-names","title":"Use intuitive descriptive names","description":"Choose names that clearly communicate purpose and intent without requiring additional documentation or context. Names should be self-explanatory to users who encounter them for the first time.","repository":"jj-vcs/jj","domain":"devtools","topic":"Naming Conventions","language":"Other","updated":"2025-09-23","comments":3,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-use-intuitive-descriptive-names.md"},{"slug":"nx-follow-established-naming-patterns","title":"Follow established naming patterns","description":"Ensure all identifiers, file references, and generated names follow established conventions and patterns rather than using arbitrary or hardcoded values. This includes using correct file extensions in imports, following consistent naming patterns for generated targets, and using template variables instead of hardcoded names in templates.","repository":"nrwl/nx","domain":"devtools","topic":"Naming Conventions","language":"Other","updated":"2025-09-23","comments":3,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-follow-established-naming-patterns.md"},{"slug":"query-test-tanstack-query-properly","title":"Test TanStack Query Properly","description":"When writing Angular unit/SSR tests for TanStack Query, align with Angular’s task tracking and keep caches isolated: - Prefer Angular injection helpers: test components/services should call `injectQuery`/`injectMutation` (not ad-hoc query execution) so Angular can track in-progress work via `PendingTasks` (Angular 19+).","repository":"tanstack/query","domain":"app-frameworks","topic":"Angular","language":"Markdown","updated":"2025-09-21","comments":2,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-test-tanstack-query-properly.md"},{"slug":"agentcore-samples-dependency-version-policy","title":"Dependency Version Policy","description":"In configuration files like `requirements.txt`, define a consistent versioning policy: - Prefer **minimum version constraints** (`>=`) for most libraries to guarantee required behavior without freezing to a single patch/release.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Configurations","language":"Txt","updated":"2025-09-19","comments":4,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-dependency-version-policy.md"},{"slug":"opencode-coordinate-concurrent-initialization","title":"coordinate concurrent initialization","description":"When implementing expensive initialization operations that may be triggered concurrently, use a shared promise to coordinate multiple requests and prevent duplicate initialization. This pattern is especially important for operations like downloading dependencies, starting external processes, or establishing connections that take significant time to complete.","repository":"sst/opencode","domain":"ai-agents","topic":"Concurrency","language":"TypeScript","updated":"2025-09-19","comments":2,"stars":28213,"raw":"https://awesomereviewers.com/raw/opencode-coordinate-concurrent-initialization.md"},{"slug":"opencode-ensure-proper-error-signaling","title":"Ensure proper error signaling","description":"Errors must be communicated through appropriate mechanisms for their execution context. In CLI applications, use proper exit codes to indicate error states (non-zero for failures). For shell command execution, implement proper error handling to prevent unexpected crashes and provide graceful failure modes.","repository":"sst/opencode","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2025-09-19","comments":2,"stars":28213,"raw":"https://awesomereviewers.com/raw/opencode-ensure-proper-error-signaling.md"},{"slug":"hyperswitch-use-meaningful-names","title":"Use meaningful names","description":"Use descriptive, self-explanatory names for variables, methods, fields, and types. Avoid single-letter variables, abbreviations, and generic naming that obscures intent.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"Naming Conventions","language":"Rust","updated":"2025-09-17","comments":17,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-use-meaningful-names.md"},{"slug":"hyperswitch-organize-code-structure","title":"Organize code structure","description":"Maintain clean and well-organized code structure by following consistent organizational patterns. This improves readability, maintainability, and reduces cognitive load for developers.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"Code Style","language":"Rust","updated":"2025-09-17","comments":15,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-organize-code-structure.md"},{"slug":"twenty-simplify-control-flow-patterns","title":"simplify control flow patterns","description":"Improve code readability by simplifying control flow structures and avoiding unnecessary complexity. This involves three key practices: **1. Use early returns instead of nested if/else blocks:**","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2025-09-17","comments":12,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-simplify-control-flow-patterns.md"},{"slug":"twenty-simplify-code-structure","title":"simplify code structure","description":"Write code that is easy to read and understand by avoiding unnecessary complexity in structure and logic. This includes several key practices: **Avoid complex nesting and nested ternaries:**","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Code Style","language":"TSX","updated":"2025-09-17","comments":8,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-simplify-code-structure.md"},{"slug":"hyperswitch-api-type-consistency","title":"API type consistency","description":"Use structured types instead of generic strings in API definitions to improve type safety and clarity. Prefer enums over string literals, specific ID types over generic strings, and maintain consistent data type usage across request/response models.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"API","language":"Rust","updated":"2025-09-17","comments":7,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-api-type-consistency.md"},{"slug":"hyperswitch-avoid-hardcoded-configuration-values","title":"Avoid hardcoded configuration values","description":"Configuration values should not be hardcoded in the source code. Instead, they should be externalized to configuration files, environment variables, or made configurable through application settings. This improves maintainability, allows for environment-specific customization, and prevents deployment issues.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"Configurations","language":"Rust","updated":"2025-09-17","comments":6,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-avoid-hardcoded-configuration-values.md"},{"slug":"twenty-use-semantically-accurate-names","title":"Use semantically accurate names","description":"Names should clearly and accurately reflect their actual purpose, functionality, and scope. Avoid misleading terminology that doesn't match the component's or variable's true behavior.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Naming Conventions","language":"TSX","updated":"2025-09-17","comments":6,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-use-semantically-accurate-names.md"},{"slug":"twenty-avoid-expensive-repeated-operations","title":"Avoid expensive repeated operations","description":"Identify and eliminate expensive operations that are performed repeatedly, such as object creation in loops, redundant computations, or duplicate filtering operations. Cache expensive objects like RegExp instances, i18n instances, or computed results to improve performance and prevent memory leaks.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Performance Optimization","language":"TypeScript","updated":"2025-09-17","comments":4,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-avoid-expensive-repeated-operations.md"},{"slug":"markitdown-meaningful-exception-handling","title":"meaningful exception handling","description":"Exception handling should provide meaningful feedback and use appropriate exception types rather than failing silently or relying on fragile string-based checks. Avoid catching exceptions without proper logging, user feedback, or recovery mechanisms. Use built-in Python exceptions when available instead of creating custom ones unnecessarily.","repository":"microsoft/markitdown","domain":"llm-infra","topic":"Error Handling","language":"Python","updated":"2025-09-17","comments":3,"stars":76602,"raw":"https://awesomereviewers.com/raw/markitdown-meaningful-exception-handling.md"},{"slug":"twenty-use-proper-null-utilities","title":"Use proper null utilities","description":"Use dedicated null checking utilities like `isDefined` or `isUndefinedOrNull` instead of generic type coercion functions like `Boolean()`. Prefer `undefined` over empty strings or `null` as default values to maintain type safety and prevent runtime errors.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Null Handling","language":"TSX","updated":"2025-09-17","comments":3,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-use-proper-null-utilities.md"},{"slug":"twenty-use-proper-postgresql-types","title":"Use proper PostgreSQL types","description":"Leverage PostgreSQL's native data types and features instead of generic alternatives to improve performance, type safety, and query capabilities. Use JSONB for structured data instead of storing raw text, implement PostgreSQL enums for constrained values rather than varchar columns, and establish proper foreign key relationships with meaningful column names.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Database","language":"TypeScript","updated":"2025-09-17","comments":3,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-use-proper-postgresql-types.md"},{"slug":"union-prioritize-code-clarity","title":"prioritize code clarity","description":"Write code that prioritizes readability and explicitness over brevity. This includes using explicit type conversions instead of implicit ones, extracting magic values to named constants, creating helper functions for repetitive operations, and organizing code logic clearly.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Code Style","language":"Rust","updated":"2025-09-16","comments":10,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-prioritize-code-clarity.md"},{"slug":"twenty-use-descriptive-specific-names","title":"Use descriptive specific names","description":"Names should be descriptive and specific enough to clearly communicate their purpose and avoid confusion. This includes using full words instead of abbreviations, being domain-specific when necessary, and ensuring names accurately reflect the function's behavior or data's purpose.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2025-09-16","comments":9,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-use-descriptive-specific-names.md"},{"slug":"hyperswitch-api-identifier-consistency","title":"API identifier consistency","description":"Maintain consistent naming conventions for API identifiers, configuration keys, and payment method types. Use snake_case for all API identifiers to ensure uniformity across the system. This includes payment method types, configuration field names, and connector specifications.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"API","language":"Toml","updated":"2025-09-16","comments":3,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-api-identifier-consistency.md"},{"slug":"twenty-enforce-restrictive-security-defaults","title":"Enforce restrictive security defaults","description":"Always start with the most restrictive security settings and only grant additional permissions when absolutely necessary. This principle applies to user authorization, iframe sandboxing, API access, and any security-sensitive features.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Security","language":"TSX","updated":"2025-09-16","comments":2,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-enforce-restrictive-security-defaults.md"},{"slug":"twenty-single-source-of-truth","title":"Single source of truth","description":"Establish a single authoritative source for each piece of data in your API interfaces rather than maintaining duplicate or parallel state. Derive computed values from the authoritative source instead of storing them separately.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"API","language":"TSX","updated":"2025-09-16","comments":2,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-single-source-of-truth.md"},{"slug":"query-semantic-naming-consistency","title":"Semantic naming consistency","description":"Use names that match the value’s real meaning and align with established/public API conventions. Practical rules: - **Name by semantics, not by adjacent intuition**: if “context” is being reinterpreted, rename (and deprecate old names with clear JSDoc) rather than silently changing what the term means.","repository":"tanstack/query","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2025-09-15","comments":9,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-semantic-naming-consistency.md"},{"slug":"twenty-security-critical-code-review","title":"Security-critical code review","description":"Changes to security-sensitive areas like authentication, input validation, and business logic require extra scrutiny and thorough review. These modifications can introduce vulnerabilities if not properly validated.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Security","language":"TypeScript","updated":"2025-09-15","comments":3,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-security-critical-code-review.md"},{"slug":"twenty-optimize-data-structure-lookups","title":"optimize data structure lookups","description":"Choose data structures that provide optimal time complexity for your access patterns. When you need frequent lookups by key, use Map instead of Record with Array.find() operations to achieve O(1) instead of O(n) complexity.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Algorithms","language":"TypeScript","updated":"2025-09-15","comments":2,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-optimize-data-structure-lookups.md"},{"slug":"parlant-api-consistency-standards","title":"API consistency standards","description":"Maintain consistent patterns across all API endpoints, including naming conventions, response structures, HTTP status codes, and interface design. This ensures a predictable and professional API surface that follows established conventions.","repository":"emcie-co/parlant","domain":"ai-agents","topic":"API","language":"Python","updated":"2025-09-14","comments":8,"stars":12205,"raw":"https://awesomereviewers.com/raw/parlant-api-consistency-standards.md"},{"slug":"jj-ensure-cross-platform-compatibility","title":"ensure cross-platform compatibility","description":"When creating configuration files and build tasks, prioritize cross-platform compatibility by avoiding shell-specific syntax and considering how tools discover their configuration files across different environments.","repository":"jj-vcs/jj","domain":"devtools","topic":"Configurations","language":"Toml","updated":"2025-09-14","comments":2,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-ensure-cross-platform-compatibility.md"},{"slug":"ncnn-graceful-error-propagation","title":"Graceful Error Propagation","description":"When writing library code, never hard-terminate or silently ignore failures. Always (1) validate inputs/shape compatibility correctly (including pack/elempack and dynamic dims), (2) signal errors with consistent return codes, and (3) propagate error statuses from lower-level operations to the caller.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Error Handling","language":"C++","updated":"2025-09-13","comments":6,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-graceful-error-propagation.md"},{"slug":"dify-optimize-data-structures","title":"Optimize data structures","description":"Choose appropriate built-in data structures and collection types to improve code efficiency and readability. Python's collections module and built-in data structures often provide more elegant and performant solutions than manual implementations.","repository":"langgenius/dify","domain":"llm-infra","topic":"Algorithms","language":"Python","updated":"2025-09-13","comments":3,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-optimize-data-structures.md"},{"slug":"twenty-choose-appropriate-concurrency-patterns","title":"Choose appropriate concurrency patterns","description":"Select concurrency mechanisms that align with your system architecture and established codebase patterns. Avoid using database transactions and pessimistic locking when working with connection pooling, as they can cause unintended side effects where one connection commits on behalf of another. Instead, follow existing patterns in the codebase for handling...","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Concurrency","language":"TypeScript","updated":"2025-09-13","comments":3,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-choose-appropriate-concurrency-patterns.md"},{"slug":"twenty-simplify-api-interfaces","title":"simplify API interfaces","description":"Keep API interfaces simple and focused by avoiding unnecessary input wrapping, extracting context parameters appropriately, and limiting exposure of internal implementation details.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2025-09-12","comments":6,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-simplify-api-interfaces.md"},{"slug":"sdk-python-ai-dependency-management","title":"AI dependency management","description":"When integrating AI libraries and SDKs, carefully manage dependencies by pinning versions with upper bounds to prevent breaking changes and minimize scope by implementing simple types locally when possible.","repository":"strands-agents/sdk-python","domain":"ai-agents","topic":"AI","language":"Toml","updated":"2025-09-12","comments":2,"stars":4044,"raw":"https://awesomereviewers.com/raw/sdk-python-ai-dependency-management.md"},{"slug":"dify-use-descriptive-names","title":"Use descriptive names","description":"Choose names that clearly describe the purpose, behavior, or content of variables, methods, and classes. Avoid ambiguous or generic names that require additional context to understand.","repository":"langgenius/dify","domain":"llm-infra","topic":"Naming Conventions","language":"Python","updated":"2025-09-11","comments":10,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-use-descriptive-names.md"},{"slug":"hyperswitch-protect-sensitive-data","title":"Protect sensitive data","description":"Wrap all sensitive data fields in Secret<> types to prevent accidental exposure through logs, debug output, serialization, or error messages. This includes authentication tokens, API keys, PII data, payment information, and any credentials.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"Security","language":"Rust","updated":"2025-09-11","comments":8,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-protect-sensitive-data.md"},{"slug":"union-use-descriptive-semantic-names","title":"Use descriptive semantic names","description":"Choose names that clearly communicate purpose, intent, and functionality rather than generic or abbreviated alternatives. Names should follow Rust conventions (snake_case for variables, functions, modules) and accurately describe what they represent or do.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Naming Conventions","language":"Rust","updated":"2025-09-11","comments":8,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-use-descriptive-semantic-names.md"},{"slug":"hyperswitch-use-option-combinators","title":"use Option combinators","description":"Leverage Rust's Option API methods like `map`, `and_then`, `is_some()`, and `filter` instead of manual pattern matching or nested conditional statements when working with optional values. This approach reduces code complexity, improves readability, and prevents common null-handling errors.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"Null Handling","language":"Rust","updated":"2025-09-11","comments":4,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-use-option-combinators.md"},{"slug":"jj-minimize-api-scope","title":"Minimize API scope","description":"When designing APIs, prioritize simplicity and focused scope over feature completeness. Before adding new API methods or expanding existing ones, evaluate whether the functionality can be achieved with existing interfaces. APIs that spread across multiple modules or introduce complex signatures often indicate scope creep that should be avoided.","repository":"jj-vcs/jj","domain":"devtools","topic":"API","language":"Markdown","updated":"2025-09-11","comments":4,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-minimize-api-scope.md"},{"slug":"jj-preserve-error-context","title":"preserve error context","description":"When handling errors, preserve the original error context and avoid exposing internal representations to users. Use `IoResultExt::context()` to attach meaningful path information to I/O errors, and maintain error source chains using `.with_source()` or similar mechanisms.","repository":"jj-vcs/jj","domain":"devtools","topic":"Error Handling","language":"Rust","updated":"2025-09-11","comments":4,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-preserve-error-context.md"},{"slug":"twenty-validate-configuration-consistency","title":"Validate configuration consistency","description":"Ensure configuration values have consistent defaults across all systems and validate configuration structures using shared schemas. When introducing new configuration options, establish system-detected defaults that work intelligently based on browser or environment context, similar to existing patterns for date/time formats and timezone detection.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2025-09-11","comments":4,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-validate-configuration-consistency.md"},{"slug":"ragflow-agent-prompt-contracts","title":"Agent Prompt Contracts","description":"When building LLM Agents, treat the system prompt + framework prompt blocks as a contract with the agent’s inputs and tool/sub-agent configuration. Apply these rules:","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"AI","language":"Other","updated":"2025-09-11","comments":3,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-agent-prompt-contracts.md"},{"slug":"dify-document-for-team-readability","title":"Document for team readability","description":"Ensure code includes appropriate documentation to improve readability and help team members understand and work with the codebase effectively. This includes adding JSDoc comments for new components and features, and preserving existing documentation patterns like internationalization keys that serve as format specifications.","repository":"langgenius/dify","domain":"llm-infra","topic":"Documentation","language":"TSX","updated":"2025-09-11","comments":2,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-document-for-team-readability.md"},{"slug":"dify-prefer-nullish-coalescing-operator","title":"prefer nullish coalescing operator","description":"Use the nullish coalescing operator (`??`) instead of logical OR (`||`) when you want to provide default values only for null or undefined, while preserving other falsy values like empty arrays, empty strings, or zero.","repository":"langgenius/dify","domain":"llm-infra","topic":"Null Handling","language":"TSX","updated":"2025-09-11","comments":2,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-prefer-nullish-coalescing-operator.md"},{"slug":"dyad-use-parameter-objects","title":"Use parameter objects","description":"Design API methods to accept parameter objects instead of individual parameters or complex optional fields. This approach makes interfaces more maintainable and flexible when requirements evolve, avoiding breaking changes when adding or removing fields.","repository":"dyad-sh/dyad","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2025-09-11","comments":2,"stars":16903,"raw":"https://awesomereviewers.com/raw/dyad-use-parameter-objects.md"},{"slug":"hyperswitch-avoid-hard-coded-test-data","title":"avoid hard-coded test data","description":"Hard-coded test data creates maintenance burdens and unrealistic test scenarios. Instead of manually defining static values or adding workarounds for dynamic fields, leverage existing test utilities and generation functions.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"Testing","language":"JavaScript","updated":"2025-09-11","comments":2,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-avoid-hard-coded-test-data.md"},{"slug":"nx-accessibility-attributes-for-decorative-elements","title":"accessibility attributes for decorative elements","description":"Decorative images, icons, and other visual elements that don't convey meaningful content should include `aria-hidden=\"true\"` to prevent screen readers from announcing them. This ensures a cleaner experience for users with assistive technologies and maintains consistent accessibility markup patterns across the codebase.","repository":"nrwl/nx","domain":"devtools","topic":"Code Style","language":"Other","updated":"2025-09-11","comments":2,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-accessibility-attributes-for-decorative-elements.md"},{"slug":"hyperswitch-explicit-error-handling","title":"explicit error handling","description":"Avoid catch-all patterns and implicit error handling. Handle each error case explicitly, use the ? operator for error propagation instead of explicit returns, and never silently ignore errors.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"Error Handling","language":"Rust","updated":"2025-09-10","comments":11,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-explicit-error-handling.md"},{"slug":"ncnn-consistent-semantic-identifiers","title":"Consistent Semantic Identifiers","description":"When adding/changing code, use names that (1) match existing project conventions, (2) clearly express intent, and (3) avoid reserved/problematic identifier patterns.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Naming Conventions","language":"C++","updated":"2025-09-10","comments":8,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-consistent-semantic-identifiers.md"},{"slug":"dify-concurrent-resource-management","title":"Concurrent resource management","description":"When implementing concurrent operations, properly manage shared resources to prevent race conditions and ensure system stability. Use database-level locking mechanisms like `SELECT ... FOR UPDATE SKIP LOCKED` to prevent concurrent access to the same data. Configure thread pools with appropriate limits and timeouts to avoid resource exhaustion. Separate...","repository":"langgenius/dify","domain":"llm-infra","topic":"Concurrency","language":"Python","updated":"2025-09-10","comments":6,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-concurrent-resource-management.md"},{"slug":"twenty-use-domain-specific-exceptions","title":"Use domain-specific exceptions","description":"Create custom exception classes for each domain/module instead of throwing generic errors or letting applications crash. Include both technical details for developers and user-friendly messages for end users. Handle exceptions at the appropriate service layer rather than at API boundaries.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2025-09-10","comments":6,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-use-domain-specific-exceptions.md"},{"slug":"hyperswitch-database-schema-consistency","title":"Database schema consistency","description":"Ensure database schema definitions are consistent with ORM annotations and include proper constraints for data integrity and security. This includes matching primary key definitions between migrations and ORM models, making foreign key relationships mandatory where appropriate, and requiring tenant identifiers in queries to prevent cross-tenant data access.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"Database","language":"Rust","updated":"2025-09-10","comments":4,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-database-schema-consistency.md"},{"slug":"ncnn-backwards-compatible-api-evolution","title":"Backwards-Compatible API Evolution","description":"When evolving or integrating client-facing interfaces (CLI/API) and platform-dependent APIs, preserve compatibility across existing clients and across SDK/platform versions.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"API","language":"C++","updated":"2025-09-10","comments":4,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-backwards-compatible-api-evolution.md"},{"slug":"twenty-avoid-repeated-expensive-operations","title":"Avoid repeated expensive operations","description":"Replace repeated expensive operations like `find()`, `filter()`, or `sort()` with pre-computed maps or cached results to improve performance. When the same lookup or computation is performed multiple times, create a map or dictionary for O(1) access instead of O(n) searches.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Performance Optimization","language":"TSX","updated":"2025-09-10","comments":3,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-avoid-repeated-expensive-operations.md"},{"slug":"dify-ci-testing-tool-integration","title":"CI testing tool integration","description":"When integrating new testing or analysis tools into CI pipelines, use graceful failure patterns during initial adoption phases to prevent breaking existing workflows. Add tools as development dependencies and allow them to fail without blocking builds using `|| true` until they are stable and properly configured.","repository":"langgenius/dify","domain":"llm-infra","topic":"Testing","language":"Yaml","updated":"2025-09-10","comments":2,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-ci-testing-tool-integration.md"},{"slug":"query-explicit-error-narrowing","title":"Explicit Error Narrowing","description":"When using data/mutation libraries, treat error handling as a two-step process: (1) type errors conservatively at the boundary, and (2) implement recovery/UI logic that matches the library’s actual error-state semantics.","repository":"tanstack/query","domain":"app-frameworks","topic":"Error Handling","language":"Markdown","updated":"2025-09-09","comments":5,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-explicit-error-narrowing.md"},{"slug":"twenty-prefer-type-guards","title":"prefer type guards","description":"Use semantic type guards like `isDefined()` instead of basic type checks (`typeof`, simple null checks) or unsafe type assertions (`as!`, `!`). Type guards provide better readability, type safety, and null reference prevention.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Null Handling","language":"TypeScript","updated":"2025-09-09","comments":5,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-prefer-type-guards.md"},{"slug":"dify-name-by-semantic-purpose","title":"Name by semantic purpose","description":"Choose names that reflect the semantic purpose and meaning rather than implementation details or arbitrary values. Use enum constants instead of string literals, select precise identifiers that clearly convey intent, and name functions/variables based on their actual purpose.","repository":"langgenius/dify","domain":"llm-infra","topic":"Naming Conventions","language":"TSX","updated":"2025-09-09","comments":4,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-name-by-semantic-purpose.md"},{"slug":"router-ensure-documentation-clarity","title":"Ensure documentation clarity","description":"Documentation should be clear, accurate, and consistently structured to provide maximum value to developers. Avoid overly broad or inaccurate statements that may mislead users, and prefer explanatory content over warnings when possible.","repository":"TanStack/router","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-09-09","comments":4,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-ensure-documentation-clarity.md"},{"slug":"kong-yaml-message-folding","title":"YAML Message Folding","description":"When writing YAML string fields intended for one-line or sentence-like messages, prefer folded block scalars (`>`) so embedded newlines render as spaces. Use literal block scalars (`|`) only when you explicitly need to preserve line breaks.","repository":"Kong/kong","domain":"cloud-infra","topic":"Code Style","language":"Yaml","updated":"2025-09-09","comments":2,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-yaml-message-folding.md"},{"slug":"teleport-comprehensive-function-documentation","title":"Comprehensive function documentation","description":"Functions, methods, and non-trivial constants should include comprehensive documentation that explains their purpose, behavior, parameters, and relationships to similar functionality. Documentation should be precise about what the code does and when errors may occur, avoiding misleading statements.","repository":"gravitational/teleport","domain":"security","topic":"Documentation","language":"Go","updated":"2025-09-08","comments":6,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-comprehensive-function-documentation.md"},{"slug":"langchain-scoped-configuration-defaults","title":"Scoped configuration defaults","description":"When updating `pyproject.toml` (lint/type/dependency config), keep changes minimal and future-safe: enable/disable rules deliberately, scope suppressions to the smallest scope, avoid broad “select everything” patterns that can introduce unintended auto-fixes, remove redundant settings, and bound dependency versions.","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"Configurations","language":"Toml","updated":"2025-09-08","comments":5,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-scoped-configuration-defaults.md"},{"slug":"nx-minimize-resource-usage","title":"minimize resource usage","description":"Optimize performance by being selective about resource consumption - process only necessary data, avoid redundant operations, and use lightweight alternatives when possible.","repository":"nrwl/nx","domain":"devtools","topic":"Performance Optimization","language":"TypeScript","updated":"2025-09-08","comments":5,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-minimize-resource-usage.md"},{"slug":"twenty-add-tests-for-functionality","title":"Add tests for functionality","description":"New functionality should include corresponding tests to ensure code quality and maintainability. When introducing new methods, utilities, or services, always add appropriate test coverage.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"Testing","language":"TypeScript","updated":"2025-09-08","comments":5,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-add-tests-for-functionality.md"},{"slug":"nx-cache-expensive-calculations","title":"Cache expensive calculations","description":"Avoid recalculating expensive operations in frequently called methods by caching results and only recalculating when necessary. This is especially important in rendering loops, event handlers, and other high-frequency code paths where the same computation may be performed repeatedly with the same inputs.","repository":"nrwl/nx","domain":"devtools","topic":"Performance Optimization","language":"Rust","updated":"2025-09-08","comments":3,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-cache-expensive-calculations.md"},{"slug":"jj-multiple-remote-configuration","title":"Multiple remote configuration","description":"When documenting or implementing features that involve multiple remote repositories, provide clear guidance on different remote configuration strategies and their appropriate use cases. This includes explaining the distinction between remotes you have write access to (typically `origin`) versus read-only upstream remotes, and when to track or sync different...","repository":"jj-vcs/jj","domain":"devtools","topic":"Networking","language":"Markdown","updated":"2025-09-08","comments":2,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-multiple-remote-configuration.md"},{"slug":"hyperswitch-synchronize-environment-configurations","title":"Synchronize environment configurations","description":"When making configuration changes, ensure all relevant environment files are updated consistently to prevent environment-specific inconsistencies and deployment issues.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"Configurations","language":"Toml","updated":"2025-09-07","comments":6,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-synchronize-environment-configurations.md"},{"slug":"router-explicit-error-type-handling","title":"explicit error type handling","description":"Handle errors with explicit type checking and intentional decisions rather than generic catch-all approaches. This improves error handling precision and makes error recovery logic clearer.","repository":"TanStack/router","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2025-09-07","comments":5,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-explicit-error-type-handling.md"},{"slug":"twenty-minimize-hook-re-renders","title":"Minimize hook re-renders","description":"Design React hooks to minimize unnecessary re-renders by avoiding common anti-patterns that cause performance issues. **Key principles:** 1. **Avoid umbrella hooks** - Don''t create hooks that combine multiple responsibilities, especially mixing read and write operations. Split them into focused, single-purpose hooks.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"React","language":"TypeScript","updated":"2025-09-07","comments":5,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-minimize-hook-re-renders.md"},{"slug":"dify-validate-before-accessing","title":"Validate before accessing","description":"Always validate preconditions before performing operations that could throw runtime errors. This includes checking object property existence, verifying context validity, and ensuring required data is available before proceeding.","repository":"langgenius/dify","domain":"llm-infra","topic":"Error Handling","language":"TSX","updated":"2025-09-07","comments":2,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-validate-before-accessing.md"},{"slug":"jj-specify-configuration-scope","title":"specify configuration scope","description":"Always explicitly specify the configuration scope using `--user` or `--repo` flags when setting configuration values with `jj config set`. This prevents ambiguity about where the configuration should be stored and ensures settings are applied at the intended level.","repository":"jj-vcs/jj","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2025-09-07","comments":2,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-specify-configuration-scope.md"},{"slug":"teleport-safe-null-handling","title":"Safe null handling","description":"Always handle potentially null or undefined values defensively using appropriate JavaScript patterns. Choose the right technique based on your specific needs:","repository":"gravitational/teleport","domain":"security","topic":"Null Handling","language":"TypeScript","updated":"2025-09-07","comments":2,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-safe-null-handling.md"},{"slug":"teleport-thoughtful-configuration-design","title":"thoughtful configuration design","description":"When designing configuration schemas and fields, carefully consider their placement, validation, and long-term implications to prevent conflicts, maintain compatibility, and ensure good user experience.","repository":"gravitational/teleport","domain":"security","topic":"Configurations","language":"Markdown","updated":"2025-09-05","comments":9,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-thoughtful-configuration-design.md"},{"slug":"teleport-configuration-requirements-clarity","title":"Configuration requirements clarity","description":"Configuration requirements and dependencies should be made explicit and prominent in documentation, not buried in notes or admonitions. When introducing new configuration options or requirements, ensure they are clearly documented as prerequisites or explicit steps rather than side notes that users might miss.","repository":"gravitational/teleport","domain":"security","topic":"Configurations","language":"Other","updated":"2025-09-05","comments":5,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-configuration-requirements-clarity.md"},{"slug":"teleport-use-appropriate-testify-assertions","title":"Use appropriate testify assertions","description":"Choose the most specific and appropriate testify assertion methods for your test scenarios to improve test clarity, error reporting, and maintainability.","repository":"gravitational/teleport","domain":"security","topic":"Testing","language":"Go","updated":"2025-09-05","comments":5,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-use-appropriate-testify-assertions.md"},{"slug":"teleport-add-contextual-logging","title":"Add contextual logging","description":"Add informative log messages with sufficient context to help operators diagnose issues, understand system state, and trace complex operations. Include relevant error details, system configuration status, and operational flow information.","repository":"gravitational/teleport","domain":"security","topic":"Logging","language":"Go","updated":"2025-09-05","comments":4,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-add-contextual-logging.md"},{"slug":"teleport-authenticated-health-checks","title":"Authenticated health checks","description":"When implementing health checks for external services, verify the complete communication stack rather than just basic connectivity. Health checks should validate that your service can successfully authenticate and perform actual operations, not merely establish network connections.","repository":"gravitational/teleport","domain":"security","topic":"Networking","language":"Markdown","updated":"2025-09-05","comments":4,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-authenticated-health-checks.md"},{"slug":"teleport-database-query-parameter-hygiene","title":"Database query parameter hygiene","description":"Ensure all database query parameters serve a clear purpose and are properly utilized. Remove unused filter parameters that create confusion and verify that necessary filtering conditions are not accidentally omitted during refactoring.","repository":"gravitational/teleport","domain":"security","topic":"Database","language":"Go","updated":"2025-09-05","comments":2,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-database-query-parameter-hygiene.md"},{"slug":"teleport-defensive-error-handling","title":"defensive error handling","description":"Implement defensive programming practices to prevent runtime errors and provide meaningful error information when failures occur. This includes validating object state before operations and ensuring error messages contain specific contextual details.","repository":"gravitational/teleport","domain":"security","topic":"Error Handling","language":"TypeScript","updated":"2025-09-05","comments":2,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-defensive-error-handling.md"},{"slug":"teleport-environment-specific-configuration-identifiers","title":"Environment-specific configuration identifiers","description":"Use distinct, environment-specific identifiers in configuration to prevent conflicts between different application contexts (development vs production, different versions, etc.) and ensure semantic clarity.","repository":"gravitational/teleport","domain":"security","topic":"Configurations","language":"TypeScript","updated":"2025-09-05","comments":2,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-environment-specific-configuration-identifiers.md"},{"slug":"teleport-network-address-clarity","title":"Network address clarity","description":"When documenting or configuring network addresses, DNS names, and IP addresses, be explicit about traffic direction and ensure uniqueness to prevent conflicts and ambiguity.","repository":"gravitational/teleport","domain":"security","topic":"Networking","language":"Other","updated":"2025-09-05","comments":2,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-network-address-clarity.md"},{"slug":"teleport-use-semantic-html-elements","title":"Use semantic HTML elements","description":"When creating interactive components in React, use proper HTML semantic elements as the foundation, even when using styled-components. Interactive elements should be actual buttons, links, or form controls rather than generic divs or spans with click handlers.","repository":"gravitational/teleport","domain":"security","topic":"React","language":"TSX","updated":"2025-09-05","comments":2,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-use-semantic-html-elements.md"},{"slug":"teleport-defer-authentication-prompts","title":"defer authentication prompts","description":"Defer mounting components that trigger authentication prompts (MFA, per-session authentication) until they are actually visible or needed by the user. This prevents multiple concurrent authentication requests that can cause failures due to hardware token limitations or daemon mutex conflicts.","repository":"gravitational/teleport","domain":"security","topic":"Security","language":"TSX","updated":"2025-09-05","comments":1,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-defer-authentication-prompts.md"},{"slug":"teleport-enforce-scope-boundaries","title":"Enforce scope boundaries","description":"When implementing hierarchical permission systems with scopes, ensure that permissions granted at a specific scope cannot be used to access resources or escalate privileges outside that scope's boundaries. This prevents lateral movement and privilege escalation attacks.","repository":"gravitational/teleport","domain":"security","topic":"Security","language":"Markdown","updated":"2025-09-04","comments":13,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-enforce-scope-boundaries.md"},{"slug":"teleport-guide-structure-consistency","title":"Guide structure consistency","description":"Documentation guides should follow a consistent structure and provide clear, descriptive content to improve user experience and comprehension. **Structure Requirements:**","repository":"gravitational/teleport","domain":"security","topic":"Documentation","language":"Other","updated":"2025-09-04","comments":12,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-guide-structure-consistency.md"},{"slug":"serena-avoid-local-imports","title":"avoid local imports","description":"Place all import statements at the top of the file as global imports rather than importing modules within functions or methods. Local imports reduce code readability, complicate dependency tracking, and can indicate poor code organization.","repository":"oraios/serena","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2025-09-04","comments":6,"stars":14465,"raw":"https://awesomereviewers.com/raw/serena-avoid-local-imports.md"},{"slug":"teleport-minimize-unnecessary-allocations","title":"minimize unnecessary allocations","description":"Avoid unnecessary memory allocations in performance-critical code paths, especially in frequently executed functions or loops that process large datasets. Common allocation sources to eliminate include:","repository":"gravitational/teleport","domain":"security","topic":"Performance Optimization","language":"Go","updated":"2025-09-04","comments":5,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-minimize-unnecessary-allocations.md"},{"slug":"teleport-optimize-computational-complexity","title":"Optimize computational complexity","description":"Always analyze the computational complexity of algorithms and choose efficient implementations to avoid performance bottlenecks and security vulnerabilities. Pay special attention to avoiding O(N²) algorithms that can create DoS risks, eliminate unnecessary computational overhead, and select appropriate data structures.","repository":"gravitational/teleport","domain":"security","topic":"Algorithms","language":"Go","updated":"2025-09-04","comments":4,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-optimize-computational-complexity.md"},{"slug":"teleport-use-descriptive-semantic-names","title":"Use descriptive semantic names","description":"Choose descriptive, semantic names that clearly convey purpose and meaning rather than generic or ambiguous identifiers. Avoid generic method names like `apply` or `handle` that don't indicate their specific function. When existing semantic references are available (such as theme palette names), prefer them over hardcoded values. Add clarifying comments...","repository":"gravitational/teleport","domain":"security","topic":"Naming Conventions","language":"TypeScript","updated":"2025-09-04","comments":3,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-use-descriptive-semantic-names.md"},{"slug":"teleport-use-structured-api-parameters","title":"Use structured API parameters","description":"When designing APIs with multiple related parameters, especially optional ones like filters, sorting, and pagination options, bundle them into structured types rather than using long parameter lists. This prevents parameter confusion, reduces the likelihood of argument order mistakes, and makes APIs more extensible without breaking changes.","repository":"gravitational/teleport","domain":"security","topic":"API","language":"Go","updated":"2025-09-04","comments":3,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-use-structured-api-parameters.md"},{"slug":"dyad-separate-model-specific-configuration","title":"separate model-specific configuration","description":"Avoid mixing model-specific features with provider-level configuration or hard-coding model-specific logic in generic handlers. This creates architectural debt and maintenance burden as new AI models are added to the system.","repository":"dyad-sh/dyad","domain":"ai-agents","topic":"AI","language":"TypeScript","updated":"2025-09-04","comments":2,"stars":16903,"raw":"https://awesomereviewers.com/raw/dyad-separate-model-specific-configuration.md"},{"slug":"hyperswitch-use-defensive-sql-clauses","title":"Use defensive SQL clauses","description":"Always use defensive SQL clauses like `IF NOT EXISTS` and `IF EXISTS` in migration scripts to make them idempotent and prevent failures when run multiple times or in different environments. This ensures migrations can be safely re-executed without causing errors due to existing schema elements.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"Migrations","language":"Sql","updated":"2025-09-04","comments":2,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-use-defensive-sql-clauses.md"},{"slug":"teleport-design-intuitive-query-interfaces","title":"Design intuitive query interfaces","description":"When designing algorithms for querying, filtering, or data manipulation, prioritize user-friendly function names and interfaces over technically precise but obscure terminology. Users should be able to understand and use your algorithmic interfaces without deep technical knowledge of the underlying implementation.","repository":"gravitational/teleport","domain":"security","topic":"Algorithms","language":"Markdown","updated":"2025-09-04","comments":2,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-design-intuitive-query-interfaces.md"},{"slug":"teleport-follow-platform-naming-conventions","title":"Follow platform naming conventions","description":"Always use the correct naming conventions for the platform you're working with, particularly React and HTML standards. React has specific prop naming requirements that differ from HTML attributes, and using incorrect names can cause functionality to break or behave unexpectedly.","repository":"gravitational/teleport","domain":"security","topic":"Naming Conventions","language":"TSX","updated":"2025-09-04","comments":2,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-follow-platform-naming-conventions.md"},{"slug":"teleport-validate-before-access","title":"validate before access","description":"Always check for null, empty, or unset values before accessing or processing them, and return meaningful errors when validation fails. This prevents runtime panics and provides clear feedback about missing required data.","repository":"gravitational/teleport","domain":"security","topic":"Null Handling","language":"Go","updated":"2025-09-04","comments":2,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-validate-before-access.md"},{"slug":"twenty-follow-react-component-patterns","title":"Follow React component patterns","description":"React components should be rendered as standard JSX elements, not called as functions, and should follow established architectural patterns. This ensures consistency with React conventions and maintainability.","repository":"twentyhq/twenty","domain":"app-frameworks","topic":"React","language":"TSX","updated":"2025-09-04","comments":2,"stars":35477,"raw":"https://awesomereviewers.com/raw/twenty-follow-react-component-patterns.md"},{"slug":"lobe-chat-model-specification-accuracy","title":"Model specification accuracy","description":"Ensure AI model configurations accurately reflect official specifications and avoid hardcoded assumptions. Model parameters, token limits, capabilities, and naming should match vendor documentation rather than using generic defaults.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"AI","language":"TypeScript","updated":"2025-09-03","comments":12,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-model-specification-accuracy.md"},{"slug":"teleport-organize-code-by-functionality","title":"Organize code by functionality","description":"Structure code based on what it does rather than how it's implemented. Group related functionality together, extract reusable components, and place code in appropriate packages or files to improve maintainability and readability.","repository":"gravitational/teleport","domain":"security","topic":"Code Style","language":"Go","updated":"2025-09-03","comments":10,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-organize-code-by-functionality.md"},{"slug":"teleport-use-descriptive-names","title":"Use descriptive names","description":"Choose names that clearly indicate their purpose and behavior rather than using generic or ambiguous terms. Avoid internal abbreviations in user-facing content, ensure function names accurately reflect what they do, and prefer specific descriptive terms over generic ones.","repository":"gravitational/teleport","domain":"security","topic":"Naming Conventions","language":"Go","updated":"2025-09-03","comments":9,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-use-descriptive-names.md"},{"slug":"dspy-complete-parameter-documentation","title":"Complete parameter documentation","description":"Ensure all public functions and classes have comprehensive docstrings that include parameter descriptions, type hints, return value documentation, and references to related implementations. This significantly improves usability by helping developers understand how to use APIs correctly and find related code.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Documentation","language":"Python","updated":"2025-09-03","comments":7,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-complete-parameter-documentation.md"},{"slug":"ant-design-markdown-formatting-consistency","title":"Markdown formatting consistency","description":"Ensure consistent markdown formatting in documentation by wrapping all technical terms, API names, property names, and code-related content in backticks. This improves readability and maintains visual consistency across documentation.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Code Style","language":"Markdown","updated":"2025-09-03","comments":6,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-markdown-formatting-consistency.md"},{"slug":"dspy-null-safety-patterns","title":"Null safety patterns","description":"Implement proper null safety patterns to prevent runtime errors and unexpected behavior. This includes several key practices: **1. Handle Optional types correctly:** When working with Union types containing None, extract the non-None type before type checking to avoid `issubclass()` errors with type annotations.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2025-09-03","comments":6,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-null-safety-patterns.md"},{"slug":"dspy-optional-configuration-parameters","title":"Optional configuration parameters","description":"Make configuration parameters optional with sensible defaults instead of requiring mandatory values, and only enable optional features when explicitly configured through environment variables or user settings.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2025-09-03","comments":6,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-optional-configuration-parameters.md"},{"slug":"novu-extract-reusable-components","title":"Extract reusable components","description":"Eliminate code duplication by extracting common functionality into shared utilities, constants, and base classes. When you notice repeated code patterns, logic, or constants across multiple files, consolidate them into reusable components.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2025-09-03","comments":6,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-extract-reusable-components.md"},{"slug":"teleport-api-consistency-patterns","title":"API consistency patterns","description":"Maintain consistent API patterns and structures across different resource types and access methods within the same system. When designing new API fields or resources, follow established patterns from existing similar functionality rather than creating divergent approaches.","repository":"gravitational/teleport","domain":"security","topic":"API","language":"Markdown","updated":"2025-09-03","comments":5,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-api-consistency-patterns.md"},{"slug":"lobe-chat-provider-based-interface-design","title":"Provider-based interface design","description":"When designing interfaces that handle multiple providers or services, organize the API structure around provider-specific logic rather than mixing different provider handling in generic components. Use provider-based props structures and create dedicated components or methods for each provider type.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"API","language":"TSX","updated":"2025-09-03","comments":4,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-provider-based-interface-design.md"},{"slug":"teleport-prefer-simpler-patterns","title":"prefer simpler patterns","description":"Choose simpler, more readable code patterns over complex alternatives to improve maintainability and reduce cognitive load. This includes avoiding unnecessary complexity in variable assignment, function parameters, and styling approaches.","repository":"gravitational/teleport","domain":"security","topic":"Code Style","language":"TSX","updated":"2025-09-03","comments":4,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-prefer-simpler-patterns.md"},{"slug":"jj-documentation-formatting-consistency","title":"documentation formatting consistency","description":"Maintain consistent formatting and style patterns across all documentation to improve readability and user experience. This includes using proper shell command notation, consistent punctuation choices, and aligned configuration examples.","repository":"jj-vcs/jj","domain":"devtools","topic":"Code Style","language":"Markdown","updated":"2025-09-03","comments":3,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-documentation-formatting-consistency.md"},{"slug":"signoz-measure-before-optimizing","title":"measure before optimizing","description":"Always measure performance impact before making optimization decisions or skipping potential optimizations due to complexity assumptions. Performance characteristics can be counterintuitive, and assumptions about complexity vs. performance trade-offs should be validated with actual benchmarks.","repository":"SigNoz/signoz","domain":"observability","topic":"Performance Optimization","language":"Go","updated":"2025-09-03","comments":3,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-measure-before-optimizing.md"},{"slug":"teleport-use-semantically-clear-names","title":"Use semantically clear names","description":"Choose names that clearly convey their purpose, scope, and meaning to reduce ambiguity and improve code maintainability. Avoid generic or potentially confusing terms when more specific alternatives exist.","repository":"gravitational/teleport","domain":"security","topic":"Naming Conventions","language":"Other","updated":"2025-09-03","comments":3,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-use-semantically-clear-names.md"},{"slug":"cypress-network-data-encoding","title":"Network data encoding","description":"Ensure network-related data like URLs and IP addresses are properly encoded and typed to prevent validation failures and type mismatches. When working with network protocols, use precise types that match the actual return values and apply consistent encoding across all network operations.","repository":"cypress-io/cypress","domain":"devtools","topic":"Networking","language":"TypeScript","updated":"2025-09-03","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-network-data-encoding.md"},{"slug":"nx-provide-actionable-error-messages","title":"Provide actionable error messages","description":"When handling errors, transform technical exceptions into user-friendly messages that include clear remediation steps and actionable guidance. Avoid exposing raw technical errors to users, and instead provide context about what went wrong and how to resolve the issue.","repository":"nrwl/nx","domain":"devtools","topic":"Error Handling","language":"TypeScript","updated":"2025-09-03","comments":2,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-provide-actionable-error-messages.md"},{"slug":"signoz-add-tests-for-new-code","title":"Add tests for new code","description":"All new code additions, regardless of complexity, should include corresponding unit tests to ensure functionality works as expected and to prevent regressions. This applies to new modules, utility functions, and any other code components.","repository":"SigNoz/signoz","domain":"observability","topic":"Testing","language":"Go","updated":"2025-09-03","comments":2,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-add-tests-for-new-code.md"},{"slug":"teleport-parameterize-configuration-values","title":"parameterize configuration values","description":"Avoid hardcoded values in configuration files and templates. Make settings parameterizable with sensible defaults to accommodate different environments and use cases. Even when you're unsure if a setting needs to be configurable, err on the side of flexibility - most users will stick with defaults, but those who need customization will appreciate the option.","repository":"gravitational/teleport","domain":"security","topic":"Configurations","language":"Yaml","updated":"2025-09-03","comments":2,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-parameterize-configuration-values.md"},{"slug":"dyad-limit-postmessage-data-exposure","title":"Limit postMessage data exposure","description":"When using postMessage for inter-window communication, avoid sending raw event data or generic message types that could expose sensitive information. Instead, use specific, predefined message types and only send the minimum necessary data.","repository":"dyad-sh/dyad","domain":"ai-agents","topic":"Security","language":"JavaScript","updated":"2025-09-03","comments":1,"stars":16903,"raw":"https://awesomereviewers.com/raw/dyad-limit-postmessage-data-exposure.md"},{"slug":"flutter-use-descriptive-names","title":"Use descriptive names","description":"Names should clearly describe what they represent or do, rather than how they're implemented or using generic terms. Avoid abbreviations and use full, descriptive words that accurately reflect the purpose and behavior of the code element.","repository":"flutter/flutter","domain":"app-frameworks","topic":"Naming Conventions","language":"Other","updated":"2025-09-02","comments":13,"stars":172252,"raw":"https://awesomereviewers.com/raw/flutter-use-descriptive-names.md"},{"slug":"signoz-consistent-descriptive-naming","title":"consistent descriptive naming","description":"Use meaningful, descriptive names that clearly convey purpose and maintain consistency across similar concepts throughout the codebase. Avoid magic strings, cryptic abbreviations, and inconsistent naming patterns.","repository":"SigNoz/signoz","domain":"observability","topic":"Naming Conventions","language":"Go","updated":"2025-09-02","comments":12,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-consistent-descriptive-naming.md"},{"slug":"langflow-api-documentation-completeness","title":"API documentation completeness","description":"Ensure API documentation provides comprehensive, accurate information including limitations, complete workflow examples, and proper cross-references. API documentation should clearly state what endpoints do, what they don't support, their constraints, and how they fit into larger workflows.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"API","language":"Other","updated":"2025-09-02","comments":9,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-api-documentation-completeness.md"},{"slug":"angular-use-descriptive-names","title":"Use descriptive names","description":"Choose names that clearly and unambiguously describe their purpose rather than being overly generic or technical. Names should be self-documenting and immediately convey what the entity does or represents.","repository":"angular/angular","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2025-09-02","comments":7,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-use-descriptive-names.md"},{"slug":"ant-design-api-evolution-strategy","title":"API evolution strategy","description":"When evolving APIs, design for extensibility and provide clear migration paths to maintain backward compatibility while improving developer experience.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2025-09-02","comments":7,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-api-evolution-strategy.md"},{"slug":"ant-design-prevent-component-re-mounting","title":"Prevent component re-mounting","description":"Maintain stable component structure to prevent unnecessary re-mounting and unmounting of child components. Conditional rendering that changes component tree structure can cause child components to lose state and trigger mount/unmount cycles, breaking components with mount effects.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"React","language":"TSX","updated":"2025-09-02","comments":7,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-prevent-component-re-mounting.md"},{"slug":"ant-design-use-semantic-descriptive-names","title":"Use semantic descriptive names","description":"Choose variable, function, and type names that clearly communicate their purpose, source, and context. Names should be self-documenting and avoid ambiguity or conflicts with existing identifiers.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Naming Conventions","language":"TSX","updated":"2025-09-02","comments":7,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-use-semantic-descriptive-names.md"},{"slug":"signoz-package-organization-standards","title":"Package organization standards","description":"Maintain proper package organization by following established structural patterns and separation of concerns. Code should be organized into appropriate packages based on functionality and responsibility.","repository":"SigNoz/signoz","domain":"observability","topic":"Code Style","language":"Go","updated":"2025-09-02","comments":7,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-package-organization-standards.md"},{"slug":"angular-use-reactive-signal-patterns","title":"Use reactive signal patterns","description":"Prefer Angular's reactive signal patterns over manual subscription management and imperative approaches. Use signals directly in templates without calling getters, convert observables to signals with `toSignal()`, and maintain reactive data flow throughout your application.","repository":"angular/angular","domain":"app-frameworks","topic":"Angular","language":"Markdown","updated":"2025-09-02","comments":6,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-use-reactive-signal-patterns.md"},{"slug":"flutter-algorithm-precision-handling","title":"Algorithm precision handling","description":"Choose algorithms that handle edge cases and mathematical precision correctly to avoid subtle bugs and unexpected behavior. When implementing algorithms, prioritize mathematical soundness and robust edge case handling over apparent simplicity. Use established mathematical formulas and precise operations rather than approximations that may fail in corner...","repository":"flutter/flutter","domain":"app-frameworks","topic":"Algorithms","language":"Other","updated":"2025-09-02","comments":6,"stars":172252,"raw":"https://awesomereviewers.com/raw/flutter-algorithm-precision-handling.md"},{"slug":"angular-avoid-reactive-over-engineering","title":"Avoid reactive over-engineering","description":"Choose the simplest React primitive that meets your requirements rather than reaching for complex reactive patterns. Avoid useEffect when useState, useMemo, or useCallback would suffice. If you find yourself using useEffect to copy data from one state to another state, it's a sign you should restructure your component's state management.","repository":"angular/angular","domain":"app-frameworks","topic":"React","language":"Markdown","updated":"2025-09-02","comments":4,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-avoid-reactive-over-engineering.md"},{"slug":"ant-design-handle-optional-values-safely","title":"Handle optional values safely","description":"Always provide safe defaults or fallbacks when working with optional or potentially undefined values. Avoid using non-null assertion operators (`!`) on optional parameters, and ensure proper handling in type checking and value merging scenarios.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Null Handling","language":"TypeScript","updated":"2025-09-02","comments":4,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-handle-optional-values-safely.md"},{"slug":"flutter-future-proof-configuration-defaults","title":"Future-proof configuration defaults","description":"When designing configuration options, avoid hardcoded values and ensure defaults can be changed in future versions without breaking existing code. Make boolean flags negatable so users can opt out when defaults change, avoid ambiguous null vs empty configuration states, and provide clear migration paths for deprecated options.","repository":"flutter/flutter","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2025-09-02","comments":4,"stars":172252,"raw":"https://awesomereviewers.com/raw/flutter-future-proof-configuration-defaults.md"},{"slug":"mermaid-consistent-docs-formatting","title":"Consistent Docs Formatting","description":"For documentation, apply strict formatting rules to both code samples and embedded assets: - Use the correct fenced-code language for rendered examples: fence Mermaid diagram samples with `mermaid-example` and keep indentation consistent.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Code Style","language":"Markdown","updated":"2025-09-02","comments":3,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-consistent-docs-formatting.md"},{"slug":"teleport-api-parameter-encapsulation","title":"API parameter encapsulation","description":"When designing API methods that accept multiple related parameters (especially filters, search criteria, or configuration options), encapsulate them in dedicated message types rather than adding individual fields directly to the request message. This pattern improves future extensibility by allowing new parameters to be added without breaking existing...","repository":"gravitational/teleport","domain":"security","topic":"API","language":"Other","updated":"2025-09-02","comments":3,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-api-parameter-encapsulation.md"},{"slug":"ant-design-enforce-ci-workflow-gates","title":"Enforce CI workflow gates","description":"Establish and enforce proper CI/CD workflow gates to maintain code quality and release safety. This includes preventing direct commits to protected branches and validating CI status before releases.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"CI/CD","language":"TypeScript","updated":"2025-09-02","comments":2,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-enforce-ci-workflow-gates.md"},{"slug":"claude-agent-sdk-python-maintain-naming-consistency","title":"Maintain naming consistency","description":"Ensure field names, method names, and identifiers are consistent across different contexts including cross-language SDKs, API specifications, and data structures. When multiple naming options exist, prioritize alignment with established patterns and accurate representation of the underlying functionality or data.","repository":"anthropics/claude-agent-sdk-python","domain":"ai-agents","topic":"Naming Conventions","language":"Python","updated":"2025-09-02","comments":2,"stars":2158,"raw":"https://awesomereviewers.com/raw/claude-agent-sdk-python-maintain-naming-consistency.md"},{"slug":"hyperswitch-centralize-shared-configurations","title":"Centralize shared configurations","description":"Avoid duplicating configuration values across multiple files. Instead, define shared configurations in centralized locations and import them where needed. This prevents inconsistencies and makes configuration management more maintainable.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"Configurations","language":"JavaScript","updated":"2025-09-02","comments":2,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-centralize-shared-configurations.md"},{"slug":"hyperswitch-explicit-database-constraints","title":"explicit database constraints","description":"Be explicit about database constraints and avoid relying on database-level defaults. Always specify NOT NULL constraints where appropriate and let the application layer handle default values rather than the database schema. Use appropriate primary key strategies like SERIAL for auto-incrementing IDs.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"Database","language":"Sql","updated":"2025-09-02","comments":2,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-explicit-database-constraints.md"},{"slug":"jj-require-explicit-security-consent","title":"require explicit security consent","description":"Always require explicit user consent and validation before executing potentially dangerous operations, especially those involving external configuration or dynamic user inputs. This prevents security vulnerabilities from being introduced through seemingly innocent features.","repository":"jj-vcs/jj","domain":"devtools","topic":"Security","language":"Rust","updated":"2025-09-02","comments":2,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-require-explicit-security-consent.md"},{"slug":"parlant-document-meaningful-complexity","title":"Document meaningful complexity","description":"Documentation should add genuine value by explaining non-obvious behavior, complex approaches, or important context that isn't immediately clear from the code itself. Remove redundant docstrings and comments that merely restate what the code obviously does, while ensuring that sophisticated algorithms, design decisions, or non-trivial implementations are...","repository":"emcie-co/parlant","domain":"ai-agents","topic":"Documentation","language":"Python","updated":"2025-09-02","comments":2,"stars":12205,"raw":"https://awesomereviewers.com/raw/parlant-document-meaningful-complexity.md"},{"slug":"parlant-implement-graceful-error-handling","title":"Implement graceful error handling","description":"Replace assertions, unhandled exceptions, and error-suppression mechanisms with proper error handling that provides clear, actionable feedback to users. Instead of allowing applications to crash or silently hide issues, implement structured error handling that communicates what went wrong and suggests next steps.","repository":"emcie-co/parlant","domain":"ai-agents","topic":"Error Handling","language":"Other","updated":"2025-09-02","comments":2,"stars":12205,"raw":"https://awesomereviewers.com/raw/parlant-implement-graceful-error-handling.md"},{"slug":"teleport-assess-optimization-necessity","title":"Assess optimization necessity","description":"Evaluate whether performance optimizations are actually needed based on your specific context, data size, and operation cost. Avoid implementing optimizations that add complexity without meaningful benefit.","repository":"gravitational/teleport","domain":"security","topic":"Performance Optimization","language":"TSX","updated":"2025-09-02","comments":2,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-assess-optimization-necessity.md"},{"slug":"ant-design-validate-disabled-state-accessibility","title":"validate disabled state accessibility","description":"When UI components with interactive elements (like buttons with href attributes) are disabled, ensure they maintain proper accessibility standards and don't create security vulnerabilities. Disabled states should properly prevent user interaction while maintaining clear visual and programmatic indication of their state.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Security","language":"Markdown","updated":"2025-09-02","comments":1,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-validate-disabled-state-accessibility.md"},{"slug":"firecrawl-remove-unnecessary-authentication","title":"remove unnecessary authentication","description":"Avoid initializing authentication mechanisms, credentials, or identity objects when they are not actually used in the code. This follows the security principle of least privilege and reduces potential attack surface by minimizing credential exposure.","repository":"firecrawl/firecrawl","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2025-09-02","comments":1,"stars":54535,"raw":"https://awesomereviewers.com/raw/firecrawl-remove-unnecessary-authentication.md"},{"slug":"teleport-minimize-authentication-complexity","title":"Minimize authentication complexity","description":"Avoid implementing redundant authentication steps when secure, direct methods are already available. Multiple authentication layers can introduce unnecessary complexity and potential security vulnerabilities. When identity files or tokens are already being used, evaluate whether additional login steps are truly required.","repository":"gravitational/teleport","domain":"security","topic":"Security","language":"Yaml","updated":"2025-09-02","comments":1,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-minimize-authentication-complexity.md"},{"slug":"dify-prefer-exceptions-over-silent-failures","title":"Prefer exceptions over silent failures","description":"Raise exceptions instead of returning None, logging warnings, or silently modifying values when encountering error conditions. This makes failures explicit and forces callers to handle error cases properly, improving code reliability and debugging experience.","repository":"langgenius/dify","domain":"llm-infra","topic":"Error Handling","language":"Python","updated":"2025-09-01","comments":6,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-prefer-exceptions-over-silent-failures.md"},{"slug":"query-control-focus-and-suspense","title":"Control focus and suspense","description":"When implementing React hooks around navigation focus or React Suspense: 1) Treat focus/mount as distinct - If you use `useFocusEffect` to run data refetches, remember the callback also runs on initial mount. Skip the first run when appropriate.","repository":"tanstack/query","domain":"app-frameworks","topic":"React","language":"Markdown","updated":"2025-09-01","comments":6,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-control-focus-and-suspense.md"},{"slug":"hyperswitch-choose-optimal-algorithms","title":"Choose optimal algorithms","description":"When implementing functionality, carefully evaluate and select the most efficient algorithmic approaches for data processing, pattern matching, and operations. Consider computational complexity and performance implications of different approaches.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"Algorithms","language":"Rust","updated":"2025-09-01","comments":4,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-choose-optimal-algorithms.md"},{"slug":"novu-optimize-database-queries","title":"Optimize database queries","description":"Structure database queries and schemas for optimal performance by avoiding nullable fields when possible, organizing query conditions efficiently, and using targeted indexes.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Database","language":"TypeScript","updated":"2025-09-01","comments":3,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-optimize-database-queries.md"},{"slug":"signoz-use-design-tokens","title":"use design tokens","description":"Replace hardcoded color values, spacing, and other design-related constants with design tokens or CSS custom properties. This promotes consistency across the application, makes theme changes easier to implement, and reduces code duplication.","repository":"SigNoz/signoz","domain":"observability","topic":"Code Style","language":"Css","updated":"2025-09-01","comments":3,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-use-design-tokens.md"},{"slug":"teleport-follow-platform-naming-standards","title":"Follow platform naming standards","description":"Adhere to established naming conventions specific to each platform, framework, or technology being used. Different platforms have different naming requirements and best practices that should be followed to ensure compatibility, avoid linter warnings, and maintain consistency with ecosystem expectations.","repository":"gravitational/teleport","domain":"security","topic":"Naming Conventions","language":"Markdown","updated":"2025-09-01","comments":3,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-follow-platform-naming-standards.md"},{"slug":"dify-sqlalchemy-20-patterns","title":"SQLAlchemy 2.0 patterns","description":"Migrate from legacy SQLAlchemy 1.x query patterns to modern 2.0 style for better performance, clarity, and future compatibility. This involves several key transformations:","repository":"langgenius/dify","domain":"llm-infra","topic":"Database","language":"Python","updated":"2025-08-31","comments":14,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-sqlalchemy-20-patterns.md"},{"slug":"dify-safe-null-handling","title":"Safe null handling","description":"Handle null and undefined values safely by using appropriate fallback patterns, validating critical parameters early, and avoiding mutable default arguments.","repository":"langgenius/dify","domain":"llm-infra","topic":"Null Handling","language":"Python","updated":"2025-08-31","comments":10,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-safe-null-handling.md"},{"slug":"query-lockfile-change-hygiene","title":"Lockfile Change Hygiene","description":"Lockfiles (e.g., pnpm-lock.yaml) are configuration artifacts and should only change when the dependency configuration (package.json / workspace manifests) changes. If there are no package.json changes, do not commit lockfile updates; treat any lockfile-only diffs as accidental/experimental output and revert them.","repository":"tanstack/query","domain":"app-frameworks","topic":"Configurations","language":"Yaml","updated":"2025-08-31","comments":2,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-lockfile-change-hygiene.md"},{"slug":"litellm-mock-tests-in-testslitellm","title":"Mock tests in tests/litellm","description":"All new functionality must include mock tests placed in the `tests/litellm/` directory structure. Mock external API calls and dependencies rather than requiring real credentials or external services. This ensures tests can run reliably in CI/CD pipelines and are accessible to all contributors.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Testing","language":"Python","updated":"2025-08-30","comments":12,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-mock-tests-in-testslitellm.md"},{"slug":"litellm-safe-access-patterns","title":"Safe access patterns","description":"Always use safe access methods when working with potentially null or undefined values. Use .get() for dictionary access, check array bounds before indexing, and validate existence before operations.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Null Handling","language":"Python","updated":"2025-08-30","comments":9,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-safe-access-patterns.md"},{"slug":"parlant-maintain-code-consistency","title":"maintain code consistency","description":"Ensure consistent patterns, formatting, and conventions throughout the codebase. Inconsistencies in code style create confusion, reduce readability, and make maintenance more difficult.","repository":"emcie-co/parlant","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2025-08-29","comments":11,"stars":12205,"raw":"https://awesomereviewers.com/raw/parlant-maintain-code-consistency.md"},{"slug":"lobe-chat-extract-reusable-components","title":"Extract reusable components","description":"Extract utilities, types, constants, and shared logic into dedicated modules to improve code maintainability and reduce duplication. When you find yourself writing similar code in multiple places, or when you have magic strings/numbers, inline type definitions, or mixed business logic, extract them into appropriate shared locations.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2025-08-29","comments":7,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-extract-reusable-components.md"},{"slug":"flutter-extract-methods-for-clarity","title":"Extract methods for clarity","description":"Break down large methods and extract repeated code patterns into smaller, focused methods or getters to improve readability and maintainability. When you encounter large conditional blocks, complex logic, or repeated patterns, consider extracting them into well-named private methods or getters. This makes the code easier to understand, test, and modify.","repository":"flutter/flutter","domain":"app-frameworks","topic":"Code Style","language":"Other","updated":"2025-08-29","comments":6,"stars":172252,"raw":"https://awesomereviewers.com/raw/flutter-extract-methods-for-clarity.md"},{"slug":"litellm-use-configuration-helper-utilities","title":"Use configuration helper utilities","description":"Always use centralized helper functions for configuration management instead of direct environment variable access or hardcoded values. This ensures consistency, maintainability, and proper error handling across the codebase.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Configurations","language":"Python","updated":"2025-08-29","comments":5,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-use-configuration-helper-utilities.md"},{"slug":"angular-build-configuration-consistency","title":"Build configuration consistency","description":"Maintain consistent build and release configurations across the project by following established patterns and ensuring documentation accuracy. When implementing new build configurations or modifying existing ones, reference how similar components handle the same requirements to maintain uniformity.","repository":"angular/angular","domain":"app-frameworks","topic":"CI/CD","language":"Markdown","updated":"2025-08-29","comments":3,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-build-configuration-consistency.md"},{"slug":"lobe-chat-optimize-database-column-types","title":"Optimize database column types","description":"Choose appropriate data types for database columns to improve storage efficiency and performance. Use auto-incrementing identity columns for primary keys when there are no specific semantic requirements, and select column types with proper constraints based on expected data characteristics.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Database","language":"TypeScript","updated":"2025-08-29","comments":3,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-optimize-database-column-types.md"},{"slug":"router-react-hook-dependencies","title":"React hook dependencies","description":"Carefully manage dependencies in React hooks to avoid stale closures and ensure correct behavior. When using useCallback, useMemo, or useEffect, include all reactive values that the hook depends on in the dependency array, even if it affects stability.","repository":"TanStack/router","domain":"app-frameworks","topic":"React","language":"TSX","updated":"2025-08-29","comments":3,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-react-hook-dependencies.md"},{"slug":"teleport-avoid-overly-broad-permissions","title":"Avoid overly broad permissions","description":"Use specific, scoped permissions instead of wildcards to prevent unintended access to sensitive resources. Wildcard permissions can grant access to critical applications beyond the intended scope, creating security vulnerabilities.","repository":"gravitational/teleport","domain":"security","topic":"Security","language":"Go","updated":"2025-08-29","comments":3,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-avoid-overly-broad-permissions.md"},{"slug":"teleport-plan-encryption-key-recovery","title":"Plan encryption key recovery","description":"Always implement recovery mechanisms and plan for key rotation when designing encryption systems. Encryption key failures, compromises, or rotation issues can lead to permanent data loss or service disruption.","repository":"gravitational/teleport","domain":"security","topic":"Security","language":"Other","updated":"2025-08-29","comments":3,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-plan-encryption-key-recovery.md"},{"slug":"angular-centralize-configuration-management","title":"Centralize configuration management","description":"Extract configuration state, feature flags, and version-dependent settings into dedicated services rather than hardcoding values or prop drilling through component hierarchies. This approach improves maintainability, testability, and allows for easier updates without code changes.","repository":"angular/angular","domain":"app-frameworks","topic":"Configurations","language":"Html","updated":"2025-08-29","comments":2,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-centralize-configuration-management.md"},{"slug":"dyad-use-robust-test-selectors","title":"use robust test selectors","description":"E2E tests should use stable, reliable selectors and waiting strategies to prevent flaky test failures. Prefer test IDs over CSS class names for element selection, as class names may change during refactoring and break tests. Use condition-based waits instead of arbitrary timeouts to ensure tests wait for the actual state changes rather than fixed time...","repository":"dyad-sh/dyad","domain":"ai-agents","topic":"Testing","language":"TypeScript","updated":"2025-08-29","comments":2,"stars":16903,"raw":"https://awesomereviewers.com/raw/dyad-use-robust-test-selectors.md"},{"slug":"lobe-chat-verify-configuration-documentation","title":"Verify configuration documentation","description":"Ensure that all configuration documentation accurately reflects the actual implementation, especially for build tools, tech stack, and architectural decisions. When documenting configurations that deviate from standard practices, provide clear rationale for the choices made.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2025-08-29","comments":2,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-verify-configuration-documentation.md"},{"slug":"servo-validate-subprocess-errors-comprehensively","title":"validate subprocess errors comprehensively","description":"When executing external commands via subprocess, don't rely solely on return codes for error detection. Some tools may return 0 even when they fail. Instead, check multiple error indicators including return codes, stderr output, and stdout content to ensure robust error handling.","repository":"servo/servo","domain":"runtimes","topic":"Error Handling","language":"Python","updated":"2025-08-29","comments":2,"stars":32962,"raw":"https://awesomereviewers.com/raw/servo-validate-subprocess-errors-comprehensively.md"},{"slug":"teleport-environment-variable-precedence","title":"Environment variable precedence","description":"When working with environment variables in configuration management, ensure proper precedence handling and use clean fallback patterns. Environment variables can be inherited by subprocesses unexpectedly, potentially overriding command-line flags or other configuration sources.","repository":"gravitational/teleport","domain":"security","topic":"Configurations","language":"Go","updated":"2025-08-29","comments":2,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-environment-variable-precedence.md"},{"slug":"union-ensure-comprehensive-test-coverage","title":"Ensure comprehensive test coverage","description":"All new functionality must include corresponding tests that verify both success and failure scenarios. When adding new functions or modifying existing behavior, write tests that cover the main functionality as well as edge cases and error conditions.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Testing","language":"Rust","updated":"2025-08-29","comments":2,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-ensure-comprehensive-test-coverage.md"},{"slug":"flutter-explain-non-obvious-code","title":"Explain non-obvious code","description":"Add explanatory comments for any code that isn't immediately self-explanatory, including magic numbers, implementation decisions, parameter purposes, and edge cases. This improves code maintainability and helps future developers understand the reasoning behind specific choices.","repository":"flutter/flutter","domain":"app-frameworks","topic":"Documentation","language":"Other","updated":"2025-08-28","comments":15,"stars":172252,"raw":"https://awesomereviewers.com/raw/flutter-explain-non-obvious-code.md"},{"slug":"better-auth-consistent-configuration-handling","title":"consistent configuration handling","description":"Ensure configuration options are handled uniformly across all API endpoints and providers. Configuration should have clear precedence rules, support dynamic values where appropriate, and avoid hardcoded fallbacks.","repository":"better-auth/better-auth","domain":"security","topic":"API","language":"TypeScript","updated":"2025-08-28","comments":10,"stars":19651,"raw":"https://awesomereviewers.com/raw/better-auth-consistent-configuration-handling.md"},{"slug":"langflow-consolidate-related-information","title":"Consolidate related information","description":"Keep related documentation content together on a single page rather than fragmenting it across multiple pages. When users need to understand a complete concept or workflow, they should be able to find all relevant information in one location without having to navigate between multiple pages.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Documentation","language":"Other","updated":"2025-08-28","comments":9,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-consolidate-related-information.md"},{"slug":"workerd-document-compatibility-flags-comprehensively","title":"Document compatibility flags comprehensively","description":"All compatibility flags must include comprehensive documentation that clearly explains their purpose, behavior, timing, and relationships with other flags. This documentation should follow a consistent format and provide sufficient context for developers to understand the flag's impact.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Configurations","language":"Other","updated":"2025-08-28","comments":7,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-document-compatibility-flags-comprehensively.md"},{"slug":"mermaid-intentional-version-pinning","title":"Intentional Version Pinning","description":"When managing configuration via `package.json`/`tsconfig.json`, treat version and target specifiers as compatibility controls—not defaults. Choose constraints based on the dependency/toolchain’s real compatibility behavior, and wire compatibility between packages explicitly.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Configurations","language":"Json","updated":"2025-08-28","comments":6,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-intentional-version-pinning.md"},{"slug":"workerd-nodejs-api-compatibility","title":"Node.js API compatibility","description":"When implementing Node.js-compatible APIs, ensure exact behavioral matching with Node.js, including export structures, method signatures, return types, and property availability. This maintains compatibility with existing Node.js code and meets developer expectations.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"API","language":"TypeScript","updated":"2025-08-28","comments":6,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-nodejs-api-compatibility.md"},{"slug":"ant-design-extract-common-patterns","title":"Extract common patterns","description":"When you encounter repeated code patterns, conditional logic within loops, or similar implementations across components, extract them into reusable utilities or common styles. This improves maintainability, reduces bundle size, and makes the codebase more consistent.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2025-08-28","comments":5,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-extract-common-patterns.md"},{"slug":"litellm-prefer-generic-api-patterns","title":"Prefer generic API patterns","description":"Avoid creating provider-specific API implementations when generic, reusable solutions exist or can be developed. This principle improves code maintainability, reduces duplication, and ensures consistency across the API surface.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"API","language":"Python","updated":"2025-08-28","comments":5,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-prefer-generic-api-patterns.md"},{"slug":"workerd-compatibility-flag-consistency","title":"compatibility flag consistency","description":"Ensure compatibility flags follow consistent naming conventions, use explicit typing, and maintain proper usage patterns throughout the codebase. Compatibility flags should use descriptive, version-specific names that accurately reflect their purpose and lifecycle.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Configurations","language":"TypeScript","updated":"2025-08-28","comments":5,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-compatibility-flag-consistency.md"},{"slug":"workers-sdk-jsdoc-documentation-standards","title":"JSDoc documentation standards","description":"All public functions and complex code should have proper JSDoc documentation. Functions must include clear descriptions of their purpose, parameters, and return values. Ensure JSDoc comments are accurate, well-formatted, and kept up-to-date with code changes.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Documentation","language":"TypeScript","updated":"2025-08-28","comments":5,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-jsdoc-documentation-standards.md"},{"slug":"langflow-prevent-code-injection-vulnerabilities","title":"Prevent code injection vulnerabilities","description":"When evaluating user-provided code or handling dynamic content, implement strict security measures to prevent malicious code execution and unauthorized access. This includes whitelisting allowed modules/imports, validating input integrity, and properly handling sensitive data.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Security","language":"Python","updated":"2025-08-28","comments":4,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-prevent-code-injection-vulnerabilities.md"},{"slug":"signoz-rest-api-conventions","title":"REST API conventions","description":"Follow standard REST API conventions for HTTP methods, status codes, endpoint structure, and response completeness. Use appropriate access controls and implement proper pagination patterns.","repository":"SigNoz/signoz","domain":"observability","topic":"API","language":"Go","updated":"2025-08-28","comments":4,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-rest-api-conventions.md"},{"slug":"union-avoid-error-display-duplication","title":"avoid error display duplication","description":"When using thiserror for error handling, avoid displaying source errors in both the error message and the source attribute, as this creates duplicated error messages when printing the full error trace.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Error Handling","language":"Rust","updated":"2025-08-28","comments":3,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-avoid-error-display-duplication.md"},{"slug":"dify-offload-heavy-operations","title":"Offload heavy operations","description":"Move heavy operations, especially those involving large data processing or bulk deletions, from synchronous request handlers to asynchronous Celery tasks. This prevents request timeouts, improves user experience, and allows for better resource management.","repository":"langgenius/dify","domain":"llm-infra","topic":"Celery","language":"Python","updated":"2025-08-28","comments":2,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-offload-heavy-operations.md"},{"slug":"langflow-precise-workflow-conditions","title":"precise workflow conditions","description":"When implementing conditional logic in CI workflows, ensure boolean expressions are precise and comprehensive to avoid unintended workflow execution or bypassing. Use multiple filter conditions combined with logical operators to create accurate triggers based on file changes.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"CI/CD","language":"Yaml","updated":"2025-08-28","comments":2,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-precise-workflow-conditions.md"},{"slug":"workers-sdk-respect-automated-tooling","title":"Respect automated tooling","description":"Avoid manually updating files or configurations that are managed by automated CI/CD tools. Many modern development workflows rely on automated systems like dependabot for dependency updates, changesets for version management, and other tools for consistent builds and releases.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"CI/CD","language":"Json","updated":"2025-08-28","comments":2,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-respect-automated-tooling.md"},{"slug":"supermemory-avoid-direct-web-fonts","title":"Avoid direct web fonts","description":"In security-sensitive or privileged contexts like browser extensions, avoid directly loading fonts (or other static assets) from arbitrary remote URLs at runtime. Remote loading can break due to CORS and may create long-term reliability/security-review issues.","repository":"supermemoryai/supermemory","domain":"security","topic":"Security","language":"Other","updated":"2025-08-28","comments":1,"stars":28844,"raw":"https://awesomereviewers.com/raw/supermemory-avoid-direct-web-fonts.md"},{"slug":"bazel-use-descriptive-unambiguous-names","title":"Use descriptive, unambiguous names","description":"Choose names that clearly communicate their purpose and avoid ambiguity or misinterpretation. Names should be self-documenting and consider what developers will wonder about at the call site.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Naming Conventions","language":"Java","updated":"2025-08-27","comments":15,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-use-descriptive-unambiguous-names.md"},{"slug":"workers-sdk-configuration-validation-messages","title":"Configuration validation messages","description":"Ensure configuration validation provides clear, actionable error messages that guide users toward correct configuration. Validation should be comprehensive, checking not only types but also value ranges, logical consistency, and edge cases like undefined vs explicitly set values.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Configurations","language":"TypeScript","updated":"2025-08-27","comments":13,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-configuration-validation-messages.md"},{"slug":"volcano-optimize-algorithmic-efficiency","title":"Optimize algorithmic efficiency","description":"Choose efficient algorithms and data structures to minimize computational overhead and improve code maintainability. Prefer positive logic over elimination methods, reuse existing data structures instead of creating new ones, and extract common algorithmic patterns into shared functions.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Algorithms","language":"Go","updated":"2025-08-27","comments":11,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-optimize-algorithmic-efficiency.md"},{"slug":"workerd-prioritize-code-clarity","title":"prioritize code clarity","description":"Write code that prioritizes readability and clarity over minor optimizations or clever shortcuts. When faced with choices between concise but obscure code and more explicit but readable code, choose readability.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Code Style","language":"Other","updated":"2025-08-27","comments":10,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-prioritize-code-clarity.md"},{"slug":"mono-prioritize-code-readability","title":"prioritize code readability","description":"Write code that prioritizes clarity and readability over cleverness or brevity. This includes several key practices: **Extract static functions**: Move functions that don''t depend on component state outside the component to reduce complexity and make their static nature clear.","repository":"rocicorp/mono","domain":"data-systems","topic":"Code Style","language":"TSX","updated":"2025-08-27","comments":7,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-prioritize-code-readability.md"},{"slug":"serena-language-agnostic-configuration-design","title":"Language-agnostic configuration design","description":"Design configuration parameters to be language-agnostic when possible, use established configuration objects, and maintain consistency across language server implementations. Avoid language-specific CLI options or constructor parameters when the functionality could apply broadly.","repository":"oraios/serena","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2025-08-27","comments":7,"stars":14465,"raw":"https://awesomereviewers.com/raw/serena-language-agnostic-configuration-design.md"},{"slug":"union-validate-production-configurations","title":"Validate production configurations","description":"Always validate configuration values and ensure production safety by avoiding hardcoded values, implementing proper defaults, and requiring explicit configuration for production-critical settings. Configuration should be validated at runtime to prevent deployment of incorrect values.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Configurations","language":"Other","updated":"2025-08-27","comments":6,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-validate-production-configurations.md"},{"slug":"better-auth-prefer-simple-solutions","title":"Prefer simple solutions","description":"Choose existing utilities, simpler patterns, and cleaner implementations over manual or complex approaches. This improves code maintainability and reduces potential bugs.","repository":"better-auth/better-auth","domain":"security","topic":"Code Style","language":"TypeScript","updated":"2025-08-27","comments":5,"stars":19651,"raw":"https://awesomereviewers.com/raw/better-auth-prefer-simple-solutions.md"},{"slug":"flutter-make-errors-explicit","title":"Make errors explicit","description":"Always make error conditions explicit and visible rather than hiding them through silent failures, default return values, or unchecked operations. This includes validating results before use, using assertions for invalid states, and logging unexpected conditions.","repository":"flutter/flutter","domain":"app-frameworks","topic":"Error Handling","language":"Other","updated":"2025-08-27","comments":4,"stars":172252,"raw":"https://awesomereviewers.com/raw/flutter-make-errors-explicit.md"},{"slug":"langflow-ai-model-chunk-sizing","title":"AI model chunk sizing","description":"When configuring text processing components that work with AI embedding models, proactively consider tokenization limits and chunk size constraints. Many embedding models have practical token limits that are lower than their theoretical maximums, and text splitting components may not enforce exact chunk sizes.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"AI","language":"Other","updated":"2025-08-27","comments":4,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-ai-model-chunk-sizing.md"},{"slug":"teleport-synchronization-primitive-selection","title":"Synchronization primitive selection","description":"Choose appropriate synchronization primitives and ensure proper protection of shared state to avoid race conditions and deadlocks. Prefer regular mutexes over RWMutex unless read-heavy workloads justify the complexity, as RWMutex can be a performance trap. When accessing shared state, ensure the entire read-modify-write operation is atomic by keeping it...","repository":"gravitational/teleport","domain":"security","topic":"Concurrency","language":"Go","updated":"2025-08-27","comments":4,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-synchronization-primitive-selection.md"},{"slug":"union-workspace-dependency-consistency","title":"workspace dependency consistency","description":"All internal project dependencies should use workspace configuration instead of direct path or git references to ensure consistent versioning and build behavior across the monorepo. Maintain the standard `{ workspace = true }` syntax format and avoid redundant configuration options when using workspace dependencies.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Configurations","language":"Toml","updated":"2025-08-27","comments":4,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-workspace-dependency-consistency.md"},{"slug":"ant-design-avoid-unnecessary-memoization","title":"Avoid unnecessary memoization","description":"Memoization (useMemo, useCallback, React.memo) should only be used when the performance benefits outweigh the overhead costs. Avoid memoization in these scenarios:","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Performance Optimization","language":"TSX","updated":"2025-08-27","comments":3,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-avoid-unnecessary-memoization.md"},{"slug":"bazel-avoid-eager-cache-invalidation","title":"Avoid eager cache invalidation","description":"Resist the urge to eagerly invalidate cache entries unless you have definitive proof that the cached data is invalid and cannot provide value for future operations. Cache entries can still be valuable even when their associated remote artifacts have expired or been removed.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Caching","language":"Java","updated":"2025-08-27","comments":3,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-avoid-eager-cache-invalidation.md"},{"slug":"better-auth-comprehensive-test-coverage","title":"comprehensive test coverage","description":"When adding new functionality, configuration options, or plugins, always include corresponding tests that verify the feature works as expected. Tests should comprehensively cover all aspects of the functionality, including input/output validation, data transformations, and edge cases. Additionally, structure tests as focused, single-responsibility test...","repository":"better-auth/better-auth","domain":"security","topic":"Testing","language":"TypeScript","updated":"2025-08-27","comments":3,"stars":19651,"raw":"https://awesomereviewers.com/raw/better-auth-comprehensive-test-coverage.md"},{"slug":"mono-optimize-react-performance-patterns","title":"Optimize React performance patterns","description":"Prioritize React performance by avoiding expensive operations and using proper React patterns. Key practices include: 1. **Avoid unnecessary exception throwing**: Exception dispatch is a slow operation in React 18. Instead of throwing promises directly, create helper functions to minimize performance impact:","repository":"rocicorp/mono","domain":"data-systems","topic":"React","language":"TSX","updated":"2025-08-27","comments":3,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-optimize-react-performance-patterns.md"},{"slug":"volcano-justify-default-enablement","title":"Justify default enablement","description":"When adding new configuration options, carefully consider whether features should be enabled by default. Require explicit justification for default enablement, weighing functionality benefits against compatibility risks and user impact.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Configurations","language":"Yaml","updated":"2025-08-27","comments":3,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-justify-default-enablement.md"},{"slug":"mono-api-parameter-design","title":"API parameter design","description":"When designing API functions and types, prioritize maintainability and extensibility through proper parameter and type design patterns. For functions with multiple parameters, especially multiple boolean flags, consolidate them into a single options object to improve readability and future extensibility. This prevents parameter lists from becoming unwieldy...","repository":"rocicorp/mono","domain":"data-systems","topic":"API","language":"TSX","updated":"2025-08-27","comments":2,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-api-parameter-design.md"},{"slug":"workerd-optimize-ci-resource-usage","title":"optimize CI resource usage","description":"Design CI workflows to maximize resource efficiency by reusing build artifacts across jobs whenever possible, while carefully evaluating when separate builds are truly necessary. Before creating duplicate build jobs, assess whether different compilation flags or configurations genuinely require separate builds, or if the same artifacts can be reused with...","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"CI/CD","language":"Yaml","updated":"2025-08-27","comments":2,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-optimize-ci-resource-usage.md"},{"slug":"angular-add-explanatory-comments","title":"Add explanatory comments","description":"Code should include explanatory comments when the purpose, behavior, or context is not immediately clear from reading the code itself. This is especially important for:","repository":"angular/angular","domain":"app-frameworks","topic":"Documentation","language":"TypeScript","updated":"2025-08-26","comments":5,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-add-explanatory-comments.md"},{"slug":"flutter-eliminate-redundant-operations","title":"Eliminate redundant operations","description":"Identify and remove unnecessary operations that impact performance, including redundant checks, duplicate calculations, unnecessary allocations, and redundant code paths. This is especially critical in hot paths like widget rebuilds, message handling, and frequently called methods.","repository":"flutter/flutter","domain":"app-frameworks","topic":"Performance Optimization","language":"Other","updated":"2025-08-26","comments":5,"stars":172252,"raw":"https://awesomereviewers.com/raw/flutter-eliminate-redundant-operations.md"},{"slug":"istio-api-compatibility-preservation","title":"API compatibility preservation","description":"When evolving APIs, prioritize backward compatibility and avoid changing the semantics of existing fields. Instead of overloading existing fields with new meanings, introduce new fields to maintain compatibility with existing usage patterns.","repository":"istio/istio","domain":"orchestration","topic":"API","language":"Go","updated":"2025-08-26","comments":5,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-api-compatibility-preservation.md"},{"slug":"parlant-llm-provider-abstraction","title":"LLM provider abstraction","description":"When integrating with different LLM providers, create proper base class abstractions that filter and validate parameters based on each provider's capabilities. Follow established architectural patterns rather than creating custom configuration approaches.","repository":"emcie-co/parlant","domain":"ai-agents","topic":"AI","language":"Python","updated":"2025-08-26","comments":5,"stars":12205,"raw":"https://awesomereviewers.com/raw/parlant-llm-provider-abstraction.md"},{"slug":"workerd-proper-span-lifecycle-management","title":"proper span lifecycle management","description":"Ensure spans are properly created, attached to async operations, and reported at appropriate times to maintain accurate tracing data. Spans that are not properly managed will result in incorrect durations, missing trace data, or unreliable observability metrics.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Observability","language":"Other","updated":"2025-08-26","comments":5,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-proper-span-lifecycle-management.md"},{"slug":"lobe-chat-use-idempotent-migrations","title":"Use idempotent migrations","description":"Always use defensive programming patterns in migration scripts to ensure they can be executed multiple times without errors. This prevents failures during re-execution scenarios and makes migrations more robust.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Migrations","language":"Sql","updated":"2025-08-26","comments":4,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-use-idempotent-migrations.md"},{"slug":"parlant-safe-environment-variable-access","title":"safe environment variable access","description":"Always use `os.environ.get()` with appropriate defaults instead of direct dictionary access to prevent KeyError exceptions when environment variables are not set. Additionally, extract configuration constants and magic numbers to named module-level variables for better maintainability and consistency.","repository":"emcie-co/parlant","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2025-08-26","comments":4,"stars":12205,"raw":"https://awesomereviewers.com/raw/parlant-safe-environment-variable-access.md"},{"slug":"signoz-ensure-migration-idempotency","title":"ensure migration idempotency","description":"Database migrations must be designed to run safely multiple times without causing errors or data corruption. This involves using structured migration APIs instead of raw SQL, implementing proper checks for existing state, and avoiding unnecessary complexity that could lead to failures.","repository":"SigNoz/signoz","domain":"observability","topic":"Migrations","language":"Go","updated":"2025-08-26","comments":4,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-ensure-migration-idempotency.md"},{"slug":"flutter-thread-safety-synchronization","title":"Thread safety synchronization","description":"Ensure proper synchronization when accessing shared data structures and coordinate operations across multiple threads to prevent race conditions. **Key practices:**","repository":"flutter/flutter","domain":"app-frameworks","topic":"Concurrency","language":"Other","updated":"2025-08-26","comments":3,"stars":172252,"raw":"https://awesomereviewers.com/raw/flutter-thread-safety-synchronization.md"},{"slug":"lobe-chat-simplify-error-flows","title":"Simplify error flows","description":"Avoid complex, multi-layered error handling that obscures error origins and makes debugging difficult. Each error should be handled at the most appropriate level without unnecessary re-parsing or nested try-catch blocks.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2025-08-26","comments":3,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-simplify-error-flows.md"},{"slug":"opencode-avoid-hardcoded-configuration-values","title":"avoid hardcoded configuration values","description":"Configuration values such as URLs, endpoints, timeouts, and environment-specific settings should never be hardcoded in source code. Instead, they should be read from configuration files, environment variables, or other configurable sources to ensure flexibility across different environments and deployments.","repository":"sst/opencode","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-08-26","comments":3,"stars":28213,"raw":"https://awesomereviewers.com/raw/opencode-avoid-hardcoded-configuration-values.md"},{"slug":"teleport-provide-contextual-error-messages","title":"Provide contextual error messages","description":"Error messages should be specific, contextual, and use appropriate error creation functions to help users understand what went wrong and how to fix it.","repository":"gravitational/teleport","domain":"security","topic":"Error Handling","language":"Go","updated":"2025-08-26","comments":3,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-provide-contextual-error-messages.md"},{"slug":"hyperswitch-minimize-api-test-data","title":"Minimize API test data","description":"Keep API test configurations lean by including only the fields necessary for the specific test scenario. Avoid bloated request/response objects that contain extraneous data, and resist creating duplicate API test patterns when existing ones can be reused.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"API","language":"JavaScript","updated":"2025-08-26","comments":2,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-minimize-api-test-data.md"},{"slug":"teleport-design-comprehensive-metrics","title":"Design comprehensive metrics","description":"When designing observability metrics, ensure they are explicit about all possible states, comprehensive in scope, and clearly documented to avoid ambiguity. Metrics should accurately represent what is being monitored and make their limitations transparent.","repository":"gravitational/teleport","domain":"security","topic":"Observability","language":"Markdown","updated":"2025-08-26","comments":2,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-design-comprehensive-metrics.md"},{"slug":"sglang-improve-code-organization","title":"Improve code organization","description":"Prioritize clean code structure and readability in AI/ML codebases by avoiding inline conditionals, using descriptive expressions, and maintaining proper separation of concerns. This is especially important in machine learning systems where complex logic can quickly become unmaintainable.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"AI","language":"Python","updated":"2025-08-25","comments":11,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-improve-code-organization.md"},{"slug":"zod-centralize-complex-regex","title":"Centralize Complex Regex","description":"When adding validation logic that uses complex literals (especially RegExp), keep it consistent and maintainable: - Don’t scatter regex literals inline across files/branches—move them to a shared constant block near other related regexes.","repository":"colinhacks/zod","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2025-08-25","comments":7,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-centralize-complex-regex.md"},{"slug":"goose-ai-model-configuration-consistency","title":"AI model configuration consistency","description":"Maintain consistent AI model metadata and configuration across all providers to prevent breaking changes and ensure reliable behavior. When adding new models or updating existing ones, always update corresponding token limits, default configurations, and provider mappings simultaneously.","repository":"block/goose","domain":"ai-agents","topic":"AI","language":"Rust","updated":"2025-08-25","comments":6,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-ai-model-configuration-consistency.md"},{"slug":"langflow-environment-variable-documentation","title":"Environment variable documentation","description":"Ensure comprehensive and accurate documentation of environment variables, including cross-references, auto-detection behavior, and deployment context. When documenting configuration options, always provide links to the environment variables page and specify the exact variable name. Include information about auto-detected variables that Langflow recognizes...","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Configurations","language":"Other","updated":"2025-08-25","comments":6,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-environment-variable-documentation.md"},{"slug":"workerd-minimize-memory-operations","title":"minimize memory operations","description":"Avoid unnecessary memory allocations, copies, and inefficient memory usage patterns that can impact performance. This includes several key practices:","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Performance Optimization","language":"Other","updated":"2025-08-25","comments":6,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-minimize-memory-operations.md"},{"slug":"discourse-validate-migration-data-comprehensively","title":"validate migration data comprehensively","description":"Migration scripts must thoroughly validate data conditions and handle edge cases to ensure reliable data transformation. Always check for data existence before applying operations, properly handle duplicate records, and avoid migrating calculated or derived fields.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Migrations","language":"Ruby","updated":"2025-08-25","comments":5,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-validate-migration-data-comprehensively.md"},{"slug":"cal.com-avoid-generic-naming","title":"Avoid generic naming","description":"Choose specific, descriptive names over generic ones for all identifiers including variables, functions, components, and test IDs. Generic names lack context and can cause confusion as the codebase grows. Names should clearly communicate their purpose and scope.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Naming Conventions","language":"TSX","updated":"2025-08-25","comments":4,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-avoid-generic-naming.md"},{"slug":"cal.com-provide-error-feedback","title":"Provide error feedback","description":"Always provide clear user feedback when errors occur or operations fail, rather than allowing silent failures or showing disabled UI without explanation. This includes detecting existing error states, preventing validation errors through input sanitization, and displaying appropriate messages for failed operations.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Error Handling","language":"TSX","updated":"2025-08-25","comments":4,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-provide-error-feedback.md"},{"slug":"cypress-prefer-existence-over-truthiness","title":"prefer existence over truthiness","description":"Use explicit existence checks instead of truthiness checks when dealing with object properties, null/undefined values, or when falsy values are valid data.","repository":"cypress-io/cypress","domain":"devtools","topic":"Null Handling","language":"TypeScript","updated":"2025-08-25","comments":4,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-prefer-existence-over-truthiness.md"},{"slug":"discourse-consistent-null-safety-patterns","title":"Consistent null safety patterns","description":"Apply null safety operators consistently throughout your code to prevent runtime errors and improve readability. Use the nullish coalescing operator (??) for default values, optional chaining (?.) for safe property access, and simplify null checks when semantically equivalent.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Null Handling","language":"JavaScript","updated":"2025-08-25","comments":4,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-consistent-null-safety-patterns.md"},{"slug":"angular-precise-build-targeting","title":"precise build targeting","description":"Build targets should use specific file patterns rather than broad globs to improve build performance, clarity, and maintainability. Avoid capturing unnecessary files that can lead to build system constraints and complexity.","repository":"angular/angular","domain":"app-frameworks","topic":"CI/CD","language":"Other","updated":"2025-08-25","comments":3,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-precise-build-targeting.md"},{"slug":"discourse-safe-configuration-access","title":"Safe configuration access","description":"Always verify configuration properties exist before accessing them to prevent runtime errors. Configuration settings may not be available depending on installed plugins, enabled features, or user preferences.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2025-08-25","comments":3,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-safe-configuration-access.md"},{"slug":"goose-default-least-permissive","title":"default least permissive","description":"When implementing security controls, always default to the most restrictive option and require explicit opt-in for more permissive behavior. This applies to authentication mechanisms, user permissions, and security scanning workflows.","repository":"block/goose","domain":"ai-agents","topic":"Security","language":"Rust","updated":"2025-08-25","comments":3,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-default-least-permissive.md"},{"slug":"langflow-eliminate-code-duplication","title":"eliminate code duplication","description":"Identify and eliminate duplicated code by extracting shared functionality to appropriate locations. When multiple components or code sections perform identical operations, consolidate the logic into a single, reusable location such as a parent component, utility function, or shared module.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Code Style","language":"TSX","updated":"2025-08-25","comments":3,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-eliminate-code-duplication.md"},{"slug":"router-algorithm-implementation-trade-offs","title":"algorithm implementation trade-offs","description":"When implementing algorithms, carefully evaluate trade-offs between built-in methods, custom implementations, and different algorithmic approaches. Consider factors like browser compatibility, performance characteristics, maintainability, and edge case handling.","repository":"TanStack/router","domain":"app-frameworks","topic":"Algorithms","language":"TypeScript","updated":"2025-08-25","comments":3,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-algorithm-implementation-trade-offs.md"},{"slug":"cal.com-centralize-workflow-scheduling","title":"Centralize workflow scheduling","description":"Avoid scattering workflow scheduling logic across multiple handlers. Instead, create dedicated service methods for different workflow contexts to improve maintainability and reduce duplication.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Temporal","language":"TypeScript","updated":"2025-08-25","comments":2,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-centralize-workflow-scheduling.md"},{"slug":"lobe-chat-protect-sensitive-data","title":"Protect sensitive data","description":"Always identify and properly protect sensitive data fields in your code. Sensitive information includes IP addresses, API keys, authentication tokens, personal identification data, and high-privilege credentials.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2025-08-24","comments":3,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-protect-sensitive-data.md"},{"slug":"signoz-api-payload-completeness","title":"API payload completeness","description":"Ensure all required fields are included in API payloads and handle special field cases properly to prevent runtime errors and data inconsistencies. Missing fields in API transformations can cause bugs and unexpected behavior. Always validate that essential fields like `aggregations`, `filter`, and `having` are properly passed through data transformations....","repository":"SigNoz/signoz","domain":"observability","topic":"API","language":"TypeScript","updated":"2025-08-24","comments":3,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-api-payload-completeness.md"},{"slug":"tree-sitter-avoid-unnecessary-option-operations","title":"avoid unnecessary Option operations","description":"When working with Option types, prefer efficient and safe access patterns over unnecessary operations. Use `.as_ref().unwrap()` instead of `.clone().unwrap()` to avoid unnecessary cloning when you only need a reference to the contained value. When possible, prefer safe alternatives like `to_string_lossy()` over `unwrap()`, or use early returns with the `?`...","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Null Handling","language":"Rust","updated":"2025-08-23","comments":7,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-avoid-unnecessary-option-operations.md"},{"slug":"tree-sitter-algorithm-and-data-optimization","title":"Algorithm and data optimization","description":"Choose efficient algorithms and appropriate data structures based on access patterns and computational requirements. Use built-in comparison methods like `cmp()` to avoid redundant checks, select data structures that match usage patterns (HashSet for lookups, Vec for iteration), and ensure algorithmic correctness by handling edge cases properly.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Algorithms","language":"Rust","updated":"2025-08-23","comments":6,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-algorithm-and-data-optimization.md"},{"slug":"goose-containerize-sensitive-workflows","title":"containerize sensitive workflows","description":"Use containerization to isolate operations that could access sensitive data, modify critical systems, or execute untrusted code. Containers provide a secure boundary that prevents workflows from affecting the host environment or accessing resources beyond their intended scope.","repository":"block/goose","domain":"ai-agents","topic":"CI/CD","language":"Markdown","updated":"2025-08-23","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-containerize-sensitive-workflows.md"},{"slug":"python-avoid-stray-commas","title":"Avoid stray commas","description":"When running linters/formatters in CI or scripts, keep command arguments syntactically precise and standardized—remove any stray or meaningless punctuation (like a standalone comma) and normalize whitespace so commands are unambiguous.","repository":"TheAlgorithms/Python","domain":"docs","topic":"Code Style","language":"Yaml","updated":"2025-08-23","comments":2,"stars":220912,"raw":"https://awesomereviewers.com/raw/python-avoid-stray-commas.md"},{"slug":"python-use-semantic-names","title":"Use semantic names","description":"Use intention-revealing, consistent, and unique names for CI workflow, jobs, and steps (avoid generic labels like `build`). Names should tell the reader what the unit actually does.","repository":"TheAlgorithms/Python","domain":"docs","topic":"Naming Conventions","language":"Yaml","updated":"2025-08-23","comments":2,"stars":220912,"raw":"https://awesomereviewers.com/raw/python-use-semantic-names.md"},{"slug":"workerd-format-observability-test-data","title":"Format observability test data","description":"When writing tests for observability systems (tracing, metrics, logging), structure test assertions to be easily readable and debuggable. Instead of placing complex JSON outputs or structured data on single lines, split them across multiple lines with proper formatting.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Observability","language":"JavaScript","updated":"2025-08-23","comments":2,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-format-observability-test-data.md"},{"slug":"discourse-use-descriptive-identifiers","title":"Use descriptive identifiers","description":"Choose names that clearly communicate purpose and reduce cognitive load for future readers. Avoid generic, abbreviated, or ambiguous identifiers in favor of self-documenting ones.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Naming Conventions","language":"Ruby","updated":"2025-08-22","comments":12,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-use-descriptive-identifiers.md"},{"slug":"sglang-eliminate-redundant-operations","title":"Eliminate redundant operations","description":"Avoid duplicate function calls, repeated tensor operations, and redundant computations that can significantly impact performance. Implement caching mechanisms for expensive operations and pre-allocate tensors when possible.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"Performance Optimization","language":"Python","updated":"2025-08-22","comments":8,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-eliminate-redundant-operations.md"},{"slug":"workerd-isolate-lock-safety","title":"isolate lock safety","description":"Always ensure proper isolate lock management and thread-safe access patterns when working with JavaScript contexts and cross-thread operations. Accessing JSG objects, IoContext, or V8 handles without holding the isolate lock leads to undefined behavior and crashes.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Concurrency","language":"Other","updated":"2025-08-22","comments":8,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-isolate-lock-safety.md"},{"slug":"workerd-prioritize-descriptive-naming","title":"Prioritize descriptive naming","description":"Choose clear, self-explanatory names that prioritize readability over brevity. Avoid abbreviations, obscure identifiers, and names that require domain knowledge to understand. Names should be immediately comprehensible to newcomers and future maintainers.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Naming Conventions","language":"Other","updated":"2025-08-22","comments":8,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-prioritize-descriptive-naming.md"},{"slug":"cypress-environment-variable-validation","title":"Environment variable validation","description":"Always validate environment variables with proper type checking, fallback values, and defensive handling to prevent runtime failures and unexpected behavior.","repository":"cypress-io/cypress","domain":"devtools","topic":"Configurations","language":"TypeScript","updated":"2025-08-22","comments":5,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-environment-variable-validation.md"},{"slug":"mermaid-options-based-api-design","title":"Options-Based API Design","description":"When designing/typing internal and public APIs, keep signatures tight and future-proof: - Don’t pass parameters you don’t use. If `config` isn’t needed, remove it from the function signature (or make it optional only where truly required).","repository":"mermaid-js/mermaid","domain":"devtools","topic":"API","language":"TypeScript","updated":"2025-08-22","comments":5,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-options-based-api-design.md"},{"slug":"novu-contextual-api-parameters","title":"contextual API parameters","description":"Design APIs to provide contextual information and adapt behavior based on current usage context. Pass context objects to callbacks, compute derived attributes based on state, and generate appropriate options dynamically.","repository":"novuhq/novu","domain":"app-frameworks","topic":"API","language":"TSX","updated":"2025-08-22","comments":5,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-contextual-api-parameters.md"},{"slug":"angular-choose-appropriate-algorithms","title":"Choose appropriate algorithms","description":"Select algorithms and data structures that match the problem domain and access patterns rather than using convenient but suboptimal approaches. For complex parsing tasks, use proper AST-based parsing instead of regex. Design data structures that align with how data will be accessed and modified.","repository":"angular/angular","domain":"app-frameworks","topic":"Algorithms","language":"TypeScript","updated":"2025-08-22","comments":4,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-choose-appropriate-algorithms.md"},{"slug":"cypress-meaningful-test-assertions","title":"meaningful test assertions","description":"Write tests that verify specific behavior and outcomes rather than relying on weak assertions like snapshots or generic checks. Tests should validate the actual functionality being tested, not just capture output or run without proper verification.","repository":"cypress-io/cypress","domain":"devtools","topic":"Testing","language":"TypeScript","updated":"2025-08-22","comments":4,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-meaningful-test-assertions.md"},{"slug":"flutter-test-observable-behavior","title":"Test observable behavior","description":"Focus on testing what users see and experience rather than internal implementation details. Tests should verify the actual behavior that matters to users, not how the code achieves that behavior internally.","repository":"flutter/flutter","domain":"app-frameworks","topic":"Testing","language":"Other","updated":"2025-08-22","comments":4,"stars":172252,"raw":"https://awesomereviewers.com/raw/flutter-test-observable-behavior.md"},{"slug":"ant-design-optimize-expensive-operations","title":"Optimize expensive operations","description":"Minimize performance impact of costly operations through strategic ordering, batching, and avoiding unnecessary work. Place cheaper conditional checks before expensive operations to enable early exits, batch DOM manipulations using requestAnimationFrame to reduce repaints, and ensure optimizations don't create additional computational overhead.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Performance Optimization","language":"TypeScript","updated":"2025-08-22","comments":3,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-optimize-expensive-operations.md"},{"slug":"cal.com-comprehensive-security-checks","title":"comprehensive security checks","description":"Ensure that security checks for authorization, authentication, and information disclosure are comprehensive and consistently applied across all contexts, rather than being conditional on specific scenarios or implementation details.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Security","language":"TSX","updated":"2025-08-22","comments":3,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-comprehensive-security-checks.md"},{"slug":"discourse-cache-expensive-operations","title":"Cache expensive operations","description":"Identify and eliminate duplicate computations by caching results of expensive operations. This includes memoizing method calls, avoiding redundant database queries, and caching computed values that are used multiple times.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Performance Optimization","language":"Ruby","updated":"2025-08-22","comments":3,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-cache-expensive-operations.md"},{"slug":"goose-optimize-hook-dependencies","title":"Optimize hook dependencies","description":"Understand React's built-in optimizations and avoid unnecessary dependencies in hook arrays. React guarantees that state setters maintain referential stability across re-renders, so they don't need to be included in dependency arrays. Similarly, ref objects themselves don't change - only their `.current` property does, and changes to `.current` don't...","repository":"block/goose","domain":"ai-agents","topic":"React","language":"TSX","updated":"2025-08-22","comments":3,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-optimize-hook-dependencies.md"},{"slug":"kilocode-api-header-management","title":"API header management","description":"Establish consistent patterns for handling headers in API clients to avoid duplication and ensure predictable behavior. When designing API client interfaces, clearly define header precedence rules and avoid setting headers in multiple locations unless absolutely necessary.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2025-08-22","comments":3,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-api-header-management.md"},{"slug":"openpilot-test-independence-design","title":"Test independence design","description":"Tests should be designed to be independent and avoid coupling to implementation details. Use public interfaces rather than accessing internal state, prefer mocked or fake data over external dependencies, and keep tests general rather than tightly coupled to specific implementations.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Testing","language":"Python","updated":"2025-08-22","comments":3,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-test-independence-design.md"},{"slug":"fiber-minimize-unsafe-reference-lifetime","title":"minimize unsafe reference lifetime","description":"When working with methods that return potentially unsafe references or data that could become invalid, pass the results directly to safety/copy methods rather than storing them in intermediate variables. This minimizes the lifetime of unsafe references and reduces the risk of using invalidated data.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Null Handling","language":"Markdown","updated":"2025-08-22","comments":2,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-minimize-unsafe-reference-lifetime.md"},{"slug":"flutter-manage-state-dependencies-properly","title":"Manage state dependencies properly","description":"Ensure components establish explicit dependencies when they need to react to external changes, and avoid state updates during build phases to prevent rendering conflicts.","repository":"flutter/flutter","domain":"app-frameworks","topic":"React","language":"Other","updated":"2025-08-22","comments":2,"stars":172252,"raw":"https://awesomereviewers.com/raw/flutter-manage-state-dependencies-properly.md"},{"slug":"goose-incremental-ci-development","title":"Incremental CI development","description":"Develop CI/CD workflows incrementally, starting with simpler versions and adding complexity gradually. This approach makes testing easier and reduces the risk of introducing breaking changes. When adding new steps or jobs, consider their performance impact and dependencies on other workflow components.","repository":"block/goose","domain":"ai-agents","topic":"CI/CD","language":"Yaml","updated":"2025-08-22","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-incremental-ci-development.md"},{"slug":"goose-use-established-logging-libraries","title":"Use established logging libraries","description":"Avoid using print statements (println!, eprintln!) or custom logging implementations for application logging. Instead, use established logging libraries like `tracing` that provide proper log levels, structured output, and configurable destinations.","repository":"block/goose","domain":"ai-agents","topic":"Logging","language":"Rust","updated":"2025-08-22","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-use-established-logging-libraries.md"},{"slug":"jj-github-actions-security-review","title":"GitHub Actions security review","description":"Always review GitHub Actions workflows for security implications before merging, particularly focusing on authentication mechanisms and credential handling. Understand what permissions like `id-token: write` grant and their potential attack vectors. Ensure secure defaults are explicitly configured, such as disabling credential persistence.","repository":"jj-vcs/jj","domain":"devtools","topic":"Security","language":"Yaml","updated":"2025-08-22","comments":2,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-github-actions-security-review.md"},{"slug":"jj-pin-actions-to-commits","title":"Pin actions to commits","description":"Use specific commit hashes instead of version tags when referencing GitHub Actions in CI/CD workflows. Version tags can be moved or updated, potentially introducing security vulnerabilities or breaking changes, while commit hashes are immutable and provide reproducible builds.","repository":"jj-vcs/jj","domain":"devtools","topic":"CI/CD","language":"Yaml","updated":"2025-08-22","comments":2,"stars":21171,"raw":"https://awesomereviewers.com/raw/jj-pin-actions-to-commits.md"},{"slug":"goose-inline-external-dependencies","title":"inline external dependencies","description":"For security-critical applications, prefer inlining external dependencies (JavaScript libraries, CSS frameworks) rather than loading them from CDNs or external sources at runtime. This approach eliminates risks from compromised external sources, network-based attacks, and supply chain vulnerabilities.","repository":"block/goose","domain":"ai-agents","topic":"Security","language":"Html","updated":"2025-08-22","comments":1,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-inline-external-dependencies.md"},{"slug":"angular-maintain-consistent-style","title":"maintain consistent style","description":"Ensure consistent application of coding style conventions throughout the codebase, including naming patterns, type usage, code organization, and formatting standards.","repository":"angular/angular","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2025-08-21","comments":12,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-maintain-consistent-style.md"},{"slug":"sglang-eliminate-code-duplication","title":"eliminate code duplication","description":"Actively identify and eliminate code duplication by extracting common patterns into reusable components. When you notice repeated code blocks, similar conditional logic, or duplicate class definitions, consolidate them through extraction techniques.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"Code Style","language":"Python","updated":"2025-08-21","comments":12,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-eliminate-code-duplication.md"},{"slug":"discourse-use-modern-null-handling","title":"Use modern null handling","description":"Leverage modern JavaScript operators and patterns for cleaner, more robust null and undefined handling. This improves code readability and reduces boilerplate while maintaining safety.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Null Handling","language":"Other","updated":"2025-08-21","comments":9,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-use-modern-null-handling.md"},{"slug":"ncnn-unrolled-simd-locality","title":"Unrolled SIMD Locality","description":"When optimizing hot kernels (SIMD/vectorized paths), remove avoidable overhead and improve locality: 1) Unroll small fixed-size tails (e.g., remainder=4)","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Performance Optimization","language":"C++","updated":"2025-08-21","comments":7,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-unrolled-simd-locality.md"},{"slug":"goose-avoid-panics-and-expects","title":"avoid panics and expects","description":"Replace panic-inducing operations like `.expect()` and `.unwrap()` with proper error handling that allows graceful recovery or controlled failure. Panics can crash entire applications and provide poor user experience, especially in server environments where \"it will kill goosed and it is all over.\"","repository":"block/goose","domain":"ai-agents","topic":"Error Handling","language":"Rust","updated":"2025-08-21","comments":6,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-avoid-panics-and-expects.md"},{"slug":"workerd-maintain-consistent-patterns","title":"maintain consistent patterns","description":"Ensure consistent coding patterns and approaches are used throughout the codebase, even when multiple valid alternatives exist. This improves code readability, reduces cognitive load for developers, and makes the codebase easier to maintain.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Code Style","language":"TypeScript","updated":"2025-08-21","comments":6,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-maintain-consistent-patterns.md"},{"slug":"workerd-prefer-higher-level-apis","title":"prefer higher-level APIs","description":"When designing APIs, prefer using higher-level abstractions and established patterns over direct low-level handle manipulation. This improves code maintainability, reduces complexity, and ensures consistency across the codebase.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"API","language":"Other","updated":"2025-08-21","comments":6,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-prefer-higher-level-apis.md"},{"slug":"angular-api-consistency-patterns","title":"API consistency patterns","description":"Ensure that similar APIs follow consistent patterns and conventions across the codebase. When designing or modifying APIs, maintain the same expressivity, return type patterns, and usage conventions as existing similar APIs.","repository":"angular/angular","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2025-08-21","comments":5,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-api-consistency-patterns.md"},{"slug":"mono-api-consistency-patterns","title":"API consistency patterns","description":"Maintain consistent patterns across similar APIs to improve developer experience and reduce cognitive overhead. When designing related APIs, use factory patterns for shared contexts, consistent parameter structures, and uniform return types.","repository":"rocicorp/mono","domain":"data-systems","topic":"API","language":"TypeScript","updated":"2025-08-21","comments":5,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-api-consistency-patterns.md"},{"slug":"discourse-api-parameter-clarity","title":"API parameter clarity","description":"Design API parameters with clear naming, structured formats, and intuitive interfaces that are easy for clients to use and maintain. Avoid complex string parsing, ambiguous parameter names, or structures that require clients to perform additional processing.","repository":"discourse/discourse","domain":"app-frameworks","topic":"API","language":"Ruby","updated":"2025-08-21","comments":4,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-api-parameter-clarity.md"},{"slug":"langflow-avoid-hardcoded-configuration-values","title":"Avoid hardcoded configuration values","description":"Replace hardcoded configuration values with configurable parameters to improve flexibility and maintainability. Hardcoded timeouts, domain strings, validation constraints, and operational parameters should be exposed as advanced inputs, environment variables, or settings.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2025-08-21","comments":4,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-avoid-hardcoded-configuration-values.md"},{"slug":"parlant-safe-null-access-patterns","title":"Safe null access patterns","description":"Always use safe access patterns to prevent runtime errors when dealing with potentially null or undefined values. Instead of direct access that can raise KeyError or IndexError, use defensive programming techniques.","repository":"emcie-co/parlant","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2025-08-21","comments":4,"stars":12205,"raw":"https://awesomereviewers.com/raw/parlant-safe-null-access-patterns.md"},{"slug":"sglang-verify-algorithmic-correctness","title":"Verify algorithmic correctness","description":"Ensure algorithmic implementations are correct before applying optimizations or complex conditional logic. This is especially critical for performance optimizations, computational complexity considerations, and batch processing logic where errors can have cascading effects.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"Algorithms","language":"Python","updated":"2025-08-21","comments":4,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-verify-algorithmic-correctness.md"},{"slug":"agents-use-definite-assignment-assertions","title":"Use definite assignment assertions","description":"When you're certain a value will be initialized but TypeScript can't infer this, use the definite assignment assertion operator (`!`) instead of `as any` or suppressing type errors. This maintains type safety while avoiding unnecessary null checks throughout your codebase.","repository":"cloudflare/agents","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2025-08-21","comments":3,"stars":2312,"raw":"https://awesomereviewers.com/raw/agents-use-definite-assignment-assertions.md"},{"slug":"ant-design-avoid-hardcoded-configuration-values","title":"Avoid hardcoded configuration values","description":"Replace hardcoded values in configuration code with design tokens, parameters, or configurable constants to ensure consistency and maintainability across the codebase.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2025-08-21","comments":3,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-avoid-hardcoded-configuration-values.md"},{"slug":"cal.com-avoid-hardcoded-configuration-values","title":"Avoid hardcoded configuration values","description":"Extract hardcoded configuration values into constants, environment variables, or function parameters to improve maintainability and flexibility. Magic numbers, provider names, file size limits, and other configuration values should not be embedded directly in business logic.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2025-08-21","comments":3,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-avoid-hardcoded-configuration-values.md"},{"slug":"cal.com-favor-component-composition","title":"Favor component composition","description":"Design components to be configurable through props rather than relying on external context like URL paths or modifying shared UI components directly. This approach improves reusability, maintainability, and reduces coupling between components and their usage contexts.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"React","language":"TSX","updated":"2025-08-21","comments":3,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-favor-component-composition.md"},{"slug":"angular-optimize-configuration-specificity","title":"Optimize configuration specificity","description":"Ensure configuration files use precise patterns and avoid redundant dependencies. Configuration specifications should be as specific as necessary to match their intended purpose, and unnecessary or duplicate entries should be removed to maintain clean, efficient configurations.","repository":"angular/angular","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2025-08-21","comments":2,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-optimize-configuration-specificity.md"},{"slug":"discourse-use-safe-navigation-operator","title":"Use safe navigation operator","description":"Prefer Ruby's safe navigation operator (`&.`) over explicit nil checks when calling methods on potentially nil objects. This approach makes code more readable, reduces boilerplate, and prevents NoMethodError exceptions in a clean, idiomatic way.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Null Handling","language":"Ruby","updated":"2025-08-21","comments":2,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-use-safe-navigation-operator.md"},{"slug":"firecrawl-optimize-frequent-operations","title":"optimize frequent operations","description":"Identify code paths that execute frequently and ensure they use performant, non-blocking solutions. Frequent operations should avoid expensive database queries, CPU-intensive synchronous processing, or anything that can block the event loop.","repository":"firecrawl/firecrawl","domain":"ai-agents","topic":"Performance Optimization","language":"TypeScript","updated":"2025-08-21","comments":2,"stars":54535,"raw":"https://awesomereviewers.com/raw/firecrawl-optimize-frequent-operations.md"},{"slug":"goose-validate-ipc-inputs","title":"validate IPC inputs","description":"Always validate and sanitize inputs to IPC handlers to prevent unauthorized access to system resources. Implement allowlists or blocklists for file system operations and maintain secure Electron configuration.","repository":"block/goose","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2025-08-21","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-validate-ipc-inputs.md"},{"slug":"langflow-avoid-internal-object-access","title":"avoid internal object access","description":"Avoid accessing internal object attributes like `__dict__` or using unpacking syntax when cleaner alternatives exist. Instead, prefer stable public methods or direct assignment patterns that don't couple to object internals.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2025-08-21","comments":2,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-avoid-internal-object-access.md"},{"slug":"langflow-database-session-lifecycle","title":"Database session lifecycle","description":"Ensure all database operations and access to database objects occur within the appropriate session scope. Database objects become invalid once their session is closed, leading to runtime errors when accessed later.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Database","language":"Python","updated":"2025-08-21","comments":2,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-database-session-lifecycle.md"},{"slug":"langflow-sanitize-trace-metadata","title":"sanitize trace metadata","description":"Always sanitize trace metadata and attributes before sending to observability platforms to ensure compatibility with OpenTelemetry attribute type restrictions. Complex objects, custom types, and non-primitive values should be converted to supported types (str, int, float, bool, None) or JSON strings to prevent warnings and ensure reliable trace data.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Observability","language":"Python","updated":"2025-08-21","comments":2,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-sanitize-trace-metadata.md"},{"slug":"langflow-validate-api-inputs-comprehensively","title":"validate API inputs comprehensively","description":"Ensure thorough validation of API inputs and outputs using robust validation techniques rather than simple string checks or partial validation. Use proper libraries for validation (like urllib.parse for URLs) and validate all required components, not just a subset.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"API","language":"Python","updated":"2025-08-21","comments":2,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-validate-api-inputs-comprehensively.md"},{"slug":"workerd-validate-post-manipulation-state","title":"validate post-manipulation state","description":"Always explicitly validate object state after performing manipulations that could potentially result in null or undefined values. This is especially critical when dealing with global objects, parsing operations, or any transformation that might leave objects in an unexpected state.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Null Handling","language":"JavaScript","updated":"2025-08-21","comments":2,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-validate-post-manipulation-state.md"},{"slug":"goose-eliminate-code-duplication","title":"eliminate code duplication","description":"Actively identify and eliminate code duplication by extracting repeated logic into reusable functions, using loops instead of repetitive code blocks, and consolidating similar implementations. When you find yourself copying and pasting code or writing nearly identical logic multiple times, refactor it into a shared function or use iteration patterns.","repository":"block/goose","domain":"ai-agents","topic":"Code Style","language":"Rust","updated":"2025-08-20","comments":9,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-eliminate-code-duplication.md"},{"slug":"volcano-extract-reusable-functions","title":"Extract reusable functions","description":"When you identify duplicate code blocks, complex logic that can be simplified, or functionality that doesn't belong in its current location, extract it into well-named, reusable functions. This improves code organization, reduces duplication, and enhances readability.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Code Style","language":"Go","updated":"2025-08-20","comments":9,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-extract-reusable-functions.md"},{"slug":"angular-consistent-null-handling-patterns","title":"consistent null handling patterns","description":"Use consistent and meaningful null/undefined handling patterns throughout your code. Prefer positive type guards over negated early returns, maintain consistency between null and undefined return types, and be careful with optional chaining semantics.","repository":"angular/angular","domain":"app-frameworks","topic":"Null Handling","language":"TypeScript","updated":"2025-08-20","comments":8,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-consistent-null-handling-patterns.md"},{"slug":"discourse-verify-authorization-explicitly","title":"verify authorization explicitly","description":"Always perform explicit authorization checks rather than assuming existing security controls are sufficient. Security vulnerabilities often arise from bypassed or missing permission verification, especially in edge cases like impersonation windows, controller action bypasses, or privilege escalation scenarios.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Security","language":"Ruby","updated":"2025-08-20","comments":8,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-verify-authorization-explicitly.md"},{"slug":"cal.com-select-specific-database-fields","title":"Select specific database fields","description":"Always explicitly select only the database fields you actually need instead of using broad includes or fetching entire objects. This practice significantly improves query performance, reduces memory usage, and minimizes data exposure.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Database","language":"TypeScript","updated":"2025-08-20","comments":6,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-select-specific-database-fields.md"},{"slug":"volcano-algorithm-explanation-clarity","title":"Algorithm explanation clarity","description":"When documenting algorithms, provide detailed explanations of the underlying logic with concrete examples and clear process flows. Abstract algorithmic descriptions should be accompanied by specific scenarios that illustrate how the algorithm behaves in practice.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Algorithms","language":"Markdown","updated":"2025-08-20","comments":6,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-algorithm-explanation-clarity.md"},{"slug":"ant-design-react-component-api-clarity","title":"React component API clarity","description":"Ensure React component APIs are well-designed with accurate TypeScript interfaces, clear documentation, and intuitive developer experience. This includes: (1) Using precise type definitions that match actual functionality, avoiding misleading exposed props from internal implementations, (2) Providing accurate property descriptions in documentation that...","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"React","language":"Markdown","updated":"2025-08-20","comments":5,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-react-component-api-clarity.md"},{"slug":"discourse-extract-duplicate-code","title":"Extract duplicate code","description":"When you notice repeated code patterns, logic blocks, or similar implementations across methods or classes, extract the common functionality into reusable methods or utilities. This improves maintainability, reduces bugs, and makes the codebase more consistent.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Code Style","language":"Ruby","updated":"2025-08-20","comments":5,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-extract-duplicate-code.md"},{"slug":"discourse-optimize-test-fixtures","title":"optimize test fixtures","description":"Use the `fab!` shorthand syntax for creating test fixtures and reuse fabricated objects across tests to improve performance and maintainability. The `fab!` method creates objects once per test context and reuses them, reducing database overhead compared to creating new objects for each test.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Testing","language":"Ruby","updated":"2025-08-20","comments":5,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-optimize-test-fixtures.md"},{"slug":"cal.com-optimize-iteration-patterns","title":"optimize iteration patterns","description":"Minimize computational complexity by optimizing iteration patterns and data processing flows. Apply early filtering when possible, but preserve data integrity when order or indexing matters.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Algorithms","language":"TypeScript","updated":"2025-08-20","comments":4,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-optimize-iteration-patterns.md"},{"slug":"goose-consolidate-api-parameters","title":"consolidate API parameters","description":"Prefer consolidating common configuration and parameters in API constructors or base methods rather than requiring multiple method calls, complex parameter passing, or external configuration loading. This reduces API surface area and makes interfaces easier to use for consumers.","repository":"block/goose","domain":"ai-agents","topic":"API","language":"Rust","updated":"2025-08-20","comments":4,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-consolidate-api-parameters.md"},{"slug":"serena-explicit-none-handling","title":"explicit None handling","description":"When operations cannot complete successfully or return meaningful results, explicitly return None rather than raising exceptions or using placeholder values. Document when None is expected and ensure consistent None handling throughout the codebase.","repository":"oraios/serena","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2025-08-20","comments":4,"stars":14465,"raw":"https://awesomereviewers.com/raw/serena-explicit-none-handling.md"},{"slug":"sglang-use-optional-types-safely","title":"Use Optional types safely","description":"Always use proper nullable type annotations and safe access patterns to prevent runtime errors from null/undefined values. Use `Optional[Type]` or `Union[None, Type]` for nullable parameters, employ safe dictionary access with `.get()`, and handle None values explicitly in operations.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"Null Handling","language":"Python","updated":"2025-08-20","comments":4,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-use-optional-types-safely.md"},{"slug":"workers-sdk-changeset-validation-standards","title":"changeset validation standards","description":"Establish comprehensive validation for changesets to ensure reliable release automation. Changesets are required for all releasable artifacts, including internal refactors, as they drive the release process. Implement validation to enforce proper changeset format, meaningful descriptions, and correct semantic versioning.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"CI/CD","language":"Markdown","updated":"2025-08-20","comments":4,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-changeset-validation-standards.md"},{"slug":"better-auth-api-consistency-standards","title":"API consistency standards","description":"Maintain consistent parameter formats and requirements across all API providers and endpoints. When documentation conflicts with implementation, resolve discrepancies to ensure alignment. Avoid breaking changes by designing API modifications as unions or optional parameters rather than replacing existing structures.","repository":"better-auth/better-auth","domain":"security","topic":"API","language":"Other","updated":"2025-08-20","comments":3,"stars":19651,"raw":"https://awesomereviewers.com/raw/better-auth-api-consistency-standards.md"},{"slug":"cal.com-contextual-error-responses","title":"Contextual error responses","description":"Choose error response strategies based on the error's origin, caller context, and downstream impact rather than blindly propagating upstream errors. Consider whether throwing a 5xx error will cause harmful retries or mislead about the actual source of the problem.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2025-08-20","comments":3,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-contextual-error-responses.md"},{"slug":"discourse-validate-configuration-dependencies","title":"Validate configuration dependencies","description":"Configuration settings often depend on other settings or external resources to function correctly. Always implement validation to check these dependencies and provide clear error messages when requirements are not met.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Configurations","language":"Yaml","updated":"2025-08-20","comments":3,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-validate-configuration-dependencies.md"},{"slug":"nx-use-proper-synchronization-primitives","title":"Use proper synchronization primitives","description":"When implementing concurrent operations, always use appropriate synchronization mechanisms and ensure all asynchronous code paths complete properly. This includes specifying explicit timing parameters, using efficient blocking primitives, and guaranteeing promise resolution in all execution branches.","repository":"nrwl/nx","domain":"devtools","topic":"Concurrency","language":"TypeScript","updated":"2025-08-20","comments":3,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-use-proper-synchronization-primitives.md"},{"slug":"better-auth-document-configuration-requirements","title":"Document configuration requirements","description":"Ensure that configuration requirements, dependencies, and options are clearly documented and communicated to users. When introducing features that require external configuration or have configurable behavior, explicitly state what must be configured and provide clear guidance on the implications of different settings.","repository":"better-auth/better-auth","domain":"security","topic":"Configurations","language":"Other","updated":"2025-08-20","comments":2,"stars":19651,"raw":"https://awesomereviewers.com/raw/better-auth-document-configuration-requirements.md"},{"slug":"flutter-use-named-constants","title":"Use named constants","description":"Replace hardcoded string literals and magic values with named constants to improve code maintainability and readability. This practice prevents typos, makes the code self-documenting, and provides a single source of truth when the same value is used in multiple places.","repository":"flutter/flutter","domain":"app-frameworks","topic":"Code Style","language":"Java","updated":"2025-08-20","comments":2,"stars":172252,"raw":"https://awesomereviewers.com/raw/flutter-use-named-constants.md"},{"slug":"goose-document-api-contracts","title":"Document API contracts","description":"Ensure all API interfaces have clearly documented contracts specifying expected request/response formats, data encoding standards, and return types. This prevents integration issues and enables reliable external consumption.","repository":"block/goose","domain":"ai-agents","topic":"API","language":"TSX","updated":"2025-08-20","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-document-api-contracts.md"},{"slug":"workerd-balance-configuration-automation-complexity","title":"Balance configuration automation complexity","description":"When implementing configuration management solutions, carefully weigh the benefits of automation against the complexity and maintenance burden it introduces. For infrequent configuration updates, prefer simple manual approaches over complex automated solutions that may break unexpectedly. For frequent updates or version-specific configurations, automation...","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Configurations","language":"Python","updated":"2025-08-20","comments":2,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-balance-configuration-automation-complexity.md"},{"slug":"lobe-chat-prevent-credential-exposure","title":"Prevent credential exposure","description":"Ensure that sensitive authentication data such as API keys, tokens, passwords, and other credentials are never exposed in documentation, client-side code, logs, or configuration files. This includes both preventing accidental inclusion in documentation and implementing proper secure handling in application code.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Security","language":"TSX","updated":"2025-08-20","comments":1,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-prevent-credential-exposure.md"},{"slug":"litellm-avoid-code-duplication","title":"Avoid code duplication","description":"Eliminate redundant code by leveraging existing utilities, extracting reusable helper functions, and organizing logic in appropriate modules. Before implementing new functionality, check if similar logic already exists in the codebase that can be reused or extended.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Code Style","language":"Python","updated":"2025-08-19","comments":15,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-avoid-code-duplication.md"},{"slug":"duckdb-use-descriptive-names","title":"Use descriptive names","description":"Names should be descriptive and unambiguous, clearly communicating their purpose and intent. Avoid abbreviations and ambiguous terms that could confuse readers about the actual functionality or data being represented.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Naming Conventions","language":"Other","updated":"2025-08-19","comments":11,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-use-descriptive-names.md"},{"slug":"clickhouse-validate-before-executing-operations","title":"validate before executing operations","description":"Always validate inputs and preconditions before executing database operations, and fail explicitly rather than silently ignoring invalid states or configurations. This prevents data corruption, ensures system consistency, and makes debugging easier.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Database","language":"C++","updated":"2025-08-19","comments":8,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-validate-before-executing-operations.md"},{"slug":"discourse-follow-established-naming-conventions","title":"Follow established naming conventions","description":"Ensure all identifiers follow the established naming conventions for the codebase and framework being used. This includes using native JavaScript private method syntax with `#` instead of underscore prefixes, following camelCase for JavaScript methods and variables, matching existing naming patterns for consistency, and avoiding deprecated naming...","repository":"discourse/discourse","domain":"app-frameworks","topic":"Naming Conventions","language":"Other","updated":"2025-08-19","comments":7,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-follow-established-naming-conventions.md"},{"slug":"better-auth-use-consistent-error-types","title":"Use consistent error types","description":"Always use the appropriate error classes and throwing mechanisms for consistent error handling across the codebase. Prefer `BetterAuthError` or `APIError` over generic `Error` classes, use `throw` instead of returning error responses in endpoints, and structure error codes consistently.","repository":"better-auth/better-auth","domain":"security","topic":"Error Handling","language":"TypeScript","updated":"2025-08-19","comments":6,"stars":19651,"raw":"https://awesomereviewers.com/raw/better-auth-use-consistent-error-types.md"},{"slug":"flutter-explicit-null-validation","title":"explicit null validation","description":"Always validate null values explicitly rather than using silent fallbacks or implicit handling. When null values are unexpected or could cause issues, use assertions or explicit checks to fail fast and provide clear error messages.","repository":"flutter/flutter","domain":"app-frameworks","topic":"Null Handling","language":"Other","updated":"2025-08-19","comments":6,"stars":172252,"raw":"https://awesomereviewers.com/raw/flutter-explicit-null-validation.md"},{"slug":"istio-return-errors-explicitly","title":"Return errors explicitly","description":"Functions should return errors explicitly to callers rather than terminating the program, hiding errors in boolean returns, or using implicit error handling. This allows higher-level code to make appropriate decisions about error handling, recovery, and program flow.","repository":"istio/istio","domain":"orchestration","topic":"Error Handling","language":"Go","updated":"2025-08-19","comments":6,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-return-errors-explicitly.md"},{"slug":"angular-ai-documentation-clarity","title":"AI documentation clarity","description":"Ensure AI-related documentation, comments, and explanations are clear, accurate, and well-structured. This includes fixing spelling errors, using precise terminology, adding necessary context about experimental features, and employing active voice for better readability.","repository":"angular/angular","domain":"app-frameworks","topic":"AI","language":"Markdown","updated":"2025-08-19","comments":5,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-ai-documentation-clarity.md"},{"slug":"cal.com-use-descriptive-identifiers","title":"Use descriptive identifiers","description":"Choose specific, descriptive names for variables, functions, and parameters that clearly communicate their purpose and content. Avoid generic terms that could be ambiguous or misleading.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2025-08-19","comments":5,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-use-descriptive-identifiers.md"},{"slug":"discourse-use-modern-syntax","title":"Use modern syntax","description":"Adopt modern JavaScript and Ember syntax patterns instead of legacy approaches to improve code readability and maintainability. Key modern patterns to use:","repository":"discourse/discourse","domain":"app-frameworks","topic":"Code Style","language":"Other","updated":"2025-08-19","comments":5,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-use-modern-syntax.md"},{"slug":"langflow-intentional-error-handling","title":"intentional error handling","description":"Make deliberate, context-appropriate decisions about error handling strategy rather than applying generic patterns. Consider whether each error scenario should fail fast, provide graceful degradation, or offer recovery options based on the specific business impact and user experience requirements.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2025-08-19","comments":5,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-intentional-error-handling.md"},{"slug":"mono-add-missing-test-coverage","title":"Add missing test coverage","description":"Identify and address gaps in test coverage by requesting specific tests for untested functionality. When reviewing code changes, look for new features, complex logic, or critical interactions that lack corresponding tests. Focus on testing type inference, component interactions, edge cases, and different code paths.","repository":"rocicorp/mono","domain":"data-systems","topic":"Testing","language":"TypeScript","updated":"2025-08-19","comments":5,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-add-missing-test-coverage.md"},{"slug":"posthog-eliminate-code-duplication","title":"eliminate code duplication","description":"Actively identify and eliminate code duplication in all its forms to improve maintainability and reduce bugs. This includes removing redundant conditional checks, extracting common functionality into reusable functions, and avoiding component or logic duplication.","repository":"PostHog/posthog","domain":"data-systems","topic":"Code Style","language":"TSX","updated":"2025-08-19","comments":5,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-eliminate-code-duplication.md"},{"slug":"posthog-api-response-standardization","title":"API response standardization","description":"Ensure API responses follow established patterns and use proper typing. Always use standardized response types like `PaginatedResponse` for paginated endpoints, avoid hardcoded union types for dynamic values that should be strings, and return fresh data from API responses rather than stale local data.","repository":"PostHog/posthog","domain":"data-systems","topic":"API","language":"TypeScript","updated":"2025-08-19","comments":4,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-api-response-standardization.md"},{"slug":"sglang-optimize-cache-performance","title":"Optimize cache performance","description":"Prioritize cache performance by leveraging proven optimization techniques and avoiding performance anti-patterns. Use standard caching decorators like @lru_cache for functions that benefit from memoization, implement zero-copy operations when moving data between cache layers, and avoid unnecessary operations that degrade performance.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"Caching","language":"Python","updated":"2025-08-19","comments":4,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-optimize-cache-performance.md"},{"slug":"ant-design-centralize-configuration-management","title":"Centralize configuration management","description":"Avoid duplicate configuration processing and keep configuration data properly centralized. When configuration utilities or hooks already exist, use them instead of manually processing the same data. Keep translations in locale files rather than embedding them directly in data structures, and prefer design tokens over hardcoded values for styling...","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Configurations","language":"TSX","updated":"2025-08-19","comments":3,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-centralize-configuration-management.md"},{"slug":"clickhouse-verify-database-state-changes","title":"Verify database state changes","description":"When testing database operations that modify schema, data, or metadata, always add comprehensive assertions to verify the expected state changes. Database operations often have side effects beyond the primary action, and tests should validate both the intended outcome and related system state.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Database","language":"Python","updated":"2025-08-19","comments":3,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-verify-database-state-changes.md"},{"slug":"dify-configuration-defaults-appropriateness","title":"Configuration defaults appropriateness","description":"Ensure configuration parameters have appropriate default values and avoid hardcoded or overly specific settings. Default values should be conservative and safe for production environments, while avoiding personal assignments or environment-specific assumptions.","repository":"langgenius/dify","domain":"llm-infra","topic":"Configurations","language":"Yaml","updated":"2025-08-19","comments":3,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-configuration-defaults-appropriateness.md"},{"slug":"discourse-prefer-css-custom-properties","title":"prefer CSS custom properties","description":"Use CSS custom properties (CSS variables) instead of hardcoded values for fonts, spacing, colors, and other design tokens. This improves maintainability, enables consistent theming, and makes design system changes easier to implement across the codebase.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Code Style","language":"Css","updated":"2025-08-19","comments":3,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-prefer-css-custom-properties.md"},{"slug":"goose-environment-aware-configuration-handling","title":"Environment-aware configuration handling","description":"Use environment variables to control application behavior and ensure configuration changes are properly synchronized between in-memory state and persistent storage. When configuration depends on environment context, check for relevant environment variables first before falling back to defaults.","repository":"block/goose","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-08-19","comments":3,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-environment-aware-configuration-handling.md"},{"slug":"sglang-environment-variable-best-practices","title":"Environment variable best practices","description":"Avoid reading environment variables directly in performance-critical code paths, especially during model forward passes or hot loops. Instead, read and cache environment variables during initialization or use dedicated helper functions for consistent handling.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"Configurations","language":"Python","updated":"2025-08-19","comments":3,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-environment-variable-best-practices.md"},{"slug":"workerd-centralize-error-handling","title":"Centralize error handling","description":"Consolidate error handling logic into central, unavoidable locations rather than scattering it across multiple functions or requiring manual setup. This prevents cases where error handling can be bypassed or forgotten.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Error Handling","language":"Python","updated":"2025-08-19","comments":3,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-centralize-error-handling.md"},{"slug":"dify-api-payload-structure","title":"API payload structure","description":"Design API request and response payloads to match their specific purpose rather than forcing them to conform to existing application types. When API payloads require different structures or optional fields compared to internal data models, create dedicated API-specific types instead of adding placeholder values or compromising type safety.","repository":"langgenius/dify","domain":"llm-infra","topic":"API","language":"TypeScript","updated":"2025-08-19","comments":2,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-api-payload-structure.md"},{"slug":"discourse-optimize-data-structure-choices","title":"optimize data structure choices","description":"Choose data structures that optimize for your access patterns and computational complexity requirements. When you need frequent membership testing or existence checking, prefer Set over Array to achieve O(1) lookup complexity instead of O(n) linear scanning.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Algorithms","language":"Ruby","updated":"2025-08-19","comments":2,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-optimize-data-structure-choices.md"},{"slug":"discourse-self-documenting-identifiers","title":"Self-documenting identifiers","description":"Choose names that are immediately understandable without requiring additional context, documentation lookup, or guessing. Identifiers should clearly communicate their purpose, units, and behavior to reduce cognitive load for developers.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Naming Conventions","language":"Yaml","updated":"2025-08-19","comments":2,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-self-documenting-identifiers.md"},{"slug":"goose-extract-duplicate-constants","title":"Extract duplicate constants","description":"Eliminate code duplication by extracting repeated values and components into well-organized constants. This applies at both the variable level (extracting duplicate literal values) and file level (separating reusable components).","repository":"block/goose","domain":"ai-agents","topic":"Code Style","language":"JavaScript","updated":"2025-08-19","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-extract-duplicate-constants.md"},{"slug":"mermaid-surface-failures-early","title":"surface failures early","description":"Make rendering/runtime failures observable instead of silently tolerated. Apply two concrete rules: 1) **Cover failure-prone inputs in tests**: when your code parses special syntaxes (e.g., `@{ ... }` blocks), add variations that stress spacing/quoting/formatting so broken input is exercised.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Error Handling","language":"JavaScript","updated":"2025-08-19","comments":2,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-surface-failures-early.md"},{"slug":"posthog-add-monitoring-metrics","title":"Add monitoring metrics","description":"Critical code paths, especially error handling and exception scenarios, should include metrics or counters to enable monitoring and alerting. This prevents systems from failing silently and provides visibility into system health.","repository":"PostHog/posthog","domain":"data-systems","topic":"Observability","language":"TypeScript","updated":"2025-08-19","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-add-monitoring-metrics.md"},{"slug":"posthog-configuration-naming-clarity","title":"Configuration naming clarity","description":"Ensure configuration variable names, display labels, and feature flag names accurately reflect their actual purpose and behavior. Misleading or outdated names create confusion for both developers and users, making the codebase harder to maintain and understand.","repository":"PostHog/posthog","domain":"data-systems","topic":"Configurations","language":"TSX","updated":"2025-08-19","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-configuration-naming-clarity.md"},{"slug":"posthog-leverage-framework-capabilities","title":"leverage framework capabilities","description":"Structure workflows and activities to take full advantage of the orchestration framework's built-in capabilities for fault tolerance, retries, and durable execution rather than implementing custom solutions.","repository":"PostHog/posthog","domain":"data-systems","topic":"Temporal","language":"Python","updated":"2025-08-19","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-leverage-framework-capabilities.md"},{"slug":"posthog-optimize-database-query-patterns","title":"Optimize database query patterns","description":"Avoid N+1 query problems and overly complex conditional SQL construction. When loading related data, prefer batch operations or dedicated endpoints that can fetch all required data in fewer queries. For conditional SQL parameters, consider using null values with database defaults instead of constructing different query strings.","repository":"PostHog/posthog","domain":"data-systems","topic":"Database","language":"TypeScript","updated":"2025-08-19","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-optimize-database-query-patterns.md"},{"slug":"posthog-test-edge-cases-comprehensively","title":"Test edge cases comprehensively","description":"Ensure your tests cover not just the happy path, but also edge cases, empty states, error conditions, and boundary scenarios. This includes testing with empty datasets, validating pagination logic, handling unusual input values, and verifying error handling behavior.","repository":"PostHog/posthog","domain":"data-systems","topic":"Testing","language":"Python","updated":"2025-08-19","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-test-edge-cases-comprehensively.md"},{"slug":"router-optimize-react-patterns","title":"Optimize React patterns","description":"Prefer derived values over state and use appropriate React hooks for better performance and cleaner code. When a value can be computed from existing state, props, or context, derive it instead of storing it in separate state. This reduces unnecessary re-renders and simplifies state management.","repository":"TanStack/router","domain":"app-frameworks","topic":"React","language":"TypeScript","updated":"2025-08-19","comments":2,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-optimize-react-patterns.md"},{"slug":"sglang-avoid-broad-exception-catching","title":"Avoid broad exception catching","description":"Avoid using overly broad exception handling like `except Exception` as it can mask specific errors and make debugging difficult. Instead, catch specific exception types when possible, or convert generic exceptions to more informative, specific error types with meaningful messages.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"Error Handling","language":"Python","updated":"2025-08-19","comments":2,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-avoid-broad-exception-catching.md"},{"slug":"discourse-enforce-consistent-sso-flows","title":"enforce consistent SSO flows","description":"When single sign-on (SSO) is enabled as the primary authentication mechanism, ensure all authentication entry points consistently redirect to the SSO endpoint without complex conditional logic. Avoid respecting secondary authentication parameters that could create inconsistent behavior or potential security gaps.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Security","language":"JavaScript","updated":"2025-08-19","comments":1,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-enforce-consistent-sso-flows.md"},{"slug":"istio-use-descriptive-names","title":"Use descriptive names","description":"Names should accurately reflect their actual functionality and behavior. Avoid misleading or vague identifiers that don't match what the code actually does.","repository":"istio/istio","domain":"orchestration","topic":"Naming Conventions","language":"Go","updated":"2025-08-18","comments":12,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-use-descriptive-names.md"},{"slug":"clickhouse-use-descriptive-semantic-names","title":"Use descriptive semantic names","description":"Names should accurately reflect their purpose, behavior, and semantic meaning to avoid confusion and improve code readability. Avoid misleading names that don't match the actual functionality or content.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Naming Conventions","language":"C++","updated":"2025-08-18","comments":11,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-use-descriptive-semantic-names.md"},{"slug":"posthog-use-descriptive-names","title":"Use descriptive names","description":"Choose names that clearly communicate purpose and accurately represent what they describe. Avoid ambiguous or misleading names that require additional context to understand.","repository":"PostHog/posthog","domain":"data-systems","topic":"Naming Conventions","language":"Python","updated":"2025-08-18","comments":9,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-use-descriptive-names.md"},{"slug":"bazel-prefer-simple-readable-code","title":"prefer simple readable code","description":"Favor simple, readable implementations over complex or overly abstracted solutions. This includes eliminating code duplication through better function design, simplifying complex expressions, and using standard library functions instead of custom helpers.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Code Style","language":"Other","updated":"2025-08-18","comments":7,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-prefer-simple-readable-code.md"},{"slug":"clickhouse-semantic-naming-accuracy","title":"semantic naming accuracy","description":"Ensure that method, variable, and class names accurately reflect their actual behavior, purpose, or content. Names should semantically match what they represent to prevent confusion and bugs.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Naming Conventions","language":"Other","updated":"2025-08-18","comments":7,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-semantic-naming-accuracy.md"},{"slug":"posthog-cache-invalidation-consistency","title":"Cache invalidation consistency","description":"Ensure comprehensive and consistent cache invalidation patterns across all models that affect cached data. Every model that can impact cached content must have proper invalidation signals, and cache keys should be designed to enable targeted busting without affecting unrelated data.","repository":"PostHog/posthog","domain":"data-systems","topic":"Caching","language":"Python","updated":"2025-08-18","comments":6,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-cache-invalidation-consistency.md"},{"slug":"router-api-parameter-design","title":"API parameter design","description":"Design API parameters thoughtfully by making them optional when appropriate, avoiding unnecessary required parameters, and maintaining backward compatibility when changing parameter signatures. Consider the actual usage patterns and avoid forcing users to provide parameters that have sensible defaults or aren't always needed.","repository":"TanStack/router","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2025-08-18","comments":6,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-api-parameter-design.md"},{"slug":"terminal-choose-efficient-data-structures","title":"Choose efficient data structures","description":"Select data structures and types that optimize for both memory usage and computational efficiency. Avoid unnecessary copies, use appropriately sized types, and consider the performance characteristics of your choices.","repository":"microsoft/terminal","domain":"devtools","topic":"Algorithms","language":"Other","updated":"2025-08-18","comments":6,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-choose-efficient-data-structures.md"},{"slug":"dify-configuration-value-types","title":"Configuration value types","description":"Ensure configuration values use appropriate types, avoid unnecessary Optional annotations, and maintain consistency in data formats and units. Key principles:","repository":"langgenius/dify","domain":"llm-infra","topic":"Configurations","language":"Python","updated":"2025-08-18","comments":5,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-configuration-value-types.md"},{"slug":"duckdb-validate-inputs-comprehensively","title":"validate inputs comprehensively","description":"Ensure thorough input validation and comprehensive edge case handling in database operations. This includes checking parameter validity, handling null inputs, testing boundary conditions, and covering all comparison operators or function variants.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Database","language":"C++","updated":"2025-08-18","comments":5,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-validate-inputs-comprehensively.md"},{"slug":"router-maintain-comprehensive-documentation","title":"Maintain comprehensive documentation","description":"When making code changes, ensure all relevant documentation is updated comprehensively across different formats and locations. This includes: 1. **JSDoc comments** for functions, especially internal APIs that need usage context","repository":"TanStack/router","domain":"app-frameworks","topic":"Documentation","language":"TypeScript","updated":"2025-08-18","comments":5,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-maintain-comprehensive-documentation.md"},{"slug":"workerd-network-resource-state-validation","title":"Network resource state validation","description":"Always validate the state of network resources (sockets, streams, connections) before performing operations to prevent errors, resource leaks, and ensure proper connection reuse.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Networking","language":"Other","updated":"2025-08-18","comments":5,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-network-resource-state-validation.md"},{"slug":"angular-async-resource-cleanup","title":"async resource cleanup","description":"Always ensure proper cleanup of asynchronous resources (subscriptions, timeouts, event listeners) to prevent memory leaks and race conditions. Use Angular's DestroyRef or similar lifecycle management patterns instead of manual cleanup.","repository":"angular/angular","domain":"app-frameworks","topic":"Concurrency","language":"TypeScript","updated":"2025-08-18","comments":4,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-async-resource-cleanup.md"},{"slug":"bazel-validate-feature-configurations","title":"validate feature configurations","description":"Always validate that required features are enabled before using feature-dependent functionality. Feature flags should be the primary condition for enabling code paths, not the presence of related data or parameters.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Configurations","language":"Other","updated":"2025-08-18","comments":4,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-validate-feature-configurations.md"},{"slug":"discourse-avoid-n1-queries","title":"Avoid N+1 queries","description":"Prevent N+1 query performance issues by batching database operations instead of making individual queries within loops. This is critical for application performance as each individual query adds significant overhead.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Database","language":"Ruby","updated":"2025-08-18","comments":4,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-avoid-n1-queries.md"},{"slug":"discourse-include-contextual-log-information","title":"Include contextual log information","description":"Log messages should include sufficient context to make them useful for debugging, monitoring, and audit trails. Include relevant entity IDs, operation details, and descriptive information that helps identify what was happening when the log entry was created.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Logging","language":"Ruby","updated":"2025-08-18","comments":4,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-include-contextual-log-information.md"},{"slug":"goose-user-focused-documentation-structure","title":"User-focused documentation structure","description":"Documentation should prioritize user needs and problems over technical implementation details. Start with the \"why\" - what problem does this solve and when would users need it? Provide clear use cases and benefits before diving into technical specifics.","repository":"block/goose","domain":"ai-agents","topic":"Documentation","language":"Markdown","updated":"2025-08-18","comments":4,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-user-focused-documentation-structure.md"},{"slug":"posthog-split-complex-migrations-incrementally","title":"Split complex migrations incrementally","description":"Break complex schema changes into multiple, sequential migrations to ensure deployment safety and proper data handling. Each migration should represent a single, atomic change that can succeed or fail independently.","repository":"PostHog/posthog","domain":"data-systems","topic":"Migrations","language":"Python","updated":"2025-08-18","comments":4,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-split-complex-migrations-incrementally.md"},{"slug":"agents-use-descriptive-names","title":"Use descriptive names","description":"Choose clear, descriptive names for variables, methods, types, and parameters that unambiguously convey their purpose and avoid conflicts. Prefer full words over abbreviations and ensure names are specific enough to prevent clashes with inherited or similar functionality.","repository":"cloudflare/agents","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2025-08-18","comments":3,"stars":2312,"raw":"https://awesomereviewers.com/raw/agents-use-descriptive-names.md"},{"slug":"bazel-explicit-null-checks","title":"explicit null checks","description":"Use explicit null/undefined checks instead of methods that silently handle missing values. When you expect a value to be present, use access patterns that will fail fast if the value is missing rather than returning default values or silently continuing.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Null Handling","language":"Other","updated":"2025-08-18","comments":3,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-explicit-null-checks.md"},{"slug":"clickhouse-documentation-completeness-standards","title":"Documentation completeness standards","description":"Ensure all documentation meets completeness and formatting standards. This includes: (1) Adding language specifications to all fenced code blocks to satisfy linting requirements, (2) Including deprecation notes with clear migration guidance when removing or replacing features, and (3) Following established documentation patterns and embedding guidelines.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Documentation","language":"Markdown","updated":"2025-08-18","comments":3,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-documentation-completeness-standards.md"},{"slug":"discourse-avoid-underscore-prefixes","title":"avoid underscore prefixes","description":"Do not use underscore prefixes (`_`) for private or internal methods and properties. The team consensus is to avoid this naming convention. Instead, use one of these alternatives:","repository":"discourse/discourse","domain":"app-frameworks","topic":"Naming Conventions","language":"JavaScript","updated":"2025-08-18","comments":3,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-avoid-underscore-prefixes.md"},{"slug":"signoz-use-descriptive-contextual-names","title":"Use descriptive contextual names","description":"Choose variable, method, and property names that clearly communicate their purpose and context to avoid confusion and misinterpretation. Names should be self-explanatory and specific enough that their meaning is unambiguous within their usage context.","repository":"SigNoz/signoz","domain":"observability","topic":"Naming Conventions","language":"TSX","updated":"2025-08-18","comments":3,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-use-descriptive-contextual-names.md"},{"slug":"workerd-use-kj-unwrap-or-pattern","title":"Use KJ_UNWRAP_OR pattern","description":"When handling potentially null values from functions like `tryParse()` or `tryCast()`, avoid the pattern of checking for null/none and then immediately using `KJ_ASSERT_NONNULL` or `JSG_REQUIRE_NONNULL`. This creates redundant checks that make code harder to read and understand.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Null Handling","language":"Other","updated":"2025-08-18","comments":3,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-use-kj-unwrap-or-pattern.md"},{"slug":"archon-include-api-version","title":"Include API Version","description":"When configuring client access to an external API, store the provider’s base endpoint as a fully-qualified URL that already includes the required API version (and defaults). Avoid splitting “base URL” and “version” in ways that can drift or be forgotten—make the endpoint unambiguous.","repository":"coleam00/Archon","domain":"ai-agents","topic":"API","language":"Other","updated":"2025-08-18","comments":2,"stars":21089,"raw":"https://awesomereviewers.com/raw/archon-include-api-version.md"},{"slug":"cal.com-ci-conditional-job-handling","title":"CI conditional job handling","description":"When implementing CI workflows with path-based filtering, ensure that conditional jobs don't inadvertently block PR merges when they don't execute. Maintain proper path filtering to run jobs only when relevant files change, but account for scenarios where filtered jobs are listed as required dependencies.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2025-08-18","comments":2,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-ci-conditional-job-handling.md"},{"slug":"clickhouse-comprehensive-database-testing","title":"Comprehensive database testing","description":"Database tests should verify both query execution and optimization behavior through comprehensive scenario coverage. When testing query optimizations, include EXPLAIN PLAN verification to ensure the optimizer produces expected execution plans. For database features like row policies or security constraints, test multiple scenarios including edge cases and...","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Database","language":"Sql","updated":"2025-08-18","comments":2,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-comprehensive-database-testing.md"},{"slug":"clickhouse-document-implementation-rationale","title":"Document implementation rationale","description":"When implementing networking or system-level functionality where multiple approaches exist, always document the rationale behind your implementation choice. This is especially critical when the chosen method may not be the most obvious one or when platform-specific considerations influence the decision.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Networking","language":"Other","updated":"2025-08-18","comments":2,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-document-implementation-rationale.md"},{"slug":"clickhouse-preserve-existing-environment-variables","title":"preserve existing environment variables","description":"When modifying environment variables in code, always preserve existing values by appending or merging rather than overwriting. This prevents breaking existing configurations that may have been set by the system, other tools, or previous code execution.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Configurations","language":"Python","updated":"2025-08-18","comments":2,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-preserve-existing-environment-variables.md"},{"slug":"discourse-control-event-propagation","title":"Control event propagation","description":"Prevent unintended network requests and interface conflicts by properly controlling event propagation in interactive elements. Use `event.stopImmediatePropagation()` when multiple event listeners on the same element or its ancestors could trigger conflicting network operations.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Networking","language":"JavaScript","updated":"2025-08-18","comments":2,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-control-event-propagation.md"},{"slug":"langflow-ensure-comprehensive-test-coverage","title":"Ensure comprehensive test coverage","description":"Always add test coverage for new functionality, especially when introducing integrations or services. Use mocks and patches when testing external dependencies. Additionally, configure coverage reporting to exclude irrelevant paths like legacy components, deactivated features, and test files themselves to maintain meaningful coverage metrics.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2025-08-18","comments":2,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-ensure-comprehensive-test-coverage.md"},{"slug":"nx-use-precise-terminology","title":"Use precise terminology","description":"Always use specific, accurate terminology rather than vague or generic terms when naming sections, referencing products, or writing documentation. Ensure grammatical correctness and technical precision in all naming contexts.","repository":"nrwl/nx","domain":"devtools","topic":"Naming Conventions","language":"Markdown","updated":"2025-08-18","comments":2,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-use-precise-terminology.md"},{"slug":"playwright-comprehensive-contextual-error-handling","title":"Comprehensive contextual error handling","description":"Implement thorough error handling that goes beyond basic logging and provides contextually accurate, actionable error messages. Error handling should include proper propagation, recovery mechanisms where appropriate, and messages that reflect the actual system state and available options.","repository":"microsoft/playwright","domain":"devtools","topic":"Error Handling","language":"Other","updated":"2025-08-18","comments":2,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-comprehensive-contextual-error-handling.md"},{"slug":"posthog-verify-error-handling-paths","title":"Verify error handling paths","description":"When implementing error handling logic, ensure that both the behavior and reasoning are clear, and that error paths are properly tested at appropriate levels. For methods that handle missing data, the default behavior should be explicitly documented and the method name should clearly indicate what the return value represents. For exception handling, verify...","repository":"PostHog/posthog","domain":"data-systems","topic":"Error Handling","language":"TypeScript","updated":"2025-08-18","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-verify-error-handling-paths.md"},{"slug":"router-break-complex-expressions","title":"break complex expressions","description":"Break down complex boolean expressions and conditions into well-named intermediate variables to improve code readability and maintainability. Instead of writing dense one-liners, use descriptive variable names that clearly communicate the intent of each condition.","repository":"TanStack/router","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2025-08-18","comments":2,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-break-complex-expressions.md"},{"slug":"clickhouse-document-authentication-precedence","title":"Document authentication precedence","description":"When implementing systems that support multiple authentication methods, always clearly document which authentication method takes precedence when multiple options are provided. This prevents security misconfigurations and ensures predictable behavior.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Security","language":"Markdown","updated":"2025-08-18","comments":1,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-document-authentication-precedence.md"},{"slug":"duckdb-eliminate-code-duplication","title":"Eliminate code duplication","description":"Actively identify and eliminate code duplication to improve maintainability and reduce the risk of inconsistent behavior. This includes several strategies:","repository":"duckdb/duckdb","domain":"data-systems","topic":"Code Style","language":"C++","updated":"2025-08-17","comments":9,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-eliminate-code-duplication.md"},{"slug":"clickhouse-validate-before-unsafe-operations","title":"Validate before unsafe operations","description":"Always validate values before performing operations that could result in undefined behavior, particularly dynamic casts and arithmetic on unsigned types that might underflow.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Null Handling","language":"C++","updated":"2025-08-17","comments":3,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-validate-before-unsafe-operations.md"},{"slug":"angular-comprehensive-test-coverage","title":"comprehensive test coverage","description":"Ensure test suites provide comprehensive coverage by including edge cases, different input scenarios, and all code paths. Tests should cover not just the happy path, but also boundary conditions, error cases, and various input combinations.","repository":"angular/angular","domain":"app-frameworks","topic":"Testing","language":"TypeScript","updated":"2025-08-16","comments":9,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-comprehensive-test-coverage.md"},{"slug":"discourse-improve-code-readability","title":"Improve code readability","description":"Structure code to match logical flow and extract intermediate variables to improve readability. When dealing with multiple discrete cases, prefer switch statements over if/else chains for better extensibility. Replace magic numbers with named constants for self-documentation.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Code Style","language":"JavaScript","updated":"2025-08-16","comments":5,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-improve-code-readability.md"},{"slug":"posthog-break-down-large-functions","title":"break down large functions","description":"Large functions that handle multiple responsibilities should be decomposed into smaller, focused functions to improve readability, maintainability, and facilitate code reviews.","repository":"PostHog/posthog","domain":"data-systems","topic":"Code Style","language":"Python","updated":"2025-08-16","comments":5,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-break-down-large-functions.md"},{"slug":"terminal-minimize-reference-counting-overhead","title":"Minimize reference counting overhead","description":"Avoid unnecessary reference counting operations that can impact performance, especially in frequently called code paths. Use move semantics, appropriate pointer types, and efficient parameter passing to reduce AddRef/Release churn.","repository":"microsoft/terminal","domain":"devtools","topic":"Performance Optimization","language":"Other","updated":"2025-08-16","comments":4,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-minimize-reference-counting-overhead.md"},{"slug":"opencode-ensure-naming-consistency","title":"Ensure naming consistency","description":"Maintain consistent naming for the same entities across different contexts including code, documentation, APIs, and external systems. When names must differ between contexts, implement fallback mechanisms to handle variations gracefully.","repository":"sst/opencode","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2025-08-16","comments":3,"stars":28213,"raw":"https://awesomereviewers.com/raw/opencode-ensure-naming-consistency.md"},{"slug":"kilocode-conditional-configuration-management","title":"Conditional configuration management","description":"Ensure configurations are conditional, context-aware, and resilient. Use feature flags to control functionality availability rather than instructing systems to avoid certain features. Implement proper fallbacks for missing configuration values and support backward compatibility when introducing new config formats.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-08-15","comments":8,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-conditional-configuration-management.md"},{"slug":"clickhouse-document-non-obvious-code","title":"Document non-obvious code","description":"Add explanatory comments for any code element that is not self-explanatory, including complex return types, method parameters, classes, and technical concepts that may not be familiar to all developers.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Documentation","language":"Other","updated":"2025-08-15","comments":7,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-document-non-obvious-code.md"},{"slug":"goose-avoid-environment-variable-proliferation","title":"avoid environment variable proliferation","description":"Prefer the consolidated config system over adding new environment variables. Environment variables should only be used for deployment-specific overrides, not as the primary configuration mechanism.","repository":"block/goose","domain":"ai-agents","topic":"Configurations","language":"Rust","updated":"2025-08-15","comments":6,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-avoid-environment-variable-proliferation.md"},{"slug":"goose-use-descriptive-identifiers","title":"Use descriptive identifiers","description":"Replace generic, ambiguous, or magic identifiers with descriptive, specific names that clearly communicate intent and avoid confusion. Key principles:","repository":"block/goose","domain":"ai-agents","topic":"Naming Conventions","language":"Rust","updated":"2025-08-15","comments":6,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-use-descriptive-identifiers.md"},{"slug":"kilocode-use-descriptive-names","title":"Use descriptive names","description":"Choose names that clearly communicate purpose, type, and intent rather than generic or ambiguous identifiers. Names should be self-documenting and help other developers understand what the code does without additional context.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2025-08-15","comments":6,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-use-descriptive-names.md"},{"slug":"cal.com-design-contextual-api-interfaces","title":"Design contextual API interfaces","description":"API interfaces should expose only relevant data and functionality based on context, configuration, and user requirements. This principle ensures efficient data transfer, cleaner interfaces, and appropriate user experiences.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"API","language":"TSX","updated":"2025-08-15","comments":5,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-design-contextual-api-interfaces.md"},{"slug":"clickhouse-database-schema-consistency","title":"Database schema consistency","description":"Ensure database operations maintain consistent behavior and ordering, especially in distributed systems. When working with data structures that affect schema representation or query results, prioritize deterministic ordering over performance optimizations to prevent schema mismatches and ensure reliable distributed operations.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Database","language":"Other","updated":"2025-08-15","comments":5,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-database-schema-consistency.md"},{"slug":"clickhouse-extract-common-patterns","title":"Extract common patterns","description":"Identify and extract repeated code patterns into reusable functions or methods to improve maintainability and reduce duplication. When you notice similar logic appearing in multiple places, create a common utility function or method that can be shared.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Code Style","language":"C++","updated":"2025-08-15","comments":5,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-extract-common-patterns.md"},{"slug":"opengrep-context-aware-algorithm-selection","title":"Context-aware algorithm selection","description":"Choose algorithms and data structures based on operational requirements and usage context rather than defaulting to familiar patterns. Consider factors like compilation timing, API constraints, and different execution contexts when making design decisions.","repository":"opengrep/opengrep","domain":"security","topic":"Algorithms","language":"Other","updated":"2025-08-15","comments":5,"stars":1546,"raw":"https://awesomereviewers.com/raw/opengrep-context-aware-algorithm-selection.md"},{"slug":"ant-design-use-semantic-naming","title":"Use semantic naming","description":"Choose semantic, non-redundant names that clearly express intent and context. Remove unnecessary prefixes when the context is already clear, use semantic design tokens instead of hardcoded values, and prefer precise type definitions over generic ones.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2025-08-15","comments":4,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-use-semantic-naming.md"},{"slug":"clickhouse-documentation-precision-standards","title":"Documentation precision standards","description":"Ensure API documentation uses precise type specifications, proper formatting, and clear language to improve developer understanding and usability. Key requirements:","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Documentation","language":"C++","updated":"2025-08-15","comments":4,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-documentation-precision-standards.md"},{"slug":"goose-handle-errors-intentionally","title":"Handle errors intentionally","description":"Avoid generic catch-all error handling that masks important failures. Instead, be selective about which errors to handle locally versus letting them bubble up to higher-level handlers. When you do handle errors locally, implement safe defaults and use robust parsing methods.","repository":"block/goose","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2025-08-15","comments":4,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-handle-errors-intentionally.md"},{"slug":"bazel-use-standard-api-abstractions","title":"Use standard API abstractions","description":"Prefer established, type-safe abstractions over primitive types or direct property access when designing APIs. This improves maintainability, enables future extensibility, and provides better developer experience.","repository":"bazelbuild/bazel","domain":"devtools","topic":"API","language":"Other","updated":"2025-08-15","comments":3,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-use-standard-api-abstractions.md"},{"slug":"clickhouse-document-mutex-responsibilities","title":"Document mutex responsibilities","description":"Use Thread Safety Analysis (TSA) annotations to explicitly document which mutexes protect which variables, making thread safety relationships clear to both static analyzers and code readers.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Concurrency","language":"Other","updated":"2025-08-15","comments":3,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-document-mutex-responsibilities.md"},{"slug":"opengrep-use-specific-descriptive-names","title":"Use specific descriptive names","description":"Choose names that clearly indicate the specific purpose, scope, or domain of functions, variables, and types rather than using generic terms. Generic names like `is_start`, `is_middle`, `enable_ignore` can be ambiguous and require readers to examine implementation details to understand their meaning.","repository":"opengrep/opengrep","domain":"security","topic":"Naming Conventions","language":"Other","updated":"2025-08-15","comments":3,"stars":1546,"raw":"https://awesomereviewers.com/raw/opengrep-use-specific-descriptive-names.md"},{"slug":"angular-guard-unsafe-api-calls","title":"Guard unsafe API calls","description":"Always check the availability or state of data before accessing potentially unsafe API methods that can throw runtime errors. Many Angular APIs provide guard methods to safely check state before accessing values.","repository":"angular/angular","domain":"app-frameworks","topic":"Error Handling","language":"Markdown","updated":"2025-08-15","comments":2,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-guard-unsafe-api-calls.md"},{"slug":"discourse-avoid-dynamic-test-generation","title":"avoid dynamic test generation","description":"Avoid using loops (forEach, for, etc.) to dynamically generate tests from arrays or objects, as this pattern makes debugging significantly harder. When a test fails, it's difficult to set breakpoints on specific cases or identify which iteration caused the failure.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Testing","language":"Other","updated":"2025-08-15","comments":2,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-avoid-dynamic-test-generation.md"},{"slug":"nx-ensure-informative-log-messages","title":"Ensure informative log messages","description":"Log messages should be clear, informative, and include specific details to help users understand what is happening. Avoid vague messages that could cause confusion, and ensure proper stream handling to prevent garbled output in concurrent scenarios.","repository":"nrwl/nx","domain":"devtools","topic":"Logging","language":"TypeScript","updated":"2025-08-15","comments":2,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-ensure-informative-log-messages.md"},{"slug":"playwright-document-network-limitations","title":"Document network limitations","description":"When documenting network-related features, clearly specify compatibility constraints, browser limitations, and potential side effects. This is especially critical for experimental features or those with platform-specific restrictions.","repository":"microsoft/playwright","domain":"devtools","topic":"Networking","language":"Markdown","updated":"2025-08-15","comments":2,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-document-network-limitations.md"},{"slug":"playwright-python-syntax-consistency","title":"Python syntax consistency","description":"Ensure Python code follows proper naming conventions and syntax rules. Use snake_case for variable and parameter names instead of camelCase, and use capitalized boolean literals (True/False) instead of lowercase variants from other languages.","repository":"microsoft/playwright","domain":"devtools","topic":"Naming Conventions","language":"Markdown","updated":"2025-08-15","comments":2,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-python-syntax-consistency.md"},{"slug":"posthog-enrich-telemetry-context","title":"Enrich telemetry context","description":"Always include relevant contextual metadata when capturing telemetry data (events, exceptions, logs, metrics) to improve debugging and operational visibility. This includes user information, team ownership, product areas, IP addresses, user agents, geographic data, and other relevant context that helps with troubleshooting and error assignment.","repository":"PostHog/posthog","domain":"data-systems","topic":"Observability","language":"Python","updated":"2025-08-15","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-enrich-telemetry-context.md"},{"slug":"workerd-test-comprehensive-error-scenarios","title":"Test comprehensive error scenarios","description":"When implementing error handling, ensure comprehensive test coverage by testing multiple error scenarios, edge cases, and boundary conditions. Don't just test the happy path - validate that your code properly handles invalid inputs, out-of-range values, and error propagation.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Error Handling","language":"JavaScript","updated":"2025-08-15","comments":2,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-test-comprehensive-error-scenarios.md"},{"slug":"pr-agent-null-safe-defaults","title":"Null-safe Defaults","description":"When handling settings, parsed model outputs, and lookup results, assume values may be missing (None/empty), omitted, or of the wrong type. Prevent NoneType and KeyError crashes by applying a consistent null-safety pattern.","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2025-08-14","comments":10,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-null-safe-defaults.md"},{"slug":"dify-use-appropriate-log-levels","title":"Use appropriate log levels","description":"Choose the correct logging level based on the importance and purpose of the message. Use DEBUG for debugging information that's only useful during development, INFO for general operational information, WARNING for concerning conditions that don't prevent operation, and ERROR for actual errors. Remove meaningless debug prints and consider using conditional...","repository":"langgenius/dify","domain":"llm-infra","topic":"Logging","language":"Python","updated":"2025-08-14","comments":6,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-use-appropriate-log-levels.md"},{"slug":"istio-avoid-expensive-operations","title":"Avoid expensive operations","description":"Identify and eliminate computationally expensive operations in frequently executed code paths. Common expensive operations include repeated computations, unbounded API calls, inefficient string operations, and operations that don't scale with data size.","repository":"istio/istio","domain":"orchestration","topic":"Performance Optimization","language":"Go","updated":"2025-08-14","comments":6,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-avoid-expensive-operations.md"},{"slug":"ty-specify-algorithmic-scope-precisely","title":"Specify algorithmic scope precisely","description":"When documenting changes to algorithms, data structures, or computational approaches, explicitly identify the specific components affected rather than using vague or generic descriptions. This includes naming exact data structure classes, clarifying the scope and limitations of algorithmic improvements, and using precise technical terminology.","repository":"astral-sh/ty","domain":"devtools","topic":"Algorithms","language":"Markdown","updated":"2025-08-14","comments":6,"stars":11919,"raw":"https://awesomereviewers.com/raw/ty-specify-algorithmic-scope-precisely.md"},{"slug":"clickhouse-optimize-algorithmic-complexity","title":"optimize algorithmic complexity","description":"Always consider the algorithmic complexity and performance implications of data structure choices, memory allocation patterns, and container operations. This includes pre-allocating containers when sizes are known, choosing appropriate data structures based on usage patterns, and measuring performance impact of changes.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Algorithms","language":"C++","updated":"2025-08-14","comments":5,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-optimize-algorithmic-complexity.md"},{"slug":"cypress-configuration-documentation-clarity","title":"Configuration documentation clarity","description":"Ensure configuration documentation, setup instructions, and changelogs use precise, clear language with proper technical terminology. Avoid ambiguous words like \"sometimes\" or \"generally\" that create uncertainty. Use correct capitalization for technical terms (e.g., \"Node.js\" not \"Node\", \"CommonJS/ESM\" not \"commonjs/ESM\"). Remove redundant words and fix...","repository":"cypress-io/cypress","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2025-08-14","comments":5,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-configuration-documentation-clarity.md"},{"slug":"dspy-test-structure-and-clarity","title":"Test structure and clarity","description":"Organize tests for maximum clarity and maintainability by leveraging pytest features and proper test structure. Split complex tests into focused, single-purpose test cases rather than testing multiple scenarios in one function. Use pytest fixtures for setup and cleanup instead of manual resource management, and prefer parameterization for testing multiple...","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2025-08-14","comments":5,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-test-structure-and-clarity.md"},{"slug":"flutter-avoid-breaking-changes","title":"Avoid breaking changes","description":"When modifying existing APIs, prioritize backward compatibility to prevent breaking changes that would force developers to maintain separate code paths for different SDK versions. Use deprecation with clear migration paths instead of direct breaking changes, make new parameters optional with sensible defaults, and avoid changing existing default values.","repository":"flutter/flutter","domain":"app-frameworks","topic":"API","language":"Other","updated":"2025-08-14","comments":5,"stars":172252,"raw":"https://awesomereviewers.com/raw/flutter-avoid-breaking-changes.md"},{"slug":"istio-network-configuration-consistency","title":"network configuration consistency","description":"Ensure network-related configurations remain consistent across different components and avoid unintended overwrites that could break connectivity or security.","repository":"istio/istio","domain":"orchestration","topic":"Networking","language":"Go","updated":"2025-08-14","comments":5,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-network-configuration-consistency.md"},{"slug":"posthog-cache-expensive-operations","title":"Cache expensive operations","description":"Identify and eliminate redundant expensive operations by implementing caching, memoization, or conditional execution. Look for repeated database queries, complex calculations, object creation, or data processing that can be cached or avoided entirely when not needed.","repository":"PostHog/posthog","domain":"data-systems","topic":"Performance Optimization","language":"Python","updated":"2025-08-14","comments":5,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-cache-expensive-operations.md"},{"slug":"posthog-maintain-naming-consistency","title":"Maintain naming consistency","description":"Ensure consistent naming conventions, terminology, and identifiers across the entire codebase. Names should be uniform between frontend/backend, across different modules, and within the same domain.","repository":"PostHog/posthog","domain":"data-systems","topic":"Naming Conventions","language":"TSX","updated":"2025-08-14","comments":5,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-maintain-naming-consistency.md"},{"slug":"angular-choose-appropriate-presentation-formats","title":"Choose appropriate presentation formats","description":"Select the most effective format for presenting different types of information in documentation. Use tables for structured data with multiple attributes, step-by-step explanations for processes, and clear section organization to avoid duplication or confusion.","repository":"angular/angular","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-08-14","comments":4,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-choose-appropriate-presentation-formats.md"},{"slug":"duckdb-constructor-configuration-injection","title":"Constructor configuration injection","description":"Prefer injecting configuration objects through constructors rather than passing them as ad-hoc parameters or using global instances. This approach improves extensibility, reduces error-prone context passing, and enables per-instance customization.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Configurations","language":"Other","updated":"2025-08-14","comments":4,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-constructor-configuration-injection.md"},{"slug":"litellm-safe-operations-with-fallbacks","title":"Safe operations with fallbacks","description":"Implement defensive programming by wrapping potentially failing operations in safe methods that provide fallback behavior. Critical operations should never cause the main functionality to fail due to secondary concerns like formatting, logging, or auxiliary processing.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Error Handling","language":"Python","updated":"2025-08-14","comments":4,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-safe-operations-with-fallbacks.md"},{"slug":"posthog-check-existence-before-operations","title":"Check existence before operations","description":"Always verify that keys, IDs, indices, or other required values exist before performing operations that depend on them. This prevents runtime errors and unexpected behavior from null references or missing data.","repository":"PostHog/posthog","domain":"data-systems","topic":"Null Handling","language":"Python","updated":"2025-08-14","comments":4,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-check-existence-before-operations.md"},{"slug":"posthog-restful-endpoint-organization","title":"RESTful endpoint organization","description":"API endpoints should be properly organized around resources and follow RESTful principles. Avoid placing aggregation or utility endpoints in viewsets where they don't belong conceptually.","repository":"PostHog/posthog","domain":"data-systems","topic":"API","language":"Python","updated":"2025-08-14","comments":4,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-restful-endpoint-organization.md"},{"slug":"ty-api-documentation-clarity","title":"API documentation clarity","description":"Ensure API documentation, including changelogs and feature descriptions, prioritizes user understanding over implementation details. Write descriptions that explain what users can expect from the API behavior rather than how it's technically implemented. Avoid redundant information when context is already established (e.g., don't repeat \"language server...","repository":"astral-sh/ty","domain":"devtools","topic":"API","language":"Markdown","updated":"2025-08-14","comments":4,"stars":11919,"raw":"https://awesomereviewers.com/raw/ty-api-documentation-clarity.md"},{"slug":"cal.com-validate-business-logic-constraints","title":"validate business logic constraints","description":"Before adding database constraints or designing schema relationships, thoroughly understand the underlying business logic and data relationships. Constraints that seem logical at first glance may break existing functionality or prevent valid use cases.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Database","language":"Prisma","updated":"2025-08-14","comments":3,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-validate-business-logic-constraints.md"},{"slug":"dify-choose-descriptive-unambiguous-names","title":"Choose descriptive, unambiguous names","description":"Select variable, method, and property names that clearly communicate their purpose and avoid ambiguity. Prioritize semantic accuracy over brevity, and consider the context in which names will be used to prevent confusion.","repository":"langgenius/dify","domain":"llm-infra","topic":"Naming Conventions","language":"TypeScript","updated":"2025-08-14","comments":3,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-choose-descriptive-unambiguous-names.md"},{"slug":"posthog-optimize-data-loading","title":"optimize data loading","description":"Review data loading operations to ensure they are properly scoped, filtered, and batched to prevent performance issues. Large datasets should be handled with appropriate pagination, filtering by relevant criteria (like date ranges), and avoiding operations that could load excessive amounts of data into memory.","repository":"PostHog/posthog","domain":"data-systems","topic":"Performance Optimization","language":"TypeScript","updated":"2025-08-14","comments":3,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-optimize-data-loading.md"},{"slug":"posthog-test-complex-logic-thoroughly","title":"Test complex logic thoroughly","description":"When implementing complex business logic, state management, or algorithms with multiple edge cases, ensure comprehensive test coverage. Complex logic is prone to bugs and difficult to reason about during code review, making tests essential for maintainability and correctness.","repository":"PostHog/posthog","domain":"data-systems","topic":"Testing","language":"TypeScript","updated":"2025-08-14","comments":3,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-test-complex-logic-thoroughly.md"},{"slug":"clickhouse-write-focused-clear-tests","title":"Write focused, clear tests","description":"Tests should be simple, focused on a single concern, and easy to understand. When a test combines multiple potential failure conditions or verification points, split it into separate, focused test cases. Avoid over-engineering tests with unnecessary complexity.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Testing","language":"Sql","updated":"2025-08-14","comments":2,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-write-focused-clear-tests.md"},{"slug":"goose-use-configuration-enums","title":"Use configuration enums","description":"Replace hardcoded string matching and magic values with proper configuration enums or flags. This improves maintainability, reduces errors, and makes configuration behavior explicit and type-safe.","repository":"block/goose","domain":"ai-agents","topic":"Configurations","language":"TSX","updated":"2025-08-14","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-use-configuration-enums.md"},{"slug":"signoz-optimize-react-architecture","title":"Optimize React architecture","description":"Prefer direct hook usage over prop drilling and carefully consider context provider placement to maintain clean component architecture. When custom hooks are available, use them directly in components rather than passing their values through props. For context providers, aim for global placement when possible, but be mindful of routing and component...","repository":"SigNoz/signoz","domain":"observability","topic":"React","language":"TSX","updated":"2025-08-14","comments":2,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-optimize-react-architecture.md"},{"slug":"terminal-api-clarity-over-convenience","title":"API clarity over convenience","description":"When designing APIs, prioritize clarity and self-documentation over implementation convenience. Choose interface patterns that make the code's intent immediately obvious to consumers and debuggers.","repository":"microsoft/terminal","domain":"devtools","topic":"API","language":"Other","updated":"2025-08-14","comments":2,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-api-clarity-over-convenience.md"},{"slug":"workerd-ensure-test-cleanup","title":"ensure test cleanup","description":"Tests must properly clean up resources and handle conditional execution regardless of test outcome. This includes removing temporary files, resetting global state, and gracefully handling feature flag conditions.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Testing","language":"Other","updated":"2025-08-14","comments":2,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-ensure-test-cleanup.md"},{"slug":"clickhouse-avoid-unnecessary-allocations","title":"Avoid unnecessary allocations","description":"Minimize memory allocations, data copying, and expensive operations by implementing early exits, using move semantics, and choosing appropriate buffer management strategies.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Performance Optimization","language":"C++","updated":"2025-08-13","comments":11,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-avoid-unnecessary-allocations.md"},{"slug":"terminal-optimize-algorithmic-choices","title":"optimize algorithmic choices","description":"Choose efficient algorithms and data structures to improve performance and reduce computational overhead. This involves selecting appropriate containers, avoiding unnecessary operations, and leveraging language features for optimization.","repository":"microsoft/terminal","domain":"devtools","topic":"Algorithms","language":"C++","updated":"2025-08-13","comments":8,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-optimize-algorithmic-choices.md"},{"slug":"workers-sdk-informative-error-messages","title":"Informative error messages","description":"Error messages should provide specific context and actionable guidance to help developers understand and resolve issues effectively. Include relevant identifiers (class names, file paths, method names) and clear recovery instructions when possible.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Error Handling","language":"TypeScript","updated":"2025-08-13","comments":8,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-informative-error-messages.md"},{"slug":"openpilot-use-context-managers-concurrency","title":"use context managers concurrency","description":"When working with concurrent operations involving shared resources or processes, use context managers and explicit synchronization to ensure proper cleanup and thread safety. This prevents resource leaks, race conditions, and ensures graceful shutdown even when operations are interrupted.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Concurrency","language":"Python","updated":"2025-08-13","comments":5,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-use-context-managers-concurrency.md"},{"slug":"sglang-use-descriptive-names","title":"Use descriptive names","description":"Choose variable, function, and parameter names that accurately reflect their content, type, and purpose. Avoid misleading names that don't match the actual data or functionality they represent.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"Naming Conventions","language":"Python","updated":"2025-08-13","comments":5,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-use-descriptive-names.md"},{"slug":"better-auth-derive-from-session-context","title":"derive from session context","description":"Always derive sensitive identifiers and permissions from the authenticated session context rather than accepting them as user input. This prevents privilege escalation attacks where users could manipulate request parameters to access unauthorized resources or perform actions on behalf of other users.","repository":"better-auth/better-auth","domain":"security","topic":"Security","language":"TypeScript","updated":"2025-08-13","comments":4,"stars":19651,"raw":"https://awesomereviewers.com/raw/better-auth-derive-from-session-context.md"},{"slug":"posthog-capture-broad-exceptions","title":"Capture broad exceptions","description":"When using broad exception handlers like `except Exception:`, always capture and log the exception to avoid silent failures that are difficult to debug in production. Broad exception handling without proper error capture masks underlying issues and makes troubleshooting nearly impossible.","repository":"PostHog/posthog","domain":"data-systems","topic":"Error Handling","language":"Python","updated":"2025-08-13","comments":4,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-capture-broad-exceptions.md"},{"slug":"posthog-configuration-constants-management","title":"Configuration constants management","description":"Extract configuration values into well-named constants instead of using magic numbers or inline values. Use consistent naming patterns across environments and organize configuration values in a maintainable way.","repository":"PostHog/posthog","domain":"data-systems","topic":"Configurations","language":"Python","updated":"2025-08-13","comments":4,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-configuration-constants-management.md"},{"slug":"terminal-safe-null-handling-patterns","title":"Safe null handling patterns","description":"Always use consistent and safe patterns when dealing with potentially null or undefined values. This includes using safe casting methods, explicit null checks, proper initialization, and immutable variables after validation.","repository":"microsoft/terminal","domain":"devtools","topic":"Null Handling","language":"Other","updated":"2025-08-13","comments":4,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-safe-null-handling-patterns.md"},{"slug":"angular-clarify-configuration-option-limitations","title":"Clarify configuration option limitations","description":"When documenting or designing configuration options, explicitly state both what the option does AND what it doesn't do, including any limitations or side effects. Users often make incorrect assumptions about configuration behavior based on names alone.","repository":"angular/angular","domain":"app-frameworks","topic":"Configurations","language":"Markdown","updated":"2025-08-13","comments":3,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-clarify-configuration-option-limitations.md"},{"slug":"deer-flow-configuration-parameter-validation","title":"Configuration parameter validation","description":"Always validate configuration parameters for type, range, and reasonable values before use. Provide safe defaults for optional settings and prefer explicit parameter passing over runtime environment variable modification.","repository":"bytedance/deer-flow","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2025-08-13","comments":3,"stars":16482,"raw":"https://awesomereviewers.com/raw/deer-flow-configuration-parameter-validation.md"},{"slug":"dify-conservative-configuration-management","title":"Conservative configuration management","description":"Be selective and intentional with configuration choices to avoid bloat and unnecessary complexity. This applies to build configurations, development environment settings, and dependency management.","repository":"langgenius/dify","domain":"llm-infra","topic":"Configurations","language":"Json","updated":"2025-08-13","comments":3,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-conservative-configuration-management.md"},{"slug":"ink-explicit-type-checking","title":"explicit type checking","description":"Always perform explicit type and existence checks before operations that could fail with null or undefined values. Instead of relying on truthiness checks, use specific type guards to prevent runtime errors.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"Null Handling","language":"TypeScript","updated":"2025-08-13","comments":3,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-explicit-type-checking.md"},{"slug":"posthog-add-explanatory-tooltips","title":"Add explanatory tooltips","description":"When UI elements have unclear functionality or purpose, add tooltips to provide immediate context and explanation. This is especially important for icons, checkboxes, and interactive elements where the behavior or consequences aren't immediately obvious to users.","repository":"PostHog/posthog","domain":"data-systems","topic":"Documentation","language":"TSX","updated":"2025-08-13","comments":3,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-add-explanatory-tooltips.md"},{"slug":"router-avoid-unnecessary-complexity","title":"avoid unnecessary complexity","description":"Remove code complexity that doesn't provide clear value, particularly in type definitions, configuration options, and formatting constraints. This includes eliminating redundant type omissions, using descriptive names for configuration options, and avoiding formatting rules that conflict with user preferences.","repository":"TanStack/router","domain":"app-frameworks","topic":"Code Style","language":"Markdown","updated":"2025-08-13","comments":3,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-avoid-unnecessary-complexity.md"},{"slug":"sglang-explicit-api-parameters","title":"Explicit API parameters","description":"API functions should use explicit parameters rather than passing large opaque objects. When a function needs specific data from a complex object, extract and pass only the required fields as individual parameters. This makes the function's dependencies clear, improves testability, and reduces coupling.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"API","language":"Python","updated":"2025-08-13","comments":3,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-explicit-api-parameters.md"},{"slug":"sglang-optimize-tensor-operations","title":"optimize tensor operations","description":"When working with PyTorch tensors, prioritize operations that avoid unnecessary memory allocations and copies to improve performance. Choose tensor operations carefully based on whether data will be immediately overwritten or needs preservation.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"Pytorch","language":"Python","updated":"2025-08-13","comments":3,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-optimize-tensor-operations.md"},{"slug":"workerd-document-security-sensitive-features","title":"document security-sensitive features","description":"When introducing compatibility flags, feature toggles, or APIs that have security implications, use self-documenting names that explicitly warn about risks and provide comprehensive documentation explaining the security concerns.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Security","language":"Other","updated":"2025-08-13","comments":3,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-document-security-sensitive-features.md"},{"slug":"discourse-prevent-async-race-conditions","title":"Prevent async race conditions","description":"When handling multiple concurrent async operations (like user input triggering API calls or messageBus updates), implement mechanisms to prevent race conditions where stale results could overwrite newer state.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Concurrency","language":"Other","updated":"2025-08-13","comments":2,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-prevent-async-race-conditions.md"},{"slug":"goose-use-self-documenting-names","title":"Use self-documenting names","description":"Choose variable, function, and constant names that clearly express their purpose and eliminate the need for explanatory comments. Break down complex expressions into well-named intermediate variables rather than relying on comments to explain the logic.","repository":"block/goose","domain":"ai-agents","topic":"Naming Conventions","language":"TSX","updated":"2025-08-13","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-use-self-documenting-names.md"},{"slug":"opencode-separate-configuration-concerns","title":"Separate configuration concerns","description":"Keep persistent user configuration separate from transient state, setup flags, and derived values. Persistent configuration should only contain user-defined settings that need to be saved across sessions. Transient state like cached detection results, setup completion flags, or runtime-derived values should be stored separately using dedicated state...","repository":"sst/opencode","domain":"ai-agents","topic":"Configurations","language":"Go","updated":"2025-08-13","comments":2,"stars":28213,"raw":"https://awesomereviewers.com/raw/opencode-separate-configuration-concerns.md"},{"slug":"posthog-keep-state-in-kea","title":"Keep state in Kea","description":"React components should focus on presentation and user interaction, not state management logic. All state logic should be contained within Kea stores, with components only pulling in actions and values. This separation improves testability, reusability, and maintainability.","repository":"PostHog/posthog","domain":"data-systems","topic":"React","language":"TSX","updated":"2025-08-13","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-keep-state-in-kea.md"},{"slug":"posthog-local-configuration-exclusion","title":"Local configuration exclusion","description":"Exclude personal and local configuration files from version control while ensuring they are properly handled during environment setup. Personal configurations should use patterns like `*.local.*` or be placed in designated directories that are gitignored to prevent accidental commits of developer-specific settings.","repository":"PostHog/posthog","domain":"data-systems","topic":"Configurations","language":"Other","updated":"2025-08-13","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-local-configuration-exclusion.md"},{"slug":"posthog-two-phase-filtering-algorithms","title":"two-phase filtering algorithms","description":"When working with large datasets or complex matching operations, implement algorithms that use a two-phase approach: first filter candidates using efficient broad criteria, then verify matches with precise logic. This pattern significantly improves performance by reducing the number of expensive operations.","repository":"PostHog/posthog","domain":"data-systems","topic":"Algorithms","language":"Python","updated":"2025-08-13","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-two-phase-filtering-algorithms.md"},{"slug":"signoz-configuration-migration-fallbacks","title":"Configuration migration fallbacks","description":"When configuration structures evolve, implement fallback mechanisms to handle both old and new formats gracefully. This ensures backward compatibility during transitions and prevents breaking changes.","repository":"SigNoz/signoz","domain":"observability","topic":"Configurations","language":"TSX","updated":"2025-08-13","comments":2,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-configuration-migration-fallbacks.md"},{"slug":"ui-tars-desktop-native-fetch-over-dependencies","title":"Native fetch over dependencies","description":"Prefer Node.js native fetch API over external HTTP client libraries like `node-fetch` when the target Node.js version supports stable native functionality. While fetch is available from Node.js 18+, it's considered stable from version 21 onwards.","repository":"bytedance/UI-TARS-desktop","domain":"ai-agents","topic":"API","language":"Json","updated":"2025-08-13","comments":2,"stars":18021,"raw":"https://awesomereviewers.com/raw/ui-tars-desktop-native-fetch-over-dependencies.md"},{"slug":"litellm-ai-provider-documentation-completeness","title":"AI provider documentation completeness","description":"Ensure comprehensive documentation for AI/ML provider integrations that covers all usage patterns, uses precise terminology, and provides helpful context for developers.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"AI","language":"Markdown","updated":"2025-08-12","comments":9,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-ai-provider-documentation-completeness.md"},{"slug":"dspy-ai-configuration-documentation","title":"AI configuration documentation","description":"Ensure AI model configurations and related documentation use precise terminology and provide clear, complete setup instructions without overwhelming users.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"AI","language":"Markdown","updated":"2025-08-12","comments":6,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-ai-configuration-documentation.md"},{"slug":"cal.com-explicit-null-checks","title":"Explicit null checks","description":"Always use explicit null and undefined checks instead of relying solely on optional chaining, especially when you need predictable boolean results or want to prevent null/undefined values from propagating to APIs, URLs, or causing runtime errors.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Null Handling","language":"TSX","updated":"2025-08-12","comments":5,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-explicit-null-checks.md"},{"slug":"angular-use-specific-descriptive-names","title":"Use specific descriptive names","description":"Choose specific, meaningful names that clearly communicate purpose rather than generic or ambiguous alternatives. This applies to classes, methods, variables, and examples in documentation.","repository":"angular/angular","domain":"app-frameworks","topic":"Naming Conventions","language":"Markdown","updated":"2025-08-12","comments":4,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-use-specific-descriptive-names.md"},{"slug":"ant-design-test-organization-standards","title":"Test organization standards","description":"Write tests that are well-organized, maintainable, and reflect real usage patterns. Test names should describe behavior and requirements rather than implementation details. Group related tests under appropriate describe blocks and avoid redundant test cases.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Testing","language":"TSX","updated":"2025-08-12","comments":4,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-test-organization-standards.md"},{"slug":"playwright-prioritize-documentation-clarity","title":"Prioritize documentation clarity","description":"Documentation should prioritize clarity and actionable guidance over comprehensive coverage. Organize content logically by placing the most relevant information first, provide clear recommendations on preferred approaches, and avoid unnecessary complexity or redundant details that don't add value.","repository":"microsoft/playwright","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2025-08-12","comments":4,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-prioritize-documentation-clarity.md"},{"slug":"playwright-testing-best-practices","title":"testing best practices","description":"Choose testing methods, configurations, and approaches that prioritize user experience and reliability over theoretical completeness. Consider the practical needs of your development team and testing environment when making decisions.","repository":"microsoft/playwright","domain":"devtools","topic":"Testing","language":"Markdown","updated":"2025-08-12","comments":4,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-testing-best-practices.md"},{"slug":"posthog-optimize-orm-queries","title":"optimize ORM queries","description":"Optimize Django ORM queries to prevent performance issues and unnecessary database load. Avoid N+1 query problems by using appropriate prefetch_related() and select_related() calls. Remove unnecessary select_related() when you're only filtering by foreign key IDs and not accessing the related object. Choose the correct database routing (read vs write...","repository":"PostHog/posthog","domain":"data-systems","topic":"Database","language":"Python","updated":"2025-08-12","comments":4,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-optimize-orm-queries.md"},{"slug":"cal.com-keep-api-handlers-thin","title":"Keep API handlers thin","description":"API handlers should be lightweight and focused on request/response handling, not business logic. Extract specific parameters from requests and delegate complex operations to dedicated services rather than handling everything in the controller.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2025-08-12","comments":3,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-keep-api-handlers-thin.md"},{"slug":"clickhouse-avoid-duplicate-http-headers","title":"Avoid duplicate HTTP headers","description":"Ensure HTTP headers are sent only once per response to prevent network protocol violations and connection errors. Sending headers multiple times violates HTTP protocol standards and can cause \"Broken pipe\" errors and connection failures.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Networking","language":"C++","updated":"2025-08-12","comments":3,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-avoid-duplicate-http-headers.md"},{"slug":"clickhouse-consistent-formatting-rules","title":"consistent formatting rules","description":"Maintain consistent formatting throughout the codebase to improve readability and maintainability. This includes standardizing function declaration spacing, comment styles, pointer/reference formatting, and type naming conventions.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Code Style","language":"Other","updated":"2025-08-12","comments":3,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-consistent-formatting-rules.md"},{"slug":"clickhouse-consistent-naming-conventions","title":"Consistent naming conventions","description":"Maintain consistent naming conventions within your codebase, even when external specifications or APIs use different naming patterns. Internal consistency should take precedence over matching external naming styles to ensure code readability and maintainability.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Naming Conventions","language":"Markdown","updated":"2025-08-12","comments":3,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-consistent-naming-conventions.md"},{"slug":"clickhouse-prefer-simple-optimizations","title":"prefer simple optimizations","description":"When implementing performance optimizations, favor simple, straightforward approaches over complex solutions unless the complexity is clearly justified by significant performance gains. Complex optimizations often introduce maintenance burden, reduce code readability, and may not provide proportional benefits.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Performance Optimization","language":"Other","updated":"2025-08-12","comments":3,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-prefer-simple-optimizations.md"},{"slug":"posthog-validate-inputs-recursively","title":"Validate inputs recursively","description":"Always implement recursive validation and sanitization for user inputs, especially when dealing with encoded content or external data sources. Single-pass validation can be bypassed through multiple encoding layers or nested attacks.","repository":"PostHog/posthog","domain":"data-systems","topic":"Security","language":"Python","updated":"2025-08-12","comments":3,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-validate-inputs-recursively.md"},{"slug":"workerd-wrap-throwing-operations","title":"Wrap throwing operations","description":"Always wrap potentially throwing operations in try/catch blocks to prevent unhandled exceptions from crashing the application or causing unexpected behavior. This includes property access on unknown objects, API calls, and resource initialization.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Error Handling","language":"TypeScript","updated":"2025-08-12","comments":3,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-wrap-throwing-operations.md"},{"slug":"clickhouse-recognize-nullable-type-context","title":"Recognize nullable type context","description":"Before adding nullable casts or special null handling logic, verify whether the type or context already provides the necessary nullability semantics. This prevents redundant operations and ensures appropriate handling of different type categories.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Null Handling","language":"Other","updated":"2025-08-12","comments":2,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-recognize-nullable-type-context.md"},{"slug":"opencut-consistent-imports-and-constants","title":"Consistent Imports And Constants","description":"Keep code style consistent by (1) avoiding redundant imports and (2) centralizing shared UI values. - Imports: Use only what you actually need. If the project uses the modern JSX transform, don’t import a default `React` namespace just for JSX.","repository":"opencut-app/opencut","domain":"app-frameworks","topic":"Code Style","language":"TSX","updated":"2025-08-12","comments":2,"stars":81817,"raw":"https://awesomereviewers.com/raw/opencut-consistent-imports-and-constants.md"},{"slug":"volcano-use-descriptive-naming","title":"Use descriptive naming","description":"Choose variable, function, and method names that clearly communicate their purpose and behavior. Avoid ambiguous abbreviations, numbered suffixes, double negatives, and names that don't accurately reflect functionality.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Naming Conventions","language":"Go","updated":"2025-08-11","comments":11,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-use-descriptive-naming.md"},{"slug":"volcano-add-explicit-nil-checks","title":"Add explicit nil checks","description":"Always add explicit nil checks before accessing object properties and after type assertions to prevent null pointer exceptions and runtime panics. Even when type assertions succeed, the underlying value can still be nil, requiring additional validation.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Null Handling","language":"Go","updated":"2025-08-11","comments":7,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-add-explicit-nil-checks.md"},{"slug":"workerd-comprehensive-assertion-testing","title":"comprehensive assertion testing","description":"Ensure test assertions are thorough and complete by testing both expected behavior and error conditions with specific error types and messages. Tests should cover edge cases, boundary conditions, and all relevant code branches rather than just happy path scenarios.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Testing","language":"JavaScript","updated":"2025-08-11","comments":7,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-comprehensive-assertion-testing.md"},{"slug":"ant-design-semantic-naming-consistency","title":"Semantic naming consistency","description":"Choose semantically clear and consistent names across related elements in your codebase. Names should convey their purpose without requiring additional context or explanation, and related elements should follow consistent naming patterns.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Naming Conventions","language":"Markdown","updated":"2025-08-11","comments":5,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-semantic-naming-consistency.md"},{"slug":"clickhouse-optimize-algorithm-selection","title":"optimize algorithm selection","description":"Choose algorithms and data structures based on actual performance characteristics rather than defaulting to standard library implementations. Consider lighter-weight alternatives when standard library functions are over-engineered for your use case.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Algorithms","language":"Other","updated":"2025-08-11","comments":5,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-optimize-algorithm-selection.md"},{"slug":"litellm-api-parameter-consistency","title":"API parameter consistency","description":"Ensure consistent parameter naming, format, and usage across all API interfaces, documentation, and code examples. This includes maintaining uniform parameter names between SDK examples and proxy configurations, using correct environment variable names as specified in official documentation, and applying proper naming conventions for model identifiers and...","repository":"BerriAI/litellm","domain":"llm-infra","topic":"API","language":"Markdown","updated":"2025-08-11","comments":5,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-api-parameter-consistency.md"},{"slug":"goose-optimize-memory-and-algorithms","title":"Optimize memory and algorithms","description":"Focus on efficient memory usage and algorithm selection while preserving functionality. Apply these optimization techniques: **Memory optimization:**","repository":"block/goose","domain":"ai-agents","topic":"Performance Optimization","language":"Rust","updated":"2025-08-11","comments":4,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-optimize-memory-and-algorithms.md"},{"slug":"posthog-ai-context-efficiency","title":"AI context efficiency","description":"When providing context to LLMs, choose the most efficient method based on the nature and size of the context data. For bounded, static context (like feature flag mappings or configuration options), inject the information directly into the system prompt rather than using tool calls. This approach is faster, more cost-effective, and reduces complexity.","repository":"PostHog/posthog","domain":"data-systems","topic":"AI","language":"Python","updated":"2025-08-11","comments":4,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-ai-context-efficiency.md"},{"slug":"sglang-prevent-race-conditions","title":"Prevent race conditions","description":"Ensure atomic operations and proper synchronization when multiple threads or processes access shared state. Race conditions occur when the timing of operations affects correctness, leading to data corruption, memory leaks, or inconsistent behavior.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"Concurrency","language":"Python","updated":"2025-08-11","comments":4,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-prevent-race-conditions.md"},{"slug":"langchain-explicit-ci-environment-config","title":"Explicit CI Environment Config","description":"Make CI and build configuration deterministic by explicitly selecting tool versions and target environments, and by ensuring monorepo config paths match what downstream generators expect.","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"Configurations","language":"Yaml","updated":"2025-08-11","comments":3,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-explicit-ci-environment-config.md"},{"slug":"workers-sdk-remove-unnecessary-configurations","title":"Remove unnecessary configurations","description":"Configuration files should only include options that are supported in production and work out of the box. Remove configuration fields that are unsupported in production environments, comment out configurations that require external provisioning, and maintain consistency across templates by removing redundant or debugging-specific settings.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Configurations","language":"Other","updated":"2025-08-11","comments":3,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-remove-unnecessary-configurations.md"},{"slug":"clickhouse-consistent-mutex-protection","title":"consistent mutex protection","description":"Ensure consistent mutex usage across all access points to shared data structures and clearly document what each mutex protects. Inconsistent locking can lead to race conditions, data corruption, and crashes.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Concurrency","language":"C++","updated":"2025-08-11","comments":2,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-consistent-mutex-protection.md"},{"slug":"discourse-messagebus-subscription-practices","title":"MessageBus subscription practices","description":"When using MessageBus for network communication, follow these essential practices to ensure reliable message handling and prevent memory leaks: 1. **Use consistent channel names** between subscribe and unsubscribe calls to avoid subscription leaks","repository":"discourse/discourse","domain":"app-frameworks","topic":"Networking","language":"Other","updated":"2025-08-11","comments":2,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-messagebus-subscription-practices.md"},{"slug":"litellm-document-configuration-purpose-clearly","title":"Document configuration purpose clearly","description":"When documenting configuration features, always provide clear explanations of their purpose, use cases, and how they map to underlying parameters. Users should understand not just how to use a configuration option, but why they would want to use it and what problem it solves.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Configurations","language":"Markdown","updated":"2025-08-11","comments":2,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-document-configuration-purpose-clearly.md"},{"slug":"novu-avoid-optional-decorator","title":"avoid @Optional decorator","description":"Avoid using the @Optional decorator in NestJS dependency injection as it disables runtime DI validation during bootstrap. This can cause missing provider dependencies to go undetected during compilation, leading to runtime failures without clear error messages.","repository":"novuhq/novu","domain":"app-frameworks","topic":"NestJS","language":"TypeScript","updated":"2025-08-11","comments":2,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-avoid-optional-decorator.md"},{"slug":"posthog-use-error-chain-iterators","title":"Use error chain iterators","description":"When traversing error chains in Rust, prefer using the `chain()` iterator method over manual source traversal with while loops. The `chain()` method provides a more idiomatic and readable approach to walking through error chains, eliminating the need for manual loop management and making the code more concise.","repository":"PostHog/posthog","domain":"data-systems","topic":"Error Handling","language":"Rust","updated":"2025-08-11","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-use-error-chain-iterators.md"},{"slug":"router-intentional-async-usage","title":"Intentional async usage","description":"Be deliberate about when to use the `async` keyword and `await` expressions. Making a function `async` changes its behavior - it will always return a Promise, even for early returns. This can break conditional logic that checks for synchronous vs asynchronous behavior.","repository":"TanStack/router","domain":"app-frameworks","topic":"Concurrency","language":"TypeScript","updated":"2025-08-11","comments":2,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-intentional-async-usage.md"},{"slug":"workerd-choose-appropriate-logging-functions","title":"Choose appropriate logging functions","description":"Select the correct logging function based on frequency, severity, and destination to avoid log spam and ensure proper routing. Use LOG_ONCE or LOG_PERIODICALLY for repeated warnings that could spam logs, KJ_LOG(ERROR) for general error logging, and LOG_EXCEPTION only for exceptions intended for Sentry monitoring.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Logging","language":"Other","updated":"2025-08-11","comments":2,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-choose-appropriate-logging-functions.md"},{"slug":"tree-sitter-simplify-complex-expressions","title":"Simplify complex expressions","description":"Break down complex code structures into simpler, more readable forms. This includes avoiding deep nesting, extracting complex logic into helper functions, simplifying boolean expressions, and reducing code duplication.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Code Style","language":"Rust","updated":"2025-08-10","comments":12,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-simplify-complex-expressions.md"},{"slug":"litellm-ai-model-data-validation","title":"AI model data validation","description":"All AI model configuration parameters must be verified against official provider documentation before merging. This includes token limits, pricing values, provider assignments, model names, and supported features. Incorrect configuration data leads to runtime errors, cost miscalculations, and integration failures.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"AI","language":"Json","updated":"2025-08-10","comments":11,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-ai-model-data-validation.md"},{"slug":"novu-use-semantic-naming-patterns","title":"Use semantic naming patterns","description":"Establish consistent naming conventions that preserve semantic meaning and follow established patterns. Use descriptive names that clearly indicate purpose and type.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2025-08-10","comments":6,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-use-semantic-naming-patterns.md"},{"slug":"ant-design-configuration-documentation-standards","title":"Configuration documentation standards","description":"Ensure configuration properties and settings are documented with consistent formatting and precise specifications. Configuration property names should be wrapped in backticks for proper formatting in documentation and changelogs. Version dependencies must specify exact version ranges rather than vague references like \"latest version\". Documentation should...","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Configurations","language":"Markdown","updated":"2025-08-10","comments":5,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-configuration-documentation-standards.md"},{"slug":"better-auth-expose-essential-configurations","title":"Expose essential configurations","description":"Carefully evaluate which configuration options should be exposed to users versus kept internal. Not all configuration parameters need to be user-controllable - expose only those that provide meaningful customization while keeping implementation details private.","repository":"better-auth/better-auth","domain":"security","topic":"Configurations","language":"TypeScript","updated":"2025-08-10","comments":4,"stars":19651,"raw":"https://awesomereviewers.com/raw/better-auth-expose-essential-configurations.md"},{"slug":"discourse-safe-setting-modifications","title":"Safe setting modifications","description":"When modifying site settings during operations like imports, jobs, or plugin initialization, implement proper safeguards to prevent unintended permanent changes. Consider the impact on existing sites and provide mechanisms for restoration or warnings.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Configurations","language":"Ruby","updated":"2025-08-10","comments":4,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-safe-setting-modifications.md"},{"slug":"sglang-document-ai-limitations","title":"Document AI limitations","description":"When implementing AI model support or hardware backends, clearly document known limitations, compatibility constraints, and version requirements to prevent integration issues and set proper expectations.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"AI","language":"Markdown","updated":"2025-08-10","comments":3,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-document-ai-limitations.md"},{"slug":"sglang-consolidate-duplicated-logic","title":"consolidate duplicated logic","description":"When you identify duplicated code patterns across different branches or functions, consolidate the shared logic into a unified implementation to improve maintainability and reduce code bloat. This applies whether the duplication occurs within conditional branches, across similar functions, or in separate files.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"Code Style","language":"CUDA","updated":"2025-08-10","comments":2,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-consolidate-duplicated-logic.md"},{"slug":"duckdb-avoid-repeated-expensive-operations","title":"avoid repeated expensive operations","description":"Identify and eliminate repeated expensive computations, especially in loops and frequently executed code paths. This optimization principle focuses on moving invariant calculations outside loops, caching results of expensive operations, and avoiding unnecessary data conversions or memory allocations.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Performance Optimization","language":"C++","updated":"2025-08-08","comments":7,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-avoid-repeated-expensive-operations.md"},{"slug":"angular-leverage-existing-angular-patterns","title":"leverage existing Angular patterns","description":"Before implementing new functionality, check if Angular already provides a suitable utility, service, or pattern that can be reused. This promotes consistency across the codebase, reduces duplication, and follows established Angular conventions.","repository":"angular/angular","domain":"app-frameworks","topic":"Angular","language":"TypeScript","updated":"2025-08-08","comments":6,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-leverage-existing-angular-patterns.md"},{"slug":"nextchat-provider-specific-ai-handling","title":"Provider-specific AI handling","description":"Implement provider-specific logic when integrating different AI services, as each provider has unique requirements for message formatting, API endpoints, validation rules, and optimization strategies.","repository":"ChatGPTNextWeb/NextChat","domain":"ai-agents","topic":"AI","language":"TypeScript","updated":"2025-08-08","comments":6,"stars":85721,"raw":"https://awesomereviewers.com/raw/nextchat-provider-specific-ai-handling.md"},{"slug":"clickhouse-setting-declaration-practices","title":"Setting declaration practices","description":"Always declare settings before using them and optimize access patterns for performance. Settings must be properly declared in the appropriate scope before being referenced in code. When accessing settings multiple times, cache the value in a local variable to avoid repeated lookups. For configuration parsing, avoid modifying AST nodes directly and use local...","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Configurations","language":"C++","updated":"2025-08-08","comments":4,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-setting-declaration-practices.md"},{"slug":"jan-ai-accuracy-documentation","title":"AI accuracy documentation","description":"Ensure accurate representation of AI model capabilities, proper attribution, and honest claims about functionality. When documenting AI systems, focus on the underlying model capabilities rather than just pipeline descriptions, provide clear explanations of model variants (distilled vs full models), attribute models to their actual creators, and avoid...","repository":"menloresearch/jan","domain":"llm-infra","topic":"AI","language":"Other","updated":"2025-08-08","comments":4,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-ai-accuracy-documentation.md"},{"slug":"mermaid-invariant-preserving-graph-algorithms","title":"Invariant-Preserving Graph Algorithms","description":"When a graph/geometry algorithm is used recursively (or downstream computations depend on its shape/metrics), don’t patch symptoms. Preserve invariants end-to-end:","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Algorithms","language":"JavaScript","updated":"2025-08-08","comments":4,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-invariant-preserving-graph-algorithms.md"},{"slug":"better-auth-use-descriptive-naming","title":"Use descriptive naming","description":"Choose specific, contextual names over generic terms to improve code clarity and maintainability. Generic names become ambiguous when combined into larger APIs or codebases, making it difficult for developers to understand functionality at a glance.","repository":"better-auth/better-auth","domain":"security","topic":"Naming Conventions","language":"TypeScript","updated":"2025-08-08","comments":3,"stars":19651,"raw":"https://awesomereviewers.com/raw/better-auth-use-descriptive-naming.md"},{"slug":"jan-eliminate-filler-language","title":"Eliminate filler language","description":"Remove unnecessary filler words and repetitive phrases that dilute clarity and assume reader incompetence. Avoid words like \"essentially\", \"basically\", \"just\", \"simple\", \"easy\", and repetitive phrases like \"at a high level\" appearing multiple times in close proximity.","repository":"menloresearch/jan","domain":"llm-infra","topic":"Documentation","language":"Other","updated":"2025-08-08","comments":3,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-eliminate-filler-language.md"},{"slug":"workerd-choose-efficient-algorithms","title":"Choose efficient algorithms","description":"When implementing algorithms, prioritize efficiency in both time and space complexity. Consider these specific optimizations: 1. **Use bitwise operations** for mathematical computations when appropriate. For random number generation in ranges, bitwise operations can be more efficient than arithmetic expressions:","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Algorithms","language":"TypeScript","updated":"2025-08-08","comments":3,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-choose-efficient-algorithms.md"},{"slug":"discourse-consistent-text-formatting","title":"Consistent text formatting","description":"Ensure text formatting follows established guidelines and maintains consistency within the same context. This applies to documentation strings, localization files, user interface text, and error messages.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Documentation","language":"Yaml","updated":"2025-08-08","comments":2,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-consistent-text-formatting.md"},{"slug":"goose-database-migration-isolation","title":"Database migration isolation","description":"When performing database migrations or schema changes, use containerized environments to ensure isolation and comprehensive testing. This approach prevents migration issues from affecting development environments and allows for reliable rollback scenarios.","repository":"block/goose","domain":"ai-agents","topic":"Database","language":"Markdown","updated":"2025-08-08","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-database-migration-isolation.md"},{"slug":"kilocode-configuration-bounds-validation","title":"Configuration bounds validation","description":"Always validate configuration values against system limits and constraints, implementing automatic adjustment when values exceed acceptable bounds. This prevents runtime errors and ensures configurations remain within operational parameters.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Configurations","language":"TSX","updated":"2025-08-08","comments":2,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-configuration-bounds-validation.md"},{"slug":"posthog-api-parameter-semantics","title":"API parameter semantics","description":"Ensure API parameters have clear semantic meaning and avoid sending null values for optional fields. When designing API endpoints, use parameter names that accurately reflect their purpose and data type. For optional fields, omit them entirely from the payload rather than setting them to null, as this creates cleaner API contracts and prevents confusion...","repository":"PostHog/posthog","domain":"data-systems","topic":"API","language":"TSX","updated":"2025-08-08","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-api-parameter-semantics.md"},{"slug":"posthog-minimize-expensive-operations","title":"minimize expensive operations","description":"Avoid triggering expensive operations (queries, API calls, computations) on every user input or state change. Instead, use appropriate triggers that balance responsiveness with performance.","repository":"PostHog/posthog","domain":"data-systems","topic":"Performance Optimization","language":"TSX","updated":"2025-08-08","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-minimize-expensive-operations.md"},{"slug":"terminal-specify-security-requirements","title":"Specify security requirements","description":"Always explicitly declare security requirements and provide clear security guidance in both configuration files and user-facing content. When operations require elevated privileges, specify the security context to ensure proper UAC prompting. When features have security implications, include explanatory text to help users make informed decisions.","repository":"microsoft/terminal","domain":"devtools","topic":"Security","language":"Other","updated":"2025-08-08","comments":2,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-specify-security-requirements.md"},{"slug":"workerd-extract-repeated-expressions","title":"extract repeated expressions","description":"When the same expression or computation appears multiple times within a code block, extract it to a variable to improve maintainability and readability. This reduces the risk of inconsistencies when the logic needs to be updated and makes the code's intent clearer.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Code Style","language":"JavaScript","updated":"2025-08-08","comments":2,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-extract-repeated-expressions.md"},{"slug":"posthog-verify-html-escaping","title":"Verify HTML escaping","description":"Always verify that user-controlled content in templates is properly HTML-escaped to prevent XSS attacks. Don't just assume framework defaults are working - actively test with potentially malicious input to confirm that HTML tags are rendered as text rather than executed.","repository":"PostHog/posthog","domain":"data-systems","topic":"Security","language":"Html","updated":"2025-08-08","comments":1,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-verify-html-escaping.md"},{"slug":"clickhouse-explicit-error-handling","title":"Explicit error handling","description":"Always handle error conditions explicitly rather than silently ignoring them or using generic error responses. Use specific error codes that reflect business logic rather than low-level system errors, and throw exceptions for unexpected states instead of using assertions or returning generic failure indicators.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Error Handling","language":"C++","updated":"2025-08-07","comments":7,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-explicit-error-handling.md"},{"slug":"mono-remove-unnecessary-code","title":"remove unnecessary code","description":"Eliminate unnecessary code elements that add complexity without providing value. This includes removing redundant function wrappers, unnecessary type annotations, singleton classes that could be simple objects, explicit type conversions where implicit ones suffice, and methods that duplicate existing functionality.","repository":"rocicorp/mono","domain":"data-systems","topic":"Code Style","language":"TypeScript","updated":"2025-08-07","comments":7,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-remove-unnecessary-code.md"},{"slug":"union-choose-efficient-data-structures","title":"Choose efficient data structures","description":"Select data structures and algorithms that optimize for the specific use case rather than defaulting to generic collections. Consider computational complexity, memory usage, and access patterns when making these choices.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Algorithms","language":"Rust","updated":"2025-08-07","comments":7,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-choose-efficient-data-structures.md"},{"slug":"better-auth-validate-before-usage","title":"Validate before usage","description":"Always explicitly check for null or undefined values before using them in operations. Don't assume values exist - validate their presence and handle missing cases appropriately with early returns, error throwing, or fallback logic.","repository":"better-auth/better-auth","domain":"security","topic":"Null Handling","language":"TypeScript","updated":"2025-08-07","comments":5,"stars":19651,"raw":"https://awesomereviewers.com/raw/better-auth-validate-before-usage.md"},{"slug":"duckdb-optimize-algorithm-complexity","title":"Optimize algorithm complexity","description":"Choose efficient algorithms and data structures to avoid unnecessary computational complexity. Replace manual loops with optimized library functions, select appropriate containers based on access patterns, and use direct conversion paths when possible.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Algorithms","language":"Other","updated":"2025-08-07","comments":5,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-optimize-algorithm-complexity.md"},{"slug":"litellm-avoid-expensive-operations","title":"avoid expensive operations","description":"Identify and optimize resource-intensive operations in frequently executed code paths. This includes avoiding memory-doubling operations like `copy.deepcopy()` on large objects, preventing blocking I/O in async contexts, and eliminating expensive debug logging operations.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Performance Optimization","language":"Python","updated":"2025-08-07","comments":5,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-avoid-expensive-operations.md"},{"slug":"workerd-http-protocol-compliance","title":"HTTP protocol compliance","description":"Ensure HTTP protocol implementations strictly follow RFC standards and handle edge cases correctly. This includes proper header parsing that respects quoted-string constructions, realistic port value assignments, and appropriate status code filtering.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Networking","language":"TypeScript","updated":"2025-08-07","comments":4,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-http-protocol-compliance.md"},{"slug":"angular-verify-ssr-documentation-accuracy","title":"Verify SSR documentation accuracy","description":"Ensure that documentation about server-side rendering (SSR), static site generation (SSG), and related rendering strategies is technically accurate and complete. Avoid making misleading claims about performance characteristics or technical behavior, and include all relevant benefits and use cases.","repository":"angular/angular","domain":"app-frameworks","topic":"Next","language":"Markdown","updated":"2025-08-07","comments":3,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-verify-ssr-documentation-accuracy.md"},{"slug":"ty-structure-documentation-logically","title":"Structure documentation logically","description":"Organize documentation sections and content to match user mental models and workflows, not internal technical implementation details. Use descriptive, specific section names instead of generic ones like \"Other changes\" or overly technical terms. Present information in the order users will encounter or need it, prioritizing common use cases before advanced...","repository":"astral-sh/ty","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2025-08-07","comments":3,"stars":11919,"raw":"https://awesomereviewers.com/raw/ty-structure-documentation-logically.md"},{"slug":"workers-sdk-http-response-construction","title":"HTTP response construction","description":"Use appropriate HTTP response construction methods and status codes for API endpoints. Prefer `Response.json()` over manual JSON stringification, return appropriate status codes (like 404 for unmatched routes), and avoid unnecessary response complexity when simple status codes suffice.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"API","language":"TypeScript","updated":"2025-08-07","comments":3,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-http-response-construction.md"},{"slug":"hyperswitch-consistent-configuration-naming","title":"consistent configuration naming","description":"Configuration variable names should follow consistent patterns and be descriptive enough to clearly convey their purpose and scope. When naming similar configuration parameters, maintain uniform naming conventions throughout the codebase.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"Naming Conventions","language":"Toml","updated":"2025-08-07","comments":2,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-consistent-configuration-naming.md"},{"slug":"posthog-validate-before-use","title":"validate before use","description":"Always validate that values are truthy or defined before using them, even when they are expected to exist. This prevents runtime errors and unexpected behavior when assumptions about data presence are violated.","repository":"PostHog/posthog","domain":"data-systems","topic":"Null Handling","language":"TypeScript","updated":"2025-08-07","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-validate-before-use.md"},{"slug":"signoz-orchestrate-observability-services","title":"orchestrate observability services","description":"When setting up observability infrastructure in build systems, use proper dependency management and descriptive naming. Define service dependencies explicitly rather than embedding commands, and use specific names that clearly identify the observability tools being orchestrated.","repository":"SigNoz/signoz","domain":"observability","topic":"Observability","language":"Other","updated":"2025-08-07","comments":2,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-orchestrate-observability-services.md"},{"slug":"litellm-avoid-hardcoded-credentials","title":"avoid hardcoded credentials","description":"Never embed sensitive credentials, passwords, API keys, or other secrets directly in source code. Hardcoded credentials create security vulnerabilities by exposing sensitive data in version control systems and making it accessible to anyone with code access.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Security","language":"Yaml","updated":"2025-08-07","comments":1,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-avoid-hardcoded-credentials.md"},{"slug":"terminal-use-semantic-naming","title":"Use semantic naming","description":"Names should clearly communicate their purpose, type, and behavior to improve code maintainability and accessibility. Avoid misleading or ambiguous terminology that can confuse developers or users.","repository":"microsoft/terminal","domain":"devtools","topic":"Naming Conventions","language":"Other","updated":"2025-08-06","comments":12,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-use-semantic-naming.md"},{"slug":"ty-configuration-documentation-clarity","title":"Configuration documentation clarity","description":"Configuration documentation should be precise, specific, and include helpful context for users. Avoid vague or ambiguous language that could lead to misunderstanding of how settings behave.","repository":"astral-sh/ty","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2025-08-06","comments":10,"stars":11919,"raw":"https://awesomereviewers.com/raw/ty-configuration-documentation-clarity.md"},{"slug":"ant-design-simplify-complex-expressions","title":"Simplify complex expressions","description":"Extract repeated expressions and complex conditional logic into clear, readable variables to improve code maintainability and reduce cognitive load. **Key practices:**","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Code Style","language":"TSX","updated":"2025-08-06","comments":5,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-simplify-complex-expressions.md"},{"slug":"goose-verify-configuration-documentation","title":"Verify configuration documentation","description":"Ensure all configuration documentation accurately reflects actual system behavior, available options, and correct command syntax. Configuration errors in documentation lead to broken user setups and erode trust.","repository":"block/goose","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2025-08-06","comments":5,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-verify-configuration-documentation.md"},{"slug":"playwright-comprehensive-test-coverage","title":"comprehensive test coverage","description":"Tests should be comprehensive and cover edge cases, complete scenarios, and use specific assertions rather than generic checks. When writing tests, include multiple test cases that validate different states, use precise count assertions instead of simple visibility checks, and ensure all relevant interactions are tested.","repository":"microsoft/playwright","domain":"devtools","topic":"Testing","language":"TypeScript","updated":"2025-08-06","comments":5,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-comprehensive-test-coverage.md"},{"slug":"workerd-connection-reuse-safety","title":"Connection reuse safety","description":"When implementing network connection reuse, prioritize safety over performance by enforcing sequential request patterns and clear resource ownership. Connection reuse should be supported to avoid the overhead of creating new connections for each request, but must include proper safeguards to prevent concurrency issues and resource conflicts.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Networking","language":"JavaScript","updated":"2025-08-06","comments":4,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-connection-reuse-safety.md"},{"slug":"duckdb-guard-expensive-logging-operations","title":"Guard expensive logging operations","description":"Avoid executing expensive operations in logging code paths when logging is disabled or not needed. Always check if logging should occur before performing costly operations like string construction, formatting, or data processing for log messages.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Logging","language":"C++","updated":"2025-08-06","comments":3,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-guard-expensive-logging-operations.md"},{"slug":"kilocode-handle-ai-provider-specifics","title":"Handle AI provider specifics","description":"Different AI providers and models have unique requirements for input processing, output filtering, and API parameters that must be implemented correctly. When working with AI APIs, research and implement provider-specific handling rather than assuming uniform behavior across all providers.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"AI","language":"TypeScript","updated":"2025-08-06","comments":3,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-handle-ai-provider-specifics.md"},{"slug":"cal.com-specify-stable-dependency-versions","title":"Specify stable dependency versions","description":"Always use specific semantic versions or caret ranges for stable releases in package.json and other dependency configuration files. Avoid using \"latest\" or development/pre-release versions as they can introduce unpredictable behavior and breaking changes that affect build reproducibility and team consistency.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2025-08-06","comments":2,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-specify-stable-dependency-versions.md"},{"slug":"goose-conditional-telemetry-flushing","title":"Conditional telemetry flushing","description":"Avoid fixed delays for telemetry flushing. Instead, make flushing conditional on whether telemetry endpoints are configured and use dynamic timeouts when possible.","repository":"block/goose","domain":"ai-agents","topic":"Observability","language":"Rust","updated":"2025-08-06","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-conditional-telemetry-flushing.md"},{"slug":"posthog-environment-based-configuration-management","title":"Environment-based configuration management","description":"Prefer environment variables over file mounting for configuration values, and avoid hardcoded environment-specific conditionals like `isCloud()`. Instead, rely purely on configuration environment variables that can be set differently across environments. When setting default configuration values, consider the constraints and limits of downstream systems to...","repository":"PostHog/posthog","domain":"data-systems","topic":"Configurations","language":"TypeScript","updated":"2025-08-06","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-environment-based-configuration-management.md"},{"slug":"router-dependency-version-specification","title":"Dependency version specification","description":"Ensure proper dependency version specification and compatibility management in package.json files. Use explicit version ranges for peer dependencies to express compatibility constraints, avoid workspace references in examples and published packages, and properly classify dependencies based on usage patterns.","repository":"TanStack/router","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2025-08-05","comments":8,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-dependency-version-specification.md"},{"slug":"terminal-use-descriptive-identifiers","title":"Use descriptive identifiers","description":"Choose clear, self-documenting names for variables, methods, parameters, and properties that explicitly convey their purpose and context. Avoid ambiguous or generic names that require additional context to understand.","repository":"microsoft/terminal","domain":"devtools","topic":"Naming Conventions","language":"C++","updated":"2025-08-05","comments":8,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-use-descriptive-identifiers.md"},{"slug":"workerd-use-appropriate-exception-types","title":"Use appropriate exception types","description":"Choose the correct exception handling mechanism and type based on the error condition's nature and audience. Use JSG_REQUIRE for user-controllable conditions that should result in JavaScript exceptions, and KJ_ASSERT for internal invariants that indicate programming errors. Provide friendly, actionable error messages for user-facing exceptions.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Error Handling","language":"Other","updated":"2025-08-05","comments":8,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-use-appropriate-exception-types.md"},{"slug":"duckdb-maintain-codebase-consistency","title":"maintain codebase consistency","description":"Ensure new code follows established patterns, conventions, and standards already present in the codebase. This includes adhering to parameter ordering conventions, maintaining existing code patterns, using consistent header formatting, and reusing existing utilities rather than creating duplicates.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Code Style","language":"Other","updated":"2025-08-05","comments":6,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-maintain-codebase-consistency.md"},{"slug":"jan-implement-graceful-error-fallbacks","title":"Implement graceful error fallbacks","description":"Always implement fallback mechanisms when primary operations can fail, especially for critical operations like resource cleanup, async operations, and user-facing functionality. When the primary approach fails, provide a secondary method to handle the situation gracefully rather than letting errors propagate unchecked.","repository":"menloresearch/jan","domain":"llm-infra","topic":"Error Handling","language":"TypeScript","updated":"2025-08-05","comments":4,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-implement-graceful-error-fallbacks.md"},{"slug":"playwright-explicit-undefined-checks","title":"explicit undefined checks","description":"Always use explicit checks for undefined values and return appropriate nullable types instead of relying on implicit conversions or unsafe type assertions. Use modern JavaScript equality checks and proper TypeScript utility types for null safety.","repository":"microsoft/playwright","domain":"devtools","topic":"Null Handling","language":"TypeScript","updated":"2025-08-05","comments":4,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-explicit-undefined-checks.md"},{"slug":"signoz-avoid-inline-styles","title":"Avoid inline styles","description":"Move all inline styles to dedicated CSS/SCSS files to improve maintainability, consistency, and separation of concerns. Inline styles make components harder to maintain, reduce reusability, and violate the principle of separating presentation from logic.","repository":"SigNoz/signoz","domain":"observability","topic":"Code Style","language":"TSX","updated":"2025-08-05","comments":4,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-avoid-inline-styles.md"},{"slug":"workerd-add-explanatory-comments","title":"Add explanatory comments","description":"When code behavior, limitations, or implementation decisions are not immediately obvious from reading the code itself, add explanatory comments to clarify the reasoning and context. This is especially important for:","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Documentation","language":"TypeScript","updated":"2025-08-05","comments":4,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-add-explanatory-comments.md"},{"slug":"angular-api-terminology-consistency","title":"API terminology consistency","description":"Maintain consistent, precise terminology throughout API documentation and interfaces. Avoid ambiguous or misleading terms that could confuse developers about the API's behavior, and use professional language that clearly communicates the intended functionality.","repository":"angular/angular","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2025-08-05","comments":3,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-api-terminology-consistency.md"},{"slug":"duckdb-environment-variable-handling","title":"Environment variable handling","description":"When working with environment variables, follow consistent naming conventions, properly check for their presence, and preserve the environment when spawning subprocesses. Use standard naming patterns (e.g., `OPENSSL_VERSION_OVERRIDE` instead of `OPEN_SSL_VERSION_OVERRIDE`), check both command-line arguments and environment variables for configuration...","repository":"duckdb/duckdb","domain":"data-systems","topic":"Configurations","language":"Python","updated":"2025-08-05","comments":3,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-environment-variable-handling.md"},{"slug":"goose-document-non-obvious-code","title":"Document non-obvious code","description":"Add clear documentation for code elements that aren't immediately self-explanatory to improve readability and maintainability. This includes replacing magic numbers with named constants, adding explanatory comments for complex types, and ensuring documentation remains consistent and synchronized across different contexts.","repository":"block/goose","domain":"ai-agents","topic":"Documentation","language":"Rust","updated":"2025-08-05","comments":3,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-document-non-obvious-code.md"},{"slug":"istio-maintain-consistent-naming-patterns","title":"maintain consistent naming patterns","description":"Ensure naming consistency across related components and throughout the codebase to prevent developer confusion and maintenance issues. When similar concepts use different naming variations, choose one pattern and apply it consistently.","repository":"istio/istio","domain":"orchestration","topic":"Naming Conventions","language":"Yaml","updated":"2025-08-05","comments":3,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-maintain-consistent-naming-patterns.md"},{"slug":"openpilot-configuration-defaults-consistency","title":"Configuration defaults consistency","description":"Ensure configuration parameters have appropriate default values, consistent naming conventions, and centralized default management. When adding new configuration keys, consider security implications for defaults (e.g., audio recording should default to off), maintain consistent naming patterns with existing keys, and centralize default values in the...","repository":"commaai/openpilot","domain":"ml-systems","topic":"Configurations","language":"Other","updated":"2025-08-05","comments":3,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-configuration-defaults-consistency.md"},{"slug":"terminal-document-implementation-rationale","title":"Document implementation rationale","description":"Add comments that explain the reasoning behind non-obvious code decisions, technical constraints, or complex logic, while avoiding over-documentation of self-evident functionality. Focus on the \"why\" rather than the \"what\" - document implementation choices that future developers (including yourself) might need to rediscover.","repository":"microsoft/terminal","domain":"devtools","topic":"Documentation","language":"C++","updated":"2025-08-05","comments":3,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-document-implementation-rationale.md"},{"slug":"angular-consider-accessibility-in-markup","title":"Consider accessibility in markup","description":"When writing HTML markup, consider the accessibility implications of your formatting and structural choices. This includes avoiding text formatting that may negatively impact screen readers and ensuring proper semantic HTML usage.","repository":"angular/angular","domain":"app-frameworks","topic":"Code Style","language":"Html","updated":"2025-08-05","comments":2,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-consider-accessibility-in-markup.md"},{"slug":"goose-dependency-version-precision","title":"dependency version precision","description":"Choose appropriate version constraints in package.json based on stability requirements and risk tolerance. Use tilde (~) for patch-level updates when you want stability but need bug fixes, caret (^) for minor updates when you can tolerate feature additions, or exact versions for maximum control. For critical dependencies requiring precise version control,...","repository":"block/goose","domain":"ai-agents","topic":"Configurations","language":"Json","updated":"2025-08-05","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-dependency-version-precision.md"},{"slug":"kilocode-avoid-expensive-operations","title":"avoid expensive operations","description":"Identify and mitigate costly operations that can significantly impact performance. This includes CPU-intensive processing, expensive I/O operations, and repeated function calls that involve file system access or complex computations.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Performance Optimization","language":"TypeScript","updated":"2025-08-05","comments":2,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-avoid-expensive-operations.md"},{"slug":"posthog-follow-css-naming-patterns","title":"Follow CSS naming patterns","description":"Maintain consistency with established CSS naming conventions already used in the codebase. For CSS classes, follow BEM methodology when that's the existing pattern. For custom properties, use semantic names that clearly indicate their purpose and work across themes.","repository":"PostHog/posthog","domain":"data-systems","topic":"Naming Conventions","language":"Css","updated":"2025-08-05","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-follow-css-naming-patterns.md"},{"slug":"posthog-validate-schema-decisions","title":"validate schema decisions","description":"When reviewing database schema changes or data structure modifications, ensure that field inclusion/exclusion decisions are explicitly justified and documented. Question ambiguous schema choices and require clear rationale for data organization patterns.","repository":"PostHog/posthog","domain":"data-systems","topic":"Database","language":"Other","updated":"2025-08-05","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-validate-schema-decisions.md"},{"slug":"ui-tars-desktop-externalize-configuration-values","title":"Externalize configuration values","description":"Avoid hard-coding configuration values directly in source files. Instead, externalize them using environment variables, configuration files, or external resources. This improves maintainability, enables environment-specific settings, and reduces bundle sizes.","repository":"bytedance/UI-TARS-desktop","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-08-05","comments":2,"stars":18021,"raw":"https://awesomereviewers.com/raw/ui-tars-desktop-externalize-configuration-values.md"},{"slug":"volcano-avoid-redundant-operations","title":"Avoid redundant operations","description":"Eliminate duplicate computations, unnecessary API calls, and redundant processing to improve performance and reduce system load. This includes avoiding duplicate function calls, minimizing API server requests, and implementing early returns or caching to prevent redundant work.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Performance Optimization","language":"Go","updated":"2025-08-04","comments":7,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-avoid-redundant-operations.md"},{"slug":"dify-http-standards-compliance","title":"HTTP standards compliance","description":"Ensure API endpoints follow HTTP standards for status codes and method selection. Delete operations should return 204 (No Content) without a response body, while update operations should use PUT method instead of GET. This improves API consistency and follows REST conventions.","repository":"langgenius/dify","domain":"llm-infra","topic":"API","language":"Python","updated":"2025-08-04","comments":5,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-http-standards-compliance.md"},{"slug":"cal.com-prefer-early-returns","title":"Prefer early returns","description":"Use early returns and guard clauses instead of nested if-else statements to improve code readability and reduce complexity. Apply the fail-fast principle by handling edge cases and invalid conditions first, then proceeding with the main logic.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Code Style","language":"TSX","updated":"2025-08-04","comments":4,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-prefer-early-returns.md"},{"slug":"terminal-implement-defensive-validation","title":"Implement defensive validation","description":"Always validate inputs, check boundaries, and avoid relying on undocumented API behavior or assumptions about how functions handle edge cases. When dealing with potentially null or invalid data, implement explicit checks rather than assuming the API will behave consistently across all scenarios.","repository":"microsoft/terminal","domain":"devtools","topic":"Error Handling","language":"C++","updated":"2025-08-04","comments":4,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-implement-defensive-validation.md"},{"slug":"jan-simplify-error-handling","title":"simplify error handling","description":"Write concise and appropriate error handling code by avoiding unnecessary complexity and verbose constructions. Remove try-catch blocks when they serve no purpose, and use streamlined approaches for error message construction.","repository":"menloresearch/jan","domain":"llm-infra","topic":"Error Handling","language":"TSX","updated":"2025-08-04","comments":2,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-simplify-error-handling.md"},{"slug":"kilocode-ensure-proper-react-keys","title":"Ensure proper React keys","description":"Always provide meaningful keys for React components and fragments to ensure proper rendering and re-rendering behavior. Use composite keys when component identity depends on multiple values, and include keys even for Fragment components when rendering lists.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"React","language":"TSX","updated":"2025-08-04","comments":2,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-ensure-proper-react-keys.md"},{"slug":"query-stable-index-mapping","title":"Stable Index Mapping","description":"Prefer stable data-structure lookups over recomputing indices in update paths—especially when the underlying collection can reorder. **Guideline** 1. **Avoid linear searches in hot paths**: if you need an element’s position during frequent updates, don’t use patterns like `array.indexOf(x)` repeatedly. Use a map (e.g., `WeakMap`/`Map`) that gives the...","repository":"tanstack/query","domain":"app-frameworks","topic":"Algorithms","language":"TypeScript","updated":"2025-08-04","comments":2,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-stable-index-mapping.md"},{"slug":"terminal-add-comprehensive-explanatory-comments","title":"Add comprehensive explanatory comments","description":"When code involves complex relationships between multiple components or non-obvious usage patterns, add comprehensive explanatory comments that consolidate key information in one accessible location. This is especially important for files with multiple structs, classes, or APIs that work closely together.","repository":"microsoft/terminal","domain":"devtools","topic":"Documentation","language":"Other","updated":"2025-08-04","comments":2,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-add-comprehensive-explanatory-comments.md"},{"slug":"yoga-pin-dependency-versions","title":"Pin dependency versions","description":"Always specify exact versions for dependencies and avoid pointing to moving targets like \"master\" branches or \"latest\" tags in configuration files. This ensures reproducible builds and prevents unexpected breakages when upstream dependencies change.","repository":"facebook/yoga","domain":"runtimes","topic":"Configurations","language":"Other","updated":"2025-08-04","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-pin-dependency-versions.md"},{"slug":"workerd-configure-secret-scanning-exceptions","title":"Configure secret scanning exceptions","description":"When embedding test certificates or cryptographic keys in code for testing purposes, configure secret scanning tools to exclude these legitimate test artifacts to prevent false positive alerts. This ensures security tooling remains effective while avoiding alert fatigue that could lead to ignoring genuine security issues.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Security","language":"JavaScript","updated":"2025-08-04","comments":1,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-configure-secret-scanning-exceptions.md"},{"slug":"union-validate-before-type-conversions","title":"Validate before type conversions","description":"Always validate input constraints and use safe conversion methods before performing type conversions that could fail or produce undefined behavior. Avoid arbitrary casting with `as` operators, especially when the source value range may not fit the target type.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Null Handling","language":"Rust","updated":"2025-08-03","comments":4,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-validate-before-type-conversions.md"},{"slug":"browser-use-replace-polling-with-events","title":"Replace polling with events","description":"Replace busy-wait polling loops with event-driven async patterns using asyncio.Event() or similar synchronization primitives. Polling loops that continuously check state variables waste CPU cycles and block the event loop, while event-driven patterns allow the thread to yield control until the condition is actually met.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Concurrency","language":"Python","updated":"2025-08-03","comments":3,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-replace-polling-with-events.md"},{"slug":"openpilot-centralize-error-handling-utilities","title":"Centralize error handling utilities","description":"Create reusable error handling functions that accept custom error callbacks instead of duplicating error handling logic across multiple files. This approach provides flexibility in error response while maintaining consistent error handling patterns throughout the codebase.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Error Handling","language":"Other","updated":"2025-08-03","comments":2,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-centralize-error-handling-utilities.md"},{"slug":"tree-sitter-ensure-documentation-clarity","title":"Ensure documentation clarity","description":"Documentation should be clear, accurate, and provide meaningful information to users. Avoid misleading descriptions, template text that doesn't add value, and unclear explanations that leave users confused about functionality.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Documentation","language":"Rust","updated":"2025-08-02","comments":5,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-ensure-documentation-clarity.md"},{"slug":"lmcache-simplify-for-readability","title":"Simplify for readability","description":"Improve code readability by simplifying complex logic, using Pythonic idioms, and removing unnecessary code. Extract helper functions for complex conditions, avoid code duplication, and leverage Python's built-in features for cleaner code.","repository":"LMCache/LMCache","domain":"llm-infra","topic":"Code Style","language":"Python","updated":"2025-08-01","comments":7,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-simplify-for-readability.md"},{"slug":"istio-prevent-race-conditions","title":"prevent race conditions","description":"Always protect shared state access and ensure proper synchronization in concurrent operations to prevent race conditions. Key areas to review: 1. **Shared Data Mutation**: Never mutate shared data structures without proper synchronization. If data is accessed by multiple goroutines, use locks or create copies instead of in-place mutations.","repository":"istio/istio","domain":"orchestration","topic":"Concurrency","language":"Go","updated":"2025-08-01","comments":6,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-prevent-race-conditions.md"},{"slug":"mono-avoid-unnecessary-computations","title":"avoid unnecessary computations","description":"Optimize algorithms by eliminating redundant work and intermediate data structures. Look for opportunities to use lazy evaluation, conditional execution, and more efficient operations.","repository":"rocicorp/mono","domain":"data-systems","topic":"Algorithms","language":"TypeScript","updated":"2025-08-01","comments":5,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-avoid-unnecessary-computations.md"},{"slug":"volcano-always-check-errors","title":"Always check errors","description":"Always check and handle errors returned from function calls, especially API operations, before proceeding with subsequent logic. Unchecked errors can lead to inconsistent state, data corruption, or unexpected behavior.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Error Handling","language":"Go","updated":"2025-08-01","comments":4,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-always-check-errors.md"},{"slug":"istio-avoid-timing-dependencies","title":"avoid timing dependencies","description":"Eliminate timing dependencies in tests by using proper retry mechanisms and assertions instead of sleep statements. Sleep-based waits make tests flaky and unreliable, while retry mechanisms with conditions provide more robust test execution.","repository":"istio/istio","domain":"orchestration","topic":"Testing","language":"Go","updated":"2025-08-01","comments":3,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-avoid-timing-dependencies.md"},{"slug":"better-auth-api-endpoint-correctness","title":"API endpoint correctness","description":"API endpoints must behave according to their intended design, properly handling special values and executing expected operations like validation. This includes preserving meaningful null values (e.g., null representing \"no limit\") rather than replacing them with default values that change the intended behavior, and ensuring validation runs when expected.","repository":"better-auth/better-auth","domain":"security","topic":"API","language":"Markdown","updated":"2025-08-01","comments":2,"stars":19651,"raw":"https://awesomereviewers.com/raw/better-auth-api-endpoint-correctness.md"},{"slug":"better-auth-intentional-configuration-management","title":"Intentional configuration management","description":"Configuration choices should be intentional, balancing production requirements with developer experience while keeping configuration logic centralized in dedicated files rather than embedded inline.","repository":"better-auth/better-auth","domain":"security","topic":"Configurations","language":"Json","updated":"2025-08-01","comments":2,"stars":19651,"raw":"https://awesomereviewers.com/raw/better-auth-intentional-configuration-management.md"},{"slug":"langflow-document-implementation-reasoning","title":"Document implementation reasoning","description":"Add comments that explain WHY implementation decisions were made, not just WHAT the code does. This is especially important for backwards compatibility hacks, workarounds, non-obvious logic checks, and temporary solutions.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Documentation","language":"Python","updated":"2025-08-01","comments":2,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-document-implementation-reasoning.md"},{"slug":"langflow-document-log-level-options","title":"Document log level options","description":"When documenting logging configuration parameters, always provide the complete list of available log level options and use consistent naming conventions. This ensures developers understand all available choices and prevents confusion from incomplete documentation.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Logging","language":"Other","updated":"2025-08-01","comments":2,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-document-log-level-options.md"},{"slug":"mono-avoid-global-state","title":"avoid global state","description":"Avoid global state in concurrent environments where multiple instances, workers, or clients may share the same JavaScript context. Global variables and singletons can lead to unpredictable behavior when accessed concurrently.","repository":"rocicorp/mono","domain":"data-systems","topic":"Concurrency","language":"TypeScript","updated":"2025-08-01","comments":2,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-avoid-global-state.md"},{"slug":"cal.com-ensure-test-reliability","title":"ensure test reliability","description":"Write tests that are stable, independent, and non-flaky by following proper isolation and waiting practices. Tests should create their own data, clean up after themselves, and avoid dependencies on other tests or external state.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Testing","language":"TypeScript","updated":"2025-07-31","comments":5,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-ensure-test-reliability.md"},{"slug":"nx-verify-configuration-paths","title":"Verify configuration paths","description":"Ensure configuration property paths are accurate and complete, especially for nested configurations and context-specific placement. Many configuration issues stem from incorrect or incomplete property paths that prevent features from working properly.","repository":"nrwl/nx","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2025-07-31","comments":5,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-verify-configuration-paths.md"},{"slug":"cal.com-avoid-redundant-operations","title":"Avoid redundant operations","description":"Identify and eliminate duplicate or inefficient operations that waste computational resources. Common patterns to watch for include: 1. **Duplicate function calls**: Multiple calls to expensive operations like database queries or API endpoints within the same request flow","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Performance Optimization","language":"TypeScript","updated":"2025-07-31","comments":4,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-avoid-redundant-operations.md"},{"slug":"langflow-database-configuration-clarity","title":"Database configuration clarity","description":"When documenting database configuration or setup procedures, provide specific, actionable instructions with clear verification steps. Always specify which database backend is being used and include concrete examples for verification.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Database","language":"Other","updated":"2025-07-31","comments":4,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-database-configuration-clarity.md"},{"slug":"langflow-observability-documentation-structure","title":"observability documentation structure","description":"Use proper heading hierarchy instead of bold text formatting when documenting observability features like monitoring, failure points, and telemetry. This improves navigation, readability, and maintains consistent documentation structure across observability-related content.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Observability","language":"Other","updated":"2025-07-31","comments":3,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-observability-documentation-structure.md"},{"slug":"litellm-minimize-core-dependencies","title":"minimize core dependencies","description":"Keep core dependencies minimal in configuration files like pyproject.toml. Non-essential packages should be added as optional dependencies or placed in extras sections rather than as required core dependencies. This prevents package bloat and allows users to install only what they need.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Configurations","language":"Toml","updated":"2025-07-31","comments":3,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-minimize-core-dependencies.md"},{"slug":"novu-provide-specific-error-context","title":"Provide specific error context","description":"Error messages should be specific and contextual rather than generic, helping users understand exactly what went wrong and where. When handling errors, provide detailed information about the cause and set errors on the specific fields or components that triggered them.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Error Handling","language":"TSX","updated":"2025-07-31","comments":3,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-provide-specific-error-context.md"},{"slug":"playwright-environment-variable-validation","title":"Environment variable validation","description":"Environment variables should be properly validated, parsed, and have sensible fallback values. Always validate boolean environment variables using explicit string comparisons rather than truthy checks, provide clear default values, and implement proper error handling for malformed values.","repository":"microsoft/playwright","domain":"devtools","topic":"Configurations","language":"TypeScript","updated":"2025-07-31","comments":3,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-environment-variable-validation.md"},{"slug":"langflow-implement-concurrent-safety-patterns","title":"Implement concurrent safety patterns","description":"When designing concurrent systems, implement comprehensive safety patterns that handle resource lifecycle management, race conditions, and proper cleanup mechanisms. This includes setting resource limits to prevent exhaustion, implementing timeout-based cleanup for idle resources, and handling database race conditions with proper rollback and retry logic.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Concurrency","language":"Python","updated":"2025-07-31","comments":2,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-implement-concurrent-safety-patterns.md"},{"slug":"opencut-tailwind-v4-z-syntax","title":"Tailwind v4 Z Syntax","description":"When using Tailwind CSS v4, follow the v4-supported utility syntax for z-index and similar numeric utilities. Prefer the non-bracket form `z-<number>` (e.g., `z-150`, `z-200`) instead of `z-[<number>]`; the JIT compiler will handle arbitrary numeric values and won’t drop these classes.","repository":"opencut-app/opencut","domain":"app-frameworks","topic":"Naming Conventions","language":"TSX","updated":"2025-07-31","comments":2,"stars":81817,"raw":"https://awesomereviewers.com/raw/opencut-tailwind-v4-z-syntax.md"},{"slug":"openpilot-optimize-mathematical-mappings","title":"optimize mathematical mappings","description":"Use consistent units and data representations throughout mathematical calculations to avoid unnecessary computational overhead. When working with value ranges, prefer direct mathematical mappings over multiple conversions, and leverage utility functions for range transformations.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Algorithms","language":"Other","updated":"2025-07-31","comments":2,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-optimize-mathematical-mappings.md"},{"slug":"posthog-use-allowlists-over-blocklists","title":"Use allowlists over blocklists","description":"When filtering data for security purposes, prefer allowlists (explicitly defining what is permitted) over blocklists (explicitly defining what is forbidden). Blocklists are inherently less secure because they can miss new threats, require constant maintenance as infrastructure changes, and operate on the assumption that anything not explicitly blocked is...","repository":"PostHog/posthog","domain":"data-systems","topic":"Security","language":"TypeScript","updated":"2025-07-31","comments":1,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-use-allowlists-over-blocklists.md"},{"slug":"playwright-use-descriptive-identifier-names","title":"Use descriptive identifier names","description":"Choose specific, descriptive names for variables, methods, types, and other identifiers that clearly communicate their purpose and behavior. Avoid generic names, unnecessary abbreviations, and assumptions about usage context.","repository":"microsoft/playwright","domain":"devtools","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-30","comments":10,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-use-descriptive-identifier-names.md"},{"slug":"angular-avoid-redundant-operations","title":"avoid redundant operations","description":"Identify and eliminate redundant computations, function calls, and expensive operations that can be cached, memoized, or combined. This includes avoiding repeated function invocations with the same parameters, caching expensive calculations, and combining multiple operations that access the same data.","repository":"angular/angular","domain":"app-frameworks","topic":"Performance Optimization","language":"TypeScript","updated":"2025-07-30","comments":5,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-avoid-redundant-operations.md"},{"slug":"duckdb-maintain-api-backward-compatibility","title":"maintain API backward compatibility","description":"When evolving APIs, prioritize backward compatibility by creating new methods or overloads rather than modifying existing function signatures. This prevents breaking changes for existing users and extensions.","repository":"duckdb/duckdb","domain":"data-systems","topic":"API","language":"Other","updated":"2025-07-30","comments":4,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-maintain-api-backward-compatibility.md"},{"slug":"goose-avoid-concurrency-anti-patterns","title":"avoid concurrency anti-patterns","description":"Avoid common concurrency anti-patterns that lead to race conditions, deadlocks, and unreliable behavior. Use structured approaches instead of ad-hoc solutions.","repository":"block/goose","domain":"ai-agents","topic":"Concurrency","language":"Rust","updated":"2025-07-30","comments":4,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-avoid-concurrency-anti-patterns.md"},{"slug":"angular-limit-error-handling-scope","title":"limit error handling scope","description":"When implementing error handling, carefully limit the scope of try-catch blocks to prevent cascading failures and ensure error handlers themselves cannot cause additional errors. Wrap only the specific operations that may throw, not the error handling logic itself.","repository":"angular/angular","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2025-07-30","comments":3,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-limit-error-handling-scope.md"},{"slug":"bazel-check-operation-failures","title":"Check operation failures","description":"Always validate inputs and check return values of operations that can fail, providing clear error messages when failures occur. This includes system calls, library functions, and user input validation.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Error Handling","language":"Other","updated":"2025-07-30","comments":3,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-check-operation-failures.md"},{"slug":"litellm-ensure-database-consistency","title":"Ensure database consistency","description":"Maintain data consistency by using appropriate database operations and ensuring transactional integrity when updating related fields. Choose the right ORM methods (upsert vs create) to handle potential duplicates, and ensure that updates to related fields across multiple tables happen atomically to prevent data drift.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Database","language":"Python","updated":"2025-07-30","comments":3,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-ensure-database-consistency.md"},{"slug":"union-organize-code-for-readability","title":"organize code for readability","description":"Structure code to maximize readability and maintainability through clear organization patterns. Use top-level control flow structures (like switch/match statements) to make logic paths obvious and easy to follow. Extract reusable functionality into separate modules or helper libraries to promote code reuse and reduce duplication. Isolate different concerns...","repository":"unionlabs/union","domain":"cloud-infra","topic":"Code Style","language":"Other","updated":"2025-07-30","comments":3,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-organize-code-for-readability.md"},{"slug":"workerd-defer-async-callbacks","title":"defer async callbacks","description":"Always ensure callbacks and event emissions are executed asynchronously to maintain proper timing and Node.js compatibility. Even when operations appear to complete synchronously, callbacks should be deferred using `queueMicrotask()` or `process.nextTick()` to match expected async behavior.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Concurrency","language":"TypeScript","updated":"2025-07-30","comments":3,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-defer-async-callbacks.md"},{"slug":"clickhouse-document-api-parameters-inline","title":"Document API parameters inline","description":"When designing APIs, prioritize clarity and self-documentation by adding inline comments for non-obvious parameters and choosing descriptive method names. This reduces the need for external documentation and makes the code more maintainable.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"API","language":"Other","updated":"2025-07-30","comments":2,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-document-api-parameters-inline.md"},{"slug":"playwright-validate-input-rigorously","title":"validate input rigorously","description":"Always validate and sanitize input data against established standards to prevent injection attacks and ensure consistent behavior. This includes validating ARIA attributes according to W3C specifications and encoding potentially dangerous content in CSS or HTML contexts.","repository":"microsoft/playwright","domain":"devtools","topic":"Security","language":"TypeScript","updated":"2025-07-30","comments":2,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-validate-input-rigorously.md"},{"slug":"tree-sitter-api-type-definition-consistency","title":"API type definition consistency","description":"When modifying API type definitions, ensure all related definition files are updated consistently and dependencies are properly managed. API types often exist in multiple formats (TypeScript definitions, JSON schemas, etc.) and must be kept in sync to maintain a coherent client interface.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"API","language":"TypeScript","updated":"2025-07-30","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-api-type-definition-consistency.md"},{"slug":"posthog-use-proper-authorization-attributes","title":"Use proper authorization attributes","description":"Avoid using Django framework attributes like `is_staff` and `is_impersonated` for application role checking, as these serve different purposes (admin panel access and user impersonation respectively). Instead, use application-specific role validation methods to ensure proper authorization.","repository":"PostHog/posthog","domain":"data-systems","topic":"Security","language":"TSX","updated":"2025-07-30","comments":1,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-use-proper-authorization-attributes.md"},{"slug":"duckdb-use-descriptive-naming","title":"Use descriptive naming","description":"Choose names that clearly communicate intent and purpose rather than being generic, abbreviated, or potentially misleading. Names should accurately reflect what the code does, not how it does it.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Naming Conventions","language":"C++","updated":"2025-07-29","comments":11,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-use-descriptive-naming.md"},{"slug":"playwright-proxy-configuration-precedence","title":"proxy configuration precedence","description":"Ensure proxy configuration follows proper precedence hierarchy and handles different proxy types correctly. User-specified proxy settings should always take priority over environment variables, similar to how browsers handle proxy configuration.","repository":"microsoft/playwright","domain":"devtools","topic":"Networking","language":"TypeScript","updated":"2025-07-29","comments":6,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-proxy-configuration-precedence.md"},{"slug":"duckdb-consistent-null-validation","title":"consistent null validation","description":"Ensure null checks and input validation are applied consistently across similar functions and code paths. When one function in an API performs null pointer checks or input validation, all similar functions should follow the same pattern to maintain predictable behavior and prevent runtime errors.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Null Handling","language":"C++","updated":"2025-07-29","comments":5,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-consistent-null-validation.md"},{"slug":"lmcache-eliminate-redundant-operations","title":"Eliminate redundant operations","description":"Avoid unnecessary function calls, I/O operations, and redundant checks that can significantly impact performance. Look for opportunities to consolidate operations, remove duplicate work, and streamline execution paths.","repository":"LMCache/LMCache","domain":"llm-infra","topic":"Performance Optimization","language":"Python","updated":"2025-07-29","comments":5,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-eliminate-redundant-operations.md"},{"slug":"discourse-use-dynamic-configuration-access","title":"Use dynamic configuration access","description":"Always access configuration values through proper service APIs rather than hardcoding them or using unreliable access patterns. This ensures configuration remains maintainable and behaves consistently across different contexts.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Configurations","language":"JavaScript","updated":"2025-07-29","comments":4,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-use-dynamic-configuration-access.md"},{"slug":"developer-roadmap-enforce-shared-code-style","title":"Enforce shared code style","description":"Keep style consistent by following the team’s codified rules for both formatting and language idioms, and enforce them via shared tooling. Apply this as a checklist:","repository":"kamranahmedse/developer-roadmap","domain":"docs","topic":"Code Style","language":"Markdown","updated":"2025-07-29","comments":3,"stars":354523,"raw":"https://awesomereviewers.com/raw/developer-roadmap-enforce-shared-code-style.md"},{"slug":"langflow-secure-credential-management","title":"Secure credential management","description":"Ensure sensitive data like API keys, passwords, and encryption keys are stored securely and never exposed in code, configuration files, or documentation. This prevents credential leakage and unauthorized access to external services and systems.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Security","language":"Other","updated":"2025-07-29","comments":3,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-secure-credential-management.md"},{"slug":"signoz-use-database-transactions","title":"Use database transactions","description":"Always use database transactions when performing operations that require atomicity or could create race conditions. This includes scenarios where you check for existence before creating/updating records, or when multiple related database operations must succeed or fail together.","repository":"SigNoz/signoz","domain":"observability","topic":"Database","language":"Go","updated":"2025-07-29","comments":3,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-use-database-transactions.md"},{"slug":"workerd-clear-descriptive-naming","title":"Clear descriptive naming","description":"Choose names that clearly communicate intent without requiring mental gymnastics to understand. Avoid double negatives in variable names, maintain consistent naming patterns across the codebase, and ensure names accurately describe their purpose and context.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-29","comments":3,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-clear-descriptive-naming.md"},{"slug":"kilocode-follow-consistent-semantic-naming","title":"Follow consistent semantic naming","description":"Ensure that names accurately reflect their purpose and maintain consistency with established patterns in the codebase. Method names should clearly indicate their behavior - avoid misleading conventions when they don't match the actual functionality. Similarly, maintain consistent naming patterns across similar contexts.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Naming Conventions","language":"TSX","updated":"2025-07-29","comments":2,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-follow-consistent-semantic-naming.md"},{"slug":"lmcache-network-service-identification","title":"network service identification","description":"Use descriptive string identifiers instead of numeric ports or generic IDs when designing network services to avoid conflicts and improve maintainability. Different network services should have clearly distinguishable communication channels.","repository":"LMCache/LMCache","domain":"llm-infra","topic":"Networking","language":"Python","updated":"2025-07-29","comments":2,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-network-service-identification.md"},{"slug":"router-avoid-repeated-object-creation","title":"Avoid repeated object creation","description":"Prevent performance degradation by avoiding the creation of functions, objects, regular expressions, and other expensive operations inside loops or frequently executed code paths. Instead, hoist these creations outside the loop or to a higher scope where they can be reused.","repository":"TanStack/router","domain":"app-frameworks","topic":"Performance Optimization","language":"TypeScript","updated":"2025-07-29","comments":2,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-avoid-repeated-object-creation.md"},{"slug":"signoz-explicit-configuration-management","title":"Explicit configuration management","description":"Configuration changes should be intentional, well-documented, and implemented using clean, understandable patterns. Avoid hacky workarounds like counter-based state management when simpler alternatives exist.","repository":"SigNoz/signoz","domain":"observability","topic":"Configurations","language":"TypeScript","updated":"2025-07-29","comments":2,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-explicit-configuration-management.md"},{"slug":"signoz-meaningful-abc-usage","title":"meaningful ABC usage","description":"Only inherit from ABC when you have abstract methods that subclasses must implement. Avoid using ABC inheritance for classes that don't define any abstract methods, as this adds unnecessary complexity without providing the intended benefits of the abstract base class pattern.","repository":"SigNoz/signoz","domain":"observability","topic":"Code Style","language":"Python","updated":"2025-07-29","comments":2,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-meaningful-abc-usage.md"},{"slug":"react-router-api-consistency-patterns","title":"API consistency patterns","description":"Ensure API design follows consistent patterns for naming, typing, and composition to improve developer experience and maintainability. **Key principles:**","repository":"remix-run/react-router","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2025-07-28","comments":12,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-api-consistency-patterns.md"},{"slug":"core-mock-external-dependencies-only","title":"Mock external dependencies only","description":"When writing tests for Home Assistant integrations, mock external library dependencies rather than Home Assistant internals like coordinators, entities, or config entries. Test integration behavior through proper setup and service calls instead of directly manipulating internal objects.","repository":"home-assistant/core","domain":"app-frameworks","topic":"Testing","language":"Python","updated":"2025-07-28","comments":11,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-mock-external-dependencies-only.md"},{"slug":"llama.cpp-consolidate-algorithmic-patterns","title":"consolidate algorithmic patterns","description":"Avoid duplicating similar algorithmic logic across multiple functions by consolidating them into generic, templated, or trait-based implementations. This reduces maintenance burden and improves code consistency.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Algorithms","language":"CUDA","updated":"2025-07-28","comments":11,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-consolidate-algorithmic-patterns.md"},{"slug":"llvm-project-avoid-unnecessary-auto","title":"Avoid unnecessary auto","description":"Use explicit types instead of `auto` unless the type is obvious from the right-hand side of the assignment or impossible to spell. The LLVM coding standards recommend avoiding `auto` in most cases to improve code readability and maintainability.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Code Style","language":"C++","updated":"2025-07-28","comments":10,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-avoid-unnecessary-auto.md"},{"slug":"kafka-use-semantically-accurate-names","title":"Use semantically accurate names","description":"Choose names that accurately reflect the purpose, scope, and semantics of variables, methods, and classes. Names should be self-documenting and eliminate ambiguity about what the code element represents or does.","repository":"apache/kafka","domain":"data-systems","topic":"Naming Conventions","language":"Java","updated":"2025-07-28","comments":9,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-use-semantically-accurate-names.md"},{"slug":"cline-break-down-large-files","title":"break down large files","description":"Large files with multiple responsibilities should be broken down into focused, single-responsibility modules to improve maintainability and avoid tight coupling. When a file becomes difficult to navigate or contains unrelated functionality, extract logical components into separate files or classes.","repository":"cline/cline","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2025-07-28","comments":8,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-break-down-large-files.md"},{"slug":"core-avoid-code-duplication","title":"avoid code duplication","description":"Create reusable components instead of duplicating similar code patterns. When you find yourself writing similar classes, functions, or logic blocks, extract the common functionality into base classes, helper functions, or generic components that can be parameterized.","repository":"home-assistant/core","domain":"app-frameworks","topic":"Code Style","language":"Python","updated":"2025-07-28","comments":8,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-avoid-code-duplication.md"},{"slug":"llvm-project-use-descriptive-names","title":"Use descriptive names","description":"Choose names that clearly describe the purpose, behavior, and content of functions, variables, and constants. Names should be self-documenting and unambiguous to other developers.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Naming Conventions","language":"C++","updated":"2025-07-28","comments":8,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-use-descriptive-names.md"},{"slug":"neovim-reduce-test-verbosity","title":"reduce test verbosity","description":"Write concise, efficient tests by eliminating repetitive code and combining related test cases. Avoid verbose patterns that can be simplified with better approaches.","repository":"neovim/neovim","domain":"devtools","topic":"Testing","language":"Other","updated":"2025-07-28","comments":8,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-reduce-test-verbosity.md"},{"slug":"llama.cpp-eliminate-code-duplication","title":"eliminate code duplication","description":"Avoid duplicating code blocks by extracting common functionality into reusable functions, using templates for type-generic operations, and moving shared utilities to common modules. Code duplication makes maintenance difficult, increases the likelihood of bugs, and violates the DRY (Don't Repeat Yourself) principle.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Code Style","language":"C++","updated":"2025-07-28","comments":7,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-eliminate-code-duplication.md"},{"slug":"llama.cpp-leverage-existing-framework-functionality","title":"leverage existing framework functionality","description":"Before implementing custom solutions in AI model conversion code, thoroughly investigate whether the framework already provides the needed functionality. This applies to inheritance patterns, configuration handling, tensor operations, and mapping conventions.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"AI","language":"Python","updated":"2025-07-28","comments":7,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-leverage-existing-framework-functionality.md"},{"slug":"llvm-project-avoid-unnecessary-allocations","title":"avoid unnecessary allocations","description":"Minimize performance overhead by avoiding unnecessary memory allocations, expensive data structures, and redundant object creation. Choose appropriate data types and parameter passing methods based on actual requirements rather than convenience.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Performance Optimization","language":"C++","updated":"2025-07-28","comments":7,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-avoid-unnecessary-allocations.md"},{"slug":"react-router-organize-related-code-together","title":"organize related code together","description":"Keep related functionality grouped together to improve code discoverability and maintainability. This includes placing related functions in the same module, maintaining consistent test file placement, and avoiding unnecessary file fragmentation.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2025-07-28","comments":7,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-organize-related-code-together.md"},{"slug":"core-use-shared-string-keys","title":"Use shared string keys","description":"Replace hardcoded strings in configuration files with shared string key references to maintain consistency and enable centralized management. This practice reduces duplication, ensures uniform messaging across components, and makes updates easier to maintain.","repository":"home-assistant/core","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2025-07-28","comments":6,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-use-shared-string-keys.md"},{"slug":"kilocode-extract-reusable-utilities","title":"extract reusable utilities","description":"When you notice repeated logic or functions that could be shared across multiple files, extract them into dedicated utility files. This improves code organization, reduces duplication, and minimizes merge conflicts.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2025-07-28","comments":6,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-extract-reusable-utilities.md"},{"slug":"neovim-documentation-accuracy-standards","title":"Documentation accuracy standards","description":"Ensure all function documentation accurately reflects the actual code behavior and includes complete, properly formatted descriptions of parameters and return values.","repository":"neovim/neovim","domain":"devtools","topic":"Documentation","language":"C","updated":"2025-07-28","comments":6,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-documentation-accuracy-standards.md"},{"slug":"neovim-prioritize-code-readability","title":"prioritize code readability","description":"Write code that prioritizes readability and clarity over brevity. Use proper formatting, clear expressions, and consistent patterns to make code easier to understand and maintain.","repository":"neovim/neovim","domain":"devtools","topic":"Code Style","language":"Other","updated":"2025-07-28","comments":6,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-prioritize-code-readability.md"},{"slug":"cline-reuse-common-message-types","title":"reuse common message types","description":"Prefer reusable message types over single-purpose request/response pairs to reduce API bloat and improve maintainability. Avoid creating dedicated \"Response\" types when the return value can be a plain, reusable struct. Merge identical request types and leverage common message patterns like StringRequest or EmptyRequest where appropriate.","repository":"cline/cline","domain":"ai-agents","topic":"API","language":"Other","updated":"2025-07-28","comments":5,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-reuse-common-message-types.md"},{"slug":"gemini-cli-add-tests-for-changes","title":"add tests for changes","description":"Every code change, whether it's a new feature, bug fix, or refactoring, must include corresponding tests. This ensures code quality, prevents regressions, and maintains system reliability.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Testing","language":"TypeScript","updated":"2025-07-28","comments":5,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-add-tests-for-changes.md"},{"slug":"llvm-project-cost-based-algorithmic-decisions","title":"cost-based algorithmic decisions","description":"When implementing algorithmic transformations and optimizations, use cost analysis and profitability heuristics to guide decision-making rather than applying transformations blindly. This includes choosing appropriate data structures based on access patterns, placing optimizations at the correct architectural level, and validating that algorithmic changes...","repository":"llvm/llvm-project","domain":"runtimes","topic":"Algorithms","language":"Other","updated":"2025-07-28","comments":5,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-cost-based-algorithmic-decisions.md"},{"slug":"llvm-project-minimize-header-dependencies","title":"minimize header dependencies","description":"Organize code to minimize header dependencies and improve compilation times. Use forward declarations instead of includes when possible, avoid unnecessary dependencies, and follow proper header organization patterns.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Code Style","language":"Other","updated":"2025-07-28","comments":5,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-minimize-header-dependencies.md"},{"slug":"llvm-project-use-descriptive-semantic-names","title":"Use descriptive semantic names","description":"Choose specific, meaningful names that clearly convey purpose and follow established codebase patterns. Avoid generic terms that could apply to many different concepts.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Naming Conventions","language":"Other","updated":"2025-07-28","comments":5,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-use-descriptive-semantic-names.md"},{"slug":"neovim-prefer-concise-expressions","title":"prefer concise expressions","description":"Write concise, readable code by choosing the most direct expression for simple operations. Use ternary operators for simple boolean assignments instead of verbose if-else blocks, but avoid unnecessary ternaries when direct boolean assignment works. Return comparison results directly rather than using intermediate variables or verbose conditional blocks.","repository":"neovim/neovim","domain":"devtools","topic":"Code Style","language":"C","updated":"2025-07-28","comments":5,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-prefer-concise-expressions.md"},{"slug":"react-router-api-naming-consistency","title":"API naming consistency","description":"Ensure related APIs use consistent naming patterns, parameter structures, and calling conventions across the codebase. When introducing new APIs alongside existing ones, maintain naming consistency to provide clarity and reduce cognitive load for developers.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2025-07-28","comments":5,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-api-naming-consistency.md"},{"slug":"angular-guard-nullable-value-access","title":"Guard nullable value access","description":"Always use appropriate guards or type checks before accessing potentially null or undefined values. Prefer type-safe guard methods that provide both runtime protection and TypeScript type narrowing over manual null checks.","repository":"angular/angular","domain":"app-frameworks","topic":"Null Handling","language":"Markdown","updated":"2025-07-28","comments":4,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-guard-nullable-value-access.md"},{"slug":"cal.com-configuration-access-patterns","title":"Configuration access patterns","description":"Ensure configuration data is accessed through proper service layers with dependency injection rather than direct database calls in presentation components. Configuration settings should be retrieved via dedicated repository classes or service methods, not through direct Prisma interactions in getServerSideProps or component logic.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Configurations","language":"TSX","updated":"2025-07-28","comments":4,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-configuration-access-patterns.md"},{"slug":"core-batch-operations-efficiently","title":"Batch operations efficiently","description":"Collect and execute similar operations together rather than performing them individually to reduce overhead and improve performance. This applies to entity creation, API calls, and state updates.","repository":"home-assistant/core","domain":"app-frameworks","topic":"Performance Optimization","language":"Python","updated":"2025-07-28","comments":4,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-batch-operations-efficiently.md"},{"slug":"llvm-project-configuration-completeness-validation","title":"Configuration completeness validation","description":"Ensure configuration options are complete and properly validated before use. When implementing configuration parsing or option handling, verify that all expected cases are covered and add appropriate validation checks for user inputs.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Configurations","language":"C++","updated":"2025-07-28","comments":4,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-configuration-completeness-validation.md"},{"slug":"llvm-project-optimize-computational-complexity","title":"optimize computational complexity","description":"When implementing algorithms, be mindful of computational complexity and optimize for efficiency by avoiding expensive operations and reusing existing computations where possible.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Algorithms","language":"C++","updated":"2025-07-28","comments":4,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-optimize-computational-complexity.md"},{"slug":"mastodon-use-accessible-terminology","title":"Use accessible terminology","description":"Choose clear, understandable names and terminology that are appropriate for your intended audience, avoiding technical jargon or obscure references that may not be widely understood. This is especially important for user-facing strings, error messages, and interface labels.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Naming Conventions","language":"Yaml","updated":"2025-07-28","comments":4,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-use-accessible-terminology.md"},{"slug":"novu-environment-aware-feature-gating","title":"Environment-aware feature gating","description":"Always check environment variables, deployment modes, subscription tiers, and feature flags before enabling functionality or changing application behavior. Combine multiple configuration checks when necessary to ensure features are only available in appropriate contexts.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Configurations","language":"TSX","updated":"2025-07-28","comments":4,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-environment-aware-feature-gating.md"},{"slug":"playwright-validate-algorithmic-edge-cases","title":"validate algorithmic edge cases","description":"Algorithms must be thoroughly tested at boundary conditions and edge cases to prevent subtle bugs. Pay special attention to off-by-1 errors in mathematical calculations, empty collections, and boundary values that might cause unexpected behavior.","repository":"microsoft/playwright","domain":"devtools","topic":"Algorithms","language":"TypeScript","updated":"2025-07-28","comments":4,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-validate-algorithmic-edge-cases.md"},{"slug":"spark-session-specific-configuration-access","title":"Session-specific configuration access","description":"Always access configuration through the appropriate session context rather than using global configuration access. This ensures that session-specific settings are respected and maintains consistency across different execution contexts.","repository":"apache/spark","domain":"data-systems","topic":"Configurations","language":"Other","updated":"2025-07-28","comments":4,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-session-specific-configuration-access.md"},{"slug":"core-use-asynciogather-concurrency","title":"Use asyncio.gather concurrency","description":"When performing multiple independent async operations, use `asyncio.gather()` to execute them concurrently instead of sequentially. This improves performance by allowing operations to run in parallel rather than waiting for each to complete before starting the next.","repository":"home-assistant/core","domain":"app-frameworks","topic":"Concurrency","language":"Python","updated":"2025-07-28","comments":3,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-use-asynciogather-concurrency.md"},{"slug":"discourse-avoid-optimization-anti-patterns","title":"Avoid optimization anti-patterns","description":"Identify and eliminate code patterns that appear to be performance optimizations but actually hurt performance or negate their intended benefits. Common anti-patterns include:","repository":"discourse/discourse","domain":"app-frameworks","topic":"Performance Optimization","language":"Other","updated":"2025-07-28","comments":3,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-avoid-optimization-anti-patterns.md"},{"slug":"gemini-cli-maintain-consistent-naming","title":"Maintain consistent naming","description":"Ensure naming consistency across all contexts where an identifier appears - configuration files, code enums, documentation, and user interfaces. Names should be semantically clear and distinguish between related but different entities.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Naming Conventions","language":"Markdown","updated":"2025-07-28","comments":3,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-maintain-consistent-naming.md"},{"slug":"kafka-validate-configurations-early","title":"Validate configurations early","description":"Perform comprehensive configuration validation as early as possible in the execution flow, before any state modifications occur. This prevents invalid configurations from causing partial state changes and ensures cleaner error handling.","repository":"apache/kafka","domain":"data-systems","topic":"Configurations","language":"Other","updated":"2025-07-28","comments":3,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-validate-configurations-early.md"},{"slug":"llama.cpp-choose-appropriate-error-mechanism","title":"Choose appropriate error mechanism","description":"Use GGML_ASSERT for early validation and programming errors that indicate misconfigurations, but implement graceful error handling with logging for runtime conditions where fallback options exist. Assertions should catch problems early in development, while runtime errors should provide informative feedback and allow system recovery when possible.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Error Handling","language":"C++","updated":"2025-07-28","comments":3,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-choose-appropriate-error-mechanism.md"},{"slug":"llvm-project-minimize-test-complexity","title":"minimize test complexity","description":"Tests should be minimal and focused on the specific functionality being verified. Remove unnecessary passes, tools, or operations that aren't directly related to what's being tested to reduce noise and improve clarity.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Testing","language":"Other","updated":"2025-07-28","comments":3,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-minimize-test-complexity.md"},{"slug":"lmcache-choose-efficient-data-structures","title":"Choose efficient data structures","description":"Select appropriate built-in data structures and algorithmic patterns that eliminate manual checks and reduce code complexity. This improves both performance and maintainability by leveraging Python's optimized implementations.","repository":"LMCache/LMCache","domain":"llm-infra","topic":"Algorithms","language":"Python","updated":"2025-07-28","comments":3,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-choose-efficient-data-structures.md"},{"slug":"spark-context-independent-schema-design","title":"context-independent schema design","description":"Database schema elements (views, constraints, tables) should be designed to be context-independent and self-contained. This means all identifiers should be fully qualified, and only information supported by the SQL parser should be included in DDL representations.","repository":"apache/spark","domain":"data-systems","topic":"Database","language":"Java","updated":"2025-07-28","comments":3,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-context-independent-schema-design.md"},{"slug":"core-api-response-transformation","title":"API response transformation","description":"When integrating external APIs, implement a translation layer that transforms responses into a standardized, user-friendly format. This protects consumers from upstream API changes and ensures responses are self-documenting without requiring external documentation.","repository":"home-assistant/core","domain":"app-frameworks","topic":"API","language":"Other","updated":"2025-07-28","comments":2,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-api-response-transformation.md"},{"slug":"langflow-comprehensive-coverage-collection","title":"Comprehensive coverage collection","description":"Configure Jest to collect coverage data from all source files, not just those with existing tests, while avoiding test failures due to coverage thresholds. Coverage enforcement should be handled by external reporting tools rather than the test runner itself.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Testing","language":"JavaScript","updated":"2025-07-28","comments":2,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-comprehensive-coverage-collection.md"},{"slug":"llvm-project-choose-appropriate-string-types","title":"Choose appropriate string types","description":"Select the most efficient string type based on ownership and lifetime requirements to optimize memory usage and prevent safety issues. Use `StringRef` for parameters and when you don't need to own the string data, `std::string` when you need ownership and persistence, and avoid storing `Twine` objects as member variables.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Performance Optimization","language":"Other","updated":"2025-07-28","comments":2,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-choose-appropriate-string-types.md"},{"slug":"llvm-project-explicit-invalid-value-handling","title":"explicit invalid value handling","description":"When designing enums or working with type casting, explicitly define and handle invalid states rather than relying on undefined behavior. Use designated invalid values that stand out clearly, and employ equality assertions for type compatibility checks.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Null Handling","language":"Other","updated":"2025-07-28","comments":2,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-explicit-invalid-value-handling.md"},{"slug":"llvm-project-match-api-complexity-appropriately","title":"match API complexity appropriately","description":"Design APIs with complexity that matches their actual use cases and adopt established patterns that improve clarity. Avoid over-engineering interfaces when simpler alternatives suffice, and prefer modern, well-established patterns over legacy approaches.","repository":"llvm/llvm-project","domain":"runtimes","topic":"API","language":"Other","updated":"2025-07-28","comments":2,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-match-api-complexity-appropriately.md"},{"slug":"llvm-project-preserve-known-test-issues","title":"preserve known test issues","description":"When tests exhibit known false positives or false negatives, preserve these test cases with clear documentation rather than removing them. This practice prevents accidental \"fixes\" that mask underlying problems and helps track when issues are genuinely resolved.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Testing","language":"C","updated":"2025-07-28","comments":2,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-preserve-known-test-issues.md"},{"slug":"llvm-project-specify-network-protocol-endianness","title":"specify network protocol endianness","description":"Always explicitly specify byte order (endianness) in network protocol documentation and implementations. Even when a specification mandates a particular endianness, make it clear in your documentation to avoid confusion and implementation errors.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Networking","language":"Markdown","updated":"2025-07-28","comments":2,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-specify-network-protocol-endianness.md"},{"slug":"llvm-project-structure-contextual-log-messages","title":"structure contextual log messages","description":"Log messages should include sufficient contextual information and structured formatting to enable effective debugging and filtering. This means including relevant metadata, level information, and clear prefixes that help developers understand the source and severity of logged events.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Logging","language":"Other","updated":"2025-07-28","comments":2,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-structure-contextual-log-messages.md"},{"slug":"llvm-project-write-accessible-documentation","title":"Write accessible documentation","description":"Documentation should be written with clarity and completeness to serve readers who may not have deep domain expertise. Use precise, unambiguous language that avoids technical jargon when simpler alternatives exist, and provide necessary context about origins, rationale, and background information.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Documentation","language":"Markdown","updated":"2025-07-28","comments":2,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-write-accessible-documentation.md"},{"slug":"lobe-chat-explicit-type-checking","title":"Explicit type checking","description":"Use explicit type checks instead of just undefined checks to prevent null values from being passed to functions or APIs that don't expect them. Checking only for undefined can still allow null values to pass through, which may cause runtime errors.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2025-07-28","comments":2,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-explicit-type-checking.md"},{"slug":"neovim-follow-protocol-standards","title":"follow protocol standards","description":"When implementing network protocols or communication formats, prioritize standardized specifications over legacy or device-specific formats, even when existing code uses older approaches. Legacy formats may work but can cause compatibility issues and confusion for applications that expect standard compliance.","repository":"neovim/neovim","domain":"devtools","topic":"Networking","language":"C","updated":"2025-07-28","comments":2,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-follow-protocol-standards.md"},{"slug":"core-classify-data-sensitivity","title":"classify data sensitivity","description":"Properly evaluate whether data contains sensitive information before applying security measures like redaction. Not all identifiers or structured data require protection - understand the nature and content of the data to make informed security decisions.","repository":"home-assistant/core","domain":"app-frameworks","topic":"Security","language":"Other","updated":"2025-07-28","comments":1,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-classify-data-sensitivity.md"},{"slug":"neovim-security-warnings-need-guidance","title":"Security warnings need guidance","description":"Security-related warnings and error messages should provide clear, actionable guidance on how users can safely resolve the issue, not just inform them of the problem. When displaying security warnings, include specific instructions that guide users through the secure workflow.","repository":"neovim/neovim","domain":"devtools","topic":"Security","language":"Other","updated":"2025-07-28","comments":1,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-security-warnings-need-guidance.md"},{"slug":"core-consistent-naming-standards","title":"Consistent naming standards","description":"Ensure all user-facing strings follow Home Assistant's naming conventions for consistency and proper internationalization. This includes using sentence-case for translatable strings, proper spelling and capitalization of technical terms, and leveraging common string references where available.","repository":"home-assistant/core","domain":"app-frameworks","topic":"Naming Conventions","language":"Json","updated":"2025-07-27","comments":14,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-consistent-naming-standards.md"},{"slug":"helix-consistent-highlighting-patterns","title":"consistent highlighting patterns","description":"Maintain consistency in syntax highlighting patterns by using appropriate, specific scopes and avoiding overly complex or noisy patterns. Follow Helix-specific conventions rather than generic tree-sitter patterns.","repository":"helix-editor/helix","domain":"devtools","topic":"Code Style","language":"Other","updated":"2025-07-27","comments":12,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-consistent-highlighting-patterns.md"},{"slug":"zod-stable-controllable-api","title":"Stable, Controllable API","description":"When changing or adding public API in schema/validation libraries, prioritize a stable, user-controlled surface: - Avoid “deprecated-from-day-1” APIs. If an equivalent non-deprecated API already exists, prefer removing/migrating rather than adding new deprecated entry points.","repository":"colinhacks/zod","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2025-07-27","comments":9,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-stable-controllable-api.md"},{"slug":"core-clear-variable-naming","title":"Clear variable naming","description":"Use descriptive, unambiguous variable and function names that clearly convey their purpose and avoid conflicts with Python built-ins or Home Assistant conventions.","repository":"home-assistant/core","domain":"app-frameworks","topic":"Naming Conventions","language":"Python","updated":"2025-07-27","comments":8,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-clear-variable-naming.md"},{"slug":"llama.cpp-maintain-naming-consistency","title":"maintain naming consistency","description":"Follow established naming patterns and conventions consistently throughout the codebase. This includes using consistent formatting (dashes vs underscores), proper capitalization, descriptive parameter names, and uniform data type representations.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Naming Conventions","language":"C++","updated":"2025-07-27","comments":8,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-maintain-naming-consistency.md"},{"slug":"cline-check-before-property-access","title":"Check before property access","description":"Always verify that parent objects and properties exist before accessing nested properties or calling methods on them. Use optional chaining (`?.`) only when the parent object might genuinely be null or undefined, not as a blanket safety measure for guaranteed values. When values can be undefined, provide meaningful defaults rather than arbitrary fallbacks.","repository":"cline/cline","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2025-07-27","comments":6,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-check-before-property-access.md"},{"slug":"neovim-validate-early-fail-fast","title":"validate early, fail fast","description":"Perform comprehensive input validation and precondition checks at the beginning of functions, before executing any operations that could have side effects or modify system state. This prevents partial execution, inconsistent states, and resource leaks when validation fails.","repository":"neovim/neovim","domain":"devtools","topic":"Error Handling","language":"C","updated":"2025-07-27","comments":5,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-validate-early-fail-fast.md"},{"slug":"tree-sitter-parameter-type-clarity","title":"parameter type clarity","description":"Design API parameters using specific, intention-revealing types rather than generic or ambiguous ones. This improves code readability, prevents misuse, and makes the API's behavior self-documenting.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"API","language":"Rust","updated":"2025-07-27","comments":4,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-parameter-type-clarity.md"},{"slug":"llama.cpp-ai-documentation-precision","title":"AI documentation precision","description":"Ensure documentation for AI/ML tools and libraries is precise, complete, and properly formatted. This includes being specific about tool references, providing complete command-line option formats, and using proper markdown formatting.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"AI","language":"Markdown","updated":"2025-07-27","comments":3,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-ai-documentation-precision.md"},{"slug":"llvm-project-explicit-configuration-requirements","title":"Explicit configuration requirements","description":"Always specify explicit configuration parameters rather than relying on default settings that may vary across different build environments or target platforms. This is particularly critical in test files where assumptions about default compiler settings, target triples, or language standards can cause failures in cross-compilation scenarios or different...","repository":"llvm/llvm-project","domain":"runtimes","topic":"Configurations","language":"C","updated":"2025-07-27","comments":2,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-explicit-configuration-requirements.md"},{"slug":"llvm-project-improve-code-readability","title":"improve code readability","description":"When code expressions become complex or difficult to understand at first glance, refactor them for better readability. This can be achieved through several techniques: extracting complex expressions into well-named variables, using named regex groups instead of numeric indices, or reformatting conditional logic into more concise forms.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Code Style","language":"Python","updated":"2025-07-27","comments":2,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-improve-code-readability.md"},{"slug":"sglang-ai-model-documentation-consistency","title":"AI model documentation consistency","description":"Ensure consistent parameter names and configuration instructions across AI model documentation. Inconsistent documentation about model parsers, parameters, and configuration options leads to developer confusion and implementation errors.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"AI","language":"Other","updated":"2025-07-27","comments":2,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-ai-model-documentation-consistency.md"},{"slug":"core-trust-server-side-validation","title":"trust server-side validation","description":"When integrating with external APIs or services that implement their own input validation, avoid duplicating that validation logic on the client side. Trust the authoritative server's validation mechanisms rather than attempting to replicate them locally.","repository":"home-assistant/core","domain":"app-frameworks","topic":"Security","language":"Json","updated":"2025-07-27","comments":1,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-trust-server-side-validation.md"},{"slug":"neovim-api-consistency-patterns","title":"API consistency patterns","description":"Ensure similar API functions use consistent parameter patterns, types, and behaviors. When designing new APIs or modifying existing ones, identify related functions and align their interfaces to create predictable, reusable patterns.","repository":"neovim/neovim","domain":"devtools","topic":"API","language":"Other","updated":"2025-07-26","comments":7,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-api-consistency-patterns.md"},{"slug":"gemini-cli-use-semantic-naming","title":"Use semantic naming","description":"Choose names that clearly communicate the purpose, behavior, and intent of variables, methods, classes, and interfaces. Avoid ambiguous or misleading names that require additional context to understand.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-26","comments":6,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-use-semantic-naming.md"},{"slug":"gemini-cli-never-ignore-errors-silently","title":"Never ignore errors silently","description":"All errors must be explicitly handled through catching, logging, or user feedback. Silent error suppression makes debugging impossible and creates poor user experiences.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Error Handling","language":"TSX","updated":"2025-07-26","comments":5,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-never-ignore-errors-silently.md"},{"slug":"llama.cpp-use-model-metadata","title":"use model metadata","description":"Leverage model metadata from GGUF format instead of hardcoded configuration values or filename-based logic. Model metadata provides authoritative information about model behavior and should be the primary source for configuration decisions.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"AI","language":"C++","updated":"2025-07-26","comments":5,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-use-model-metadata.md"},{"slug":"lmcache-cache-state-consistency","title":"Cache state consistency","description":"Ensure cache operations maintain consistent state and handle shared resources properly throughout the cache lifecycle. This includes proper key type management, safe eviction of shared entries, and accurate state tracking across different operational phases.","repository":"LMCache/LMCache","domain":"llm-infra","topic":"Caching","language":"Python","updated":"2025-07-26","comments":5,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-cache-state-consistency.md"},{"slug":"spark-avoid-unnecessary-computations","title":"avoid unnecessary computations","description":"Prevent performance degradation by avoiding unnecessary expensive operations such as premature execution, redundant iterations, and costly data conversions. Use lazy evaluation, short-circuiting, and efficient data handling patterns to optimize execution paths.","repository":"apache/spark","domain":"data-systems","topic":"Performance Optimization","language":"Other","updated":"2025-07-26","comments":5,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-avoid-unnecessary-computations.md"},{"slug":"core-api-documentation-consistency","title":"API documentation consistency","description":"Ensure all API-related descriptions, field names, and documentation accurately reflect the terminology and specifications used by external service providers. Descriptions should be consistent between code comments, user-facing strings, and external documentation.","repository":"home-assistant/core","domain":"app-frameworks","topic":"API","language":"Json","updated":"2025-07-26","comments":4,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-api-documentation-consistency.md"},{"slug":"core-consistent-documentation-language","title":"Consistent documentation language","description":"Maintain consistency in wording, formatting, and specificity across all documentation strings to improve readability and translation quality. Key practices:","repository":"home-assistant/core","domain":"app-frameworks","topic":"Documentation","language":"Json","updated":"2025-07-26","comments":4,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-consistent-documentation-language.md"},{"slug":"nuxt-handle-async-cancellation-properly","title":"Handle async cancellation properly","description":"When implementing async operations with cancellation support, ensure that cancelled operations do not continue to update application state and that all cleanup logic is properly consolidated. This prevents race conditions where cancelled requests might still modify data after cancellation.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Concurrency","language":"TypeScript","updated":"2025-07-26","comments":4,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-handle-async-cancellation-properly.md"},{"slug":"cline-ai-provider-naming-clarity","title":"AI provider naming clarity","description":"Use specific, unambiguous names for AI providers and models to prevent confusion when working with multiple AI services. Avoid generic names that could be mistaken for other providers or create ambiguity about the underlying service.","repository":"cline/cline","domain":"ai-agents","topic":"AI","language":"TypeScript","updated":"2025-07-26","comments":3,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-ai-provider-naming-clarity.md"},{"slug":"volcano-standardize-configuration-formats","title":"Standardize configuration formats","description":"Ensure all plugin configurations follow a consistent, structured format across the codebase to improve maintainability and user experience. Different plugins and features should not use ad-hoc configuration styles that make the system fragmented and difficult to understand.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Configurations","language":"Markdown","updated":"2025-07-26","comments":3,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-standardize-configuration-formats.md"},{"slug":"cline-analyze-async-operation-dependencies","title":"Analyze async operation dependencies","description":"Before choosing between sequential awaits and parallel execution (Promise.all), carefully analyze whether operations have dependencies that require specific execution order. Operations that depend on each other's results or shared state must be executed sequentially to prevent race conditions.","repository":"cline/cline","domain":"ai-agents","topic":"Concurrency","language":"TSX","updated":"2025-07-26","comments":2,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-analyze-async-operation-dependencies.md"},{"slug":"cline-use-null-meaningfully","title":"Use null meaningfully","description":"Choose between null and undefined based on semantic intent rather than convenience. Use null when operations can explicitly fail and you want to represent that failure state, allowing consumers to handle it appropriately. Use optional properties (?) when a value may simply not be provided or initialized.","repository":"cline/cline","domain":"ai-agents","topic":"Null Handling","language":"TSX","updated":"2025-07-26","comments":2,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-use-null-meaningfully.md"},{"slug":"signoz-use-secure-credential-storage","title":"Use secure credential storage","description":"Avoid storing sensitive credentials like usernames and passwords in environment variables. Instead, use dedicated secrets management systems such as HashiCorp Vault, AWS Secrets Manager, Azure Key Vault, or your CI/CD platform's built-in secrets management.","repository":"SigNoz/signoz","domain":"observability","topic":"Security","language":"TypeScript","updated":"2025-07-26","comments":1,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-use-secure-credential-storage.md"},{"slug":"gemini-cli-organize-code-by-responsibility","title":"organize code by responsibility","description":"Place code at the appropriate abstraction level and extract complex logic to dedicated modules. Large files like App.tsx and gemini.tsx should focus on their core responsibilities, with specific functionality moved to specialized components or utility files.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Code Style","language":"TSX","updated":"2025-07-25","comments":9,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-organize-code-by-responsibility.md"},{"slug":"mastodon-use-descriptive-specific-names","title":"Use descriptive specific names","description":"Choose descriptive, specific names that clearly communicate intent and behavior rather than generic or ambiguous alternatives. Names should be self-documenting and reduce the need for additional context or comments.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Naming Conventions","language":"Ruby","updated":"2025-07-25","comments":9,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-use-descriptive-specific-names.md"},{"slug":"gemini-cli-prevent-concurrent-state-races","title":"Prevent concurrent state races","description":"When multiple operations can execute concurrently (e.g., multiple keystrokes in the same React event loop, simultaneous async calls), ensure they don't operate on stale state or create race conditions. Use centralized state management patterns like reducers, proper synchronization flags, and avoid direct state manipulation from concurrent contexts.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Concurrency","language":"TypeScript","updated":"2025-07-25","comments":8,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-prevent-concurrent-state-races.md"},{"slug":"neovim-consistent-naming-conventions","title":"consistent naming conventions","description":"Maintain consistent naming patterns and terminology across the codebase to reduce cognitive load and improve code clarity. The same concept should always use the same name in different contexts.","repository":"neovim/neovim","domain":"devtools","topic":"Naming Conventions","language":"Other","updated":"2025-07-25","comments":8,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-consistent-naming-conventions.md"},{"slug":"gemini-cli-reduce-nesting-complexity","title":"reduce nesting complexity","description":"Prefer early returns, guard clauses, and helper method extraction to reduce nesting levels and improve code readability. Deep nesting makes code harder to follow and understand.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2025-07-25","comments":7,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-reduce-nesting-complexity.md"},{"slug":"neovim-complete-function-documentation","title":"Complete function documentation","description":"Ensure all functions have comprehensive, accurate documentation including required tags (@param, @return, @since), clear descriptions that match actual behavior, and explanatory comments for complex logic.","repository":"neovim/neovim","domain":"devtools","topic":"Documentation","language":"Other","updated":"2025-07-25","comments":7,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-complete-function-documentation.md"},{"slug":"core-use-appropriate-logging-levels","title":"Use appropriate logging levels","description":"Choose the correct logging level based on the nature and expected frequency of the event being logged. Follow these guidelines: **Use `debug` for application events:** The `info` level is reserved for system-level messages. Use `debug` for application-specific information like successful authentication, data processing steps, or operational status updates.","repository":"home-assistant/core","domain":"app-frameworks","topic":"Logging","language":"Python","updated":"2025-07-25","comments":6,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-use-appropriate-logging-levels.md"},{"slug":"dspy-api-backward-compatibility","title":"API backward compatibility","description":"Maintain backward compatibility when evolving API interfaces by preserving existing method signatures and parameter patterns. When adding new functionality, prefer extending existing interfaces over breaking changes, and use deprecation warnings for obsolete parameters.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"API","language":"Python","updated":"2025-07-25","comments":6,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-api-backward-compatibility.md"},{"slug":"llvm-project-provide-contextual-code-documentation","title":"Provide contextual code documentation","description":"Code should include documentation that explains the purpose, rationale, and context behind implementation decisions, not just what the code does. This helps future maintainers understand the reasoning and makes the codebase more maintainable.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Documentation","language":"C++","updated":"2025-07-25","comments":6,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-provide-contextual-code-documentation.md"},{"slug":"spark-optimize-data-structures","title":"optimize data structures","description":"Choose appropriate data structures and algorithms to optimize computational complexity and performance. Consider the specific use case and access patterns when selecting between different approaches.","repository":"apache/spark","domain":"data-systems","topic":"Algorithms","language":"Other","updated":"2025-07-25","comments":6,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-optimize-data-structures.md"},{"slug":"comfyui-api-backward-compatibility","title":"API backward compatibility","description":"Ensure API changes maintain backward compatibility to avoid breaking existing clients and workflows. When adding new functionality, use optional parameters with sensible defaults rather than required parameters. When versioning APIs, follow the `/api/v2/resource` pattern and maintain deprecated endpoints during transition periods to allow clients time to...","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"API","language":"Python","updated":"2025-07-25","comments":5,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-api-backward-compatibility.md"},{"slug":"core-prefer-none-over-placeholders","title":"prefer None over placeholders","description":"When data is unavailable, unknown, or invalid, return `None` instead of placeholder strings like \"Unknown\", \"Unspecified\", or \"???\". This makes the absence of data explicit and prevents downstream code from treating placeholder values as legitimate data.","repository":"home-assistant/core","domain":"app-frameworks","topic":"Null Handling","language":"Python","updated":"2025-07-25","comments":5,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-prefer-none-over-placeholders.md"},{"slug":"llvm-project-design-thoughtful-api-interfaces","title":"Design thoughtful API interfaces","description":"When designing APIs, prioritize clarity, appropriate abstraction levels, and user experience. Avoid magic numbers or unclear parameters by using named constants or helper functions. Choose the right balance between generic and specific interfaces - use specific types when the use case is well-defined, but design for genericity when supporting multiple...","repository":"llvm/llvm-project","domain":"runtimes","topic":"API","language":"C++","updated":"2025-07-25","comments":5,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-design-thoughtful-api-interfaces.md"},{"slug":"llvm-project-eliminate-redundant-null-checks","title":"Eliminate redundant null checks","description":"Avoid unnecessary null checks when the called function already handles null cases, and use references instead of pointers when null values are guaranteed not to occur.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Null Handling","language":"C++","updated":"2025-07-25","comments":5,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-eliminate-redundant-null-checks.md"},{"slug":"llvm-project-proper-error-propagation","title":"proper error propagation","description":"Ensure errors are properly propagated to callers rather than handled locally with exits or fatal errors. Library functions should return error information to allow callers to make appropriate decisions about error handling and recovery.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Error Handling","language":"C++","updated":"2025-07-25","comments":5,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-proper-error-propagation.md"},{"slug":"lmcache-ai-model-architecture-flexibility","title":"AI model architecture flexibility","description":"Avoid hardcoding AI model-specific assumptions and instead design systems to be configurable across different model architectures, data types, and configurations. This ensures your AI systems can adapt to evolving model designs and support multiple model families without requiring code changes.","repository":"LMCache/LMCache","domain":"llm-infra","topic":"AI","language":"Python","updated":"2025-07-25","comments":5,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-ai-model-architecture-flexibility.md"},{"slug":"mastodon-early-nil-validation","title":"early nil validation","description":"Check for nil values early in methods and handle them gracefully before they can cause runtime errors or trigger expensive operations. This prevents NoMethodError exceptions and improves performance by avoiding unnecessary processing.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Null Handling","language":"Ruby","updated":"2025-07-25","comments":5,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-early-nil-validation.md"},{"slug":"mastodon-use-semantic-naming","title":"Use semantic naming","description":"Choose names that clearly communicate purpose and align with established domain terminology. Prioritize semantic clarity over brevity, and ensure consistency with the codebase's vocabulary.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Naming Conventions","language":"Other","updated":"2025-07-25","comments":5,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-use-semantic-naming.md"},{"slug":"spark-prefer-simple-apis","title":"prefer simple APIs","description":"Design APIs with simplicity in mind by avoiding unnecessary method overloads, reducing configuration options, and preferring single well-designed methods that handle all cases rather than multiple variants.","repository":"apache/spark","domain":"data-systems","topic":"API","language":"Other","updated":"2025-07-25","comments":5,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-prefer-simple-apis.md"},{"slug":"unstructured-raise-exceptions-properly","title":"Raise exceptions properly","description":"Always ensure exceptions are properly raised and propagated rather than being logged and swallowed. Avoid patterns where errors are caught, logged, and then execution continues normally, as this can hide critical failures from calling code.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Error Handling","language":"Python","updated":"2025-07-25","comments":5,"stars":12116,"raw":"https://awesomereviewers.com/raw/unstructured-raise-exceptions-properly.md"},{"slug":"gemini-cli-centralize-configuration-management","title":"Centralize configuration management","description":"Prefer centralized configuration files (settings.json, settings.ts) over environment variables for application settings, especially when organizational control is needed. Avoid hardcoded assumptions about user environments and ensure configuration is loaded at appropriate initialization points.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Configurations","language":"TSX","updated":"2025-07-25","comments":4,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-centralize-configuration-management.md"},{"slug":"kafka-validate-configuration-dependencies","title":"validate configuration dependencies","description":"Validate configuration dependencies and constraints at initialization time rather than allowing invalid combinations to cause runtime failures. When configurations have interdependencies, implement validation logic that checks these relationships early and provides clear error messages.","repository":"apache/kafka","domain":"data-systems","topic":"Configurations","language":"Java","updated":"2025-07-25","comments":4,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-validate-configuration-dependencies.md"},{"slug":"kilocode-minimize-merge-conflicts","title":"minimize merge conflicts","description":"When working with upstream codebases, prioritize coding approaches that minimize merge conflicts while maintaining functionality. Keep dependency arrays in consistent order with upstream code, use CSS classes for conditional styling instead of conditional rendering to create smaller diffs, and isolate custom components in separate directories. For example,...","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Code Style","language":"TSX","updated":"2025-07-25","comments":4,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-minimize-merge-conflicts.md"},{"slug":"neovim-avoid-error-masking","title":"avoid error masking","description":"Don't use mechanisms that suppress or hide errors unless absolutely necessary for the application flow. Error masking makes debugging difficult and can hide important issues from users and developers.","repository":"neovim/neovim","domain":"devtools","topic":"Error Handling","language":"Other","updated":"2025-07-25","comments":4,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-avoid-error-masking.md"},{"slug":"neovim-avoid-unnecessary-configuration","title":"avoid unnecessary configuration","description":"Avoid creating special-purpose configuration options when simpler alternatives exist. Don't force users to call setup functions or provide explicit configuration for basic functionality to work.","repository":"neovim/neovim","domain":"devtools","topic":"Configurations","language":"Txt","updated":"2025-07-25","comments":4,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-avoid-unnecessary-configuration.md"},{"slug":"clickhouse-validate-user-inputs","title":"validate user inputs","description":"Always validate and properly escape user-controlled input before incorporating it into structured data formats like JSON, SQL, XML, or command strings. Unescaped input can lead to injection vulnerabilities that allow attackers to manipulate application logic or access unauthorized data.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Security","language":"C++","updated":"2025-07-25","comments":3,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-validate-user-inputs.md"},{"slug":"langflow-document-connection-parameters-clearly","title":"Document connection parameters clearly","description":"When documenting network connections (SSH, HTTP, database, etc.), provide clear explanations of all connection parameters, their security implications, and their relationships. Don't just list placeholders - explain what each parameter represents and why it's needed.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Networking","language":"Other","updated":"2025-07-25","comments":3,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-document-connection-parameters-clearly.md"},{"slug":"llama.cpp-systematic-test-coverage","title":"systematic test coverage","description":"When writing tests that need to cover multiple scenarios (different data types, backend capabilities, etc.), structure them systematically rather than duplicating code or hardcoding conditional logic.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Testing","language":"C++","updated":"2025-07-25","comments":3,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-systematic-test-coverage.md"},{"slug":"react-router-documentation-generation-compatibility","title":"documentation generation compatibility","description":"When making code changes, ensure compatibility with documentation generation tools like JSDoc and TypeDoc. This includes: (1) Exporting types that should appear in generated documentation, (2) Avoiding duplicate exports across modules that can confuse documentation parsers, and (3) Formatting code examples appropriately for documentation rendering.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Documentation","language":"TypeScript","updated":"2025-07-25","comments":3,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-documentation-generation-compatibility.md"},{"slug":"llama.cpp-metal-shared-memory-sizing","title":"Metal shared memory sizing","description":"When allocating shared memory for Metal compute shaders, ensure proper sizing that accounts for both SIMD group requirements and Metal platform constraints. Metal requires shared memory buffer sizes to be multiples of 16 bytes. Consider using simplified allocation strategies that meet platform requirements while maintaining correctness.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Performance Optimization","language":"Objective-C","updated":"2025-07-25","comments":2,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-metal-shared-memory-sizing.md"},{"slug":"opengrep-extract-duplicated-logic","title":"Extract duplicated logic","description":"When you notice the same code pattern appearing in multiple places, extract it into a reusable function rather than copy-pasting. Duplicated code is error-prone and harder to maintain. Look for repeated logic, data structure creation patterns, or similar operations that can be abstracted.","repository":"opengrep/opengrep","domain":"security","topic":"Code Style","language":"Other","updated":"2025-07-25","comments":2,"stars":1546,"raw":"https://awesomereviewers.com/raw/opengrep-extract-duplicated-logic.md"},{"slug":"spark-optimize-expensive-operations","title":"optimize expensive operations","description":"Before executing computationally expensive operations, implement conditional checks to determine if the operation is actually necessary. This optimization technique can significantly improve performance by avoiding costly computations when simpler alternatives exist or when the operation can be skipped entirely.","repository":"apache/spark","domain":"data-systems","topic":"Algorithms","language":"Python","updated":"2025-07-25","comments":2,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-optimize-expensive-operations.md"},{"slug":"istio-document-security-behavior-references","title":"Document security behavior references","description":"When implementing security-related functionality such as certificate parsing, cryptographic validation, or authentication mechanisms, always document the expected behavior and include references to official documentation that explains the underlying security decisions.","repository":"istio/istio","domain":"orchestration","topic":"Security","language":"Other","updated":"2025-07-25","comments":1,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-document-security-behavior-references.md"},{"slug":"kubernetes-clear-field-documentation","title":"Clear field documentation","description":"Write precise, unambiguous documentation that explains what fields and methods represent rather than implementation details. Avoid recursive definitions, ambiguous terms, and focus on the user-facing behavior and purpose.","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"Documentation","language":"Go","updated":"2025-07-24","comments":7,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-clear-field-documentation.md"},{"slug":"llvm-project-comprehensive-test-coverage","title":"comprehensive test coverage","description":"Tests should comprehensively cover all relevant scenarios, including return values, edge cases, different compilation modes, and abnormal conditions. This includes:","repository":"llvm/llvm-project","domain":"runtimes","topic":"Testing","language":"C++","updated":"2025-07-24","comments":7,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-comprehensive-test-coverage.md"},{"slug":"lobe-chat-add-unit-tests","title":"Add unit tests","description":"All new functionality must include corresponding unit tests. This is especially critical for utility functions, core logic modules, stream processing, data transformation methods, and complex business logic. Without unit tests, code becomes difficult to understand and maintain over time.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Testing","language":"TypeScript","updated":"2025-07-24","comments":7,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-add-unit-tests.md"},{"slug":"cline-grpc-interface-consistency","title":"gRPC interface consistency","description":"Ensure gRPC/RPC interfaces follow consistent patterns for return types, error handling, and method design. Avoid creating duplicate RPC methods when existing ones can be reused, use proper gRPC clients instead of direct imports, and maintain type safety with specific parameter types rather than generic objects.","repository":"cline/cline","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2025-07-24","comments":6,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-grpc-interface-consistency.md"},{"slug":"kafka-avoid-unnecessary-object-creation","title":"avoid unnecessary object creation","description":"Minimize object allocation in performance-critical code paths by reusing existing objects, caching expensive operations, and choosing efficient alternatives to object creation patterns.","repository":"apache/kafka","domain":"data-systems","topic":"Performance Optimization","language":"Java","updated":"2025-07-24","comments":6,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-avoid-unnecessary-object-creation.md"},{"slug":"gemini-cli-api-consistency-patterns","title":"API consistency patterns","description":"Maintain consistent interface patterns across APIs and avoid loose coupling through magic strings or unstable properties. APIs should follow established conventions and provide stable, well-defined contracts.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2025-07-24","comments":5,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-api-consistency-patterns.md"},{"slug":"gemini-cli-implement-resource-constraints","title":"implement resource constraints","description":"Implement multiple types of resource constraints with appropriate thresholds to prevent performance degradation and resource exhaustion. This includes rate limiting, memory thresholds, execution time limits, and queue size bounds.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Performance Optimization","language":"TypeScript","updated":"2025-07-24","comments":5,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-implement-resource-constraints.md"},{"slug":"gemini-cli-maintain-naming-consistency","title":"Maintain naming consistency","description":"Ensure consistent naming patterns and approaches across similar functionality in the codebase. This includes using named constants instead of magic strings, aligning input handling patterns with existing code, maintaining consistent identifier formats, and following established conventions from libraries or existing implementations.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Naming Conventions","language":"TSX","updated":"2025-07-24","comments":5,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-maintain-naming-consistency.md"},{"slug":"kubernetes-optimize-search-algorithms","title":"Optimize search algorithms","description":"Implement efficient search strategies that minimize computational overhead through proper ordering, early termination, and targeted scope reduction. This involves three key principles:","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"Algorithms","language":"Go","updated":"2025-07-24","comments":5,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-optimize-search-algorithms.md"},{"slug":"llama.cpp-optimize-memory-access-patterns","title":"optimize memory access patterns","description":"Ensure CUDA kernels use optimal memory access patterns to maximize performance. This involves several key practices: 1. **Use `__restrict__` qualifiers** on pointer parameters to inform the compiler that pointers don''t alias, enabling better optimizations especially on older GPUs.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Performance Optimization","language":"CUDA","updated":"2025-07-24","comments":5,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-optimize-memory-access-patterns.md"},{"slug":"workerd-avoid-unnecessary-allocations","title":"avoid unnecessary allocations","description":"Minimize object creation and memory copying operations to improve performance. Cache and reuse objects when possible, use buffer views instead of copying data, and avoid creating temporary objects that will be immediately discarded.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Performance Optimization","language":"TypeScript","updated":"2025-07-24","comments":5,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-avoid-unnecessary-allocations.md"},{"slug":"kafka-ensure-complete-javadoc-coverage","title":"Ensure complete JavaDoc coverage","description":"All public classes, methods, and parameters must have comprehensive JavaDoc documentation. This includes: 1. **Class-level JavaDoc**: Every public class and interface requires JavaDoc explaining its purpose and usage","repository":"apache/kafka","domain":"data-systems","topic":"Documentation","language":"Java","updated":"2025-07-24","comments":4,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-ensure-complete-javadoc-coverage.md"},{"slug":"kafka-optimize-data-structures","title":"optimize data structures","description":"When working with data structures and collections, optimize for performance and correctness by using modern APIs, proper sizing, result filtering, and lazy initialization. Use `List.of()` and `Map.of()` instead of legacy `Collections.singletonList()` and `Collections.singletonMap()` for better readability and performance. Size collections appropriately -...","repository":"apache/kafka","domain":"data-systems","topic":"Database","language":"Java","updated":"2025-07-24","comments":4,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-optimize-data-structures.md"},{"slug":"kubernetes-prevent-information-disclosure","title":"Prevent information disclosure","description":"Avoid exposing sensitive information through error messages, logs, configuration, or other output channels that might be accessible to unauthorized parties such as cluster administrators or operators.","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"Security","language":"Go","updated":"2025-07-24","comments":4,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-prevent-information-disclosure.md"},{"slug":"kubernetes-wrap-errors-meaningfully","title":"Wrap errors meaningfully","description":"Always wrap errors with meaningful context that explains what operation failed and why. Use proper error wrapping with `fmt.Errorf(\"operation failed: %w\", err)` to preserve the original error chain while adding context. Include explanatory comments for complex error handling logic to clarify the intended behavior and recovery strategy.","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"Error Handling","language":"Go","updated":"2025-07-24","comments":4,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-wrap-errors-meaningfully.md"},{"slug":"neovim-consolidate-network-apis","title":"consolidate network APIs","description":"When implementing network functionality, consolidate around standardized APIs like `vim.net.request()` instead of maintaining custom download functions or direct curl calls. Implement comprehensive testing for network operations using integration test guards to prevent failures in environments without network access.","repository":"neovim/neovim","domain":"devtools","topic":"Networking","language":"Other","updated":"2025-07-24","comments":4,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-consolidate-network-apis.md"},{"slug":"deno-environment-loading-order","title":"environment loading order","description":"Environment files and variables must be loaded before creating any factories, services, or components that depend on them. This ensures that environment-based configuration propagates correctly throughout the application lifecycle.","repository":"denoland/deno","domain":"runtimes","topic":"Configurations","language":"Rust","updated":"2025-07-24","comments":3,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-environment-loading-order.md"},{"slug":"deno-network-address-validation","title":"network address validation","description":"When validating network addresses and interfaces, properly handle special address values and use protocol-specific prefixes to avoid ambiguity. Network address validation should account for standard special addresses like `INADDR_ANY` (0.0.0.0) which allows the operating system to choose an appropriate interface, rather than treating them as invalid. For...","repository":"denoland/deno","domain":"runtimes","topic":"Networking","language":"Rust","updated":"2025-07-24","comments":3,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-network-address-validation.md"},{"slug":"electron-use-semantically-accurate-names","title":"Use semantically accurate names","description":"Choose parameter and method names that accurately reflect their semantic meaning and implementation reality, rather than names that may be misleading or platform-specific.","repository":"electron/electron","domain":"devtools","topic":"Naming Conventions","language":"Markdown","updated":"2025-07-24","comments":3,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-use-semantically-accurate-names.md"},{"slug":"gemini-cli-document-configuration-defaults-clearly","title":"Document configuration defaults clearly","description":"When documenting configuration options, always specify exact file paths, explicit default values, and clarify potentially confusing settings to prevent user confusion. This includes documenting where settings are persisted, what happens when optional properties are omitted, and explaining any non-obvious behavior like token budget comparisons.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2025-07-24","comments":3,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-document-configuration-defaults-clearly.md"},{"slug":"kafka-validate-network-state","title":"validate network state","description":"Always validate network connectivity and cluster state before attempting network operations. Check for leader availability, partition existence, and proper metadata state to avoid unnecessary network calls and provide better error handling.","repository":"apache/kafka","domain":"data-systems","topic":"Networking","language":"Java","updated":"2025-07-24","comments":3,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-validate-network-state.md"},{"slug":"nx-avoid-redundant-ci-operations","title":"avoid redundant CI operations","description":"CI/CD processes should eliminate unnecessary repetition and redundant operations across projects and builds. This includes avoiding repeated warning messages, preferring template-based configurations over runtime string replacements, and ensuring operations are performed once at the appropriate level rather than repeatedly for each project.","repository":"nrwl/nx","domain":"devtools","topic":"CI/CD","language":"TypeScript","updated":"2025-07-24","comments":3,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-avoid-redundant-ci-operations.md"},{"slug":"spark-comprehensive-test-coverage","title":"comprehensive test coverage","description":"Ensure test suites provide comprehensive coverage by including edge cases, boundary conditions, and input variations while verifying that tests actually validate the intended functionality. Tests should cover different input formats (case sensitivity, precision levels), boundary values (empty inputs, maximum/minimum values), and error conditions. Remove...","repository":"apache/spark","domain":"data-systems","topic":"Testing","language":"Sql","updated":"2025-07-24","comments":3,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-comprehensive-test-coverage.md"},{"slug":"gemini-cli-avoid-non-null-assertions","title":"avoid non-null assertions","description":"Avoid using the non-null assertion operator (`!`) and instead use union types or explicit null checks for better type safety. Non-null assertions bypass TypeScript's null safety checks and can lead to runtime errors if the assumption is incorrect.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2025-07-24","comments":2,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-avoid-non-null-assertions.md"},{"slug":"kafka-document-configuration-constraints","title":"Document configuration constraints","description":"Configuration documentation must explicitly specify when settings should or should not be used, including conditional requirements and mutually exclusive options. This prevents misconfigurations and helps developers understand the proper context for each setting.","repository":"apache/kafka","domain":"data-systems","topic":"Configurations","language":"Html","updated":"2025-07-24","comments":2,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-document-configuration-constraints.md"},{"slug":"langflow-validate-migration-conflicts","title":"Validate migration conflicts","description":"Before applying database migrations, systematically validate existing data and check for potential conflicts with current schema constraints. This prevents migration failures and ensures backward compatibility.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Migrations","language":"Python","updated":"2025-07-24","comments":2,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-validate-migration-conflicts.md"},{"slug":"litellm-configurable-security-settings","title":"configurable security settings","description":"Security configurations should be made configurable through environment variables or runtime settings rather than hardcoded in the application logic. This allows teams to adapt security measures to different deployment environments and regulatory requirements without code changes.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Security","language":"Python","updated":"2025-07-24","comments":2,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-configurable-security-settings.md"},{"slug":"llvm-project-protect-shared-data","title":"protect shared data","description":"Always protect shared data that can be accessed by multiple threads using appropriate synchronization mechanisms. Identify potential race conditions where shared state could be modified concurrently and choose the right protection mechanism.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Concurrency","language":"C++","updated":"2025-07-24","comments":2,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-protect-shared-data.md"},{"slug":"sglang-ai-dependency-justification","title":"AI dependency justification","description":"When modifying AI library dependencies, always provide clear justification for version choices, especially when using non-standard sources like git commits or release candidates. This is critical for AI projects where library compatibility and stability directly impact model performance and inference reliability.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"AI","language":"Toml","updated":"2025-07-24","comments":2,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-ai-dependency-justification.md"},{"slug":"firecrawl-secure-xml-parsing","title":"secure XML parsing","description":"When configuring XML parsing options, carefully evaluate security implications of each setting, especially those that enable potentially risky features like DTD processing. Document the business justification for enabling such features and verify that the chosen library provides adequate protection against common XML-based attacks (XXE, DTD attacks, etc.).","repository":"firecrawl/firecrawl","domain":"ai-agents","topic":"Security","language":"Rust","updated":"2025-07-24","comments":1,"stars":54535,"raw":"https://awesomereviewers.com/raw/firecrawl-secure-xml-parsing.md"},{"slug":"kubernetes-comprehensive-test-coverage","title":"Comprehensive test coverage","description":"Ensure comprehensive test coverage by systematically considering all scenarios, edge cases, and feature combinations when adding or modifying functionality. This includes testing both positive and negative cases, feature gate enabled/disabled states, error conditions, and boundary conditions.","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"Testing","language":"Go","updated":"2025-07-23","comments":16,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-comprehensive-test-coverage.md"},{"slug":"rust-validate-boundary-conditions","title":"Validate boundary conditions","description":"Ensure algorithms handle boundary conditions and edge cases correctly by adding explicit validation for all input ranges. Special attention should be paid to index calculations, offset arithmetic, and memory management operations, as these are common sources of subtle bugs that only manifest in edge cases.","repository":"rust-lang/rust","domain":"runtimes","topic":"Algorithms","language":"Rust","updated":"2025-07-23","comments":16,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-validate-boundary-conditions.md"},{"slug":"spark-optimize-database-operations","title":"optimize database operations","description":"When working with database operations, prioritize batching multiple statements and pushing operations down to the database level for optimal performance. Use batch statements instead of executing individual prepared statements, and implement proper compatibility checks before attempting query pushdown optimizations.","repository":"apache/spark","domain":"data-systems","topic":"Database","language":"Other","updated":"2025-07-23","comments":16,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-optimize-database-operations.md"},{"slug":"n8n-guard-against-null","title":"Guard against null","description":"Always use optional chaining (`?.`) and nullish coalescing (`??`) operators when accessing potentially undefined or null properties. These patterns prevent TypeErrors when accessing nested properties and provide appropriate defaults only when values are null or undefined.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2025-07-23","comments":14,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-guard-against-null.md"},{"slug":"electron-api-parameter-consistency","title":"API parameter consistency","description":"Ensure consistent parameter handling across API methods by using appropriate defaults, proper type conversion, validation with meaningful constants, and cross-platform behavior consistency.","repository":"electron/electron","domain":"devtools","topic":"API","language":"Other","updated":"2025-07-23","comments":13,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-api-parameter-consistency.md"},{"slug":"kafka-comprehensive-test-coverage","title":"comprehensive test coverage","description":"Ensure tests cover not only the happy path but also edge cases, error scenarios, and complete workflows. Many code reviews reveal gaps where only basic functionality is tested while important edge cases, exception handling, and integration scenarios are missing.","repository":"apache/kafka","domain":"data-systems","topic":"Testing","language":"Java","updated":"2025-07-23","comments":11,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-comprehensive-test-coverage.md"},{"slug":"kubernetes-feature-gate-field-preservation","title":"Feature gate field preservation","description":"When implementing feature-gated fields, always preserve existing field values when the feature gate is disabled, but drop new field values that depend on disabled features. This prevents breaking existing functionality during feature gate transitions or version skew scenarios.","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"Configurations","language":"Go","updated":"2025-07-23","comments":11,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-feature-gate-field-preservation.md"},{"slug":"kubernetes-use-semantically-clear-names","title":"Use semantically clear names","description":"Choose names that accurately reflect the actual functionality, purpose, or semantic meaning rather than using generic, misleading, or implementation-focused terms. Names should be self-documenting and help readers understand what the code does without needing additional context.","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"Naming Conventions","language":"Go","updated":"2025-07-23","comments":11,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-use-semantically-clear-names.md"},{"slug":"kubernetes-simplify-code-structure","title":"simplify code structure","description":"Prioritize code simplification by removing unnecessary complexity, avoiding duplication, and leveraging existing utilities. This improves readability and maintainability while reducing potential bugs.","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"Code Style","language":"Go","updated":"2025-07-23","comments":10,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-simplify-code-structure.md"},{"slug":"rust-keep-documentation-purposefully-minimal","title":"Keep documentation purposefully minimal","description":"Documentation should be concise, focused, and maintainable. Follow these principles: 1. Keep examples short and demonstrate one concept at a time 2. Avoid redundant documentation across related items","repository":"rust-lang/rust","domain":"runtimes","topic":"Documentation","language":"Rust","updated":"2025-07-23","comments":9,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-keep-documentation-purposefully-minimal.md"},{"slug":"svelte-prefer-simple-code-patterns","title":"prefer simple code patterns","description":"Choose straightforward, readable code patterns over complex or clever alternatives. This improves maintainability and reduces cognitive load for other developers.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Code Style","language":"JavaScript","updated":"2025-07-23","comments":9,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-prefer-simple-code-patterns.md"},{"slug":"hyprland-maintain-clean-code-structure","title":"Maintain clean code structure","description":"Keep code well-organized by separating interface from implementation, managing dependencies properly, and following consistent structural patterns. Function bodies should remain in implementation files rather than headers to reduce compilation dependencies and improve maintainability. Organize includes strategically - move them to implementation files when...","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Code Style","language":"Other","updated":"2025-07-23","comments":8,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-maintain-clean-code-structure.md"},{"slug":"kubernetes-api-field-documentation","title":"API field documentation","description":"API fields must be comprehensively documented with clear behavior specifications, format constraints, and interaction details. This includes documenting how fields interact with each other, specifying allowed formats and validation rules, clarifying field semantics and placement decisions, and aligning naming conventions with existing Kubernetes APIs.","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"API","language":"Go","updated":"2025-07-23","comments":8,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-api-field-documentation.md"},{"slug":"n8n-prevent-null-reference-exceptions","title":"Prevent null reference exceptions","description":"Always use optional chaining and nullish coalescing operators to prevent runtime errors when accessing properties or methods on potentially undefined objects.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Null Handling","language":"Other","updated":"2025-07-23","comments":8,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-prevent-null-reference-exceptions.md"},{"slug":"kubernetes-avoid-unnecessary-work","title":"Avoid unnecessary work","description":"Optimize performance by avoiding unnecessary computations, allocations, and operations. Use feature gates, lazy evaluation, and conditional logic to prevent work that won't be used.","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"Performance Optimization","language":"Go","updated":"2025-07-23","comments":7,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-avoid-unnecessary-work.md"},{"slug":"prisma-consistent-clear-naming","title":"Consistent clear naming","description":"Use consistent terminology across similar concepts and choose names that clearly indicate their purpose. Avoid overloaded terms that cause confusion in your domain context, and ensure naming conventions align with established patterns.","repository":"prisma/prisma","domain":"data-systems","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-23","comments":7,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-consistent-clear-naming.md"},{"slug":"roo-code-maintain-consistent-terminology-patterns","title":"Maintain consistent terminology patterns","description":"Ensure consistent terminology usage across the codebase, especially in localization files and technical documentation. When a term is established (whether in translation or technical context), maintain that same term throughout related files and contexts.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Naming Conventions","language":"Json","updated":"2025-07-23","comments":7,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-maintain-consistent-terminology-patterns.md"},{"slug":"typescript-document-function-behavior-completely","title":"Document function behavior completely","description":"Functions should be documented with comprehensive JSDoc comments that cover: 1. Purpose and behavior description 2. All parameters with their types and constraints","repository":"microsoft/typescript","domain":"runtimes","topic":"Documentation","language":"TypeScript","updated":"2025-07-23","comments":7,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-document-function-behavior-completely.md"},{"slug":"gemini-cli-ensure-comprehensive-user-documentation","title":"Ensure comprehensive user documentation","description":"All user-facing features, APIs, and tools must have clear, comprehensive documentation that explains their purpose, limitations, and usage. Documentation should use terminology that users can understand, provide helpful guidance for common scenarios, and include warnings about potential issues.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Documentation","language":"TypeScript","updated":"2025-07-23","comments":6,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-ensure-comprehensive-user-documentation.md"},{"slug":"gemini-cli-classify-errors-appropriately","title":"classify errors appropriately","description":"Different types of errors require different handling strategies. Classify errors into categories and apply appropriate response patterns: fail fast for user-actionable problems, retry with backoff for transient issues, and graceful degradation for non-critical failures.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2025-07-23","comments":5,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-classify-errors-appropriately.md"},{"slug":"kafka-api-completeness-validation","title":"API completeness validation","description":"Ensure APIs are complete by validating that all necessary cases are handled, all required arguments are properly validated, and response structures are consistent across similar operations.","repository":"apache/kafka","domain":"data-systems","topic":"API","language":"Java","updated":"2025-07-23","comments":5,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-api-completeness-validation.md"},{"slug":"mastodon-optimize-database-queries","title":"Optimize database queries","description":"Write efficient database queries by leveraging proper indexes, using performance-optimized ActiveRecord methods, and avoiding unnecessary database operations. Key practices include:","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Database","language":"Ruby","updated":"2025-07-23","comments":5,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-optimize-database-queries.md"},{"slug":"n8n-optimize-loop-operations","title":"Optimize loop operations","description":"Avoid repeated computations and object creation in loops or high-frequency operations. Move invariant calculations outside the loop and reuse objects rather than creating new instances on each iteration. This reduces CPU overhead, memory churn, and improves performance in critical code paths.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Performance Optimization","language":"TypeScript","updated":"2025-07-23","comments":5,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-optimize-loop-operations.md"},{"slug":"rust-benchmark-before-optimizing-code","title":"Benchmark before optimizing code","description":"Always validate performance optimizations with benchmarks before implementation. Ensure measurements account for: 1. Platform-specific characteristics (32-bit vs 64-bit)","repository":"rust-lang/rust","domain":"runtimes","topic":"Performance Optimization","language":"Rust","updated":"2025-07-23","comments":5,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-benchmark-before-optimizing-code.md"},{"slug":"supabase-structure-components-with-clarity","title":"Structure components with clarity","description":"Maintain clean and logical component organization by following these guidelines: 1. Keep related files together - place test files beside their components rather than in separate folders","repository":"supabase/supabase","domain":"data-systems","topic":"Code Style","language":"TSX","updated":"2025-07-23","comments":5,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-structure-components-with-clarity.md"},{"slug":"kafka-catch-specific-exceptions","title":"catch specific exceptions","description":"Avoid catching overly broad exception types like `Throwable` or `Exception` when you can be more specific about the expected failure modes. Catching `Throwable` is particularly dangerous as it captures JVM-level errors like `OutOfMemoryError` that should typically cause the application to exit.","repository":"apache/kafka","domain":"data-systems","topic":"Error Handling","language":"Java","updated":"2025-07-23","comments":4,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-catch-specific-exceptions.md"},{"slug":"kubernetes-feature-gate-configuration-management","title":"Feature gate configuration management","description":"Ensure feature gates are properly managed across all configuration files and contexts. Feature-specific permissions, settings, and resources should be conditionally included based on appropriate feature gate guards rather than being present in default configurations. Avoid manually adding feature gates to configuration files when they are automatically...","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"Configurations","language":"Yaml","updated":"2025-07-23","comments":4,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-feature-gate-configuration-management.md"},{"slug":"mastodon-migration-data-dependencies","title":"migration data dependencies","description":"Ensure that migrations properly handle data dependencies and sequencing to prevent deployment failures. When migrations depend on specific records existing (like default roles or seed data), create those records within the migration itself rather than relying on seeds or post-deployment processes.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Migrations","language":"Ruby","updated":"2025-07-23","comments":4,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-migration-data-dependencies.md"},{"slug":"n8n-consistent-naming-patterns","title":"Consistent naming patterns","description":"Maintain consistent naming conventions throughout the codebase to improve readability and maintainability. This applies to translation keys, command names, variables, and terminology.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Naming Conventions","language":"Json","updated":"2025-07-23","comments":4,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-consistent-naming-patterns.md"},{"slug":"roo-code-optimize-algorithm-implementations","title":"Optimize algorithm implementations","description":"When implementing algorithms, ensure they are both efficient and correct across all input cases. Key considerations: 1. **Pattern matching edge cases**: Ensure regex patterns handle all edge cases, including matches at the beginning of strings. For example, replace `/[^\\\\]`[^`\\n]+`/` with `/(?:^|[^\\\\])`[^`\\n]+`/` to catch backticks at string start.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Algorithms","language":"TypeScript","updated":"2025-07-23","comments":4,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-optimize-algorithm-implementations.md"},{"slug":"router-api-backward-compatibility","title":"API backward compatibility","description":"When updating existing APIs, maintain backward compatibility by deprecating old options rather than introducing breaking changes. Add new properties while keeping old ones functional, marking them as deprecated to guide migration without forcing immediate updates.","repository":"TanStack/router","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2025-07-23","comments":4,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-api-backward-compatibility.md"},{"slug":"spark-externalize-configuration-values","title":"Externalize configuration values","description":"Avoid hardcoding configuration values directly in code. Instead, make them externally configurable through appropriate mechanisms based on their usage patterns. Use environment variables for values that may need to change between deployments or runs, move configuration setup to appropriate lifecycle methods (like setupClass), and choose the right location...","repository":"apache/spark","domain":"data-systems","topic":"Configurations","language":"Python","updated":"2025-07-23","comments":4,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-externalize-configuration-values.md"},{"slug":"traefik-api-interface-simplification","title":"API interface simplification","description":"Design APIs with clean, minimal interfaces that encapsulate internal logic and avoid exposing unnecessary complexity to consumers. Prefer methods that internally handle implementation details over exposing flags or parameters that clients must manage.","repository":"traefik/traefik","domain":"cloud-infra","topic":"API","language":"Go","updated":"2025-07-23","comments":4,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-api-interface-simplification.md"},{"slug":"typescript-provide-actionable-errors","title":"Provide actionable errors","description":"Error messages should not only identify problems but also guide developers toward solutions. Include specific steps, alternatives, or configuration changes that can resolve the issue.","repository":"microsoft/typescript","domain":"runtimes","topic":"Error Handling","language":"TypeScript","updated":"2025-07-23","comments":4,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-provide-actionable-errors.md"},{"slug":"agents-explicit-api-parameters","title":"Explicit API parameters","description":"Design APIs with explicit parameters rather than implicit defaults or hidden behavior. When an API function requires specific data or configuration, make those requirements clear through the function signature instead of relying on optional parameters with complex fallback logic.","repository":"cloudflare/agents","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2025-07-23","comments":3,"stars":2312,"raw":"https://awesomereviewers.com/raw/agents-explicit-api-parameters.md"},{"slug":"continue-use-established-configuration-patterns","title":"Use established configuration patterns","description":"Always access and set configuration values using established patterns and correct property names. Understanding the structure of configuration objects is essential to prevent bugs in your application.","repository":"continuedev/continue","domain":"ai-agents","topic":"Configurations","language":"TSX","updated":"2025-07-23","comments":3,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-use-established-configuration-patterns.md"},{"slug":"gemini-cli-prevent-react-race-conditions","title":"Prevent React race conditions","description":"When building React components that handle rapid user input or manage complex interdependent state, consolidate state management to prevent race conditions that occur when multiple events are processed in the same React event loop.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"React","language":"TypeScript","updated":"2025-07-23","comments":3,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-prevent-react-race-conditions.md"},{"slug":"goose-use-idiomatic-optional-patterns","title":"Use idiomatic optional patterns","description":"Prefer Rust's built-in optional handling methods over manual checks and intermediate variables. Use `if let Some(value) = option` for pattern matching, `option.map(|x| x.field).unwrap_or(default)` for transformations with fallbacks, and `option.is_some_and(|x| condition)` for conditional checks.","repository":"block/goose","domain":"ai-agents","topic":"Null Handling","language":"Rust","updated":"2025-07-23","comments":3,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-use-idiomatic-optional-patterns.md"},{"slug":"n8n-complete-error-handling-cycle","title":"Complete error handling cycle","description":"Implement comprehensive error handling that covers prevention, recovery, and diagnosis: 1. **Prevent errors** through thorough validation before enabling actions","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Error Handling","language":"Other","updated":"2025-07-23","comments":3,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-complete-error-handling-cycle.md"},{"slug":"rust-default-over-unsafe-initialization","title":"Default over unsafe initialization","description":"Prefer using safe initialization methods like `Default::default()` over unsafe alternatives like `MaybeUninit::uninit()` or null values when initializing variables. This reduces the risk of undefined behavior and eliminates unnecessary unsafe blocks.","repository":"rust-lang/rust","domain":"runtimes","topic":"Null Handling","language":"Rust","updated":"2025-07-23","comments":3,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-default-over-unsafe-initialization.md"},{"slug":"spark-parameterize-configuration-values","title":"parameterize configuration values","description":"Replace hardcoded configuration values with parameterized variables in build files and configuration management. This enables flexible environment-specific settings and improves maintainability.","repository":"apache/spark","domain":"data-systems","topic":"Configurations","language":"Xml","updated":"2025-07-23","comments":3,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-parameterize-configuration-values.md"},{"slug":"bazel-comprehensive-edge-case-testing","title":"comprehensive edge case testing","description":"Write comprehensive tests that cover edge cases and platform-specific scenarios to uncover underlying implementation issues rather than masking them with workarounds. When encountering failures, investigate the root cause through targeted testing before implementing fallback mechanisms.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Testing","language":"Other","updated":"2025-07-23","comments":2,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-comprehensive-edge-case-testing.md"},{"slug":"electron-avoid-runtime-credential-resolution","title":"avoid runtime credential resolution","description":"Security credentials and access control mechanisms should be pre-configured at deployment or configuration time rather than resolved dynamically at runtime. Dynamic credential fetching introduces injection risks and makes security boundaries harder to audit and control.","repository":"electron/electron","domain":"devtools","topic":"Security","language":"Shell","updated":"2025-07-23","comments":2,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-avoid-runtime-credential-resolution.md"},{"slug":"electron-scope-configuration-impact","title":"Scope configuration impact","description":"When implementing configuration settings, carefully consider and limit their scope to prevent unintended broad impact across systems or workflows. Configuration changes should be targeted and controlled rather than applied globally when only specific contexts require them.","repository":"electron/electron","domain":"devtools","topic":"Configurations","language":"Yaml","updated":"2025-07-23","comments":2,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-scope-configuration-impact.md"},{"slug":"gemini-cli-optimize-react-hooks-usage","title":"optimize React hooks usage","description":"Avoid useRef unless strictly necessary and ensure useEffect has proper dependencies to prevent unnecessary re-renders. useRef makes logic harder to reason about and should be replaced with more straightforward patterns when possible. For useEffect, extract values outside the effect when they don't need to be dependencies, and ensure the dependency array...","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"React","language":"TSX","updated":"2025-07-23","comments":2,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-optimize-react-hooks-usage.md"},{"slug":"gemini-cli-prefer-lightweight-composable-apis","title":"Prefer lightweight composable APIs","description":"When designing APIs, favor lightweight, composable solutions that allow callers to maintain control over their specific use cases, rather than imposing centralized, monolithic systems that take control away from the caller.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"API","language":"Markdown","updated":"2025-07-23","comments":2,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-prefer-lightweight-composable-apis.md"},{"slug":"kubernetes-benchmark-performance-changes","title":"Benchmark performance changes","description":"Always measure and validate performance impact through benchmarking before making changes that could affect system performance, even when changes appear to be obvious optimizations. Removing seemingly redundant configurations or adding new features can have unexpected performance consequences that only surface during integration testing or production use.","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"Performance Optimization","language":"Yaml","updated":"2025-07-23","comments":2,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-benchmark-performance-changes.md"},{"slug":"litellm-incremental-dependency-updates","title":"Incremental dependency updates","description":"When updating dependencies in configuration files like requirements.txt, break large changes into smaller, focused pull requests that can be individually tested and validated. Each dependency update should include clear justification for why the change is necessary, especially when it triggers cascading updates to other packages.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Configurations","language":"Txt","updated":"2025-07-23","comments":2,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-incremental-dependency-updates.md"},{"slug":"llama.cpp-consistent-clear-naming","title":"consistent clear naming","description":"Ensure variable and identifier names are both consistent and unambiguous within their context. When multiple equivalent naming options exist (such as `tile_B::I` vs `tile_C::J` for the same value), choose one approach and apply it consistently throughout the codebase. Additionally, select names that clearly distinguish their purpose and avoid confusion with...","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Naming Conventions","language":"CUDA","updated":"2025-07-23","comments":2,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-consistent-clear-naming.md"},{"slug":"llama.cpp-use-precise-documentation-details","title":"Use precise documentation details","description":"Documentation should provide specific, actionable information rather than vague or generic references. This applies to both technical specifications and descriptive text.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Documentation","language":"Markdown","updated":"2025-07-23","comments":2,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-use-precise-documentation-details.md"},{"slug":"openpilot-explicit-value-specifications","title":"Explicit value specifications","description":"Always use explicit value specifications and type-safe handling to prevent undefined behavior and ensure predictable code execution. This includes specifying appropriate default values for configuration parameters and using platform-independent format specifiers for data types.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Null Handling","language":"Other","updated":"2025-07-23","comments":2,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-explicit-value-specifications.md"},{"slug":"spark-complete-method-documentation","title":"Complete method documentation","description":"All public methods, especially in interfaces and APIs, must have comprehensive JavaDoc documentation that clearly describes their purpose, return values, and behavior. Avoid vague or ambiguous descriptions that leave developers guessing about the method's functionality.","repository":"apache/spark","domain":"data-systems","topic":"Documentation","language":"Java","updated":"2025-07-23","comments":2,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-complete-method-documentation.md"},{"slug":"workerd-optimize-algorithm-performance","title":"Optimize algorithm performance","description":"When implementing algorithms, prioritize performance by using batching techniques to reduce API call overhead and avoiding unnecessary memory allocations. Convert recursive algorithms to iterative ones when dealing with large datasets, and process elements in batches rather than individually.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Algorithms","language":"Other","updated":"2025-07-23","comments":2,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-optimize-algorithm-performance.md"},{"slug":"kubernetes-minimize-security-dependencies","title":"minimize security dependencies","description":"For security-sensitive operations like shell argument parsing, input validation, or cryptographic functions, prefer copying minimal, well-understood code over adding external dependencies, especially when:","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"Security","language":"Other","updated":"2025-07-23","comments":1,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-minimize-security-dependencies.md"},{"slug":"roo-code-complete-locale-translations","title":"Complete locale translations","description":"Ensure that all text strings in locale-specific files are properly translated into their respective languages. Leaving untranslated English text in non-English locale files creates an inconsistent user experience and reduces the effectiveness of localization efforts.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Documentation","language":"Json","updated":"2025-07-22","comments":25,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-complete-locale-translations.md"},{"slug":"roo-code-internationalize-all-text","title":"Internationalize all text","description":"All user-facing text must be wrapped with translation functions instead of using hardcoded English strings. This includes regular UI text, accessibility attributes (aria-label, title, alt), and screen reader announcements. Using translation keys creates a consistent, maintainable internationalization system and ensures the application is accessible to users...","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Documentation","language":"TSX","updated":"2025-07-22","comments":14,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-internationalize-all-text.md"},{"slug":"kafka-prefer-modern-collection-apis","title":"prefer modern collection APIs","description":"Use modern collection creation methods instead of legacy alternatives for improved readability and conciseness. Replace older patterns with their modern equivalents:","repository":"apache/kafka","domain":"data-systems","topic":"Code Style","language":"Java","updated":"2025-07-22","comments":8,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-prefer-modern-collection-apis.md"},{"slug":"kubernetes-implement-proper-observability","title":"implement proper observability","description":"Ensure observability mechanisms (events and metrics) are implemented correctly with appropriate types, accurate labeling, and user-focused messaging. Use events for user-visible information that appears in `kubectl describe`, not just internal logging. Choose correct event types (`EventTypeNormal` for waiting states, `EventTypeWarning` for actual failures)...","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"Observability","language":"Go","updated":"2025-07-22","comments":7,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-implement-proper-observability.md"},{"slug":"rust-standardize-configuration-value-handling","title":"Standardize configuration value handling","description":"Implement robust and type-safe configuration handling to avoid fragile hardcoding and improve maintainability. Key guidelines: 1. Use type-safe structures for passing configuration between processes instead of raw strings","repository":"rust-lang/rust","domain":"runtimes","topic":"Configurations","language":"Rust","updated":"2025-07-22","comments":7,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-standardize-configuration-value-handling.md"},{"slug":"react-router-precise-null-type-checking","title":"precise null type checking","description":"Use precise null and undefined type checking that matches the actual usage context. Distinguish between checking if a type contains undefined (`undefined extends T`) versus checking if a type is exactly undefined (`Equal<T, undefined> extends true`). For inferred return types, use the \"contains undefined\" check since the type may be a union. For direct...","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Null Handling","language":"TypeScript","updated":"2025-07-22","comments":6,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-precise-null-type-checking.md"},{"slug":"terminal-manage-object-lifetimes-carefully","title":"manage object lifetimes carefully","description":"Ensure proper object lifetime management in concurrent scenarios to prevent crashes from dangling pointers and premature destruction. Use weak references for event handlers that may outlive their target objects, and capture strong references in async operations to keep objects alive during coroutine execution.","repository":"microsoft/terminal","domain":"devtools","topic":"Concurrency","language":"C++","updated":"2025-07-22","comments":6,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-manage-object-lifetimes-carefully.md"},{"slug":"ant-design-consistent-null-safety-patterns","title":"Consistent null safety patterns","description":"Maintain consistent approaches to null and undefined handling throughout the codebase. Use optional chaining (`?.`) for safe property access, but be mindful that it may not always be equivalent to explicit type and null checks. When accessing properties on values that could be objects, always include explicit null checks alongside type checks since `typeof...","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Null Handling","language":"TSX","updated":"2025-07-22","comments":5,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-consistent-null-safety-patterns.md"},{"slug":"codex-centralize-configuration-management","title":"Centralize configuration management","description":"Prefer centralized configuration objects over environment variables for application settings. Environment variables create inconsistent configuration sources and can lead to maintenance challenges.","repository":"openai/codex","domain":"ai-agents","topic":"Configurations","language":"Rust","updated":"2025-07-22","comments":5,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-centralize-configuration-management.md"},{"slug":"gemini-cli-choose-efficient-data-structures","title":"Choose efficient data structures","description":"Select data structures and algorithms that match your performance requirements rather than defaulting to simple but inefficient approaches. Consider the time complexity of operations and use specialized libraries when appropriate.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Algorithms","language":"TypeScript","updated":"2025-07-22","comments":5,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-choose-efficient-data-structures.md"},{"slug":"jan-eliminate-code-redundancy","title":"eliminate code redundancy","description":"Remove duplicate imports, unused legacy code, and repetitive patterns to maintain clean, organized codebases. Extract commonly used functionality into utilities and avoid code duplication through proper abstractions. Use early returns to reduce nesting and improve readability.","repository":"menloresearch/jan","domain":"llm-infra","topic":"Code Style","language":"TypeScript","updated":"2025-07-22","comments":5,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-eliminate-code-redundancy.md"},{"slug":"kubernetes-prefer-early-null-returns","title":"Prefer early null returns","description":"Use early return patterns with null checks to reduce nesting and improve code readability. Avoid unnecessary null checks for values that are guaranteed to be non-nil, and prefer length checks over nil checks for slices.","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"Null Handling","language":"Go","updated":"2025-07-22","comments":5,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-prefer-early-null-returns.md"},{"slug":"n8n-validate-api-data-contracts","title":"Validate API data contracts","description":"Always validate API request and response data using schema validation to ensure type safety and prevent runtime errors. Define explicit schemas (e.g., using Zod or similar) for all API interfaces rather than relying on TypeScript types alone.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2025-07-22","comments":5,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-validate-api-data-contracts.md"},{"slug":"spark-include-contextual-information","title":"Include contextual information","description":"Log messages should include comprehensive contextual information to support debugging and system monitoring. This includes relevant identifiers, operation details, and state information that help developers understand what happened and why.","repository":"apache/spark","domain":"data-systems","topic":"Logging","language":"Other","updated":"2025-07-22","comments":5,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-include-contextual-information.md"},{"slug":"codex-minimize-blocking-operations","title":"Minimize blocking operations","description":"When writing concurrent code, minimize blocking operations to maintain responsiveness and prevent performance bottlenecks. This applies especially to async contexts and lock usage.","repository":"openai/codex","domain":"ai-agents","topic":"Concurrency","language":"Rust","updated":"2025-07-22","comments":4,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-minimize-blocking-operations.md"},{"slug":"codex-organize-code-top-down","title":"Organize code top down","description":"Structure code files with a clear top-down organization, placing primary functions and important declarations at the top, followed by helper functions and implementation details below. This improves code readability and maintainability by establishing a clear hierarchy.","repository":"openai/codex","domain":"ai-agents","topic":"Code Style","language":"Rust","updated":"2025-07-22","comments":4,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-organize-code-top-down.md"},{"slug":"duckdb-protect-shared-state","title":"Protect shared state","description":"Always protect shared mutable state with appropriate synchronization mechanisms to prevent race conditions and data corruption in multi-threaded environments. Use `std::call_once` for thread-safe initialization, mutexes for protecting shared resources, and carefully consider whether state belongs in global vs local thread contexts.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Concurrency","language":"C++","updated":"2025-07-22","comments":4,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-protect-shared-state.md"},{"slug":"electron-consistent-nullable-returns","title":"consistent nullable returns","description":"Establish consistent patterns for nullable return values in APIs and document them clearly. Use `null` consistently for \"not found\" or \"unavailable\" cases rather than mixing `null`, `undefined`, and `false`. Always document when and why nullable values are returned, explaining the specific conditions that lead to these values.","repository":"electron/electron","domain":"devtools","topic":"Null Handling","language":"Markdown","updated":"2025-07-22","comments":4,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-consistent-nullable-returns.md"},{"slug":"lmcache-configuration-validation-standards","title":"Configuration validation standards","description":"Ensure configuration parameters follow consistent validation, naming, and default value standards to improve code safety and clarity. **Key Requirements:**","repository":"LMCache/LMCache","domain":"llm-infra","topic":"Configurations","language":"Python","updated":"2025-07-22","comments":4,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-configuration-validation-standards.md"},{"slug":"n8n-secure-credential-data-handling","title":"Secure credential data handling","description":"Always protect sensitive credential data through proper encryption, secure storage, and careful handling in code. Key requirements: 1. Never store credentials in plaintext within source code","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2025-07-22","comments":4,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-secure-credential-data-handling.md"},{"slug":"roo-code-prevent-unnecessary-processing","title":"Prevent unnecessary processing","description":"Optimize React component performance by minimizing unnecessary operations that can slow down your application: 1. **Memoize stable components** to prevent unnecessary re-renders when parent components update:","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Performance Optimization","language":"TSX","updated":"2025-07-22","comments":4,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-prevent-unnecessary-processing.md"},{"slug":"spark-self-documenting-code-practices","title":"self-documenting code practices","description":"Write code that explains itself through clear structure and meaningful names, while adding targeted comments only where necessary for future maintainability. Extract complex logic into well-named functions with comprehensive documentation, but avoid redundant comments that duplicate what the code already expresses clearly.","repository":"apache/spark","domain":"data-systems","topic":"Documentation","language":"Other","updated":"2025-07-22","comments":4,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-self-documenting-code-practices.md"},{"slug":"svelte-api-flexibility-balance","title":"API flexibility balance","description":"When designing APIs, carefully balance simplicity for common use cases with flexibility for advanced scenarios. Consider whether to expose simple interfaces (strings, direct exports) that make typical usage ergonomic, or more flexible interfaces (objects, options parameters) that enable customization.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"API","language":"JavaScript","updated":"2025-07-22","comments":4,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-api-flexibility-balance.md"},{"slug":"codex-avoid-unnecessary-operations","title":"Avoid unnecessary operations","description":"Optimize performance by eliminating operations that don''t contribute meaningful value to your code''s functionality. Look for three common performance drains:","repository":"openai/codex","domain":"ai-agents","topic":"Performance Optimization","language":"Rust","updated":"2025-07-22","comments":3,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-avoid-unnecessary-operations.md"},{"slug":"goose-extract-duplicated-code","title":"extract duplicated code","description":"Identify and eliminate code duplication by extracting shared logic into reusable functions, components, or type definitions. When you notice similar code patterns appearing in multiple places, refactor them into a single, well-named abstraction.","repository":"block/goose","domain":"ai-agents","topic":"Code Style","language":"TSX","updated":"2025-07-22","comments":3,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-extract-duplicated-code.md"},{"slug":"neovim-optimize-algorithmic-complexity","title":"Optimize algorithmic complexity","description":"Actively identify and eliminate unnecessary computational overhead in algorithms, particularly focusing on nested loops and inefficient data operations that can significantly impact performance.","repository":"neovim/neovim","domain":"devtools","topic":"Algorithms","language":"Other","updated":"2025-07-22","comments":3,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-optimize-algorithmic-complexity.md"},{"slug":"react-native-consistent-null-checking","title":"consistent null checking","description":"Ensure null checks follow consistent patterns and proper ordering for better readability and safety. Always place the variable being checked on the left side of null comparisons, use defensive programming with hasKey() checks before accessing map values, and maintain null-safe fallbacks when appropriate.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Null Handling","language":"Java","updated":"2025-07-22","comments":3,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-consistent-null-checking.md"},{"slug":"react-native-prevent-regression-crashes","title":"Prevent regression crashes","description":"When implementing error handling or bug fixes, avoid introducing new crash conditions that would break previously working code. Focus on defensive programming that handles edge cases without creating new failure points.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Error Handling","language":"Java","updated":"2025-07-22","comments":3,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-prevent-regression-crashes.md"},{"slug":"supabase-use-parameter-based-paths","title":"Use parameter-based paths","description":"When designing API routes and interfaces, always use parameter-based path syntax instead of hardcoded literals. This approach provides better flexibility, improved type safety, and allows for more reusable code. Additionally, always validate parameters before using them in routes or API calls to prevent undefined reference errors.","repository":"supabase/supabase","domain":"data-systems","topic":"API","language":"TSX","updated":"2025-07-22","comments":3,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-use-parameter-based-paths.md"},{"slug":"vscode-comprehensive-jsdoc-with-examples","title":"Comprehensive JSDoc with examples","description":"Write thorough JSDoc comments for interfaces, functions, and methods that clearly explain their purpose and behavior. Include: 1. A main description explaining the component''s purpose","repository":"microsoft/vscode","domain":"devtools","topic":"Documentation","language":"TypeScript","updated":"2025-07-22","comments":3,"stars":174887,"raw":"https://awesomereviewers.com/raw/vscode-comprehensive-jsdoc-with-examples.md"},{"slug":"cline-avoid-premature-memoization","title":"Avoid premature memoization","description":"Don't automatically reach for useMemo and useCallback for every computation or function. These hooks add complexity and should only be used when there's a measurable performance benefit. Consider the actual cost of the operation and frequency of re-renders before memoizing.","repository":"cline/cline","domain":"ai-agents","topic":"React","language":"TSX","updated":"2025-07-22","comments":2,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-avoid-premature-memoization.md"},{"slug":"core-maintain-inline-documentation","title":"Maintain inline documentation","description":"Ensure inline code comments are accurate, current, and provide meaningful explanations for complex or unclear code sections. Comments should be updated whenever the associated code changes to prevent misleading documentation.","repository":"home-assistant/core","domain":"app-frameworks","topic":"Documentation","language":"Python","updated":"2025-07-22","comments":2,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-maintain-inline-documentation.md"},{"slug":"gemini-cli-use-appropriate-logging-levels","title":"Use appropriate logging levels","description":"Use console.debug() for debug information instead of console.log() to prevent cluttering user-facing output. Debug information should be hidden from normal users but available when debugging is enabled.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Logging","language":"TypeScript","updated":"2025-07-22","comments":2,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-use-appropriate-logging-levels.md"},{"slug":"kilocode-consider-semantic-context","title":"Consider semantic context","description":"When choosing names for variables, methods, classes, or configuration sections, consider both the current purpose and potential future extensions. Names should be semantically accurate and align with established conventions in the codebase.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Naming Conventions","language":"Json","updated":"2025-07-22","comments":2,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-consider-semantic-context.md"},{"slug":"llama.cpp-prefer-const-variables","title":"prefer const variables","description":"Add the `const` qualifier to variables that are not modified after initialization. This improves code clarity, prevents accidental modifications, and makes the code's intent more explicit to both compilers and other developers.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Code Style","language":"CUDA","updated":"2025-07-22","comments":2,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-prefer-const-variables.md"},{"slug":"llvm-project-match-function-names-to-behavior","title":"Match function names to behavior","description":"Function names and their documentation must accurately reflect what the function actually does. When a function handles more data than its name suggests, either rename the function or split the functionality.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-22","comments":2,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-match-function-names-to-behavior.md"},{"slug":"mono-avoid-manual-error-handling","title":"avoid manual error handling","description":"Prefer centralized error handling mechanisms and specialized utilities over manual error handling in individual components. Instead of implementing error handling logic directly in each function or component, leverage global error handlers and purpose-built utilities.","repository":"rocicorp/mono","domain":"data-systems","topic":"Error Handling","language":"TSX","updated":"2025-07-22","comments":2,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-avoid-manual-error-handling.md"},{"slug":"react-router-complete-accurate-documentation","title":"Complete accurate documentation","description":"Documentation should provide complete, accurate guidance that doesn't mislead developers about correct usage patterns. Avoid documentation structures that suggest incorrect import paths or API usage, and ensure that configuration examples are accompanied by practical usage demonstrations.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Documentation","language":"Json","updated":"2025-07-22","comments":2,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-complete-accurate-documentation.md"},{"slug":"rust-conditional-ci-resource-management","title":"Conditional CI resource management","description":"Configure CI workflows to intelligently manage system resources through conditional execution rather than duplicating steps. Use matrix variables or job conditions to determine when resource-intensive operations should run.","repository":"rust-lang/rust","domain":"runtimes","topic":"CI/CD","language":"Yaml","updated":"2025-07-22","comments":2,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-conditional-ci-resource-management.md"},{"slug":"spark-ensure-test-isolation","title":"ensure test isolation","description":"Tests must properly clean up resources and avoid side effects that can impact other tests, especially when running in parallel. This prevents non-deterministic failures and ensures reliable test execution.","repository":"apache/spark","domain":"data-systems","topic":"Testing","language":"Python","updated":"2025-07-22","comments":2,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-ensure-test-isolation.md"},{"slug":"spark-validate-before-data-access","title":"validate before data access","description":"Always validate for null or None values before accessing data elements, especially when working with collections or optional parameters. Avoid direct indexing or attribute access without first ensuring the data exists and is valid.","repository":"apache/spark","domain":"data-systems","topic":"Null Handling","language":"Python","updated":"2025-07-22","comments":2,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-validate-before-data-access.md"},{"slug":"gemini-cli-generic-security-configuration-naming","title":"Generic security configuration naming","description":"When implementing security-related configuration options, use generic, implementation-agnostic naming conventions rather than tying them to specific tools or runtimes. This approach ensures flexibility as the underlying technology stack evolves and prevents vendor lock-in in security configurations.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Security","language":"Markdown","updated":"2025-07-22","comments":1,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-generic-security-configuration-naming.md"},{"slug":"kubernetes-minimize-rbac-permissions","title":"minimize RBAC permissions","description":"When defining RBAC rules and authorization policies, grant only the minimum necessary permissions required for the intended functionality. Avoid copying broad permission sets or including unnecessary verbs that expand the attack surface.","repository":"kubernetes/kubernetes","domain":"orchestration","topic":"Security","language":"Yaml","updated":"2025-07-22","comments":1,"stars":116489,"raw":"https://awesomereviewers.com/raw/kubernetes-minimize-rbac-permissions.md"},{"slug":"traefik-validate-file-paths","title":"validate file paths","description":"Always validate and sanitize file paths when processing external input to prevent directory traversal attacks, zip slip vulnerabilities, and other path-based security issues. Check for minimum required path components, reject paths with suspicious patterns, and ensure paths stay within expected boundaries.","repository":"traefik/traefik","domain":"cloud-infra","topic":"Security","language":"Go","updated":"2025-07-22","comments":1,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-validate-file-paths.md"},{"slug":"prometheus-consistent-descriptive-naming","title":"Consistent descriptive naming","description":"Ensure variable, function, and type names are consistent, descriptive, and follow Go naming conventions. Names should clearly convey their purpose and maintain consistency across related components.","repository":"prometheus/prometheus","domain":"observability","topic":"Naming Conventions","language":"Go","updated":"2025-07-21","comments":13,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-consistent-descriptive-naming.md"},{"slug":"appwrite-validate-environment-variables","title":"Validate environment variables","description":"Always validate environment variables before use and implement proper fallback strategies. For required variables, fail fast with clear error messages. For optional variables with empty values, ensure they don't short-circuit fallback chains.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Configurations","language":"PHP","updated":"2025-07-21","comments":10,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-validate-environment-variables.md"},{"slug":"appwrite-ensure-database-transactional-integrity","title":"Ensure database transactional integrity","description":"When performing multiple related database operations, use transactions and proper error handling to maintain data consistency. Without proper safeguards, partial failures can leave your database in an inconsistent state with orphaned or mismatched records.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Database","language":"PHP","updated":"2025-07-21","comments":9,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-ensure-database-transactional-integrity.md"},{"slug":"roo-code-protect-shared-state-access","title":"Protect shared state access","description":"Ensure thread-safe access to shared state by using appropriate synchronization mechanisms and atomic operations. Avoid race conditions by: 1. Using atomic operations or locks when modifying shared state","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Concurrency","language":"TypeScript","updated":"2025-07-21","comments":9,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-protect-shared-state-access.md"},{"slug":"vscode-eliminate-unnecessary-code-patterns","title":"Eliminate unnecessary code patterns","description":"Remove redundant code patterns that add complexity without value. This includes: 1. Duplicate code blocks - Extract shared logic into reusable functions","repository":"microsoft/vscode","domain":"devtools","topic":"Code Style","language":"TypeScript","updated":"2025-07-21","comments":9,"stars":174887,"raw":"https://awesomereviewers.com/raw/vscode-eliminate-unnecessary-code-patterns.md"},{"slug":"appwrite-comprehensive-migration-planning","title":"Comprehensive migration planning","description":"When changing identifier systems (e.g., from using `getInternalId()` to `getSequence()`), implement comprehensive migration strategies to preserve data integrity and backward compatibility. For each change:","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Migrations","language":"PHP","updated":"2025-07-21","comments":8,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-comprehensive-migration-planning.md"},{"slug":"roo-code-extract-reusable-patterns","title":"Extract reusable patterns","description":"Extract repetitive or complex code into reusable functions, components, or custom hooks. This improves code organization, reduces duplication, and enhances readability.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Code Style","language":"TSX","updated":"2025-07-21","comments":8,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-extract-reusable-patterns.md"},{"slug":"appwrite-consistent-placeholder-conventions","title":"Consistent placeholder conventions","description":"Ensure all placeholders in localization files follow consistent naming conventions to prevent runtime errors and text leakage in the UI. This applies to both sprintf-style placeholders (`%s`) and template variables (`{% raw %}{{name}}{% endraw %}`).","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Naming Conventions","language":"Json","updated":"2025-07-21","comments":7,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-consistent-placeholder-conventions.md"},{"slug":"mastodon-centralize-configuration-management","title":"centralize configuration management","description":"Migrate configuration from direct environment variable access to Rails' config_for mechanism for better organization, testability, and maintainability. Instead of accessing ENV variables directly throughout the codebase, consolidate them into YAML configuration files loaded at application startup.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Configurations","language":"Ruby","updated":"2025-07-21","comments":7,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-centralize-configuration-management.md"},{"slug":"roo-code-configure-with-care","title":"Configure with care","description":"Always validate configuration values before use, provide sensible defaults, and centralize constants in shared modules. When implementing configuration handling:","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-07-21","comments":7,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-configure-with-care.md"},{"slug":"roo-code-document-i18n-string-usage","title":"Document i18n string usage","description":"All user-facing strings must be documented with translation function usage to ensure proper internationalization support. This includes error messages, notifications, labels, and any text displayed to users.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Documentation","language":"TypeScript","updated":"2025-07-21","comments":7,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-document-i18n-string-usage.md"},{"slug":"rust-ensure-complete-test-coverage","title":"Ensure complete test coverage","description":"Write comprehensive tests that cover all relevant cases and variations while maintaining proper organization and structure. Key practices: 1. Place tests in appropriate locations (e.g., core tests in `library/coretests`)","repository":"rust-lang/rust","domain":"runtimes","topic":"Testing","language":"Rust","updated":"2025-07-21","comments":7,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-ensure-complete-test-coverage.md"},{"slug":"spark-simplify-conditional-structures","title":"Simplify conditional structures","description":"Organize complex conditional logic using clear, sequential patterns rather than nested structures or multiple early returns. This improves code readability and maintainability by making the flow of logic easier to follow.","repository":"apache/spark","domain":"data-systems","topic":"Code Style","language":"Other","updated":"2025-07-21","comments":7,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-simplify-conditional-structures.md"},{"slug":"argo-cd-complete-configuration-examples","title":"Complete configuration examples","description":"Configuration examples in documentation must be complete and reference authoritative sources to prevent deployment issues and developer confusion. Incomplete configuration lists can lead to runtime errors and failed setups.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Configurations","language":"Markdown","updated":"2025-07-21","comments":6,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-complete-configuration-examples.md"},{"slug":"core-minimize-try-block-scope","title":"Minimize try block scope","description":"Only include code that can actually raise exceptions within try blocks. Move variable assignments, logging statements, and other operations that cannot fail outside of the try block to avoid accidentally catching unintended exceptions and to improve code clarity.","repository":"home-assistant/core","domain":"app-frameworks","topic":"Error Handling","language":"Python","updated":"2025-07-21","comments":5,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-minimize-try-block-scope.md"},{"slug":"istio-conservative-networking-defaults","title":"Conservative networking defaults","description":"When configuring networking components, prefer stable and permissive defaults over restrictive or experimental configurations that may not work across all environments. This approach ensures broader compatibility and reduces the risk of breaking existing deployments.","repository":"istio/istio","domain":"orchestration","topic":"Networking","language":"Yaml","updated":"2025-07-21","comments":5,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-conservative-networking-defaults.md"},{"slug":"kafka-optimize-algorithmic-complexity","title":"optimize algorithmic complexity","description":"Replace inefficient algorithms with more optimal data structures and approaches to improve computational complexity. Look for opportunities to use appropriate data structures (like priority queues) instead of linear searches, avoid redundant iterations, and choose efficient traversal patterns.","repository":"apache/kafka","domain":"data-systems","topic":"Algorithms","language":"Java","updated":"2025-07-21","comments":5,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-optimize-algorithmic-complexity.md"},{"slug":"rust-name-for-semantic-meaning","title":"Name for semantic meaning","description":"Choose names that clearly convey the semantic meaning and purpose of the identifier, rather than using clever or ambiguous names. Names should be explicit and descriptive enough that their purpose is immediately clear to readers.","repository":"rust-lang/rust","domain":"runtimes","topic":"Naming Conventions","language":"Rust","updated":"2025-07-21","comments":5,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-name-for-semantic-meaning.md"},{"slug":"supabase-clear-descriptive-identifiers","title":"Clear, descriptive identifiers","description":"Choose variable, component, and parameter names that clearly describe their purpose and avoid ambiguity. Names should fully reflect functionality, be properly spelled, and avoid confusion with library terms or similar concepts.","repository":"supabase/supabase","domain":"data-systems","topic":"Naming Conventions","language":"TSX","updated":"2025-07-21","comments":5,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-clear-descriptive-identifiers.md"},{"slug":"duckdb-comprehensive-database-testing","title":"comprehensive database testing","description":"Database tests should execute actual queries and verify results comprehensively, not just check query plans or use hash comparisons. Always include edge cases, test data scenarios with both expected and unexpected data, and verify storage correctness through restart/reload cycles.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Database","language":"Other","updated":"2025-07-21","comments":4,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-comprehensive-database-testing.md"},{"slug":"roo-code-conditional-debug-logging","title":"Conditional debug logging","description":"Remove or conditionally disable console.log and console.debug statements before committing code to production. These debugging statements create noise in browser consoles, may expose sensitive information, and can impact runtime performance.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Logging","language":"TSX","updated":"2025-07-21","comments":4,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-conditional-debug-logging.md"},{"slug":"roo-code-optimize-react-components","title":"Optimize React components","description":"Apply these React optimization techniques to improve component performance and maintainability: 1. **Use stable, unique keys for list items** - Avoid using array indices as keys when rendering lists that can change. Instead, use unique identifiers from your data.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"React","language":"TSX","updated":"2025-07-21","comments":4,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-optimize-react-components.md"},{"slug":"appwrite-version-migration-dependencies-carefully","title":"Version migration dependencies carefully","description":"When updating dependencies for migration-related components or making schema changes, verify compatibility and ensure backward compatibility: 1. For dependency updates:","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Migrations","language":"Json","updated":"2025-07-21","comments":3,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-version-migration-dependencies-carefully.md"},{"slug":"discourse-css-modifier-naming","title":"CSS modifier naming","description":"Use consistent modifier patterns with `--` prefixes for CSS classes and variables. Prefer semantic base names combined with modifiers over long descriptive names. This approach improves maintainability and creates predictable naming schemes.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Naming Conventions","language":"Css","updated":"2025-07-21","comments":3,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-css-modifier-naming.md"},{"slug":"bazel-write-specific-test-assertions","title":"Write specific test assertions","description":"Make test assertions specific and verifiable rather than relying on generic metrics or counts. Use explicit checks for expected behaviors and implement proper error handling to ensure tests fail fast when something goes wrong.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Testing","language":"Shell","updated":"2025-07-21","comments":2,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-write-specific-test-assertions.md"},{"slug":"goose-leverage-typescript-nullability","title":"leverage TypeScript nullability","description":"When dealing with values that may be null or undefined, explicitly leverage TypeScript's nullable types to identify dependencies and guide null handling decisions. Make values nullable when their availability is uncertain, then let TypeScript reveal where null checks are needed.","repository":"block/goose","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2025-07-21","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-leverage-typescript-nullability.md"},{"slug":"goose-optimize-algorithmic-efficiency","title":"Optimize algorithmic efficiency","description":"Always consider the computational complexity of your algorithms and leverage efficient built-in methods when available. Look for opportunities to reduce time complexity and avoid unnecessary operations like redundant loops or object creation.","repository":"block/goose","domain":"ai-agents","topic":"Algorithms","language":"TSX","updated":"2025-07-21","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-optimize-algorithmic-efficiency.md"},{"slug":"goose-validate-object-availability","title":"Validate object availability","description":"Always verify that objects and their properties exist before accessing them to prevent null reference errors. This includes checking for undefined global objects, optional parameters, and nested properties.","repository":"block/goose","domain":"ai-agents","topic":"Null Handling","language":"TSX","updated":"2025-07-21","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-validate-object-availability.md"},{"slug":"mastodon-environment-variable-descriptive-naming","title":"Environment variable descriptive naming","description":"Environment variables should use descriptive, specific names that clearly indicate their purpose and scope to avoid conflicts and improve maintainability. Generic names can lead to confusion when multiple features need similar configuration options.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2025-07-21","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-environment-variable-descriptive-naming.md"},{"slug":"openpilot-design-convenient-apis","title":"Design convenient APIs","description":"APIs should provide convenient methods that handle common operations directly, rather than requiring users to write helper functions or use verbose patterns. This improves developer experience and reduces boilerplate code.","repository":"commaai/openpilot","domain":"ml-systems","topic":"API","language":"Python","updated":"2025-07-21","comments":2,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-design-convenient-apis.md"},{"slug":"posthog-api-initialization-side-effects","title":"API initialization side effects","description":"When initializing API clients, prefer bootstrap/configuration patterns over method calls that may trigger unintended side effects like billing events, data capture, or state changes. Method calls during initialization can have unexpected consequences that users may not anticipate or want to pay for.","repository":"PostHog/posthog","domain":"data-systems","topic":"API","language":"Html","updated":"2025-07-21","comments":2,"stars":28460,"raw":"https://awesomereviewers.com/raw/posthog-api-initialization-side-effects.md"},{"slug":"react-router-structure-documentation-interfaces","title":"Structure documentation interfaces","description":"Organize interfaces and component props documentation to improve API clarity and maintainability. Extract reusable interfaces into separate declarations to generate dedicated documentation pages, and ensure prop documentation accurately represents the code structure, especially for rest/spread operators.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Documentation","language":"TSX","updated":"2025-07-21","comments":2,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-structure-documentation-interfaces.md"},{"slug":"rust-optimize-dependency-configurations","title":"Optimize dependency configurations","description":"When configuring project dependencies, be mindful of feature flags that may introduce unnecessary build dependencies or slow down compilation. For libraries like serde, separate the core functionality from derive macros to improve build parallelization:","repository":"rust-lang/rust","domain":"runtimes","topic":"Configurations","language":"Toml","updated":"2025-07-21","comments":2,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-optimize-dependency-configurations.md"},{"slug":"bazel-add-explanatory-comments","title":"Add explanatory comments","description":"Add explanatory comments and documentation for complex logic, non-obvious code behavior, method parameters, and API functionality to improve code readability and maintainability.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Documentation","language":"Java","updated":"2025-07-20","comments":11,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-add-explanatory-comments.md"},{"slug":"fiber-minimize-memory-allocations","title":"minimize memory allocations","description":"Prioritize reducing memory allocations and choosing efficient data structures to improve performance. Avoid unnecessary string/byte conversions, use maps for O(1) lookups instead of slices, and leverage compiler optimizations where possible.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Performance Optimization","language":"Go","updated":"2025-07-20","comments":9,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-minimize-memory-allocations.md"},{"slug":"appwrite-stable-dependency-version-management","title":"Stable dependency version management","description":"Always use stable, well-defined version constraints in configuration files to ensure reproducible builds and prevent unexpected behavior. Avoid using development branches for production dependencies.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2025-07-20","comments":7,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-stable-dependency-version-management.md"},{"slug":"hyprland-avoid-expensive-hot-paths","title":"avoid expensive hot paths","description":"Identify and optimize expensive operations in frequently executed code paths to prevent performance bottlenecks. Hot paths include rendering loops, input event handlers, and frequently called utility functions.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Performance Optimization","language":"C++","updated":"2025-07-20","comments":7,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-avoid-expensive-hot-paths.md"},{"slug":"roo-code-validate-nullable-values-explicitly","title":"Validate nullable values explicitly","description":"Always handle potentially null or undefined values explicitly using type guards, null coalescing operators, and proper fallback values. This ensures type safety and prevents runtime errors from null references.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2025-07-20","comments":7,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-validate-nullable-values-explicitly.md"},{"slug":"router-ssr-documentation-completeness","title":"SSR documentation completeness","description":"Ensure server-side rendering documentation provides complete implementation details with proper build configurations and explanatory context. SSR setup guides should include comprehensive Vite configurations that clearly separate client and server bundles, detailed explanations of script purposes, and complete file structures.","repository":"TanStack/router","domain":"app-frameworks","topic":"Next","language":"Markdown","updated":"2025-07-20","comments":7,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-ssr-documentation-completeness.md"},{"slug":"roo-code-maintain-consistent-naming-patterns","title":"Maintain consistent naming patterns","description":"Use consistent naming patterns throughout the codebase. When adding new identifiers, follow existing patterns in similar contexts. This includes: 1. Consistent prefix/suffix patterns in related identifiers","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-20","comments":6,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-maintain-consistent-naming-patterns.md"},{"slug":"appwrite-assert-response-fully-always","title":"Assert response fully always","description":"Always validate all relevant aspects of API responses in tests, including status codes, headers, and body content. Don't partially validate responses or make assumptions about response structure.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Testing","language":"PHP","updated":"2025-07-20","comments":5,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-assert-response-fully-always.md"},{"slug":"codex-document-non-obvious-aspects","title":"Document non-obvious aspects","description":"Documentation should explain what isn't obvious from the code itself. Focus on providing context about \"why\" certain decisions were made rather than restating what the code does.","repository":"openai/codex","domain":"ai-agents","topic":"Documentation","language":"Rust","updated":"2025-07-20","comments":5,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-document-non-obvious-aspects.md"},{"slug":"router-configuration-option-consistency","title":"Configuration option consistency","description":"Ensure configuration options follow consistent naming conventions and are documented accurately. Use \"default\" prefix for options that can be overridden at more specific levels (e.g., `defaultOutputPath` instead of `outputPath`). Document only public APIs - avoid documenting internal or experimental configuration options that are not yet part of the public...","repository":"TanStack/router","domain":"app-frameworks","topic":"Configurations","language":"Markdown","updated":"2025-07-20","comments":5,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-configuration-option-consistency.md"},{"slug":"rust-document-lock-behavior","title":"Document lock behavior","description":"When implementing or documenting synchronization primitives, always clearly specify how locks behave under exceptional conditions, particularly during thread panics. This information is critical for developers to write robust concurrent code.","repository":"rust-lang/rust","domain":"runtimes","topic":"Concurrency","language":"Rust","updated":"2025-07-20","comments":5,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-document-lock-behavior.md"},{"slug":"router-test-real-user-interactions","title":"test real user interactions","description":"Write tests that simulate actual user behavior and verify real rendering outcomes rather than testing implementation details or internal state. Use `data-testid` attributes with `getByTestId` instead of `getByRole` for better maintainability, as it allows changing text and HTML structure without breaking tests. Focus on testing what users actually see and...","repository":"TanStack/router","domain":"app-frameworks","topic":"Testing","language":"TSX","updated":"2025-07-20","comments":4,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-test-real-user-interactions.md"},{"slug":"appwrite-use-object-methods-consistently","title":"Use object methods consistently","description":"When working with Document objects, always use their accessor methods rather than array-style syntax. Use `$object->getAttribute('property')` and `$object->setAttribute('property', $value)` instead of `$object['property']`. This ensures proper encapsulation, maintains data integrity through validation, and creates more resilient code that won't break if the...","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Code Style","language":"PHP","updated":"2025-07-20","comments":3,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-use-object-methods-consistently.md"},{"slug":"argo-cd-extract-testable-units","title":"Extract testable units","description":"Avoid copying or reimplementing production logic in test files. Instead, refactor the production code to extract small, testable functions that can be unit tested with mocked dependencies. Tests should call the actual production functions rather than duplicating their logic.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Testing","language":"Go","updated":"2025-07-20","comments":3,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-extract-testable-units.md"},{"slug":"kafka-use-parameterized-logging","title":"Use parameterized logging","description":"Use parameterized logging with placeholders (`{}`) instead of string concatenation for better performance and readability. When logging exceptions, pass the exception object as a separate parameter to the logger rather than including its message in the format string.","repository":"apache/kafka","domain":"data-systems","topic":"Logging","language":"Java","updated":"2025-07-20","comments":3,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-use-parameterized-logging.md"},{"slug":"roo-code-sanitize-user-inputs","title":"Sanitize user inputs","description":"Always validate and sanitize user-provided inputs before using them\\ \\ in security-sensitive operations to prevent XSS attacks and unsafe redirections.\\ \\ \\n","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Security","language":"JavaScript","updated":"2025-07-20","comments":2,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-sanitize-user-inputs.md"},{"slug":"codex-contextualize-dont-swallow","title":"Contextualize, don't swallow","description":"Always propagate errors with appropriate context rather than silently ignoring them. This makes debugging easier and prevents unexpected behavior. **Do**:","repository":"openai/codex","domain":"ai-agents","topic":"Error Handling","language":"Rust","updated":"2025-07-19","comments":5,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-contextualize-dont-swallow.md"},{"slug":"fiber-validate-security-configurations","title":"Validate security configurations","description":"Always verify that security middleware configurations use correct constant values, proper parameter specifications, and follow established security practices. Incorrect configuration values can create vulnerabilities or cause security features to fail silently.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Security","language":"Markdown","updated":"2025-07-19","comments":5,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-validate-security-configurations.md"},{"slug":"typescript-guard-against-undefined","title":"Guard against undefined","description":"Always protect against potential null or undefined values before attempting property access or method calls to prevent runtime errors. This applies especially to array access, method calls like `.some()` or `.length`, and property access on objects that might be null.","repository":"microsoft/typescript","domain":"runtimes","topic":"Null Handling","language":"TypeScript","updated":"2025-07-19","comments":5,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-guard-against-undefined.md"},{"slug":"goose-ai-terminology-consistency","title":"AI terminology consistency","description":"Maintain consistent terminology when describing AI systems, capabilities, and workflows throughout documentation and content. This includes using standardized terms for AI entities (consistently choosing between \"AI\", \"assistant\", \"model\", or \"agent\"), technical processes, and capability descriptions.","repository":"block/goose","domain":"ai-agents","topic":"AI","language":"Markdown","updated":"2025-07-19","comments":4,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-ai-terminology-consistency.md"},{"slug":"spark-avoid-null-in-scala","title":"avoid null in Scala","description":"Avoid using null values in Scala code and prefer Option types for representing optional values. Null usage can lead to NullPointerException at runtime and makes code less safe and predictable.","repository":"apache/spark","domain":"data-systems","topic":"Null Handling","language":"Other","updated":"2025-07-19","comments":4,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-avoid-null-in-scala.md"},{"slug":"cline-validate-configuration-values","title":"validate configuration values","description":"Always verify configuration values against official documentation and test across target platforms before committing. Invalid configuration values can cause build failures, runtime errors, or platform-specific issues that are difficult to debug.","repository":"cline/cline","domain":"ai-agents","topic":"Configurations","language":"Json","updated":"2025-07-19","comments":3,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-validate-configuration-values.md"},{"slug":"markitdown-improve-code-modularity","title":"Improve code modularity","description":"Organize code into well-structured, reusable components by extracting specific functionality into separate functions, using flexible parameter patterns, and consolidating duplicate logic. This improves readability, maintainability, and extensibility.","repository":"microsoft/markitdown","domain":"llm-infra","topic":"Code Style","language":"Python","updated":"2025-07-19","comments":3,"stars":76602,"raw":"https://awesomereviewers.com/raw/markitdown-improve-code-modularity.md"},{"slug":"opencode-reuse-existing-code","title":"reuse existing code","description":"Before implementing new functionality, check if similar utilities or patterns already exist in the codebase. Consolidate duplicate logic and leverage existing libraries to maintain consistency and reduce maintenance overhead.","repository":"sst/opencode","domain":"ai-agents","topic":"Code Style","language":"Go","updated":"2025-07-19","comments":3,"stars":28213,"raw":"https://awesomereviewers.com/raw/opencode-reuse-existing-code.md"},{"slug":"cline-configure-formatting-tools-consistently","title":"Configure formatting tools consistently","description":"Properly configure development tools to maintain consistent code formatting across the entire codebase and development environments. This includes setting up formatter ignore files, git attributes, and other configuration files that ensure uniform code style regardless of developer setup or platform differences.","repository":"cline/cline","domain":"ai-agents","topic":"Code Style","language":"Other","updated":"2025-07-19","comments":2,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-configure-formatting-tools-consistently.md"},{"slug":"yaak-preserve-url-integrity","title":"preserve URL integrity","description":"When manipulating URLs for API calls, prioritize preserving the original URL structure over using convenience APIs that may normalize or modify the URL unexpectedly. This is especially important when appending query parameters or handling URL fragments.","repository":"mountain-loop/yaak","domain":"devtools","topic":"API","language":"TypeScript","updated":"2025-07-19","comments":2,"stars":13008,"raw":"https://awesomereviewers.com/raw/yaak-preserve-url-integrity.md"},{"slug":"n8n-clean-and-consistent-code","title":"Clean and consistent code","description":"Maintain clean and consistent code by removing unnecessary elements and following standard practices: 1. **Remove commented-out code and unused imports** - Don''t leave commented-out code in the codebase. If code is no longer needed, delete it entirely rather than commenting it out. Similarly, remove unused imports to reduce bundle size and avoid linting...","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Code Style","language":"Other","updated":"2025-07-18","comments":12,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-clean-and-consistent-code.md"},{"slug":"gemini-cli-ai-model-integration-patterns","title":"AI model integration patterns","description":"When integrating with AI models and LLMs, structure your code to properly handle model responses, separate concerns between layers, and implement robust failure detection mechanisms.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"AI","language":"TypeScript","updated":"2025-07-18","comments":10,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-ai-model-integration-patterns.md"},{"slug":"vscode-validate-nullability-with-types","title":"Validate nullability with types","description":"Always handle null and undefined values explicitly through proper type declarations and validation patterns rather than using non-null assertions or unsafe type casts. This ensures type safety and prevents runtime errors.","repository":"microsoft/vscode","domain":"devtools","topic":"Null Handling","language":"TypeScript","updated":"2025-07-18","comments":10,"stars":174887,"raw":"https://awesomereviewers.com/raw/vscode-validate-nullability-with-types.md"},{"slug":"temporal-names-reflect-precise-behavior","title":"Names reflect precise behavior","description":"Choose names that accurately reflect the behavior and purpose of code elements. Names should be semantically precise and avoid misleading implications. This applies to methods, variables, and configuration parameters.","repository":"temporalio/temporal","domain":"orchestration","topic":"Naming Conventions","language":"Go","updated":"2025-07-18","comments":8,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-names-reflect-precise-behavior.md"},{"slug":"continue-ci-script-reliability-practices","title":"CI script reliability practices","description":"Ensure CI/CD workflows maintain reliability by following these practices: 1. **Use explicit script paths** - Always use explicit paths when invoking scripts (e.g., `./build.ps1` for PowerShell or `./build.sh` for bash) rather than relying on implicit path resolution. This ensures the runner can locate and execute scripts regardless of the current working...","repository":"continuedev/continue","domain":"ai-agents","topic":"CI/CD","language":"Yaml","updated":"2025-07-18","comments":7,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-ci-script-reliability-practices.md"},{"slug":"gemini-cli-test-behavioral-differences","title":"Test behavioral differences","description":"Tests should verify that different states, modes, or inputs produce meaningfully different behaviors, not just that code doesn't crash. Focus on testing state transitions, edge cases, and behavioral changes rather than basic existence checks.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Testing","language":"TSX","updated":"2025-07-18","comments":7,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-test-behavioral-differences.md"},{"slug":"n8n-maintain-test-state-isolation","title":"Maintain test state isolation","description":"Ensure each test runs in isolation by properly managing test state, mocks, and timers. Clean up all test artifacts in beforeEach/afterEach hooks rather than within individual tests to prevent state leakage and test interdependence.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Testing","language":"TypeScript","updated":"2025-07-18","comments":7,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-maintain-test-state-isolation.md"},{"slug":"agents-test-actual-functionality","title":"Test actual functionality","description":"Ensure tests verify real operations and integration scenarios rather than just basic concepts or type definitions. Many test suites contain placeholder tests that only check if functions exist or verify simple type structures, but fail to test the actual behavior and interactions that matter in production.","repository":"cloudflare/agents","domain":"ai-agents","topic":"Testing","language":"TypeScript","updated":"2025-07-18","comments":6,"stars":2312,"raw":"https://awesomereviewers.com/raw/agents-test-actual-functionality.md"},{"slug":"continue-handle-unsafe-operations-safely","title":"Handle unsafe operations safely","description":"Always wrap potentially unsafe operations (like JSON parsing, Buffer operations, or API calls) in try-catch blocks with appropriate error handling. Ensure error messages are user-friendly and actionable.","repository":"continuedev/continue","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2025-07-18","comments":6,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-handle-unsafe-operations-safely.md"},{"slug":"n8n-never-swallow-errors-silently","title":"Never swallow errors silently","description":"Always handle errors explicitly and preserve their context. Never silently catch and discard errors as this hides bugs and makes debugging difficult. When re-throwing errors, include the original error as the cause to maintain the stack trace. In UI components, convert errors to user-friendly messages while logging technical details at appropriate levels.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2025-07-18","comments":6,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-never-swallow-errors-silently.md"},{"slug":"n8n-standardize-llm-interface-parameters","title":"Standardize LLM interface parameters","description":"Maintain consistent parameter names and interface patterns across LLM implementations to improve maintainability and prevent integration issues. This includes:","repository":"n8n-io/n8n","domain":"ai-agents","topic":"AI","language":"TypeScript","updated":"2025-07-18","comments":6,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-standardize-llm-interface-parameters.md"},{"slug":"nuxt-use-descriptive-names","title":"Use descriptive names","description":"Choose variable, function, and file names that clearly describe their purpose, behavior, and content. Names should be self-documenting and avoid ambiguity about what they represent or do.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-18","comments":6,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-use-descriptive-names.md"},{"slug":"rust-structure-validation-algorithms","title":"Structure validation algorithms","description":"When implementing or modifying parsing and validation algorithms, carefully consider both the correctness and user experience aspects: 1. **Preserve structural ordering** in data structures like ASTs when order impacts semantics. As noted in discussion #1, \"In some cases, like in macro scoping, the order is actually important,\" so field reordering can...","repository":"rust-lang/rust","domain":"runtimes","topic":"Algorithms","language":"Other","updated":"2025-07-18","comments":6,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-structure-validation-algorithms.md"},{"slug":"comfyui-avoid-expensive-operations","title":"avoid expensive operations","description":"Identify and eliminate unnecessary expensive operations that can significantly impact performance. Common patterns to watch for include: 1. **Unnecessary deep copying**: Instead of using `deepcopy()` on large objects, build new dictionaries with only the required values. For example, rather than `copy.deepcopy(self.history[key])` and then removing unwanted...","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Performance Optimization","language":"Python","updated":"2025-07-18","comments":5,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-avoid-expensive-operations.md"},{"slug":"continue-document-why-not-what","title":"Document why not what","description":"Documentation should explain rationale and be technically precise. Focus on: 1. Including all required parameters with correct names in examples and documentation","repository":"continuedev/continue","domain":"ai-agents","topic":"Documentation","language":"TypeScript","updated":"2025-07-18","comments":5,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-document-why-not-what.md"},{"slug":"continue-robust-comparison-algorithms","title":"Robust comparison algorithms","description":"Ensure your comparison algorithms handle edge cases properly and avoid common pitfalls: 1. **Normalize values before comparison** - When comparing strings, consider if you need to normalize whitespace, case, or other variants:","repository":"continuedev/continue","domain":"ai-agents","topic":"Algorithms","language":"TypeScript","updated":"2025-07-18","comments":5,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-robust-comparison-algorithms.md"},{"slug":"prometheus-simplify-test-structure","title":"simplify test structure","description":"Write tests that are direct, focused, and free of unnecessary complexity. Remove redundant test fields, use direct assertions with expected values, and leverage existing fixtures instead of creating temporary content.","repository":"prometheus/prometheus","domain":"observability","topic":"Testing","language":"Go","updated":"2025-07-18","comments":5,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-simplify-test-structure.md"},{"slug":"temporal-design-stable-apis","title":"Design stable APIs","description":"When designing APIs, prioritize long-term stability and compatibility to avoid breaking changes. Use request/response objects pattern for methods that might evolve over time rather than direct parameters:","repository":"temporalio/temporal","domain":"orchestration","topic":"API","language":"Go","updated":"2025-07-18","comments":5,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-design-stable-apis.md"},{"slug":"argo-cd-simplify-code-readability","title":"Simplify code readability","description":"Prioritize code readability by using clearer control structures, extracting complex expressions into descriptive variables, and choosing simpler syntax when available. This improves maintainability and makes code easier to understand for other developers.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Code Style","language":"TSX","updated":"2025-07-18","comments":4,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-simplify-code-readability.md"},{"slug":"gemini-cli-prefer-settings-over-environment","title":"prefer settings over environment","description":"Prefer settings.json over environment variables and CLI flags for user configuration options. Environment variables should be reserved for system-level configuration or cases where the setting must be available before settings.json is loaded. CLI flags should be used for options that users frequently change between invocations.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-07-18","comments":4,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-prefer-settings-over-environment.md"},{"slug":"supabase-maintain-code-consistency","title":"Maintain code consistency","description":"Ensure consistent code organization, naming conventions, and structure throughout the codebase: 1. Use identical parameter names for similar components (e.g., `queryGroup=\"language\"` instead of custom names)","repository":"supabase/supabase","domain":"data-systems","topic":"Code Style","language":"Other","updated":"2025-07-18","comments":4,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-maintain-code-consistency.md"},{"slug":"cline-provide-configuration-fallbacks","title":"Provide configuration fallbacks","description":"Always provide sensible default or fallback values for configuration properties to prevent undefined states that can block users or cause application errors. Configuration properties should never be left in an undefined state that prevents normal application functionality.","repository":"cline/cline","domain":"ai-agents","topic":"Configurations","language":"TSX","updated":"2025-07-18","comments":3,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-provide-configuration-fallbacks.md"},{"slug":"cline-set-evidence-based-timeouts","title":"Set evidence-based timeouts","description":"Configure timeout values based on empirical testing and user experience requirements rather than arbitrary durations. Analyze actual system behavior to determine appropriate timeout thresholds that balance responsiveness with reliability.","repository":"cline/cline","domain":"ai-agents","topic":"Performance Optimization","language":"TypeScript","updated":"2025-07-18","comments":3,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-set-evidence-based-timeouts.md"},{"slug":"duckdb-maintain-consistent-naming-patterns","title":"Maintain consistent naming patterns","description":"Ensure all new functions, files, and identifiers follow established naming conventions within the codebase. This prevents naming conflicts, maintains API consistency, and improves code readability.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Naming Conventions","language":"Json","updated":"2025-07-18","comments":3,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-maintain-consistent-naming-patterns.md"},{"slug":"duckdb-thoughtful-configuration-design","title":"thoughtful configuration design","description":"When designing configuration options, environment variables, and build settings, follow established patterns and ensure they serve a clear purpose. Consider cross-platform compatibility, use familiar conventions (like PATH-style lists), and align configuration choices with project requirements.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Configurations","language":"Txt","updated":"2025-07-18","comments":3,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-thoughtful-configuration-design.md"},{"slug":"langflow-handle-null-values-safely","title":"Handle null values safely","description":"When handling potentially null or undefined values, implement explicit null checks and provide safe default values rather than allowing null values to propagate through the system. This prevents null reference errors and ensures predictable behavior.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2025-07-18","comments":3,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-handle-null-values-safely.md"},{"slug":"spark-verify-ci-build-consistency","title":"Verify CI build consistency","description":"Ensure CI pipelines thoroughly verify build outputs and maintain consistency across different build tools and configurations. This prevents broken builds from reaching contributors and ensures reliable deployment artifacts.","repository":"apache/spark","domain":"data-systems","topic":"CI/CD","language":"Yaml","updated":"2025-07-18","comments":3,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-verify-ci-build-consistency.md"},{"slug":"vscode-parallelize-independent-operations","title":"Parallelize independent operations","description":"When writing concurrent code, always execute independent operations in parallel rather than sequentially to improve performance and responsiveness. Using parallel execution patterns can significantly reduce waiting time for I/O-bound operations.","repository":"microsoft/vscode","domain":"devtools","topic":"Concurrency","language":"TypeScript","updated":"2025-07-18","comments":3,"stars":174887,"raw":"https://awesomereviewers.com/raw/vscode-parallelize-independent-operations.md"},{"slug":"workerd-simplify-async-patterns","title":"Simplify async patterns","description":"Use modern promise utilities and clean async patterns instead of manual promise construction. Prefer Promise.withResolvers() over manual promise creation with resolve/reject callbacks, and chain promises directly rather than wrapping them in unnecessary async functions.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Concurrency","language":"JavaScript","updated":"2025-07-18","comments":3,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-simplify-async-patterns.md"},{"slug":"agents-test-security-boundaries","title":"Test security boundaries","description":"Security mechanisms should be tested for both success and failure scenarios to ensure they properly enforce boundaries. Don't just test that security features work when enabled - also verify they correctly block unauthorized access when disabled or misconfigured.","repository":"cloudflare/agents","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2025-07-18","comments":2,"stars":2312,"raw":"https://awesomereviewers.com/raw/agents-test-security-boundaries.md"},{"slug":"cline-organize-environment-configurations","title":"organize environment configurations","description":"Environment variables in CI/CD workflows should be organized consistently using structured `env` sections rather than inline declarations, and should account for platform-specific requirements. This improves maintainability, readability, and prevents environment-related failures across different operating systems.","repository":"cline/cline","domain":"ai-agents","topic":"Configurations","language":"Yaml","updated":"2025-07-18","comments":2,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-organize-environment-configurations.md"},{"slug":"codex-provider-agnostic-api-design","title":"Provider-agnostic API design","description":"Design your API interfaces to be provider-agnostic rather than tightly coupled to specific service providers. This improves flexibility, maintainability, and makes future provider changes less disruptive.","repository":"openai/codex","domain":"ai-agents","topic":"API","language":"Rust","updated":"2025-07-18","comments":2,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-provider-agnostic-api-design.md"},{"slug":"discourse-limit-plugin-outlet-apis","title":"Limit plugin outlet APIs","description":"When creating plugin outlets or extension points, avoid exposing entire component instances, controllers, or large objects. Instead, pass explicit, minimal arguments that represent only the data and actions that plugins actually need.","repository":"discourse/discourse","domain":"app-frameworks","topic":"API","language":"Other","updated":"2025-07-18","comments":2,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-limit-plugin-outlet-apis.md"},{"slug":"kafka-api-response-completeness","title":"API response completeness","description":"Ensure API responses contain all necessary data fields and provide mechanisms for clients to verify operation results. When building API responses, successful operations should include complete metadata (such as topic IDs, timestamps, or other identifiers), while failed operations should contain appropriate error information. Additionally, provide...","repository":"apache/kafka","domain":"data-systems","topic":"API","language":"Other","updated":"2025-07-18","comments":2,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-api-response-completeness.md"},{"slug":"mono-avoid-stale-ref-values","title":"avoid stale ref values","description":"When using React refs in hooks like useLayoutEffect or useEffect, pass the ref object itself rather than ref.current to avoid stale values. The ref.current value captured at hook definition time may be outdated when the effect callback executes.","repository":"rocicorp/mono","domain":"data-systems","topic":"React","language":"TypeScript","updated":"2025-07-18","comments":2,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-avoid-stale-ref-values.md"},{"slug":"sglang-cuda-compatibility-verification","title":"CUDA compatibility verification","description":"When modifying CUDA versions or GPU architecture configurations in AI/ML projects, verify compatibility across three critical dimensions: CUDA version support, GPU architecture coverage, and dependent library requirements. Check official compatibility matrices, test with target hardware, and validate that AI libraries maintain their functionality.","repository":"sgl-project/sglang","domain":"llm-infra","topic":"AI","language":"Dockerfile","updated":"2025-07-18","comments":2,"stars":17245,"raw":"https://awesomereviewers.com/raw/sglang-cuda-compatibility-verification.md"},{"slug":"spark-prefer-system-properties-directly","title":"prefer system properties directly","description":"When detecting operating system or environment characteristics, prefer direct access to system properties over external library dependencies for basic checks. Use `System.getProperty(\"os.name\")` with `regionMatches()` for case-insensitive OS detection instead of relying on third-party utilities like Apache Commons Lang3's SystemUtils.","repository":"apache/spark","domain":"data-systems","topic":"Configurations","language":"Java","updated":"2025-07-18","comments":2,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-prefer-system-properties-directly.md"},{"slug":"traefik-avoid-external-dependencies","title":"avoid external dependencies","description":"Unit tests should not depend on external components like databases, Redis, or Kubernetes clusters. Instead, create fake implementations or use mocks to isolate the code under test. Reserve integration tests for scenarios that require real external services.","repository":"traefik/traefik","domain":"cloud-infra","topic":"Testing","language":"Go","updated":"2025-07-18","comments":2,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-avoid-external-dependencies.md"},{"slug":"traefik-proper-context-handling","title":"proper context handling","description":"Always propagate contexts consistently throughout the call chain and handle context cancellation properly in concurrent operations. When a context is available in the current scope, reuse it instead of creating a new background context. For operations that may block (like time.Sleep), use context-aware alternatives to prevent goroutine leaks when requests...","repository":"traefik/traefik","domain":"cloud-infra","topic":"Concurrency","language":"Go","updated":"2025-07-18","comments":2,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-proper-context-handling.md"},{"slug":"roo-code-escape-xml-content-securely","title":"Escape XML content securely","description":"Always use proper XML entity escaping instead of CDATA blocks when embedding XML-like content within XML documents. CDATA sections can be vulnerable to XML injection attacks if the content isn''t properly validated or controlled.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Security","language":"Xml","updated":"2025-07-18","comments":1,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-escape-xml-content-securely.md"},{"slug":"n8n-use-structured-logging","title":"Use structured logging","description":"Always use the project's structured logger instead of direct console methods (`console.log`, `console.error`, etc.). This ensures consistent log formatting, proper level-based filtering, and integration with monitoring systems.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Logging","language":"TypeScript","updated":"2025-07-17","comments":8,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-use-structured-logging.md"},{"slug":"prisma-explicit-null-handling","title":"explicit null handling","description":"Prefer explicit null and undefined handling over optional or nullable types. When possible, provide default values or objects instead of making parameters optional. When null/undefined checks are necessary, handle both values explicitly and use descriptive patterns.","repository":"prisma/prisma","domain":"data-systems","topic":"Null Handling","language":"TypeScript","updated":"2025-07-17","comments":8,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-explicit-null-handling.md"},{"slug":"continue-extract-into-helper-functions","title":"Extract into helper functions","description":"Break down complex or deeply nested code into smaller, well-named helper functions to improve readability and maintainability. Extract code into helpers when:","repository":"continuedev/continue","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2025-07-17","comments":6,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-extract-into-helper-functions.md"},{"slug":"n8n-sanitize-all-dynamic-content","title":"Sanitize all dynamic content","description":"Always sanitize dynamic content before rendering to prevent XSS and injection attacks. This includes HTML content, CSS styles, and executable scripts. Use appropriate sanitization methods based on content type:","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Security","language":"Other","updated":"2025-07-17","comments":6,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-sanitize-all-dynamic-content.md"},{"slug":"cline-centralize-configuration-management","title":"centralize configuration management","description":"Consolidate related configuration settings into dedicated config objects or files rather than scattering hardcoded values throughout the codebase. Separate different types of configuration (API endpoints, timeouts, credentials) into distinct config sections to improve maintainability and avoid coupling.","repository":"cline/cline","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-07-17","comments":5,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-centralize-configuration-management.md"},{"slug":"cline-use-semantic-naming","title":"use semantic naming","description":"Choose variable, function, and type names that clearly communicate their purpose and meaning without requiring additional context or comments. Names should be self-documenting and unambiguous to future developers.","repository":"cline/cline","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-17","comments":5,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-use-semantic-naming.md"},{"slug":"gemini-cli-document-current-functionality","title":"document current functionality","description":"Documentation should focus exclusively on current, active functionality rather than including historical context, deprecated features, or legacy modes. Remove sections that explain how things \"used to work\" or provide extensive support for outdated approaches that have minimal user adoption.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Documentation","language":"Markdown","updated":"2025-07-17","comments":5,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-document-current-functionality.md"},{"slug":"kafka-defensive-null-validation","title":"Defensive null validation","description":"Always validate null parameters and dependencies early with proper ordering to prevent NullPointerExceptions and provide clear error messages. Use defensive programming practices including parameter validation, method overloading instead of null parameter handling, and careful ordering of null checks.","repository":"apache/kafka","domain":"data-systems","topic":"Null Handling","language":"Java","updated":"2025-07-17","comments":5,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-defensive-null-validation.md"},{"slug":"roo-code-use-structured-logging","title":"Use structured logging","description":"Replace direct `console.log`, `console.warn`, and `console.error` calls with a centralized logging abstraction. This ensures logs are consistently formatted, properly categorized by severity, and can be filtered or disabled in production environments.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Logging","language":"TypeScript","updated":"2025-07-17","comments":5,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-use-structured-logging.md"},{"slug":"bazel-ensure-documentation-completeness","title":"Ensure documentation completeness","description":"All code elements should have sufficient documentation to understand their purpose, usage, and context. This includes adding explanatory comments for non-obvious constants, documenting private functions for maintainability, ensuring grammatical accuracy in all documentation, and providing necessary context such as prerequisites or limitations.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Documentation","language":"Other","updated":"2025-07-17","comments":4,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-ensure-documentation-completeness.md"},{"slug":"codex-semantic-naming-patterns","title":"Semantic naming patterns","description":"Use names that clearly convey purpose and maintain consistency across related components. Avoid generic identifiers (like `dir`) in favor of descriptive ones (like `codex_home`), and ensure placeholder names in string templates are self-explanatory (prefer `SUMMARY_TEXT` over `{}`). For related functions or elements, establish consistent naming patterns...","repository":"openai/codex","domain":"ai-agents","topic":"Naming Conventions","language":"Rust","updated":"2025-07-17","comments":4,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-semantic-naming-patterns.md"},{"slug":"gemini-cli-centralize-proxy-configuration","title":"Centralize proxy configuration","description":"Avoid duplicate proxy configuration across your application by establishing a single point of proxy setup and leveraging built-in proxy support where available. Multiple proxy configurations can lead to conflicts, inconsistent behavior, and maintenance overhead.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Networking","language":"TypeScript","updated":"2025-07-17","comments":4,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-centralize-proxy-configuration.md"},{"slug":"kafka-improve-code-readability","title":"Improve code readability","description":"Write code that prioritizes readability through clear string formatting, descriptive method calls, and well-organized structure. Use string interpolation instead of concatenation for better readability, choose descriptive assertion methods that provide meaningful error messages, avoid code duplication by leveraging method overloading, and extract complex...","repository":"apache/kafka","domain":"data-systems","topic":"Code Style","language":"Other","updated":"2025-07-17","comments":4,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-improve-code-readability.md"},{"slug":"prometheus-complete-observability-documentation","title":"Complete observability documentation","description":"Ensure documentation for observability systems provides comprehensive information including all required permissions, complete configuration options, and clear warnings about operational impacts. Monitoring and metrics systems often have significant performance and security implications that users must understand to operate them safely.","repository":"prometheus/prometheus","domain":"observability","topic":"Observability","language":"Markdown","updated":"2025-07-17","comments":4,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-complete-observability-documentation.md"},{"slug":"roo-code-consistent-output-path-specification","title":"Consistent output path specification","description":"Configuration files defining operations that generate data outputs must always include a `<save_to>` element specifying the output location. Follow established patterns for similar operations, typically using predictable paths like `.roo/temp/pr-[PR_NUMBER]/[operation]-output.{json|diff}`. This ensures operation outputs are consistently stored and easily...","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Configurations","language":"Xml","updated":"2025-07-17","comments":4,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-consistent-output-path-specification.md"},{"slug":"n8n-prevent-element-double-counting","title":"Prevent element double-counting","description":"When working with graph structures, collections, or relationship mappings, ensure each element is processed exactly once to maintain algorithmic integrity. Implement proper tracking mechanisms to prevent duplicate counting or processing of elements, especially in scenarios involving:","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Algorithms","language":"TypeScript","updated":"2025-07-17","comments":3,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-prevent-element-double-counting.md"},{"slug":"supabase-centralize-configuration-values","title":"Centralize configuration values","description":"Extract and centralize configuration values instead of duplicating or hardcoding them throughout the codebase. This improves maintainability by ensuring changes only need to be made in one place and enforces consistency across the application.","repository":"supabase/supabase","domain":"data-systems","topic":"Configurations","language":"TypeScript","updated":"2025-07-17","comments":3,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-centralize-configuration-values.md"},{"slug":"appwrite-validate-documentation-links","title":"Validate documentation links","description":"Always verify that URLs in documentation resolve correctly (return HTTP 200) before merging changes. Broken links create a poor user experience and reduce the credibility of documentation.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-07-17","comments":2,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-validate-documentation-links.md"},{"slug":"n8n-avoid-hardcoded-configurations","title":"Avoid hardcoded configurations","description":"Never hardcode environment-specific values or feature states directly in your code. Instead, use environment variables, configuration files, or feature flag systems to manage these values dynamically.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Configurations","language":"Other","updated":"2025-07-17","comments":2,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-avoid-hardcoded-configurations.md"},{"slug":"n8n-optimize-vue-watchers","title":"Optimize Vue watchers","description":"When implementing watchers in Vue applications, ensure they are configured appropriately for the data structures they observe. Two common pitfalls to avoid:","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Vue","language":"Other","updated":"2025-07-17","comments":2,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-optimize-vue-watchers.md"},{"slug":"nx-use-explicit-identifiers","title":"Use explicit identifiers","description":"Choose explicit, unambiguous names for functions, variables, and parameters to avoid conflicts with common types and reduce reliance on implicit assumptions. Prefer descriptive names that clearly indicate purpose over generic terms that might be confused with built-in types or require string parsing.","repository":"nrwl/nx","domain":"devtools","topic":"Naming Conventions","language":"Rust","updated":"2025-07-17","comments":2,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-use-explicit-identifiers.md"},{"slug":"signoz-provide-defaults-when-destructuring","title":"provide defaults when destructuring","description":"When destructuring properties from objects that might contain undefined values, use the nullish coalescing operator (??) to provide explicit default values at the point of assignment. This prevents undefined values from propagating through your code and eliminates the need for repeated null checks later.","repository":"SigNoz/signoz","domain":"observability","topic":"Null Handling","language":"TSX","updated":"2025-07-17","comments":2,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-provide-defaults-when-destructuring.md"},{"slug":"volcano-implement-simulation-testing","title":"Implement simulation testing","description":"When developing complex systems like schedulers or resource managers, create simulation-based testing frameworks to validate functionality in scenarios that cannot be easily reproduced in development environments. This approach enables testing of hardware configurations you don't have access to (GPU/NPU nodes), large-scale cluster behaviors, and parameter...","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Testing","language":"Markdown","updated":"2025-07-17","comments":2,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-implement-simulation-testing.md"},{"slug":"vscode-descriptive-semantic-naming","title":"Descriptive semantic naming","description":"Names should accurately reflect their purpose and behavior, providing users and developers with clear expectations. For identifiers, use specific qualifiers that indicate their intended context rather than generic terms. For UI elements like commands, ensure the name accurately represents the behavior (e.g., only use ellipsis '...' when additional input...","repository":"microsoft/vscode","domain":"devtools","topic":"Naming Conventions","language":"Json","updated":"2025-07-17","comments":2,"stars":174887,"raw":"https://awesomereviewers.com/raw/vscode-descriptive-semantic-naming.md"},{"slug":"n8n-avoid-hardcoded-credentials","title":"Avoid hardcoded credentials","description":"Never hardcode sensitive information such as passwords, API keys, or authentication tokens in source code, configuration files, or container definitions. These can be exposed through version control systems, shared repositories, or compromised container images.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Security","language":"Dockerfile","updated":"2025-07-17","comments":1,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-avoid-hardcoded-credentials.md"},{"slug":"vscode-update-security-patches-regularly","title":"Update security patches regularly","description":"Always keep dependencies, runtime environments, and libraries updated with the latest security patches to mitigate known vulnerabilities. Prioritize security updates even for minor version changes.","repository":"microsoft/vscode","domain":"devtools","topic":"Security","language":"Other","updated":"2025-07-17","comments":1,"stars":174887,"raw":"https://awesomereviewers.com/raw/vscode-update-security-patches-regularly.md"},{"slug":"v-use-descriptive-names","title":"Use descriptive names","description":"Choose variable, function, and parameter names that clearly communicate their purpose and avoid confusion. Names should be descriptive enough that their intent is obvious without requiring additional context or comments.","repository":"vlang/v","domain":"runtimes","topic":"Naming Conventions","language":"Other","updated":"2025-07-16","comments":15,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-use-descriptive-names.md"},{"slug":"unstructured-explicit-none-handling","title":"explicit None handling","description":"Always handle potential None values explicitly through defensive programming patterns, proper type annotations, and explicit checks to prevent runtime errors and improve code reliability.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Null Handling","language":"Python","updated":"2025-07-16","comments":11,"stars":12116,"raw":"https://awesomereviewers.com/raw/unstructured-explicit-none-handling.md"},{"slug":"electron-optimize-algorithmic-efficiency","title":"optimize algorithmic efficiency","description":"Choose efficient data structures and algorithms to minimize computational overhead and improve performance. This involves selecting appropriate containers based on usage patterns, avoiding unnecessary operations like redundant copies or conversions, and leveraging optimized library functions.","repository":"electron/electron","domain":"devtools","topic":"Algorithms","language":"Other","updated":"2025-07-16","comments":10,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-optimize-algorithmic-efficiency.md"},{"slug":"cal.com-authorization-hierarchy-verification","title":"Authorization hierarchy verification","description":"Always implement comprehensive authorization checks that verify user permissions at the appropriate hierarchy level (individual → team → organization) before allowing operations. Consider multiple permission levels and provide proper fallbacks when users have different roles across teams or organizations.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Security","language":"TypeScript","updated":"2025-07-16","comments":9,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-authorization-hierarchy-verification.md"},{"slug":"lmcache-use-descriptive-consistent-names","title":"Use descriptive consistent names","description":"Choose names that clearly convey their purpose, role, and meaning while maintaining consistency with established patterns in the codebase. Names should be self-documenting and unambiguous to future maintainers.","repository":"LMCache/LMCache","domain":"llm-infra","topic":"Naming Conventions","language":"Python","updated":"2025-07-16","comments":9,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-use-descriptive-consistent-names.md"},{"slug":"duckdb-explicit-ci-configurations","title":"Explicit CI configurations","description":"CI/CD workflows should use explicit, named configurations rather than wildcards, globs, or implicit behaviors to improve maintainability and debuggability. This makes it easier for developers to understand failures and reduces silent errors.","repository":"duckdb/duckdb","domain":"data-systems","topic":"CI/CD","language":"Yaml","updated":"2025-07-16","comments":6,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-explicit-ci-configurations.md"},{"slug":"electron-avoid-redundant-operations","title":"avoid redundant operations","description":"Identify and eliminate unnecessary duplicate operations, redundant function calls, and repeated computations that can impact performance. Common patterns include: avoiding redundant parameter retrieval when values are already available, preventing duplicate map lookups by caching results, checking for changes before performing expensive operations, and...","repository":"electron/electron","domain":"devtools","topic":"Performance Optimization","language":"Other","updated":"2025-07-16","comments":6,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-avoid-redundant-operations.md"},{"slug":"gemini-cli-secure-input-validation","title":"Secure input validation","description":"Always validate and sanitize user inputs, especially when constructing commands or file paths. Use established security libraries instead of implementing custom parsing logic, and implement proper validation that prevents attacks while avoiding false positives.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2025-07-16","comments":6,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-secure-input-validation.md"},{"slug":"llama.cpp-follow-naming-conventions","title":"Follow naming conventions","description":"Maintain consistency with established naming patterns and conventions throughout the codebase. This includes matching enum names with their value prefixes, following existing API naming patterns, using consistent variable naming within similar contexts, and applying appropriate prefixes to avoid naming conflicts.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Naming Conventions","language":"Other","updated":"2025-07-16","comments":6,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-follow-naming-conventions.md"},{"slug":"mono-environment-variable-patterns","title":"Environment variable patterns","description":"Use consistent patterns for environment variable handling and configuration validation. Access environment variables directly where they're needed rather than loading them unnecessarily in build configurations. Provide clear fallback mechanisms and fail fast with descriptive error messages when required configuration is missing or invalid.","repository":"rocicorp/mono","domain":"data-systems","topic":"Configurations","language":"TypeScript","updated":"2025-07-16","comments":6,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-environment-variable-patterns.md"},{"slug":"roo-code-enforce-api-format-consistency","title":"Enforce API format consistency","description":"Maintain consistent data formats, parameter units, and interface patterns across API implementations. This includes: 1. Consistent type mappings and format handling","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2025-07-16","comments":6,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-enforce-api-format-consistency.md"},{"slug":"roo-code-enforce-resource-usage-limits","title":"Enforce resource usage limits","description":"Implement explicit resource limits and monitoring to prevent performance degradation and memory issues. This includes: 1. Define maximum sizes for buffers and caches","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Performance Optimization","language":"TypeScript","updated":"2025-07-16","comments":6,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-enforce-resource-usage-limits.md"},{"slug":"rust-clear-helpful-error-messages","title":"Clear helpful error messages","description":"Create user-friendly error messages that guide developers toward solutions. Error messages should: 1. Include the problematic value in the message 2. Provide clear suggestions for fixing the issue","repository":"rust-lang/rust","domain":"runtimes","topic":"Error Handling","language":"Rust","updated":"2025-07-16","comments":6,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-clear-helpful-error-messages.md"},{"slug":"continue-validate-before-data-access","title":"Validate before data access","description":"Always validate data existence and type before accessing properties or methods to prevent runtime errors from null/undefined values. This includes: 1. Array bounds checking before indexing","repository":"continuedev/continue","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2025-07-16","comments":5,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-validate-before-data-access.md"},{"slug":"llama.cpp-measure-before-optimizing","title":"measure before optimizing","description":"Always profile and measure performance impact before implementing optimizations, especially micro-optimizations. Many seemingly beneficial optimizations provide no measurable improvement and can hurt code maintainability.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Performance Optimization","language":"C++","updated":"2025-07-16","comments":5,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-measure-before-optimizing.md"},{"slug":"continue-prevent-async-deadlocks","title":"Prevent async deadlocks","description":"Avoid circular dependencies in asynchronous code paths that can lead to deadlocks or indefinite blocking. When using async/await, ensure that promise chains have clear resolution paths and aren't dependent on their own completion. Be particularly careful with initialization patterns and refresh mechanisms.","repository":"continuedev/continue","domain":"ai-agents","topic":"Concurrency","language":"TypeScript","updated":"2025-07-16","comments":4,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-prevent-async-deadlocks.md"},{"slug":"continue-working-configuration-examples","title":"Working configuration examples","description":"Configuration examples should be complete, accurate, and ready to use without modification. This applies to both code snippets and configuration file examples.","repository":"continuedev/continue","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2025-07-16","comments":4,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-working-configuration-examples.md"},{"slug":"n8n-consistent-identifier-naming","title":"Consistent identifier naming","description":"Follow consistent naming conventions for all identifiers to improve code quality, accessibility, and test reliability. Ensure correct spelling and adhere to established project patterns.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Naming Conventions","language":"Other","updated":"2025-07-16","comments":4,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-consistent-identifier-naming.md"},{"slug":"terminal-reuse-defined-resources-consistently","title":"Reuse defined resources consistently","description":"Always reuse existing defined constants, resources, and reusable components instead of duplicating values or creating redundant implementations. This improves maintainability, ensures consistency across the codebase, and reduces the risk of introducing inconsistencies when values need to be updated.","repository":"microsoft/terminal","domain":"devtools","topic":"Code Style","language":"Other","updated":"2025-07-16","comments":4,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-reuse-defined-resources-consistently.md"},{"slug":"continue-memoize-expensive-calculations","title":"Memoize expensive calculations","description":"Cache computation results in React components to prevent unnecessary recalculations during re-renders, which can significantly impact application performance. Apply these optimization techniques in three key areas:","repository":"continuedev/continue","domain":"ai-agents","topic":"Performance Optimization","language":"TSX","updated":"2025-07-16","comments":3,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-memoize-expensive-calculations.md"},{"slug":"continue-tests-must-assert","title":"Tests must assert","description":"Test methods should contain active, uncommented code that includes at least one assertion to verify expected behavior. Commented-out test code provides zero value and creates a false sense of security by appearing to test functionality while actually testing nothing.","repository":"continuedev/continue","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2025-07-16","comments":3,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-tests-must-assert.md"},{"slug":"mono-enforce-database-constraints-properly","title":"enforce database constraints properly","description":"Database schemas should use appropriate constraints to enforce business rules and prevent data inconsistencies. When designing tables, identify potential duplicate data scenarios and implement unique constraints to prevent them. Consider consolidating related tables when a single table with proper constraints can achieve the same goal more efficiently.","repository":"rocicorp/mono","domain":"data-systems","topic":"Database","language":"Sql","updated":"2025-07-16","comments":3,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-enforce-database-constraints-properly.md"},{"slug":"roo-code-centralize-configuration-constants","title":"Centralize configuration constants","description":"Always centralize configuration constants in a shared location and import them rather than duplicating values across the codebase. This prevents drift between frontend and backend configurations, reduces errors from manual updates, and makes configuration changes easier to manage.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Configurations","language":"TSX","updated":"2025-07-16","comments":3,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-centralize-configuration-constants.md"},{"slug":"temporal-minimize-code-nesting-depth","title":"Minimize code nesting depth","description":"Reduce cognitive load and improve code readability by minimizing nested code blocks. Prefer early returns and flattened logic over deeply nested conditions. This makes the code easier to read, understand, and maintain.","repository":"temporalio/temporal","domain":"orchestration","topic":"Code Style","language":"Go","updated":"2025-07-16","comments":3,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-minimize-code-nesting-depth.md"},{"slug":"kafka-avoid-overly-specific-examples","title":"avoid overly specific examples","description":"When documenting configuration options, use generic examples that don't unnecessarily tie documentation to specific versions, environments, or exact default values. This keeps documentation maintainable and prevents examples from becoming outdated or environment-specific.","repository":"apache/kafka","domain":"data-systems","topic":"Configurations","language":"Markdown","updated":"2025-07-16","comments":2,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-avoid-overly-specific-examples.md"},{"slug":"kafka-centralize-configuration-values","title":"Centralize configuration values","description":"Avoid duplicating configuration values across multiple files by maintaining a single source of truth for environment variables, build arguments, version specifications, and other configuration parameters. When the same value appears in build scripts, Dockerfiles, documentation, or configuration files, consolidate it to one authoritative location and...","repository":"apache/kafka","domain":"data-systems","topic":"Configurations","language":"Dockerfile","updated":"2025-07-16","comments":2,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-centralize-configuration-values.md"},{"slug":"llama.cpp-use-strongly-typed-configurations","title":"Use strongly typed configurations","description":"Prefer strongly typed configuration values over primitive types to improve code safety and clarity. Use enum classes instead of raw strings for categorical options, and proper boolean types instead of integer flags for binary settings.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Configurations","language":"C++","updated":"2025-07-16","comments":2,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-use-strongly-typed-configurations.md"},{"slug":"spark-eliminate-unnecessary-complexity","title":"Eliminate unnecessary complexity","description":"Remove unnecessary default parameters and consolidate related conditional logic to improve code clarity and maintainability. When parameters are always provided in practice, avoid adding default values that create false optionality. Similarly, combine related conditions into single, more readable expressions.","repository":"apache/spark","domain":"data-systems","topic":"Code Style","language":"Python","updated":"2025-07-16","comments":2,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-eliminate-unnecessary-complexity.md"},{"slug":"supabase-use-appropriate-http-methods","title":"Use appropriate HTTP methods","description":"Choose HTTP methods that align with the actual operation being performed. Use GET for retrieving data with query parameters, and POST for operations that modify state or require complex request bodies.","repository":"supabase/supabase","domain":"data-systems","topic":"API","language":"TypeScript","updated":"2025-07-16","comments":2,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-use-appropriate-http-methods.md"},{"slug":"svelte-realistic-documentation-examples","title":"realistic documentation examples","description":"Use practical, complete examples in documentation rather than oversimplified or contrived ones that cut corners. Documentation examples should reflect real-world usage patterns and include necessary context, edge cases, and limitations.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-07-15","comments":15,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-realistic-documentation-examples.md"},{"slug":"lmcache-ensure-operation-completion-safety","title":"Ensure operation completion safety","description":"In concurrent code, ensure that operations complete safely before proceeding to prevent race conditions and data corruption. This applies to several scenarios:","repository":"LMCache/LMCache","domain":"llm-infra","topic":"Concurrency","language":"Python","updated":"2025-07-15","comments":7,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-ensure-operation-completion-safety.md"},{"slug":"bazel-avoid-unnecessary-computations","title":"Avoid unnecessary computations","description":"Before performing expensive operations, check if the work is actually needed or if more efficient alternatives exist. This includes validating preconditions, using optimized system calls, and avoiding duplicate method invocations.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Performance Optimization","language":"Java","updated":"2025-07-15","comments":6,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-avoid-unnecessary-computations.md"},{"slug":"litellm-use-proper-logging-mechanisms","title":"Use proper logging mechanisms","description":"Always use the logging library instead of print statements and maintain consistent logging patterns throughout the codebase. Print statements should be avoided as they bypass proper log level controls, formatting, and routing. Instead, use appropriate logging methods like `verbose_logger.info()`, `verbose_logger.debug()`, or `verbose_logger.warning()`.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Logging","language":"Python","updated":"2025-07-15","comments":6,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-use-proper-logging-mechanisms.md"},{"slug":"mono-explicit-null-handling","title":"explicit null handling","description":"Use explicit null and undefined checks with assertions to validate assumptions and maintain type safety. Prefer `!= null` for checking both null and undefined, and use assertions to validate non-null expectations rather than relying on implicit checks.","repository":"rocicorp/mono","domain":"data-systems","topic":"Null Handling","language":"TypeScript","updated":"2025-07-15","comments":6,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-explicit-null-handling.md"},{"slug":"supabase-prevent-hardcoded-secrets","title":"Prevent hardcoded secrets","description":"Never store sensitive information such as API keys, passwords, tokens, or credentials directly in your source code. These hardcoded secrets are easily exposed through version control systems, code sharing, or security breaches, creating significant security vulnerabilities.","repository":"supabase/supabase","domain":"data-systems","topic":"Security","language":"TypeScript","updated":"2025-07-15","comments":6,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-prevent-hardcoded-secrets.md"},{"slug":"svelte-document-configuration-hierarchies","title":"document configuration hierarchies","description":"When documenting configuration options, clearly explain all available configuration levels and their precedence order. Many configuration options can be set globally, per-component, or dynamically, and users need to understand these different approaches.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Configurations","language":"Markdown","updated":"2025-07-15","comments":6,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-document-configuration-hierarchies.md"},{"slug":"react-router-maintain-naming-consistency","title":"maintain naming consistency","description":"Ensure consistent naming conventions across the entire codebase, including terminology, file names, directory structures, and API naming. Inconsistent naming creates confusion and poor developer experience.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Naming Conventions","language":"Markdown","updated":"2025-07-15","comments":5,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-maintain-naming-consistency.md"},{"slug":"argo-cd-optimize-algorithmic-complexity","title":"optimize algorithmic complexity","description":"Always consider computational complexity and performance when implementing algorithms. Look for opportunities to optimize through early exits, efficient comparison strategies, and avoiding nested loops that create O(N*M) complexity.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Algorithms","language":"Go","updated":"2025-07-15","comments":4,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-optimize-algorithmic-complexity.md"},{"slug":"n8n-explicit-environment-configuration-handling","title":"Explicit environment configuration handling","description":"Environment and configuration values should be explicit, visible, and environment-aware. Avoid hardcoded production values, hidden configuration properties, and complex environment variable logic. Instead:","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-07-15","comments":4,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-explicit-environment-configuration-handling.md"},{"slug":"rust-extract-complex-logic-helpers","title":"Extract complex logic helpers","description":"Complex or duplicated logic should be extracted into well-named helper functions to improve code readability and maintainability. This applies to: 1. Large blocks of code in functions that handle a specific subtask","repository":"rust-lang/rust","domain":"runtimes","topic":"Code Style","language":"Rust","updated":"2025-07-15","comments":4,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-extract-complex-logic-helpers.md"},{"slug":"argo-cd-comprehensive-function-documentation","title":"Comprehensive function documentation","description":"Functions should have thorough documentation that follows Go conventions and explains both the \"what\" and \"why\" of the code. This includes: 1. **Proper Go doc format**: Start function comments with the function name, e.g., \"GetSecretByName returns the Secret...\" instead of \"Returns the Secret...\"","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Documentation","language":"Go","updated":"2025-07-15","comments":3,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-comprehensive-function-documentation.md"},{"slug":"n8n-pin-actions-securely","title":"Pin actions securely","description":"Always pin GitHub Actions to specific commit hashes rather than version tags to prevent supply chain attacks and ensure build reproducibility. This practice ensures that your workflow remains stable and secure even if the action's version tag is compromised or modified.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"CI/CD","language":"Yaml","updated":"2025-07-15","comments":3,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-pin-actions-securely.md"},{"slug":"react-router-documentation-linking-standards","title":"documentation linking standards","description":"Ensure proper linking and cross-referencing in documentation to improve navigation and discoverability. Use correct JSDoc syntax for type references and consistently link to related concepts where they are mentioned.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-07-15","comments":3,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-documentation-linking-standards.md"},{"slug":"roo-code-validate-model-capabilities-first","title":"Validate model capabilities first","description":"Always validate AI model capabilities and configurations before attempting to use them. This includes checking: 1. Feature support (e.g., images, embeddings)","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"AI","language":"TypeScript","updated":"2025-07-15","comments":3,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-validate-model-capabilities-first.md"},{"slug":"spark-minimize-public-api-surface","title":"minimize public API surface","description":"Only expose APIs that are truly necessary for external consumers and avoid creating public interfaces that may become maintenance burdens. Before adding public builders, helper utilities, or exposing internal types, critically evaluate whether they provide genuine value to API users.","repository":"apache/spark","domain":"data-systems","topic":"API","language":"Java","updated":"2025-07-15","comments":3,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-minimize-public-api-surface.md"},{"slug":"supabase-abstract-user-facing-errors","title":"Abstract user-facing errors","description":"Error messages displayed to end users should abstract away implementation details while providing actionable information. Avoid exposing internal system components (like \"containerd\", \"K8S\") or raw error messages that might confuse users or reveal security-sensitive information. Instead, map technical errors to user-friendly messages that explain what...","repository":"supabase/supabase","domain":"data-systems","topic":"Error Handling","language":"TSX","updated":"2025-07-15","comments":3,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-abstract-user-facing-errors.md"},{"slug":"supabase-use-configuration-over-hardcoding","title":"Use configuration over hardcoding","description":"Always use configuration constants instead of hardcoding values directly in the code. This improves maintainability and reduces errors when values need to change across different environments or contexts.","repository":"supabase/supabase","domain":"data-systems","topic":"Configurations","language":"TSX","updated":"2025-07-15","comments":3,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-use-configuration-over-hardcoding.md"},{"slug":"temporal-operation-order-affects-correctness","title":"Operation order affects correctness","description":"When implementing algorithms that involve multiple operations (like iteration, validation, and execution), the order of operations can critically affect correctness. Always validate operation ordering to ensure no unintended side effects or lost data.","repository":"temporalio/temporal","domain":"orchestration","topic":"Algorithms","language":"Go","updated":"2025-07-15","comments":3,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-operation-order-affects-correctness.md"},{"slug":"agentcore-samples-avoid-hardcoded-environments","title":"Avoid Hardcoded Environments","description":"Do not commit configuration that is (a) unnecessary/stale or (b) hardcoded to specific environments (e.g., `gamma`, `beta`, `no-prod`, or other prod variants). Keep repo configuration environment-agnostic by parameterizing values and deriving environment-specific behavior at runtime/deployment.","repository":"awslabs/agentcore-samples","domain":"ai-agents","topic":"Configurations","language":"Json","updated":"2025-07-15","comments":2,"stars":3244,"raw":"https://awesomereviewers.com/raw/agentcore-samples-avoid-hardcoded-environments.md"},{"slug":"core-review-configuration-constants-regularly","title":"Review configuration constants regularly","description":"Configuration constants and mappings require regular maintenance to stay aligned with evolving platform capabilities. Outdated configurations can introduce unnecessary complexity, while incomplete mappings can cause functionality loss.","repository":"home-assistant/core","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2025-07-15","comments":2,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-review-configuration-constants-regularly.md"},{"slug":"firecrawl-minimize-database-roundtrips","title":"Minimize database roundtrips","description":"Avoid making multiple database queries when a single query can retrieve the required data. Each database roundtrip adds latency and increases system load. Before making a database call, check if the data is already available or if multiple queries can be combined into one.","repository":"firecrawl/firecrawl","domain":"ai-agents","topic":"Database","language":"TypeScript","updated":"2025-07-15","comments":2,"stars":54535,"raw":"https://awesomereviewers.com/raw/firecrawl-minimize-database-roundtrips.md"},{"slug":"nest-document-cicd-changes","title":"Document CI/CD changes","description":"Always document changes to CI/CD configurations and scripts, and ensure pull requests remain focused on their intended purpose. When modifying build scripts, dependencies, or deployment processes:","repository":"nestjs/nest","domain":"app-frameworks","topic":"CI/CD","language":"Json","updated":"2025-07-15","comments":2,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-document-cicd-changes.md"},{"slug":"spark-consistent-null-handling","title":"consistent null handling","description":"Maintain consistency in null handling patterns across the codebase. When multiple approaches exist for representing absent or disabled values, choose one approach and apply it uniformly throughout the project.","repository":"apache/spark","domain":"data-systems","topic":"Null Handling","language":"Java","updated":"2025-07-15","comments":2,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-consistent-null-handling.md"},{"slug":"union-environment-specific-configuration-values","title":"Environment-specific configuration values","description":"Avoid hardcoding configuration values that should vary between different deployment environments (testnet, mainnet, development). Instead, use environment variables, configuration files, or conditional logic to handle environment-specific settings.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Configurations","language":"Go","updated":"2025-07-15","comments":2,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-environment-specific-configuration-values.md"},{"slug":"n8n-restrict-database-access","title":"Restrict database access","description":"Never allow unrestricted public access (0.0.0.0/0) to database instances. Restrict database network access to only specific trusted IP ranges or VPC networks that require it, following the principle of least privilege. This prevents potential unauthorized access and data breaches.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Security","language":"Terraform","updated":"2025-07-15","comments":1,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-restrict-database-access.md"},{"slug":"v-avoid-expensive-repeated-operations","title":"avoid expensive repeated operations","description":"Cache results of expensive computations and order operations from cheapest to most expensive to minimize performance overhead. This includes storing function call results in local variables, extracting constants to avoid repeated allocations, using appropriate buffer sizes, and placing fast conditional checks before slower ones.","repository":"vlang/v","domain":"runtimes","topic":"Performance Optimization","language":"Other","updated":"2025-07-14","comments":13,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-avoid-expensive-repeated-operations.md"},{"slug":"langflow-organize-documentation-content","title":"Organize documentation content","description":"Structure documentation to prevent information overload and improve readability by using appropriate organizational elements and callouts judiciously.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Documentation","language":"Markdown","updated":"2025-07-14","comments":11,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-organize-documentation-content.md"},{"slug":"novu-complete-openapi-annotations","title":"Complete OpenAPI annotations","description":"Ensure all API endpoints have complete and accurate OpenAPI annotations to support proper SDK generation and documentation. Use appropriate decorators, include all necessary metadata, and verify that generated SDKs work correctly.","repository":"novuhq/novu","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2025-07-14","comments":8,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-complete-openapi-annotations.md"},{"slug":"terminal-cache-expensive-computations","title":"Cache expensive computations","description":"Identify and cache the results of expensive operations that are computed repeatedly with the same inputs. This includes function calls, data structure creation, regex compilation, and complex calculations that don't change between invocations.","repository":"microsoft/terminal","domain":"devtools","topic":"Performance Optimization","language":"C++","updated":"2025-07-14","comments":8,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-cache-expensive-computations.md"},{"slug":"workers-sdk-use-descriptive-names","title":"Use descriptive names","description":"Choose names that clearly describe their purpose, behavior, and data type rather than generic or ambiguous alternatives. Function names should reflect what they actually do, variables should indicate their specific role, and parameter names should convey semantic meaning.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-14","comments":8,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-use-descriptive-names.md"},{"slug":"kafka-synchronization-safety-patterns","title":"Synchronization safety patterns","description":"Ensure proper synchronization mechanisms to prevent deadlocks and race conditions in concurrent code. When designing thread-safe components, carefully consider lock ordering, avoid nested synchronization blocks that could cause deadlocks, and make mutable shared state thread-safe.","repository":"apache/kafka","domain":"data-systems","topic":"Concurrency","language":"Java","updated":"2025-07-14","comments":6,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-synchronization-safety-patterns.md"},{"slug":"llama.cpp-explicit-control-flow-logic","title":"explicit control flow logic","description":"Use explicit control flow structures like switch statements instead of complex boolean logic or implicit reasoning when handling algorithmic decisions. This improves code clarity, maintainability, and reduces the likelihood of logical errors in computational paths.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Algorithms","language":"C++","updated":"2025-07-14","comments":6,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-explicit-control-flow-logic.md"},{"slug":"terminal-use-established-configuration-patterns","title":"Use established configuration patterns","description":"When adding new configuration options or settings, leverage existing configuration frameworks and patterns rather than implementing custom solutions. This ensures consistency, reduces boilerplate code, and maintains alignment with established practices.","repository":"microsoft/terminal","domain":"devtools","topic":"Configurations","language":"Other","updated":"2025-07-14","comments":6,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-use-established-configuration-patterns.md"},{"slug":"llama.cpp-ai-parameter-organization","title":"AI parameter organization","description":"Ensure proper organization and placement of AI model parameters, hyperparameters, and configuration options. Avoid parameter duplication by reusing existing values, and place parameters in their logically appropriate structures.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"AI","language":"Other","updated":"2025-07-14","comments":5,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-ai-parameter-organization.md"},{"slug":"terminal-prefer-const-declarations","title":"prefer const declarations","description":"Use `const` for variables that are not modified after initialization, and avoid creating unnecessary temporary variables when the value can be computed directly in the declaration.","repository":"microsoft/terminal","domain":"devtools","topic":"Code Style","language":"C++","updated":"2025-07-14","comments":5,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-prefer-const-declarations.md"},{"slug":"ant-design-update-deprecated-demo-apis","title":"Update deprecated demo APIs","description":"Documentation, demos, and example code should always use current, non-deprecated APIs instead of showing deprecation warnings. When APIs are deprecated, update all demo code and examples to use the recommended replacement APIs immediately.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"API","language":"Other","updated":"2025-07-14","comments":4,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-update-deprecated-demo-apis.md"},{"slug":"bun-consistent-descriptive-identifiers","title":"Consistent descriptive identifiers","description":"Use camelCase for all variables, parameters, methods, and functions in JavaScript/TypeScript code to maintain consistency with language conventions. Choose names that accurately describe the purpose and behavior of identifiers, and avoid naming collisions between different scopes.","repository":"oven-sh/bun","domain":"runtimes","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-14","comments":4,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-consistent-descriptive-identifiers.md"},{"slug":"dify-validate-access-controls","title":"Validate access controls","description":"Always implement comprehensive validation for access control mechanisms to prevent unauthorized access and privilege escalation. This includes validating user permissions, enforcing tenant isolation, and preventing bypass through direct API calls.","repository":"langgenius/dify","domain":"llm-infra","topic":"Security","language":"Python","updated":"2025-07-14","comments":4,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-validate-access-controls.md"},{"slug":"langflow-ai-response-variability","title":"AI response variability","description":"When documenting AI model interactions, account for the non-deterministic nature of AI responses and avoid assumptions about specific outputs. AI models can produce different responses to identical inputs, and model behavior changes over time through updates and improvements.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"AI","language":"Markdown","updated":"2025-07-14","comments":4,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-ai-response-variability.md"},{"slug":"llama.cpp-maintain-code-consistency","title":"maintain code consistency","description":"Always follow the existing code style patterns and conventions found in the surrounding codebase rather than introducing new formatting approaches. This includes matching brace placement, function organization, and parameter formatting styles.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Code Style","language":"Other","updated":"2025-07-14","comments":4,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-maintain-code-consistency.md"},{"slug":"llama.cpp-validate-bounds-before-access","title":"validate bounds before access","description":"Always validate array indices, buffer sizes, and container bounds before accessing elements to prevent out-of-bounds errors and undefined behavior. This includes checking that indices are within valid ranges and that containers have sufficient size before element access.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Null Handling","language":"C++","updated":"2025-07-14","comments":4,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-validate-bounds-before-access.md"},{"slug":"node-follow-naming-conventions","title":"Follow naming conventions","description":"Maintain consistent naming conventions across the codebase: - Use PascalCase for class methods (e.g., `All()`, `Get()`, `Run()` instead of `all()`, `get()`, `run()`)","repository":"nodejs/node","domain":"runtimes","topic":"Naming Conventions","language":"Other","updated":"2025-07-14","comments":4,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-follow-naming-conventions.md"},{"slug":"node-limit-environment-variable-scope","title":"Limit environment variable scope","description":"When working with environment variables for configuration: 1. **Reuse existing environment variables** rather than creating new ones. Leverage established variables like `NODE_TEST_CONTEXT` where possible to avoid fragmentation.","repository":"nodejs/node","domain":"runtimes","topic":"Configurations","language":"JavaScript","updated":"2025-07-14","comments":4,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-limit-environment-variable-scope.md"},{"slug":"terminal-api-parameter-explicitness","title":"API parameter explicitness","description":"Always use correct and explicit parameters when calling APIs, rather than relying on defaults or passing incorrect values. This includes passing appropriate objects to API methods, specifying all required parameters explicitly, and using correct operation patterns.","repository":"microsoft/terminal","domain":"devtools","topic":"API","language":"C++","updated":"2025-07-14","comments":4,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-api-parameter-explicitness.md"},{"slug":"llama.cpp-measure-algorithm-performance-impact","title":"measure algorithm performance impact","description":"Choose algorithms based on measurable performance benefits rather than theoretical complexity advantages. Start with simpler implementations and only adopt complex algorithms when they demonstrate clear performance improvements over basic approaches.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Algorithms","language":"Other","updated":"2025-07-14","comments":3,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-measure-algorithm-performance-impact.md"},{"slug":"playwright-optimize-react-rerenders","title":"optimize React rerenders","description":"Ensure React components avoid unnecessary rerenders by maintaining object identity in dependencies and eliminating unused state variables. When objects are recreated on every render, they cause effects and child components to re-execute unnecessarily, leading to performance issues.","repository":"microsoft/playwright","domain":"devtools","topic":"React","language":"TSX","updated":"2025-07-14","comments":3,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-optimize-react-rerenders.md"},{"slug":"svelte-preserve-user-input-focus","title":"preserve user input focus","description":"When implementing reactive state updates that affect input elements, always check if the user is currently interacting with the element before applying the update. This prevents jarring user experiences where typing gets interrupted by state changes.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"React","language":"JavaScript","updated":"2025-07-14","comments":3,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-preserve-user-input-focus.md"},{"slug":"vscode-avoid-css-important","title":"Avoid CSS !important","description":"Using `!important` in CSS declarations should be avoided as it makes styles difficult to override and maintain. Instead, use more specific selectors to achieve the desired styling hierarchy. This improves code maintainability and follows CSS best practices.","repository":"microsoft/vscode","domain":"devtools","topic":"Code Style","language":"Css","updated":"2025-07-14","comments":3,"stars":174887,"raw":"https://awesomereviewers.com/raw/vscode-avoid-css-important.md"},{"slug":"workerd-prefer-nullish-coalescing-operators","title":"prefer nullish coalescing operators","description":"Use nullish coalescing operators (`??`) and logical OR with safe defaults (`|| {}`) to handle null and undefined values more safely and concisely. This prevents runtime errors when accessing properties on potentially null/undefined objects and provides cleaner, more readable code.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Null Handling","language":"TypeScript","updated":"2025-07-14","comments":3,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-prefer-nullish-coalescing-operators.md"},{"slug":"argo-cd-prefer-modern-react-patterns","title":"prefer modern React patterns","description":"Favor modern React patterns over legacy approaches to improve code maintainability and prepare for future React upgrades. Use functional components with hooks instead of class components, and prefer `React.useContext` over the `<Context.Consumer>` render prop pattern to reduce JSX nesting and improve readability.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"React","language":"TSX","updated":"2025-07-14","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-prefer-modern-react-patterns.md"},{"slug":"gemini-cli-minimize-performance-overhead","title":"minimize performance overhead","description":"Reduce unnecessary overhead in performance-related code by creating reusable patterns and avoiding verbose implementations. This applies to both production performance monitoring and development workflows like testing.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Performance Optimization","language":"TSX","updated":"2025-07-14","comments":2,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-minimize-performance-overhead.md"},{"slug":"traefik-complete-network-configurations","title":"Complete network configurations","description":"Network configuration examples and documentation should include all essential networking components such as ports, protocols, timeouts, and security considerations. Incomplete configurations can lead to connection failures, security vulnerabilities, or unexpected behavior.","repository":"traefik/traefik","domain":"cloud-infra","topic":"Networking","language":"Markdown","updated":"2025-07-13","comments":17,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-complete-network-configurations.md"},{"slug":"tree-sitter-optimize-frequent-operations","title":"Optimize frequent operations","description":"Identify code paths that execute frequently (loops, hot functions, repeated calls) and optimize them by avoiding redundant computations, expensive operations, and unnecessary allocations.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Performance Optimization","language":"Rust","updated":"2025-07-13","comments":6,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-optimize-frequent-operations.md"},{"slug":"codex-write-comprehensive-test-assertions","title":"Write comprehensive test assertions","description":"Instead of making multiple small assertions that check individual fields or conditions, write single comprehensive assertions that verify the complete expected state. This approach makes tests more maintainable, provides better documentation of expected behavior, and makes test failures more informative.","repository":"openai/codex","domain":"ai-agents","topic":"Testing","language":"Rust","updated":"2025-07-13","comments":5,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-write-comprehensive-test-assertions.md"},{"slug":"comfyui-prefer-dynamic-configuration-sources","title":"prefer dynamic configuration sources","description":"Use runtime-determined configuration sources instead of hardcoded values or static file parsing when more reliable alternatives are available. This improves robustness, cross-platform compatibility, and deployment flexibility.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Configurations","language":"Python","updated":"2025-07-13","comments":5,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-prefer-dynamic-configuration-sources.md"},{"slug":"neovim-provide-helpful-documentation-context","title":"Provide helpful documentation context","description":"Documentation should include sufficient context, practical examples, and helpful hints to make it truly useful for developers. Avoid assuming users have background knowledge - explain concepts, provide examples, and mention related functionality.","repository":"neovim/neovim","domain":"devtools","topic":"Documentation","language":"Txt","updated":"2025-07-13","comments":5,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-provide-helpful-documentation-context.md"},{"slug":"nuxt-follow-vue-api-patterns","title":"Follow Vue API patterns","description":"Always prefer Vue's native APIs and follow official Vue patterns instead of creating custom implementations. This ensures better compatibility, maintainability, and consistency with the Vue ecosystem.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Vue","language":"TypeScript","updated":"2025-07-13","comments":5,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-follow-vue-api-patterns.md"},{"slug":"prometheus-explicit-test-assertions","title":"explicit test assertions","description":"Tests should explicitly assert both positive and negative expectations to make test intentions clear and prevent regressions. Use the `expect` syntax to specify not only what should happen, but also what should NOT happen in your tests.","repository":"prometheus/prometheus","domain":"observability","topic":"Testing","language":"Other","updated":"2025-07-13","comments":5,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-explicit-test-assertions.md"},{"slug":"llama.cpp-prioritize-compile-time-optimizations","title":"prioritize compile-time optimizations","description":"In performance-critical code, favor compile-time optimizations over runtime flexibility to enable better compiler optimizations and reduce execution overhead. This principle applies to several key areas:","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Performance Optimization","language":"Other","updated":"2025-07-13","comments":4,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-prioritize-compile-time-optimizations.md"},{"slug":"neovim-conditional-expensive-operations","title":"Conditional expensive operations","description":"Only execute expensive operations when they are actually necessary. Avoid paying performance costs for functionality that may not be used or when conditions don't require the expensive computation.","repository":"neovim/neovim","domain":"devtools","topic":"Performance Optimization","language":"Other","updated":"2025-07-13","comments":4,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-conditional-expensive-operations.md"},{"slug":"neovim-configuration-variable-organization","title":"Configuration variable organization","description":"Use structured naming patterns and avoid polluting the global namespace when managing configuration variables. Prefer storing configuration state on relevant objects rather than creating numerous top-level global variables.","repository":"neovim/neovim","domain":"devtools","topic":"Configurations","language":"Other","updated":"2025-07-13","comments":4,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-configuration-variable-organization.md"},{"slug":"neovim-use-descriptive-names","title":"Use descriptive names","description":"Avoid ambiguous or vague identifiers in favor of specific, self-documenting names that clearly convey purpose and context. Names should be immediately understandable without requiring additional context or documentation. Generic terms like \"float\" should be replaced with specific terms like \"floatwin\" or \"win_float\" to eliminate ambiguity. Function names...","repository":"neovim/neovim","domain":"devtools","topic":"Naming Conventions","language":"C","updated":"2025-07-13","comments":4,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-use-descriptive-names.md"},{"slug":"roo-code-configuration-consistency-check","title":"Configuration consistency check","description":"Ensure that configuration files and settings are consistent with their intended functionality and maintain portability across different environments.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Configurations","language":"Other","updated":"2025-07-13","comments":4,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-configuration-consistency-check.md"},{"slug":"bun-technical-documentation-accuracy","title":"Technical documentation accuracy","description":"Documentation must precisely reflect the current state of the codebase to prevent confusion and ensure developers can rely on it. Ensure that: 1. References to packages, tools, or features that have been removed or renamed are updated or deleted from documentation","repository":"oven-sh/bun","domain":"runtimes","topic":"Documentation","language":"Markdown","updated":"2025-07-13","comments":3,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-technical-documentation-accuracy.md"},{"slug":"desktop-lazy-initialization-patterns","title":"Lazy initialization patterns","description":"Avoid repeatedly performing expensive operations like adding event handlers, loading resources, or fetching preferences. Instead, initialize these resources once when first needed and reuse them thereafter. This prevents memory leaks, reduces unnecessary work, and improves performance.","repository":"zen-browser/desktop","domain":"devtools","topic":"Performance Optimization","language":"Other","updated":"2025-07-13","comments":3,"stars":34711,"raw":"https://awesomereviewers.com/raw/desktop-lazy-initialization-patterns.md"},{"slug":"helix-optimize-query-performance","title":"Optimize query performance","description":"When writing tree-sitter queries, prioritize performance by choosing efficient predicates and avoiding computationally expensive operations. Use `#any-of?` instead of complex `#match?` patterns when checking against multiple literal values, as it reduces regex compilation overhead. Avoid predicates like `#has-ancestor?` which have poor performance...","repository":"helix-editor/helix","domain":"devtools","topic":"Algorithms","language":"Other","updated":"2025-07-13","comments":3,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-optimize-query-performance.md"},{"slug":"node-resource-aware-programming-patterns","title":"Resource-aware programming patterns","description":"When optimizing application performance, be mindful of system resource constraints and use appropriate patterns to handle different scenarios efficiently:","repository":"nodejs/node","domain":"runtimes","topic":"Performance Optimization","language":"Markdown","updated":"2025-07-13","comments":3,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-resource-aware-programming-patterns.md"},{"slug":"alacritty-centralize-workspace-dependencies","title":"centralize workspace dependencies","description":"Define shared dependencies at the workspace level in the root Cargo.toml to ensure version consistency and prevent conflicts across the project. This approach centralizes dependency management and makes it easier to maintain uniform versions throughout the codebase.","repository":"alacritty/alacritty","domain":"devtools","topic":"Configurations","language":"Toml","updated":"2025-07-13","comments":2,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-centralize-workspace-dependencies.md"},{"slug":"kafka-condition-based-network-synchronization","title":"condition-based network synchronization","description":"When waiting for network state propagation or distributed system synchronization, avoid using fixed sleep times and instead implement condition-based waiting that verifies the actual desired state. Fixed delays are unreliable in network environments due to variable latency and don't guarantee the expected state has been reached.","repository":"apache/kafka","domain":"data-systems","topic":"Networking","language":"Other","updated":"2025-07-13","comments":2,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-condition-based-network-synchronization.md"},{"slug":"neovim-document-connection-scope","title":"Document connection scope","description":"When documenting network connection operations, clearly specify the scope of when operations are supported and their limitations. Include information about initial connection requirements, fallback behaviors, and unsupported scenarios to help users understand operational boundaries.","repository":"neovim/neovim","domain":"devtools","topic":"Networking","language":"Txt","updated":"2025-07-13","comments":2,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-document-connection-scope.md"},{"slug":"node-descriptive-behavior-based-tests","title":"Descriptive behavior-based tests","description":"Tests should be named to describe the expected behavior or outcome being verified, not the input parameters or implementation details. This makes tests more meaningful as documentation and easier to understand when they fail.","repository":"nodejs/node","domain":"runtimes","topic":"Testing","language":"Other","updated":"2025-07-13","comments":2,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-descriptive-behavior-based-tests.md"},{"slug":"comfyui-extract-repeated-logic","title":"Extract repeated logic","description":"When you notice code patterns being repeated across functions or methods, extract the common logic into separate, reusable functions. This improves maintainability, reduces bugs, and follows the DRY (Don't Repeat Yourself) principle.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Code Style","language":"Python","updated":"2025-07-12","comments":9,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-extract-repeated-logic.md"},{"slug":"ncnn-platform-targeted-flags","title":"Platform-Targeted Flags","description":"When enabling/disabling CPU features or platform-specific APIs, derive decisions from the *configured target/platform* (toolchain/CMake target selection) and apply consistent compile-time guards across code and tests. Do not rely on compiler-defined feature macros that may differ between build/test environments.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Configurations","language":"Other","updated":"2025-07-12","comments":8,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-platform-targeted-flags.md"},{"slug":"bazel-optimize-algorithm-choices","title":"optimize algorithm choices","description":"Choose algorithms and data structures that provide both deterministic behavior and optimal performance characteristics. Prefer ordered collections when iteration order matters, optimize pattern matching to avoid expensive operations, and be mindful of algorithmic complexity.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Algorithms","language":"Java","updated":"2025-07-12","comments":7,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-optimize-algorithm-choices.md"},{"slug":"continue-semantically-consistent-naming","title":"Semantically consistent naming","description":"Names should accurately reflect their purpose and be used consistently throughout the codebase. This applies to props, function names, variables, and UI labels.","repository":"continuedev/continue","domain":"ai-agents","topic":"Naming Conventions","language":"TSX","updated":"2025-07-12","comments":6,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-semantically-consistent-naming.md"},{"slug":"ncnn-conditional-cmake-configuration","title":"Conditional CMake Configuration","description":"When changing build configuration (compiler definitions, link libraries, compile/link flags), ensure it is applied only when the correct *feature option* is enabled and the *selected target/toolchain* actually requires it. Avoid unconditional/global flags that can break other platforms or remove the ability to disable features.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Configurations","language":"Txt","updated":"2025-07-12","comments":6,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-conditional-cmake-configuration.md"},{"slug":"ncnn-avoid-performance-pessimization","title":"Avoid Performance Pessimization","description":"When optimizing for CPU/GPU speed, don’t accidentally remove fast paths via build/toolchain settings, and don’t add expensive memory-access patterns in the hottest kernels.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Performance Optimization","language":"Other","updated":"2025-07-12","comments":5,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-avoid-performance-pessimization.md"},{"slug":"ncnn-platform-correct-ci-pipelines","title":"Platform-correct CI Pipelines","description":"Ensure CI/CD workflows build, test, and package artifacts in a way that is correct for each target platform/architecture—without running irrelevant jobs.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"CI/CD","language":"Yaml","updated":"2025-07-12","comments":5,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-platform-correct-ci-pipelines.md"},{"slug":"continue-prevent-broken-interactions","title":"Prevent broken interactions","description":"Ensure UI elements'' visual state (e.g., disabled, active) always matches their actual behavior. When an element appears disabled, completely prevent the associated actions by:","repository":"continuedev/continue","domain":"ai-agents","topic":"Error Handling","language":"TSX","updated":"2025-07-12","comments":4,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-prevent-broken-interactions.md"},{"slug":"llama.cpp-api-minimalism-principle","title":"API minimalism principle","description":"Keep APIs minimal by avoiding redundant interfaces and preferring simple solutions over complex ones. When adding functionality, first consider extending existing functions rather than creating new ones, especially when there's only a single use case. Remove unnecessary options and flags to maintain interface simplicity.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"API","language":"C++","updated":"2025-07-12","comments":4,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-api-minimalism-principle.md"},{"slug":"cline-prevent-unnecessary-operations","title":"prevent unnecessary operations","description":"Identify and eliminate redundant computations, network requests, and re-renders in React components to improve performance. Common patterns include memoizing functions that recreate on every render, debouncing user input to reduce API calls, and conditionally triggering side effects only when necessary.","repository":"cline/cline","domain":"ai-agents","topic":"Performance Optimization","language":"TSX","updated":"2025-07-12","comments":3,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-prevent-unnecessary-operations.md"},{"slug":"helix-semantic-identifier-naming-patterns","title":"Semantic identifier naming patterns","description":"Use consistent naming patterns that reflect the semantic role of identifiers: 1. Constants should use UPPER_SNAKE_CASE: ``` const MAX_RETRY_COUNT = 3;","repository":"helix-editor/helix","domain":"devtools","topic":"Naming Conventions","language":"Other","updated":"2025-07-12","comments":3,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-semantic-identifier-naming-patterns.md"},{"slug":"kafka-use-condition-based-waiting","title":"Use condition-based waiting","description":"Replace fixed-time delays with condition-based waiting mechanisms to ensure reliable synchronization and avoid timing-dependent race conditions. Fixed delays like `Thread.sleep()` are unreliable because they don't guarantee the expected state change has occurred, leading to flaky tests and potential production issues.","repository":"apache/kafka","domain":"data-systems","topic":"Concurrency","language":"Other","updated":"2025-07-12","comments":3,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-use-condition-based-waiting.md"},{"slug":"ncnn-eliminate-shared-mutable-state","title":"Eliminate Shared Mutable State","description":"Ensure concurrent execution is race-free by (a) not storing per-inference mutable state in shared layer objects, (b) keeping OpenMP loop temporaries thread-local, and (c) using the correct synchronization primitive for the target platform.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Concurrency","language":"Other","updated":"2025-07-12","comments":3,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-eliminate-shared-mutable-state.md"},{"slug":"ncnn-optional-null-safety-checks","title":"Optional Null Safety Checks","description":"When code depends on possibly-missing inputs/outputs or optional attributes, do not index or read them unconditionally. Add explicit guards for presence and fall back to a safe default/overload.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Null Handling","language":"C++","updated":"2025-07-12","comments":3,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-optional-null-safety-checks.md"},{"slug":"roo-code-sanitize-untrusted-content","title":"Sanitize untrusted content","description":"Always sanitize user-generated or externally sourced content before rendering it to prevent Cross-Site Scripting (XSS) vulnerabilities. Never use `dangerouslySetInnerHTML` with unsanitized content.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Security","language":"TSX","updated":"2025-07-12","comments":3,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-sanitize-untrusted-content.md"},{"slug":"bun-validate-loop-boundary-conditions","title":"Validate loop boundary conditions","description":"When implementing iterative algorithms, ensure comprehensive handling of edge cases and boundary conditions. This includes: 1. Using while loops instead of if-else chains for repetitive operations","repository":"oven-sh/bun","domain":"runtimes","topic":"Algorithms","language":"Other","updated":"2025-07-12","comments":2,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-validate-loop-boundary-conditions.md"},{"slug":"continue-logging-levels-hierarchy","title":"Logging levels hierarchy","description":"Use appropriate logging levels to prevent debug noise from leaking into production environments. Reserve console.log() for important application events, and use console.debug() for development information that should not be visible to end users.","repository":"continuedev/continue","domain":"ai-agents","topic":"Logging","language":"TSX","updated":"2025-07-12","comments":2,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-logging-levels-hierarchy.md"},{"slug":"openpilot-consistent-terminology-choices","title":"Consistent terminology choices","description":"When introducing new terminology or naming conventions, ensure consistency with existing patterns in the codebase while prioritizing clarity and universal understanding. Before adding new names, identifiers, or terminology, review existing usage patterns and adopt the established conventions. When multiple options exist, choose the most widely understood...","repository":"commaai/openpilot","domain":"ml-systems","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-12","comments":2,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-consistent-terminology-choices.md"},{"slug":"continue-accessible-security-controls","title":"Accessible security controls","description":"Security controls and interactive elements must be accessible to all users to prevent unequal security access. When non-standard elements (like divs) are used for interaction, they must include proper accessibility attributes to ensure users with disabilities can access security features.","repository":"continuedev/continue","domain":"ai-agents","topic":"Security","language":"TSX","updated":"2025-07-12","comments":1,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-accessible-security-controls.md"},{"slug":"react-router-documentation-clarity-standards","title":"documentation clarity standards","description":"Ensure all React-related documentation, comments, and descriptions maintain high standards of clarity, accuracy, and consistency. This includes using proper grammar, consistent terminology, complete descriptions, and well-structured explanations.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"React","language":"Markdown","updated":"2025-07-11","comments":30,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-documentation-clarity-standards.md"},{"slug":"alacritty-use-descriptive-contextual-names","title":"Use descriptive contextual names","description":"Choose variable, function, and struct names that clearly communicate their purpose and content while considering their surrounding context. Avoid generic names like `x`, `normal`, or `data` that provide no semantic meaning. When naming within a specific scope or module, avoid redundant prefixes that repeat the context.","repository":"alacritty/alacritty","domain":"devtools","topic":"Naming Conventions","language":"Rust","updated":"2025-07-11","comments":13,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-use-descriptive-contextual-names.md"},{"slug":"alacritty-optimize-algorithmic-efficiency","title":"optimize algorithmic efficiency","description":"Eliminate unnecessary operations and choose appropriate data structures to improve algorithmic efficiency. Look for opportunities to remove redundant computations, avoid unnecessary allocations, and leverage built-in methods instead of manual implementations.","repository":"alacritty/alacritty","domain":"devtools","topic":"Algorithms","language":"Rust","updated":"2025-07-11","comments":10,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-optimize-algorithmic-efficiency.md"},{"slug":"node-evolve-return-values","title":"Evolve return values","description":"When extending APIs with new capabilities, carefully consider how changes to return values affect consumers. Avoid creating polymorphic return types based on input options as this reduces predictability and makes it difficult to programmatically detect supported features.","repository":"nodejs/node","domain":"runtimes","topic":"API","language":"Markdown","updated":"2025-07-11","comments":8,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-evolve-return-values.md"},{"slug":"node-informative-error-messages","title":"Informative error messages","description":"Error messages should be specific, actionable, and include context that helps developers understand and fix the issue. Use standard error codes that can be tested and suppressed rather than relying only on text messages. Create errors at the point of detection rather than inside callbacks to preserve useful stack traces.","repository":"nodejs/node","domain":"runtimes","topic":"Error Handling","language":"JavaScript","updated":"2025-07-11","comments":8,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-informative-error-messages.md"},{"slug":"novu-explicit-null-safety","title":"explicit null safety","description":"Always perform explicit null and undefined checks before processing values, and use the nullish coalescing operator (??) for safe default value assignment. Distinguish between null (explicit no value) and undefined (use default) semantics in your API design.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Null Handling","language":"TypeScript","updated":"2025-07-11","comments":8,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-explicit-null-safety.md"},{"slug":"node-version-apis-with-care","title":"Version APIs with care","description":"When introducing new API features or changes, implement proper versioning to maintain stability and backward compatibility. Key practices: 1. Guard experimental features behind version flags","repository":"nodejs/node","domain":"runtimes","topic":"API","language":"Other","updated":"2025-07-11","comments":7,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-version-apis-with-care.md"},{"slug":"tree-sitter-prefer-compile-time-configuration","title":"prefer compile-time configuration","description":"Use compile-time configuration checks with `cfg!` macros instead of runtime environment variable parsing when the configuration decision can be determined at build time. This improves performance by eliminating runtime checks and makes the code's behavior more predictable.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Configurations","language":"Rust","updated":"2025-07-11","comments":7,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-prefer-compile-time-configuration.md"},{"slug":"ant-design-jsdoc-deprecation-formatting","title":"JSDoc deprecation formatting","description":"Ensure consistent formatting in JSDoc deprecation comments to improve API documentation clarity and developer experience. Use backticks around parameter/property names to distinguish them from regular text, use angle brackets for component names, and include \"instead\" for replacement suggestions.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"API","language":"TSX","updated":"2025-07-11","comments":6,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-jsdoc-deprecation-formatting.md"},{"slug":"vscode-handle-errors-with-specificity","title":"Handle errors with specificity","description":"Always handle errors specifically and explicitly, avoiding generic catch blocks that mask or ignore errors. Ensure proper resource cleanup and consistent error propagation. Key practices:","repository":"microsoft/vscode","domain":"devtools","topic":"Error Handling","language":"TypeScript","updated":"2025-07-11","comments":6,"stars":174887,"raw":"https://awesomereviewers.com/raw/vscode-handle-errors-with-specificity.md"},{"slug":"node-follow-consistent-naming-patterns","title":"Follow consistent naming patterns","description":"Maintain consistent naming conventions throughout the codebase to improve readability and reduce confusion. Adhere to these guidelines: 1. **Function naming patterns**: Use established prefixes like `create` for factory functions, which accurately conveys their purpose and aligns with existing patterns.","repository":"nodejs/node","domain":"runtimes","topic":"Naming Conventions","language":"Markdown","updated":"2025-07-11","comments":5,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-follow-consistent-naming-patterns.md"},{"slug":"bun-use-consistent-test-patterns","title":"Use consistent test patterns","description":"Standardize testing by leveraging established patterns and helper functions throughout your test suite. Extract repetitive test setup into lifecycle hooks like `beforeEach` or shared fixtures. Use existing test helpers rather than duplicating logic, and organize tests logically by functionality.","repository":"oven-sh/bun","domain":"runtimes","topic":"Testing","language":"TypeScript","updated":"2025-07-11","comments":4,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-use-consistent-test-patterns.md"},{"slug":"mastodon-hook-responsibility-separation","title":"Hook responsibility separation","description":"Keep hooks and components focused on single, well-defined responsibilities to maintain clean architecture and avoid mixing concerns. When designing hooks, ensure they have a clear, singular purpose. Avoid combining unrelated functionality like DOM manipulation with event handling, or complex business logic with simple state management. If a hook or...","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"React","language":"TSX","updated":"2025-07-11","comments":4,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-hook-responsibility-separation.md"},{"slug":"n8n-actions-configuration-best-practices","title":"Actions configuration best practices","description":"When working with GitHub Actions workflows, follow these configuration best practices: 1. **Boolean inputs comparison**: GitHub Actions boolean inputs are actually strings. Always use string comparison with quotes:","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Configurations","language":"Yaml","updated":"2025-07-11","comments":4,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-actions-configuration-best-practices.md"},{"slug":"neovim-semantic-naming-over-implementation","title":"Semantic naming over implementation","description":"Choose names that reflect the semantic purpose and meaning rather than implementation details or internal mechanisms. Names should communicate what something does or represents from the user's perspective, not how it works internally.","repository":"neovim/neovim","domain":"devtools","topic":"Naming Conventions","language":"Txt","updated":"2025-07-11","comments":4,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-semantic-naming-over-implementation.md"},{"slug":"argo-cd-api-documentation-clarity","title":"API documentation clarity","description":"Ensure API parameter documentation clearly specifies default values, valid options, error conditions, and precise requirements to prevent user confusion and integration failures. Ambiguous documentation leads to misunderstandings about expected behavior and can cause integration problems.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"API","language":"Markdown","updated":"2025-07-11","comments":3,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-api-documentation-clarity.md"},{"slug":"continue-document-configurations-completely","title":"Document configurations completely","description":"Ensure configuration documentation is comprehensive, clear and actionable for developers. This includes: 1. **Document all possible configuration options and behaviors**, not just defaults:","repository":"continuedev/continue","domain":"ai-agents","topic":"Configurations","language":"Other","updated":"2025-07-11","comments":3,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-document-configurations-completely.md"},{"slug":"kafka-maintain-naming-consistency","title":"maintain naming consistency","description":"Ensure consistent naming conventions and parameter ordering throughout the codebase. This includes maintaining consistent parameter order within classes, using established import aliases consistently, and ensuring method names accurately reflect their expected parameters and behavior.","repository":"apache/kafka","domain":"data-systems","topic":"Naming Conventions","language":"Other","updated":"2025-07-11","comments":3,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-maintain-naming-consistency.md"},{"slug":"kafka-sequence-data-state-updates","title":"sequence data state updates","description":"When working with distributed data systems, ensure that state updates are performed in the correct conceptual order to maintain data consistency and avoid race conditions. Operations that logically depend on each other should be sequenced appropriately, and components should maintain clear ownership of their data state.","repository":"apache/kafka","domain":"data-systems","topic":"Database","language":"Other","updated":"2025-07-11","comments":3,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-sequence-data-state-updates.md"},{"slug":"llama.cpp-maintain-consistent-naming-patterns","title":"Maintain consistent naming patterns","description":"Follow established naming conventions in the codebase and align with original source patterns while using modern, non-deprecated alternatives. Avoid creating confusing duplication in naming structures.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Naming Conventions","language":"Python","updated":"2025-07-11","comments":3,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-maintain-consistent-naming-patterns.md"},{"slug":"llvm-project-target-aware-configuration-handling","title":"Target-aware configuration handling","description":"When implementing features that depend on specific compilation targets or modes, design configuration mechanisms that gracefully handle target availability differences. Provide clear detection methods for feature availability on the current target, and ensure attributes and builtins work consistently across different compilation contexts.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Configurations","language":"Other","updated":"2025-07-11","comments":3,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-target-aware-configuration-handling.md"},{"slug":"node-use-modern-nullish-operators","title":"Use modern nullish operators","description":"When dealing with potentially null or undefined values, use optional chaining (`?.`) and nullish coalescing (`??`) operators instead of verbose conditionals. These operators make code more readable, concise, and prevent null reference errors.","repository":"nodejs/node","domain":"runtimes","topic":"Null Handling","language":"JavaScript","updated":"2025-07-11","comments":3,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-use-modern-nullish-operators.md"},{"slug":"bun-initialize-default-values","title":"Initialize default values","description":"Always initialize class attributes with default values to prevent AttributeError exceptions when accessing potentially undefined values. Use defensive coding patterns:","repository":"oven-sh/bun","domain":"runtimes","topic":"Null Handling","language":"Python","updated":"2025-07-11","comments":2,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-initialize-default-values.md"},{"slug":"duckdb-maintain-api-backwards-compatibility","title":"maintain API backwards compatibility","description":"Never modify existing stable API versions in ways that could break backwards compatibility. When adding new functionality, always introduce it in unstable API versions first before stabilizing in new releases. For serialization formats, avoid renaming existing fields - instead use property mapping or add new fields alongside deprecated ones.","repository":"duckdb/duckdb","domain":"data-systems","topic":"API","language":"Json","updated":"2025-07-11","comments":2,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-maintain-api-backwards-compatibility.md"},{"slug":"electron-protocol-specific-network-handling","title":"Protocol-specific network handling","description":"When implementing custom network protocol behavior, ensure that modifications are properly scoped to only the intended protocol types and include upstream context documentation. Avoid applying protocol-specific changes broadly across all network protocols, as this can break assumptions and cause unintended side effects.","repository":"electron/electron","domain":"devtools","topic":"Networking","language":"Other","updated":"2025-07-11","comments":2,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-protocol-specific-network-handling.md"},{"slug":"goose-keep-dependencies-current","title":"Keep dependencies current","description":"Always use the latest stable versions of dependencies in configuration files like Cargo.toml, and avoid deprecated or unmaintained packages. Outdated dependencies can introduce security vulnerabilities, compatibility issues, and technical debt.","repository":"block/goose","domain":"ai-agents","topic":"Configurations","language":"Toml","updated":"2025-07-11","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-keep-dependencies-current.md"},{"slug":"llama.cpp-specify-naming-formats-explicitly","title":"Specify naming formats explicitly","description":"When defining naming conventions in documentation, specifications, or APIs, explicitly specify the exact format and patterns to be used. Avoid ambiguous descriptions that could lead to inconsistent implementations.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Naming Conventions","language":"Markdown","updated":"2025-07-11","comments":2,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-specify-naming-formats-explicitly.md"},{"slug":"react-native-maintain-cross-platform-api-consistency","title":"maintain cross-platform API consistency","description":"When designing APIs that work across multiple platforms, ensure consistent return types and behavior to avoid breaking changes and maintain a unified developer experience. Use Platform.select() to handle platform-specific implementations rather than hardcoded conditional logic.","repository":"facebook/react-native","domain":"app-frameworks","topic":"API","language":"JavaScript","updated":"2025-07-11","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-maintain-cross-platform-api-consistency.md"},{"slug":"rust-synchronize-configuration-files","title":"Synchronize configuration files","description":"Ensure all related configuration files are updated consistently when making changes to dependencies, versions, or other configuration settings. When updating a dependency version in one file (e.g., package.json), ensure that all related files (e.g., lockfiles, version specifications) are also updated to maintain consistency. This prevents subtle integration...","repository":"rust-lang/rust","domain":"runtimes","topic":"Configurations","language":"Json","updated":"2025-07-11","comments":2,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-synchronize-configuration-files.md"},{"slug":"traefik-health-check-lifecycle-completeness","title":"Health check lifecycle completeness","description":"Ensure health check systems are not only created but also properly launched and integrated with observability infrastructure. Health checkers must follow the complete lifecycle: creation, launch, and metrics integration.","repository":"traefik/traefik","domain":"cloud-infra","topic":"Observability","language":"Go","updated":"2025-07-11","comments":2,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-health-check-lifecycle-completeness.md"},{"slug":"traefik-provide-contextual-error-information","title":"provide contextual error information","description":"Ensure error messages and logging provide sufficient context to understand what failed and why. Include relevant details such as server addresses, operation types, configuration values, or other identifying information that helps with debugging and troubleshooting.","repository":"traefik/traefik","domain":"cloud-infra","topic":"Error Handling","language":"Go","updated":"2025-07-11","comments":2,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-provide-contextual-error-information.md"},{"slug":"gemini-cli-secure-authentication-flows","title":"secure authentication flows","description":"Authentication flows should be designed to provide a seamless user experience while maintaining security standards. Avoid implementing temporary workarounds that require users to perform multiple steps, quit and restart applications, or follow complex sequences to authenticate successfully.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Security","language":"TSX","updated":"2025-07-11","comments":1,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-secure-authentication-flows.md"},{"slug":"istio-add-explanatory-comments","title":"Add explanatory comments","description":"Code should include explanatory comments that help future maintainers understand complex logic, design decisions, field semantics, and non-obvious implementation details. Comments are especially important for:","repository":"istio/istio","domain":"orchestration","topic":"Documentation","language":"Go","updated":"2025-07-10","comments":9,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-add-explanatory-comments.md"},{"slug":"router-use-descriptive-conflict-free-names","title":"Use descriptive, conflict-free names","description":"Choose descriptive names that clearly convey purpose while avoiding conflicts with existing APIs, built-in functions, or established conventions. Names should follow consistent patterns across the codebase and use appropriate spelling conventions.","repository":"TanStack/router","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-10","comments":8,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-use-descriptive-conflict-free-names.md"},{"slug":"roo-code-consistent-localization-formatting","title":"Consistent localization formatting","description":"Ensure all localization strings maintain consistent formatting patterns within each locale file. This includes: 1. **Terminal punctuation**: All similar messages should consistently end with appropriate punctuation marks for the locale (periods in English/French, \"।\" in Hindi, etc.).","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Code Style","language":"Json","updated":"2025-07-10","comments":7,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-consistent-localization-formatting.md"},{"slug":"roo-code-preserve-error-context-chain","title":"Preserve error context chain","description":"When catching and re-throwing errors, always preserve the original error context using the `cause` option of the Error constructor. This maintains the complete error chain for debugging and ensures no critical information is lost when translating errors between layers.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2025-07-10","comments":7,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-preserve-error-context-chain.md"},{"slug":"argo-cd-prefer-early-returns","title":"Prefer early returns","description":"Use early returns and guard clauses to reduce nesting levels and improve code readability. Instead of deeply nested if-else structures, invert conditions and return early when possible. This pattern makes the main logic flow more apparent and reduces cognitive load.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Code Style","language":"Go","updated":"2025-07-10","comments":6,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-prefer-early-returns.md"},{"slug":"sentry-feature-flag-rollouts","title":"Feature flag rollouts","description":"Use feature flags to gate new functionality for controlled rollouts. This allows for quick enabling/disabling without code reverts when issues arise, and supports gradual adoption through percentage-based rollouts.","repository":"getsentry/sentry","domain":"observability","topic":"Configurations","language":"Python","updated":"2025-07-10","comments":6,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-feature-flag-rollouts.md"},{"slug":"sentry-use-descriptive-identifiers","title":"Use descriptive identifiers","description":"Choose variable, parameter, field, and class names that clearly communicate their purpose and context. Favor specific, self-explanatory identifiers over generic or ambiguous ones, and ensure they follow Python's snake_case convention.","repository":"getsentry/sentry","domain":"observability","topic":"Naming Conventions","language":"Python","updated":"2025-07-10","comments":6,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-use-descriptive-identifiers.md"},{"slug":"argo-cd-use-configuration-constants","title":"Use configuration constants","description":"Replace hardcoded values with named constants from common packages or make values configurable through environment variables or flags. This improves maintainability, reduces magic numbers, and enables runtime configuration.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Configurations","language":"Go","updated":"2025-07-10","comments":5,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-use-configuration-constants.md"},{"slug":"node-thread-safe-resource-management-patterns","title":"Thread-safe resource management patterns","description":"Ensure thread-safe access to shared resources while following proper resource management patterns. When implementing concurrent operations: 1. Prefer worker threads over process spawning for parallel tasks","repository":"nodejs/node","domain":"runtimes","topic":"Concurrency","language":"Other","updated":"2025-07-10","comments":5,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-thread-safe-resource-management-patterns.md"},{"slug":"sentry-defensive-null-checking","title":"Defensive null checking","description":"Implement defensive null checking to prevent NoneType errors, KeyError, and IndexError exceptions. When accessing dictionaries, collections, or optional values, verify existence before use.","repository":"getsentry/sentry","domain":"observability","topic":"Null Handling","language":"Python","updated":"2025-07-10","comments":5,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-defensive-null-checking.md"},{"slug":"discourse-api-parameter-handling","title":"API parameter handling","description":"Ensure consistent and safe handling of parameters and data across API endpoints. This includes using proper serialization methods, consistent parameter passing approaches, and context-aware processing when the same input may have different meanings.","repository":"discourse/discourse","domain":"app-frameworks","topic":"API","language":"JavaScript","updated":"2025-07-10","comments":4,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-api-parameter-handling.md"},{"slug":"n8n-descriptive-parameter-names","title":"Descriptive parameter names","description":"Use specific, descriptive parameter names for API resources rather than generic identifiers. Parameter names should clearly indicate the resource type they refer to by using namespaced identifiers (e.g., `userId` instead of `id`). This improves API readability, reduces ambiguity in code, and prevents confusion when multiple resource types are used in the...","repository":"n8n-io/n8n","domain":"ai-agents","topic":"API","language":"Yaml","updated":"2025-07-10","comments":4,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-descriptive-parameter-names.md"},{"slug":"prometheus-special-value-handling","title":"special value handling","description":"Algorithms must explicitly define and consistently handle special values like NaN, infinity, and edge cases across all mathematical operations. Special values can significantly impact computational results and should not be treated as afterthoughts.","repository":"prometheus/prometheus","domain":"observability","topic":"Algorithms","language":"Markdown","updated":"2025-07-10","comments":4,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-special-value-handling.md"},{"slug":"rust-contextual-error-messages","title":"Contextual error messages","description":"Error messages should provide specific context about the error and guide users toward solutions. When reporting syntax errors like mismatched delimiters, include both the location of the error and references to related code elements to help users quickly identify the problem.","repository":"rust-lang/rust","domain":"runtimes","topic":"Error Handling","language":"Other","updated":"2025-07-10","comments":4,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-contextual-error-messages.md"},{"slug":"spark-resource-cleanup-responsibility","title":"Resource cleanup responsibility","description":"Ensure proper resource management by clearly defining cleanup responsibilities and implementing robust cleanup patterns. Resources should be closed by their creator, and cleanup must occur even when exceptions happen during resource creation or usage.","repository":"apache/spark","domain":"data-systems","topic":"Error Handling","language":"Other","updated":"2025-07-10","comments":4,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-resource-cleanup-responsibility.md"},{"slug":"supabase-handle-external-operations-safely","title":"Handle external operations safely","description":"Always implement explicit error handling for external operations such as network requests, database queries, and API calls. When errors occur, either:","repository":"supabase/supabase","domain":"data-systems","topic":"Error Handling","language":"TypeScript","updated":"2025-07-10","comments":4,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-handle-external-operations-safely.md"},{"slug":"temporal-safe-lock-usage-patterns","title":"Safe lock usage patterns","description":"Follow these critical patterns when using locks to prevent deadlocks, resource leaks, and performance issues: 1. Use consistent lock naming: ```go // Prefer","repository":"temporalio/temporal","domain":"orchestration","topic":"Concurrency","language":"Go","updated":"2025-07-10","comments":4,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-safe-lock-usage-patterns.md"},{"slug":"vscode-validate-before-expensive-operations","title":"Validate before expensive operations","description":"Perform lightweight validation checks before executing expensive operations to avoid unnecessary resource consumption. This is especially important in hot paths or frequently called functions.","repository":"microsoft/vscode","domain":"devtools","topic":"Performance Optimization","language":"TypeScript","updated":"2025-07-10","comments":4,"stars":174887,"raw":"https://awesomereviewers.com/raw/vscode-validate-before-expensive-operations.md"},{"slug":"bun-never-swallow-errors","title":"Never swallow errors","description":"Always ensure errors are properly surfaced rather than silently ignored. Silent error handling can lead to confusing behavior where features fail without any indication of what went wrong, making debugging difficult or impossible.","repository":"oven-sh/bun","domain":"runtimes","topic":"Error Handling","language":"TypeScript","updated":"2025-07-10","comments":3,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-never-swallow-errors.md"},{"slug":"bun-respect-existing-configurations","title":"Respect existing configurations","description":"When integrating with external services or tools, design your configuration options to respect users' existing environment settings rather than overriding them with hardcoded defaults. This ensures your tool works seamlessly within various environments and avoids disrupting users' workflows.","repository":"oven-sh/bun","domain":"runtimes","topic":"Configurations","language":"TypeScript","updated":"2025-07-10","comments":3,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-respect-existing-configurations.md"},{"slug":"bun-verify-assertions-properly","title":"Verify assertions properly","description":"Ensure test assertions correctly validate the intended behavior by: 1. **Awaiting promise assertions** when testing async code: ```javascript // PROBLEMATIC: Test may pass even if promise never resolves","repository":"oven-sh/bun","domain":"runtimes","topic":"Testing","language":"JavaScript","updated":"2025-07-10","comments":3,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-verify-assertions-properly.md"},{"slug":"cline-prevent-async-race-conditions","title":"Prevent async race conditions","description":"Identify and prevent race conditions in asynchronous operations, especially when operations depend on each other's completion state. Race conditions occur when the timing or order of async operations affects program correctness, often leading to intermittent failures that are difficult to debug.","repository":"cline/cline","domain":"ai-agents","topic":"Concurrency","language":"TypeScript","updated":"2025-07-10","comments":3,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-prevent-async-race-conditions.md"},{"slug":"continue-complete-dependency-arrays","title":"Complete dependency arrays","description":"Always include all referenced variables in React hook dependency arrays (useEffect, useCallback, useMemo). Missing or incorrect dependencies can lead to stale closures, unexpected behavior, and difficult-to-diagnose bugs.","repository":"continuedev/continue","domain":"ai-agents","topic":"React","language":"TSX","updated":"2025-07-10","comments":3,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-complete-dependency-arrays.md"},{"slug":"litellm-prefer-lightweight-observability-integrations","title":"Prefer lightweight observability integrations","description":"Observability integrations should minimize external dependencies and avoid patching LiteLLM's core functions. Instead of requiring users to install additional SDKs, prefer lightweight approaches using custom loggers with direct HTTP calls (like httpx) or implement CustomBatchLogger interfaces. Avoid monkey-patching completion functions as this can cause...","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Observability","language":"Markdown","updated":"2025-07-10","comments":3,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-prefer-lightweight-observability-integrations.md"},{"slug":"neovim-prevent-autocommand-reentrancy","title":"prevent autocommand reentrancy","description":"Guard against reentrancy issues when operations may trigger autocommands or async events that could invalidate state or cause recursive execution. Check for existing execution context before proceeding and validate that pointers/state remain valid after operations that may trigger autocommands.","repository":"neovim/neovim","domain":"devtools","topic":"Concurrency","language":"C","updated":"2025-07-10","comments":3,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-prevent-autocommand-reentrancy.md"},{"slug":"sentry-simplify-feature-flag-logic","title":"Simplify feature flag logic","description":"When working with feature flags and configuration conditions, keep your logic clean and up-to-date: 1. **Simplify conditionals when flag states change**: When a feature flag becomes permanently enabled or disabled, update and simplify all conditionals that reference it.","repository":"getsentry/sentry","domain":"observability","topic":"Configurations","language":"TSX","updated":"2025-07-10","comments":3,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-simplify-feature-flag-logic.md"},{"slug":"supabase-prevent-re-render-triggers","title":"Prevent re-render triggers","description":"Avoid creating new object/array references in component render functions and carefully manage state updates to prevent unnecessary re-renders. This improves performance by reducing computational overhead and DOM manipulations.","repository":"supabase/supabase","domain":"data-systems","topic":"Performance Optimization","language":"TSX","updated":"2025-07-10","comments":3,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-prevent-re-render-triggers.md"},{"slug":"bun-path-comparison-precision","title":"Path comparison precision","description":"When implementing file path matching or exclusion algorithms, use precise comparison techniques that respect directory boundaries rather than simple string operations. Naïve prefix matching using `startsWith()` can lead to unexpected behavior by accidentally matching unrelated paths that share prefixes.","repository":"oven-sh/bun","domain":"runtimes","topic":"Algorithms","language":"TypeScript","updated":"2025-07-10","comments":2,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-path-comparison-precision.md"},{"slug":"bun-validate-workflow-files","title":"Validate workflow files","description":"Ensure all CI/CD workflow configuration files are validated for accuracy and consistency. Small errors in workflow files can prevent automation from triggering correctly or cause unexpected behavior. Pay special attention to:","repository":"oven-sh/bun","domain":"runtimes","topic":"CI/CD","language":"Yaml","updated":"2025-07-10","comments":2,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-validate-workflow-files.md"},{"slug":"continue-avoid-duplicated-code","title":"Avoid duplicated code","description":"Identify and extract shared functionality between classes into reusable components. Code duplication increases maintenance burden and risk of inconsistent behavior when changes are needed.","repository":"continuedev/continue","domain":"ai-agents","topic":"Code Style","language":"Kotlin","updated":"2025-07-10","comments":2,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-avoid-duplicated-code.md"},{"slug":"deno-prefer-efficient-built-ins","title":"prefer efficient built-ins","description":"When multiple built-in methods can accomplish the same algorithmic task, prefer the single comprehensive method over combining multiple operations. This reduces computational overhead, simplifies code logic, and often provides better performance characteristics.","repository":"denoland/deno","domain":"runtimes","topic":"Algorithms","language":"TypeScript","updated":"2025-07-10","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-prefer-efficient-built-ins.md"},{"slug":"kafka-document-precise-security-requirements","title":"Document precise security requirements","description":"Security documentation must specify exact permission requirements with clear scope and timing details. Vague or outdated security requirements can lead to insufficient ACL configurations, creating security gaps or deployment failures.","repository":"apache/kafka","domain":"data-systems","topic":"Security","language":"Html","updated":"2025-07-10","comments":2,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-document-precise-security-requirements.md"},{"slug":"llama.cpp-implement-or-fail-explicitly","title":"implement or fail explicitly","description":"Algorithmic functions should either correctly implement their intended behavior or explicitly fail with an error, rather than silently returning potentially incorrect or unchanged results. This prevents subtle bugs where callers assume the algorithm was applied when it wasn't.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Algorithms","language":"Python","updated":"2025-07-10","comments":2,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-implement-or-fail-explicitly.md"},{"slug":"prometheus-consistent-parameter-naming","title":"consistent parameter naming","description":"Maintain consistent naming and symbol choices throughout code and documentation, prioritizing readability and avoiding ambiguity. When choosing between equivalent representations (like φ vs phi), select the more widely understood option and use it consistently across all related contexts.","repository":"prometheus/prometheus","domain":"observability","topic":"Naming Conventions","language":"Markdown","updated":"2025-07-10","comments":2,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-consistent-parameter-naming.md"},{"slug":"langflow-configuration-documentation-clarity","title":"Configuration documentation clarity","description":"Ensure configuration documentation clearly distinguishes between deployment contexts and uses consistent terminology throughout. When documenting configuration procedures, explicitly specify the target deployment type (Langflow Desktop vs OSS) and platform (macOS vs Windows) to avoid user confusion.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2025-07-09","comments":17,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-configuration-documentation-clarity.md"},{"slug":"mono-type-safe-database-operations","title":"type-safe database operations","description":"Implement proper type conversion and validation when working with different database systems to prevent runtime errors and data corruption. This is critical when handling data types that behave differently across database engines.","repository":"rocicorp/mono","domain":"data-systems","topic":"Database","language":"TypeScript","updated":"2025-07-09","comments":10,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-type-safe-database-operations.md"},{"slug":"langfuse-sync-documentation-with-code","title":"Sync documentation with code","description":"Always ensure documentation and comments accurately reflect the actual code implementation. When modifying code, update all related documentation to maintain consistency. This applies to:","repository":"langfuse/langfuse","domain":"observability","topic":"Documentation","language":"TypeScript","updated":"2025-07-09","comments":9,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-sync-documentation-with-code.md"},{"slug":"langfuse-extract-repeated-code","title":"Extract repeated code","description":"Follow the DRY (Don't Repeat Yourself) principle by extracting repeated code patterns into helper functions, constants, or shared utilities. Code duplication leads to maintainability issues, inconsistencies, and bugs when one instance is updated but others are overlooked.","repository":"langfuse/langfuse","domain":"observability","topic":"Code Style","language":"TypeScript","updated":"2025-07-09","comments":8,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-extract-repeated-code.md"},{"slug":"poetry-clear-actionable-error-messages","title":"Clear actionable error messages","description":"Error messages should be user-friendly, readable, and provide actionable guidance for resolution. Avoid exposing technical implementation details like raw dictionaries, regex patterns, or internal data structures to end users. Instead, format errors clearly and include specific steps users can take to resolve the issue.","repository":"python-poetry/poetry","domain":"devtools","topic":"Error Handling","language":"Python","updated":"2025-07-09","comments":6,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-clear-actionable-error-messages.md"},{"slug":"sentry-structure-logs-with-context","title":"Structure logs with context","description":"Use structured logging with appropriate context and log levels to maximize the value of log messages. Include relevant metadata with each log message to facilitate filtering and debugging:","repository":"getsentry/sentry","domain":"observability","topic":"Logging","language":"Python","updated":"2025-07-09","comments":6,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-structure-logs-with-context.md"},{"slug":"ghostty-use-if-unwrap-with-optionals","title":"Use if-unwrap with optionals","description":"Always use Zig's if-unwrap pattern (`if (optional) |value| {...}`) when working with optional values instead of forced unwrapping with `.?`. This pattern is safer as it avoids runtime panics, more readable, and aligns with Zig's idioms for null safety.","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Null Handling","language":"Other","updated":"2025-07-09","comments":5,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-use-if-unwrap-with-optionals.md"},{"slug":"langfuse-ensure-deterministic-query-results","title":"Ensure deterministic query results","description":"Always ensure database queries produce deterministic results by including explicit ORDER BY clauses when using LIMIT operations. This prevents unpredictable result ordering and potential data inconsistencies.","repository":"langfuse/langfuse","domain":"observability","topic":"Database","language":"TypeScript","updated":"2025-07-09","comments":5,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-ensure-deterministic-query-results.md"},{"slug":"langfuse-use-structured-logging-framework","title":"Use structured logging framework","description":"Replace all console.* calls with an appropriate structured logging framework using proper log levels. This ensures consistent logging patterns, better log management, and appropriate handling of different severity levels.","repository":"langfuse/langfuse","domain":"observability","topic":"Logging","language":"TypeScript","updated":"2025-07-09","comments":5,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-use-structured-logging-framework.md"},{"slug":"angular-configuration-opt-in-safety","title":"Configuration opt-in safety","description":"When introducing new configuration options or making changes that could be disruptive, make them opt-in by default rather than enabled automatically. This prevents breaking existing functionality and gives users control over when to adopt new behaviors.","repository":"angular/angular","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2025-07-09","comments":4,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-configuration-opt-in-safety.md"},{"slug":"comfyui-explicit-null-handling-strategies","title":"explicit null handling strategies","description":"Functions and APIs should employ explicit strategies for handling null/None values rather than leaving null handling ambiguous. Choose one of two approaches:","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Null Handling","language":"Python","updated":"2025-07-09","comments":4,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-explicit-null-handling-strategies.md"},{"slug":"comfyui-optimize-computational-efficiency","title":"optimize computational efficiency","description":"Implement memoization and guard clauses to eliminate redundant computations and improve algorithmic performance. Many algorithms can be significantly optimized by caching intermediate results and avoiding unnecessary work.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Algorithms","language":"Python","updated":"2025-07-09","comments":4,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-optimize-computational-efficiency.md"},{"slug":"kafka-optimize-collection-conversions","title":"Optimize collection conversions","description":"When converting between Java and Scala collections or performing set operations, choose methods that minimize temporary collection creation to improve performance and reduce memory overhead.","repository":"apache/kafka","domain":"data-systems","topic":"Algorithms","language":"Other","updated":"2025-07-09","comments":4,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-optimize-collection-conversions.md"},{"slug":"sentry-optimize-react-hook-patterns","title":"Optimize React hook patterns","description":"Design React hooks with performance and maintainability in mind by following these key principles: 1. Minimize useEffect usage - Update values directly when possible instead of using effects. Effects should only be used for true side effects, not for derived state updates.","repository":"getsentry/sentry","domain":"observability","topic":"React","language":"TSX","updated":"2025-07-09","comments":4,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-optimize-react-hook-patterns.md"},{"slug":"sentry-thread-management-best-practices","title":"Thread management best practices","description":"When working with threads or thread pools in concurrent code, follow these practices to improve reliability and debuggability: 1. **Always name your threads and thread pools** using the `thread_name_prefix` parameter. This makes debugging and monitoring much easier when issues arise.","repository":"getsentry/sentry","domain":"observability","topic":"Concurrency","language":"Python","updated":"2025-07-09","comments":4,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-thread-management-best-practices.md"},{"slug":"appwrite-resilient-configuration-patterns","title":"Resilient configuration patterns","description":"When modifying or defining configuration values, use patterns that are resistant to future changes and silent failures. For configuration files, scripts, and environment variables, implement approaches that remain valid when underlying values change.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Configurations","language":"Yaml","updated":"2025-07-09","comments":3,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-resilient-configuration-patterns.md"},{"slug":"istio-avoid-repeated-expensive-operations","title":"avoid repeated expensive operations","description":"Avoid performing expensive computational operations repeatedly when the same result can be achieved through better algorithm design or data structure choices. This includes avoiding sorting on each access, repeated string parsing, or complex comparisons that could be precomputed or cached.","repository":"istio/istio","domain":"orchestration","topic":"Algorithms","language":"Go","updated":"2025-07-09","comments":3,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-avoid-repeated-expensive-operations.md"},{"slug":"langfuse-semantically-correct-status","title":"Semantically correct status","description":"Use HTTP status codes that accurately reflect the outcome of API operations. This improves API clarity and allows client applications to handle responses more intelligently.","repository":"langfuse/langfuse","domain":"observability","topic":"API","language":"TypeScript","updated":"2025-07-09","comments":3,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-semantically-correct-status.md"},{"slug":"llama.cpp-validate-configuration-options-explicitly","title":"validate configuration options explicitly","description":"When handling configuration options or tool types, use explicit conditional statements with proper error handling for unknown values instead of implicit fallbacks or else clauses. This prevents silent failures and makes it clear which configurations are supported.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Configurations","language":"Python","updated":"2025-07-09","comments":3,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-validate-configuration-options-explicitly.md"},{"slug":"neon-handle-all-error-paths","title":"Handle all error paths","description":"Ensure comprehensive error handling throughout the codebase by implementing proper error handling blocks, defensive validation, and thorough resource cleanup.","repository":"neondatabase/neon","domain":"data-systems","topic":"Error Handling","language":"C","updated":"2025-07-09","comments":3,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-handle-all-error-paths.md"},{"slug":"router-use-descriptive-scoped-names","title":"Use descriptive scoped names","description":"Prefer descriptive, scoped names over generic or vague identifiers for types, functions, and properties. Names should clearly communicate their purpose and context within the codebase.","repository":"TanStack/router","domain":"app-frameworks","topic":"Naming Conventions","language":"TSX","updated":"2025-07-09","comments":3,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-use-descriptive-scoped-names.md"},{"slug":"sentry-api-parameter-design-flexibility","title":"API parameter design flexibility","description":"Design API parameters to be extensible and future-proof by using object arguments and explicit type definitions instead of boolean flags or simplistic checks. This approach makes APIs more maintainable and easier to evolve over time.","repository":"getsentry/sentry","domain":"observability","topic":"API","language":"TSX","updated":"2025-07-09","comments":3,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-api-parameter-design-flexibility.md"},{"slug":"angular-use-design-system-colors","title":"Use design system colors","description":"Always use design system color variables instead of hardcoded color values in stylesheets. This ensures consistent theming, automatic dark/light mode support, and maintainable code.","repository":"angular/angular","domain":"app-frameworks","topic":"Code Style","language":"Css","updated":"2025-07-09","comments":2,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-use-design-system-colors.md"},{"slug":"ant-design-pin-ci-dependencies-securely","title":"Pin CI dependencies securely","description":"Always pin CI/CD dependencies (GitHub Actions, external tools) to specific commit hashes or exact versions rather than using floating tags like @v1 or @latest. This prevents supply chain attacks and ensures reproducible builds. However, pinned dependencies must be regularly updated to avoid using outdated or vulnerable versions.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2025-07-09","comments":2,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-pin-ci-dependencies-securely.md"},{"slug":"browser-use-maintain-configuration-consistency","title":"Maintain configuration consistency","description":"When modifying configuration settings, especially environment variables, ensure changes are consistent with existing codebase usage patterns and maintain backward compatibility. Before changing configuration names or values, audit the codebase to understand current usage and dependencies.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Configurations","language":"Other","updated":"2025-07-09","comments":2,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-maintain-configuration-consistency.md"},{"slug":"hyprland-weak-pointer-callback-safety","title":"weak pointer callback safety","description":"When capturing objects in callbacks or lambdas that may execute asynchronously, use weak pointers instead of raw pointers or shared pointers to prevent use-after-free bugs. Always validate the weak pointer before dereferencing it, and avoid redundant lock() calls on the same weak pointer.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Concurrency","language":"C++","updated":"2025-07-09","comments":2,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-weak-pointer-callback-safety.md"},{"slug":"llama.cpp-optimize-code-placement","title":"optimize code placement","description":"Ensure code is placed in its most logical and efficient location to improve maintainability and performance. This includes consolidating duplicate functionality into shared headers or utility files, and moving loop-invariant conditions outside of loops.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Code Style","language":"Objective-C","updated":"2025-07-09","comments":2,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-optimize-code-placement.md"},{"slug":"mastodon-configuration-value-safety","title":"Configuration value safety","description":"Ensure configuration values are properly encoded and dependencies use specific versions to prevent runtime failures and security issues. When embedding dynamic values in YAML configuration files, use proper encoding methods like `.to_json` to handle special characters safely. For external dependencies in workflows and configuration, specify exact versions...","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Configurations","language":"Yaml","updated":"2025-07-09","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-configuration-value-safety.md"},{"slug":"neovim-avoid-lua-ternary-traps","title":"avoid Lua ternary traps","description":"Avoid using the `condition and expr1 or expr2` pattern when `expr1` can be `nil` or `false`, as this will always return `expr2` regardless of the condition result. This is a common source of subtle bugs in Lua code.","repository":"neovim/neovim","domain":"devtools","topic":"Null Handling","language":"Other","updated":"2025-07-09","comments":2,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-avoid-lua-ternary-traps.md"},{"slug":"appwrite-verify-authentication-logic","title":"Verify authentication logic","description":"Ensure authentication validation logic follows expected semantics and intuitive implementation. Authentication checks should correctly interpret the presence or absence of security tokens, with clear and accurate logging that reflects the actual security state.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Security","language":"JavaScript","updated":"2025-07-09","comments":1,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-verify-authentication-logic.md"},{"slug":"langflow-api-authentication-requirements","title":"API authentication requirements","description":"Ensure all API documentation and code examples include proper authentication headers and clearly explain authentication requirements. As of Langflow v1.5, all API requests require a Langflow API key, even when `AUTO_LOGIN` is enabled. The only exceptions are MCP endpoints (`/v1/mcp`, `/v1/mcp-projects`, `/v2/mcp`) which don't require authentication...","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"API","language":"Markdown","updated":"2025-07-08","comments":19,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-api-authentication-requirements.md"},{"slug":"inbox-zero-handle-async-operation-errors","title":"Handle async operation errors","description":"Always wrap asynchronous operations in try-catch-finally blocks to prevent unhandled promise rejections and ensure proper cleanup. When errors occur, provide users with meaningful feedback while preserving application state.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Error Handling","language":"TSX","updated":"2025-07-08","comments":14,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-handle-async-operation-errors.md"},{"slug":"bun-maintain-consistent-style","title":"Maintain consistent style","description":"Maintain consistent style patterns throughout the codebase to improve readability, reduce maintenance overhead, and prevent errors. Key areas to focus on:","repository":"oven-sh/bun","domain":"runtimes","topic":"Code Style","language":"Other","updated":"2025-07-08","comments":12,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-maintain-consistent-style.md"},{"slug":"ai-consistent-semantic-naming","title":"Consistent semantic naming","description":"Use clear, consistent, and semantic naming patterns across your codebase to improve readability and maintainability: 1. **Start function names with verbs** that describe the action being performed:","repository":"vercel/ai","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-08","comments":10,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-consistent-semantic-naming.md"},{"slug":"istio-simplify-code-structure","title":"Simplify code structure","description":"Prioritize code simplicity and readability by leveraging standard library functions, improving control flow patterns, and eliminating unnecessary complexity.","repository":"istio/istio","domain":"orchestration","topic":"Code Style","language":"Go","updated":"2025-07-08","comments":9,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-simplify-code-structure.md"},{"slug":"pytorch-optimize-numerical-precision","title":"Optimize numerical precision","description":"When implementing AI operations that involve matrix multiplication or neural network components, explicitly support modern numerical precision formats (TF32, BFloat16, Float8) across different hardware backends. These precision formats significantly accelerate AI training and inference while maintaining acceptable numerical accuracy.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"AI","language":"C++","updated":"2025-07-08","comments":8,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-optimize-numerical-precision.md"},{"slug":"vitess-meaningful-consistent-naming","title":"Meaningful consistent naming","description":"Use descriptive, semantically clear names that follow consistent patterns throughout the codebase. Names should convey purpose and follow established conventions.","repository":"vitessio/vitess","domain":"data-systems","topic":"Naming Conventions","language":"Go","updated":"2025-07-08","comments":8,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-meaningful-consistent-naming.md"},{"slug":"vllm-catch-specific-exception-types","title":"Catch specific exception types","description":"Avoid using broad exception handlers like `except Exception:` or bare `except:`. Instead, catch specific exception types that you expect and can handle meaningfully. This makes code more maintainable by:","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Error Handling","language":"Python","updated":"2025-07-08","comments":8,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-catch-specific-exception-types.md"},{"slug":"vllm-vectorize-over-python-loops","title":"Vectorize over Python loops","description":"Replace Python loops and list comprehensions with vectorized operations when processing tensors or performing repeated computations. This optimization reduces interpreter overhead and enables efficient parallel execution on modern hardware.","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Performance Optimization","language":"Python","updated":"2025-07-08","comments":8,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-vectorize-over-python-loops.md"},{"slug":"inbox-zero-validate-environment-variables-strictly","title":"Validate environment variables strictly","description":"Enforce strict validation of environment variables using Zod schemas with explicit environment-specific rules. Required configurations should be mandatory in production while allowing flexibility in development/test environments.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2025-07-08","comments":7,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-validate-environment-variables-strictly.md"},{"slug":"prowler-meaningful-consistent-naming","title":"Meaningful consistent naming","description":"Use names that clearly describe the purpose and behavior of variables, methods, classes, and files, while maintaining consistency across the codebase. Follow these guidelines:","repository":"prowler-cloud/prowler","domain":"security","topic":"Naming Conventions","language":"Python","updated":"2025-07-08","comments":7,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-meaningful-consistent-naming.md"},{"slug":"vllm-follow-logging-best-practices","title":"Follow logging best practices","description":"Maintain high-quality logging throughout the codebase by following these best practices: 1. **Use appropriate log levels**: Reserve `debug` for detailed troubleshooting, `info` for general operational information, `warning` for potential issues, and `error`/`critical` for actual problems. Avoid excessive logging at higher levels.","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Logging","language":"Python","updated":"2025-07-08","comments":7,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-follow-logging-best-practices.md"},{"slug":"ai-type-safe-null-handling","title":"Type-safe null handling","description":"Use TypeScript's type system and modern JavaScript features to prevent\\ \\ null reference errors. \\n\\n**TypeScript type safety:**\\n- Prefer `never` over\\ \\ `undefined` for properties that shouldn't have values","repository":"vercel/ai","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2025-07-08","comments":6,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-type-safe-null-handling.md"},{"slug":"ai-verify-ai-model-capabilities","title":"Verify AI model capabilities","description":"Always verify and accurately document AI model capabilities, supported formats, and limitations before implementation. Use consistent terminology (e.g., \"multi-modal\" instead of \"multimodal\") and validate model features against official documentation sources. When documenting AI functionalities:","repository":"vercel/ai","domain":"ai-agents","topic":"AI","language":"Other","updated":"2025-07-08","comments":6,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-verify-ai-model-capabilities.md"},{"slug":"langfuse-preserve-error-handling-context","title":"Preserve error handling context","description":"Always preserve error context by using specific error types, safe error handling patterns, and meaningful error messages. This helps with debugging and maintains a clear error handling chain.","repository":"langfuse/langfuse","domain":"observability","topic":"Error Handling","language":"TypeScript","updated":"2025-07-08","comments":6,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-preserve-error-handling-context.md"},{"slug":"neon-minimize-unnecessary-allocations","title":"Minimize unnecessary allocations","description":"Avoid allocations and cloning when they don''t provide sufficient benefit relative to their performance cost. Balance optimization efforts against code readability, especially in rarely executed paths. Specifically:","repository":"neondatabase/neon","domain":"data-systems","topic":"Performance Optimization","language":"Rust","updated":"2025-07-08","comments":6,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-minimize-unnecessary-allocations.md"},{"slug":"prometheus-improve-code-readability","title":"improve code readability","description":"Structure code to maximize readability and reduce cognitive load through proper formatting and control flow patterns. This includes breaking long function signatures across multiple lines, using early returns to reduce nesting levels, and extracting complex boolean expressions into well-named functions.","repository":"prometheus/prometheus","domain":"observability","topic":"Code Style","language":"Go","updated":"2025-07-08","comments":6,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-improve-code-readability.md"},{"slug":"svelte-document-complex-apis","title":"Document complex APIs","description":"Require comprehensive JSDoc documentation for classes, complex functions, and all exported functions to improve codebase maintainability and developer onboarding. Focus especially on code with broad reach across the codebase or non-obvious functionality.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Documentation","language":"JavaScript","updated":"2025-07-08","comments":6,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-document-complex-apis.md"},{"slug":"terraform-contextual-null-checks","title":"Contextual null checks","description":"Use type-appropriate null checking strategies based on the context of your data. For primitive values, ensure they exist before accessing properties. For complex nested structures, use more comprehensive checks like `IsWhollyKnown()` instead of simple `IsKnown()` to verify all nested attributes.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Null Handling","language":"Go","updated":"2025-07-08","comments":6,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-contextual-null-checks.md"},{"slug":"terraform-descriptive-purpose-driven-naming","title":"Descriptive purpose-driven naming","description":"Choose identifiers that accurately describe their purpose and behavior, not just their type or how they're used. Names should be specific enough to understand their role without requiring additional context.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Naming Conventions","language":"Go","updated":"2025-07-08","comments":6,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-descriptive-purpose-driven-naming.md"},{"slug":"vllm-use-self-documenting-names","title":"Use self-documenting names","description":"Variable, function, and parameter names should accurately reflect their purpose, behavior, and content. Choosing descriptive names improves code readability and reduces bugs caused by naming confusion.","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Naming Conventions","language":"Python","updated":"2025-07-08","comments":6,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-use-self-documenting-names.md"},{"slug":"bun-use-memory-pools","title":"Use memory pools","description":"Reuse memory with buffer pools for temporary allocations instead of creating new buffers each time. This reduces memory allocation overhead and improves performance, especially for operations that frequently need temporary storage.","repository":"oven-sh/bun","domain":"runtimes","topic":"Performance Optimization","language":"Other","updated":"2025-07-08","comments":5,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-use-memory-pools.md"},{"slug":"deno-avoid-implementation-detail-leakage","title":"avoid implementation detail leakage","description":"APIs should provide clean abstraction boundaries without exposing internal implementation details or creating unwanted dependencies between modules. When designing public interfaces, carefully consider what needs to be exposed versus what can remain internal.","repository":"denoland/deno","domain":"runtimes","topic":"API","language":"Rust","updated":"2025-07-08","comments":5,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-avoid-implementation-detail-leakage.md"},{"slug":"django-comments-versus-docstrings-usage","title":"Comments versus docstrings usage","description":"Choose between comments and docstrings based on the documentation's purpose and scope. Use docstrings for API-level documentation of functions, classes, and methods, writing verbs as commands (e.g., \"Return\" not \"Returns\"). Use inline comments sparingly for implementation details that aren't appropriate for the public API documentation.","repository":"django/django","domain":"app-frameworks","topic":"Documentation","language":"Python","updated":"2025-07-08","comments":5,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-comments-versus-docstrings-usage.md"},{"slug":"neon-design-metrics-for-insights","title":"Design metrics for insights","description":"Design metrics that provide actionable insights while maintaining system efficiency. Follow these key principles: 1. Track success and failure counts instead of just total counts to enable error rate calculations","repository":"neondatabase/neon","domain":"data-systems","topic":"Observability","language":"Rust","updated":"2025-07-08","comments":5,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-design-metrics-for-insights.md"},{"slug":"pytorch-handle-errors-specifically","title":"Handle errors specifically","description":"Always be explicit and specific when handling errors rather than using catch-all approaches or implicit conventions. This improves code robustness, debuggability, and maintainability.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Error Handling","language":"Python","updated":"2025-07-08","comments":5,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-handle-errors-specifically.md"},{"slug":"pytorch-prevent-null-pollution","title":"Prevent null pollution","description":"Design your code to minimize the unexpected introduction of None values into data structures and APIs. Use immutable parameter types when you don't need to modify the input, and be explicit about nullable types to establish clear contracts.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Null Handling","language":"Python","updated":"2025-07-08","comments":5,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-prevent-null-pollution.md"},{"slug":"pytorch-use-higher-level-iterations","title":"Use higher-level iterations","description":"When working with multiple sequences that need to be combined, prefer higher-level iteration abstractions over nested loops. This improves code readability, reduces nesting depth, and helps prevent logical errors when managing multiple iterative dimensions.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Algorithms","language":"Python","updated":"2025-07-08","comments":5,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-use-higher-level-iterations.md"},{"slug":"sentry-prevent-n1-database-queries","title":"Prevent N+1 database queries","description":"Avoid N+1 database queries by using appropriate Django ORM features like select_related(), prefetch_related(), and bulk operations. N+1 queries occur when you access related objects in a loop, causing additional database queries for each iteration.","repository":"getsentry/sentry","domain":"observability","topic":"Database","language":"Python","updated":"2025-07-08","comments":5,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-prevent-n1-database-queries.md"},{"slug":"sentry-secure-sensitive-data","title":"Secure sensitive data","description":"Always protect sensitive data through proper encryption, secure cookies, and careful exception handling to prevent information leakage. When handling sensitive data:","repository":"getsentry/sentry","domain":"observability","topic":"Security","language":"Python","updated":"2025-07-08","comments":5,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-secure-sensitive-data.md"},{"slug":"terraform-document-function-behavior-completely","title":"Document function behavior completely","description":"Function and method documentation should accurately describe behavior, parameters, and any non-obvious aspects of the implementation. Documentation should evolve alongside code changes.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Documentation","language":"Go","updated":"2025-07-08","comments":5,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-document-function-behavior-completely.md"},{"slug":"deno-validate-operation-permissions","title":"Validate operation permissions","description":"Ensure appropriate permission checks are implemented before performing security-sensitive operations that access files, networks, or system resources. Different operation types require different permission validations, and the timing of these checks matters for security.","repository":"denoland/deno","domain":"runtimes","topic":"Security","language":"Rust","updated":"2025-07-08","comments":4,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-validate-operation-permissions.md"},{"slug":"django-measure-before-optimizing","title":"Measure before optimizing","description":"Always measure performance impact before implementing optimizations and focus on changes with meaningful benefits. Python's performance characteristics can be unintuitive - optimizations that seem beneficial might have minimal impact, while simple changes can yield significant improvements.","repository":"django/django","domain":"app-frameworks","topic":"Performance Optimization","language":"Python","updated":"2025-07-08","comments":4,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-measure-before-optimizing.md"},{"slug":"n8n-maintain-semantic-naming-consistency","title":"Maintain semantic naming consistency","description":"Names should be semantically meaningful and consistent across related concepts in the codebase. This applies to variables, functions, components, and types. When naming:","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-08","comments":4,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-maintain-semantic-naming-consistency.md"},{"slug":"neon-connection-pooling-with-pipelining","title":"Connection pooling with pipelining","description":"Implement connection pooling with request pipelining for network services to optimize resource usage and improve throughput. Pool should manage three resource levels:","repository":"neondatabase/neon","domain":"data-systems","topic":"Networking","language":"Rust","updated":"2025-07-08","comments":4,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-connection-pooling-with-pipelining.md"},{"slug":"neon-ensure-algorithm-robustness","title":"Ensure algorithm robustness","description":"When implementing algorithms, ensure they handle all edge cases correctly and robustly. Code should gracefully manage exceptional conditions rather than producing incorrect results or panicking.","repository":"neondatabase/neon","domain":"data-systems","topic":"Algorithms","language":"Rust","updated":"2025-07-08","comments":4,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-ensure-algorithm-robustness.md"},{"slug":"prowler-document-configuration-variables","title":"Document configuration variables","description":"Always provide complete documentation for configuration variables, including their exact format, purpose, and behavior. For environment variables and connection strings, specify the full expected format with examples and explain why specific formats are required.","repository":"prowler-cloud/prowler","domain":"security","topic":"Configurations","language":"Markdown","updated":"2025-07-08","comments":4,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-document-configuration-variables.md"},{"slug":"prowler-maintain-component-consistency","title":"Maintain component consistency","description":"Use a consistent approach when working with components to improve code maintainability and ensure visual coherence throughout the application: 1. **Reuse existing components** rather than creating new ones for similar functionality.","repository":"prowler-cloud/prowler","domain":"security","topic":"Code Style","language":"TSX","updated":"2025-07-08","comments":4,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-maintain-component-consistency.md"},{"slug":"pytorch-choose-appropriate-exceptions","title":"Choose appropriate exceptions","description":"Select the proper exception type based on the error scenario to provide clearer error handling and better debugging experience: 1. Use ValueError (TORCH_CHECK_VALUE) when input parameters have invalid values","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Error Handling","language":"C++","updated":"2025-07-08","comments":4,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-choose-appropriate-exceptions.md"},{"slug":"pytorch-normalize-configuration-parameters","title":"Normalize configuration parameters","description":"Always normalize configuration inputs (especially environment variables) by removing whitespace and applying consistent case transformation before processing them. This prevents unexpected behaviors caused by insignificant variations in input format.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Configurations","language":"Python","updated":"2025-07-08","comments":4,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-normalize-configuration-parameters.md"},{"slug":"vllm-document-ai-model-capabilities","title":"Document AI model capabilities","description":"Provide clear, comprehensive documentation for AI model capabilities, especially for multimodal features and deployment scenarios. Include: 1. Explicit documentation of supported input types and formats","repository":"vllm-project/vllm","domain":"llm-infra","topic":"AI","language":"Markdown","updated":"2025-07-08","comments":4,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-document-ai-model-capabilities.md"},{"slug":"volcano-comprehensive-test-structure","title":"Comprehensive test structure","description":"Tests should focus on comprehensive coverage of main logic flows rather than trivial functions, use established testing patterns like TestCommonStruct for end-to-end validation, and maintain proper table-driven test formatting for readability and maintainability.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Testing","language":"Go","updated":"2025-07-08","comments":4,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-comprehensive-test-structure.md"},{"slug":"bun-maintain-portable-config-values","title":"Maintain portable config values","description":"Always use portable, environment-agnostic values in configuration files. Avoid hardcoded absolute paths, system-specific values, or mismatched feature flags. Instead:","repository":"oven-sh/bun","domain":"runtimes","topic":"Configurations","language":"Other","updated":"2025-07-08","comments":3,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-maintain-portable-config-values.md"},{"slug":"core-use-environment-flags-consistently","title":"Use environment flags consistently","description":"Feature flags like `__DEV__` and `__COMPAT__` are critical configuration mechanisms that control environment-specific behavior. Always wrap development-only code (such as warnings and debug information) in `__DEV__` conditionals to ensure they don't ship to production builds. Remember that these flags are replaced at build time through tree-shaking, so...","repository":"vuejs/core","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2025-07-08","comments":3,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-use-environment-flags-consistently.md"},{"slug":"django-break-lines-for-readability","title":"Break lines for readability","description":"Format code with semantic line breaks that enhance readability rather than adhering strictly to character limits. When breaking long lines: 1. Break at natural semantic boundaries","repository":"django/django","domain":"app-frameworks","topic":"Code Style","language":"Python","updated":"2025-07-08","comments":3,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-break-lines-for-readability.md"},{"slug":"neon-document-api-specs-completely","title":"Document API specs completely","description":"When designing and implementing APIs, always provide comprehensive specifications that clearly document all endpoints, methods, parameters, and expected responses. This should include:","repository":"neondatabase/neon","domain":"data-systems","topic":"API","language":"Markdown","updated":"2025-07-08","comments":3,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-document-api-specs-completely.md"},{"slug":"neon-environment-specific-config-defaults","title":"Environment-specific config defaults","description":"Define appropriate configuration defaults for different environments (development, testing, production) using dedicated configuration classes with sensible defaults. When test environments require different configurations than production, explicitly create separate config structures rather than hardcoding values throughout tests.","repository":"neondatabase/neon","domain":"data-systems","topic":"Configurations","language":"Python","updated":"2025-07-08","comments":3,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-environment-specific-config-defaults.md"},{"slug":"pytorch-check-cuda-availability-first","title":"Check CUDA availability first","description":"Always verify CUDA availability before performing CUDA-specific operations to prevent runtime errors when code runs on systems without CUDA support. When working with device-specific code:","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Pytorch","language":"Python","updated":"2025-07-08","comments":3,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-check-cuda-availability-first.md"},{"slug":"pytorch-parameterize-similar-test-cases","title":"Parameterize similar test cases","description":"Instead of duplicating test code or using nested loops, use test parameterization to handle multiple test cases efficiently. This improves maintainability, ensures complete coverage, and makes test failures more traceable.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Testing","language":"Python","updated":"2025-07-08","comments":3,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-parameterize-similar-test-cases.md"},{"slug":"sentry-structured-metric-naming","title":"Structured metric naming","description":"Create metrics with descriptive, unique names that are distinguishable when viewed in monitoring tools. Avoid generic prefixes that make groups of related metrics indistinguishable from each other. Include specific actions or states in the metric name to clearly identify what's being measured.","repository":"getsentry/sentry","domain":"observability","topic":"Observability","language":"Python","updated":"2025-07-08","comments":3,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-structured-metric-naming.md"},{"slug":"spark-use-modern-java-syntax","title":"use modern Java syntax","description":"Prefer modern Java language features and constructs to write more concise, readable code. Since Apache Spark 4.0.0, the project recommends using contemporary Java syntax where applicable.","repository":"apache/spark","domain":"data-systems","topic":"Code Style","language":"Java","updated":"2025-07-08","comments":3,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-use-modern-java-syntax.md"},{"slug":"supabase-explicit-null-handling","title":"Explicit null handling","description":"Use explicit patterns when dealing with potentially null or undefined values to prevent runtime errors and improve code clarity: 1. **Mark optional properties with the `?` operator** in TypeScript interfaces when values might be undefined:","repository":"supabase/supabase","domain":"data-systems","topic":"Null Handling","language":"TSX","updated":"2025-07-08","comments":3,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-explicit-null-handling.md"},{"slug":"volcano-extract-configuration-constants","title":"Extract configuration constants","description":"Avoid hardcoded values and magic numbers in configuration-related code by extracting them as named constants. This improves code maintainability, readability, and makes configuration values easier to modify.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Configurations","language":"Go","updated":"2025-07-08","comments":3,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-extract-configuration-constants.md"},{"slug":"ai-consistent-camelcase-naming","title":"Consistent camelCase naming","description":"Use camelCase consistently for all property names, method names, and configuration options, even when interacting with external APIs that use different conventions (like snake_case). This maintains codebase consistency and makes interfaces more predictable for developers.","repository":"vercel/ai","domain":"ai-agents","topic":"Naming Conventions","language":"Other","updated":"2025-07-08","comments":2,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-consistent-camelcase-naming.md"},{"slug":"ai-format-for-rendering-compatibility","title":"Format for rendering compatibility","description":"Documentation should be formatted appropriately for its intended rendering context and ensure discoverability. Consider how documentation files will be displayed in different environments (GitHub, websites, etc.) and choose appropriate file formats and structures.","repository":"vercel/ai","domain":"ai-agents","topic":"Documentation","language":"Markdown","updated":"2025-07-08","comments":2,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-format-for-rendering-compatibility.md"},{"slug":"argo-cd-document-observability-prerequisites","title":"Document observability prerequisites","description":"When documenting observability features such as metrics, debugging capabilities, or monitoring tools, always include clear information about their prerequisites, enabling conditions, and limitations. This ensures developers understand when these features are available and how to access them.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Observability","language":"Markdown","updated":"2025-07-08","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-document-observability-prerequisites.md"},{"slug":"bun-hide-implementation-details","title":"Hide implementation details","description":"When designing APIs, carefully consider which elements of your implementation become part of the public interface. Avoid exposing internal types, naming patterns, and implementation details that could confuse API consumers or lock you into supporting implementation details as part of your contract.","repository":"oven-sh/bun","domain":"runtimes","topic":"API","language":"TypeScript","updated":"2025-07-08","comments":2,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-hide-implementation-details.md"},{"slug":"lobe-chat-choose-hooks-wisely","title":"Choose hooks wisely","description":"Use React hooks only when you need reactivity and component re-rendering. For accessing instantaneous values or one-time data retrieval, prefer plain functions to avoid unnecessary re-renders and improve performance.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"React","language":"TypeScript","updated":"2025-07-08","comments":2,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-choose-hooks-wisely.md"},{"slug":"neon-handle-network-interrupts-safely","title":"Handle network interrupts safely","description":"Network code must properly handle interrupts and maintain consistent connection state at all potential interruption points. When implementing network operations:","repository":"neondatabase/neon","domain":"data-systems","topic":"Networking","language":"C","updated":"2025-07-08","comments":2,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-handle-network-interrupts-safely.md"},{"slug":"prowler-write-objectively","title":"Write objectively","description":"Use an impersonal, objective tone in technical documentation. Avoid using second-person pronouns (\"you\") and subjective terms like \"simple\" or \"easy\" which make assumptions about reader knowledge.","repository":"prowler-cloud/prowler","domain":"security","topic":"Documentation","language":"Markdown","updated":"2025-07-08","comments":2,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-write-objectively.md"},{"slug":"pytorch-preserve-api-compatibility","title":"Preserve API compatibility","description":"When modifying existing APIs, always prioritize backward compatibility to avoid breaking client code. Before changing API signatures, function names, or return types, first consider the impact on existing consumers.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"API","language":"Other","updated":"2025-07-08","comments":2,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-preserve-api-compatibility.md"},{"slug":"trae-agent-externalize-hardcoded-configurations","title":"Externalize hardcoded configurations","description":"Configuration values should be externalized to environment variables rather than hardcoded in the source code. This improves flexibility, security, and deployment across different environments.","repository":"bytedance/trae-agent","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2025-07-08","comments":2,"stars":9088,"raw":"https://awesomereviewers.com/raw/trae-agent-externalize-hardcoded-configurations.md"},{"slug":"trae-agent-follow-established-naming-conventions","title":"Follow established naming conventions","description":"Adhere to established naming conventions consistently throughout the codebase, prioritizing official documentation standards when available. Use appropriate case conventions (ALL_CAPS for constants, descriptive names for variables) and maintain consistency with external API standards.","repository":"bytedance/trae-agent","domain":"ai-agents","topic":"Naming Conventions","language":"Python","updated":"2025-07-08","comments":2,"stars":9088,"raw":"https://awesomereviewers.com/raw/trae-agent-follow-established-naming-conventions.md"},{"slug":"turborepo-verify-test-commands","title":"Verify test commands","description":"Always verify that test commands documented in project guides work exactly as written. Test commands should be copy-paste executable without modification. When adding or updating test command examples in documentation:","repository":"vercel/turborepo","domain":"devtools","topic":"Testing","language":"Markdown","updated":"2025-07-08","comments":2,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-verify-test-commands.md"},{"slug":"vllm-environment-aware-configuration-values","title":"Environment-aware configuration values","description":"When creating configuration files or defining configuration constants, ensure they properly adapt to different environments (Python versions, hardware architectures, etc.) with clear documentation. This prevents compatibility issues and helps other developers understand configuration choices.","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Configurations","language":"Other","updated":"2025-07-08","comments":2,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-environment-aware-configuration-values.md"},{"slug":"pytorch-device-agnostic-acceleration-code","title":"Device-agnostic acceleration code","description":"Avoid hardcoding specific device types like 'cuda' in AI code. Instead, use device-agnostic approaches such as device type variables or accelerator detection functions. This ensures code runs efficiently across different hardware accelerators (CUDA, ROCm, XPU, etc.) without modification.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"AI","language":"Python","updated":"2025-07-07","comments":11,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-device-agnostic-acceleration-code.md"},{"slug":"vllm-eliminate-code-redundancy","title":"Eliminate code redundancy","description":"Keep your codebase maintainable by eliminating both unnecessary and duplicated code: 1. **Remove debugging artifacts**: Delete commented-out code, debug print statements, and unused imports before merging.","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Code Style","language":"Python","updated":"2025-07-07","comments":11,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-eliminate-code-redundancy.md"},{"slug":"prometheus-simplify-complex-algorithms","title":"simplify complex algorithms","description":"When implementing algorithms, prioritize simplicity and maintainability over premature optimization. Complex algorithms should be broken down into smaller, reusable components or replaced with simpler approaches when possible.","repository":"prometheus/prometheus","domain":"observability","topic":"Algorithms","language":"Go","updated":"2025-07-07","comments":10,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-simplify-complex-algorithms.md"},{"slug":"vllm-document-code-thoroughly","title":"Document code thoroughly","description":"Always include comprehensive documentation for your code through both\\ \\ docstrings and explanatory comments. \\n\\nFor classes, functions, and methods,\\ \\ add docstrings that explain:","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Documentation","language":"Python","updated":"2025-07-07","comments":10,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-document-code-thoroughly.md"},{"slug":"vllm-avoid-magic-numbers","title":"Avoid magic numbers","description":"Replace hardcoded values and magic numbers in AI model code with named constants or configuration parameters. This improves maintainability, reduces errors, and makes code more adaptable to different model architectures.","repository":"vllm-project/vllm","domain":"llm-infra","topic":"AI","language":"Python","updated":"2025-07-07","comments":9,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-avoid-magic-numbers.md"},{"slug":"alacritty-document-configuration-specifics","title":"Document configuration specifics","description":"When documenting configuration options in changelogs, README files, or other user-facing documentation, focus on specific implementation details and user-actionable information rather than vague feature descriptions. Write from the user's perspective, specifying exact configuration keys, values, and behaviors.","repository":"alacritty/alacritty","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2025-07-07","comments":7,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-document-configuration-specifics.md"},{"slug":"sentry-minimize-mocks-verify-behavior","title":"Minimize mocks verify behavior","description":"Write tests that verify actual system behavior rather than implementation details by minimizing mock usage and focusing on real interactions. Excessive mocking can lead to brittle tests that pass even when core functionality is broken.","repository":"getsentry/sentry","domain":"observability","topic":"Testing","language":"Python","updated":"2025-07-07","comments":7,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-minimize-mocks-verify-behavior.md"},{"slug":"supabase-document-structure-consistency","title":"Document structure consistency","description":"Maintain consistent document structure and formatting in documentation to improve readability and user experience. Follow these key principles: 1. **Use sentence case for headings** - Only capitalize the first word and proper nouns:","repository":"supabase/supabase","domain":"data-systems","topic":"Documentation","language":"Other","updated":"2025-07-07","comments":7,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-document-structure-consistency.md"},{"slug":"vllm-check-before-access","title":"Check before access","description":"Always verify that objects, attributes, and variables are not None before accessing their properties, calling their methods, or using them in operations. This prevents common runtime errors like TypeError, AttributeError, or UnboundLocalError when working with optional values.","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Null Handling","language":"Python","updated":"2025-07-07","comments":7,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-check-before-access.md"},{"slug":"ghostty-robust-ssh-integration","title":"Robust SSH integration","description":"When implementing SSH integration in your application, follow these practices to ensure reliability across different systems: 1. **Preserve user context**: Include user information in SSH target identification, as many operations (like terminfo installation) write to user-specific directories.","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Networking","language":"Other","updated":"2025-07-07","comments":6,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-robust-ssh-integration.md"},{"slug":"neovim-follow-established-api-patterns","title":"Follow established API patterns","description":"APIs should follow documented conventions and established patterns within the codebase to ensure consistency and predictability. This includes adhering to naming conventions, parameter structures, and interface designs that users already expect.","repository":"neovim/neovim","domain":"devtools","topic":"API","language":"Txt","updated":"2025-07-07","comments":6,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-follow-established-api-patterns.md"},{"slug":"turborepo-know-your-implicit-configurations","title":"Know your implicit configurations","description":"When working with Turborepo, be aware of implicit configurations and special files that affect behavior even when not explicitly configured. For example, `turbo.json` and `package.json` are always considered inputs when determining if a package has changed, even if you try to explicitly ignore them. Package manager lockfiles are also always parsed and...","repository":"vercel/turborepo","domain":"devtools","topic":"Configurations","language":"Other","updated":"2025-07-07","comments":6,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-know-your-implicit-configurations.md"},{"slug":"vllm-process-configurations-consistently","title":"Process configurations consistently","description":"Ensure that configuration data is processed consistently and correctly throughout the codebase. This includes: 1. **Use proper serialization methods** for configuration dictionaries. Prefer `json.dumps()` over `str()` when converting dictionaries to strings:","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Configurations","language":"Python","updated":"2025-07-07","comments":6,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-process-configurations-consistently.md"},{"slug":"vllm-stable-documentation-links","title":"Stable documentation links","description":"Ensure all documentation links are stable, consistent, and correctly targeted to improve navigation and long-term maintainability: 1. **Use stable references**: Always link to stable release tags or specific commit hashes rather than volatile branches like `master` or `main`:","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Documentation","language":"Markdown","updated":"2025-07-07","comments":6,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-stable-documentation-links.md"},{"slug":"bun-clean-all-error-paths","title":"Clean all error paths","description":"Ensure all error paths properly clean up resources and handle errors appropriately. This includes: 1. Using errdefer for cleanup when allocating resources","repository":"oven-sh/bun","domain":"runtimes","topic":"Error Handling","language":"Other","updated":"2025-07-07","comments":5,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-clean-all-error-paths.md"},{"slug":"hyprland-optimize-computational-efficiency","title":"optimize computational efficiency","description":"Prioritize algorithmic efficiency and avoid unnecessary computational overhead in performance-critical code paths. Look for opportunities to reduce time complexity and eliminate redundant calculations.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Algorithms","language":"C++","updated":"2025-07-07","comments":5,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-optimize-computational-efficiency.md"},{"slug":"opentofu-clear-concise-documentation","title":"Clear concise documentation","description":"Write documentation that is direct, consistent, and appropriately detailed. Follow these principles: 1. **Use direct language** - Prefer straightforward assertions over gentle phrasing. Instead of \"Please be cautious when...\" use \"Use caution when...\" or simply state facts and instructions directly.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Documentation","language":"Other","updated":"2025-07-07","comments":5,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-clear-concise-documentation.md"},{"slug":"vllm-preserve-api-compatibility","title":"Preserve API compatibility","description":"When modifying API interfaces, parameters, or argument behavior, ensure backward compatibility is maintained to prevent breaking existing user code. If a parameter needs to be renamed or enhanced, continue supporting the old parameter name alongside the new one.","repository":"vllm-project/vllm","domain":"llm-infra","topic":"API","language":"Python","updated":"2025-07-07","comments":5,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-preserve-api-compatibility.md"},{"slug":"vllm-validate-algorithmic-operations-carefully","title":"Validate algorithmic operations carefully","description":"Mathematical and logical operations require careful validation to ensure correctness. Common issues include: 1. Operator precedence in complex conditions","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Algorithms","language":"Python","updated":"2025-07-07","comments":5,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-validate-algorithmic-operations-carefully.md"},{"slug":"duckdb-prefer-settings-over-pragmas","title":"prefer settings over pragmas","description":"When implementing configuration options, prefer database settings over pragma functions to maintain consistency and better user experience. Settings provide a unified interface that's easier to discover, document, and manage compared to scattered pragma functions.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Configurations","language":"C++","updated":"2025-07-07","comments":4,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-prefer-settings-over-pragmas.md"},{"slug":"ghostty-optimize-comparison-patterns-efficiently","title":"Optimize comparison patterns efficiently","description":"Choose efficient comparison patterns and algorithms based on the data type and use case. Key guidelines: 1. For string pattern matching, prefer glob patterns over regex for simple cases:","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Algorithms","language":"Other","updated":"2025-07-07","comments":4,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-optimize-comparison-patterns-efficiently.md"},{"slug":"material-ui-use-slots-for-composition","title":"Use slots for composition","description":"When designing React component APIs, implement the slots pattern using `slots` and `slotProps` props instead of specialized prop names. This approach provides a consistent, flexible, and maintainable way to customize component parts while preserving their functionality.","repository":"mui/material-ui","domain":"app-frameworks","topic":"React","language":"Markdown","updated":"2025-07-07","comments":4,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-use-slots-for-composition.md"},{"slug":"pytorch-design-for-compatibility","title":"Design for compatibility","description":"When evolving APIs, prioritize backward compatibility to minimize disruption for existing users. Add new functionality using default arguments rather than creating overloaded methods that could cause ABI compatibility issues. For example:","repository":"pytorch/pytorch","domain":"ml-systems","topic":"API","language":"C++","updated":"2025-07-07","comments":4,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-design-for-compatibility.md"},{"slug":"react-router-api-backward-compatibility","title":"API backward compatibility","description":"When evolving APIs, maintain backward compatibility by preserving existing public interfaces while adding new functionality through internal implementations or optional parameters. Avoid breaking changes that remove functionality without providing migration paths.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"API","language":"TSX","updated":"2025-07-07","comments":4,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-api-backward-compatibility.md"},{"slug":"roo-code-robust-error-handling","title":"Robust error handling","description":"Implement comprehensive error handling to prevent crashes and aid debugging. This includes: 1. **Use try/catch blocks for risky operations** - Especially when parsing JSON or using browser APIs that might throw exceptions:","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Error Handling","language":"TSX","updated":"2025-07-07","comments":4,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-robust-error-handling.md"},{"slug":"temporal-trust-getx-accessors","title":"Trust GetX accessors","description":"When working with protocol buffer messages or similar objects that provide GetX() accessor methods, avoid redundant nil checks before calling these methods. GetX() methods are designed to handle nil receivers safely, allowing for cleaner and more concise code.","repository":"temporalio/temporal","domain":"orchestration","topic":"Null Handling","language":"Go","updated":"2025-07-07","comments":4,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-trust-getx-accessors.md"},{"slug":"browser-use-simplify-algorithmic-approaches","title":"Simplify algorithmic approaches","description":"When implementing functionality, evaluate whether simpler algorithmic approaches or more appropriate data structures can achieve the same result with less complexity. Look for opportunities to eliminate unnecessary conditional branching, use built-in operations for common tasks, and leverage established patterns like regex for pattern matching.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Algorithms","language":"Python","updated":"2025-07-07","comments":3,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-simplify-algorithmic-approaches.md"},{"slug":"crewai-thread-safety-first","title":"Thread safety first","description":"When implementing features that may run concurrently, always ensure thread safety using appropriate synchronization mechanisms: 1. Use thread-safe context variables for isolating execution contexts:","repository":"crewaiinc/crewai","domain":"ai-agents","topic":"Concurrency","language":"Python","updated":"2025-07-07","comments":3,"stars":33945,"raw":"https://awesomereviewers.com/raw/crewai-thread-safety-first.md"},{"slug":"discourse-include-contextual-error-information","title":"Include contextual error information","description":"Error messages should include relevant contextual information such as IDs, file paths, job identifiers, and other debugging details to make troubleshooting easier. Generic error messages make it difficult to identify the specific instance or operation that failed, especially in systems processing multiple items concurrently.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Error Handling","language":"Ruby","updated":"2025-07-07","comments":3,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-include-contextual-error-information.md"},{"slug":"django-consider-related-object-cleanup","title":"Consider related object cleanup","description":"When implementing migration operations that modify or remove database objects like fields and models, ensure all related objects (indexes, constraints, foreign keys) are properly identified and removed. Failing to handle these dependencies can leave orphaned database objects that may cause issues later.","repository":"django/django","domain":"app-frameworks","topic":"Migrations","language":"Python","updated":"2025-07-07","comments":3,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-consider-related-object-cleanup.md"},{"slug":"langflow-consistent-formatting-standards","title":"Consistent formatting standards","description":"Maintain consistent formatting and syntax across all documentation and code examples to improve readability and functionality. Follow established style guides and ensure uniformity in presentation.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Code Style","language":"Markdown","updated":"2025-07-07","comments":3,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-consistent-formatting-standards.md"},{"slug":"langfuse-standardize-configuration-values","title":"Standardize configuration values","description":"Always standardize configuration values to ensure consistency, reproducibility, and maintainability: 1. **Pin specific versions** instead of using floating tags for dependencies to ensure consistent behavior across environments.","repository":"langfuse/langfuse","domain":"observability","topic":"Configurations","language":"Yaml","updated":"2025-07-07","comments":3,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-standardize-configuration-values.md"},{"slug":"pytorch-prefer-hints-in-cmake","title":"Prefer HINTS in CMake","description":"When configuring library searches in CMake, use `HINTS` instead of `PATHS` when you want to prioritize specific locations before falling back to system defaults. `HINTS` are searched before default paths, while `PATHS` are searched after default paths. This ensures that user-specified or environment-provided paths are checked first, making dependency...","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Configurations","language":"Txt","updated":"2025-07-07","comments":3,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-prefer-hints-in-cmake.md"},{"slug":"pytorch-purpose-revealing-identifier-names","title":"Purpose-revealing identifier names","description":"Choose identifier names that clearly reveal their purpose and behavior. Names should be specific, descriptive, and self-explanatory: - **Function names** should include verbs that indicate the action being performed or a question being answered (e.g., use `is_consistent()` rather than `consistency()`)","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Naming Conventions","language":"Python","updated":"2025-07-07","comments":3,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-purpose-revealing-identifier-names.md"},{"slug":"pytorch-reduce-code-duplication","title":"Reduce code duplication","description":"Eliminate repeated code patterns by using appropriate abstraction techniques. This improves readability, reduces maintenance burden, and minimizes the risk of inconsistencies when changes are needed.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Code Style","language":"C++","updated":"2025-07-07","comments":3,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-reduce-code-duplication.md"},{"slug":"sentry-memoize-expensive-computations-effectively","title":"Memoize expensive computations effectively","description":"Prevent unnecessary recalculations and rerenders by properly memoizing expensive computations and derived values in React components. Pay special attention to dependency arrays and ensure they only include stable references.","repository":"getsentry/sentry","domain":"observability","topic":"Performance Optimization","language":"TSX","updated":"2025-07-07","comments":3,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-memoize-expensive-computations-effectively.md"},{"slug":"sentry-write-comprehensive-assertions","title":"Write comprehensive assertions","description":"When writing tests, ensure your assertions thoroughly verify all relevant aspects of the functionality being tested. Go beyond the basic \"happy path\" checks and include assertions that verify:","repository":"getsentry/sentry","domain":"observability","topic":"Testing","language":"TSX","updated":"2025-07-07","comments":3,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-write-comprehensive-assertions.md"},{"slug":"agents-validate-environment-bindings","title":"Validate environment bindings","description":"Always validate that environment bindings exist and are of the expected type before using them, and ensure external dependencies are properly configured in build scripts. Runtime binding validation prevents cryptic errors when bindings are missing or misconfigured, while proper build configuration prevents dynamic import issues in serverless environments.","repository":"cloudflare/agents","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-07-07","comments":2,"stars":2312,"raw":"https://awesomereviewers.com/raw/agents-validate-environment-bindings.md"},{"slug":"browser-use-configuration-documentation-completeness","title":"Configuration documentation completeness","description":"Configuration documentation should include all necessary constraints and limitations while avoiding redundant information that's already documented elsewhere. Always document critical constraints that could cause runtime issues, such as resource conflicts or usage limitations. Remove duplicate explanations that repeat information available in other parts of...","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2025-07-07","comments":2,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-configuration-documentation-completeness.md"},{"slug":"continue-use-asyncawait-pattern","title":"Use async/await pattern","description":"Prefer async/await syntax over promise chains or callback patterns when working with asynchronous operations. This improves code readability, makes error handling more straightforward, and maintains consistency across the codebase.","repository":"continuedev/continue","domain":"ai-agents","topic":"Concurrency","language":"TSX","updated":"2025-07-07","comments":2,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-use-asyncawait-pattern.md"},{"slug":"django-organize-by-functionality","title":"Organize by functionality","description":"Place code in files that match its functionality. When functionality applies to multiple components, use a general-purpose file rather than component-specific ones. This improves maintainability and makes the codebase easier to navigate.","repository":"django/django","domain":"app-frameworks","topic":"Code Style","language":"JavaScript","updated":"2025-07-07","comments":2,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-organize-by-functionality.md"},{"slug":"llama.cpp-explicit-performance-handling","title":"explicit performance handling","description":"When writing performance benchmarking and measurement code, always be explicit about all possible cases and organize related constants clearly. Avoid catch-all else clauses that could mask bugs or unexpected values in performance-critical code paths.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Performance Optimization","language":"Python","updated":"2025-07-07","comments":2,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-explicit-performance-handling.md"},{"slug":"material-ui-graceful-component-errors","title":"Graceful component errors","description":"Use descriptive error messages and appropriate error severity based on component maturity and usage patterns. For newer components, throwing errors is acceptable when constraints are violated. For established components, consider using development-mode warnings instead of throwing errors to avoid breaking existing implementations.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2025-07-07","comments":2,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-graceful-component-errors.md"},{"slug":"node-validate-network-request-parameters","title":"Validate network request parameters","description":"Always validate and sanitize all network request parameters to prevent injection attacks. This includes: 1. **URL validation**: Consider restricting URLs to trusted origins only (e.g., localhost/loopback interfaces) to reduce the attack surface.","repository":"nodejs/node","domain":"runtimes","topic":"Security","language":"JavaScript","updated":"2025-07-07","comments":2,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-validate-network-request-parameters.md"},{"slug":"prowler-format-ai-code-identifiers","title":"Format AI code identifiers","description":"When documenting AI systems, always format code identifiers, function names, agent names, model names, and other technical references with backticks (`) to improve readability and clearly distinguish them from regular text. This is particularly important in AI documentation where specialized components like agents, models, and functions need to be visually...","repository":"prowler-cloud/prowler","domain":"security","topic":"AI","language":"Markdown","updated":"2025-07-07","comments":2,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-format-ai-code-identifiers.md"},{"slug":"sentry-meaningful-test-design","title":"Meaningful test design","description":"Write tests that focus on unique edge cases and avoid redundancy. When designing test suites: 1. Consolidate similar test cases that don''t provide additional coverage","repository":"getsentry/sentry","domain":"observability","topic":"Testing","language":"TypeScript","updated":"2025-07-07","comments":2,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-meaningful-test-design.md"},{"slug":"supabase-avoid-code-duplication","title":"Avoid code duplication","description":"Maintain clean, maintainable code by avoiding duplication and following proper code organization principles: 1. Place utility functions in dedicated utility files rather than defining them inline within component files","repository":"supabase/supabase","domain":"data-systems","topic":"Code Style","language":"TypeScript","updated":"2025-07-07","comments":2,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-avoid-code-duplication.md"},{"slug":"temporal-protocol-buffer-organization","title":"Protocol buffer organization","description":"When defining protocol buffer messages, prioritize good organization and reuse: 1. Reuse existing message types instead of duplicating structures. This reduces maintenance effort and prevents potential bugs from diverging implementations.","repository":"temporalio/temporal","domain":"orchestration","topic":"Code Style","language":"Other","updated":"2025-07-07","comments":2,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-protocol-buffer-organization.md"},{"slug":"vllm-combine-identical-css","title":"Combine identical CSS","description":"When multiple CSS selectors share identical styling properties, combine them using comma separation rather than duplicating the same rules. This reduces code duplication, improves maintainability, and makes stylesheets more concise.","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Code Style","language":"Css","updated":"2025-07-07","comments":2,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-combine-identical-css.md"},{"slug":"vllm-optimize-gpu-execution","title":"Optimize GPU execution","description":"Ensure GPU code is optimized for both proper thread utilization and correct architecture dispatching: 1. **Maximize thread parallelism** - Design CUDA kernels to fully utilize available threads. When appropriate, use multi-dimensional grid configurations to parallelize across all relevant dimensions of your problem.","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Performance Optimization","language":"CUDA","updated":"2025-07-07","comments":2,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-optimize-gpu-execution.md"},{"slug":"langflow-use-fake-sample-data","title":"Use fake sample data","description":"Always use completely fictional personal information in sample files, documentation, test data, and code examples to prevent privacy violations and unintentional exposure of real people's data. Real names, email addresses, phone numbers, and social media profiles should never appear in sample data as they can link to actual individuals and create privacy...","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Security","language":"Txt","updated":"2025-07-07","comments":1,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-use-fake-sample-data.md"},{"slug":"v-informative-error-messages","title":"informative error messages","description":"Error messages should be specific, contextual, and include relevant information to aid debugging and user understanding. Avoid generic messages like \"invalid syntax\" in favor of descriptive explanations that specify what was expected, what was found, and include the problematic data when helpful.","repository":"vlang/v","domain":"runtimes","topic":"Error Handling","language":"Other","updated":"2025-07-06","comments":7,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-informative-error-messages.md"},{"slug":"django-prevent-n1-queries","title":"Prevent N+1 queries","description":"The N+1 query problem is one of the most common performance bottlenecks in Django applications. This occurs when you retrieve a list of objects and then access related objects for each one individually, causing an additional database query for each parent object.","repository":"django/django","domain":"app-frameworks","topic":"Database","language":"Txt","updated":"2025-07-06","comments":4,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-prevent-n1-queries.md"},{"slug":"neovim-reuse-concurrency-infrastructure","title":"reuse concurrency infrastructure","description":"Avoid implementing custom concurrency patterns when existing infrastructure is available. Before creating new debouncing, async/await, or parallel execution code, check if suitable implementations already exist in the codebase.","repository":"neovim/neovim","domain":"devtools","topic":"Concurrency","language":"Other","updated":"2025-07-06","comments":3,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-reuse-concurrency-infrastructure.md"},{"slug":"node-use-appropriate-metric-types","title":"Use appropriate metric types","description":"When instrumenting applications with metrics, choose the correct metric type based on what you''re measuring to ensure accurate and useful observability data:","repository":"nodejs/node","domain":"runtimes","topic":"Observability","language":"Markdown","updated":"2025-07-06","comments":3,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-use-appropriate-metric-types.md"},{"slug":"roo-code-use-cryptographic-randomness","title":"Use cryptographic randomness","description":"Always use cryptographically secure random number generation for security-sensitive operations such as generating session IDs, authentication tokens, or unique identifiers. Standard random number generators like `Math.random()` are designed for statistical randomness, not security, making them vulnerable to prediction and exploitation by attackers.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2025-07-06","comments":3,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-use-cryptographic-randomness.md"},{"slug":"argo-cd-remove-unnecessary-elements","title":"Remove unnecessary elements","description":"Eliminate superfluous syntax and words that don't add value to improve code readability and maintain consistent style. This includes removing unnecessary quotes in YAML files and avoiding redundant words in documentation.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Code Style","language":"Markdown","updated":"2025-07-06","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-remove-unnecessary-elements.md"},{"slug":"ghostty-pipeline-friendly-script-design","title":"Pipeline-friendly script design","description":"Design scripts to be easily integrated into build pipelines and CI/CD workflows by using standard I/O streams instead of hardcoded file paths. Scripts that read from stdin and write to stdout can be easily composed in pipelines, redirected, and incorporated into various build systems without modification.","repository":"ghostty-org/ghostty","domain":"devtools","topic":"CI/CD","language":"Python","updated":"2025-07-06","comments":2,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-pipeline-friendly-script-design.md"},{"slug":"playwright-api-documentation-precision","title":"API documentation precision","description":"API documentation must use specific, well-defined types instead of generic ones, and clearly define behavior for all scenarios including edge cases. When documenting return types, use explicit union types or named type aliases rather than generic strings. For complex APIs with multiple options, document the interaction between different parameters and their...","repository":"microsoft/playwright","domain":"devtools","topic":"API","language":"Markdown","updated":"2025-07-06","comments":2,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-api-documentation-precision.md"},{"slug":"appwrite-active-service-health-checks","title":"Active service health checks","description":"Replace static delays with active health checks in CI/CD workflows to ensure service readiness. Instead of using fixed sleep times, implement polling mechanisms that verify service health endpoints. This improves workflow reliability and reduces false negatives.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2025-07-05","comments":3,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-active-service-health-checks.md"},{"slug":"pytorch-thread-context-management","title":"Thread context management","description":"Always explicitly set required thread context and state rather than assuming inheritance from parent threads or other concurrent processes. In multithreaded and distributed environments, assumptions about shared state can lead to subtle bugs, race conditions, and incorrect behavior.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Concurrency","language":"Python","updated":"2025-07-05","comments":3,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-thread-context-management.md"},{"slug":"vllm-secure-before-deployment","title":"Secure before deployment","description":"Remove or secure development-specific code before deploying to production environments. Development artifacts like debug print statements, weak validation methods, and development endpoints can introduce significant security vulnerabilities.","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Security","language":"Python","updated":"2025-07-05","comments":3,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-secure-before-deployment.md"},{"slug":"router-optimize-file-based-routing","title":"optimize file-based routing","description":"Implement lazy loading patterns and strategic code-splitting in file-based routing systems to improve performance and reduce unnecessary processing. Root routes should never be code-split since they're always needed, while other routes can benefit from lazy instantiation to avoid parsing route trees when not required.","repository":"TanStack/router","domain":"app-frameworks","topic":"Next","language":"TypeScript","updated":"2025-07-05","comments":2,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-optimize-file-based-routing.md"},{"slug":"ghostty-descriptive-consistent-naming","title":"Descriptive consistent naming","description":"Use descriptive, consistent naming that follows language and platform conventions. Choose names that clearly communicate purpose and context, and maintain consistency across similar elements.","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Naming Conventions","language":"Other","updated":"2025-07-04","comments":13,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-descriptive-consistent-naming.md"},{"slug":"electron-use-extensible-parameter-objects","title":"Use extensible parameter objects","description":"When designing APIs that may need additional parameters in the future, use objects instead of individual parameters to enable extension without breaking changes. This approach allows new properties to be added while maintaining backward compatibility.","repository":"electron/electron","domain":"devtools","topic":"API","language":"Markdown","updated":"2025-07-04","comments":12,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-use-extensible-parameter-objects.md"},{"slug":"electron-use-optional-types-safely","title":"use optional types safely","description":"When functions may not return valid values, use `std::optional` or `absl::optional` instead of raw types that could represent invalid states. Always check the validity of optional values before accessing them to prevent null pointer dereferences and invalid value usage.","repository":"electron/electron","domain":"devtools","topic":"Null Handling","language":"Other","updated":"2025-07-04","comments":8,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-use-optional-types-safely.md"},{"slug":"continue-clean-code-formatting-rules","title":"Clean code formatting rules","description":"Maintain consistent and clean code formatting to improve readability and maintainability. Follow these guidelines: 1. Use correct syntax for utility classes:","repository":"continuedev/continue","domain":"ai-agents","topic":"Code Style","language":"TSX","updated":"2025-07-04","comments":7,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-clean-code-formatting-rules.md"},{"slug":"grafana-safe-concurrent-programming","title":"Safe concurrent programming","description":"When working with concurrent code, carefully manage shared resources and synchronization to prevent race conditions, deadlocks, and resource leaks: 1. **Protect shared data**: Always synchronize access to data accessed by multiple goroutines using appropriate primitives like mutexes or channels.","repository":"grafana/grafana","domain":"observability","topic":"Concurrency","language":"Go","updated":"2025-07-04","comments":7,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-safe-concurrent-programming.md"},{"slug":"brew-follow-established-naming-patterns","title":"Follow established naming patterns","description":"Names should be descriptive and consistent with existing patterns in the codebase. This applies to methods, variables, and DSL elements: 1. Follow existing naming patterns for similar concepts:","repository":"Homebrew/brew","domain":"devtools","topic":"Naming Conventions","language":"Ruby","updated":"2025-07-04","comments":6,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-follow-established-naming-patterns.md"},{"slug":"vite-ensure-documentation-accuracy","title":"Ensure documentation accuracy","description":"Documentation must precisely reflect the current codebase implementation. When documenting features, options, or APIs: 1. Validate that all examples match the actual implementation. For instance, if template names or file formats change, update all references in the documentation:","repository":"vitejs/vite","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2025-07-04","comments":6,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-ensure-documentation-accuracy.md"},{"slug":"airflow-maintain-code-consistency","title":"Maintain code consistency","description":"Ensure consistency throughout the codebase by following established patterns for both UI components and code structure. Specifically: 1. Use semantic color names and variables rather than hardcoded values to maintain theme consistency and facilitate future changes:","repository":"apache/airflow","domain":"orchestration","topic":"Code Style","language":"TSX","updated":"2025-07-04","comments":5,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-maintain-code-consistency.md"},{"slug":"airflow-use-system-configuration-defaults","title":"Use system configuration defaults","description":"Always use the configuration system's default values instead of hardcoding defaults in the code. This ensures consistency across the application and makes configuration management more maintainable.","repository":"apache/airflow","domain":"orchestration","topic":"Configurations","language":"Python","updated":"2025-07-04","comments":5,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-use-system-configuration-defaults.md"},{"slug":"argo-cd-check-nil-before-access","title":"Check nil before access","description":"Always verify that pointers and nested struct fields are not nil before accessing their members to prevent runtime panics. This is especially important when dealing with optional configuration fields, middleware components, and API responses where certain fields may not be initialized.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Null Handling","language":"Go","updated":"2025-07-04","comments":5,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-check-nil-before-access.md"},{"slug":"argo-cd-use-descriptive-constants","title":"Use descriptive constants","description":"Replace hardcoded strings, numbers, and magic values with well-named constants that clearly describe their purpose and meaning. This improves code readability, maintainability, and reduces the risk of typos when the same values are used in multiple places.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Naming Conventions","language":"TSX","updated":"2025-07-04","comments":5,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-use-descriptive-constants.md"},{"slug":"bun-descriptive-identifier-names","title":"Descriptive identifier names","description":"Choose clear, consistent, and accurate identifiers that precisely reflect behavior and follow established patterns. This applies to function names, method names, variable types, and enum values.","repository":"oven-sh/bun","domain":"runtimes","topic":"Naming Conventions","language":"C++","updated":"2025-07-04","comments":5,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-descriptive-identifier-names.md"},{"slug":"electron-use-descriptive-consistent-names","title":"Use descriptive consistent names","description":"Choose names that are both semantically accurate and consistent with established patterns. Names should clearly convey their purpose, data type, and behavior while following existing conventions in the codebase and upstream dependencies.","repository":"electron/electron","domain":"devtools","topic":"Naming Conventions","language":"Other","updated":"2025-07-04","comments":5,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-use-descriptive-consistent-names.md"},{"slug":"grafana-function-design-principles","title":"Function design principles","description":"Design functions for maximum reusability, clarity, and maintainability. Follow these principles: 1. **Pass complete objects instead of extracted properties**: When a function needs to extract multiple properties from an object, pass the whole object rather than individual properties. This makes the function more composable and easier to reuse in different...","repository":"grafana/grafana","domain":"observability","topic":"Code Style","language":"TypeScript","updated":"2025-07-04","comments":5,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-function-design-principles.md"},{"slug":"inbox-zero-names-reflect-semantic-purpose","title":"Names reflect semantic purpose","description":"Choose names that reflect the semantic purpose rather than implementation details or temporal characteristics. Names should be consistent across the codebase and accurately represent their usage.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-04","comments":5,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-names-reflect-semantic-purpose.md"},{"slug":"neon-use-descriptive-identifiers","title":"Use descriptive identifiers","description":"Choose clear, meaningful names for variables, parameters, and constants that convey their purpose without requiring additional documentation or context.","repository":"neondatabase/neon","domain":"data-systems","topic":"Naming Conventions","language":"Python","updated":"2025-07-04","comments":5,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-use-descriptive-identifiers.md"},{"slug":"opentelemetry-python-configuration-source-precedence","title":"Configuration source precedence","description":"Define and document a clear precedence order when configurations come from multiple sources (code parameters, environment variables, defaults). Typically, explicit parameters should take precedence over environment variables, which should take precedence over defaults.","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Configurations","language":"Python","updated":"2025-07-04","comments":5,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-configuration-source-precedence.md"},{"slug":"uv-secure-configuration-defaults","title":"Secure configuration defaults","description":"Establish secure default configurations in project metadata files to prevent accidental publishing and ensure proper version constraints. This is particularly important for private packages and build system configurations.","repository":"astral-sh/uv","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2025-07-04","comments":5,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-secure-configuration-defaults.md"},{"slug":"zed-scope-dependencies-appropriately","title":"Scope dependencies appropriately","description":"Configure dependencies with their minimum necessary scope to maintain clean architecture and improve build times. Key practices: 1. **Test-only dependencies should be dev-dependencies**","repository":"zed-industries/zed","domain":"devtools","topic":"Configurations","language":"Toml","updated":"2025-07-04","comments":5,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-scope-dependencies-appropriately.md"},{"slug":"airflow-ensure-deterministic-queries","title":"Ensure deterministic queries","description":"Build SQLAlchemy queries that are both efficient and deterministic to prevent unpredictable results and improve performance. When writing database queries:","repository":"apache/airflow","domain":"orchestration","topic":"Database","language":"Python","updated":"2025-07-04","comments":4,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-ensure-deterministic-queries.md"},{"slug":"argo-cd-design-extensible-apis","title":"design extensible APIs","description":"When designing APIs, prioritize extensibility and backwards compatibility over convenience. Avoid modifying existing response types or interfaces in ways that could break existing clients. Instead, create new dedicated types, methods, or optional parameters.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"API","language":"Go","updated":"2025-07-04","comments":4,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-design-extensible-apis.md"},{"slug":"grafana-component-architecture-principles","title":"Component architecture principles","description":"Extract logic that doesn't render JSX into custom hooks instead of components. Components that don't return markup create unnecessary abstraction layers and can lead to harder-to-follow data flows.","repository":"grafana/grafana","domain":"observability","topic":"React","language":"TSX","updated":"2025-07-04","comments":4,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-component-architecture-principles.md"},{"slug":"inbox-zero-cache-invariant-computations","title":"Cache invariant computations","description":"Avoid repeatedly computing values that don't change frequently. For data structures, maps, or validation schemas used in hot paths, initialize them once at module scope rather than recreating them on every function call.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Performance Optimization","language":"TypeScript","updated":"2025-07-04","comments":4,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-cache-invariant-computations.md"},{"slug":"mono-dependency-management-practices","title":"dependency management practices","description":"Ensure comprehensive dependency management in package.json files by following these practices: 1. **Evaluate necessity**: Before adding dependencies, check if native Node.js APIs provide the functionality. For example, use `fs.mkdtemp(path.join(os.tmpdir(), ''prefix''))` instead of adding a temporary file library.","repository":"rocicorp/mono","domain":"data-systems","topic":"Configurations","language":"Json","updated":"2025-07-04","comments":4,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-dependency-management-practices.md"},{"slug":"playwright-avoid-redundant-operations","title":"Avoid redundant operations","description":"Identify and eliminate duplicate computations, unnecessary object creation, and redundant function calls to improve performance. This is especially critical in memory-sensitive areas and frequently executed code paths.","repository":"microsoft/playwright","domain":"devtools","topic":"Performance Optimization","language":"TypeScript","updated":"2025-07-04","comments":4,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-avoid-redundant-operations.md"},{"slug":"terraform-choose-appropriate-api-types","title":"Choose appropriate API types","description":"Select the simplest data types that satisfy requirements when designing API signatures. Avoid using complex types (like cty.Value) when simpler types (like string, int, bool) would suffice. This improves API usability, reduces complexity, and simplifies client implementations while maintaining consistent patterns across the API.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"API","language":"Go","updated":"2025-07-04","comments":4,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-choose-appropriate-api-types.md"},{"slug":"ai-provide-actionable-examples","title":"Provide actionable examples","description":"Documentation should include concrete, executable code examples rather than vague instructions. Make your examples copy-paste ready with all necessary context and dependencies. When documenting features or APIs, show exactly how they should be used in practice.","repository":"vercel/ai","domain":"ai-agents","topic":"Documentation","language":"Other","updated":"2025-07-04","comments":3,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-provide-actionable-examples.md"},{"slug":"gemini-cli-remove-unsupported-runtime-versions","title":"Remove unsupported runtime versions","description":"When maintaining CI/CD pipelines, regularly audit and remove runtime versions that are no longer supported by your project's dependencies or cause build failures. This prevents pipeline instability and reduces maintenance overhead.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"CI/CD","language":"Yaml","updated":"2025-07-04","comments":3,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-remove-unsupported-runtime-versions.md"},{"slug":"grafana-proper-mocking-techniques","title":"Proper mocking techniques","description":"Use appropriate mocking approaches for different dependencies in tests to ensure accurate test results and prevent false positives. Different types of dependencies require different mocking strategies:","repository":"grafana/grafana","domain":"observability","topic":"Testing","language":"TSX","updated":"2025-07-04","comments":3,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-proper-mocking-techniques.md"},{"slug":"kafka-add-proactive-null-checks","title":"Add proactive null checks","description":"Always add null checks before accessing methods or properties on objects that can potentially be null, especially when dealing with Java APIs or exceptional conditions like RejectedExecutionException.","repository":"apache/kafka","domain":"data-systems","topic":"Null Handling","language":"Other","updated":"2025-07-04","comments":3,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-add-proactive-null-checks.md"},{"slug":"pytorch-structure-for-readability","title":"Structure for readability","description":"Structure code to maximize readability by reducing unnecessary complexity. Use early returns to minimize nesting levels, move invariant conditions outside of loops, and replace magic numbers with named constants.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Code Style","language":"Python","updated":"2025-07-04","comments":3,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-structure-for-readability.md"},{"slug":"ghostty-format-for-readability","title":"Format for readability","description":"Documentation should be formatted to optimize readability and information retention. Apply these principles to make documentation more user-friendly:","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2025-07-04","comments":2,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-format-for-readability.md"},{"slug":"grafana-document-translatable-ui-text","title":"Document translatable UI text","description":"All user-facing text in UI components should be properly documented for translation using the application's internationalization (i18n) framework. This ensures that the application can be easily localized for different regions and improves maintainability.","repository":"grafana/grafana","domain":"observability","topic":"Documentation","language":"TSX","updated":"2025-07-04","comments":2,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-document-translatable-ui-text.md"},{"slug":"grafana-object-parameters-for-readability","title":"Object parameters for readability","description":"When a function has 3 or more parameters, use object destructuring instead of positional arguments. This improves code readability by making parameter names explicit at call sites and making the function signature more maintainable as parameters are added or modified.","repository":"grafana/grafana","domain":"observability","topic":"Code Style","language":"TSX","updated":"2025-07-04","comments":2,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-object-parameters-for-readability.md"},{"slug":"langfuse-consistent-descriptive-naming","title":"Consistent descriptive naming","description":"Use naming conventions that are both consistent with existing patterns and descriptively clear about purpose. Follow established patterns in the codebase for similar entities while ensuring names are specific and self-explanatory.","repository":"langfuse/langfuse","domain":"observability","topic":"Naming Conventions","language":"Prisma","updated":"2025-07-04","comments":2,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-consistent-descriptive-naming.md"},{"slug":"neovim-api-extensibility-parameters","title":"API extensibility parameters","description":"Always design API functions with extensible parameter structures to accommodate future feature expansion without breaking changes. Use `Dict opts` parameters instead of individual boolean or primitive parameters, unless you are absolutely certain no expansion will ever be needed (which is usually wrong).","repository":"neovim/neovim","domain":"devtools","topic":"API","language":"C","updated":"2025-07-04","comments":2,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-api-extensibility-parameters.md"},{"slug":"pytorch-hardware-acceleration-considerations","title":"Hardware acceleration considerations","description":"When implementing hardware-accelerated operations for AI models, ensure support for the latest architectures while considering determinism requirements.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"AI","language":"Other","updated":"2025-07-04","comments":2,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-hardware-acceleration-considerations.md"},{"slug":"zed-proper-documentation-linking","title":"Proper documentation linking","description":"Documentation should use appropriate linking strategies to ensure content remains accessible and navigable across all deployment environments: 1. **Use absolute URLs for repository links**: When referencing files within the codebase (like READMEs or source files), always use absolute GitHub URLs instead of relative paths that may break when documentation...","repository":"zed-industries/zed","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2025-07-04","comments":2,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-proper-documentation-linking.md"},{"slug":"bun-secure-credentials-handling","title":"Secure credentials handling","description":"When handling credentials or secrets in code, avoid passing them directly through command substitution or template literals in shell commands, as this can lead to security vulnerabilities. Instead, write sensitive data to temporary files with restricted permissions, use those files for operations requiring credentials, and ensure proper cleanup afterward.","repository":"oven-sh/bun","domain":"runtimes","topic":"Security","language":"TypeScript","updated":"2025-07-04","comments":1,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-secure-credentials-handling.md"},{"slug":"ghostty-secure-temporary-files","title":"Secure temporary files","description":"Always use `mktemp` instead of manually constructing temporary file paths with random values. Manually constructed paths with elements like `$RANDOM` or timestamp values can be vulnerable to race conditions, predictability issues, and permission problems, potentially leading to security exploits.","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Security","language":"Other","updated":"2025-07-04","comments":1,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-secure-temporary-files.md"},{"slug":"netty-optimize-allocation-hotspots","title":"Optimize allocation hotspots","description":"Identify and optimize object allocation in performance-critical paths by applying appropriate allocation strategies based on usage patterns. For frequently accessed objects, consider reusing instances rather than creating new ones. For short-lived objects in hot code paths, evaluate whether the JIT can optimize allocations away or if explicit object...","repository":"netty/netty","domain":"runtimes","topic":"Performance Optimization","language":"Java","updated":"2025-07-03","comments":17,"stars":34227,"raw":"https://awesomereviewers.com/raw/netty-optimize-allocation-hotspots.md"},{"slug":"inbox-zero-sanitize-all-inputs","title":"Sanitize all inputs","description":"Properly sanitize or escape all user-provided inputs before using them in sensitive contexts to prevent injection attacks. This applies to multiple contexts:","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Security","language":"TypeScript","updated":"2025-07-03","comments":11,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-sanitize-all-inputs.md"},{"slug":"tokio-release-locks-before-waking","title":"Release locks before waking","description":"In concurrent systems, it's critical to release locks before performing operations that might trigger reentrancy or block the current thread, such as waking waiters. Holding locks while waking tasks can lead to deadlocks if the awakened code attempts to acquire the same lock.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Concurrency","language":"Rust","updated":"2025-07-03","comments":9,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-release-locks-before-waking.md"},{"slug":"neon-clear-consistent-identifier-names","title":"Clear consistent identifier names","description":"Choose clear, consistent, and non-redundant names for identifiers across the codebase. Follow these guidelines: 1. Use specific, descriptive names that clearly indicate purpose:","repository":"neondatabase/neon","domain":"data-systems","topic":"Naming Conventions","language":"Rust","updated":"2025-07-03","comments":7,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-clear-consistent-identifier-names.md"},{"slug":"quarkus-meaningful-error-communication","title":"Meaningful error communication","description":"Error handling should be designed to provide clear, actionable information to developers while avoiding redundancy. Follow these practices: 1. **Don''t duplicate error reporting** - If you''re throwing an exception, don''t also log the same error. This creates noise and confusion.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Error Handling","language":"Java","updated":"2025-07-03","comments":7,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-meaningful-error-communication.md"},{"slug":"airflow-standardize-api-parameter-handling","title":"Standardize API parameter handling","description":"Use consistent parameter handling patterns across API endpoints to ensure maintainability and predictable behavior. Follow these guidelines: 1. Use FastAPI''s native parameter handling for lists:","repository":"apache/airflow","domain":"orchestration","topic":"API","language":"Python","updated":"2025-07-03","comments":6,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-standardize-api-parameter-handling.md"},{"slug":"grafana-explicit-null-validation","title":"Explicit null validation","description":"Always validate objects for null/nil before accessing their properties, and establish consistent patterns for handling null values throughout the codebase. This prevents nil pointer dereferences and ensures predictable behavior.","repository":"grafana/grafana","domain":"observability","topic":"Null Handling","language":"Go","updated":"2025-07-03","comments":6,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-explicit-null-validation.md"},{"slug":"prisma-manage-output-streams-carefully","title":"Manage output streams carefully","description":"Always consider the destination and lifecycle of output streams to prevent protocol interference, data loss, and unexpected behavior. Choose stdout for application output and stderr for debugging/logging. Avoid accidentally closing streams and be mindful of output pollution in protocol-sensitive contexts.","repository":"prisma/prisma","domain":"data-systems","topic":"Logging","language":"TypeScript","updated":"2025-07-03","comments":6,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-manage-output-streams-carefully.md"},{"slug":"ruff-handle-nulls-with-option","title":"Handle nulls with Option","description":"Use Rust's Option type and its methods effectively to handle nullable values. This improves code clarity and safety by making null cases explicit and leveraging the type system.","repository":"astral-sh/ruff","domain":"devtools","topic":"Null Handling","language":"Rust","updated":"2025-07-03","comments":6,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-handle-nulls-with-option.md"},{"slug":"airflow-documentation-best-practices","title":"Documentation best practices","description":"Documentation should follow established best practices to ensure clarity, consistency, and usefulness: 1. **Use proper link types**: Use relative links for internal resources and absolute HTTP links only for external resources.","repository":"apache/airflow","domain":"orchestration","topic":"Documentation","language":"Other","updated":"2025-07-03","comments":5,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-documentation-best-practices.md"},{"slug":"continue-decouple-tests-from-implementation","title":"Decouple tests from implementation","description":"Tests tightly coupled to implementation details break easily when the implementation changes, creating maintenance burden and reducing test reliability. Write tests that validate behavior rather than specific implementation details.","repository":"continuedev/continue","domain":"ai-agents","topic":"Testing","language":"TypeScript","updated":"2025-07-03","comments":5,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-decouple-tests-from-implementation.md"},{"slug":"grafana-proper-shell-quoting","title":"Proper shell quoting","description":"Always use proper quoting in shell scripts (especially GitHub Actions workflows) to prevent word splitting, globbing, and ensure correct variable expansion:","repository":"grafana/grafana","domain":"observability","topic":"Code Style","language":"Yaml","updated":"2025-07-03","comments":5,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-proper-shell-quoting.md"},{"slug":"playwright-api-parameter-clarity","title":"API parameter clarity","description":"Design API parameters to be self-documenting and minimize cognitive overhead. Avoid boolean parameters in favor of descriptive enums or string literals, leverage type inference where possible, and prefer clean parameter passing over state mutation patterns.","repository":"microsoft/playwright","domain":"devtools","topic":"API","language":"TypeScript","updated":"2025-07-03","comments":5,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-api-parameter-clarity.md"},{"slug":"ruff-consider-algorithmic-complexity-tradeoffs","title":"Consider algorithmic complexity tradeoffs","description":"When implementing algorithms or data structures, carefully evaluate the tradeoffs between computational complexity, memory usage, and code maintainability. Consider:","repository":"astral-sh/ruff","domain":"devtools","topic":"Algorithms","language":"Rust","updated":"2025-07-03","comments":5,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-consider-algorithmic-complexity-tradeoffs.md"},{"slug":"ruff-document-component-behavior-comprehensively","title":"Document component behavior comprehensively","description":"Documentation should clearly explain the purpose, behavior, and relationships between code components using accessible terminology. This helps other developers understand the code without needing to dig into implementations.","repository":"astral-sh/ruff","domain":"devtools","topic":"Documentation","language":"Rust","updated":"2025-07-03","comments":5,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-document-component-behavior-comprehensively.md"},{"slug":"ruff-profile-allocations-before-optimization","title":"Profile allocations before optimization","description":"Before implementing data structures or algorithms, analyze allocation patterns and optimize for common cases. Key strategies: 1. Use fixed-size arrays for known small collections:","repository":"astral-sh/ruff","domain":"devtools","topic":"Performance Optimization","language":"Rust","updated":"2025-07-03","comments":5,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-profile-allocations-before-optimization.md"},{"slug":"uv-optimize-cicd-commands","title":"Optimize CI/CD commands","description":"Design CI/CD workflows to be efficient, consistent, and purposeful across all environments. When writing or modifying pipeline scripts: 1. Batch related operations to minimize redundant commands and improve performance","repository":"astral-sh/uv","domain":"devtools","topic":"CI/CD","language":"Yaml","updated":"2025-07-03","comments":5,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-optimize-cicd-commands.md"},{"slug":"vllm-remove-unnecessary-code-elements","title":"Remove unnecessary code elements","description":"Keep code clean and maintainable by removing unnecessary elements that add complexity without value: 1. Remove unused header includes that increase compile times","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Code Style","language":"CUDA","updated":"2025-07-03","comments":5,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-remove-unnecessary-code-elements.md"},{"slug":"zed-choose-domain-specific-semantic-names","title":"Choose domain-specific semantic names","description":"Names should clearly reflect their domain-specific meaning and purpose, avoiding generic or ambiguous terms. This applies to variables, methods, classes, and other identifiers. When naming, consider:","repository":"zed-industries/zed","domain":"devtools","topic":"Naming Conventions","language":"Rust","updated":"2025-07-03","comments":5,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-choose-domain-specific-semantic-names.md"},{"slug":"airflow-document-public-api-boundaries","title":"Document public API boundaries","description":"Clearly define and document the boundaries between public and internal APIs to guide developers on proper interface usage. Use dedicated namespaces (like the 'sdk' namespace) to distinguish public interfaces from internal implementations. Ensure all public interfaces have comprehensive documentation that accurately reflects behavior, with consistent...","repository":"apache/airflow","domain":"orchestration","topic":"API","language":"Other","updated":"2025-07-03","comments":4,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-document-public-api-boundaries.md"},{"slug":"ant-design-deprecated-api-documentation","title":"Deprecated API documentation","description":"When documenting deprecated APIs, follow consistent practices to provide clear guidance to developers while maintaining usability. Use strikethrough formatting (~~propertyName~~) to visually indicate deprecation without completely removing the documentation. Always include replacement guidance using phrases like \"请使用 `xxx` 替换\" or \"Please use `xxx` instead\"...","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-07-03","comments":4,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-deprecated-api-documentation.md"},{"slug":"grafana-prefer-null-safe-access","title":"Prefer null-safe access","description":"Always use null-safe access patterns when dealing with potentially undefined values to prevent runtime errors and improve code robustness. This includes:","repository":"grafana/grafana","domain":"observability","topic":"Null Handling","language":"TypeScript","updated":"2025-07-03","comments":4,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-prefer-null-safe-access.md"},{"slug":"material-ui-document-compatibility-boundaries","title":"Document compatibility boundaries","description":"Clearly communicate your API''s compatibility guarantees and limitations. When designing APIs, explicitly indicate what usage patterns are supported vs. which are experimental or might change. For functions that have multiple calling patterns, document which are stable and which might be deprecated:","repository":"mui/material-ui","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2025-07-03","comments":4,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-document-compatibility-boundaries.md"},{"slug":"neon-pin-github-action-versions","title":"Pin GitHub action versions","description":"Always pin GitHub Actions to specific commit hashes instead of using major/minor version tags (like @v4). This ensures reproducible builds and prevents supply chain attacks through compromised action versions.","repository":"neondatabase/neon","domain":"data-systems","topic":"CI/CD","language":"Yaml","updated":"2025-07-03","comments":4,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-pin-github-action-versions.md"},{"slug":"node-descriptive-function-names","title":"Descriptive function names","description":"Function and method names should precisely describe their purpose and behavior. Choose names that explicitly communicate what the function does, including any special conditions or behaviors.","repository":"nodejs/node","domain":"runtimes","topic":"Naming Conventions","language":"JavaScript","updated":"2025-07-03","comments":4,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-descriptive-function-names.md"},{"slug":"prometheus-ensure-mathematical-correctness","title":"ensure mathematical correctness","description":"When implementing or testing algorithms, ensure mathematical relationships and constraints are maintained throughout the computation. Test data should have plausible values that reflect real-world mathematical relationships, and algorithmic edge cases should be carefully handled to prevent mathematical inconsistencies.","repository":"prometheus/prometheus","domain":"observability","topic":"Algorithms","language":"Other","updated":"2025-07-03","comments":4,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-ensure-mathematical-correctness.md"},{"slug":"ruff-leverage-existing-api-utilities","title":"Leverage existing API utilities","description":"When implementing or consuming APIs, always prefer using existing utility methods and abstractions over manual implementations. This reduces code duplication, improves consistency, and helps avoid subtle bugs in conversion logic or interface handling.","repository":"astral-sh/ruff","domain":"devtools","topic":"API","language":"Rust","updated":"2025-07-03","comments":4,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-leverage-existing-api-utilities.md"},{"slug":"ruff-maintain-focused-module-structure","title":"Maintain focused module structure","description":"Keep modules focused and well-organized by grouping related functionality together and splitting large files into logical submodules. Each file should have a clear, single responsibility. When a file grows too large or handles multiple concerns, consider breaking it into smaller, more focused modules.","repository":"astral-sh/ruff","domain":"devtools","topic":"Code Style","language":"Rust","updated":"2025-07-03","comments":4,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-maintain-focused-module-structure.md"},{"slug":"supabase-protect-sensitive-api-keys","title":"Protect sensitive API keys","description":"Never expose keys with elevated privileges (such as `service_role` or secret keys) in client-side code. These keys can bypass Row Level Security (RLS) and provide unrestricted access to your data.","repository":"supabase/supabase","domain":"data-systems","topic":"Security","language":"Other","updated":"2025-07-03","comments":4,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-protect-sensitive-api-keys.md"},{"slug":"temporal-consistent-naming-patterns","title":"Consistent naming patterns","description":"Maintain consistent naming patterns across related components and services. When implementing equivalent functionality in different services, use identical field/method names. When naming related fields that form logical groupings, either:","repository":"temporalio/temporal","domain":"orchestration","topic":"Naming Conventions","language":"Other","updated":"2025-07-03","comments":4,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-consistent-naming-patterns.md"},{"slug":"workers-sdk-simplify-conditional-logic","title":"Simplify conditional logic","description":"Prefer concise conditional expressions over verbose nested conditions and unnecessary boolean variables. This improves readability and reduces cognitive overhead.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Code Style","language":"TypeScript","updated":"2025-07-03","comments":4,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-simplify-conditional-logic.md"},{"slug":"zed-contextualize-dont-panic","title":"Contextualize don't panic","description":"Always provide meaningful context for errors and avoid code that can panic in production. Use `.context()` or `.with_context()` to add rich error information, making debugging easier. Replace `.unwrap()` and `.expect()` with proper error handling mechanisms like error propagation or logging.","repository":"zed-industries/zed","domain":"devtools","topic":"Error Handling","language":"Rust","updated":"2025-07-03","comments":4,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-contextualize-dont-panic.md"},{"slug":"airflow-enforce-authentication-boundaries","title":"Enforce authentication boundaries","description":"Implement strict authentication boundaries and access controls to prevent security vulnerabilities: 1. When multiple authentication methods are supported, ensure they are mutually exclusive to prevent confusion about which method is active. Add validation code that raises explicit exceptions when conflicting credentials are provided.","repository":"apache/airflow","domain":"orchestration","topic":"Security","language":"Other","updated":"2025-07-03","comments":3,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-enforce-authentication-boundaries.md"},{"slug":"ant-design-standardize-deprecation-documentation","title":"Standardize deprecation documentation","description":"When marking APIs, components, or features as deprecated, use consistent JSDoc @deprecated tags with clear alternative guidance. This ensures smooth migration paths for users and maintains backward compatibility during version transitions.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Documentation","language":"TSX","updated":"2025-07-03","comments":3,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-standardize-deprecation-documentation.md"},{"slug":"deno-control-cache-lifecycle","title":"Control cache lifecycle","description":"Design cache systems so that higher-level components control when cache entries are invalidated or cleaned up, rather than having cache operations happen automatically at lower levels. This allows callers to make informed decisions about cache lifecycle based on their broader context and requirements.","repository":"denoland/deno","domain":"runtimes","topic":"Caching","language":"Rust","updated":"2025-07-03","comments":3,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-control-cache-lifecycle.md"},{"slug":"deno-explain-non-obvious-decisions","title":"Explain non-obvious decisions","description":"When code contains non-obvious parameter choices, conditional logic, or unexpected implementation changes, add comments explaining the reasoning behind these decisions. This helps other developers understand the context and prevents confusion during code reviews.","repository":"denoland/deno","domain":"runtimes","topic":"Documentation","language":"Rust","updated":"2025-07-03","comments":3,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-explain-non-obvious-decisions.md"},{"slug":"langflow-document-security-implications-clearly","title":"Document security implications clearly","description":"When documenting features that involve sensitive data, authentication, or privileged operations, explicitly state the security implications and use appropriate warning levels to ensure users understand potential risks.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Security","language":"Markdown","updated":"2025-07-03","comments":3,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-document-security-implications-clearly.md"},{"slug":"langfuse-validate-environment-variables-strictly","title":"Validate environment variables strictly","description":"Implement comprehensive validation for environment variables using a schema validation library (e.g., Zod). Include proper typing, conditional validation rules, and sensible defaults. This ensures configuration errors are caught early and prevents runtime issues.","repository":"langfuse/langfuse","domain":"observability","topic":"Configurations","language":"TypeScript","updated":"2025-07-03","comments":3,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-validate-environment-variables-strictly.md"},{"slug":"litellm-standardize-environment-versions","title":"Standardize environment versions","description":"Ensure consistent versions of languages, tools, and dependencies across all CI/CD environments (GitHub Actions, CircleCI, local development, etc.). Inconsistent versions between environments make it difficult to reproduce issues and debug failures, as seen when using \"Python 3.12 in GitHub & 3.9 elsewhere - makes it hard to figure out how to fix the broken...","repository":"BerriAI/litellm","domain":"llm-infra","topic":"CI/CD","language":"Yaml","updated":"2025-07-03","comments":3,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-standardize-environment-versions.md"},{"slug":"material-ui-maintain-configuration-accuracy","title":"Maintain configuration accuracy","description":"Regularly audit configuration files to remove unused entries and ensure all configurations accurately reflect the project's requirements and intended functionality. When modifying configuration files, carefully consider the purpose of each entry and verify that changes align with the desired behavior.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2025-07-03","comments":3,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-maintain-configuration-accuracy.md"},{"slug":"neon-avoid-flaky-tests","title":"Avoid flaky tests","description":"Tests should be designed to be deterministic and reliable to prevent\\ \\ wasted developer time and false confidence. \\n\\nTwo common causes of flakiness\\ \\ to avoid:","repository":"neondatabase/neon","domain":"data-systems","topic":"Testing","language":"Python","updated":"2025-07-03","comments":3,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-avoid-flaky-tests.md"},{"slug":"neon-optimize-data-structures","title":"Optimize data structures","description":"When implementing algorithms, prioritize data structure choices that minimize resource usage while maintaining functionality. Consider if a simpler approach with counters, efficient state tracking, or built-in functions can replace complex custom implementations.","repository":"neondatabase/neon","domain":"data-systems","topic":"Algorithms","language":"C","updated":"2025-07-03","comments":3,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-optimize-data-structures.md"},{"slug":"quarkus-descriptive-consistent-naming","title":"Descriptive consistent naming","description":"Use clear, descriptive names instead of cryptic abbreviations, and follow consistent naming patterns across your codebase. This practice enhances readability and maintainability.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Naming Conventions","language":"Other","updated":"2025-07-03","comments":3,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-descriptive-consistent-naming.md"},{"slug":"roo-code-prevent-timeout-race-conditions","title":"Prevent timeout race conditions","description":"When working with timeouts and asynchronous operations that affect shared state, clear timeouts at the beginning of event handlers or user interactions to prevent race conditions. This defensive approach ensures that competing operations (like auto-approval timers and manual user actions) don't conflict.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Concurrency","language":"TSX","updated":"2025-07-03","comments":3,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-prevent-timeout-race-conditions.md"},{"slug":"ruff-assert-exact-expectations","title":"Assert exact expectations","description":"Always assert exact expected values in tests rather than using loose assertions. When testing the presence of elements or count of items, use equality assertions (`assert_eq!`) instead of non-empty checks (`assert!(!items.is_empty())`) or inequality assertions (`assert!(items.len() >= 2)`).","repository":"astral-sh/ruff","domain":"devtools","topic":"Testing","language":"Rust","updated":"2025-07-03","comments":3,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-assert-exact-expectations.md"},{"slug":"ruff-structure-documentation-effectively","title":"Structure documentation effectively","description":"Documentation should follow a consistent structure where explanations precede code examples, preferably ending with a colon to introduce the code. When documenting special cases or complex behaviors, include links to relevant external specifications or standards. Consolidate similar documentation to avoid duplication across files.","repository":"astral-sh/ruff","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2025-07-03","comments":3,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-structure-documentation-effectively.md"},{"slug":"sentry-clear-consistent-naming-patterns","title":"Clear consistent naming patterns","description":"Use clear, consistent naming patterns for variables and event handlers. Avoid abbreviations unless they are widely understood standards. For event handlers, follow the pattern 'on' + 'action' + 'object'.","repository":"getsentry/sentry","domain":"observability","topic":"Naming Conventions","language":"TSX","updated":"2025-07-03","comments":3,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-clear-consistent-naming-patterns.md"},{"slug":"svelte-async-cleanup-safety","title":"async cleanup safety","description":"Ensure async operations include proper safety checks to prevent race conditions, memory leaks, and inconsistent state. This includes equality checks before updates, destruction status verification, and proper cleanup mechanisms.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Concurrency","language":"JavaScript","updated":"2025-07-03","comments":3,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-async-cleanup-safety.md"},{"slug":"airflow-use-proper-access-patterns","title":"Use proper access patterns","description":"Access configurations through documented abstraction layers rather than bypassing them with direct database or low-level access. For example, in Airflow, XCom operations should be performed through the Task Context using `get_current_context()` rather than directly accessing the database model:","repository":"apache/airflow","domain":"orchestration","topic":"Configurations","language":"Other","updated":"2025-07-03","comments":2,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-use-proper-access-patterns.md"},{"slug":"bun-match-api-conventions","title":"Match API conventions","description":"Ensure API implementations match established conventions and reference implementations to maintain compatibility and predictability. When implementing APIs that parallel existing systems (like Node.js APIs or REST services), follow their error codes, response formats, and naming conventions precisely.","repository":"oven-sh/bun","domain":"runtimes","topic":"API","language":"Other","updated":"2025-07-03","comments":2,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-match-api-conventions.md"},{"slug":"dspy-use-relative-documentation-links","title":"Use relative documentation links","description":"Always use relative links instead of absolute links in documentation files to enable proper broken link detection and ensure compatibility with documentation generators like MkDocs.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Documentation","language":"Markdown","updated":"2025-07-03","comments":2,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-use-relative-documentation-links.md"},{"slug":"frp-validate-security-critical-inputs","title":"Validate security-critical inputs","description":"Always implement thorough validation for user-controllable inputs that could pose security risks. Particularly: 1. **Path validation**: Protect against path traversal attacks by rejecting paths containing directory traversal sequences (`..`) or by resolving paths against a safe base directory.","repository":"fatedier/frp","domain":"cloud-infra","topic":"Security","language":"Go","updated":"2025-07-03","comments":2,"stars":95938,"raw":"https://awesomereviewers.com/raw/frp-validate-security-critical-inputs.md"},{"slug":"grafana-balance-flexibility-with-simplicity","title":"Balance flexibility with simplicity","description":"When designing component APIs, strive to find the optimal balance between providing flexible configuration options and maintaining simplicity. Start with essential functionality before adding complex features that may complicate the API surface.","repository":"grafana/grafana","domain":"observability","topic":"API","language":"TSX","updated":"2025-07-03","comments":2,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-balance-flexibility-with-simplicity.md"},{"slug":"grafana-sort-with-clarity","title":"Sort with clarity","description":"Ensure sorting functions are named to accurately reflect their behavior and implement consistent sorting approaches throughout the codebase. When implementing sort operations:","repository":"grafana/grafana","domain":"observability","topic":"Algorithms","language":"Go","updated":"2025-07-03","comments":2,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-sort-with-clarity.md"},{"slug":"grafana-stable-test-assertions","title":"Stable test assertions","description":"Write tests that focus on behavior rather than implementation details to create more stable and maintainable test suites. Avoid using arbitrary timeouts and assertions that frequently break with implementation changes.","repository":"grafana/grafana","domain":"observability","topic":"Testing","language":"TypeScript","updated":"2025-07-03","comments":2,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-stable-test-assertions.md"},{"slug":"inbox-zero-consistent-code-organization","title":"Consistent code organization","description":"Maintain consistent patterns when organizing code elements within schema files. Place standard fields (like IDs and timestamps) first in all models to establish a predictable structure. Group similar elements together and position enum definitions at the bottom of schema files.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Code Style","language":"Prisma","updated":"2025-07-03","comments":2,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-consistent-code-organization.md"},{"slug":"kafka-comprehensive-test-assertions","title":"comprehensive test assertions","description":"Write test assertions that are both comprehensive and maintainable. Ensure all relevant fields and behaviors are validated, while using generic matchers where appropriate to reduce brittleness.","repository":"apache/kafka","domain":"data-systems","topic":"Testing","language":"Other","updated":"2025-07-03","comments":2,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-comprehensive-test-assertions.md"},{"slug":"langflow-standardize-naming-patterns-consistently","title":"Standardize naming patterns consistently","description":"Establish and follow consistent naming conventions for similar types of elements throughout the codebase and documentation. When multiple instances of the same type of element exist, ensure they follow the same naming pattern to avoid confusion and improve maintainability.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Naming Conventions","language":"Markdown","updated":"2025-07-03","comments":2,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-standardize-naming-patterns-consistently.md"},{"slug":"pytorch-actionable-error-messages","title":"Actionable error messages","description":"When writing error messages in PyTorch code, include not only what went wrong but also clear guidance on how to fix the issue. This helps users quickly understand and resolve problems without digging through documentation.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Pytorch","language":"C++","updated":"2025-07-03","comments":2,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-actionable-error-messages.md"},{"slug":"pytorch-descriptive-unambiguous-names","title":"Descriptive unambiguous names","description":"Always use descriptive variable names that clearly indicate their purpose without requiring readers to check call sites or implementation details. Avoid single-letter variables like `t` or vague abbreviations, especially in public interfaces and open-source code. Additionally, ensure clear distinction between similarly named variables, particularly when...","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Naming Conventions","language":"C++","updated":"2025-07-03","comments":2,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-descriptive-unambiguous-names.md"},{"slug":"vllm-match-reference-names","title":"Match reference names","description":"Ensure that filenames and paths referenced in scripts, commands, or configuration files exactly match the actual names of the files they reference. Name mismatches between references and actual files can cause commands to fail during execution.","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Naming Conventions","language":"Other","updated":"2025-07-03","comments":2,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-match-reference-names.md"},{"slug":"zed-minimize-credential-exposure-lifetime","title":"Minimize credential exposure lifetime","description":"Credentials and secrets should never be stored persistently in memory or written to files. Instead, use ephemeral patterns that limit the lifetime of sensitive data:","repository":"zed-industries/zed","domain":"devtools","topic":"Security","language":"Rust","updated":"2025-07-03","comments":2,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-minimize-credential-exposure-lifetime.md"},{"slug":"elasticsearch-extract-for-clarity","title":"Extract for clarity","description":"Extract complex or reused logic into focused, well-named methods with single responsibilities. This improves code readability, testability, and maintainability while reducing duplication. When refactoring:","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Code Style","language":"Java","updated":"2025-07-02","comments":16,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-extract-for-clarity.md"},{"slug":"runtime-optimize-for-readability","title":"Optimize for readability","description":"Write code that clearly communicates intent by using appropriate naming and formatting techniques. Improve readability by: 1. Replacing magic numbers and string literals with named constants:","repository":"dotnet/runtime","domain":"runtimes","topic":"Code Style","language":"C#","updated":"2025-07-02","comments":11,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-optimize-for-readability.md"},{"slug":"nuxt-configuration-resolution-patterns","title":"configuration resolution patterns","description":"When defining configuration schemas, use consistent patterns for safe property access, async resolution, and default value handling. Always use optional chaining with fallback values for nested configuration properties, leverage `$resolve` for complex async configuration logic, and ensure proper backwards compatibility.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2025-07-02","comments":10,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-configuration-resolution-patterns.md"},{"slug":"elasticsearch-name-reflects-meaning","title":"Name reflects meaning","description":"Choose names that clearly communicate the intent, behavior, and semantics of code elements. Names should be accurate, consistent, and follow established patterns:","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Naming Conventions","language":"Java","updated":"2025-07-02","comments":9,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-name-reflects-meaning.md"},{"slug":"runtime-specific-exceptions-with-context","title":"Specific exceptions with context","description":"Always throw the most specific exception type appropriate for the error condition and include contextual information in the error message. This helps developers quickly identify and fix issues.","repository":"dotnet/runtime","domain":"runtimes","topic":"Error Handling","language":"C#","updated":"2025-07-02","comments":9,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-specific-exceptions-with-context.md"},{"slug":"azure-sdk-for-net-design-stable-apis","title":"Design stable APIs","description":"When creating or modifying APIs, carefully consider what becomes part of your public API surface to ensure backward compatibility and consistent developer experience.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"API","language":"Markdown","updated":"2025-07-02","comments":7,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-design-stable-apis.md"},{"slug":"bun-validate-nullability-explicitly","title":"Validate nullability explicitly","description":"Always validate null or undefined values before using them to prevent crashes and undefined behavior. When implementing null-handling code, consider these principles:","repository":"oven-sh/bun","domain":"runtimes","topic":"Null Handling","language":"Other","updated":"2025-07-02","comments":7,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-validate-nullability-explicitly.md"},{"slug":"uv-structure-for-readability","title":"Structure for readability","description":"Organize code to maximize readability and maintainability. When code becomes complex, break it down into smaller, more manageable pieces with clear responsibilities:","repository":"astral-sh/uv","domain":"devtools","topic":"Code Style","language":"Rust","updated":"2025-07-02","comments":7,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-structure-for-readability.md"},{"slug":"airflow-avoid-code-duplication","title":"Avoid code duplication","description":"Extract repeated code patterns into reusable functions, variables, or constants to improve maintainability and reduce the risk of inconsistencies. Look for similar code blocks that perform the same operations and consolidate them.","repository":"apache/airflow","domain":"orchestration","topic":"Code Style","language":"Python","updated":"2025-07-02","comments":6,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-avoid-code-duplication.md"},{"slug":"azure-sdk-for-net-minimize-memory-allocations","title":"Minimize memory allocations","description":"Reduce garbage collection pressure and improve application performance by avoiding unnecessary memory allocations. This significantly impacts overall system responsiveness, especially for high-throughput services.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Performance Optimization","language":"C#","updated":"2025-07-02","comments":6,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-minimize-memory-allocations.md"},{"slug":"azure-sdk-for-net-use-domain-specific-type-names","title":"Use domain-specific type names","description":"Types should be named with clear domain context rather than generic terms. Avoid single-word or overly generic names that could be ambiguous or conflict with other types. Instead, prefix type names with their domain or service name to provide clear context and prevent naming collisions.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Naming Conventions","language":"C#","updated":"2025-07-02","comments":6,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-use-domain-specific-type-names.md"},{"slug":"bazel-explicit-null-handling","title":"Explicit null handling","description":"Always make null handling explicit through proper annotations, defensive checks, and clear documentation. Use @Nullable annotations for parameters and fields that can be null, add precondition checks with meaningful error messages for required non-null values, and document when and why values may be null.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Null Handling","language":"Java","updated":"2025-07-02","comments":6,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-explicit-null-handling.md"},{"slug":"opencv-cross-platform-api-design-rules","title":"Cross-platform API design rules","description":"Design public APIs to work seamlessly across different programming languages and platforms. Follow these key principles: 1. Use platform-agnostic types in public interfaces:","repository":"opencv/opencv","domain":"ml-systems","topic":"API","language":"Other","updated":"2025-07-02","comments":6,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-cross-platform-api-design-rules.md"},{"slug":"tokio-design-error-handling-carefully","title":"Design error handling carefully","description":"When implementing error handling, balance between propagation and recovery. Design error types to preserve context while providing users with meaningful ways to handle failure.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Error Handling","language":"Rust","updated":"2025-07-02","comments":6,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-design-error-handling-carefully.md"},{"slug":"tokio-follow-import-style","title":"Follow import style","description":"Tokio projects follow specific import conventions for consistency and readability. Adhere to these guidelines: 1. Use separate `use` statements for different modules","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Code Style","language":"Rust","updated":"2025-07-02","comments":6,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-follow-import-style.md"},{"slug":"airflow-validate-nulls-explicitly","title":"Validate nulls explicitly","description":"Always check for null values before using them, and use Python's idiomatic patterns to make these checks concise and readable. This prevents unexpected errors and makes code more maintainable.","repository":"apache/airflow","domain":"orchestration","topic":"Null Handling","language":"Python","updated":"2025-07-02","comments":5,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-validate-nulls-explicitly.md"},{"slug":"deno-use-appropriate-synchronization-mechanisms","title":"Use appropriate synchronization mechanisms","description":"Select and implement synchronization primitives that match your concurrency requirements and avoid unsafe patterns. Consider the number of consumers, thread safety requirements, and proper initialization order.","repository":"denoland/deno","domain":"runtimes","topic":"Concurrency","language":"Rust","updated":"2025-07-02","comments":5,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-use-appropriate-synchronization-mechanisms.md"},{"slug":"elasticsearch-prevent-redundant-operations","title":"Prevent redundant operations","description":"In distributed database systems, prevent redundant operations that can overload cluster resources. When implementing update operations that might be triggered simultaneously from multiple nodes:","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Database","language":"Java","updated":"2025-07-02","comments":5,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-prevent-redundant-operations.md"},{"slug":"fastapi-consistent-code-examples","title":"Consistent code examples","description":"Maintain consistent formatting and styling in code examples throughout your NestJS application documentation. This ensures developers can quickly understand dependency injection patterns, module structures, and decorator usage.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"NestJS","language":"Markdown","updated":"2025-07-02","comments":5,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-consistent-code-examples.md"},{"slug":"roo-code-extract-shared-code-patterns","title":"Extract shared code patterns","description":"Identify and extract duplicate code patterns into shared utility functions to improve maintainability and reduce redundancy. When similar logic appears in multiple places, create a reusable function in a shared utility file.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2025-07-02","comments":5,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-extract-shared-code-patterns.md"},{"slug":"roo-code-prevent-duplicate-keys","title":"Prevent duplicate keys","description":"Always ensure configuration files, especially JSON files, have unique keys. Duplicate keys can cause unpredictable behavior as the last occurrence of a key will overwrite previous values, potentially leading to runtime errors or inconsistent application behavior.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Configurations","language":"Json","updated":"2025-07-02","comments":5,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-prevent-duplicate-keys.md"},{"slug":"runtime-avoid-busy-waiting","title":"Avoid busy waiting","description":"When implementing concurrent code that waits for conditions to be met, avoid busy-wait loops that continuously consume CPU resources. Busy-waiting wastes processing power, reduces overall system performance, and can increase power consumption.","repository":"dotnet/runtime","domain":"runtimes","topic":"Concurrency","language":"C#","updated":"2025-07-02","comments":5,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-avoid-busy-waiting.md"},{"slug":"runtime-maintainable-test-structure","title":"Maintainable test structure","description":"Write tests that are maintainable, self-documenting, and that promote good testing practices: 1. **Use proper assertion mechanisms**: Prefer modern assertion patterns over legacy approaches. Use built-in assertion methods that clearly indicate what is being tested.","repository":"dotnet/runtime","domain":"runtimes","topic":"Testing","language":"C#","updated":"2025-07-02","comments":5,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-maintainable-test-structure.md"},{"slug":"terraform-consolidate-related-code","title":"Consolidate related code","description":"Organize code to keep related functionality together. When functions serve similar purposes or operate on the same data, combine them rather than creating separate implementations. Position validation and condition checks before execution to allow early returns and avoid unnecessary processing. This improves code readability, maintainability, and reduces...","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Code Style","language":"Go","updated":"2025-07-02","comments":5,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-consolidate-related-code.md"},{"slug":"tokio-design-flexible-apis","title":"Design flexible APIs","description":"When designing APIs, prioritize flexibility, ergonomics, and intuitiveness to create better user experiences. APIs should accept the most general parameter types appropriate for the functionality, handle edge cases gracefully, and provide methods that align with user expectations.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"API","language":"Rust","updated":"2025-07-02","comments":5,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-design-flexible-apis.md"},{"slug":"airflow-component-reuse-first","title":"Component reuse first","description":"Always prioritize reusing existing components before creating new ones. This practice improves codebase consistency, reduces maintenance burden, and prevents duplication. When implementing new UI elements:","repository":"apache/airflow","domain":"orchestration","topic":"React","language":"TSX","updated":"2025-07-02","comments":4,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-component-reuse-first.md"},{"slug":"bazel-build-action-separation","title":"build action separation","description":"Keep build actions focused on their core responsibility and move complex logic to appropriate abstraction layers like builders or configuration components. Build actions should contain minimal action-specific branching and avoid tight coupling to implementation details.","repository":"bazelbuild/bazel","domain":"devtools","topic":"CI/CD","language":"Java","updated":"2025-07-02","comments":4,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-build-action-separation.md"},{"slug":"elasticsearch-clarity-over-uncertainty","title":"Clarity over uncertainty","description":"Technical documentation should use precise language that clearly differentiates between product behavior and user configuration options. Frame explanations from the user's perspective, emphasizing capabilities rather than limitations.","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Documentation","language":"Markdown","updated":"2025-07-02","comments":4,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-clarity-over-uncertainty.md"},{"slug":"elasticsearch-configure-type-serialization","title":"Configure type serialization","description":"When working with databases that exchange data with other systems, ensure proper serialization and deserialization of data types like UUIDs, dates, or complex objects. System-specific representation differences can lead to data corruption, query failures, or incorrect results.","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Database","language":"Markdown","updated":"2025-07-02","comments":4,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-configure-type-serialization.md"},{"slug":"grafana-judicious-configuration-management","title":"Judicious configuration management","description":"Carefully manage configuration options, including feature flags, to balance flexibility with maintainability: 1. **Use feature flags strategically:**","repository":"grafana/grafana","domain":"observability","topic":"Configurations","language":"Go","updated":"2025-07-02","comments":4,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-judicious-configuration-management.md"},{"slug":"grafana-maintain-configuration-documentation-accuracy","title":"Maintain configuration documentation accuracy","description":"Always ensure configuration documentation accurately reflects the current system capabilities, limitations, and feature availability status. When documenting configuration options:","repository":"grafana/grafana","domain":"observability","topic":"Configurations","language":"Markdown","updated":"2025-07-02","comments":4,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-maintain-configuration-documentation-accuracy.md"},{"slug":"grafana-optimize-performance-patterns","title":"Optimize performance patterns","description":"Choose efficient implementation patterns that improve performance. Apply these optimizations throughout your code: 1. **Avoid redundant operations**: Store results of expensive lookups rather than repeating them.","repository":"grafana/grafana","domain":"observability","topic":"Performance Optimization","language":"Go","updated":"2025-07-02","comments":4,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-optimize-performance-patterns.md"},{"slug":"pytorch-optimize-memory-usage","title":"Optimize memory usage","description":"Limit memory consumption in performance-critical paths by conditionally creating large data structures or deferring allocation until needed. Large tracking structures, debug information, and memory-intensive operations should be guarded by configuration flags to prevent them from impacting performance in production environments.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Performance Optimization","language":"C++","updated":"2025-07-02","comments":4,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-optimize-memory-usage.md"},{"slug":"quarkus-documentation-style-consistency","title":"Documentation style consistency","description":"Maintain consistent documentation style to improve readability and user experience: 1. **Use precise terminology**: When referencing features or components, use their full and correct names.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Documentation","language":"Other","updated":"2025-07-02","comments":4,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-documentation-style-consistency.md"},{"slug":"runtime-choose-appropriate-error-mechanisms","title":"Choose appropriate error mechanisms","description":"Use the right error handling mechanism for each scenario: exceptions for recoverable situations, assertions only for true programming bugs, and consistent error codes for API boundaries. Don''t assert unreachable for scenarios that could legitimately occur, such as in this example:","repository":"dotnet/runtime","domain":"runtimes","topic":"Error Handling","language":"C++","updated":"2025-07-02","comments":4,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-choose-appropriate-error-mechanisms.md"},{"slug":"supabase-maintain-network-controls","title":"Maintain network controls","description":"Create maintainable and clearly documented network access controls. Instead of hardcoding network restrictions, use dedicated tables that can be updated without code changes. Always document networking concepts with plain language explanations for developers unfamiliar with networking terminology.","repository":"supabase/supabase","domain":"data-systems","topic":"Networking","language":"Other","updated":"2025-07-02","comments":4,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-maintain-network-controls.md"},{"slug":"ai-document-configuration-decisions","title":"Document configuration decisions","description":"When modifying configuration files (package.json, tsconfig.json, etc.), document the reasoning behind significant changes and verify they don't introduce unexpected side effects. This is especially important for changes affecting dependencies and build processes.","repository":"vercel/ai","domain":"ai-agents","topic":"Configurations","language":"Json","updated":"2025-07-02","comments":3,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-document-configuration-decisions.md"},{"slug":"airflow-follow-naming-conventions","title":"Follow naming conventions","description":"Use proper naming conventions to make code more readable and maintainable:\\n\\ \\n1. **Functions should start with verbs** that describe their action:\\n   ```typescript","repository":"apache/airflow","domain":"orchestration","topic":"Naming Conventions","language":"TSX","updated":"2025-07-02","comments":3,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-follow-naming-conventions.md"},{"slug":"crewai-validate-configurations-up-front","title":"Validate configurations up front","description":"Always validate configuration parameters and environment variables at initialization time, providing clear error messages for missing or invalid values. This helps catch configuration issues early and makes debugging easier.","repository":"crewaiinc/crewai","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2025-07-02","comments":3,"stars":33945,"raw":"https://awesomereviewers.com/raw/crewai-validate-configurations-up-front.md"},{"slug":"cypress-clarify-testing-documentation","title":"Clarify testing documentation","description":"Ensure that testing documentation, including changelogs, API docs, and guides, uses clear and precise language that doesn't confuse developers. Avoid ambiguous statements that might mislead users who already understand the concepts, use proper technical terminology, and provide concrete examples that reflect real-world usage patterns.","repository":"cypress-io/cypress","domain":"devtools","topic":"Testing","language":"Markdown","updated":"2025-07-02","comments":3,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-clarify-testing-documentation.md"},{"slug":"elasticsearch-design-for-evolution","title":"Design for evolution","description":"When designing APIs, prioritize flexibility and independent evolution of components. Avoid tightly coupling related services or wrapping existing components when they might evolve differently over time. Instead, design APIs with extension points and loose coupling to accommodate future changes.","repository":"elastic/elasticsearch","domain":"data-systems","topic":"API","language":"Java","updated":"2025-07-02","comments":3,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-design-for-evolution.md"},{"slug":"grafana-feature-toggle-lifecycle","title":"Feature toggle lifecycle","description":"When working with feature toggles and configuration flags, manage their entire lifecycle carefully to prevent breaking changes and compatibility issues.","repository":"grafana/grafana","domain":"observability","topic":"Configurations","language":"TypeScript","updated":"2025-07-02","comments":3,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-feature-toggle-lifecycle.md"},{"slug":"langflow-api-endpoint-documentation","title":"API endpoint documentation","description":"Ensure API documentation includes all required networking components and uses proper syntax for shell commands. API examples must include authentication headers, use correct variable expansion syntax, and clearly state network configuration assumptions.","repository":"langflow-ai/langflow","domain":"ai-agents","topic":"Networking","language":"Markdown","updated":"2025-07-02","comments":3,"stars":111046,"raw":"https://awesomereviewers.com/raw/langflow-api-endpoint-documentation.md"},{"slug":"opengrep-contextual-failure-handling","title":"contextual failure handling","description":"Implement intelligent failure handling that makes contextual decisions about retry, cleanup, and error propagation based on the type and likelihood of recovery from specific failures.","repository":"opengrep/opengrep","domain":"security","topic":"Error Handling","language":"Shell","updated":"2025-07-02","comments":3,"stars":1546,"raw":"https://awesomereviewers.com/raw/opengrep-contextual-failure-handling.md"},{"slug":"pytorch-consistent-code-organization","title":"Consistent code organization","description":"Follow consistent code organization patterns: 1. Place static definitions in .cpp files rather than headers to prevent duplicate definitions when included in multiple compilation units:","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Code Style","language":"Other","updated":"2025-07-02","comments":3,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-consistent-code-organization.md"},{"slug":"typescript-preserve-naming-consistency","title":"Preserve naming consistency","description":"Maintain consistent naming patterns and casing across all related code entities to ensure clarity and prevent errors. This includes: 1. Use consistent casing for technical identifiers across all occurrences (in code, documentation, and translations)","repository":"microsoft/typescript","domain":"runtimes","topic":"Naming Conventions","language":"Other","updated":"2025-07-02","comments":3,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-preserve-naming-consistency.md"},{"slug":"union-use-configuration-service-injection","title":"Use configuration service injection","description":"Replace mutable singletons and getter functions with dependency injection services for configuration-dependent components. This approach eliminates race conditions, provides proper initialization guarantees, and enables environment-specific configuration management.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Configurations","language":"TypeScript","updated":"2025-07-02","comments":3,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-use-configuration-service-injection.md"},{"slug":"argo-cd-document-configuration-risks-comprehensively","title":"Document configuration risks comprehensively","description":"When documenting configuration options, provide comprehensive information including current default values, recommended settings, future behavioral changes, and potential security implications. Configuration comments should clearly explain not just what the option does, but also warn about risks and provide guidance on proper usage.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Configurations","language":"Yaml","updated":"2025-07-02","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-document-configuration-risks-comprehensively.md"},{"slug":"cline-remove-production-console-logs","title":"Remove production console logs","description":"Console logs should not appear in production code, especially debug statements that can expose sensitive information or clutter output. When error logging is necessary, log detailed information internally while presenting sanitized messages to users.","repository":"cline/cline","domain":"ai-agents","topic":"Logging","language":"TypeScript","updated":"2025-07-02","comments":2,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-remove-production-console-logs.md"},{"slug":"discourse-log-errors-for-debugging","title":"Log errors for debugging","description":"Always log errors in catch blocks and use named functions to improve debugging and error traceability. Empty catch blocks make it impossible to diagnose issues, while anonymous functions provide poor stack traces.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Error Handling","language":"Other","updated":"2025-07-02","comments":2,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-log-errors-for-debugging.md"},{"slug":"elasticsearch-specify-explicit-rest-formats","title":"Specify explicit REST formats","description":"Always specify explicit request formats in REST API tests rather than relying on default behaviors. This includes: 1. Set appropriate Content-Type headers (typically application/json for REST APIs)","repository":"elastic/elasticsearch","domain":"data-systems","topic":"API","language":"Yaml","updated":"2025-07-02","comments":2,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-specify-explicit-rest-formats.md"},{"slug":"grafana-assert-with-precision","title":"Assert with precision","description":"Tests should verify actual behavior rather than just successful execution. When writing assertions, favor precise equality checks that verify the exact content and ordering rather than loose containment checks.","repository":"grafana/grafana","domain":"observability","topic":"Testing","language":"Go","updated":"2025-07-02","comments":2,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-assert-with-precision.md"},{"slug":"grafana-check-before-calculating","title":"Check before calculating","description":"Implement preliminary validation checks before executing expensive operations to avoid unnecessary processing. When handling operations that may be computationally intensive (like text layout calculations, data transformations, or complex rendering), add targeted checks that can early-exit or skip work when the operation would have no effect or be redundant.","repository":"grafana/grafana","domain":"observability","topic":"Performance Optimization","language":"TypeScript","updated":"2025-07-02","comments":2,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-check-before-calculating.md"},{"slug":"kilocode-justify-configuration-overrides","title":"Justify configuration overrides","description":"Before adding manual configuration entries, verify that the tool doesn't already provide the desired behavior automatically. Document why the override is necessary and what specific problem it solves.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Configurations","language":"Json","updated":"2025-07-02","comments":2,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-justify-configuration-overrides.md"},{"slug":"kilocode-organize-test-setup","title":"organize test setup","description":"Reduce test code duplication by organizing common setup logic and grouping related tests appropriately. Move repeated setup code into beforeEach hooks and use describe blocks to group tests that share similar setup or test the same feature area.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Testing","language":"TypeScript","updated":"2025-07-02","comments":2,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-organize-test-setup.md"},{"slug":"lmcache-check-before-using-values","title":"Check before using values","description":"Always validate that values are not null, undefined, or empty before using them in operations that depend on their content. This prevents downstream errors and unexpected behavior when collections are empty or strings are null.","repository":"LMCache/LMCache","domain":"llm-infra","topic":"Null Handling","language":"Python","updated":"2025-07-02","comments":2,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-check-before-using-values.md"},{"slug":"mastodon-markdown-formatting-consistency","title":"markdown formatting consistency","description":"Establish and maintain consistent formatting standards for Markdown files to improve readability and maintainability. This includes adhering to line length limits and consistent styling choices within documents.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Code Style","language":"Markdown","updated":"2025-07-02","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-markdown-formatting-consistency.md"},{"slug":"node-choose-appropriate-containers","title":"Choose appropriate containers","description":"Select data structures based on expected collection size and usage patterns. For small collections (typically fewer than 30 elements), consider using ordered containers like `std::map` instead of hash-based ones like `std::unordered_map`. With small collections, the theoretical O(log n) vs O(1) lookup time difference becomes negligible in practice, while...","repository":"nodejs/node","domain":"runtimes","topic":"Algorithms","language":"Other","updated":"2025-07-02","comments":2,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-choose-appropriate-containers.md"},{"slug":"opengrep-ensure-cross-platform-compatibility","title":"Ensure cross-platform compatibility","description":"Write code that works consistently across different platforms and environments. Avoid using Unicode symbols or special characters that may not render properly in all terminals or logging systems, as they can cause display issues or interfere with automated processing. Use portable system paths and commands that work across different operating systems.","repository":"opengrep/opengrep","domain":"security","topic":"Code Style","language":"Shell","updated":"2025-07-02","comments":2,"stars":1546,"raw":"https://awesomereviewers.com/raw/opengrep-ensure-cross-platform-compatibility.md"},{"slug":"pytorch-centralize-configuration-detection","title":"Centralize configuration detection","description":"Always use centralized configuration detection mechanisms (like CMake finder modules) instead of hardcoding paths or environment variables. This approach ensures compatibility across different installation methods and environments.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Configurations","language":"Shell","updated":"2025-07-02","comments":2,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-centralize-configuration-detection.md"},{"slug":"pytorch-choose-data-structures-wisely","title":"Choose data structures wisely","description":"When designing algorithms, select data structures that accommodate all possible scenarios, not just the common case. For static analysis algorithms where certainty isn't guaranteed, prefer collections that can represent one-to-many relationships even when most instances will contain only one element. This prevents having to redesign your algorithm later...","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Algorithms","language":"Other","updated":"2025-07-02","comments":2,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-choose-data-structures-wisely.md"},{"slug":"rust-normalize-variable-test-output","title":"Normalize variable test output","description":"When writing tests that capture output (like UI tests, stderr, or stdout), ensure you normalize any variable content that might change between runs or versions to prevent fragile tests. This includes version numbers, debug information, instruction identifiers, and other implementation details that don't affect the functionality being tested.","repository":"rust-lang/rust","domain":"runtimes","topic":"Testing","language":"Other","updated":"2025-07-02","comments":2,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-normalize-variable-test-output.md"},{"slug":"serena-inline-configuration-dictionaries","title":"Inline configuration dictionaries","description":"Avoid storing simple configuration data in separate JSON files. Instead, define configuration as Python dictionaries directly within the relevant modules. This approach reduces file overhead, improves maintainability, and keeps related code together.","repository":"oraios/serena","domain":"ai-agents","topic":"Configurations","language":"Json","updated":"2025-07-02","comments":2,"stars":14465,"raw":"https://awesomereviewers.com/raw/serena-inline-configuration-dictionaries.md"},{"slug":"continue-prevent-injection-vulnerabilities","title":"Prevent injection vulnerabilities","description":"When constructing templates or dynamic content that will be parsed, always implement robust escaping mechanisms to prevent injection vulnerabilities. Avoid using delimiters in template strings that might appear in the content itself, as this could break formatting or enable code injection attacks.","repository":"continuedev/continue","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2025-07-02","comments":1,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-prevent-injection-vulnerabilities.md"},{"slug":"chef-limit-token-permissions","title":"Limit token permissions","description":"Always specify the minimum required permissions for the GITHUB_TOKEN in GitHub Actions workflows to enhance security. By default, the GITHUB_TOKEN has broad permissions that could potentially be exploited if a workflow is compromised.","repository":"chef/chef","domain":"cloud-infra","topic":"Security","language":"Yaml","updated":"2025-07-01","comments":12,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-limit-token-permissions.md"},{"slug":"n8n-component-naming-consistency","title":"Component naming consistency","description":"Ensure component usage in templates matches registered components. Vue components must be referenced in templates by either their kebab-case equivalent or by their exact registered name.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Vue","language":"TypeScript","updated":"2025-07-01","comments":12,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-component-naming-consistency.md"},{"slug":"grafana-extract-repeated-code","title":"Extract repeated code","description":"Identify and extract repeated code patterns into well-named functions to improve readability, maintainability, and testability. Look for blocks of code that appear in multiple places or complex operations that can be encapsulated with a descriptive function name.","repository":"grafana/grafana","domain":"observability","topic":"Code Style","language":"Go","updated":"2025-07-01","comments":9,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-extract-repeated-code.md"},{"slug":"rails-layer-security-defenses","title":"Layer security defenses","description":"Implement multiple layers of security throughout your application rather than relying on a single protection mechanism. This defense-in-depth approach significantly improves your application's security posture.","repository":"rails/rails","domain":"app-frameworks","topic":"Security","language":"Markdown","updated":"2025-07-01","comments":9,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-layer-security-defenses.md"},{"slug":"turborepo-validate-configurations-comprehensively","title":"Validate configurations comprehensively","description":"When implementing configuration systems, ensure comprehensive validation, testing, and documentation. Key requirements: 1. Use an allowlist approach - explicitly categorize and validate ALL configuration fields","repository":"vercel/turborepo","domain":"devtools","topic":"Configurations","language":"Rust","updated":"2025-07-01","comments":8,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-validate-configurations-comprehensively.md"},{"slug":"brew-optimize-collection-operations","title":"Optimize collection operations","description":"Use Ruby's built-in collection methods to write more efficient and readable code. This reduces algorithmic complexity and improves performance by leveraging optimized implementations instead of writing manual iterations or chaining multiple operations.","repository":"Homebrew/brew","domain":"devtools","topic":"Algorithms","language":"Ruby","updated":"2025-07-01","comments":7,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-optimize-collection-operations.md"},{"slug":"grafana-follow-documentation-conventions","title":"Follow documentation conventions","description":"Ensure documentation adheres to established style guidelines and technical\\ \\ standards:\\n\\n1. **Use proper terminology and formatting:**\\n   - Write \\\"data\\ \\ source\\\" as two words, not \\\"datasource\\\"","repository":"grafana/grafana","domain":"observability","topic":"Documentation","language":"Markdown","updated":"2025-07-01","comments":7,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-follow-documentation-conventions.md"},{"slug":"langfuse-cache-expensive-operations","title":"Cache expensive operations","description":"Identify and cache results of computationally expensive or repetitive operations instead of recalculating them multiple times. This includes function calls, date object creation, data transformations, and resolved promises.","repository":"langfuse/langfuse","domain":"observability","topic":"Performance Optimization","language":"TypeScript","updated":"2025-07-01","comments":7,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-cache-expensive-operations.md"},{"slug":"runtime-simplify-code-expressions","title":"Simplify code expressions","description":"Strive for clarity by simplifying code expressions and reducing unnecessary complexity. Complex or verbose expressions decrease readability and increase the chance of errors during maintenance.","repository":"dotnet/runtime","domain":"runtimes","topic":"Code Style","language":"C++","updated":"2025-07-01","comments":7,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-simplify-code-expressions.md"},{"slug":"zed-test-through-public-apis","title":"Test through public APIs","description":"Write comprehensive tests that validate functionality through public interfaces rather than testing implementation details. Tests should cover diverse scenarios, handle platform-specific cases, and use appropriate assertions.","repository":"zed-industries/zed","domain":"devtools","topic":"Testing","language":"Rust","updated":"2025-07-01","comments":7,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-test-through-public-apis.md"},{"slug":"ai-keep-tests-simple","title":"Keep tests simple","description":"Tests should be straightforward, explicit, and free from complex logic or indirection. Avoid \"magic\" in tests that makes them harder to understand at a glance. When designing tests:","repository":"vercel/ai","domain":"ai-agents","topic":"Testing","language":"TypeScript","updated":"2025-07-01","comments":6,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-keep-tests-simple.md"},{"slug":"elasticsearch-measure-before-optimizing-performance","title":"Measure before optimizing performance","description":"Before implementing performance optimizations, measure and validate the impact through benchmarks. This applies especially to: 1. Changes affecting common operations (string conversions, collections)","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Performance Optimization","language":"Java","updated":"2025-07-01","comments":6,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-measure-before-optimizing-performance.md"},{"slug":"elasticsearch-use-configuration-access-methods","title":"Use configuration access methods","description":"When accessing configuration settings, always use the appropriate type-safe accessor methods provided by the configuration framework rather than manual string parsing. This improves code readability, maintainability, and reduces potential bugs from string parsing errors.","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Configurations","language":"Java","updated":"2025-07-01","comments":6,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-use-configuration-access-methods.md"},{"slug":"material-ui-meaningful-and-consistent-names","title":"Meaningful and consistent names","description":"Use descriptive, accurate identifiers that follow established conventions and maintain consistency throughout your codebase. Variables, parameters, and properties should clearly indicate their purpose and content.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2025-07-01","comments":6,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-meaningful-and-consistent-names.md"},{"slug":"neon-keep-files-focused-small","title":"Keep files focused small","description":"Maintain code organization by keeping files focused on a single responsibility and splitting large files into smaller, well-organized modules. This improves code navigation, readability, and maintainability.","repository":"neondatabase/neon","domain":"data-systems","topic":"Code Style","language":"Rust","updated":"2025-07-01","comments":6,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-keep-files-focused-small.md"},{"slug":"opencv-clear-api-contracts","title":"Clear API contracts","description":"Design APIs with clear contracts that behave exactly as their names and signatures suggest. Functions should do precisely what they claim to do without surprising side effects or hidden behaviors.","repository":"opencv/opencv","domain":"ml-systems","topic":"API","language":"C++","updated":"2025-07-01","comments":6,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-clear-api-contracts.md"},{"slug":"prometheus-avoid-subjective-language","title":"avoid subjective language","description":"Avoid subjective terms, unexplained jargon, and assumptions about user knowledge in documentation. Replace subjective language like \"obvious\" with descriptive explanations, define technical terms that may not be familiar to all readers, and break down compact technical descriptions into more accessible language.","repository":"prometheus/prometheus","domain":"observability","topic":"Documentation","language":"Markdown","updated":"2025-07-01","comments":6,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-avoid-subjective-language.md"},{"slug":"pydantic-maintain-code-consistency","title":"Maintain code consistency","description":"Ensure code follows consistent patterns throughout the codebase, even when duplicating code is necessary. When similar code patterns appear in multiple places, they should maintain the same structure and approach to improve readability and reduce errors.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Code Style","language":"Python","updated":"2025-07-01","comments":6,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-maintain-code-consistency.md"},{"slug":"quarkus-thread-safe-state-management","title":"Thread-safe state management","description":"When managing state accessed by multiple threads, ensure thread safety through appropriate synchronization mechanisms: 1. **Use thread-safe collections** for multi-threaded access:","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Concurrency","language":"Java","updated":"2025-07-01","comments":6,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-thread-safe-state-management.md"},{"slug":"zed-consider-algorithmic-complexity","title":"Consider algorithmic complexity","description":"When implementing algorithms, be mindful of their computational complexity\\ \\ and choose appropriate data structures for operations. \\n\\n1. **Use specialized\\ \\ collections for their strengths**:","repository":"zed-industries/zed","domain":"devtools","topic":"Algorithms","language":"Rust","updated":"2025-07-01","comments":6,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-consider-algorithmic-complexity.md"},{"slug":"django-version-annotation-in-docs","title":"Version annotation in docs","description":"Always include appropriate version annotations when documenting new features or changes in behavior. Use `.. versionadded::` for new features and `.. versionchanged::` for modifications to existing functionality. Place these annotations immediately after the feature's first mention in the documentation.","repository":"django/django","domain":"app-frameworks","topic":"Documentation","language":"Txt","updated":"2025-07-01","comments":5,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-version-annotation-in-docs.md"},{"slug":"grafana-close-resources-with-errors","title":"Close resources with errors","description":"Always close resources (files, streams, connections) and properly handle their Close() errors. For read operations, Close() errors can be ignored if the primary operation (like JSON parsing) succeeded. For write operations, always check and propagate Close() errors.","repository":"grafana/grafana","domain":"observability","topic":"Error Handling","language":"Go","updated":"2025-07-01","comments":5,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-close-resources-with-errors.md"},{"slug":"neon-hierarchical-semantic-naming","title":"Hierarchical semantic naming","description":"Use hierarchical prefixes and clear descriptive names to indicate the domain, source, and purpose of code elements. This improves code organization, searchability, and helps maintain consistency across the codebase.","repository":"neondatabase/neon","domain":"data-systems","topic":"Naming Conventions","language":"Other","updated":"2025-07-01","comments":5,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-hierarchical-semantic-naming.md"},{"slug":"ruff-use-descriptive-identifiers","title":"Use descriptive identifiers","description":"Avoid abbreviations in variable, parameter, and method names to improve code readability and maintainability. Use descriptive identifiers that clearly indicate the purpose and content of what they represent.","repository":"astral-sh/ruff","domain":"devtools","topic":"Naming Conventions","language":"Rust","updated":"2025-07-01","comments":5,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-use-descriptive-identifiers.md"},{"slug":"runtime-abstract-traversal-patterns","title":"Abstract traversal patterns","description":"When implementing algorithms that operate on complex data structures (trees, graphs, dominator structures), abstract the traversal mechanism from the operation performed at each node. Use visitor patterns or callbacks to separate concerns, making algorithms more maintainable and reusable.","repository":"dotnet/runtime","domain":"runtimes","topic":"Algorithms","language":"C++","updated":"2025-07-01","comments":5,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-abstract-traversal-patterns.md"},{"slug":"runtime-cache-expensive-computations","title":"Cache expensive computations","description":"Avoid recomputing expensive operations by caching results when they will be used multiple times. This applies to method calls, property access, and static property lookups. The performance impact of repeated calculations can be significant, especially in hot code paths.","repository":"dotnet/runtime","domain":"runtimes","topic":"Performance Optimization","language":"C#","updated":"2025-07-01","comments":5,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-cache-expensive-computations.md"},{"slug":"runtime-prevent-null-references","title":"Prevent null references","description":"Use defensive coding practices to prevent null reference exceptions\\ \\ by properly handling potentially null values throughout your code. \\n\\n1. **Properly\\ \\ initialize objects** instead of using default values when instantiation is needed:","repository":"dotnet/runtime","domain":"runtimes","topic":"Null Handling","language":"C#","updated":"2025-07-01","comments":5,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-prevent-null-references.md"},{"slug":"airflow-context-rich-log-messages","title":"Context-rich log messages","description":"Ensure log messages provide clear context about what happened, potential consequences, and actionable information for debugging. Choose appropriate log levels based on severity, and include exception details when catching errors.","repository":"apache/airflow","domain":"orchestration","topic":"Logging","language":"Python","updated":"2025-07-01","comments":4,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-context-rich-log-messages.md"},{"slug":"airflow-explicit-over-implicit-configuration","title":"Explicit over implicit configuration","description":"Always prefer explicit configuration parameters over inferring behavior from indirect sources like image tags, naming conventions, or environment factors. When behavior needs to vary based on environment or version, introduce dedicated configuration parameters that users can explicitly set rather than relying on potentially unreliable metadata.","repository":"apache/airflow","domain":"orchestration","topic":"Configurations","language":"Yaml","updated":"2025-07-01","comments":4,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-explicit-over-implicit-configuration.md"},{"slug":"airflow-parameterize-similar-tests","title":"Parameterize similar tests","description":"Write parameterized tests instead of using for loops or duplicating test code for similar test cases. Using pytest's `@pytest.mark.parametrize` decorator improves test maintainability, provides clearer failure messages, and makes the test structure more readable.","repository":"apache/airflow","domain":"orchestration","topic":"Testing","language":"Python","updated":"2025-07-01","comments":4,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-parameterize-similar-tests.md"},{"slug":"bun-always-await-promises","title":"Always await promises","description":"Consistently use the `await` keyword when working with Promise-returning functions to ensure proper execution flow and prevent race conditions. Missing awaits can lead to unexpected behavior where code continues execution without waiting for asynchronous operations to complete.","repository":"oven-sh/bun","domain":"runtimes","topic":"Concurrency","language":"TypeScript","updated":"2025-07-01","comments":4,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-always-await-promises.md"},{"slug":"lobe-chat-use-reactive-hooks","title":"Use reactive hooks","description":"Always use React's reactive hook patterns instead of imperative state access or manual effect management. This ensures proper component re-rendering, better performance, and cleaner code architecture.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"React","language":"TSX","updated":"2025-07-01","comments":4,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-use-reactive-hooks.md"},{"slug":"neon-proactive-cache-warming","title":"Proactive cache warming","description":"Implement proactive cache warming strategies to minimize performance degradation after system restarts or during cold starts. Rather than waiting for normal workload patterns to gradually populate caches, actively prefetch and load likely-needed data into memory ahead of time.","repository":"neondatabase/neon","domain":"data-systems","topic":"Performance Optimization","language":"Markdown","updated":"2025-07-01","comments":4,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-proactive-cache-warming.md"},{"slug":"prisma-ensure-concurrent-resource-cleanup","title":"Ensure concurrent resource cleanup","description":"Always ensure proper cleanup of concurrent resources like semaphores, transactions, and async operations, even when exceptions occur. Use finally blocks to guarantee resource release and Promise.allSettled instead of Promise.all when handling multiple concurrent operations that might fail.","repository":"prisma/prisma","domain":"data-systems","topic":"Concurrency","language":"TypeScript","updated":"2025-07-01","comments":4,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-ensure-concurrent-resource-cleanup.md"},{"slug":"pytorch-eliminate-redundant-operations","title":"Eliminate redundant operations","description":"Avoid unnecessary operations that can impact performance. This includes:\\n\\ \\n1. Redundant data transformations:\\n   - Load data directly from sources instead\\ \\ of creating temporary copies","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Performance Optimization","language":"Python","updated":"2025-07-01","comments":4,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-eliminate-redundant-operations.md"},{"slug":"quarkus-validate-database-connections-explicitly","title":"Validate database connections explicitly","description":"Always implement explicit database connection validation strategies to ensure robust application behavior during startup and runtime. This includes: 1. Configure validation queries with appropriate timeouts:","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Database","language":"Java","updated":"2025-07-01","comments":4,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-validate-database-connections-explicitly.md"},{"slug":"rails-optimize-cache-headers","title":"Optimize cache headers","description":"Use appropriate HTTP cache headers based on content mutability. For immutable assets (like digest-stamped files), apply aggressive caching with far-future expiry and the immutable flag. For mutable files, use short cache times to balance between preventing thundering herds and allowing timely updates.","repository":"rails/rails","domain":"app-frameworks","topic":"Caching","language":"Other","updated":"2025-07-01","comments":4,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-optimize-cache-headers.md"},{"slug":"zed-protect-render-loop-performance","title":"Protect render loop performance","description":"Ensure render loop operations stay within frame time budget (typically 16.67ms for 60fps). Avoid expensive computations, traversals, and I/O operations during frame rendering. Instead, compute and cache results ahead of time or move heavy operations to background tasks.","repository":"zed-industries/zed","domain":"devtools","topic":"Performance Optimization","language":"Rust","updated":"2025-07-01","comments":4,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-protect-render-loop-performance.md"},{"slug":"airflow-document-intentional-choices","title":"Document intentional choices","description":"Add explanatory comments for non-obvious code decisions that might appear incorrect, unusual, or suboptimal to future contributors. Without such comments, code that looks unusual might be \"fixed\" during refactoring, introducing bugs. This is particularly important for:","repository":"apache/airflow","domain":"orchestration","topic":"Documentation","language":"Python","updated":"2025-07-01","comments":3,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-document-intentional-choices.md"},{"slug":"lobe-chat-optimize-store-selectors","title":"Optimize store selectors","description":"Write store selectors with proper patterns to prevent unnecessary component re-renders. Use inline selector functions that extract only the needed data, and provide custom equality comparisons for complex data types like arrays and objects.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Performance Optimization","language":"TSX","updated":"2025-07-01","comments":3,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-optimize-store-selectors.md"},{"slug":"n8n-never-commit-credentials","title":"Never commit credentials","description":"Credentials, passwords, API tokens, and database connection strings must never be committed to version control in any form, even in configuration files or Kubernetes manifests. This practice exposes sensitive information to anyone with repository access and creates security vulnerabilities.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Security","language":"Yaml","updated":"2025-07-01","comments":3,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-never-commit-credentials.md"},{"slug":"neon-adaptive-cache-expiration-strategy","title":"Adaptive cache expiration strategy","description":"Design cache expiration policies that align with actual workload patterns rather than arbitrary timeframes. For systems with varying access patterns (e.g., daily vs. monthly workloads), implement configurable TTL settings to prevent premature cache invalidation.","repository":"neondatabase/neon","domain":"data-systems","topic":"Caching","language":"Markdown","updated":"2025-07-01","comments":3,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-adaptive-cache-expiration-strategy.md"},{"slug":"neon-database-before-memory","title":"Database before memory","description":"When working with database systems that also maintain in-memory state, always update the persistent database state before updating the in-memory representation. This ensures that if a crash occurs between operations, the system can correctly rebuild its state from the database without inconsistencies or \"time traveling\" issues.","repository":"neondatabase/neon","domain":"data-systems","topic":"Database","language":"Rust","updated":"2025-07-01","comments":3,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-database-before-memory.md"},{"slug":"runtime-choose-descriptive-names","title":"Choose descriptive names","description":"Names should clearly convey purpose and meaning. Parameter, variable, and method names should be self-explanatory and accurately reflect their behavior and intent. Rename elements when their original name no longer captures their purpose or could lead to confusion.","repository":"dotnet/runtime","domain":"runtimes","topic":"Naming Conventions","language":"C++","updated":"2025-07-01","comments":3,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-choose-descriptive-names.md"},{"slug":"runtime-memory-ordering-matters","title":"Memory ordering matters","description":"When working with shared data in multithreaded environments, memory ordering is critical to prevent race conditions and ensure thread safety: 1. **Avoid transient incorrect states** - Don''t write an incorrect value before replacing it with the correct one, as other threads may see the intermediate state:","repository":"dotnet/runtime","domain":"runtimes","topic":"Concurrency","language":"C++","updated":"2025-07-01","comments":3,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-memory-ordering-matters.md"},{"slug":"runtime-optimize-build-dependency-chains","title":"Optimize build dependency chains","description":"When configuring build and test processes in CI/CD pipelines, ensure proper dependency chains with clear inputs and outputs to avoid unnecessary execution steps and cross-platform failures. Use techniques like:","repository":"dotnet/runtime","domain":"runtimes","topic":"CI/CD","language":"Other","updated":"2025-07-01","comments":3,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-optimize-build-dependency-chains.md"},{"slug":"turborepo-validate-configuration-structures","title":"Validate configuration structures","description":"Ensure configuration files and schemas adhere to their expected structure, location, and uniqueness constraints. When supporting multiple configuration file formats (e.g., both .json and .jsonc extensions), implement validation to prevent conflicting configurations:","repository":"vercel/turborepo","domain":"devtools","topic":"Configurations","language":"TypeScript","updated":"2025-07-01","comments":3,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-validate-configuration-structures.md"},{"slug":"uv-declarative-constraints-over-runtime","title":"Declarative constraints over runtime","description":"Design APIs that enforce constraints through type systems and declarative mechanisms rather than runtime checks. This makes invalid states unrepresentable by design and improves both API usability and reliability.","repository":"astral-sh/uv","domain":"devtools","topic":"API","language":"Rust","updated":"2025-07-01","comments":3,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-declarative-constraints-over-runtime.md"},{"slug":"ai-flexible-api-inputs","title":"Flexible API inputs","description":"Design APIs to accept flexible input formats and schema structures, ensuring a better developer experience while maintaining consistency in internal implementation.","repository":"vercel/ai","domain":"ai-agents","topic":"API","language":"Markdown","updated":"2025-07-01","comments":2,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-flexible-api-inputs.md"},{"slug":"airflow-use-guards-over-assertions","title":"Use guards over assertions","description":"Prefer explicit type guards and null checks over TypeScript's type assertions (`as`) when handling potentially null or undefined values. Type assertions bypass TypeScript's type checking system and can lead to runtime errors.","repository":"apache/airflow","domain":"orchestration","topic":"Null Handling","language":"TSX","updated":"2025-07-01","comments":2,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-use-guards-over-assertions.md"},{"slug":"airflow-validate-configuration-source-changes","title":"Validate configuration source changes","description":"When switching between different configuration sources (like APIs or configuration values), ensure data structure compatibility and consistent behavior. Configuration endpoints may return different data structures that require proper transformation.","repository":"apache/airflow","domain":"orchestration","topic":"Configurations","language":"TSX","updated":"2025-07-01","comments":2,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-validate-configuration-source-changes.md"},{"slug":"azure-sdk-for-net-eliminate-repeated-code","title":"Eliminate repeated code","description":"Reduce code duplication by extracting repeated patterns into variables, loops, or helper functions. When you find yourself writing similar lines of code multiple times, refactor to a more DRY (Don't Repeat Yourself) approach to improve maintainability and readability.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Code Style","language":"Other","updated":"2025-07-01","comments":2,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-eliminate-repeated-code.md"},{"slug":"kilocode-prefer-simple-null-safe-patterns","title":"prefer simple null-safe patterns","description":"Use straightforward null-safe patterns instead of complex undefined/empty distinctions. Avoid `any` types that can hide potential null/undefined issues at runtime.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2025-07-01","comments":2,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-prefer-simple-null-safe-patterns.md"},{"slug":"llama.cpp-enable-callback-chaining","title":"Enable callback chaining","description":"When designing APIs that accept callbacks or configuration functions, always return the previous callback/configuration to enable chaining and composition. This allows multiple components to layer their functionality without losing existing behavior.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"API","language":"Other","updated":"2025-07-01","comments":2,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-enable-callback-chaining.md"},{"slug":"material-ui-optimize-cicd-infrastructure","title":"Optimize CI/CD infrastructure","description":"Continuously optimize and maintain your CI/CD infrastructure to keep development velocity high while ensuring quality. Proactive maintenance prevents disruptions that can impact the entire team.","repository":"mui/material-ui","domain":"app-frameworks","topic":"CI/CD","language":"Markdown","updated":"2025-07-01","comments":2,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-optimize-cicd-infrastructure.md"},{"slug":"n8n-preserve-icon-font-families","title":"Preserve icon font families","description":"When working with icon elements in CSS, maintain the specialized font families designed for icon rendering. Replacing icon fonts (like 'element-icons') with standard text fonts (like 'Inter') will break icon displays that depend on specific glyph mappings in the icon font.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Code Style","language":"Css","updated":"2025-07-01","comments":2,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-preserve-icon-font-families.md"},{"slug":"n8n-sanitize-user-input","title":"Sanitize user input","description":"Always sanitize and validate user-controlled input before using it in\\ \\ sensitive operations, and never hard-code credentials in source code. \\n\\n**For\\ \\ command execution:**","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Security","language":"Python","updated":"2025-07-01","comments":2,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-sanitize-user-input.md"},{"slug":"neon-feature-flag-implementation-clarity","title":"Feature flag implementation clarity","description":"When implementing feature flags in the system, clearly document both the evaluation strategy and its performance implications. For HTTP evaluation vs. local evaluation, include expected request volumes and latency impacts. Always provide configuration examples that demonstrate proper usage.","repository":"neondatabase/neon","domain":"data-systems","topic":"Configurations","language":"Markdown","updated":"2025-07-01","comments":2,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-feature-flag-implementation-clarity.md"},{"slug":"quarkus-document-observability-context-flows","title":"Document observability context flows","description":"When implementing observability features like OpenTelemetry exporters, metrics collection, or distributed tracing, clearly document the context flow and environment limitations. Make explicit which features are available in specific environments (development vs. production), how context is propagated between components, and provide proper error handling for...","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Observability","language":"Other","updated":"2025-07-01","comments":2,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-document-observability-context-flows.md"},{"slug":"router-prioritize-code-legibility","title":"Prioritize code legibility","description":"Write clear, explicit code that prioritizes readability over brevity. Remove unnecessary operations and use straightforward syntax patterns. This is especially important in library code where clarity benefits all consumers.","repository":"TanStack/router","domain":"app-frameworks","topic":"Code Style","language":"TSX","updated":"2025-07-01","comments":2,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-prioritize-code-legibility.md"},{"slug":"runtime-honor-api-contracts","title":"Honor API contracts","description":"When implementing or modifying APIs, carefully preserve the historical behavior and semantic contracts of existing interfaces, even when those behaviors seem counterintuitive. This includes maintaining consistent exception throwing patterns and honoring the distinct purposes of method overloads.","repository":"dotnet/runtime","domain":"runtimes","topic":"API","language":"C#","updated":"2025-07-01","comments":2,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-honor-api-contracts.md"},{"slug":"uv-test-deployment-edge-cases","title":"Test deployment edge cases","description":"Ensure that code paths handling different deployment environments (installation prefixes, target directories, etc.) have proper test coverage. Without tests for these scenarios, it's difficult to trust that the functionality works correctly across all supported environments.","repository":"astral-sh/uv","domain":"devtools","topic":"Testing","language":"Python","updated":"2025-07-01","comments":2,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-test-deployment-edge-cases.md"},{"slug":"azure-sdk-for-net-redact-sensitive-information","title":"Redact sensitive information","description":"Always sanitize configuration data or any potentially sensitive information before logging or displaying it. When logging configurations, API responses, or user inputs, use pattern matching to identify and redact secrets, passwords, API keys, and other credentials.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Security","language":"Other","updated":"2025-07-01","comments":1,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-redact-sensitive-information.md"},{"slug":"elasticsearch-enforce-least-privilege","title":"Enforce least privilege","description":"Always assign the minimum permissions necessary for functionality when implementing role-based access controls. This fundamental security principle reduces the potential attack surface and minimizes the impact of compromised accounts.","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Security","language":"Java","updated":"2025-07-01","comments":1,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-enforce-least-privilege.md"},{"slug":"n8n-secure-credential-management","title":"Secure credential management","description":"Never hardcode sensitive information like passwords, API keys, or access tokens directly in code or configuration files (including Dockerfiles). These credentials can be exposed through version control systems, shared images, or when files are accessed by unauthorized users.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Security","language":"Txt","updated":"2025-07-01","comments":1,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-secure-credential-management.md"},{"slug":"runtime-constant-time-cryptographic-validation","title":"Constant-time cryptographic validation","description":"Always use constant-time comparison methods when validating cryptographic values to prevent timing side-channel attacks. Operations like comparing authentication tags, MACs, hashes, or any security-sensitive values should use dedicated APIs such as `CryptographicOperations.FixedTimeEquals()` rather than standard equality operators or methods.","repository":"dotnet/runtime","domain":"runtimes","topic":"Security","language":"C#","updated":"2025-07-01","comments":1,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-constant-time-cryptographic-validation.md"},{"slug":"dspy-use-descriptive-names","title":"Use descriptive names","description":"Choose variable, method, class, and parameter names that clearly communicate their purpose and avoid ambiguity. Names should be self-documenting and specific rather than generic or vague.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Naming Conventions","language":"Python","updated":"2025-06-30","comments":11,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-use-descriptive-names.md"},{"slug":"electron-conditional-feature-initialization","title":"conditional feature initialization","description":"Only initialize configuration-dependent features, systems, or resources when the relevant settings, flags, or conditions are actually present or enabled. This prevents unnecessary resource allocation, avoids unwanted side effects like creating default contexts, and improves performance by deferring expensive operations until they're needed.","repository":"electron/electron","domain":"devtools","topic":"Configurations","language":"Other","updated":"2025-06-30","comments":9,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-conditional-feature-initialization.md"},{"slug":"ghostty-code-structure-clarity","title":"Code structure clarity","description":"Write code with clear structural organization that enhances readability and maintainability. Extract duplicated or complex logic into well-named functions, avoid deeply nested conditionals, and use proper type organization.","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Code Style","language":"Other","updated":"2025-06-30","comments":9,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-code-structure-clarity.md"},{"slug":"elasticsearch-optimize-before-implementing","title":"Optimize before implementing","description":"Before implementing algorithms, evaluate their efficiency implications, especially for operations that may be executed frequently or with large datasets. Consider:","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Algorithms","language":"Java","updated":"2025-06-30","comments":8,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-optimize-before-implementing.md"},{"slug":"azure-sdk-for-net-check-before-dereferencing","title":"Check before dereferencing","description":"Always verify objects are not null before dereferencing them, particularly when using methods that might return null like FirstOrDefault(), LastOrDefault(), or 'as' casts. Prevent NullReferenceExceptions by adding explicit null checks before accessing members.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Null Handling","language":"C#","updated":"2025-06-30","comments":7,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-check-before-dereferencing.md"},{"slug":"framework-use-modern-phpunit-attributes","title":"Use modern PHPUnit attributes","description":"Prefer modern PHPUnit attributes over PHPDoc annotations for improved type safety, IDE support, and code readability in tests. Replace legacy annotation-style test decorators with their attribute counterparts:","repository":"laravel/framework","domain":"app-frameworks","topic":"Testing","language":"PHP","updated":"2025-06-30","comments":7,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-use-modern-phpunit-attributes.md"},{"slug":"tokio-structure-conditional-compilation","title":"Structure conditional compilation","description":"Use organized structural patterns for conditional compilation to improve code maintainability and readability. Avoid applying `#[cfg]` attributes directly to function parameters - instead wrap conditionally available data in structs that can be zero-sized when features are disabled:","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Configurations","language":"Rust","updated":"2025-06-30","comments":7,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-structure-conditional-compilation.md"},{"slug":"vitess-dynamic-configuration-needs-validation","title":"Dynamic configuration needs validation","description":"When implementing dynamic configuration options, validate that the system actually supports runtime changes for that setting. A configuration should only be marked as dynamic if:","repository":"vitessio/vitess","domain":"data-systems","topic":"Configurations","language":"Go","updated":"2025-06-30","comments":7,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-dynamic-configuration-needs-validation.md"},{"slug":"airflow-validate-user-controlled-paths","title":"Validate user-controlled paths","description":"Always validate and sanitize user-provided inputs used in file path operations to prevent path traversal attacks. Path traversal vulnerabilities can allow attackers to access unauthorized files outside the intended directory structure.","repository":"apache/airflow","domain":"orchestration","topic":"Security","language":"Python","updated":"2025-06-30","comments":6,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-validate-user-controlled-paths.md"},{"slug":"elasticsearch-robust-test-assertions","title":"Robust test assertions","description":"Use precise, informative assertions in tests to provide clear feedback when tests fail and verify the correct behavior rather than implementation details.","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Testing","language":"Java","updated":"2025-06-30","comments":6,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-robust-test-assertions.md"},{"slug":"framework-name-indicates-clear-purpose","title":"Name indicates clear purpose","description":"Names should clearly indicate their purpose, type, and behavior. This applies to methods, variables, and parameters. Choose names that are self-documenting and unambiguous.","repository":"laravel/framework","domain":"app-frameworks","topic":"Naming Conventions","language":"PHP","updated":"2025-06-30","comments":6,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-name-indicates-clear-purpose.md"},{"slug":"neon-log-level-appropriately","title":"Log level appropriately","description":"Select the appropriate log level based on operational significance and ensure messages are clear, accurate, and formatted for human readability: 1. **ERROR**: Use for failures requiring immediate attention","repository":"neondatabase/neon","domain":"data-systems","topic":"Logging","language":"Rust","updated":"2025-06-30","comments":6,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-log-level-appropriately.md"},{"slug":"tokio-structural-configuration-approaches","title":"Structural configuration approaches","description":"When working with feature flags and conditional compilation, prefer structural approaches over scattered configuration attributes throughout your code. This creates more maintainable code and reduces the chance of bugs when features are added or removed.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Configurations","language":"Rust","updated":"2025-06-30","comments":6,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-structural-configuration-approaches.md"},{"slug":"airflow-handle-exceptions-with-specificity","title":"Handle exceptions with specificity","description":"Use specific exception types and avoid masking errors through overly broad exception handling or default values. This improves error diagnosis and system reliability.","repository":"apache/airflow","domain":"orchestration","topic":"Error Handling","language":"Python","updated":"2025-06-30","comments":5,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-handle-exceptions-with-specificity.md"},{"slug":"argo-cd-structured-logging-practices","title":"structured logging practices","description":"Use structured logging with proper context and consolidate related log messages. Instead of multiple separate log statements or string interpolation, use structured fields that are parseable by log tools and provide sufficient context for debugging.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Logging","language":"Go","updated":"2025-06-30","comments":5,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-structured-logging-practices.md"},{"slug":"azure-sdk-for-net-specific-exceptions-for-clarity","title":"Specific exceptions for clarity","description":"Use specific exception types with meaningful error messages rather than generic exceptions to improve error handling, debugging, and API usability. This allows callers to distinguish between different error conditions and respond appropriately.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Error Handling","language":"C#","updated":"2025-06-30","comments":5,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-specific-exceptions-for-clarity.md"},{"slug":"compose-scope-concurrency-control-precisely","title":"Scope concurrency control precisely","description":"Apply concurrency control mechanisms with precise scope to prevent both race conditions and unnecessary blocking. Use appropriate synchronization tools (mutex, channels, errgroup) only around critical sections that actually require protection.","repository":"docker/compose","domain":"orchestration","topic":"Concurrency","language":"Go","updated":"2025-06-30","comments":5,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-scope-concurrency-control-precisely.md"},{"slug":"gemini-cli-use-specific-configuration-patterns","title":"Use specific configuration patterns","description":"When defining exclusion patterns, file filters, or other configuration rules, use specific, targeted patterns rather than broad glob patterns. Overly broad patterns can lead to unintended exclusions and hard-to-debug issues in the future when legitimate files need to be included.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Configurations","language":"Json","updated":"2025-06-30","comments":5,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-use-specific-configuration-patterns.md"},{"slug":"node-standardize-null-pointer-checks","title":"Standardize null pointer checks","description":"Always use standard null-checking patterns like CHECK_NOT_NULL for pointer validation instead of manual null checks. This ensures consistent error handling and improves code readability. For functions that may return null objects, consider using wrapper types like MaybeLocal to properly propagate null states.","repository":"nodejs/node","domain":"runtimes","topic":"Null Handling","language":"Other","updated":"2025-06-30","comments":5,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-standardize-null-pointer-checks.md"},{"slug":"quarkus-name-for-meaning-first","title":"Name for meaning first","description":"Choose names that prioritize domain meaning and clarity over implementation details. This applies to methods, variables, constants, and configuration properties. Names should be immediately understandable to developers working in the domain, without requiring knowledge of the underlying implementation.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Naming Conventions","language":"Java","updated":"2025-06-30","comments":5,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-name-for-meaning-first.md"},{"slug":"rails-write-complete-api-examples","title":"Write complete API examples","description":"Always provide complete, context-rich code examples in API documentation. Examples should show the full usage context and avoid abbreviated or partial code snippets that may confuse developers.","repository":"rails/rails","domain":"app-frameworks","topic":"Documentation","language":"Ruby","updated":"2025-06-30","comments":5,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-write-complete-api-examples.md"},{"slug":"roo-code-write-resilient-test-assertions","title":"Write resilient test assertions","description":"Write test assertions that are resilient to implementation changes by focusing on behavior rather than implementation details. Avoid exact matches when partial or behavioral assertions would suffice.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Testing","language":"TypeScript","updated":"2025-06-30","comments":5,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-write-resilient-test-assertions.md"},{"slug":"stagehand-use-descriptive-names","title":"Use descriptive names","description":"Choose descriptive, domain-specific names that clearly communicate intent and prevent confusion. Avoid generic names when more specific alternatives exist, especially when working alongside similar types or concepts from external libraries.","repository":"browserbase/stagehand","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2025-06-30","comments":5,"stars":16443,"raw":"https://awesomereviewers.com/raw/stagehand-use-descriptive-names.md"},{"slug":"compose-prevent-sensitive-data-exposure","title":"Prevent sensitive data exposure","description":"Implement comprehensive checks to prevent accidental exposure of sensitive data through multiple vectors in configuration files and deployment artifacts. This includes validating environment variables, file permissions, bind mounts, and individual configuration files before publishing or deployment.","repository":"docker/compose","domain":"orchestration","topic":"Security","language":"Go","updated":"2025-06-30","comments":4,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-prevent-sensitive-data-exposure.md"},{"slug":"continue-safe-property-access","title":"Safe property access","description":"Always use proper null safety patterns when accessing properties that might be null or undefined. This prevents runtime errors and improves code robustness.","repository":"continuedev/continue","domain":"ai-agents","topic":"Null Handling","language":"TSX","updated":"2025-06-30","comments":4,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-safe-property-access.md"},{"slug":"elasticsearch-defensive-null-handling","title":"Defensive null handling","description":"Always handle null references and values defensively to prevent NullPointerExceptions and unexpected behavior. Follow these practices: 1. **Check nulls before dereferencing**: Always verify a reference is not null before accessing its methods or properties:","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Null Handling","language":"Java","updated":"2025-06-30","comments":4,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-defensive-null-handling.md"},{"slug":"elasticsearch-parallel-branch-traceability","title":"Parallel branch traceability","description":"When implementing algorithms with parallel processing branches, ensure proper traceability and data consistency across all branches to facilitate result analysis and debugging:","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Algorithms","language":"Markdown","updated":"2025-06-30","comments":4,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-parallel-branch-traceability.md"},{"slug":"grafana-minimize-database-joins","title":"Minimize database joins","description":"Prefer direct filtering or specialized service methods over complex JOIN operations, especially when maintaining or refactoring database access patterns. JOINs across multiple tables can impact performance and make code more difficult to maintain, particularly during architectural migrations.","repository":"grafana/grafana","domain":"observability","topic":"Database","language":"Go","updated":"2025-06-30","comments":4,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-minimize-database-joins.md"},{"slug":"grafana-name-for-purpose-first","title":"Name for purpose first","description":"Choose names that lead with their primary purpose or category, followed by specific details. This makes code more discoverable and self-documenting by grouping related items and clearly conveying intent.","repository":"grafana/grafana","domain":"observability","topic":"Naming Conventions","language":"Go","updated":"2025-06-30","comments":4,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-name-for-purpose-first.md"},{"slug":"n8n-configuration-consistency-management","title":"Configuration consistency management","description":"When modifying configuration files, ensure all references to the changed values are updated consistently across the entire project. Configuration changes rarely exist in isolation - they often have ripple effects throughout the codebase.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Configurations","language":"Json","updated":"2025-06-30","comments":4,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-configuration-consistency-management.md"},{"slug":"pydantic-simple-defaults-flexible-overrides","title":"Simple defaults, flexible overrides","description":"Design APIs with intuitive defaults for common use cases while providing specialized options for edge cases. This approach makes your API approachable for most users while maintaining flexibility for advanced scenarios.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"API","language":"Python","updated":"2025-06-30","comments":4,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-simple-defaults-flexible-overrides.md"},{"slug":"runtime-maintain-consistent-formatting","title":"Maintain consistent formatting","description":"Ensure consistent formatting and organization throughout the codebase to improve readability and maintainability. This includes: 1. **Consistent spacing and alignment**","repository":"dotnet/runtime","domain":"runtimes","topic":"Code Style","language":"Other","updated":"2025-06-30","comments":4,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-maintain-consistent-formatting.md"},{"slug":"uv-consistent-authentication-patterns","title":"Consistent authentication patterns","description":"Design API authentication mechanisms with consistent patterns, clear documentation, and helpful error messages. When implementing authentication: 1. **Document authentication requirements explicitly**:","repository":"astral-sh/uv","domain":"devtools","topic":"API","language":"Markdown","updated":"2025-06-30","comments":4,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-consistent-authentication-patterns.md"},{"slug":"continue-standardize-llm-configurations","title":"Standardize LLM configurations","description":"When configuring LLM providers and their capabilities, always use proper JSON syntax with quoted property names and explicitly declare all relevant capabilities. This ensures your AI models work as expected with the correct features enabled.","repository":"continuedev/continue","domain":"ai-agents","topic":"AI","language":"Markdown","updated":"2025-06-30","comments":3,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-standardize-llm-configurations.md"},{"slug":"core-configuration-status-accuracy","title":"configuration status accuracy","description":"Ensure that configuration file status values accurately reflect the actual implementation state. Use 'done' only when features are fully implemented, 'todo' for planned but unimplemented features, and 'exempt' for features that don't apply to the integration. Always provide clear, descriptive comments explaining why items are marked as exempt.","repository":"home-assistant/core","domain":"app-frameworks","topic":"Configurations","language":"Yaml","updated":"2025-06-30","comments":3,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-configuration-status-accuracy.md"},{"slug":"elasticsearch-stage-intensive-operations-carefully","title":"Stage intensive operations carefully","description":"When implementing operations that consume significant system resources (CPU, memory, I/O), introduce changes gradually while monitoring performance. This prevents cascading performance issues that can degrade the entire system.","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Performance Optimization","language":"Markdown","updated":"2025-06-30","comments":3,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-stage-intensive-operations-carefully.md"},{"slug":"pytorch-modular-configuration-design","title":"Modular configuration design","description":"Configuration systems should be designed with modularity and clarity in mind. When creating configuration classes or mechanisms: 1. **Separate generic from specific configurations**: Organize configuration options by their scope and applicability. Use class hierarchies or namespaces to isolate domain-specific settings from generic ones.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Configurations","language":"Other","updated":"2025-06-30","comments":3,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-modular-configuration-design.md"},{"slug":"react-native-feature-flag-isolation","title":"Feature flag isolation","description":"Feature flags should be properly isolated and scoped to avoid mixing configuration concerns with core interfaces. When implementing feature flags, ensure they only affect behavior when explicitly enabled and don't leak into unrelated system components.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Configurations","language":"Kotlin","updated":"2025-06-30","comments":3,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-feature-flag-isolation.md"},{"slug":"runtime-validate-before-access","title":"Validate before access","description":"Always validate parameters and initialize variables before access to prevent null dereference and undefined behavior. When handling arrays or pointers, require and validate length parameters. For conditionally initialized variables, ensure all code paths explicitly set values.","repository":"dotnet/runtime","domain":"runtimes","topic":"Null Handling","language":"C","updated":"2025-06-30","comments":3,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-validate-before-access.md"},{"slug":"goose-sanitize-untrusted-input","title":"Sanitize untrusted input","description":"Always sanitize or escape untrusted input before using it in security-sensitive contexts to prevent injection attacks. This includes HTML content that could lead to XSS vulnerabilities and user-provided strings used in regex patterns.","repository":"block/goose","domain":"ai-agents","topic":"Security","language":"TSX","updated":"2025-06-30","comments":2,"stars":19037,"raw":"https://awesomereviewers.com/raw/goose-sanitize-untrusted-input.md"},{"slug":"roo-code-avoid-hardcoded-configurations","title":"Avoid hardcoded configurations","description":"Always extract configuration values from appropriate sources (config files, environment variables, etc.) rather than hardcoding them in your code. Include validation to ensure the configuration is valid before use, and provide sensible defaults with the ability to override when needed.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Configurations","language":"JavaScript","updated":"2025-06-30","comments":2,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-avoid-hardcoded-configurations.md"},{"slug":"bazel-temporary-security-workarounds","title":"temporary security workarounds","description":"When implementing workarounds for OS-level security restrictions, ensure they are explicitly temporary and include clear plans for proper long-term solutions. Avoid recommending users bypass security features through unofficial methods, and instead guide them toward sanctioned approaches when possible.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Security","language":"Java","updated":"2025-06-30","comments":1,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-temporary-security-workarounds.md"},{"slug":"gemini-cli-test-security-end-to-end","title":"test security end-to-end","description":"Security features must be tested using the actual executable or CLI rather than just module-level unit tests. This ensures the complete security mechanism works end-to-end in the real execution environment, not just individual components in isolation.","repository":"google-gemini/gemini-cli","domain":"ai-agents","topic":"Security","language":"JavaScript","updated":"2025-06-30","comments":1,"stars":65062,"raw":"https://awesomereviewers.com/raw/gemini-cli-test-security-end-to-end.md"},{"slug":"sentry-comprehensive-authentication-notifications","title":"Comprehensive authentication notifications","description":"Authentication notifications must include specific context about the triggering action, clear instructions for legitimate use, expiration details, and explicit steps to take if the action was unauthorized. This enhances security by helping users identify potential account compromises and take appropriate action.","repository":"getsentry/sentry","domain":"observability","topic":"Security","language":"Html","updated":"2025-06-30","comments":1,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-comprehensive-authentication-notifications.md"},{"slug":"node-idempotent-error-safe-disposers","title":"Idempotent error-safe disposers","description":"When implementing resource cleanup logic, especially disposers for explicit resource management, always design for resilience during error conditions:","repository":"nodejs/node","domain":"runtimes","topic":"Error Handling","language":"Markdown","updated":"2025-06-29","comments":11,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-idempotent-error-safe-disposers.md"},{"slug":"airflow-use-descriptive-action-names","title":"Use descriptive action names","description":"Names should clearly indicate purpose and behavior using appropriate action verbs and descriptive terms. This applies to functions, methods, variables, and classes. Avoid generic or ambiguous names that don't convey the actual functionality.","repository":"apache/airflow","domain":"orchestration","topic":"Naming Conventions","language":"Python","updated":"2025-06-29","comments":8,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-use-descriptive-action-names.md"},{"slug":"express-single-source-documentation","title":"Single source documentation","description":"Maintain documentation with a single source of truth to prevent inconsistencies and reduce maintenance burden. When information exists elsewhere, link to it rather than duplicating content. This applies to code of conduct references, governance documents, and API documentation.","repository":"expressjs/express","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-06-29","comments":8,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-single-source-documentation.md"},{"slug":"elasticsearch-prefer-callbacks-over-blocking","title":"Prefer callbacks over blocking","description":"Always structure concurrent code to use asynchronous callbacks instead of blocking operations. Blocking calls like CountDownLatch, Thread.join(), or Future.get() can lead to thread starvation, reduced throughput, and complex deadlock scenarios.","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Concurrency","language":"Java","updated":"2025-06-29","comments":6,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-prefer-callbacks-over-blocking.md"},{"slug":"polars-optimize-memory-allocation-patterns","title":"Optimize memory allocation patterns","description":"Minimize memory allocations and optimize allocation patterns to improve performance. Key practices: 1. Pre-allocate collections with known sizes 2. Avoid unnecessary intermediate allocations","repository":"pola-rs/polars","domain":"data-systems","topic":"Performance Optimization","language":"Rust","updated":"2025-06-29","comments":6,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-optimize-memory-allocation-patterns.md"},{"slug":"rails-follow-documentation-conventions","title":"Follow documentation conventions","description":"Maintain consistent formatting and style in all documentation to improve readability and professionalism: 1. **Use proper formatting for code elements**:","repository":"rails/rails","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-06-29","comments":6,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-follow-documentation-conventions.md"},{"slug":"airflow-internationalize-ui-text","title":"Internationalize ui text","description":"All user interface text must be internationalized using the appropriate i18n module instead of hardcoded strings. This ensures the application can be properly localized for different languages and regions.","repository":"apache/airflow","domain":"orchestration","topic":"Documentation","language":"TSX","updated":"2025-06-29","comments":5,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-internationalize-ui-text.md"},{"slug":"node-use-modern-c-features","title":"Use modern C++ features","description":"Embrace modern C++20 features throughout the codebase to improve code readability, maintainability, and performance. Specifically: 1. Use condensed namespace syntax:","repository":"nodejs/node","domain":"runtimes","topic":"Code Style","language":"Other","updated":"2025-06-29","comments":5,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-use-modern-c-features.md"},{"slug":"airflow-consistent-technical-term-translation","title":"Consistent technical term translation","description":"When localizing an application, maintain consistent conventions for technical terms while respecting language-specific rules: 1. For acronyms, follow the target language''s capitalization conventions:","repository":"apache/airflow","domain":"orchestration","topic":"Naming Conventions","language":"Json","updated":"2025-06-29","comments":4,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-consistent-technical-term-translation.md"},{"slug":"cal.com-use-unstable-cache-directly","title":"Use unstable_cache directly","description":"When implementing server-side caching in Next.js applications, prefer using `unstable_cache` with direct repository method calls instead of tRPC callers. This approach provides better performance and proper integration with Next.js caching mechanisms.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Caching","language":"TSX","updated":"2025-06-29","comments":2,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-use-unstable-cache-directly.md"},{"slug":"node-benchmark-before-optimizing-code","title":"Benchmark before optimizing code","description":"Performance optimizations should be validated through benchmarks before implementation. This helps prevent premature optimization and ensures changes actually improve performance in real-world scenarios.","repository":"nodejs/node","domain":"runtimes","topic":"Performance Optimization","language":"JavaScript","updated":"2025-06-28","comments":7,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-benchmark-before-optimizing-code.md"},{"slug":"runtime-model-actual-hardware-costs","title":"Model actual hardware costs","description":"Base optimization decisions on accurate hardware cost models rather than outdated assumptions. Modern architectures have different performance characteristics for operations than older hardware, especially for SIMD and memory operations.","repository":"dotnet/runtime","domain":"runtimes","topic":"Performance Optimization","language":"C++","updated":"2025-06-28","comments":6,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-model-actual-hardware-costs.md"},{"slug":"fastapi-standardize-version-transitions","title":"Standardize version transitions","description":"When supporting multiple library versions or preparing for version deprecation in configuration-dependent code, use standardized TODO comments with consistent formatting. Always include a space after the # symbol and use the prefix \"TODO:\" to ensure comments can be found with standard search tools.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Configurations","language":"Python","updated":"2025-06-28","comments":3,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-standardize-version-transitions.md"},{"slug":"iptv-validate-stream-documentation","title":"Validate stream documentation","description":"When updating playlist/stream documentation (e.g., .m3u EXTINF entries), ensure **both the URL and the metadata follow the documented stream-description scheme** and are **not based on player-specific behavior**.","repository":"iptv-org/iptv","domain":"docs","topic":"Documentation","language":"Other","updated":"2025-06-28","comments":3,"stars":135586,"raw":"https://awesomereviewers.com/raw/iptv-validate-stream-documentation.md"},{"slug":"airflow-natural-language-translations","title":"Natural language translations","description":"When providing translations for user interface elements and documentation, prioritize natural and idiomatic expressions in the target language rather than literal translations. Consider the grammatical rules and cultural context of each language to ensure the translated text sounds native to users.","repository":"apache/airflow","domain":"orchestration","topic":"Documentation","language":"Json","updated":"2025-06-28","comments":2,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-natural-language-translations.md"},{"slug":"airflow-optimize-ci-configurations","title":"Optimize CI configurations","description":"When designing CI/CD workflows, prioritize both resource efficiency and clear documentation. Incorporate dynamic configuration where beneficial, but avoid creating separate jobs for simple tasks that can be handled within existing steps. Ensure all comments and configurations accurately reflect version requirements across all supported branches,...","repository":"apache/airflow","domain":"orchestration","topic":"CI/CD","language":"Yaml","updated":"2025-06-28","comments":2,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-optimize-ci-configurations.md"},{"slug":"azure-sdk-for-net-approve-ai-dependencies-conditionally","title":"Approve AI dependencies conditionally","description":"All AI-related dependencies (Microsoft.Extensions.AI.*, etc.) require explicit approval before inclusion and must be restricted to specific packages using conditional blocks in Packages.Data.props. Prefer version 8.x dependencies when available, and document any exceptions (such as using 9.x) with clear comments explaining the approval scope and reasoning.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"AI","language":"Other","updated":"2025-06-28","comments":2,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-approve-ai-dependencies-conditionally.md"},{"slug":"fiber-api-design-clarity","title":"API design clarity","description":"Maintain clear separation of concerns in API design by avoiding feature overlap and ensuring each method has a distinct, well-defined purpose. When designing APIs, resist the temptation to add convenience features that blur the boundaries between different configuration approaches, as this leads to user confusion and maintenance issues.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2025-06-28","comments":2,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-api-design-clarity.md"},{"slug":"ruff-logical-content-organization","title":"Logical content organization","description":"Organize code and documentation logically based on functionality and dependencies. Place files in directories that reflect their purpose rather than superficial characteristics. Structure documentation so prerequisite concepts appear before concepts that depend on them.","repository":"astral-sh/ruff","domain":"devtools","topic":"Code Style","language":"Markdown","updated":"2025-06-28","comments":2,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-logical-content-organization.md"},{"slug":"runtime-explicit-api-versioning","title":"Explicit API versioning","description":"When extending interfaces with new methods or functionality, always implement proper versioning to ensure compatibility across different clients. Breaking changes should increment major versions, while additive changes should increment minor versions. More importantly, implement version checks in your code to gracefully handle compatibility.","repository":"dotnet/runtime","domain":"runtimes","topic":"API","language":"Other","updated":"2025-06-28","comments":2,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-explicit-api-versioning.md"},{"slug":"vllm-ai-model-persistence","title":"AI model persistence","description":"When containerizing AI applications, ensure proper model persistence by mounting volumes to the default cache locations used by AI frameworks and setting appropriate environment variables. This prevents redundant downloads of large models and improves development efficiency.","repository":"vllm-project/vllm","domain":"llm-infra","topic":"AI","language":"Other","updated":"2025-06-28","comments":2,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-ai-model-persistence.md"},{"slug":"opencv-code-for-readability","title":"Code for readability","description":"Prioritize human readability when writing code. Split complex expressions into steps with meaningful variable names. Extract repeated logic into well-named functions. Avoid magic numbers - derive values from existing structures or use named constants. Simplify control flow by reducing nesting levels and using early returns.","repository":"opencv/opencv","domain":"ml-systems","topic":"Code Style","language":"C++","updated":"2025-06-27","comments":13,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-code-for-readability.md"},{"slug":"n8n-vue-component-test-requirement","title":"Vue component test requirement","description":"Every Vue component (.vue file) that is created or modified must have at least one corresponding unit test file. The test must import the component, mount it, and include assertions that validate its behavior.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Testing","language":"Other","updated":"2025-06-27","comments":9,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-vue-component-test-requirement.md"},{"slug":"litellm-follow-consistent-naming-patterns","title":"Follow consistent naming patterns","description":"Maintain consistent naming conventions across all aspects of the codebase, including file structures, folder organization, environment variables, and identifiers. This ensures predictability and reduces cognitive load for developers.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Naming Conventions","language":"Python","updated":"2025-06-27","comments":7,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-follow-consistent-naming-patterns.md"},{"slug":"ruff-choose-error-strategies-deliberately","title":"Choose error strategies deliberately","description":"Make deliberate choices about error handling strategies based on the context. Decide between early returns with appropriate error reporting, panic mechanisms, or silent failures with diagnostics:","repository":"astral-sh/ruff","domain":"devtools","topic":"Error Handling","language":"Rust","updated":"2025-06-27","comments":7,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-choose-error-strategies-deliberately.md"},{"slug":"vite-descriptive-consistent-naming","title":"Descriptive consistent naming","description":"Choose variable, function, and class names that accurately reflect their purpose while maintaining consistency with established patterns in the codebase. When the purpose or content of an entity changes, update its name accordingly. This applies to:","repository":"vitejs/vite","domain":"devtools","topic":"Naming Conventions","language":"TypeScript","updated":"2025-06-27","comments":7,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-descriptive-consistent-naming.md"},{"slug":"ant-design-dependency-versioning-consistency","title":"Dependency versioning consistency","description":"Establish and maintain consistent dependency versioning strategies in package.json configuration. Choose between caret (^) and tilde (~) ranges based on stability requirements and update policies. For stable production dependencies, prefer tilde ranges to avoid unexpected breaking changes, while development dependencies can use caret ranges for latest...","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2025-06-27","comments":6,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-dependency-versioning-consistency.md"},{"slug":"core-avoid-redundant-computations","title":"Avoid redundant computations","description":"Identify and eliminate redundant operations that cause performance bottlenecks by caching expensive function results, performing transformations only when necessary, and implementing lazy evaluation patterns.","repository":"vuejs/core","domain":"app-frameworks","topic":"Performance Optimization","language":"TypeScript","updated":"2025-06-27","comments":6,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-avoid-redundant-computations.md"},{"slug":"django-use-connection-by-alias","title":"Use connection by alias","description":"When working with database operations in Django projects that might use multiple database backends, always access database features and operations through `connections[alias]` instead of the global `connection` object. This ensures your code works correctly regardless of which database backend is being used for a specific operation.","repository":"django/django","domain":"app-frameworks","topic":"Database","language":"Python","updated":"2025-06-27","comments":6,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-use-connection-by-alias.md"},{"slug":"django-structure-logs-effectively","title":"Structure logs effectively","description":"When implementing logging in your application, structure your log messages and parameters consistently to improve readability, searchability, and integration with monitoring tools. Consider these practices:","repository":"django/django","domain":"app-frameworks","topic":"Logging","language":"Python","updated":"2025-06-27","comments":5,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-structure-logs-effectively.md"},{"slug":"grafana-standardize-observability-semantic-conventions","title":"Standardize observability semantic conventions","description":"When implementing observability features (logs, metrics, traces), use consistent semantic conventions to ensure data can be correlated and analyzed efficiently across the entire system.","repository":"grafana/grafana","domain":"observability","topic":"Observability","language":"Go","updated":"2025-06-27","comments":5,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-standardize-observability-semantic-conventions.md"},{"slug":"inbox-zero-transactional-verified-migrations","title":"Transactional verified migrations","description":"Enhance database migration reliability by wrapping changes in transactions with pre-check and post-verification steps. This pattern prevents partial migrations that could leave your database in an inconsistent state.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Migrations","language":"Sql","updated":"2025-06-27","comments":5,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-transactional-verified-migrations.md"},{"slug":"node-document-with-precise-accuracy","title":"Document with precise accuracy","description":"Maintain precise and accurate documentation through both JSDoc annotations and explanatory comments. Ensure all technical documentation matches the actual implementation, avoiding inconsistencies between code and documentation.","repository":"nodejs/node","domain":"runtimes","topic":"Documentation","language":"JavaScript","updated":"2025-06-27","comments":5,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-document-with-precise-accuracy.md"},{"slug":"prowler-safe-attribute-access-patterns","title":"Safe attribute access patterns","description":"Implement consistent patterns for safely accessing potentially null or undefined attributes and dictionary values. This prevents runtime errors and makes code more robust.","repository":"prowler-cloud/prowler","domain":"security","topic":"Null Handling","language":"Python","updated":"2025-06-27","comments":5,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-safe-attribute-access-patterns.md"},{"slug":"runtime-document-code-meaningfully","title":"Document code meaningfully","description":"Provide meaningful documentation that enhances code maintainability and understanding. Follow these practices: 1. **Explain the \"why\"** - Document complex or non-obvious code behavior with comments that explain reasoning, not just functionality:","repository":"dotnet/runtime","domain":"runtimes","topic":"Documentation","language":"C#","updated":"2025-06-27","comments":5,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-document-code-meaningfully.md"},{"slug":"airflow-explicit-version-constraints","title":"Explicit version constraints","description":"Always specify explicit version constraints for dependencies in configuration files (like pyproject.toml), particularly when dealing with Python version compatibility. Use conditional dependencies based on Python versions to handle compatibility issues, and include explanatory comments when adding constraints.","repository":"apache/airflow","domain":"orchestration","topic":"Configurations","language":"Toml","updated":"2025-06-27","comments":4,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-explicit-version-constraints.md"},{"slug":"elasticsearch-exceptions-for-critical-errors","title":"Exceptions for critical errors","description":"Use exceptions rather than assertions for handling critical error conditions that need to be caught in production. Assertions should only be used for development-time invariant checking that should never occur in production code.","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Error Handling","language":"Java","updated":"2025-06-27","comments":4,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-exceptions-for-critical-errors.md"},{"slug":"material-ui-strict-mode-proof-hooks","title":"Strict mode-proof hooks","description":"Ensure your React components work correctly in both development (Strict Mode) and production environments by writing hooks that handle React''s intentional double-rendering behavior. When using side effects in initializers, guard them with refs to prevent duplicate executions:","repository":"mui/material-ui","domain":"app-frameworks","topic":"React","language":"JavaScript","updated":"2025-06-27","comments":4,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-strict-mode-proof-hooks.md"},{"slug":"netty-optimize-search-operations","title":"Optimize search operations","description":"Enhance search algorithm performance by prioritizing common cases, using appropriate data structures, and avoiding unnecessary operations. When implementing binary search:","repository":"netty/netty","domain":"runtimes","topic":"Algorithms","language":"Java","updated":"2025-06-27","comments":4,"stars":34227,"raw":"https://awesomereviewers.com/raw/netty-optimize-search-operations.md"},{"slug":"sentry-explicit-optional-type-declarations","title":"Explicit optional type declarations","description":"Always explicitly declare optional types in interfaces and function parameters rather than relying on runtime checks or using `any`. This improves type safety, makes null/undefined handling requirements clear, and prevents runtime errors.","repository":"getsentry/sentry","domain":"observability","topic":"Null Handling","language":"TSX","updated":"2025-06-27","comments":4,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-explicit-optional-type-declarations.md"},{"slug":"union-configuration-file-completeness","title":"Configuration file completeness","description":"Ensure all configuration files contain required fields, maintain proper structure, and follow consistent formatting standards. Configuration files should be complete with all mandatory nodes present, properly sorted for consistency, and preserve critical values that shouldn't be auto-updated.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Configurations","language":"Json","updated":"2025-06-27","comments":4,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-configuration-file-completeness.md"},{"slug":"elasticsearch-scope-and-document-configurations","title":"Scope and document configurations","description":"When designing and implementing configuration options, carefully consider two key aspects: 1. **Choose appropriate configuration scope**: Place configuration settings at the level that makes the most sense for their purpose and usage pattern. Avoid overly granular scopes when settings could logically apply at a broader level.","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Configurations","language":"Markdown","updated":"2025-06-27","comments":3,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-scope-and-document-configurations.md"},{"slug":"fastapi-proper-response-handling","title":"Proper response handling","description":"When designing APIs, ensure responses adhere to HTTP semantics by: 1. Using semantic status code constants instead of magic numbers ```python # Bad raise HTTPException(status_code=400, detail=\"Inactive user\")","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"API","language":"Python","updated":"2025-06-27","comments":3,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-proper-response-handling.md"},{"slug":"grafana-complete-configuration-fields","title":"Complete configuration fields","description":"Ensure all plugin configuration files include the complete set of required fields specific to their plugin type. Missing configuration fields can cause unexpected behavior or failures when the plugin is used.","repository":"grafana/grafana","domain":"observability","topic":"Configurations","language":"Json","updated":"2025-06-27","comments":3,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-complete-configuration-fields.md"},{"slug":"grafana-maintain-api-version-compatibility","title":"Maintain API version compatibility","description":"When implementing or modifying APIs, ensure backward compatibility across versions and client interfaces. Carefully evaluate field structures, method visibility, and response formats for consistency.","repository":"grafana/grafana","domain":"observability","topic":"API","language":"TypeScript","updated":"2025-06-27","comments":3,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-maintain-api-version-compatibility.md"},{"slug":"llama.cpp-optimize-algorithmic-complexity","title":"optimize algorithmic complexity","description":"When implementing or refactoring algorithms, prioritize efficient data structures and computational approaches over simpler but slower alternatives. This is especially critical in performance-sensitive code where operations may be called frequently.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Algorithms","language":"C","updated":"2025-06-27","comments":3,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-optimize-algorithmic-complexity.md"},{"slug":"sentry-consistent-url-design","title":"Consistent URL design","description":"Design API endpoints with consistent, unambiguous URL patterns to improve usability and maintainability. Follow these principles: 1. **Use descriptive parameter names** that clearly indicate their purpose","repository":"getsentry/sentry","domain":"observability","topic":"API","language":"Python","updated":"2025-06-27","comments":3,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-consistent-url-design.md"},{"slug":"vllm-protect-shared-state","title":"Protect shared state","description":"When mutable state (like dictionaries, lists, or counters) is accessed from multiple threads or concurrent tasks, use appropriate synchronization mechanisms to prevent race conditions. Unprotected access to shared state can lead to data corruption, inconsistent behavior, and hard-to-debug issues.","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Concurrency","language":"Python","updated":"2025-06-27","comments":3,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-protect-shared-state.md"},{"slug":"azure-sdk-for-net-document-ai-changes-thoroughly","title":"Document AI changes thoroughly","description":"When updating AI libraries and SDKs, ensure all changes are thoroughly documented in changelogs with clear categorizations (Features Added, Breaking Changes) and explicit migration paths for breaking changes. For complex AI features, include links to detailed documentation.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"AI","language":"Markdown","updated":"2025-06-27","comments":2,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-document-ai-changes-thoroughly.md"},{"slug":"grafana-contextual-structured-logging","title":"Contextual structured logging","description":"Log messages should provide sufficient context to be meaningful and actionable while following structured logging patterns. Include relevant metrics, ratios, or identifiers that help diagnose issues. Use semantic conventions and structured key-value pairs rather than embedding values in message strings.","repository":"grafana/grafana","domain":"observability","topic":"Logging","language":"Go","updated":"2025-06-27","comments":2,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-contextual-structured-logging.md"},{"slug":"grafana-use-dynamic-port-allocation","title":"Use dynamic port allocation","description":"When writing tests that require network services (HTTP, gRPC, or custom protocols), use port 0 to let the operating system assign available ports rather than hard-coding specific port numbers. Hard-coded ports can cause conflicts when multiple tests run simultaneously, leading to flaky tests.","repository":"grafana/grafana","domain":"observability","topic":"Networking","language":"Go","updated":"2025-06-27","comments":2,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-use-dynamic-port-allocation.md"},{"slug":"prometheus-test-practical-monitoring-scenarios","title":"test practical monitoring scenarios","description":"When writing tests for observability features like metrics, functions, and alerting expressions, ensure test cases cover practical, real-world monitoring scenarios in addition to edge cases. Focus on common usage patterns that developers will actually use in production monitoring and alerting.","repository":"prometheus/prometheus","domain":"observability","topic":"Observability","language":"Other","updated":"2025-06-27","comments":2,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-test-practical-monitoring-scenarios.md"},{"slug":"quarkus-optimize-elimination-paths","title":"Optimize elimination paths","description":"When implementing algorithms that process large data structures or complex computational paths, prioritize opportunities for dead code elimination (DCE) and path optimization. Different initialization strategies (like build-time vs. runtime initialization) can dramatically affect which code paths are evaluated and optimized.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Algorithms","language":"Other","updated":"2025-06-27","comments":2,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-optimize-elimination-paths.md"},{"slug":"ruff-test-edge-cases","title":"Test edge cases","description":"When writing tests, prioritize coverage of edge cases and non-standard code patterns to ensure robust functionality. Particularly for linting rules or code transformations, identify scenarios that might behave unexpectedly or require special handling.","repository":"astral-sh/ruff","domain":"devtools","topic":"Testing","language":"Python","updated":"2025-06-27","comments":2,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-test-edge-cases.md"},{"slug":"sentry-optimize-lookup-operations","title":"Optimize lookup operations","description":"Choose appropriate data structures to minimize computational complexity when performing lookups. Prefer direct lookups (maps/dictionaries) over repeated array traversals, and use set-based inclusion checks for membership testing rather than multiple conditionals.","repository":"getsentry/sentry","domain":"observability","topic":"Algorithms","language":"TSX","updated":"2025-06-27","comments":2,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-optimize-lookup-operations.md"},{"slug":"prometheus-http-security-headers","title":"HTTP security headers","description":"Ensure that HTTP security headers are properly implemented and documented to prevent web vulnerabilities such as cache poisoning, clickjacking, and content type sniffing attacks. Security headers should be explicitly added to API responses and web endpoints as defensive measures.","repository":"prometheus/prometheus","domain":"observability","topic":"Security","language":"Markdown","updated":"2025-06-27","comments":1,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-http-security-headers.md"},{"slug":"electron-provide-contextual-explanations","title":"Provide contextual explanations","description":"Documentation should explain not just what APIs and features do, but when, why, and how to use them. Provide sufficient context for developers to understand the purpose, appropriate use cases, and practical implementation details.","repository":"electron/electron","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2025-06-26","comments":12,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-provide-contextual-explanations.md"},{"slug":"zed-design-interfaces-not-implementations","title":"Design interfaces, not implementations","description":"Create intuitive API interfaces that abstract away implementation details while providing a consistent experience for consumers. Use appropriate parameter types that express intent and maintain established patterns across your codebase.","repository":"zed-industries/zed","domain":"devtools","topic":"API","language":"Rust","updated":"2025-06-26","comments":12,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-design-interfaces-not-implementations.md"},{"slug":"polars-appropriate-error-handling","title":"Appropriate error handling","description":"Distinguish between implementation errors (invariant violations) and expected failure cases. For implementation errors that should never occur, use `unreachable!()` with explanatory comments rather than generic `panic!()` or `todo!()`. For expected failure modes, return proper error types with informative messages.","repository":"pola-rs/polars","domain":"data-systems","topic":"Error Handling","language":"Rust","updated":"2025-06-26","comments":9,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-appropriate-error-handling.md"},{"slug":"runtime-follow-naming-patterns","title":"Follow naming patterns","description":"Maintain consistent naming patterns throughout your code to improve readability and maintainability. Follow these guidelines: 1. Use PascalCase for public methods and members","repository":"dotnet/runtime","domain":"runtimes","topic":"Naming Conventions","language":"C#","updated":"2025-06-26","comments":9,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-follow-naming-patterns.md"},{"slug":"runtime-optimize-memory-access","title":"Optimize memory access","description":"When implementing performance-critical algorithms, carefully consider memory access patterns. Document alignment assumptions when using low-level operations like `MemoryMarshal.Cast` or SIMD intrinsics. Prefer reference-based APIs over pinning to avoid GC interference. For bulk operations, use specialized helpers like `LoadUnsafe(ref T source, nuint...","repository":"dotnet/runtime","domain":"runtimes","topic":"Algorithms","language":"C#","updated":"2025-06-26","comments":9,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-optimize-memory-access.md"},{"slug":"spring-boot-optimize-test-case-design","title":"Optimize test case design","description":"Write focused, efficient tests that validate core functionality without unnecessary complexity. Key principles: 1. Test one concept per case 2. Use appropriate test scope (unit vs integration)","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Testing","language":"Java","updated":"2025-06-26","comments":8,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-optimize-test-case-design.md"},{"slug":"prisma-database-provider-compatibility","title":"Database provider compatibility","description":"Ensure database code properly handles provider-specific differences and capabilities. Different database providers have varying syntax requirements, feature support, and connection methods that must be accounted for in the implementation.","repository":"prisma/prisma","domain":"data-systems","topic":"Database","language":"TypeScript","updated":"2025-06-26","comments":7,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-database-provider-compatibility.md"},{"slug":"grafana-descriptive-semantic-names","title":"Descriptive semantic names","description":"Always use descriptive variable, parameter, function, and constant names that clearly convey their purpose and behavior. Avoid single-letter variables or abbreviations except in well-established contexts like loop counters.","repository":"grafana/grafana","domain":"observability","topic":"Naming Conventions","language":"TSX","updated":"2025-06-26","comments":6,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-descriptive-semantic-names.md"},{"slug":"neon-optimize-cargo-dependencies","title":"Optimize cargo dependencies","description":"Maintain clean and efficient dependency configurations in Cargo.toml files by following these practices: 1. **Use workspace inheritance** when available for common settings and dependencies:","repository":"neondatabase/neon","domain":"data-systems","topic":"Configurations","language":"Toml","updated":"2025-06-26","comments":6,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-optimize-cargo-dependencies.md"},{"slug":"react-router-configuration-compatibility-validation","title":"configuration compatibility validation","description":"Ensure that code examples and documentation accurately reflect the constraints and requirements of different rendering modes and configurations. When documenting APIs or providing examples, verify that the suggested approach is compatible with the specific rendering context (SSR, SSG, client-side) and configuration options being used.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Next","language":"Markdown","updated":"2025-06-26","comments":6,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-configuration-compatibility-validation.md"},{"slug":"deno-avoid-panics-gracefully","title":"avoid panics gracefully","description":"Replace panic-prone operations like `unwrap()` and `expect()` with graceful error handling that provides meaningful feedback. When encountering unexpected conditions, prefer logging warnings and falling back to reasonable defaults rather than crashing the application.","repository":"denoland/deno","domain":"runtimes","topic":"Error Handling","language":"Rust","updated":"2025-06-26","comments":5,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-avoid-panics-gracefully.md"},{"slug":"django-graceful-api-evolution","title":"Graceful API evolution","description":"When evolving APIs, prioritize backward compatibility and provide clear migration paths. For any significant change: 1. Add explicit deprecation warnings that explain what''s changing and how to adapt code","repository":"django/django","domain":"app-frameworks","topic":"API","language":"Python","updated":"2025-06-26","comments":5,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-graceful-api-evolution.md"},{"slug":"langfuse-avoid-array-mutations","title":"Avoid array mutations","description":"Always clone arrays before performing operations that would mutate the original array, especially when working with component state or props. Direct mutations can cause subtle bugs and unexpected side effects in React applications.","repository":"langfuse/langfuse","domain":"observability","topic":"Code Style","language":"TSX","updated":"2025-06-26","comments":5,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-avoid-array-mutations.md"},{"slug":"fiber-validate-configuration-defaults","title":"Validate configuration defaults","description":"Configuration structs should validate input values and provide sensible defaults that work well in production environments. Always check for invalid values (like negative timeouts), provide reasonable defaults for production use cases, and handle edge cases where users might set unexpected values.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Configurations","language":"Go","updated":"2025-06-26","comments":4,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-validate-configuration-defaults.md"},{"slug":"grafana-safe-property-access-patterns","title":"Safe property access patterns","description":"Use appropriate null/undefined handling techniques based on the context to prevent runtime errors. Be mindful of the distinction between `null` and `undefined` in TypeScript, as they behave differently and affect type safety.","repository":"grafana/grafana","domain":"observability","topic":"Null Handling","language":"TSX","updated":"2025-06-26","comments":4,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-safe-property-access-patterns.md"},{"slug":"openpilot-use-descriptive-names","title":"Use descriptive names","description":"Choose names that clearly communicate purpose and meaning rather than using abbreviations or unclear terms. Names should be self-documenting and make the code's intent obvious without requiring additional context.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Naming Conventions","language":"Other","updated":"2025-06-26","comments":4,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-use-descriptive-names.md"},{"slug":"signoz-use-existing-api-utilities","title":"Use existing API utilities","description":"Always leverage existing utility hooks, constants, and navigation methods instead of implementing manual solutions. This ensures consistency across the codebase, improves testability, and reduces maintenance overhead.","repository":"SigNoz/signoz","domain":"observability","topic":"API","language":"TSX","updated":"2025-06-26","comments":4,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-use-existing-api-utilities.md"},{"slug":"django-fail-predictably-loudly","title":"Fail predictably, loudly","description":"Design APIs that fail explicitly and predictably when used incorrectly. When an operation is attempted in an inappropriate state, raise a specific exception rather than returning None or an unexpected value. This helps developers catch misuse early rather than encountering subtle bugs later.","repository":"django/django","domain":"app-frameworks","topic":"API","language":"Txt","updated":"2025-06-26","comments":3,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-fail-predictably-loudly.md"},{"slug":"fiber-clear-network-api-documentation","title":"Clear network API documentation","description":"Ensure networking-related API documentation and descriptions are specific, clear, and include concrete implementation details rather than vague or generic statements. This helps developers understand exactly what networking functionality does and how to implement it correctly.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Networking","language":"Markdown","updated":"2025-06-26","comments":3,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-clear-network-api-documentation.md"},{"slug":"grafana-measure-before-optimizing","title":"Measure before optimizing","description":"Performance optimizations should be validated with measurements rather than assumptions. When implementing performance-sensitive code or optimizations:","repository":"grafana/grafana","domain":"observability","topic":"Performance Optimization","language":"TSX","updated":"2025-06-26","comments":3,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-measure-before-optimizing.md"},{"slug":"pytorch-document-configuration-decisions","title":"Document configuration decisions","description":"Always document configuration decisions in package metadata files like `pyproject.toml` with clear comments, especially when: 1. Using deprecated formats due to technical constraints","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Configurations","language":"Toml","updated":"2025-06-26","comments":3,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-document-configuration-decisions.md"},{"slug":"rust-prevent-toctou-vulnerabilities","title":"Prevent TOCTOU vulnerabilities","description":"Time-of-Check-to-Time-of-Use (TOCTOU) race conditions occur when a program checks a condition and then uses the result of that check, but the condition might have changed between the check and use. This pattern creates security vulnerabilities, particularly in file system operations, but can affect any multi-step operation where state might change.","repository":"rust-lang/rust","domain":"runtimes","topic":"Security","language":"Rust","updated":"2025-06-26","comments":3,"stars":105254,"raw":"https://awesomereviewers.com/raw/rust-prevent-toctou-vulnerabilities.md"},{"slug":"gin-select-algorithms-by-complexity","title":"Select algorithms by complexity","description":"Choose appropriate algorithms based on computational complexity requirements and context. When implementing lookups, prefer O(1) direct access over O(n) iterations whenever possible. For infrequent operations or small datasets, simpler linear algorithms may outperform more complex logarithmic approaches due to lower constant factors and better locality.","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"Algorithms","language":"Go","updated":"2025-06-26","comments":2,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-select-algorithms-by-complexity.md"},{"slug":"langchainjs-follow-standard-naming","title":"Follow standard naming","description":"Use established naming patterns and correct capitalization throughout\\ \\ the codebase and documentation. \\n\\nFor test fixtures and recordings, follow common\\ \\ conventions like `__snapshots__` instead of custom directory names:","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Naming Conventions","language":"Markdown","updated":"2025-06-26","comments":2,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-follow-standard-naming.md"},{"slug":"nuxt-preserve-http-header-semantics","title":"Preserve HTTP header semantics","description":"HTTP headers have specific semantics that must be respected when processing, merging, or deduplicating them. Avoid naive approaches that treat headers as simple key-value pairs, as this can break protocol compliance and cause unexpected behavior.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Networking","language":"TypeScript","updated":"2025-06-26","comments":2,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-preserve-http-header-semantics.md"},{"slug":"nx-standardize-todo-comments","title":"standardize TODO comments","description":"Use version-specific TODO comments with a consistent format to ensure actionable items are properly tracked and easily searchable across the codebase. Include the target version in parentheses immediately after \"TODO\" to make it clear when the item should be addressed.","repository":"nrwl/nx","domain":"devtools","topic":"Documentation","language":"TypeScript","updated":"2025-06-26","comments":2,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-standardize-todo-comments.md"},{"slug":"prettier-test-all-variations","title":"Test all variations","description":"Ensure comprehensive test coverage by testing all behavioral variations, configuration options, and edge cases rather than just single scenarios. When adding new functionality, preserve existing tests and add new ones to cover both old and new behaviors.","repository":"prettier/prettier","domain":"devtools","topic":"Testing","language":"Other","updated":"2025-06-26","comments":2,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-test-all-variations.md"},{"slug":"uv-avoid-unnecessary-constraints","title":"Avoid unnecessary constraints","description":"When specifying dependencies and version requirements in project configuration files, avoid adding unnecessary constraints that could limit future compatibility. Unless there''s a specific known incompatibility issue:","repository":"astral-sh/uv","domain":"devtools","topic":"Configurations","language":"Toml","updated":"2025-06-26","comments":2,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-avoid-unnecessary-constraints.md"},{"slug":"airflow-document-security-exceptions","title":"Document security exceptions","description":"When disabling security-related linter rules or bypassing security best practices, always include comments that explain why the exception is necessary, why it remains secure, and link to relevant security policies. This creates an audit trail and ensures future developers understand the security implications.","repository":"apache/airflow","domain":"orchestration","topic":"Security","language":"TSX","updated":"2025-06-26","comments":1,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-document-security-exceptions.md"},{"slug":"node-scope-security-settings","title":"Scope security settings","description":"Avoid modifying global security state in favor of connection-specific or context-bound security settings. Global security state changes can lead to unexpected security vulnerabilities when modified by dependencies without application awareness.","repository":"nodejs/node","domain":"runtimes","topic":"Security","language":"Markdown","updated":"2025-06-26","comments":1,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-scope-security-settings.md"},{"slug":"traefik-configuration-value-consistency","title":"configuration value consistency","description":"Ensure configuration values follow consistent formats, use meaningful defaults, and accurately distinguish between required and optional fields across all documentation.","repository":"traefik/traefik","domain":"cloud-infra","topic":"Configurations","language":"Markdown","updated":"2025-06-25","comments":18,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-configuration-value-consistency.md"},{"slug":"polars-extract-duplicated-code","title":"Extract duplicated code","description":"Identify and extract duplicated code into reusable functions or move common fields to parent structures. This makes the codebase more maintainable and reduces the risk of inconsistencies when code needs to be updated.","repository":"pola-rs/polars","domain":"data-systems","topic":"Code Style","language":"Rust","updated":"2025-06-25","comments":10,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-extract-duplicated-code.md"},{"slug":"inbox-zero-remove-commented-code","title":"Remove commented code","description":"Commented-out code should be removed from the codebase rather than left as comments. Keeping commented code: 1. Clutters the codebase and reduces readability","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Code Style","language":"TSX","updated":"2025-06-25","comments":9,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-remove-commented-code.md"},{"slug":"zed-prefer-idiomatic-option-handling","title":"Prefer idiomatic Option handling","description":"When handling null values in Rust, use idiomatic Option patterns instead of verbose nested conditionals. This improves code readability, safety, and reduces the chance of runtime errors.","repository":"zed-industries/zed","domain":"devtools","topic":"Null Handling","language":"Rust","updated":"2025-06-25","comments":9,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-prefer-idiomatic-option-handling.md"},{"slug":"prowler-use-configurable-default-values","title":"Use configurable default values","description":"Make configuration values flexible and robust by avoiding hardcoded values and providing sensible defaults. This ensures your application works correctly even with incomplete configuration and supports different environments without code changes.","repository":"prowler-cloud/prowler","domain":"security","topic":"Configurations","language":"Python","updated":"2025-06-25","comments":8,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-use-configurable-default-values.md"},{"slug":"langfuse-falsy-vs-null-checks","title":"Falsy vs null checks","description":"Distinguish between falsy values (0, '', false, null, undefined) and null/undefined values in your code. Use explicit checks for null/undefined when you want to preserve other falsy values.","repository":"langfuse/langfuse","domain":"observability","topic":"Null Handling","language":"TSX","updated":"2025-06-25","comments":7,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-falsy-vs-null-checks.md"},{"slug":"azure-sdk-for-net-document-code-reasoning","title":"Document code reasoning","description":"Add clear, concise comments that explain the \"why\" behind complex logic, non-obvious decisions, and implicit behaviors. Focus on documenting: 1. **Algorithmic choices and control flow** - Explain why loops are broken, conditions are checked, or specific approaches are used.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Documentation","language":"C#","updated":"2025-06-25","comments":6,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-document-code-reasoning.md"},{"slug":"runtime-optimize-common-paths","title":"Optimize common paths","description":"Design algorithms that optimize for the most common execution paths by prioritizing frequent scenarios in conditional logic, data structures, and resource allocation.","repository":"dotnet/runtime","domain":"runtimes","topic":"Algorithms","language":"Other","updated":"2025-06-25","comments":6,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-optimize-common-paths.md"},{"slug":"temporal-precompute-and-cache","title":"Precompute and cache","description":"Avoid performing expensive operations repeatedly, especially in hot code paths. Identify operations such as parsing, deserialization, or configuration lookups that can be done once and reused.","repository":"temporalio/temporal","domain":"orchestration","topic":"Performance Optimization","language":"Go","updated":"2025-06-25","comments":6,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-precompute-and-cache.md"},{"slug":"argo-cd-provide-comprehensive-explanations","title":"Provide comprehensive explanations","description":"Documentation should provide thorough technical explanations that define key concepts, explain behaviors, and include necessary context for users to properly understand and use features. Avoid leaving users to guess what terms mean or how features differ from similar functionality.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Documentation","language":"Markdown","updated":"2025-06-25","comments":5,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-provide-comprehensive-explanations.md"},{"slug":"bun-match-filenames-to-contents","title":"Match filenames to contents","description":"Files should be named to clearly reflect their primary contents:\\n\\n\\ 1. When a file contains a single primary type:\\n   - Name the file exactly after\\ \\ the type","repository":"oven-sh/bun","domain":"runtimes","topic":"Naming Conventions","language":"Other","updated":"2025-06-25","comments":5,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-match-filenames-to-contents.md"},{"slug":"django-use-semantic-html-elements","title":"Use semantic HTML elements","description":"Structure HTML templates using semantically appropriate elements rather than generic containers. Replace non-semantic elements like `<div>` and `<p>` with more meaningful elements such as `<nav>`, `<ol>`, `<ul>`, and include proper accessibility attributes like `aria-labelledby` and `aria-current`.","repository":"django/django","domain":"app-frameworks","topic":"Code Style","language":"Html","updated":"2025-06-25","comments":5,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-use-semantic-html-elements.md"},{"slug":"maplibre-native-self-documenting-code-naming","title":"Self-documenting code naming","description":"Method, parameter, and variable names should clearly describe their purpose and behavior, making code self-documenting. Choose names that indicate exactly what the code does and how it behaves with different inputs.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Naming Conventions","language":"Other","updated":"2025-06-25","comments":5,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-self-documenting-code-naming.md"},{"slug":"node-propagate-errors-with-context","title":"Propagate errors with context","description":"Always propagate errors with their original context instead of swallowing them or throwing new errors that hide the original cause. This helps with debugging and allows proper error handling up the call stack.","repository":"nodejs/node","domain":"runtimes","topic":"Error Handling","language":"Other","updated":"2025-06-25","comments":5,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-propagate-errors-with-context.md"},{"slug":"polars-hide-implementation-details","title":"Hide implementation details","description":"Design public APIs to hide implementation details and focus on the user's mental model of the system. Avoid exposing internal classes, implementation-specific parameters, or technical approaches that might change in the future.","repository":"pola-rs/polars","domain":"data-systems","topic":"API","language":"Python","updated":"2025-06-25","comments":5,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-hide-implementation-details.md"},{"slug":"prisma-avoid-unnecessary-allocations","title":"Avoid unnecessary allocations","description":"Minimize memory allocations by avoiding intermediate objects, sharing underlying buffers, and eliminating unnecessary array operations. This is particularly important in hot code paths and when processing large datasets.","repository":"prisma/prisma","domain":"data-systems","topic":"Performance Optimization","language":"TypeScript","updated":"2025-06-25","comments":5,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-avoid-unnecessary-allocations.md"},{"slug":"azure-sdk-for-net-standardize-environment-variables","title":"Standardize environment variables","description":"Ensure environment variable names are consistently spelled, properly referenced, and follow established naming conventions across test files. Replace hardcoded values with environment variables for credentials, endpoints, and other configurable test parameters. Always provide meaningful defaults when environment variables aren't available to ensure tests...","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Configurations","language":"C#","updated":"2025-06-25","comments":4,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-standardize-environment-variables.md"},{"slug":"ghostty-structure-user-documentation","title":"Structure user documentation","description":"When documenting complex features or configuration options, structure your documentation with these four key elements: 1. **Concise summary**: Begin with a brief, terse explanation of what the feature does","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Documentation","language":"Other","updated":"2025-06-25","comments":4,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-structure-user-documentation.md"},{"slug":"grafana-consistent-semantic-naming","title":"Consistent semantic naming","description":"Use consistent, specific, and semantically appropriate naming conventions throughout the codebase. When creating new identifiers: 1. Check for existing patterns for similar concepts (e.g., use ''ascending/descending'' for sort options to match existing UI components)","repository":"grafana/grafana","domain":"observability","topic":"Naming Conventions","language":"TypeScript","updated":"2025-06-25","comments":4,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-consistent-semantic-naming.md"},{"slug":"grafana-fail-safe-security-defaults","title":"Fail-safe security defaults","description":"Always implement security features with fail-safe defaults that deny access or disable insecure functionality unless explicitly configured. When security-sensitive features must be available in development environments, add explicit environment checks to prevent their use in production.","repository":"grafana/grafana","domain":"observability","topic":"Security","language":"Go","updated":"2025-06-25","comments":4,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-fail-safe-security-defaults.md"},{"slug":"hyprland-prefer-managed-pointers","title":"prefer managed pointers","description":"Raw pointers are banned in new code unless absolutely necessary. Instead, use managed pointer types to prevent null pointer dereferences, dangling pointers, and memory safety issues.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Null Handling","language":"Other","updated":"2025-06-25","comments":4,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-prefer-managed-pointers.md"},{"slug":"openpilot-initialize-and-validate-values","title":"Initialize and validate values","description":"Always initialize variables with sensible default values and validate inputs to prevent null reference errors and undefined behavior. This includes three key practices:","repository":"commaai/openpilot","domain":"ml-systems","topic":"Null Handling","language":"Python","updated":"2025-06-25","comments":4,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-initialize-and-validate-values.md"},{"slug":"polars-prevent-deadlock-conditions","title":"Prevent deadlock conditions","description":"Carefully manage resource acquisition and release to prevent deadlocks in concurrent code. Deadlocks typically occur when multiple threads hold resources while waiting for resources held by each other. To avoid deadlocks:","repository":"pola-rs/polars","domain":"data-systems","topic":"Concurrency","language":"Rust","updated":"2025-06-25","comments":4,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-prevent-deadlock-conditions.md"},{"slug":"cline-use-theme-based-styling","title":"Use theme-based styling","description":"Always use CSS custom properties (CSS variables) for colors and include proper accessibility attributes instead of hard-coded values. This ensures consistency with the design system and improves accessibility for users with visual impairments or different theme preferences.","repository":"cline/cline","domain":"ai-agents","topic":"Code Style","language":"TSX","updated":"2025-06-25","comments":3,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-use-theme-based-styling.md"},{"slug":"continue-include-concrete-examples","title":"Include concrete examples","description":"Technical documentation should always include concrete, working examples that demonstrate the described concepts in action. Examples clarify abstract ideas, illustrate correct usage patterns, and provide templates users can adapt to their needs.","repository":"continuedev/continue","domain":"ai-agents","topic":"Documentation","language":"Markdown","updated":"2025-06-25","comments":3,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-include-concrete-examples.md"},{"slug":"grafana-graceful-feature-availability","title":"Graceful feature availability","description":"When implementing configurable features, ensure they degrade gracefully based on environment conditions like feature flags, plugin availability, or license status. Instead of showing disabled buttons or non-functional UI elements, provide informative feedback about why a feature is unavailable and how to enable it.","repository":"grafana/grafana","domain":"observability","topic":"Configurations","language":"TSX","updated":"2025-06-25","comments":3,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-graceful-feature-availability.md"},{"slug":"grafana-optimize-hot-paths","title":"Optimize hot paths","description":"Identify and optimize frequently executed code paths by moving invariant calculations and conditional logic outside of loops, recursive functions, and other performance-critical sections. This reduces repeated evaluations and improves algorithm efficiency.","repository":"grafana/grafana","domain":"observability","topic":"Algorithms","language":"TypeScript","updated":"2025-06-25","comments":3,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-optimize-hot-paths.md"},{"slug":"langfuse-ensure-algorithmic-precision","title":"Ensure algorithmic precision","description":"When implementing algorithms, ensure they perform exactly the operations needed without introducing unintended side effects or limitations. Verify all calculations produce correct results and avoid assumptions that restrict applicability.","repository":"langfuse/langfuse","domain":"observability","topic":"Algorithms","language":"TSX","updated":"2025-06-25","comments":3,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-ensure-algorithmic-precision.md"},{"slug":"rails-wrap-threaded-code-properly","title":"Wrap threaded code properly","description":"When working with threads in Rails applications, always wrap application code with `Rails.application.executor.wrap` to ensure thread safety and proper state management. Code running outside these wrappers can cause race conditions, memory leaks, and inconsistent application state.","repository":"rails/rails","domain":"app-frameworks","topic":"Concurrency","language":"Markdown","updated":"2025-06-25","comments":3,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-wrap-threaded-code-properly.md"},{"slug":"typescript-eliminate-unnecessary-constructs","title":"Eliminate unnecessary constructs","description":"Remove redundant or unnecessary code constructs to improve readability and maintainability. This includes avoiding empty blocks, blocks containing only empty statements, and unnecessary variable declarations that don't enhance code clarity.","repository":"microsoft/typescript","domain":"runtimes","topic":"Code Style","language":"JavaScript","updated":"2025-06-25","comments":3,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-eliminate-unnecessary-constructs.md"},{"slug":"v-comprehensive-validated-examples","title":"comprehensive validated examples","description":"Documentation examples should be self-sufficient, comprehensive, and use proper syntax tags to enable automated validation. Examples must include all necessary context and demonstrate multiple related features rather than isolated snippets. Use `v` syntax tags instead of generic ones like `codeblock` to ensure examples are validated by `v check-md` during...","repository":"vlang/v","domain":"runtimes","topic":"Documentation","language":"Markdown","updated":"2025-06-25","comments":3,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-comprehensive-validated-examples.md"},{"slug":"airflow-quote-shell-variables","title":"Quote shell variables","description":"Always quote shell script variable expansions using double quotes to prevent word splitting issues and ensure consistent behavior. This is particularly important in conditionals and when passing variables as command arguments.","repository":"apache/airflow","domain":"orchestration","topic":"Code Style","language":"Shell","updated":"2025-06-25","comments":2,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-quote-shell-variables.md"},{"slug":"discourse-prefer-asyncawait-patterns","title":"prefer async/await patterns","description":"Convert promise chains to async/await syntax for better readability, error handling, and proper cleanup operation placement. Async functions automatically return promises, so avoid redundant Promise.resolve() calls or manual promise wrapping.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Concurrency","language":"JavaScript","updated":"2025-06-25","comments":2,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-prefer-asyncawait-patterns.md"},{"slug":"litellm-follow-documentation-standards","title":"Follow documentation standards","description":"Ensure all documentation follows established patterns and standards for components, formatting, and code examples. This includes using proper imports for documentation components (like Image imports instead of markdown syntax) and maintaining consistent formatting for code samples with standardized attributes.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Documentation","language":"Markdown","updated":"2025-06-25","comments":2,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-follow-documentation-standards.md"},{"slug":"runtime-optimize-aligned-simd-operations","title":"Optimize aligned SIMD operations","description":"Always use proper memory alignment for SIMD (Single Instruction, Multiple Data) operations to maximize performance. When implementing vector operations:","repository":"dotnet/runtime","domain":"runtimes","topic":"Performance Optimization","language":"C","updated":"2025-06-25","comments":2,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-optimize-aligned-simd-operations.md"},{"slug":"swe-agent-document-configuration-clarity","title":"Document configuration clarity","description":"Ensure all configuration options and setup instructions are clearly documented with their intended purposes, use cases, and the most accessible implementation paths. When introducing new configuration classes or setup steps, include contextual descriptions that help users understand when and why to use each option.","repository":"SWE-agent/SWE-agent","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2025-06-25","comments":2,"stars":16839,"raw":"https://awesomereviewers.com/raw/swe-agent-document-configuration-clarity.md"},{"slug":"vllm-optimize-tensor-memory-operations","title":"Optimize tensor memory operations","description":"When working with PyTorch tensors, use memory-efficient operations that avoid unnecessary copies. Specify memory formats directly during tensor creation instead of applying operations like `.t().contiguous()`. For C++/CUDA kernel interfacing, use `.data_ptr()` instead of `.view(dtype)` to ensure safe memory access and maintain compatibility with future...","repository":"vllm-project/vllm","domain":"llm-infra","topic":"Pytorch","language":"Python","updated":"2025-06-25","comments":2,"stars":51730,"raw":"https://awesomereviewers.com/raw/vllm-optimize-tensor-memory-operations.md"},{"slug":"volcano-network-topology-plugin-configuration","title":"network topology plugin configuration","description":"When implementing network topology-aware scheduling, ensure that the appropriate topology plugins are properly configured for different scheduling modes. In hard mode, the scheduler should strictly enforce topology constraints, while in soft mode, it should prefer network locality but allow cross-topology scheduling when necessary.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Networking","language":"Go","updated":"2025-06-25","comments":2,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-network-topology-plugin-configuration.md"},{"slug":"brew-clear-code-examples","title":"Clear code examples","description":"Documentation should include clear, actionable code examples that users can reliably follow. Avoid using ambiguous placeholders or variables that might be misinterpreted as literal code to copy-paste. When placeholder values must be used in examples, explicitly mark them and provide clear instructions for replacement.","repository":"Homebrew/brew","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2025-06-24","comments":6,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-clear-code-examples.md"},{"slug":"comfyui-hardware-compatibility-patterns","title":"Hardware compatibility patterns","description":"Implement proper hardware compatibility patterns when working with different GPU backends and AI frameworks. Many AI applications need to support multiple hardware platforms (NVIDIA CUDA, AMD ROCm, Intel XPU, Moore Threads, DirectML, ZLUDA) which have different capabilities and limitations.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"AI","language":"Python","updated":"2025-06-24","comments":6,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-hardware-compatibility-patterns.md"},{"slug":"node-prefer-clarity-over-cleverness","title":"Prefer clarity over cleverness","description":"Write code that prioritizes readability and maintainability over cleverness or excessive optimization. Avoid overly clever techniques that might confuse other developers or make the code harder to maintain.","repository":"nodejs/node","domain":"runtimes","topic":"Code Style","language":"JavaScript","updated":"2025-06-24","comments":6,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-prefer-clarity-over-cleverness.md"},{"slug":"runtime-document-configuration-intent","title":"Document configuration intent","description":"Configuration settings should be self-documenting with clear intent. When adding temporary workarounds, conditional flags, or platform-specific settings, include descriptive comments explaining their purpose, limitations, and lifecycle. Use TODO comments with issue references for temporary configurations, and choose clear, descriptive names for all...","repository":"dotnet/runtime","domain":"runtimes","topic":"Configurations","language":"Other","updated":"2025-06-24","comments":6,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-document-configuration-intent.md"},{"slug":"continue-standardize-ai-model-interfaces","title":"Standardize AI model interfaces","description":"When implementing AI model integrations, maintain consistent interfaces and proper type definitions across different providers. This ensures compatibility, prevents runtime errors, and simplifies maintenance.","repository":"continuedev/continue","domain":"ai-agents","topic":"AI","language":"TypeScript","updated":"2025-06-24","comments":5,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-standardize-ai-model-interfaces.md"},{"slug":"duckdb-validate-inputs-early","title":"validate inputs early","description":"Validate function inputs, preconditions, and assumptions as early as possible in the execution flow, preferably during binding or initialization phases rather than deep within implementation logic. This prevents invalid states from propagating through the system and ensures errors are caught at the appropriate architectural level.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Error Handling","language":"C++","updated":"2025-06-24","comments":5,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-validate-inputs-early.md"},{"slug":"mastodon-api-parameter-design","title":"API parameter design","description":"Design API parameters with clear intent, proper validation, and thoughtful default behaviors. Parameter names should reflect their purpose rather than their source (e.g., `include_original` instead of `client_type == 'editor'`). Always validate parameters through StrongParameters to prevent security issues, and carefully consider the implications of default...","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"API","language":"Ruby","updated":"2025-06-24","comments":5,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-api-parameter-design.md"},{"slug":"airflow-optimize-collection-processing-patterns","title":"Optimize collection processing patterns","description":"Use Python's built-in efficient collection processing methods instead of manual implementations. This reduces code complexity and improves performance by leveraging optimized implementations.","repository":"apache/airflow","domain":"orchestration","topic":"Algorithms","language":"Python","updated":"2025-06-24","comments":4,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-optimize-collection-processing-patterns.md"},{"slug":"azure-sdk-for-net-externalize-configuration-values","title":"Externalize configuration values","description":"Store configuration values (URLs, demands, pool names) in centralized variables rather than hardcoding them inline. This improves maintainability, ensures consistency across the codebase, and simplifies future updates. When possible, group related configurations in dedicated template files or variable groups.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Configurations","language":"Yaml","updated":"2025-06-24","comments":4,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-externalize-configuration-values.md"},{"slug":"browser-use-simplify-complex-implementations","title":"Simplify complex implementations","description":"Replace verbose, complex code structures with simpler, more readable alternatives. Prefer existing methods over inline complex logic, use built-in functions instead of manual implementations, and leverage modern Python features for cleaner code.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2025-06-24","comments":4,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-simplify-complex-implementations.md"},{"slug":"inbox-zero-normalize-api-responses","title":"Normalize API responses","description":"Design APIs to return consistent response structures across different data sources or providers. Normalize responses at the API layer rather than handling provider-specific format differences in client components. This approach:","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"API","language":"TSX","updated":"2025-06-24","comments":4,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-normalize-api-responses.md"},{"slug":"material-ui-explicit-configuration-specifications","title":"Explicit configuration specifications","description":"When writing configuration files, be explicit and precise about dependencies and versions rather than using broad patterns or tags. For dependency declarations:","repository":"mui/material-ui","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2025-06-24","comments":4,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-explicit-configuration-specifications.md"},{"slug":"nuxt-vue-context-boundaries","title":"Vue context boundaries","description":"Ensure Vue composables, reactive state, and side effects are properly scoped within Vue's execution context to prevent SSR failures, memory leaks, and shared state across requests.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Vue","language":"Markdown","updated":"2025-06-24","comments":4,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-vue-context-boundaries.md"},{"slug":"opentelemetry-python-place-attributes-correctly","title":"Place attributes correctly","description":"When implementing observability with OpenTelemetry, place attributes at the appropriate level in the telemetry hierarchy to ensure effective data collection and analysis:","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Observability","language":"Markdown","updated":"2025-06-24","comments":4,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-place-attributes-correctly.md"},{"slug":"azure-sdk-for-net-descriptive-consistent-identifiers","title":"Descriptive consistent identifiers","description":"Use clear, descriptive identifiers that accurately reflect their purpose, and maintain consistent naming patterns throughout the codebase. This applies to variables, parameters, methods, and configuration elements.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Naming Conventions","language":"Other","updated":"2025-06-24","comments":3,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-descriptive-consistent-identifiers.md"},{"slug":"azure-sdk-for-net-surface-errors-appropriately","title":"Surface errors appropriately","description":"Ensure errors are visible and properly handled rather than silently processed or hidden. Provide mechanisms for developers to handle errors explicitly, especially in libraries or frameworks with automated processes. Hidden or automatically handled errors can mask bugs and make debugging difficult.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Error Handling","language":"Markdown","updated":"2025-06-24","comments":3,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-surface-errors-appropriately.md"},{"slug":"core-api-polling-optimization","title":"API polling optimization","description":"Optimize API polling patterns to avoid excessive calls and improve performance. Use appropriate update intervals based on data freshness requirements rather than aggressive polling schedules.","repository":"home-assistant/core","domain":"app-frameworks","topic":"API","language":"Python","updated":"2025-06-24","comments":3,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-api-polling-optimization.md"},{"slug":"developer-roadmap-semantic-precision-in-algorithms","title":"Semantic Precision In Algorithms","description":"When writing documentation or implementing algorithm/data-structure logic, make the *semantics* unambiguous: state the defining invariants/behavior, keep each section aligned to its exact step in the workflow, and avoid language-level ambiguity that can change correctness.","repository":"kamranahmedse/developer-roadmap","domain":"docs","topic":"Algorithms","language":"Markdown","updated":"2025-06-24","comments":3,"stars":354523,"raw":"https://awesomereviewers.com/raw/developer-roadmap-semantic-precision-in-algorithms.md"},{"slug":"django-document-accessibility-decisions","title":"Document accessibility decisions","description":"When implementing HTML templates, add clear comments documenting accessibility-related decisions. Explain the purpose of semantic HTML elements, ARIA attributes, and screen reader considerations. This ensures that future developers understand the rationale behind these choices and preserves accessibility during code modifications.","repository":"django/django","domain":"app-frameworks","topic":"Documentation","language":"Html","updated":"2025-06-24","comments":3,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-document-accessibility-decisions.md"},{"slug":"django-prefer-semantic-css-selectors","title":"Prefer semantic CSS selectors","description":"Use semantic attribute-based selectors instead of structural or overly specific class names when the semantic meaning is already captured in HTML attributes. This makes CSS more maintainable by connecting styles to the actual meaning of elements rather than their position in the DOM.","repository":"django/django","domain":"app-frameworks","topic":"Code Style","language":"Css","updated":"2025-06-24","comments":3,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-prefer-semantic-css-selectors.md"},{"slug":"electron-defensive-null-checking","title":"defensive null checking","description":"Implement robust null and undefined handling patterns to prevent runtime errors and maintain code reliability. Use optional chaining for safe property access, explicit null checks with early returns, and conditional property assignment to avoid unintended undefined values.","repository":"electron/electron","domain":"devtools","topic":"Null Handling","language":"TypeScript","updated":"2025-06-24","comments":3,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-defensive-null-checking.md"},{"slug":"lmcache-optimize-cicd-pipelines","title":"optimize CI/CD pipelines","description":"CI/CD pipelines should be optimized for both performance and maintainability through strategic caching, script consolidation, and compilation optimization. This involves three key practices:","repository":"LMCache/LMCache","domain":"llm-infra","topic":"CI/CD","language":"Shell","updated":"2025-06-24","comments":3,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-optimize-cicd-pipelines.md"},{"slug":"mastodon-choose-appropriate-exception-types","title":"Choose appropriate exception types","description":"Select exception types that match method contracts and avoid surprising behavior. Methods with names like `find_or_initialize_by_*` should not raise validation errors since the standard Rails method doesn't perform validation. Use `save` instead of `save!` when you want to handle validation errors gracefully rather than raising exceptions. Prefer standard...","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Error Handling","language":"Ruby","updated":"2025-06-24","comments":3,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-choose-appropriate-exception-types.md"},{"slug":"node-reuse-computed-values-efficiently","title":"Reuse computed values efficiently","description":"Move variable declarations and computations outside of loops when their values don't change between iterations. This reduces memory allocations and avoids redundant computations, improving performance.","repository":"nodejs/node","domain":"runtimes","topic":"Performance Optimization","language":"Other","updated":"2025-06-24","comments":3,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-reuse-computed-values-efficiently.md"},{"slug":"prometheus-configuration-design-clarity","title":"Configuration design clarity","description":"Design configuration options to be unambiguous and self-documenting. Avoid reusing the same configuration field for different data types, as this creates confusion and maintenance burden. Instead, use explicit indicators or separate fields to handle different scenarios. Make mutual exclusivity and constraints between configuration options explicit in both...","repository":"prometheus/prometheus","domain":"observability","topic":"Configurations","language":"Markdown","updated":"2025-06-24","comments":3,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-configuration-design-clarity.md"},{"slug":"react-native-avoid-unnecessary-conversions","title":"avoid unnecessary conversions","description":"Choose direct, efficient methods over approaches that require additional parsing, conversion, or processing steps. This reduces computational overhead and improves performance by eliminating intermediate operations.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Performance Optimization","language":"Kotlin","updated":"2025-06-24","comments":3,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-avoid-unnecessary-conversions.md"},{"slug":"ruff-ensure-algorithmic-determinism","title":"Ensure algorithmic determinism","description":"When implementing algorithms for code analysis, type checking, or pattern matching, ensure they produce consistent and deterministic results for the same inputs. Edge cases should be explicitly handled rather than making assumptions.","repository":"astral-sh/ruff","domain":"devtools","topic":"Algorithms","language":"Other","updated":"2025-06-24","comments":3,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-ensure-algorithmic-determinism.md"},{"slug":"runtime-platform-agnostic-network-apis","title":"Platform-agnostic network APIs","description":"When implementing networking functionality, ensure code uses platform-agnostic APIs and appropriate abstraction layers to handle differences between Windows, Unix, and macOS systems. Similar to how string operations require platform-specific handling (as seen in discussion 1 where `strchr` was replaced with `app_candidate.find(DIR_SEPARATOR)`), networking...","repository":"dotnet/runtime","domain":"runtimes","topic":"Networking","language":"C++","updated":"2025-06-24","comments":3,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-platform-agnostic-network-apis.md"},{"slug":"svelte-multi-indicator-configuration-detection","title":"Multi-indicator configuration detection","description":"When detecting configuration states, use multiple indicators rather than relying on a single source of truth, especially when dealing with ambiguous or transitional states. Provide clear documentation explaining the detection logic and reasoning behind each check.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Configurations","language":"JavaScript","updated":"2025-06-24","comments":3,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-multi-indicator-configuration-detection.md"},{"slug":"argo-cd-follow-established-naming-patterns","title":"Follow established naming patterns","description":"When introducing new identifiers (variables, methods, flags, metrics, etc.), examine existing code to identify and follow established naming conventions rather than creating new patterns. This ensures consistency across the codebase and maintains predictability for users and developers.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Naming Conventions","language":"Markdown","updated":"2025-06-24","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-follow-established-naming-patterns.md"},{"slug":"azure-sdk-for-net-address-not-mask","title":"Address not mask","description":"Always address the root cause of CI/CD pipeline issues rather than masking them with quick fixes. This applies to encoding problems, build failures, and other CI-related issues.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"CI/CD","language":"Other","updated":"2025-06-24","comments":2,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-address-not-mask.md"},{"slug":"jan-consistent-localhost-addressing","title":"consistent localhost addressing","description":"Use 127.0.0.1 instead of 'localhost' for network requests and implement broad localhost detection rather than specific port-based checks. This ensures consistent behavior across different environments and avoids issues with DNS resolution or host file configurations.","repository":"menloresearch/jan","domain":"llm-infra","topic":"Networking","language":"TypeScript","updated":"2025-06-24","comments":2,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-consistent-localhost-addressing.md"},{"slug":"kilocode-consider-async-function-contracts","title":"Consider async function contracts","description":"Be intentional when marking functions as async, as it changes the function's contract and caller expectations. Avoid using async unnecessarily when you're just returning a promise explicitly, and consider whether making a function async implies that callers should await its completion.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Concurrency","language":"TypeScript","updated":"2025-06-24","comments":2,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-consider-async-function-contracts.md"},{"slug":"mastodon-prefer-findby-async-queries","title":"prefer findBy async queries","description":"When testing components that require waiting for elements to appear, prefer using findBy* queries over waitFor + getBy* combinations. The findBy* queries have built-in waiting functionality that makes tests more readable and reliable.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Testing","language":"TSX","updated":"2025-06-24","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-prefer-findby-async-queries.md"},{"slug":"pytorch-reuse-existing-algorithms","title":"Reuse existing algorithms","description":"Before implementing common algorithms or utilities, check if the codebase already contains an appropriate implementation. Reusing existing, tested code reduces bugs, improves maintainability, and often provides better performance characteristics.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Algorithms","language":"C++","updated":"2025-06-24","comments":2,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-reuse-existing-algorithms.md"},{"slug":"refact-prefer-simpler-implementations","title":"prefer simpler implementations","description":"When writing code, favor simpler, more straightforward implementations over complex ones. Look for opportunities to consolidate logic paths, reduce unnecessary branching, and reuse existing resources instead of recreating them.","repository":"smallcloudai/refact","domain":"ai-agents","topic":"Code Style","language":"Rust","updated":"2025-06-24","comments":2,"stars":3114,"raw":"https://awesomereviewers.com/raw/refact-prefer-simpler-implementations.md"},{"slug":"runtime-names-reflect-actual-purpose","title":"Names reflect actual purpose","description":"Name variables, properties, and functions to accurately reflect their purpose and actual usage in code, not just their technical classification. This ensures other developers can understand the intent without having to analyze implementation details.","repository":"dotnet/runtime","domain":"runtimes","topic":"Naming Conventions","language":"Other","updated":"2025-06-24","comments":2,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-names-reflect-actual-purpose.md"},{"slug":"signoz-observability-correctness-and-maintainability","title":"Observability correctness and maintainability","description":"Ensure observability implementations prioritize both mathematical correctness and code maintainability. Observability systems must produce accurate metrics and telemetry data while remaining easy to understand and modify.","repository":"SigNoz/signoz","domain":"observability","topic":"Observability","language":"Go","updated":"2025-06-24","comments":2,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-observability-correctness-and-maintainability.md"},{"slug":"temporal-configure-opentelemetry-programmatically","title":"Configure OpenTelemetry programmatically","description":"Configure OpenTelemetry programmatically rather than through environment variables or command-line flags. This creates a more maintainable and standardized approach to observability. Additionally, ensure all observability components like collectors are explicitly included in your deployment configurations.","repository":"temporalio/temporal","domain":"orchestration","topic":"Observability","language":"Yaml","updated":"2025-06-24","comments":2,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-configure-opentelemetry-programmatically.md"},{"slug":"typescript-streamline-workflow-configurations","title":"Streamline workflow configurations","description":"Maintain efficient and properly structured CI/CD workflows by removing unnecessary dependencies and using consistent formatting patterns. Each workflow step should serve a specific purpose for the job it's part of, and matrix configurations should follow a consistent structure.","repository":"microsoft/typescript","domain":"runtimes","topic":"CI/CD","language":"Yaml","updated":"2025-06-24","comments":2,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-streamline-workflow-configurations.md"},{"slug":"checkov-centralize-environment-variables","title":"Centralize environment variables","description":"All environment variables should be defined in a centralized location (`checkov/common/util/env_vars_config.py`) rather than scattered throughout the codebase. This approach enhances maintainability, promotes consistency, and simplifies tracking of configuration settings.","repository":"bridgecrewio/checkov","domain":"security","topic":"Configurations","language":"Python","updated":"2025-06-23","comments":9,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-centralize-environment-variables.md"},{"slug":"deno-avoid-ambiguous-naming","title":"Avoid ambiguous naming","description":"Choose names that clearly convey their purpose and avoid ambiguous identifiers that can be misinterpreted. This applies to methods, variables, parameters, and types.","repository":"denoland/deno","domain":"runtimes","topic":"Naming Conventions","language":"Rust","updated":"2025-06-23","comments":8,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-avoid-ambiguous-naming.md"},{"slug":"prowler-specific-exception-handling","title":"Specific exception handling","description":"Handle exceptions with specificity rather than using broad catch-all blocks. Catch specific exception types, provide clear error messages, and respond appropriately based on the error type. This improves error diagnosis and enables targeted recovery strategies.","repository":"prowler-cloud/prowler","domain":"security","topic":"Error Handling","language":"Python","updated":"2025-06-23","comments":8,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-specific-exception-handling.md"},{"slug":"bun-assert-before-cast","title":"Assert before cast","description":"Always validate values before performing unsafe operations like dynamic casting. When a value could be null, zero, or undefined, store it in an intermediate variable and verify it before proceeding.","repository":"oven-sh/bun","domain":"runtimes","topic":"Null Handling","language":"C++","updated":"2025-06-23","comments":7,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-assert-before-cast.md"},{"slug":"neon-structure-endpoints-for-rest","title":"Structure endpoints for REST","description":"Organize API endpoints hierarchically by resource type and use appropriate HTTP methods based on operation semantics. Group related operations under resource-based paths, use debug prefixes for administrative endpoints, and select HTTP methods that match the operation''s behavior:","repository":"neondatabase/neon","domain":"data-systems","topic":"API","language":"Rust","updated":"2025-06-23","comments":7,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-structure-endpoints-for-rest.md"},{"slug":"chef-never-commit-secrets","title":"Never commit secrets","description":"Private cryptographic keys, certificates with private keys, and other secrets must never be committed to source code repositories, even in test or spec files. This is a critical security vulnerability that could lead to unauthorized access, impersonation, or system compromise.","repository":"chef/chef","domain":"cloud-infra","topic":"Security","language":"Other","updated":"2025-06-23","comments":6,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-never-commit-secrets.md"},{"slug":"vscode-use-specific-semantic-names","title":"Use specific semantic names","description":"Choose specific, descriptive names for identifiers that accurately reflect their purpose and behavior. Avoid generic terms or ambiguous names that could lead to confusion. Names should be self-documenting and convey precise meaning.","repository":"microsoft/vscode","domain":"devtools","topic":"Naming Conventions","language":"TypeScript","updated":"2025-06-23","comments":6,"stars":174887,"raw":"https://awesomereviewers.com/raw/vscode-use-specific-semantic-names.md"},{"slug":"mermaid-precise-ci-workflows","title":"Precise CI Workflows","description":"CI workflows should be precise, minimal, and predictable: - Trigger only when needed: narrow `on: pull_request.paths` (avoid overly broad selectors like `**/*.js` unless required). If the PR doesn’t touch dependency inputs, the lockfile validation workflow shouldn’t run.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"CI/CD","language":"Yaml","updated":"2025-06-23","comments":5,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-precise-ci-workflows.md"},{"slug":"prowler-prioritize-code-readability","title":"Prioritize code readability","description":"Write code that optimizes for human readability and understanding. Complex expressions, while technically correct, can become difficult to understand and maintain over time.","repository":"prowler-cloud/prowler","domain":"security","topic":"Code Style","language":"Python","updated":"2025-06-23","comments":5,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-prioritize-code-readability.md"},{"slug":"svelte-defensive-error-handling","title":"defensive error handling","description":"Add defensive checks and proper error handling to prevent crashes and handle edge cases gracefully. This includes using try-catch blocks around potentially unsafe operations, adding guard conditions to prevent infinite loops or invalid states, and ensuring the system can recover from unexpected inputs or conditions.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Error Handling","language":"JavaScript","updated":"2025-06-23","comments":5,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-defensive-error-handling.md"},{"slug":"airflow-leverage-backend-api-capabilities","title":"Leverage backend API capabilities","description":"When consuming APIs in frontend applications, utilize the backend capabilities rather than reimplementing equivalent functionality in the frontend. This reduces code complexity, improves performance, and maintains a clean separation of concerns.","repository":"apache/airflow","domain":"orchestration","topic":"API","language":"TSX","updated":"2025-06-23","comments":4,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-leverage-backend-api-capabilities.md"},{"slug":"checkov-use-pytest-best-practices","title":"Use pytest best practices","description":"Adopt modern pytest features to create maintainable, isolated, and comprehensive tests. This includes: 1. **Prefer pytest over unittest** for new test development to leverage pytest''s rich feature set and simpler syntax.","repository":"bridgecrewio/checkov","domain":"security","topic":"Testing","language":"Python","updated":"2025-06-23","comments":4,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-use-pytest-best-practices.md"},{"slug":"django-defend-against-nulls","title":"Defend against nulls","description":"Always use defensive programming techniques when handling potentially null or empty values to avoid runtime errors. Consider these practices: 1. Use specialized methods when checking for default values or null states rather than direct comparisons:","repository":"django/django","domain":"app-frameworks","topic":"Null Handling","language":"Python","updated":"2025-06-23","comments":4,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-defend-against-nulls.md"},{"slug":"inbox-zero-define-schema-relations-correctly","title":"Define schema relations correctly","description":"When designing database schemas, ensure relations and constraints are explicitly and correctly defined: 1. Every model must have a properly defined primary key:","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Database","language":"Prisma","updated":"2025-06-23","comments":4,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-define-schema-relations-correctly.md"},{"slug":"node-document-non-intuitive-code","title":"Document non-intuitive code","description":"Add clear comments to explain complex logic, function differences, and non-obvious implementation details. This is especially important for: - Similar functions with subtle differences","repository":"nodejs/node","domain":"runtimes","topic":"Documentation","language":"Other","updated":"2025-06-23","comments":4,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-document-non-intuitive-code.md"},{"slug":"polars-prevent-cryptic-errors","title":"Prevent cryptic errors","description":"Always implement proper validation and type checking to prevent cryptic error messages. When errors do occur, provide clear, actionable guidance for resolution.","repository":"pola-rs/polars","domain":"data-systems","topic":"Error Handling","language":"Python","updated":"2025-06-23","comments":4,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-prevent-cryptic-errors.md"},{"slug":"prettier-validate-configuration-changes","title":"validate configuration changes","description":"Configuration files require careful validation to ensure they work as intended and don't introduce unintended side effects. This includes verifying ignore patterns don't create parent-child conflicts, understanding rule severity implications, and confirming dependency changes are expected.","repository":"prettier/prettier","domain":"devtools","topic":"Configurations","language":"Other","updated":"2025-06-23","comments":4,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-validate-configuration-changes.md"},{"slug":"prowler-service-layer-abstraction","title":"Service layer abstraction","description":"Separate business logic and external service interactions from API views by using dedicated service layers. This improves testability, maintainability, and enforces separation of concerns in your API design.","repository":"prowler-cloud/prowler","domain":"security","topic":"API","language":"Python","updated":"2025-06-23","comments":4,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-service-layer-abstraction.md"},{"slug":"mastodon-leverage-existing-configuration-sources","title":"leverage existing configuration sources","description":"When implementing configuration logic, prefer using built-in configuration mechanisms and existing framework parameters over creating custom configuration options. This reduces complexity, improves maintainability, and follows established patterns.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2025-06-23","comments":3,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-leverage-existing-configuration-sources.md"},{"slug":"neon-secure-authentication-handling","title":"Secure authentication handling","description":"Always implement proper authentication checks and protect sensitive credentials throughout your codebase. This includes: 1. **Validate all authentication inputs properly** to prevent panics and security vulnerabilities:","repository":"neondatabase/neon","domain":"data-systems","topic":"Security","language":"Rust","updated":"2025-06-23","comments":3,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-secure-authentication-handling.md"},{"slug":"neovim-documentation-formatting-standards","title":"Documentation formatting standards","description":"Ensure documentation follows consistent formatting standards to improve readability and maintainability. This includes proper indentation of code blocks for syntax highlighting, clear separation of examples with individual explanatory comments, and concise organization of related information.","repository":"neovim/neovim","domain":"devtools","topic":"Code Style","language":"Txt","updated":"2025-06-23","comments":3,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-documentation-formatting-standards.md"},{"slug":"novu-consistent-naming-patterns","title":"consistent naming patterns","description":"Establish and maintain consistent naming conventions across similar components and contexts. Inconsistent naming patterns make code harder to understand, discover, and maintain.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Naming Conventions","language":"TSX","updated":"2025-06-23","comments":3,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-consistent-naming-patterns.md"},{"slug":"openpilot-pin-dependency-versions","title":"Pin dependency versions","description":"Always pin specific versions of dependencies, tools, and commits in configuration files to ensure consistent behavior across environments and deployments. When pinning versions, include comments explaining the reasoning behind the specific version choice.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Configurations","language":"Shell","updated":"2025-06-23","comments":3,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-pin-dependency-versions.md"},{"slug":"roo-code-use-nullish-coalescing","title":"Use nullish coalescing","description":"When providing default values for numeric properties, use the nullish coalescing operator (??) instead of logical OR (||). This ensures that valid zero values are preserved rather than being replaced with defaults. Using || will treat 0 as a falsy value and replace it with the default, which is often unintended behavior for numeric settings.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Null Handling","language":"TSX","updated":"2025-06-23","comments":3,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-use-nullish-coalescing.md"},{"slug":"ruff-verify-union-attribute-access","title":"Verify union attribute access","description":"When working with union types in Python, always verify that all components of the union have the attributes you're trying to access or modify. Failure to do so can lead to runtime errors when the code attempts to access undefined attributes.","repository":"astral-sh/ruff","domain":"devtools","topic":"Null Handling","language":"Markdown","updated":"2025-06-23","comments":3,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-verify-union-attribute-access.md"},{"slug":"sentry-algorithm-structure-optimization","title":"Algorithm structure optimization","description":"Optimize algorithm structure by separating concerns and using appropriate data structures and language features. When implementing algorithms: 1. **Separate search from processing** to improve readability and maintainability. When you need to find and process an item, first locate the item, then apply operations to it rather than mixing these steps.","repository":"getsentry/sentry","domain":"observability","topic":"Algorithms","language":"Python","updated":"2025-06-23","comments":3,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-algorithm-structure-optimization.md"},{"slug":"azure-sdk-for-net-use-higher-level-telemetry","title":"Use higher-level telemetry","description":"When implementing observability for Azure services, prefer higher-level telemetry packages and configuration methods over low-level implementations. For Azure Monitor integration, use the Azure.Monitor.OpenTelemetry.AspNetCore package instead of the lower-level Azure.Monitor.OpenTelemetry.Exporter, as it provides simpler integration and is the recommended...","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Observability","language":"Markdown","updated":"2025-06-23","comments":2,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-use-higher-level-telemetry.md"},{"slug":"brew-resolve-naming-conflicts-clearly","title":"Resolve naming conflicts clearly","description":"When naming components, packages, or files that conflict with existing names in your system or related ecosystems, follow a systematic approach to ensure uniqueness while maintaining semantic clarity:","repository":"Homebrew/brew","domain":"devtools","topic":"Naming Conventions","language":"Markdown","updated":"2025-06-23","comments":2,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-resolve-naming-conflicts-clearly.md"},{"slug":"comfyui-ai-hardware-platform-support","title":"AI hardware platform support","description":"AI applications must properly handle different GPU platforms (NVIDIA CUDA, AMD ROCm, Iluvatar Corex, etc.) through both build-time configuration and runtime capability detection. This ensures models can run efficiently across diverse hardware environments.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"AI","language":"Markdown","updated":"2025-06-23","comments":2,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-ai-hardware-platform-support.md"},{"slug":"mastodon-prefer-established-configuration-patterns","title":"prefer established configuration patterns","description":"When making configuration choices, prioritize existing centralized configuration values and established patterns over ad-hoc solutions or deprecated frameworks. This reduces technical debt and maintains consistency across the codebase.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Configurations","language":"TSX","updated":"2025-06-23","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-prefer-established-configuration-patterns.md"},{"slug":"neon-proper-metrics-design","title":"Proper metrics design","description":"When designing metrics for observability systems like Prometheus, follow established best practices to ensure your metrics are useful, queryable, and maintainable:","repository":"neondatabase/neon","domain":"data-systems","topic":"Observability","language":"Other","updated":"2025-06-23","comments":2,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-proper-metrics-design.md"},{"slug":"neovim-defer-expensive-operations","title":"defer expensive operations","description":"Avoid performing expensive operations (like module loading, event emissions, or resource allocation) until they are actually needed. This pattern significantly improves startup time and runtime performance by reducing unnecessary work.","repository":"neovim/neovim","domain":"devtools","topic":"Performance Optimization","language":"Txt","updated":"2025-06-23","comments":2,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-defer-expensive-operations.md"},{"slug":"opentelemetry-python-use-proper-testing-frameworks","title":"Use proper testing frameworks","description":"Always leverage established testing frameworks and APIs over custom bash scripts or direct Python execution for test automation. Using proper testing frameworks improves maintainability, provides better error handling, and enables more flexible test configuration.","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Testing","language":"Shell","updated":"2025-06-23","comments":2,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-use-proper-testing-frameworks.md"},{"slug":"prowler-task-signature-methods","title":"Task signature methods","description":"When chaining Celery tasks, choose the correct signature method: - Use `.s()` when a task needs the output from the previous task in the chain - Use `.si()` (immutable signature) when a task doesn''t need any output from the previous task","repository":"prowler-cloud/prowler","domain":"security","topic":"Celery","language":"Python","updated":"2025-06-23","comments":2,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-task-signature-methods.md"},{"slug":"react-router-pin-problematic-dependencies","title":"Pin problematic dependencies","description":"When external dependencies or tools in CI/CD pipelines have known regressions or bugs, pin them to stable versions and document the reasoning with issue links. Include TODO comments to track when temporary measures can be reverted.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2025-06-23","comments":2,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-pin-problematic-dependencies.md"},{"slug":"supabase-sync-environment-variables","title":"Sync environment variables","description":"When converting hardcoded values to environment variables in configuration files (like docker-compose.yml), always update corresponding example files (e.g., .env.example) with appropriate default values. This ensures that developers can use standard setup processes without additional manual configuration.","repository":"supabase/supabase","domain":"data-systems","topic":"Configurations","language":"Yaml","updated":"2025-06-23","comments":2,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-sync-environment-variables.md"},{"slug":"temporal-explicit-ci-configuration-conditions","title":"Explicit CI configuration conditions","description":"When writing CI/CD workflow configurations, always use explicit and precise conditions, paths, and selectors to ensure that actions only execute when necessary and operate on the exact intended targets. This prevents wasted compute resources, unintended side effects, and improves workflow reliability.","repository":"temporalio/temporal","domain":"orchestration","topic":"CI/CD","language":"Yaml","updated":"2025-06-23","comments":2,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-explicit-ci-configuration-conditions.md"},{"slug":"airflow-prioritize-secure-token-storage","title":"Prioritize secure token storage","description":"When implementing authentication token handling, prioritize more secure storage mechanisms over less secure ones. Specifically, prefer retrieving tokens from properly configured cookies (with Secure and HttpOnly flags) before falling back to localStorage, which is vulnerable to XSS attacks.","repository":"apache/airflow","domain":"orchestration","topic":"Security","language":"TypeScript","updated":"2025-06-23","comments":1,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-prioritize-secure-token-storage.md"},{"slug":"better-auth-prefer-authentication-wrappers","title":"prefer authentication wrappers","description":"Use authentication wrapper functions or higher-order functions that automatically handle unauthenticated calls rather than manually checking authentication status. These wrappers provide built-in security by ensuring that authentication edge cases are handled consistently and reducing the risk of forgetting to validate authentication in handlers.","repository":"better-auth/better-auth","domain":"security","topic":"Security","language":"Markdown","updated":"2025-06-23","comments":1,"stars":19651,"raw":"https://awesomereviewers.com/raw/better-auth-prefer-authentication-wrappers.md"},{"slug":"polars-safe-null-handling","title":"Safe null handling","description":"Always implement robust null handling patterns to prevent unexpected behavior and crashes. Consider all edge cases where null values might affect calculations, type conversions, or data operations:","repository":"pola-rs/polars","domain":"data-systems","topic":"Null Handling","language":"Rust","updated":"2025-06-22","comments":10,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-safe-null-handling.md"},{"slug":"vitess-optimize-memory-allocation","title":"Optimize memory allocation","description":"Always allocate data structures with appropriate initial capacity and use memory-efficient data types to reduce memory pressure and improve application performance. Pre-allocate containers when the size is known or can be estimated, avoid unnecessary intermediate data structures, and choose compact data representations.","repository":"vitessio/vitess","domain":"data-systems","topic":"Performance Optimization","language":"Go","updated":"2025-06-22","comments":5,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-optimize-memory-allocation.md"},{"slug":"drizzle-orm-configuration-context-consistency","title":"Configuration context consistency","description":"Ensure configuration names, values, and settings accurately reflect their intended context and usage. Configuration mismatches can lead to runtime errors, incorrect behavior, and maintenance issues.","repository":"drizzle-team/drizzle-orm","domain":"data-systems","topic":"Configurations","language":"TypeScript","updated":"2025-06-22","comments":4,"stars":29461,"raw":"https://awesomereviewers.com/raw/drizzle-orm-configuration-context-consistency.md"},{"slug":"helix-avoid-panics-gracefully","title":"avoid panics gracefully","description":"Replace panics, expects, and unwraps with graceful error handling that provides user feedback and allows the system to continue operating. Instead of crashing the application, log errors appropriately and return early or set status messages for the user.","repository":"helix-editor/helix","domain":"devtools","topic":"Error Handling","language":"Rust","updated":"2025-06-22","comments":4,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-avoid-panics-gracefully.md"},{"slug":"node-await-all-promises","title":"Await all promises","description":"Always explicitly await all asynchronous operations, especially in cleanup code paths and resource management. Failing to properly await promises can lead to race conditions, resource leaks, and unpredictable behavior in concurrent environments.","repository":"nodejs/node","domain":"runtimes","topic":"Concurrency","language":"JavaScript","updated":"2025-06-22","comments":4,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-await-all-promises.md"},{"slug":"prometheus-check-nil-at-usage","title":"Check nil at usage","description":"Perform null and validity checks at the point where values are actually used, rather than defensively initializing or checking everywhere. This approach reduces unnecessary overhead while ensuring safety where it matters most.","repository":"prometheus/prometheus","domain":"observability","topic":"Null Handling","language":"Go","updated":"2025-06-22","comments":4,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-check-nil-at-usage.md"},{"slug":"prometheus-maintain-api-consistency","title":"maintain API consistency","description":"When designing or modifying APIs, ensure they follow established patterns and conventions within the codebase rather than introducing inconsistent approaches. This includes maintaining symmetrical interfaces, preserving backward compatibility when possible, and using consistent parameter types across similar functions.","repository":"prometheus/prometheus","domain":"observability","topic":"API","language":"Go","updated":"2025-06-22","comments":4,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-maintain-api-consistency.md"},{"slug":"spring-framework-standardize-configuration-formats","title":"Standardize configuration formats","description":"Use consistent, explicit, and well-documented formats in all configuration files to improve readability and prevent misunderstandings. When defining configuration values:","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2025-06-22","comments":3,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-standardize-configuration-formats.md"},{"slug":"uv-optimize-cache-sharing-strategies","title":"Optimize cache sharing strategies","description":"Select the appropriate cache sharing approach based on your execution environment to maximize performance and efficiency. When working with containerized applications:","repository":"astral-sh/uv","domain":"devtools","topic":"Caching","language":"Markdown","updated":"2025-06-22","comments":3,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-optimize-cache-sharing-strategies.md"},{"slug":"quarkus-design-fluent-http-apis","title":"Design fluent HTTP APIs","description":"When designing HTTP-related APIs, prioritize readability and intuitiveness through well-crafted fluent interfaces. API methods should read naturally in code, expressing the developer's intent clearly and concisely.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"API","language":"Other","updated":"2025-06-22","comments":2,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-design-fluent-http-apis.md"},{"slug":"inbox-zero-enforce-user-scoping","title":"Enforce user scoping","description":"All database queries must include appropriate user scoping to prevent unauthorized data access and Insecure Direct Object Reference (IDOR) vulnerabilities. Every query should filter results based on the authenticated user's context using `emailAccountId`, `userId`, or equivalent identifiers in WHERE clauses.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Security","language":"Other","updated":"2025-06-22","comments":1,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-enforce-user-scoping.md"},{"slug":"fastapi-isolate-configuration-concerns","title":"Isolate configuration concerns","description":"Keep configuration settings separate from application code by using environment variables or dedicated configuration files. This promotes better maintainability, security, and flexibility across different deployment environments.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Configurations","language":"Markdown","updated":"2025-06-21","comments":8,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-isolate-configuration-concerns.md"},{"slug":"node-behavior-focused-test-design","title":"Behavior-focused test design","description":"Tests should focus on verifying behavior rather than implementation details to ensure they remain robust during refactoring. Avoid dependencies on timers or internal code structure that can lead to flaky and brittle tests.","repository":"nodejs/node","domain":"runtimes","topic":"Testing","language":"JavaScript","updated":"2025-06-21","comments":5,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-behavior-focused-test-design.md"},{"slug":"parlant-names-reflect-exact-purpose","title":"Names reflect exact purpose","description":"Choose names that precisely reflect the component's purpose and behavior, avoiding ambiguous terms or shortcuts. Names should be self-documenting and consistent with related components.","repository":"emcie-co/parlant","domain":"ai-agents","topic":"Naming Conventions","language":"Python","updated":"2025-06-21","comments":5,"stars":12205,"raw":"https://awesomereviewers.com/raw/parlant-names-reflect-exact-purpose.md"},{"slug":"uv-environment-variable-best-practices","title":"Environment variable best practices","description":"When implementing environment variable configuration: 1. Follow standard environment variable conventions: - Use uppercase with underscores (e.g., `NO_COLOR`, `FORCE_COLOR`)","repository":"astral-sh/uv","domain":"devtools","topic":"Configurations","language":"Rust","updated":"2025-06-21","comments":5,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-environment-variable-best-practices.md"},{"slug":"zed-use-structured-model-metadata","title":"Use structured model metadata","description":"Represent AI model information using structured data rather than hardcoded enumerations or conditionals. Store capabilities, limitations, and features as structured fields that can be queried at runtime. This approach simplifies adding new models, detecting feature support, and adapting to model updates without requiring extensive code changes.","repository":"zed-industries/zed","domain":"devtools","topic":"AI","language":"Rust","updated":"2025-06-21","comments":5,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-use-structured-model-metadata.md"},{"slug":"azure-sdk-for-net-user-friendly-configuration-values","title":"User-friendly configuration values","description":"Prefer intuitive, user-friendly values for configuration options over technical \"magic strings\" or codes that require special knowledge. This applies to both environment variables and programmatic configuration options.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Configurations","language":"Markdown","updated":"2025-06-21","comments":4,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-user-friendly-configuration-values.md"},{"slug":"ghostty-prefer-safe-optional-handling","title":"Prefer safe optional handling","description":"Always use Swift''s built-in mechanisms for safely handling optional values instead of force unwrapping or manual nil handling. Specifically: 1. Use optional binding (`if let`, `guard let`) instead of checking for nil and force unwrapping:","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Null Handling","language":"Swift","updated":"2025-06-21","comments":3,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-prefer-safe-optional-handling.md"},{"slug":"gin-write-resilient-tests","title":"Write resilient tests","description":"Tests should be designed to validate behavior without being brittle or sensitive to implementation details. Avoid direct string comparisons for complex data structures or binary data, as these tests can break due to formatting changes or encoding issues that don't reflect actual functional problems.","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"Testing","language":"Go","updated":"2025-06-21","comments":3,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-write-resilient-tests.md"},{"slug":"parlant-use-semantic-naming","title":"Use semantic naming","description":"Choose names that clearly communicate the purpose, behavior, or domain concept rather than generic or abbreviated terms. Names should be self-documenting and reflect what the entity actually does or represents.","repository":"emcie-co/parlant","domain":"ai-agents","topic":"Naming Conventions","language":"Other","updated":"2025-06-21","comments":3,"stars":12205,"raw":"https://awesomereviewers.com/raw/parlant-use-semantic-naming.md"},{"slug":"query-semantic-naming-clarity","title":"Semantic naming clarity","description":"When introducing names for APIs/docs and for contribution metadata, ensure the naming is semantic and cannot be mistaken for a requirement that isn’t real.","repository":"tanstack/query","domain":"app-frameworks","topic":"Naming Conventions","language":"Markdown","updated":"2025-06-21","comments":3,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-semantic-naming-clarity.md"},{"slug":"turborepo-document-configuration-alternatives","title":"Document configuration alternatives","description":"When documenting commands or tools that can be executed in different ways based on configuration settings (like global vs. local installation), always explicitly describe all alternatives with clear, consistent labeling. Include examples for each configuration option to ensure users can follow instructions regardless of their environment setup.","repository":"vercel/turborepo","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2025-06-21","comments":3,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-document-configuration-alternatives.md"},{"slug":"turborepo-standardize-package-manager-commands","title":"Standardize package manager commands","description":"Ensure all package manager commands in documentation and CI/CD scripts follow the correct syntax for the specific package manager being used, especially in monorepo environments. Package manager flags should be positioned correctly according to each tool's specifications to prevent pipeline failures.","repository":"vercel/turborepo","domain":"devtools","topic":"CI/CD","language":"Markdown","updated":"2025-06-21","comments":3,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-standardize-package-manager-commands.md"},{"slug":"ghostty-prefer-flat-control-flow","title":"Prefer flat control flow","description":"Minimize code nesting by using Swift features like `guard` statements and early returns instead of deeply nested if-else structures. When multiple code branches end with a return statement, avoid nesting with `else` clauses.","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Code Style","language":"Swift","updated":"2025-06-21","comments":2,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-prefer-flat-control-flow.md"},{"slug":"traefik-ensure-documentation-completeness","title":"ensure documentation completeness","description":"Documentation should include all necessary information for users to successfully implement features. This includes providing complete configuration examples in all supported formats, documenting all available options, including prerequisites and setup requirements, and adding proper metadata.","repository":"traefik/traefik","domain":"cloud-infra","topic":"Documentation","language":"Markdown","updated":"2025-06-20","comments":8,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-ensure-documentation-completeness.md"},{"slug":"bun-check-exceptions-consistently","title":"Check exceptions consistently","description":"Always check for exceptions immediately after operations that might throw them, especially before using the results in control flow decisions. When accessing properties that might be used in conditionals, retrieve the property first, check for exceptions, and then use the property in the conditional.","repository":"oven-sh/bun","domain":"runtimes","topic":"Error Handling","language":"C++","updated":"2025-06-20","comments":6,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-check-exceptions-consistently.md"},{"slug":"mono-preserve-error-context","title":"preserve error context","description":"When propagating errors through promise rejections, catch blocks, or error transformations, always preserve the original error information to maintain debugging context and error traceability.","repository":"rocicorp/mono","domain":"data-systems","topic":"Error Handling","language":"TypeScript","updated":"2025-06-20","comments":5,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-preserve-error-context.md"},{"slug":"neon-flexible-documented-configurations","title":"Flexible documented configurations","description":"Create configuration interfaces that are flexible, well-documented, and future-proof. When designing configuration parameters: 1. **Prefer flexible parameterization** - Use functions/interfaces with optional parameters and sensible defaults rather than separate specialized functions for related configuration operations.","repository":"neondatabase/neon","domain":"data-systems","topic":"Configurations","language":"Other","updated":"2025-06-20","comments":5,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-flexible-documented-configurations.md"},{"slug":"sentry-remove-unnecessary-code-elements","title":"Remove unnecessary code elements","description":"Keep code clean and maintainable by removing unnecessary elements. This includes: 1. Omit type annotations when TypeScript can infer them: ```typescript","repository":"getsentry/sentry","domain":"observability","topic":"Code Style","language":"TSX","updated":"2025-06-20","comments":5,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-remove-unnecessary-code-elements.md"},{"slug":"signoz-centralize-configuration-management","title":"Centralize configuration management","description":"Consolidate configuration parameters into centralized config structures instead of using scattered options structs or hardcoded values. Configuration should be owned and controlled by the appropriate component, with all related settings grouped together in well-organized config files.","repository":"SigNoz/signoz","domain":"observability","topic":"Configurations","language":"Go","updated":"2025-06-20","comments":5,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-centralize-configuration-management.md"},{"slug":"material-ui-avoid-render-cycle-allocations","title":"Avoid render cycle allocations","description":"Creating new objects, arrays, or functions inside a component's render cycle causes unnecessary allocations on every render, which can degrade performance, especially in frequently-rendered components.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Performance Optimization","language":"JavaScript","updated":"2025-06-20","comments":4,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-avoid-render-cycle-allocations.md"},{"slug":"neovim-initialize-before-dereferencing","title":"Initialize before dereferencing","description":"Always ensure buffers, containers, and data structures are properly initialized before passing them to functions that will dereference them. This prevents null pointer dereferences and undefined behavior.","repository":"neovim/neovim","domain":"devtools","topic":"Null Handling","language":"C","updated":"2025-06-20","comments":4,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-initialize-before-dereferencing.md"},{"slug":"node-format-docs-for-readability","title":"Format docs for readability","description":"Documentation should follow consistent formatting and structural patterns to maximize readability and maintainability. Key guidelines: 1. Keep line lengths to 80 characters maximum","repository":"nodejs/node","domain":"runtimes","topic":"Documentation","language":"Markdown","updated":"2025-06-20","comments":4,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-format-docs-for-readability.md"},{"slug":"runtime-structure-configuration-options","title":"Structure configuration options","description":"Design and document configuration options (feature flags, environment variables, conditional compilation) to be clear, consistent, and maintainable. Group related configurations together and avoid unnecessary splits or redundancies. Document the purpose and behavior of each option, including valid values and interaction effects.","repository":"dotnet/runtime","domain":"runtimes","topic":"Configurations","language":"C++","updated":"2025-06-20","comments":4,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-structure-configuration-options.md"},{"slug":"ghostty-define-explicit-error-sets","title":"Define explicit error sets","description":"Always define explicit error sets for functions that can fail, rather than using inferred error sets. This makes error handling more maintainable and helps catch missing error cases during development. The error set should be defined at the function level, even for simple APIs.","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Error Handling","language":"Other","updated":"2025-06-20","comments":3,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-define-explicit-error-sets.md"},{"slug":"opencode-use-descriptive-specific-names","title":"Use descriptive specific names","description":"Choose names that clearly communicate purpose and scope rather than generic or overly broad terms. Names should be specific enough to accommodate future variants and descriptive enough to indicate their function without requiring additional context.","repository":"sst/opencode","domain":"ai-agents","topic":"Naming Conventions","language":"Go","updated":"2025-06-20","comments":3,"stars":28213,"raw":"https://awesomereviewers.com/raw/opencode-use-descriptive-specific-names.md"},{"slug":"sentry-centralize-ai-code","title":"Centralize AI code","description":"Move AI-specific functionality (especially prompts) to dedicated services rather than scattering them throughout the codebase. This improves maintainability and follows team conventions.","repository":"getsentry/sentry","domain":"observability","topic":"AI","language":"Python","updated":"2025-06-20","comments":3,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-centralize-ai-code.md"},{"slug":"temporal-context-aware-network-calls","title":"Context-aware network calls","description":"Always propagate context through network calls to ensure proper cancellation, timeout handling, and tracing. For HTTP requests, use `http.NewRequestWithContext()` instead of `http.Post()` or `http.Get()`. For gRPC, ensure context is passed and enriched with necessary metadata.","repository":"temporalio/temporal","domain":"orchestration","topic":"Networking","language":"Go","updated":"2025-06-20","comments":3,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-context-aware-network-calls.md"},{"slug":"temporal-structured-contextual-logging","title":"Structured contextual logging","description":"Always use structured logging with appropriate tags instead of string concatenation or formatting. Include relevant contextual information that would help in troubleshooting, such as namespace, operation ID, or workflow ID.","repository":"temporalio/temporal","domain":"orchestration","topic":"Logging","language":"Go","updated":"2025-06-20","comments":3,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-structured-contextual-logging.md"},{"slug":"azure-sdk-for-net-complete-pipeline-configurations","title":"Complete pipeline configurations","description":"Ensure all CI/CD configuration files have their required fields properly populated with specific values rather than empty strings or placeholders. Missing or incomplete configuration values can cause pipeline failures, prevent proper asset publishing, or create unnecessary maintenance overhead. Regularly review configurations to validate they're accurate...","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"CI/CD","language":"Json","updated":"2025-06-20","comments":2,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-complete-pipeline-configurations.md"},{"slug":"maplibre-native-use-specific-test-assertions","title":"Use specific test assertions","description":"Always use the most specific test assertion method available for your test case rather than generic assertions. Specific assertions provide better error messages and make test failures easier to debug.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Testing","language":"C++","updated":"2025-06-20","comments":2,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-use-specific-test-assertions.md"},{"slug":"neon-optimize-what-matters","title":"Optimize what matters","description":"Focus optimization efforts on performance-critical paths rather than applying micro-optimizations everywhere. Balance code clarity and maintainability against performance gains, and only optimize when there's a measurable benefit.","repository":"neondatabase/neon","domain":"data-systems","topic":"Performance Optimization","language":"C","updated":"2025-06-20","comments":2,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-optimize-what-matters.md"},{"slug":"prometheus-centralize-shared-configurations","title":"Centralize shared configurations","description":"When adding common functionality like help targets, build rules, or other configuration elements that will be used across multiple projects or subdirectories, prefer centralizing them in shared configuration files rather than duplicating the implementation.","repository":"prometheus/prometheus","domain":"observability","topic":"Configurations","language":"Other","updated":"2025-06-20","comments":2,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-centralize-shared-configurations.md"},{"slug":"ruff-clear-and-relevant-comments","title":"Clear and relevant comments","description":"Ensure all comments in the codebase provide value and clarity rather than creating confusion. Remove comments that are: 1. Not applicable to the current framework (e.g., linter directives for tools you''re not using)","repository":"astral-sh/ruff","domain":"devtools","topic":"Code Style","language":"Python","updated":"2025-06-20","comments":2,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-clear-and-relevant-comments.md"},{"slug":"sentry-migration-model-imports","title":"Migration model imports","description":"When writing Django migrations, avoid importing and referencing external models directly. Django migrations use auto-generated model classes based on the migration state at that point, not the current model definitions. These migration-specific models ensure compatibility with the database schema as it existed at that migration's point in time.","repository":"getsentry/sentry","domain":"observability","topic":"Migrations","language":"Python","updated":"2025-06-20","comments":2,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-migration-model-imports.md"},{"slug":"sentry-use-acks-late-for-reliability","title":"Use acks_late for reliability","description":"Configure Celery tasks with `acks_late=True` when task reliability is critical and you prefer to risk duplicate processing rather than task loss. This setting ensures tasks aren't acknowledged until successfully completed, allowing them to be reprocessed if a worker crashes or a deployment occurs during task execution.","repository":"getsentry/sentry","domain":"observability","topic":"Celery","language":"Python","updated":"2025-06-20","comments":2,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-use-acks-late-for-reliability.md"},{"slug":"union-version-serializable-structures","title":"Version serializable structures","description":"All serializable data structures that may evolve over time must include explicit versioning to enable backward and forward compatibility during migrations. This prevents breaking changes when schemas need to evolve and allows for graceful handling of different versions.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Migrations","language":"Rust","updated":"2025-06-20","comments":2,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-version-serializable-structures.md"},{"slug":"discourse-use-guardian-authorization-classes","title":"use Guardian authorization classes","description":"Always implement authorization checks using Guardian classes rather than ad-hoc permission logic. Guardian classes provide a centralized, consistent approach to authorization that helps prevent security vulnerabilities from inconsistent or missing permission checks.","repository":"discourse/discourse","domain":"app-frameworks","topic":"Security","language":"Markdown","updated":"2025-06-20","comments":1,"stars":44898,"raw":"https://awesomereviewers.com/raw/discourse-use-guardian-authorization-classes.md"},{"slug":"prowler-precise-csp-configuration","title":"Precise CSP configuration","description":"When integrating third-party services into your web application, carefully configure Content Security Policy (CSP) headers by explicitly specifying only the necessary domains for each directive. Understand the complete technical requirements of each service, including resources they might dynamically load. Add domains to appropriate directives based on how...","repository":"prowler-cloud/prowler","domain":"security","topic":"Security","language":"JavaScript","updated":"2025-06-20","comments":1,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-precise-csp-configuration.md"},{"slug":"appwrite-consistent-terminology-propagation","title":"Consistent terminology propagation","description":"When changing terminology or naming conventions in a codebase, ensure complete and consistent propagation across all related code artifacts. This includes variable names, method names, parameters, error messages, documentation, comments, and any other references. Inconsistent terminology creates cognitive overhead, leads to bugs, and hampers maintainability.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Naming Conventions","language":"PHP","updated":"2025-06-19","comments":15,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-consistent-terminology-propagation.md"},{"slug":"appwrite-enforce-api-endpoint-consistency","title":"Enforce API endpoint consistency","description":"When implementing or modifying API endpoints, ensure consistency across related routes by checking: 1. Parameter naming matches between route definition and handler:","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"API","language":"PHP","updated":"2025-06-19","comments":10,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-enforce-api-endpoint-consistency.md"},{"slug":"fastapi-documentation-translation-guidelines","title":"Documentation translation guidelines","description":"Maintain consistency and accuracy when translating documentation. Ensure technical terms and special formatting elements are handled properly according to project guidelines.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-06-19","comments":9,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-documentation-translation-guidelines.md"},{"slug":"prometheus-configuration-mutual-exclusivity-validation","title":"Configuration mutual exclusivity validation","description":"Ensure configuration options that are mutually exclusive are properly validated with clear, actionable error messages. When introducing configuration fields that cannot be used together, implement validation logic that checks for conflicts and provides specific guidance to users.","repository":"prometheus/prometheus","domain":"observability","topic":"Configurations","language":"Go","updated":"2025-06-19","comments":8,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-configuration-mutual-exclusivity-validation.md"},{"slug":"appwrite-keep-documentation-paths-current","title":"Keep documentation paths current","description":"Maintain accurate and consistent documentation paths, references, and descriptions across the codebase. When terminology or architecture changes, ensure all documentation references are updated to reflect the current state.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Documentation","language":"PHP","updated":"2025-06-19","comments":7,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-keep-documentation-paths-current.md"},{"slug":"appwrite-secure-authorization-skip-handling","title":"Secure authorization skip handling","description":"When using authorization bypass mechanisms like `Authorization::skip()`, ensure proper security validation is maintained. Authorization skipping should only be used for internal system operations where the caller already has appropriate permissions, never for user-facing operations that require access control.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Security","language":"PHP","updated":"2025-06-19","comments":6,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-secure-authorization-skip-handling.md"},{"slug":"framework-cache-expensive-operations","title":"Cache expensive operations","description":"Identify and cache results of expensive operations that may be called repeatedly during a request lifecycle, especially recursive functions or operations performed in loops. This reduces redundant processing and can significantly improve application performance.","repository":"laravel/framework","domain":"app-frameworks","topic":"Performance Optimization","language":"PHP","updated":"2025-06-19","comments":6,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-cache-expensive-operations.md"},{"slug":"node-minimize-configuration-dependencies","title":"Minimize configuration dependencies","description":"Keep configuration dependencies minimal and platform-aware. Avoid including unnecessary configuration files or external tools that can introduce unpredictable behaviors or unrelated settings. For platform-specific code, use conditional compilation to ensure that components are only built and executed in relevant environments.","repository":"nodejs/node","domain":"runtimes","topic":"Configurations","language":"Other","updated":"2025-06-19","comments":5,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-minimize-configuration-dependencies.md"},{"slug":"novu-environment-variable-fallbacks","title":"Environment variable fallbacks","description":"Always implement proper fallback chains for environment variables and handle missing configuration gracefully. When introducing new environment variables, maintain backward compatibility with existing ones, and apply environment-specific behavior conditionally to avoid issues across different deployment contexts.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2025-06-19","comments":5,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-environment-variable-fallbacks.md"},{"slug":"azure-sdk-for-net-write-deterministic-tests","title":"Write deterministic tests","description":"Tests should be deterministic, reliable, and isolated from external dependencies to ensure consistent results across environments. To achieve this: 1. **Avoid direct network calls** that can introduce flakiness and slow down tests. Instead:","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Testing","language":"C#","updated":"2025-06-19","comments":4,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-write-deterministic-tests.md"},{"slug":"material-ui-semantic-descriptive-naming","title":"Semantic descriptive naming","description":"Choose names that clearly communicate purpose, behavior, and semantics of code elements. Names should be self-explanatory and convey their intended functionality without requiring additional context.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Naming Conventions","language":"JavaScript","updated":"2025-06-19","comments":4,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-semantic-descriptive-naming.md"},{"slug":"polars-design-for-operation-flexibility","title":"Design for operation flexibility","description":"When implementing algorithms that operate on data structures (particularly arrays, lists, or collections), design them to handle both constant and expression-based inputs efficiently. Consider the constraints each imposes on the algorithm:","repository":"pola-rs/polars","domain":"data-systems","topic":"Algorithms","language":"Python","updated":"2025-06-19","comments":4,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-design-for-operation-flexibility.md"},{"slug":"ruff-support-configuration-extension-patterns","title":"Support configuration extension patterns","description":"When designing configuration systems, provide both replacement and extension options for list-based settings to give users flexibility in how they modify default configurations.","repository":"astral-sh/ruff","domain":"devtools","topic":"Configurations","language":"Rust","updated":"2025-06-19","comments":4,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-support-configuration-extension-patterns.md"},{"slug":"vscode-optimize-algorithmic-complexity-first","title":"Optimize algorithmic complexity first","description":"When implementing algorithms, prioritize reducing computational complexity before adding special cases or optimizing for specific scenarios. Key practices:","repository":"microsoft/vscode","domain":"devtools","topic":"Algorithms","language":"TypeScript","updated":"2025-06-19","comments":4,"stars":174887,"raw":"https://awesomereviewers.com/raw/vscode-optimize-algorithmic-complexity-first.md"},{"slug":"prowler-pin-github-actions-dependencies","title":"Pin GitHub Actions dependencies","description":"Always pin GitHub Actions to specific commit SHAs rather than using major version references to prevent supply chain attacks and ensure workflow stability. This practice ensures your CI/CD pipelines remain consistent and secure even if the referenced action is updated or compromised.","repository":"prowler-cloud/prowler","domain":"security","topic":"CI/CD","language":"Yaml","updated":"2025-06-19","comments":3,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-pin-github-actions-dependencies.md"},{"slug":"argo-cd-organize-css-systematically","title":"Organize CSS systematically","description":"When working with CSS/SCSS, prioritize organization and avoid duplication by following these principles: 1. **Extract related styles into dedicated files** - Group thematically related CSS rules (like motion controls, accessibility overrides, or component variants) into separate SCSS files and import them centrally for better maintainability.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Code Style","language":"Css","updated":"2025-06-19","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-organize-css-systematically.md"},{"slug":"duckdb-use-specialized-sensitive-types","title":"Use specialized sensitive types","description":"When handling sensitive data like encryption keys, choose data types based on the data's lifecycle and security requirements. Use specialized types (e.g., `EncryptionKey`) for actual sensitive data that persists in memory, as these provide memory locking and secure deletion. Use regular strings only for temporary user input that gets immediately processed...","repository":"duckdb/duckdb","domain":"data-systems","topic":"Security","language":"Other","updated":"2025-06-19","comments":2,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-use-specialized-sensitive-types.md"},{"slug":"kilocode-document-configuration-requirements","title":"Document configuration requirements","description":"Always document configuration requirements, environment variables, and version specifications to ensure consistent development environments and proper system setup. This includes documenting environment variables that enhance workflow, specifying exact versions in configuration files, and providing clear setup instructions.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2025-06-19","comments":2,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-document-configuration-requirements.md"},{"slug":"llvm-project-ensure-comprehensive-documentation","title":"Ensure comprehensive documentation","description":"Documentation should be complete, properly formatted, and clearly explain purpose with adequate examples. When writing documentation, ensure that: 1. **Code examples are properly formatted** - Match indentation requirements and follow established formatting conventions","repository":"llvm/llvm-project","domain":"runtimes","topic":"Documentation","language":"Other","updated":"2025-06-19","comments":2,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-ensure-comprehensive-documentation.md"},{"slug":"react-native-environment-variable-validation","title":"Environment variable validation","description":"Environment variables should be properly validated with correct type checking and without redundant conditions. Common issues include comparing strings to integers and using unnecessary double-checks that can lead to unexpected behavior.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Configurations","language":"Ruby","updated":"2025-06-19","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-environment-variable-validation.md"},{"slug":"react-native-follow-established-naming-conventions","title":"Follow established naming conventions","description":"Ensure all identifiers (variables, methods, classes) adhere to the project's established naming conventions and accurately reflect their purpose. Consistency in naming patterns improves code readability and maintainability across the codebase.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Naming Conventions","language":"Ruby","updated":"2025-06-19","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-follow-established-naming-conventions.md"},{"slug":"roo-code-verify-documentation-references","title":"Verify documentation references","description":"Ensure all references in documentation (file paths, commands, code examples) actually exist in the codebase and accurately reflect the current system state. Additionally, verify that translations maintain correct meaning and grammar in all supported languages.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Documentation","language":"Markdown","updated":"2025-06-19","comments":2,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-verify-documentation-references.md"},{"slug":"runtime-maintain-configuration-compatibility","title":"Maintain configuration compatibility","description":"When modifying configuration systems, prioritize backward compatibility unless there's an explicit breaking change planned. If a breaking change is necessary, implement compatibility handlers for older configurations and clearly communicate the transition plan.","repository":"dotnet/runtime","domain":"runtimes","topic":"Configurations","language":"Txt","updated":"2025-06-19","comments":2,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-maintain-configuration-compatibility.md"},{"slug":"vite-code-example-consistency","title":"Code example consistency","description":"Ensure code examples in documentation and comments are syntactically correct and properly marked with the appropriate language identifier. This maintains a professional appearance and prevents readers from copying incorrect code.","repository":"vitejs/vite","domain":"devtools","topic":"Code Style","language":"Markdown","updated":"2025-06-19","comments":2,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-code-example-consistency.md"},{"slug":"appwrite-handle-errors-gracefully-always","title":"Handle errors gracefully always","description":"Always implement graceful error handling for resource lookups, data parsing, and system operations. Catch specific exceptions, provide clear error messages, and ensure the system can continue operating in a degraded state rather than failing completely.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Error Handling","language":"PHP","updated":"2025-06-18","comments":10,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-handle-errors-gracefully-always.md"},{"slug":"spring-framework-complete-api-documentation","title":"Complete API documentation","description":"Documentation should be complete, accurate, and follow Spring Framework conventions. Ensure your Javadocs include: 1. **Clear and accurate descriptions** that precisely explain behavior and purpose","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Documentation","language":"Java","updated":"2025-06-18","comments":10,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-complete-api-documentation.md"},{"slug":"prometheus-metrics-registration-lifecycle","title":"metrics registration lifecycle","description":"Ensure proper metrics registration and lifecycle management to maintain observability system stability. Handle metric registration/unregistration correctly during configuration changes and avoid common pitfalls that can cause panics or data loss.","repository":"prometheus/prometheus","domain":"observability","topic":"Observability","language":"Go","updated":"2025-06-18","comments":8,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-metrics-registration-lifecycle.md"},{"slug":"langchainjs-use-comprehensive-jsdoc","title":"Use comprehensive JSDoc","description":"Always use JSDoc format (`/** */`) instead of regular comments (`//`) for documenting classes, functions, and interfaces. Documentation should be comprehensive, including:","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Documentation","language":"TypeScript","updated":"2025-06-18","comments":7,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-use-comprehensive-jsdoc.md"},{"slug":"node-public-over-internal-apis","title":"Public over internal APIs","description":"When designing or implementing APIs, always prefer publicly documented APIs over internal ones. Internal APIs may change without notice as they aren't subject to semantic versioning guarantees.","repository":"nodejs/node","domain":"runtimes","topic":"API","language":"JavaScript","updated":"2025-06-18","comments":7,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-public-over-internal-apis.md"},{"slug":"quarkus-document-configuration-comprehensively","title":"Document configuration comprehensively","description":"Configuration properties should be thoroughly documented with explicit details about constraints, units, default values, and behavior implications. This helps users understand how to use them correctly and troubleshoot issues.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Configurations","language":"Java","updated":"2025-06-18","comments":7,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-document-configuration-comprehensively.md"},{"slug":"zod-secure-input-validation-rules","title":"Secure Input Validation Rules","description":"When validating security-sensitive inputs (IDs, hostnames, tokens, IPs, payment-like numbers), ensure the implementation is strict, resilient, portable, and non-leaky:","repository":"colinhacks/zod","domain":"app-frameworks","topic":"Security","language":"TypeScript","updated":"2025-06-18","comments":7,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-secure-input-validation-rules.md"},{"slug":"opencv-use-opencv-error-mechanisms","title":"Use OpenCV error mechanisms","description":"Always use OpenCV's built-in error handling mechanisms instead of C++ exceptions or custom error handling. This ensures consistent error handling across the codebase and proper integration with OpenCV's error handling infrastructure.","repository":"opencv/opencv","domain":"ml-systems","topic":"Error Handling","language":"C++","updated":"2025-06-18","comments":6,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-use-opencv-error-mechanisms.md"},{"slug":"rails-document-apis-clearly","title":"Document APIs clearly","description":"When designing and documenting APIs, prioritize clarity and completeness through concrete examples and accurate parameter descriptions. Your documentation should help developers understand both the basic usage and edge cases of your API.","repository":"rails/rails","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2025-06-18","comments":6,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-document-apis-clearly.md"},{"slug":"rails-initialize-nil-prone-variables","title":"Initialize nil-prone variables","description":"Always initialize variables that might be nil to appropriate default values to prevent unexpected behavior. For boolean flags, explicitly initialize to false in constructors or initialization methods:","repository":"rails/rails","domain":"app-frameworks","topic":"Null Handling","language":"Ruby","updated":"2025-06-18","comments":5,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-initialize-nil-prone-variables.md"},{"slug":"cline-avoid-generic-suffixes","title":"Avoid generic suffixes","description":"Avoid using generic suffixes like \"Response\", \"Result\", or \"Request\" in type names, especially for non-request types. Instead, use semantic names that describe the actual data structure and can be reused throughout the codebase.","repository":"cline/cline","domain":"ai-agents","topic":"Naming Conventions","language":"Other","updated":"2025-06-18","comments":4,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-avoid-generic-suffixes.md"},{"slug":"deno-explicit-dependency-configuration","title":"explicit dependency configuration","description":"Ensure dependency configurations are explicit and predictable to avoid confusion and unexpected build behavior. Avoid package aliases that obscure the actual dependency being used, prefer published versions over git dependencies for stability, and be explicit about features that control critical behaviors like linking.","repository":"denoland/deno","domain":"runtimes","topic":"Configurations","language":"Toml","updated":"2025-06-18","comments":4,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-explicit-dependency-configuration.md"},{"slug":"electron-mark-experimental-configuration-features","title":"mark experimental configuration features","description":"Always mark experimental and deprecated configuration options with appropriate stability indicators in documentation. Use `_Experimental_` for features under active development and `_Deprecated_` for features being phased out. This helps developers make informed decisions about which configuration options are safe for production use.","repository":"electron/electron","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2025-06-18","comments":4,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-mark-experimental-configuration-features.md"},{"slug":"grafana-consistent-api-versioning-approach","title":"Consistent API versioning approach","description":"Adopt and document a consistent approach to API versioning across your services. The chosen format should be clearly communicated, whether using the simple form (e.g., `\"apiVersion\": \"v0alpha1\"`) or the fully qualified form (e.g., `\"apiVersion\": \"prometheus.datasource.grafana.app/v0alpha1\"`).","repository":"grafana/grafana","domain":"observability","topic":"API","language":"Go","updated":"2025-06-18","comments":4,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-consistent-api-versioning-approach.md"},{"slug":"pr-agent-bound-llm-budgets","title":"Bound LLM Budgets","description":"When configuring generative AI for code-review workflows, keep prompts and model behaviors tightly bounded to control latency/cost while preserving quality.","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"AI","language":"Toml","updated":"2025-06-18","comments":4,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-bound-llm-budgets.md"},{"slug":"sentry-raise-contextual-error-types","title":"Raise contextual error types","description":"Always raise specific, contextual exception types instead of generic exceptions. Include relevant error details that help identify the root cause and potential solutions. This improves error tracking, debugging, and system reliability.","repository":"getsentry/sentry","domain":"observability","topic":"Error Handling","language":"Python","updated":"2025-06-18","comments":4,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-raise-contextual-error-types.md"},{"slug":"v-document-algorithm-behavior","title":"Document algorithm behavior","description":"When implementing or documenting algorithms, clearly specify their behavior, expected outputs, and usage patterns. This includes documenting mathematical operation semantics, output characteristics, and providing complete examples that demonstrate the algorithm's behavior.","repository":"vlang/v","domain":"runtimes","topic":"Algorithms","language":"Markdown","updated":"2025-06-18","comments":4,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-document-algorithm-behavior.md"},{"slug":"dify-ensure-configuration-consistency","title":"Ensure configuration consistency","description":"Maintain consistency across configuration variables to prevent setup confusion and deployment issues. Avoid duplicate or conflicting environment variables, ensure related configuration values align, and use appropriate defaults for the deployment context.","repository":"langgenius/dify","domain":"llm-infra","topic":"Configurations","language":"Other","updated":"2025-06-18","comments":3,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-ensure-configuration-consistency.md"},{"slug":"dify-maintain-consistent-organization","title":"Maintain consistent organization","description":"Ensure proper file organization and consistent import conventions throughout the codebase. Assets should be placed in designated folders, utility functions should be moved to appropriate shared locations, and import paths should follow established patterns.","repository":"langgenius/dify","domain":"llm-infra","topic":"Code Style","language":"TSX","updated":"2025-06-18","comments":3,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-maintain-consistent-organization.md"},{"slug":"django-validate-security-related-inputs","title":"Validate security-related inputs","description":"Always validate and sanitize all inputs that influence security-related functionality at the application level, rather than relying on underlying systems to handle invalid inputs. This prevents potential security vulnerabilities and provides clearer error messages to developers.","repository":"django/django","domain":"app-frameworks","topic":"Security","language":"Python","updated":"2025-06-18","comments":3,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-validate-security-related-inputs.md"},{"slug":"kong-pin-and-inline-ci","title":"Pin and Inline CI","description":"Harden CI/CD workflows by (1) pinning external actions/tool versions, (2) minimizing opaque third-party action wrappers when the underlying steps are small and deterministic, and (3) scoping dependency installation to the right workflow (local dev vs CI).","repository":"Kong/kong","domain":"cloud-infra","topic":"CI/CD","language":"Yaml","updated":"2025-06-18","comments":3,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-pin-and-inline-ci.md"},{"slug":"material-ui-use-design-system-tokens","title":"Use design system tokens","description":"Always use design system tokens (theme values, breakpoints, spacing units) instead of hard-coded values. This ensures consistency across the codebase and makes maintenance easier when design changes are needed.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Code Style","language":"TSX","updated":"2025-06-18","comments":3,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-use-design-system-tokens.md"},{"slug":"react-native-follow-platform-naming-conventions","title":"Follow platform naming conventions","description":"Adhere to the established naming conventions and namespacing practices of your target platform. This includes following language-specific patterns for method names, avoiding namespace pollution in headers, and properly namespacing exported functions.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Naming Conventions","language":"Other","updated":"2025-06-18","comments":3,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-follow-platform-naming-conventions.md"},{"slug":"llama.cpp-use-environment-variables","title":"Use environment variables","description":"Prefer environment variables over hardcoded paths and configuration values in build scripts and configuration files. This approach improves portability, flexibility, and maintainability by allowing different environments to specify their own paths without modifying the codebase.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Configurations","language":"Txt","updated":"2025-06-18","comments":2,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-use-environment-variables.md"},{"slug":"maplibre-native-configuration-over-hardcoding","title":"Configuration over hardcoding","description":"When designing APIs, prefer exposing behavior through configuration options rather than hardcoding logic, especially for aspects that might vary across implementations or require customization. This creates more flexible APIs that can adapt to changing requirements without code modifications.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"API","language":"C++","updated":"2025-06-18","comments":2,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-configuration-over-hardcoding.md"},{"slug":"novu-comprehensive-null-checks","title":"comprehensive null checks","description":"When checking for null or undefined values in conditional statements, ensure all related nullable dependencies are validated together in the same condition. Partial null checks can lead to runtime errors when some dependencies are validated while others are not.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Null Handling","language":"TSX","updated":"2025-06-18","comments":2,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-comprehensive-null-checks.md"},{"slug":"nuxt-organize-accessibility-attributes","title":"organize accessibility attributes","description":"Systematically organize HTML elements by adding appropriate accessibility attributes (aria-label, role) to improve code structure and semantic clarity. Place accessibility attributes immediately after class attributes for consistent code organization and enhanced readability.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Code Style","language":"Html","updated":"2025-06-18","comments":2,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-organize-accessibility-attributes.md"},{"slug":"refact-complete-model-configurations","title":"Complete model configurations","description":"When adding new models to configuration files, ensure all required configuration fields are populated, not just the model name in the running_models list. Models need complete configuration in both JSON (known_models.json) and YAML (provider files) with all necessary fields specified.","repository":"smallcloudai/refact","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2025-06-18","comments":2,"stars":3114,"raw":"https://awesomereviewers.com/raw/refact-complete-model-configurations.md"},{"slug":"sentry-reduce-code-nesting","title":"Reduce code nesting","description":"Excessive indentation makes code harder to read and understand. Two common techniques can help flatten your code structure: 1. **Use early returns** for guard conditions instead of nesting the main logic in else blocks:","repository":"getsentry/sentry","domain":"observability","topic":"Code Style","language":"Python","updated":"2025-06-18","comments":2,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-reduce-code-nesting.md"},{"slug":"signoz-use-descriptive-names","title":"Use descriptive names","description":"Variable and function names should clearly communicate their actual purpose and behavior, not just their initial intent. Avoid vague or misleading names that don't accurately reflect what the code does.","repository":"SigNoz/signoz","domain":"observability","topic":"Naming Conventions","language":"TypeScript","updated":"2025-06-18","comments":2,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-use-descriptive-names.md"},{"slug":"typescript-use-typescript-specific-tests","title":"Use TypeScript-specific tests","description":"Always use fourslash tests (for IDE/language service features) or compiler tests (for TypeScript compilation behavior) instead of direct unit tests. Place tests in the correct directories: `tests/cases/compiler` or `tests/cases/fourslash`.","repository":"microsoft/typescript","domain":"runtimes","topic":"Testing","language":"Markdown","updated":"2025-06-18","comments":2,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-use-typescript-specific-tests.md"},{"slug":"kilocode-evaluate-ci-secret-exposure","title":"Evaluate CI secret exposure","description":"Before using secrets in CI/CD workflows that can be triggered by external contributors (forks, dependabot), assess the \"blast radius\" of potential secret compromise. Differentiate between high-risk secrets that provide infrastructure access and limited-scope secrets with constrained permissions.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Security","language":"Yaml","updated":"2025-06-18","comments":1,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-evaluate-ci-secret-exposure.md"},{"slug":"novu-enforce-permission-based-ui-controls","title":"Enforce permission-based UI controls","description":"Always implement proper authorization checks in UI components that expose sensitive functionality. Wrap buttons, forms, and other interactive elements that perform create, update, delete, or other privileged operations with permission-based controls to prevent unauthorized access.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Security","language":"TSX","updated":"2025-06-18","comments":1,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-enforce-permission-based-ui-controls.md"},{"slug":"brew-prefer-explicit-nil-handling","title":"Prefer explicit nil handling","description":"Handle nil values explicitly and consistently to improve code clarity and type safety. Follow these guidelines: 1. Use early returns for nil validation:","repository":"Homebrew/brew","domain":"devtools","topic":"Null Handling","language":"Ruby","updated":"2025-06-17","comments":10,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-prefer-explicit-nil-handling.md"},{"slug":"zed-standardize-platform-agnostic-configuration","title":"Standardize platform-agnostic configuration","description":"Ensure configuration handling is consistent and platform-agnostic by following these guidelines: 1. Use environment variables with fallbacks: ```rust","repository":"zed-industries/zed","domain":"devtools","topic":"Configurations","language":"Rust","updated":"2025-06-17","comments":10,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-standardize-platform-agnostic-configuration.md"},{"slug":"inbox-zero-use-transactions-for-consistency","title":"Use transactions for consistency","description":"Always wrap multiple related database operations in a transaction to ensure data consistency and prevent partial updates. This applies to operations across different tables or when coordinating database updates with external services (e.g., Redis cache).","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Database","language":"TypeScript","updated":"2025-06-17","comments":9,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-use-transactions-for-consistency.md"},{"slug":"prometheus-minimize-memory-allocations","title":"minimize memory allocations","description":"Prioritize memory allocation minimization through buffer reuse, pre-allocation, and efficient data structures. Allocations are among the worst performance bottlenecks, especially in hot paths and frequently called functions.","repository":"prometheus/prometheus","domain":"observability","topic":"Performance Optimization","language":"Go","updated":"2025-06-17","comments":9,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-minimize-memory-allocations.md"},{"slug":"ruff-precise-type-narrowing","title":"Precise type narrowing","description":"Implement sound type narrowing algorithms that balance precision with correctness. When narrowing types: 1. For direct assignments, narrow the type to the assigned value''s type:","repository":"astral-sh/ruff","domain":"devtools","topic":"Algorithms","language":"Markdown","updated":"2025-06-17","comments":8,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-precise-type-narrowing.md"},{"slug":"langfuse-maintain-naming-consistency","title":"Maintain naming consistency","description":"Use consistent and descriptive names for variables, components, and functions throughout the codebase. When the same concept appears in multiple places, use identical naming to prevent confusion and bugs. This includes:","repository":"langfuse/langfuse","domain":"observability","topic":"Naming Conventions","language":"TSX","updated":"2025-06-17","comments":6,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-maintain-naming-consistency.md"},{"slug":"argo-cd-choose-appropriate-synchronization-primitives","title":"Choose appropriate synchronization primitives","description":"Select the right synchronization mechanism based on your specific use case to avoid performance regressions and ensure thread safety. Follow these guidelines:","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Concurrency","language":"Go","updated":"2025-06-17","comments":5,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-choose-appropriate-synchronization-primitives.md"},{"slug":"logseq-optimize-algorithm-performance","title":"optimize algorithm performance","description":"When implementing algorithms, prioritize performance optimization through careful algorithm selection, query structure, and evaluation strategy choices. Key considerations include:","repository":"logseq/logseq","domain":"app-frameworks","topic":"Algorithms","language":"Other","updated":"2025-06-17","comments":5,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-optimize-algorithm-performance.md"},{"slug":"opencv-optimize-memory-allocation-patterns","title":"Optimize memory allocation patterns","description":"Prefer efficient memory allocation patterns to improve performance. Key practices: 1. Use RAII containers (like Mat) instead of raw pointers to prevent memory leaks","repository":"opencv/opencv","domain":"ml-systems","topic":"Performance Optimization","language":"C++","updated":"2025-06-17","comments":5,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-optimize-memory-allocation-patterns.md"},{"slug":"quarkus-optimize-algorithmic-operations","title":"Optimize algorithmic operations","description":"Before implementing or modifying algorithms, carefully evaluate data structure properties and operation costs. Always: 1. **Understand data structure guarantees**: Choose structures that provide the necessary ordering and performance characteristics. For instance, when replacing one structure with another, be aware of their different behaviors:","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Algorithms","language":"Java","updated":"2025-06-17","comments":5,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-optimize-algorithmic-operations.md"},{"slug":"argo-cd-explicit-security-controls","title":"explicit security controls","description":"Security configurations should use explicit controls and secure defaults rather than implicit permissions or hardcoded credentials. This principle helps prevent accidental privilege escalation and credential exposure.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Security","language":"Markdown","updated":"2025-06-17","comments":4,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-explicit-security-controls.md"},{"slug":"argo-cd-validate-untrusted-inputs","title":"Validate untrusted inputs","description":"Always validate and sanitize user-provided inputs to prevent injection attacks, particularly path traversal vulnerabilities. User inputs should be treated as untrusted and validated against expected patterns before use in file operations, URL construction, or system commands.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Security","language":"Go","updated":"2025-06-17","comments":4,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-validate-untrusted-inputs.md"},{"slug":"lmcache-maintain-comprehensive-error-handling","title":"Maintain comprehensive error handling","description":"Always preserve and implement thorough error handling that includes proper resource cleanup, meaningful logging, and appropriate return values. Don't remove existing error handling during code refactoring or simplification.","repository":"LMCache/LMCache","domain":"llm-infra","topic":"Error Handling","language":"Python","updated":"2025-06-17","comments":4,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-maintain-comprehensive-error-handling.md"},{"slug":"uv-use-direct-documentation-style","title":"Use direct documentation style","description":"Write documentation using direct, clear language that addresses the reader directly. Follow these style guidelines: 1. Use direct address instead of referring to \"users\" - write \"You can configure...\" rather than \"Users can configure...\"","repository":"astral-sh/uv","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2025-06-17","comments":4,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-use-direct-documentation-style.md"},{"slug":"brew-structure-test-fixtures-clearly","title":"Structure test fixtures clearly","description":"Test fixtures should clearly separate input parameters from expected outputs to enhance readability and maintainability. For table-driven tests, use a consistent pattern that explicitly distinguishes between test inputs and expected results. This approach makes tests more understandable and easier to maintain over time.","repository":"Homebrew/brew","domain":"devtools","topic":"Testing","language":"Ruby","updated":"2025-06-17","comments":3,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-structure-test-fixtures-clearly.md"},{"slug":"electron-async-destruction-safety","title":"async destruction safety","description":"When destroying objects asynchronously to avoid crashes from observer notifications or other synchronous destruction issues, ensure proper cleanup ordering and add defensive null checks to handle race conditions.","repository":"electron/electron","domain":"devtools","topic":"Concurrency","language":"Other","updated":"2025-06-17","comments":3,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-async-destruction-safety.md"},{"slug":"hyprland-configuration-consistency-validation","title":"configuration consistency validation","description":"When modifying configuration options, ensure changes are consistently applied across all relevant locations including default configuration files, documentation, example configs, and related codebases. Configuration inconsistencies create user confusion and maintenance burden.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Configurations","language":"Other","updated":"2025-06-17","comments":3,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-configuration-consistency-validation.md"},{"slug":"langfuse-secure-external-links","title":"Secure external links","description":"Always add `rel=\"noopener noreferrer\"` to external links that use `target=\"_blank\"` to prevent tabnabbing attacks. This security attribute prevents malicious websites from gaining access to your window object through the opener property, which could be exploited for phishing attacks or other security breaches.","repository":"langfuse/langfuse","domain":"observability","topic":"Security","language":"TSX","updated":"2025-06-17","comments":3,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-secure-external-links.md"},{"slug":"playwright-prefer-css-over-javascript","title":"prefer CSS over JavaScript","description":"Use CSS solutions instead of JavaScript state management for simple styling and interactions. This approach improves maintainability, reduces complexity, and follows web standards best practices.","repository":"microsoft/playwright","domain":"devtools","topic":"Code Style","language":"TSX","updated":"2025-06-17","comments":3,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-prefer-css-over-javascript.md"},{"slug":"quarkus-reuse-test-patterns","title":"Reuse test patterns","description":"Minimize duplication and improve test maintainability by reusing existing test patterns and leveraging parameterization. When testing similar functionality across modules or with varying inputs, prefer adapting existing test cases and using parameterized tests over creating entirely new test files.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Testing","language":"Java","updated":"2025-06-17","comments":3,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-reuse-test-patterns.md"},{"slug":"sentry-prefer-bulk-operations","title":"Prefer bulk operations","description":"When implementing functionality that processes multiple items, always consider the performance implications of individual versus batch processing. Avoid fetching or processing items one-by-one in loops, as this can lead to significant performance degradation, especially at scale. Instead:","repository":"getsentry/sentry","domain":"observability","topic":"Performance Optimization","language":"Python","updated":"2025-06-17","comments":3,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-prefer-bulk-operations.md"},{"slug":"django-ai-documentation-targeting","title":"AI documentation targeting","description":"When writing technical documentation, consider AI systems as a direct audience that may read and act upon your text. Include explicit instructions addressed to AI models that might process your content.","repository":"django/django","domain":"app-frameworks","topic":"AI","language":"Txt","updated":"2025-06-17","comments":2,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-ai-documentation-targeting.md"},{"slug":"neon-document-parameter-choices","title":"Document parameter choices","description":"Always add explanatory comments for parameters or configuration options that aren''t self-explanatory from their names or context. These comments should explain:","repository":"neondatabase/neon","domain":"data-systems","topic":"Documentation","language":"Python","updated":"2025-06-17","comments":2,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-document-parameter-choices.md"},{"slug":"signoz-ensure-log-message-clarity","title":"Ensure log message clarity","description":"Log messages should be clear, unambiguous, and avoid creating confusion for developers and operators. This means explicitly logging when no-op operations occur (rather than staying silent) and avoiding duplicate log entries with identical information that can mislead readers.","repository":"SigNoz/signoz","domain":"observability","topic":"Logging","language":"Go","updated":"2025-06-17","comments":2,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-ensure-log-message-clarity.md"},{"slug":"typescript-actionable-error-messages","title":"Actionable error messages","description":"When designing APIs, provide error messages that are contextually accurate, descriptive, and actionable. Generic error suggestions can confuse users when they don''t apply to the specific situation. Instead, tailor error responses to include:","repository":"microsoft/typescript","domain":"runtimes","topic":"API","language":"JavaScript","updated":"2025-06-17","comments":2,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-actionable-error-messages.md"},{"slug":"typescript-consistent-module-resolution","title":"Consistent module resolution","description":"Configure consistent module resolution strategies across related projects and ensure package.json files are properly set up for the chosen strategy. Different strategies (Node10, NodeNext) have distinct behaviors regarding package.json handling, which can cause subtle resolution errors and confusing tracing output.","repository":"microsoft/typescript","domain":"runtimes","topic":"Configurations","language":"JavaScript","updated":"2025-06-17","comments":2,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-consistent-module-resolution.md"},{"slug":"vitess-validate-environment-configurations","title":"Validate environment configurations","description":"Ensure that all environment-specific configurations work properly across all target environments, particularly when managing multiple architectures or CI systems. Test changes thoroughly in the actual environments where code will run. Document the purpose of specialized configurations and don't remove configuration blocks without verifying they're no longer...","repository":"vitessio/vitess","domain":"data-systems","topic":"Configurations","language":"Yaml","updated":"2025-06-17","comments":2,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-validate-environment-configurations.md"},{"slug":"azure-sdk-for-net-complete-authentication-testing","title":"Complete authentication testing","description":"Always verify both positive and negative authentication scenarios in your security tests. For each authentication mechanism, test that credentials are properly included when required and correctly absent when not needed. This comprehensive approach prevents potential authentication bypasses and ensures proper access control.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Security","language":"C#","updated":"2025-06-17","comments":1,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-complete-authentication-testing.md"},{"slug":"sentry-safe-url-navigation","title":"Safe URL navigation","description":"Always use sanitized navigation utilities instead of directly manipulating `window.location` with potentially user-influenced data to prevent cross-site scripting (XSS) vulnerabilities. User-provided values can contain malicious scripts that execute when inserted into navigation contexts.","repository":"getsentry/sentry","domain":"observability","topic":"Security","language":"TSX","updated":"2025-06-17","comments":1,"stars":41297,"raw":"https://awesomereviewers.com/raw/sentry-safe-url-navigation.md"},{"slug":"openpilot-prefer-explicit-readable-code","title":"Prefer explicit readable code","description":"Write code that prioritizes readability and explicitness over cleverness or brevity. This includes several key practices: **Import Organization**: Follow standard import ordering - stdlib and third-party imports first, then openpilot imports after a blank line:","repository":"commaai/openpilot","domain":"ml-systems","topic":"Code Style","language":"Python","updated":"2025-06-16","comments":9,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-prefer-explicit-readable-code.md"},{"slug":"prisma-dependency-classification-standards","title":"dependency classification standards","description":"Ensure proper classification and versioning of package dependencies in package.json files. Dependencies should be classified based on their usage pattern: use regular `dependencies` for hard requirements that the package cannot function without, and `peerDependencies` for packages that consumers are expected to provide. When specifying version ranges, use...","repository":"prisma/prisma","domain":"data-systems","topic":"Configurations","language":"Json","updated":"2025-06-16","comments":8,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-dependency-classification-standards.md"},{"slug":"fastapi-sync-versus-async-tests","title":"Sync versus async tests","description":"Choose the appropriate testing approach based on your test requirements. For standard API endpoint testing, use `TestClient` with regular functions. For tests requiring async operations (like database queries), use `AsyncClient` with proper async test configuration.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Testing","language":"Markdown","updated":"2025-06-16","comments":7,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-sync-versus-async-tests.md"},{"slug":"polars-names-reveal-clear-intent","title":"Names reveal clear intent","description":"Choose names that clearly communicate intent and context, avoiding ambiguity or confusion. Variable and function names should be self-documenting and reflect their domain purpose.","repository":"pola-rs/polars","domain":"data-systems","topic":"Naming Conventions","language":"Rust","updated":"2025-06-16","comments":6,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-names-reveal-clear-intent.md"},{"slug":"inbox-zero-time-precision-matters","title":"Time precision matters","description":"When implementing algorithms involving date and time calculations, maintain precise control over time components to avoid subtle bugs: 1. **Reset unwanted time components** - Always explicitly set seconds and milliseconds to zero when you only care about hours and minutes","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Algorithms","language":"TypeScript","updated":"2025-06-16","comments":5,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-time-precision-matters.md"},{"slug":"volcano-use-structured-logging","title":"Use structured logging","description":"Always use structured logging methods like klog.InfoS and klog.ErrorS instead of unstructured methods like klog.Infoln, klog.Infof, or klog.Errorln. Structured logging improves log parsing, analysis, and monitoring capabilities. Additionally, ensure log messages are clear, descriptive, and provide complete context about actions taken and values being set.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Logging","language":"Go","updated":"2025-06-16","comments":5,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-use-structured-logging.md"},{"slug":"airflow-safe-constraint-modification-sequence","title":"Safe constraint modification sequence","description":"When modifying constraints in database migrations, follow a safe sequence of operations to prevent integrity errors: 1. For adding not-nullable constraints to existing tables:","repository":"apache/airflow","domain":"orchestration","topic":"Migrations","language":"Python","updated":"2025-06-16","comments":4,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-safe-constraint-modification-sequence.md"},{"slug":"electron-ensure-async-error-cleanup","title":"Ensure async error cleanup","description":"Always ensure cleanup code executes and avoid creating dangling promises in error handling scenarios. Use try-catch-finally patterns for guaranteed cleanup, and avoid making error handlers async unless you properly handle promise rejections.","repository":"electron/electron","domain":"devtools","topic":"Error Handling","language":"TypeScript","updated":"2025-06-16","comments":4,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-ensure-async-error-cleanup.md"},{"slug":"neon-proper-option-type-usage","title":"Proper Option type usage","description":"Use Option<T> only for truly optional values that can meaningfully be None. Avoid using Option when a value is always required or when defaulting to empty/invalid values.","repository":"neondatabase/neon","domain":"data-systems","topic":"Null Handling","language":"Rust","updated":"2025-06-16","comments":4,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-proper-option-type-usage.md"},{"slug":"quarkus-automate-style-enforcement","title":"Automate style enforcement","description":"Implement automated code style enforcement using complementary tools rather than relying on manual reviews. Configure multiple tools to work together, as each has unique strengths and blind spots.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Code Style","language":"Xml","updated":"2025-06-16","comments":4,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-automate-style-enforcement.md"},{"slug":"terminal-safe-optional-handling","title":"Safe optional handling","description":"Always use safe patterns when working with optional, nullable, or potentially empty types. Avoid direct comparisons with optional values and ensure proper initialization of nullable members.","repository":"microsoft/terminal","domain":"devtools","topic":"Null Handling","language":"C++","updated":"2025-06-16","comments":4,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-safe-optional-handling.md"},{"slug":"neon-guard-against-race-conditions","title":"Guard against race conditions","description":"When working with concurrent operations, always implement proper guards to prevent race conditions between processes. This includes: 1. Adding explicit checks before operations that might be affected by concurrent processes:","repository":"neondatabase/neon","domain":"data-systems","topic":"Concurrency","language":"C","updated":"2025-06-16","comments":3,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-guard-against-race-conditions.md"},{"slug":"angular-pin-github-actions-sha","title":"Pin GitHub Actions SHA","description":"GitHub Actions should be pinned to specific SHA commits rather than mutable tag references to ensure security and reproducibility. Tags can be moved or updated by malicious actors, potentially introducing supply chain vulnerabilities, while SHA commits are immutable and provide guaranteed consistency across builds.","repository":"angular/angular","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2025-06-16","comments":2,"stars":98611,"raw":"https://awesomereviewers.com/raw/angular-pin-github-actions-sha.md"},{"slug":"azure-sdk-for-net-preserve-protocol-data-integrity","title":"Preserve protocol data integrity","description":"When working with network protocols (like AMQP, NFS, or SMB), maintain the integrity of the original protocol data structures during serialization, deserialization, and transformation operations. Modifying protocol-specific data can lead to unintended changes in the service contract and unexpected behavior for clients.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Networking","language":"Markdown","updated":"2025-06-16","comments":2,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-preserve-protocol-data-integrity.md"},{"slug":"inbox-zero-semantic-naming-consistency","title":"Semantic naming consistency","description":"Ensure all model and field names semantically reflect their actual purpose and maintain consistency with their usage throughout the codebase: 1. Choose names that accurately represent the entity''s role without misleading prefixes.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Naming Conventions","language":"Prisma","updated":"2025-06-16","comments":2,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-semantic-naming-consistency.md"},{"slug":"maplibre-native-numerical-precision-considerations","title":"Numerical precision considerations","description":"When implementing algorithms involving floating-point calculations, choose epsilon values based on the specific domain requirements rather than defaulting to system-defined constants. Standard values like `std::numeric_limits<double>::epsilon()` are often too small for practical geometric or graphical applications.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Algorithms","language":"C++","updated":"2025-06-16","comments":2,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-numerical-precision-considerations.md"},{"slug":"spark-test-algorithmic-performance-scaling","title":"Test algorithmic performance scaling","description":"When implementing or modifying algorithms, especially data structures like hash tables, bloom filters, or pattern matching logic, ensure performance characteristics are validated across different input scales. Many algorithms exhibit degraded performance or correctness issues that only become apparent with large datasets.","repository":"apache/spark","domain":"data-systems","topic":"Algorithms","language":"Java","updated":"2025-06-16","comments":2,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-test-algorithmic-performance-scaling.md"},{"slug":"ragflow-use-oauth-authorization-header","title":"Use OAuth Authorization Header","description":"When authenticating requests with bearer tokens or OAuth-derived credentials, transmit them using the standards-based `Authorization` request header as required by the relevant OAuth specification. Avoid sending secrets via custom headers like `api_key`, and ensure documentation/examples match the OAuth flow requirements.","repository":"infiniflow/ragflow","domain":"llm-infra","topic":"Security","language":"Markdown","updated":"2025-06-16","comments":1,"stars":80174,"raw":"https://awesomereviewers.com/raw/ragflow-use-oauth-authorization-header.md"},{"slug":"vitess-verify-dependency-integrity","title":"Verify dependency integrity","description":"Always verify the integrity of external dependencies, especially those downloaded from non-official or personal repositories. This helps prevent supply chain attacks where compromised packages could introduce security vulnerabilities.","repository":"vitessio/vitess","domain":"data-systems","topic":"Security","language":"Yaml","updated":"2025-06-16","comments":1,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-verify-dependency-integrity.md"},{"slug":"poetry-parameterize-similar-tests","title":"Parameterize similar tests","description":"Use `pytest.mark.parametrize` to consolidate similar test cases instead of duplicating test code. This approach improves maintainability, reduces code duplication, and ensures comprehensive test coverage across different scenarios.","repository":"python-poetry/poetry","domain":"devtools","topic":"Testing","language":"Python","updated":"2025-06-15","comments":12,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-parameterize-similar-tests.md"},{"slug":"hyprland-dynamic-configuration-handling","title":"Dynamic configuration handling","description":"When implementing configuration changes that need to be applied at runtime, follow these practices: 1. **Use reload mechanisms instead of immediate handling**: Don''t process configuration changes directly in dispatch functions. Instead, trigger reloads through proper channels.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Configurations","language":"C++","updated":"2025-06-15","comments":6,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-dynamic-configuration-handling.md"},{"slug":"react-router-configuration-consistency-standards","title":"configuration consistency standards","description":"Ensure configuration options, flags, and environment settings are handled consistently across all commands and modules. This includes supporting the same configuration flags across CLI commands, using standardized approaches for environment detection, and implementing clear precedence rules.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2025-06-15","comments":6,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-configuration-consistency-standards.md"},{"slug":"codex-structure-configurations-properly","title":"Structure configurations properly","description":"Define a clear, hierarchical structure for application configurations with descriptive naming and proper organization. Avoid hardcoded values, use named constants for magic numbers, and ensure configuration is loaded only once at startup and passed through the application rather than loaded at arbitrary points.","repository":"openai/codex","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-06-15","comments":5,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-structure-configurations-properly.md"},{"slug":"core-guarantee-cleanup-execution","title":"Guarantee cleanup execution","description":"When implementing features that require cleanup or state restoration, always use try-finally blocks to ensure cleanup code executes even when errors occur. This pattern prevents resources from being leaked, components from becoming stuck in intermediate states, and operations from remaining incomplete after exceptions.","repository":"vuejs/core","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2025-06-15","comments":4,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-guarantee-cleanup-execution.md"},{"slug":"codex-extract-reusable-logic","title":"Extract reusable logic","description":"Avoid duplicating logic across the codebase. Instead, extract common functionality into well-named helper functions or standalone utilities. This improves code readability, simplifies maintenance, and centralizes logic for easier updates.","repository":"openai/codex","domain":"ai-agents","topic":"Code Style","language":"TSX","updated":"2025-06-15","comments":3,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-extract-reusable-logic.md"},{"slug":"comfyui-prevent-path-traversal","title":"Prevent path traversal","description":"Always validate and sanitize file paths from user input to prevent directory traversal attacks. Malicious actors can use path manipulation techniques like `../../../` sequences or absolute paths to access files outside intended directories, potentially overwriting critical system files or accessing sensitive data.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Security","language":"Python","updated":"2025-06-15","comments":3,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-prevent-path-traversal.md"},{"slug":"codex-provider-agnostic-ai-code","title":"Provider-agnostic AI code","description":"Design AI integration code to be provider-agnostic, avoiding assumptions that all models will come from a single provider. Implement explicit handling for known models while maintaining fallback mechanisms for others.","repository":"openai/codex","domain":"ai-agents","topic":"AI","language":"TypeScript","updated":"2025-06-15","comments":2,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-provider-agnostic-ai-code.md"},{"slug":"drizzle-orm-avoid-cosmetic-formatting-changes","title":"avoid cosmetic formatting changes","description":"Avoid including purely cosmetic formatting changes in pull requests that serve a functional purpose. Automatic formatter changes (like Prettier reformatting, bracket placement, or line breaks) should be separated from functional changes to keep PRs focused and easier to review and merge.","repository":"drizzle-team/drizzle-orm","domain":"data-systems","topic":"Code Style","language":"TypeScript","updated":"2025-06-15","comments":2,"stars":29461,"raw":"https://awesomereviewers.com/raw/drizzle-orm-avoid-cosmetic-formatting-changes.md"},{"slug":"llvm-project-consistent-error-diagnostics","title":"consistent error diagnostics","description":"When implementing attributes, language features, or compiler diagnostics, always provide explicit error diagnostics rather than default warnings for misuse scenarios. Error messages should be clear, specific about the violation, and consistent with existing diagnostic patterns in the codebase.","repository":"llvm/llvm-project","domain":"runtimes","topic":"Error Handling","language":"Other","updated":"2025-06-15","comments":2,"stars":33702,"raw":"https://awesomereviewers.com/raw/llvm-project-consistent-error-diagnostics.md"},{"slug":"zod-use-existing-abstractions","title":"Use Existing Abstractions","description":"Prefer existing framework/library abstractions for both types and layout styling to avoid redundant code and one-off visual tweaks. - Types: If the framework exposes a prop type, reuse it instead of introducing a duplicate interface.","repository":"colinhacks/zod","domain":"app-frameworks","topic":"Code Style","language":"TSX","updated":"2025-06-15","comments":2,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-use-existing-abstractions.md"},{"slug":"comfyui-use-descriptive-names","title":"Use descriptive names","description":"Choose descriptive, self-documenting names for constants, functions, parameters, and types that clearly communicate their purpose and meaning. Avoid magic numbers, generic strings, and ambiguous identifiers that require additional context to understand.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Naming Conventions","language":"Python","updated":"2025-06-14","comments":6,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-use-descriptive-names.md"},{"slug":"comfyui-explicit-error-propagation","title":"Explicit error propagation","description":"Functions should raise exceptions with meaningful messages instead of returning False, None, or silently catching all exceptions. This allows calling code to properly understand what went wrong and take appropriate action.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Error Handling","language":"Python","updated":"2025-06-14","comments":5,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-explicit-error-propagation.md"},{"slug":"tree-sitter-consistent-formatting-preferences","title":"consistent formatting preferences","description":"Maintain consistent formatting and use concise, standard syntax throughout the codebase. This includes several specific formatting rules: 1. **Preprocessor directives**: Do not add spaces after the `#` symbol","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Code Style","language":"Other","updated":"2025-06-14","comments":5,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-consistent-formatting-preferences.md"},{"slug":"browser-use-avoid-external-test-dependencies","title":"avoid external test dependencies","description":"Tests should not rely on external URLs, live websites, or internet connectivity to ensure reliability, consistency, and faster execution. External dependencies can cause tests to fail due to network issues, website changes, or unavailability, making CI/CD pipelines unstable.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2025-06-14","comments":4,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-avoid-external-test-dependencies.md"},{"slug":"bun-clear-accurate-documentation","title":"Clear accurate documentation","description":"Documentation should be both technically accurate and contextually helpful for developers. Comments and JSDoc entries must correctly describe the behavior, purpose, and relationships of code elements.","repository":"oven-sh/bun","domain":"runtimes","topic":"Documentation","language":"TypeScript","updated":"2025-06-14","comments":4,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-clear-accurate-documentation.md"},{"slug":"comfyui-document-complex-code","title":"Document complex code","description":"Add explanatory comments or docstrings for complex, specialized, or non-obvious code that may not be immediately clear to other developers. This includes magic constants, platform-specific operations, advanced APIs, and implementation decisions with specific reasoning.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Documentation","language":"Python","updated":"2025-06-14","comments":4,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-document-complex-code.md"},{"slug":"helix-avoid-quadratic-complexity","title":"avoid quadratic complexity","description":"When working with data structures, especially ropes and collections, avoid algorithms that result in quadratic time complexity when linear alternatives exist. Common patterns to watch for include repeated indexing operations and nested loops over related data sets.","repository":"helix-editor/helix","domain":"devtools","topic":"Algorithms","language":"Rust","updated":"2025-06-14","comments":4,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-avoid-quadratic-complexity.md"},{"slug":"prometheus-document-test-tool-options","title":"document test tool options","description":"When documenting test tools, migration utilities, or testing frameworks, provide comprehensive explanations of different modes or options available, including their trade-offs and appropriate use cases. This helps developers make informed decisions about which approach best fits their testing needs.","repository":"prometheus/prometheus","domain":"observability","topic":"Testing","language":"Markdown","updated":"2025-06-14","comments":3,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-document-test-tool-options.md"},{"slug":"helix-target-documentation-to-audience","title":"Target documentation to audience","description":"Write documentation that matches both your audience's expertise level and the language's conventional formats. For technical documentation, use language-specific conventions (like Rust's doc comments). For tutorials or learning materials, prefer step-by-step explanations that minimize cognitive load.","repository":"helix-editor/helix","domain":"devtools","topic":"Documentation","language":"Other","updated":"2025-06-14","comments":2,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-target-documentation-to-audience.md"},{"slug":"llama.cpp-semantic-configuration-validation","title":"semantic configuration validation","description":"When designing configuration systems, prefer semantic parameters over generic key-value approaches for common features, and implement runtime validation to detect incompatible configuration combinations.","repository":"ggml-org/llama.cpp","domain":"llm-infra","topic":"Configurations","language":"Other","updated":"2025-06-14","comments":2,"stars":83559,"raw":"https://awesomereviewers.com/raw/llama.cpp-semantic-configuration-validation.md"},{"slug":"pydantic-enforce-style-with-linters","title":"Enforce style with linters","description":"Use automated linting tools to enforce consistent code style across the project, but be deliberate about which rules to include or exclude. When adding new linters or rules, evaluate their impact on the codebase before fully adopting them.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Code Style","language":"Toml","updated":"2025-06-14","comments":2,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-enforce-style-with-linters.md"},{"slug":"quarkus-keep-configurations-current","title":"Keep configurations current","description":"Always use the latest stable and supported versions in configuration files. This applies to runtime environments, build plugins, and dependencies. Outdated configurations can limit functionality, miss security updates, or prevent access to newer features.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Configurations","language":"Yaml","updated":"2025-06-14","comments":2,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-keep-configurations-current.md"},{"slug":"framework-precise-type-annotations","title":"Precise type annotations","description":"Always use the most specific and accurate type information possible in PHPDoc comments to improve static analysis, IDE autocompletion, and code clarity. Pay special attention to array types using appropriate syntax:","repository":"laravel/framework","domain":"app-frameworks","topic":"Documentation","language":"PHP","updated":"2025-06-13","comments":8,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-precise-type-annotations.md"},{"slug":"uv-names-should-be-descriptive","title":"Names should be descriptive","description":"Use clear, descriptive names while avoiding redundant qualifiers. Choose full words over abbreviations unless the abbreviated form is widely recognized. When a type or context already implies certain qualities, avoid repeating them in the name.","repository":"astral-sh/uv","domain":"devtools","topic":"Naming Conventions","language":"Rust","updated":"2025-06-13","comments":8,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-names-should-be-descriptive.md"},{"slug":"traefik-use-descriptive-names","title":"Use descriptive names","description":"Choose names that clearly express the purpose, behavior, or semantic meaning of variables, functions, and types. Avoid ambiguous or generic names that require additional context to understand their role.","repository":"traefik/traefik","domain":"cloud-infra","topic":"Naming Conventions","language":"Go","updated":"2025-06-13","comments":7,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-use-descriptive-names.md"},{"slug":"inbox-zero-enforce-atomic-database-operations","title":"Enforce atomic database operations","description":"Replace check-then-act patterns with atomic database operations to prevent race conditions in concurrent environments. Use transactions for multi-step operations and leverage database-level constraints instead of application-level checks.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Concurrency","language":"TypeScript","updated":"2025-06-13","comments":6,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-enforce-atomic-database-operations.md"},{"slug":"zed-prefer-rust-structural-patterns","title":"Prefer Rust structural patterns","description":"Use Rust''s structural patterns to write more idiomatic and maintainable code. This includes: 1. Use early returns to reduce nesting: ```rust // Instead of","repository":"zed-industries/zed","domain":"devtools","topic":"Code Style","language":"Rust","updated":"2025-06-13","comments":6,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-prefer-rust-structural-patterns.md"},{"slug":"argo-cd-follow-go-naming-conventions","title":"Follow Go naming conventions","description":"Adhere to Go naming conventions and maintain consistency with established codebase terminology. This includes proper capitalization of acronyms (e.g., \"OCI\" not \"Oci\"), avoiding underscores in identifiers, following standard library naming patterns, and using consistent terminology throughout the codebase.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Naming Conventions","language":"Go","updated":"2025-06-13","comments":5,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-follow-go-naming-conventions.md"},{"slug":"brew-actions-workflow-best-practices","title":"Actions workflow best practices","description":"Use GitHub Actions native features and follow best practices to create maintainable, secure, and reliable CI workflows: 1. **Use working-directory instead of manual cd commands**","repository":"Homebrew/brew","domain":"devtools","topic":"CI/CD","language":"Yaml","updated":"2025-06-13","comments":5,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-actions-workflow-best-practices.md"},{"slug":"litellm-background-task-coordination","title":"background task coordination","description":"When working with background tasks in async applications, ensure proper task lifecycle management and coordination to prevent memory leaks, race conditions, and resource conflicts.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Concurrency","language":"Python","updated":"2025-06-13","comments":5,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-background-task-coordination.md"},{"slug":"mono-minimize-hot-path-allocations","title":"minimize hot path allocations","description":"Reduce memory allocations and garbage collection pressure in frequently executed code paths. Object creation through functional methods like `Object.fromEntries()`, `map()`, and repeated `toString()` calls can cause significant performance degradation in hot paths.","repository":"rocicorp/mono","domain":"data-systems","topic":"Performance Optimization","language":"TypeScript","updated":"2025-06-13","comments":5,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-minimize-hot-path-allocations.md"},{"slug":"spring-framework-cleanup-error-handling","title":"Cleanup error handling","description":"When handling resources that require cleanup (like streams, connections, or transactions), ensure that errors during the cleanup phase don't overshadow or silently replace the original error. This applies to both try-with-resources and traditional try/finally blocks.","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Error Handling","language":"Java","updated":"2025-06-13","comments":5,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-cleanup-error-handling.md"},{"slug":"continue-maintain-api-compatibility","title":"Maintain API compatibility","description":"When modifying existing APIs, ensure backward compatibility to prevent runtime failures and minimize migration effort for consumers. Breaking changes in function signatures, return types, or parameter requirements can cause cascading issues throughout a codebase.","repository":"continuedev/continue","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2025-06-13","comments":4,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-maintain-api-compatibility.md"},{"slug":"deno-defensive-null-handling","title":"defensive null handling","description":"Use defensive programming patterns to prevent null-related issues before they occur. This includes creating safe object copies to prevent mutations, using explicit null/undefined checks, and initializing objects safely.","repository":"denoland/deno","domain":"runtimes","topic":"Null Handling","language":"JavaScript","updated":"2025-06-13","comments":4,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-defensive-null-handling.md"},{"slug":"azure-sdk-for-net-centralize-pipeline-configurations","title":"Centralize pipeline configurations","description":"Use centralized templates and variables for pipeline configurations instead of duplicating or hardcoding values. This improves maintainability, ensures consistency, and makes platform-specific adaptations easier to manage.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"CI/CD","language":"Yaml","updated":"2025-06-13","comments":3,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-centralize-pipeline-configurations.md"},{"slug":"continue-enforce-strict-config-schemas","title":"Enforce strict config schemas","description":"Configuration schemas should explicitly define all required fields and validate types at compile time to prevent runtime errors. Use strict typing with clear validation rules, and avoid marking required fields as optional.","repository":"continuedev/continue","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-06-13","comments":3,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-enforce-strict-config-schemas.md"},{"slug":"prowler-document-dependency-versioning","title":"Document dependency versioning","description":"Use consistent patterns for specifying dependency versions in configuration\\ \\ files and document reasoning behind version constraints. \\n\\nGuidelines:\\n1. Use\\ \\ exact versions (`==`) for stability-critical dependencies","repository":"prowler-cloud/prowler","domain":"security","topic":"Configurations","language":"Toml","updated":"2025-06-13","comments":3,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-document-dependency-versioning.md"},{"slug":"quarkus-avoid-request-path-blocking","title":"Avoid request-path blocking","description":"Minimize blocking operations in request-handling paths to ensure responsive application performance. Implement caching and asynchronous processing for expensive operations to reduce latency and improve throughput.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Performance Optimization","language":"Other","updated":"2025-06-13","comments":3,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-avoid-request-path-blocking.md"},{"slug":"azure-sdk-for-net-document-non-obvious-code","title":"Document non-obvious code","description":"Add clarifying comments to code elements whose purpose or behavior may not be immediately apparent to other developers. This includes conditional logic blocks, empty configuration properties, and any code structures whose intent requires context to understand.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Documentation","language":"Yaml","updated":"2025-06-13","comments":2,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-document-non-obvious-code.md"},{"slug":"azure-sdk-for-net-match-ci-commands-locally","title":"Match CI commands locally","description":"Always use the same build and test commands locally that are used in your CI pipeline to ensure consistency between environments. This practice significantly increases the likelihood that code passing locally will also pass in CI, reducing integration delays and failed builds.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"CI/CD","language":"Markdown","updated":"2025-06-13","comments":2,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-match-ci-commands-locally.md"},{"slug":"bun-cache-repeated-accesses","title":"Cache repeated accesses","description":"When accessing the same property or calling the same function multiple times, especially in loops or performance-critical sections, cache the result in a local variable. This reduces redundant memory access operations and improves execution speed.","repository":"oven-sh/bun","domain":"runtimes","topic":"Performance Optimization","language":"C++","updated":"2025-06-13","comments":2,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-cache-repeated-accesses.md"},{"slug":"bun-function-invocation-syntax","title":"Function invocation syntax","description":"Use the appropriate invocation syntax for functions based on their intended usage. Regular functions should be called directly without the `new` keyword, while constructor functions (typically capitalized) should be instantiated with `new`.","repository":"oven-sh/bun","domain":"runtimes","topic":"Code Style","language":"JavaScript","updated":"2025-06-13","comments":2,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-function-invocation-syntax.md"},{"slug":"continue-mutually-exclusive-promises","title":"Mutually exclusive promises","description":"Ensure that promises are either resolved or rejected, but never both. When handling promise resolution in callbacks or event handlers, use proper conditional logic to guarantee mutual exclusion between success and error paths.","repository":"continuedev/continue","domain":"ai-agents","topic":"Error Handling","language":"JavaScript","updated":"2025-06-13","comments":2,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-mutually-exclusive-promises.md"},{"slug":"elasticsearch-avoid-flaky-tests","title":"Avoid flaky tests","description":"Design tests to be deterministic and reliable across different environments. Tests that occasionally fail due to timing, race conditions, or environmental differences waste development time and reduce confidence in the test suite.","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Testing","language":"Yaml","updated":"2025-06-13","comments":2,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-avoid-flaky-tests.md"},{"slug":"elasticsearch-use-current-configuration-patterns","title":"Use current configuration patterns","description":"Always use the current recommended configuration patterns for your project, avoiding deprecated approaches. When configuring tests, features, or resource access:","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Configurations","language":"Yaml","updated":"2025-06-13","comments":2,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-use-current-configuration-patterns.md"},{"slug":"mastodon-accessibility-interaction-security","title":"accessibility interaction security","description":"Ensure that accessibility features do not create security vulnerabilities by allowing unintended interactions or providing misleading information to assistive technologies. This includes proper ARIA attribute usage and ensuring hidden or inactive elements are truly inaccessible.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Security","language":"TSX","updated":"2025-06-13","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-accessibility-interaction-security.md"},{"slug":"mastodon-avoid-deprecated-sass-syntax","title":"avoid deprecated SASS syntax","description":"Always use modern SASS and CSS syntax instead of deprecated functions to ensure future compatibility and avoid build warnings. Replace deprecated division operators with calc() or math.div(), and use native CSS functions instead of deprecated SASS color functions.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Code Style","language":"Css","updated":"2025-06-13","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-avoid-deprecated-sass-syntax.md"},{"slug":"material-ui-isolate-dom-security-boundaries","title":"Isolate DOM security boundaries","description":"When developing UI components, establish clear DOM manipulation boundaries to prevent security risks. Components that modify aria attributes (like aria-hidden) on parent or ancestor elements can create security vulnerabilities by unexpectedly exposing content that was intentionally hidden from assistive technologies or hiding content that should be...","repository":"mui/material-ui","domain":"app-frameworks","topic":"Security","language":"TypeScript","updated":"2025-06-13","comments":2,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-isolate-dom-security-boundaries.md"},{"slug":"material-ui-parameter-interaction-design","title":"Parameter interaction design","description":"Design APIs with clear parameter interactions and priority rules to create intuitive interfaces. When multiple parameters could affect the same behavior, establish and document a consistent priority order rather than making parameters conditionally required.","repository":"mui/material-ui","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2025-06-13","comments":2,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-parameter-interaction-design.md"},{"slug":"runtime-platform-aware-algorithm-optimization","title":"Platform-aware algorithm optimization","description":"When implementing performance-critical algorithms, design your code to detect and utilize platform-specific hardware features while maintaining compatibility across different architectures. Create abstraction layers that allow the same algorithm to run on various platforms but take advantage of specialized instruction sets (like AVX extensions) when...","repository":"dotnet/runtime","domain":"runtimes","topic":"Algorithms","language":"Txt","updated":"2025-06-13","comments":2,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-platform-aware-algorithm-optimization.md"},{"slug":"vitess-justify-ci-resource-additions","title":"Justify CI resource additions","description":"Before adding new resources (Dockerfiles, jobs, images) to CI/CD pipelines, provide clear justification for their necessity and document how they will be maintained. Consider whether the resource will actually run in your CI environment, if existing resources could be reused, and who will maintain version updates. For example, instead of creating a new...","repository":"vitessio/vitess","domain":"data-systems","topic":"CI/CD","language":"Other","updated":"2025-06-13","comments":2,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-justify-ci-resource-additions.md"},{"slug":"codex-explicit-security-bypass","title":"Explicit security bypass","description":"When implementing functionality to bypass security controls (like sandboxing), ensure the bypass is complete and explicit rather than just configuring existing security mechanisms to be permissive. Create dedicated code paths for unrestricted operation that truly bypass all security layers.","repository":"openai/codex","domain":"ai-agents","topic":"Security","language":"Rust","updated":"2025-06-13","comments":1,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-explicit-security-bypass.md"},{"slug":"uv-mask-sensitive-tokens","title":"Mask sensitive tokens","description":"Always mask sensitive tokens, credentials, and secrets in CI/CD workflows to prevent accidental exposure in logs or build outputs. In GitHub Actions, use the `::add-mask::` command before outputting or storing sensitive values in environment variables.","repository":"astral-sh/uv","domain":"devtools","topic":"Security","language":"Yaml","updated":"2025-06-13","comments":1,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-mask-sensitive-tokens.md"},{"slug":"react-native-prefer-kotlin-idioms","title":"prefer Kotlin idioms","description":"Use Kotlin-specific constructs and syntax patterns instead of Java-style code to improve readability and maintainability. This includes leveraging Kotlin's expressive syntax features and standard library functions.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Code Style","language":"Kotlin","updated":"2025-06-12","comments":9,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-prefer-kotlin-idioms.md"},{"slug":"pydantic-document-code-rationale","title":"Document code rationale","description":"Add clear comments that explain the \"why\" behind non-obvious code decisions, complex logic, or special-case handling. This is especially important when:","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Documentation","language":"Python","updated":"2025-06-12","comments":7,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-document-code-rationale.md"},{"slug":"duckdb-explicit-null-state-management","title":"explicit null state management","description":"Make null state checks explicit and comprehensive rather than using implicit return values or redundant fields. Use dedicated methods like `ContainsNull()` to clearly indicate null state, avoid duplicate null tracking when child objects already maintain null state, and ensure hierarchical null checks cover all levels (self and children).","repository":"duckdb/duckdb","domain":"data-systems","topic":"Null Handling","language":"Other","updated":"2025-06-12","comments":6,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-explicit-null-state-management.md"},{"slug":"uv-make-errors-user-actionable","title":"Make errors user actionable","description":"Error messages should provide clear, actionable information that helps users understand and resolve the problem. Each error should: 1. Include specific context about what failed","repository":"astral-sh/uv","domain":"devtools","topic":"Error Handling","language":"Rust","updated":"2025-06-12","comments":6,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-make-errors-user-actionable.md"},{"slug":"playwright-synchronous-event-handlers","title":"Synchronous event handlers","description":"Keep event handlers synchronous to prevent race conditions and timing issues. Async operations within event handlers can cause deadlocks, missed events, and unpredictable behavior.","repository":"microsoft/playwright","domain":"devtools","topic":"Concurrency","language":"TypeScript","updated":"2025-06-12","comments":5,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-synchronous-event-handlers.md"},{"slug":"django-optimize-computational-complexity","title":"Optimize computational complexity","description":"Identify and reduce computational complexity in your code by minimizing redundant operations and simplifying algorithms. Focus especially on code that processes large datasets or is called frequently.","repository":"django/django","domain":"app-frameworks","topic":"Algorithms","language":"Python","updated":"2025-06-12","comments":4,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-optimize-computational-complexity.md"},{"slug":"langfuse-configuration-value-consistency","title":"Configuration value consistency","description":"Maintain consistency in configuration values across the application by following these practices: 1. **Use properly formatted template strings for configuration keys**","repository":"langfuse/langfuse","domain":"observability","topic":"Configurations","language":"TSX","updated":"2025-06-12","comments":4,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-configuration-value-consistency.md"},{"slug":"novu-optimize-collection-operations","title":"Optimize collection operations","description":"When processing collections of data, choose efficient algorithms and data structures that minimize computational complexity. Use appropriate array methods (filter, find, map, reduce) and consider batching operations when possible.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Algorithms","language":"TSX","updated":"2025-06-12","comments":4,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-optimize-collection-operations.md"},{"slug":"prowler-ensure-migration-compatibility","title":"Ensure migration compatibility","description":"When modifying database schemas through migrations, ensure compatibility with existing data. For new required fields, use `null=True` or provide appropriate default values to prevent failures on existing records. Always keep migration files synchronized with model changes, and test migrations against a representative dataset before deploying to production.","repository":"prowler-cloud/prowler","domain":"security","topic":"Migrations","language":"Python","updated":"2025-06-12","comments":4,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-ensure-migration-compatibility.md"},{"slug":"terminal-validate-before-configuration-generation","title":"Validate before configuration generation","description":"Always validate system capabilities and existing configuration state before generating new configuration entries or profiles. This prevents unnecessary configuration generation, improves startup performance, and avoids presenting unusable options to users.","repository":"microsoft/terminal","domain":"devtools","topic":"Configurations","language":"C++","updated":"2025-06-12","comments":4,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-validate-before-configuration-generation.md"},{"slug":"chef-standardize-shell-flags","title":"Standardize shell flags","description":"Always use `set -eou pipefail` at the beginning of shell scripts to ensure consistent error handling and behavior across the codebase. This combination provides important safety guarantees:","repository":"chef/chef","domain":"cloud-infra","topic":"Code Style","language":"Shell","updated":"2025-06-12","comments":3,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-standardize-shell-flags.md"},{"slug":"argo-cd-standardize-commit-tracing-metadata","title":"standardize commit tracing metadata","description":"When CI/CD pipelines make automated commits (such as image bumps or manifest updates), use standardized git commit trailers to maintain traceability back to the original code changes. This enables developers and tools to trace deployment artifacts to their source commits.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"CI/CD","language":"Markdown","updated":"2025-06-12","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-standardize-commit-tracing-metadata.md"},{"slug":"chef-standardize-bash-error-handling","title":"Standardize bash error-handling","description":"Always use `set -eou pipefail` at the beginning of bash scripts to ensure consistent and robust error handling. This combination ensures scripts fail immediately on errors (`-e`), treat unset variables as errors (`-u`), and properly handle pipeline failures (`-o pipefail`), preventing silent failures and making debugging easier.","repository":"chef/chef","domain":"cloud-infra","topic":"Error Handling","language":"Shell","updated":"2025-06-12","comments":2,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-standardize-bash-error-handling.md"},{"slug":"prowler-endpoints-for-evolving-data","title":"Endpoints for evolving data","description":"Design dedicated API endpoints for data that changes frequently or grows over time, rather than hardcoding such information in frontend files. This pattern ensures that applications remain maintainable as backend data evolves.","repository":"prowler-cloud/prowler","domain":"security","topic":"API","language":"TypeScript","updated":"2025-06-12","comments":2,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-endpoints-for-evolving-data.md"},{"slug":"pydantic-avoid-unnecessary-operations","title":"Avoid unnecessary operations","description":"Check conditions early to skip unnecessary processing and reuse computed values where possible to optimize performance. This reduces CPU cycles and improves execution speed, especially in performance-critical code paths.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Performance Optimization","language":"Python","updated":"2025-06-12","comments":2,"stars":24364,"raw":"https://awesomereviewers.com/raw/pydantic-avoid-unnecessary-operations.md"},{"slug":"ruff-single-yield-algorithm","title":"Single yield algorithm","description":"Context managers must follow a crucial algorithmic constraint: each execution path must yield exactly once. Multiple yields in the same path lead to unpredictable behavior, while no yields prevent proper resource management.","repository":"astral-sh/ruff","domain":"devtools","topic":"Algorithms","language":"Python","updated":"2025-06-12","comments":2,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-single-yield-algorithm.md"},{"slug":"runtime-document-function-contracts","title":"Document function contracts","description":"Always document function contracts completely, even when surrounding code lacks documentation. Include header comments that describe the function's purpose and behavior, and explicitly specify preconditions using appropriate annotations (like `PRECONDITION`) to clarify execution requirements.","repository":"dotnet/runtime","domain":"runtimes","topic":"Documentation","language":"C++","updated":"2025-06-12","comments":2,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-document-function-contracts.md"},{"slug":"sentry-php-ensure-test-isolation","title":"Ensure test isolation","description":"Tests should be independent and isolated from each other to prevent state leakage and ensure reliable results. When testing components that maintain state (like singletons) or require specific environments (like PHP version-specific features), choose appropriate isolation strategies:","repository":"getsentry/sentry-php","domain":"observability","topic":"Testing","language":"Other","updated":"2025-06-12","comments":2,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-ensure-test-isolation.md"},{"slug":"signoz-justify-caching-strategies","title":"justify caching strategies","description":"When implementing caching solutions, clearly document and justify your caching strategy decisions based on access patterns, performance requirements, and complexity trade-offs. Consider whether the benefits of complex caching approaches outweigh simpler alternatives.","repository":"SigNoz/signoz","domain":"observability","topic":"Caching","language":"Go","updated":"2025-06-12","comments":2,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-justify-caching-strategies.md"},{"slug":"prometheus-write-meaningful-documentation","title":"Write meaningful documentation","description":"Documentation comments should be accurate, concise, and add genuine value rather than restating obvious code behavior. Focus on explaining \"what\" the code does and \"why\" it exists, not \"how\" it works step-by-step.","repository":"prometheus/prometheus","domain":"observability","topic":"Documentation","language":"Go","updated":"2025-06-11","comments":8,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-write-meaningful-documentation.md"},{"slug":"electron-prefer-const-correctness","title":"prefer const correctness","description":"Always mark variables, parameters, and methods as `const` when they don't modify state. This improves code safety, enables compiler optimizations, and makes intent clearer to readers.","repository":"electron/electron","domain":"devtools","topic":"Code Style","language":"Other","updated":"2025-06-11","comments":7,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-prefer-const-correctness.md"},{"slug":"polars-explicit-null-handling","title":"Explicit null handling","description":"Always be explicit and consistent about how null values are handled in operations and documentation. This clarity prevents confusion and ensures predictable behavior across the codebase.","repository":"pola-rs/polars","domain":"data-systems","topic":"Null Handling","language":"Python","updated":"2025-06-11","comments":6,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-explicit-null-handling.md"},{"slug":"helix-reduce-nesting-complexity","title":"reduce nesting complexity","description":"Prefer code structures that minimize nesting levels and improve readability through early returns, pattern matching, and avoiding deeply nested assignments.","repository":"helix-editor/helix","domain":"devtools","topic":"Code Style","language":"Rust","updated":"2025-06-11","comments":5,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-reduce-nesting-complexity.md"},{"slug":"prowler-consistent-naming-patterns","title":"Consistent naming patterns","description":"Follow systematic naming conventions for types, interfaces, and functions to enhance code readability and navigability: ### Type/Interface Naming - `*Data`: Full API models with `id`, `type`, `attributes`, `relationships` (e.g., `RoleData`)","repository":"prowler-cloud/prowler","domain":"security","topic":"Naming Conventions","language":"TypeScript","updated":"2025-06-11","comments":5,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-consistent-naming-patterns.md"},{"slug":"duckdb-preserve-serialization-compatibility","title":"preserve serialization compatibility","description":"When making changes to serialized data structures, always preserve backward and forward compatibility to prevent breaking existing databases and migration paths. This applies to enums, serialized plans, function serialization, and version handling.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Migrations","language":"Other","updated":"2025-06-11","comments":4,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-preserve-serialization-compatibility.md"},{"slug":"vitess-use-parameterized-queries","title":"Use parameterized queries","description":"Always use parameterized queries with bind variables instead of string concatenation or formatting when constructing SQL statements. This prevents SQL injection attacks and improves query performance through better statement caching.","repository":"vitessio/vitess","domain":"data-systems","topic":"Database","language":"Go","updated":"2025-06-11","comments":4,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-use-parameterized-queries.md"},{"slug":"duckdb-generate-test-data-dynamically","title":"generate test data dynamically","description":"Instead of adding static test data files to the repository, generate test data programmatically within test cases. This approach improves test modularity, reduces repository bloat, and ensures tests are self-contained. Use temporary directories for any files that need to be written during testing.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Testing","language":"Csv","updated":"2025-06-11","comments":3,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-generate-test-data-dynamically.md"},{"slug":"maplibre-native-cross-platform-ci-validation","title":"Cross-platform CI validation","description":"Always verify that code changes work across all CI platforms before submitting. When addressing a CI issue for one platform, ensure your fix doesn''t break other environments. Common cross-platform CI issues include:","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"CI/CD","language":"Other","updated":"2025-06-11","comments":3,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-cross-platform-ci-validation.md"},{"slug":"neon-extract-and-reuse","title":"Extract and reuse","description":"Create focused utility functions for repeated or complex operations instead of duplicating logic across the codebase. When implementing functionality, first check if similar code already exists that can be reused.","repository":"neondatabase/neon","domain":"data-systems","topic":"Code Style","language":"C","updated":"2025-06-11","comments":3,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-extract-and-reuse.md"},{"slug":"terminal-clear-accurate-error-messages","title":"Clear accurate error messages","description":"Error messages should be clear, accurate, and contextually appropriate to help users understand what went wrong and how to fix it. Use complete, descriptive terms instead of abbreviations or technical jargon that may confuse users. Ensure error messages accurately reflect the actual capabilities and constraints of the system rather than copying generic...","repository":"microsoft/terminal","domain":"devtools","topic":"Error Handling","language":"Other","updated":"2025-06-11","comments":3,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-clear-accurate-error-messages.md"},{"slug":"uv-enforce-strong-optional-types","title":"Enforce strong optional types","description":"Use strong typing and early validation to handle optional values and prevent null-related issues. Prefer enums and specific types over strings when dealing with optional data, and validate optional values as early as possible in the data flow.","repository":"astral-sh/uv","domain":"devtools","topic":"Null Handling","language":"Rust","updated":"2025-06-11","comments":3,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-enforce-strong-optional-types.md"},{"slug":"uv-follow-established-naming-conventions","title":"Follow established naming conventions","description":"Adhere to established naming conventions for files, variables, functions, and configuration options to maintain consistency and clarity throughout the codebase and documentation.","repository":"astral-sh/uv","domain":"devtools","topic":"Naming Conventions","language":"Markdown","updated":"2025-06-11","comments":3,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-follow-established-naming-conventions.md"},{"slug":"zed-self-explanatory-identifier-names","title":"Self-explanatory identifier names","description":"Choose identifier names that clearly convey their purpose without requiring users to understand implementation details. If reviewers struggle to understand what a name means, it likely needs improvement.","repository":"zed-industries/zed","domain":"devtools","topic":"Naming Conventions","language":"Json","updated":"2025-06-11","comments":3,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-self-explanatory-identifier-names.md"},{"slug":"azure-sdk-for-net-handle-external-process-errors","title":"Handle external process errors","description":"When calling external processes (like dotnet, msbuild, etc.), always implement proper error handling and output management: 1. Check exit codes to detect failures and propagate errors","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Error Handling","language":"Other","updated":"2025-06-11","comments":2,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-handle-external-process-errors.md"},{"slug":"desktop-event-delegation-patterns","title":"event delegation patterns","description":"When handling events in web applications, especially those involving network-triggered UI updates or real-time data streams, prefer event delegation over individual element listeners for better performance and maintainability. Use container-level event listeners and check the event target rather than attaching listeners to each individual element.","repository":"zen-browser/desktop","domain":"devtools","topic":"Networking","language":"Other","updated":"2025-06-11","comments":2,"stars":34711,"raw":"https://awesomereviewers.com/raw/desktop-event-delegation-patterns.md"},{"slug":"grafana-defense-in-depth","title":"Defense in depth","description":"Always implement multiple layers of security controls, even when they might seem redundant. This strategy ensures protection remains effective even if one security measure fails or is bypassed.","repository":"grafana/grafana","domain":"observability","topic":"Security","language":"TypeScript","updated":"2025-06-11","comments":2,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-defense-in-depth.md"},{"slug":"novu-pin-dependency-versions","title":"Pin dependency versions","description":"Always pin dependency versions by removing caret (^) and tilde (~) prefixes in package.json files to prevent build failures and ensure consistency across different environments and packages in a monorepo.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2025-06-11","comments":2,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-pin-dependency-versions.md"},{"slug":"react-native-platform-api-consistency","title":"platform API consistency","description":"When implementing cross-platform functionality, prioritize consistency and avoid replicating platform-specific bugs or inconsistencies. Consider the broader architectural impact of API choices, especially when they require significant migrations or affect multiple components.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Networking","language":"Java","updated":"2025-06-11","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-platform-api-consistency.md"},{"slug":"supabase-consistent-case-style","title":"Consistent case style","description":"Use consistent case styles in your codebase, adapting to the conventions of the ecosystem you're interacting with. When working with systems that use snake_case (like many Python-based backends, databases, or MCP servers), maintain that convention in your interfaces to those systems.","repository":"supabase/supabase","domain":"data-systems","topic":"Naming Conventions","language":"TypeScript","updated":"2025-06-11","comments":2,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-consistent-case-style.md"},{"slug":"union-validate-input-uniqueness","title":"validate input uniqueness","description":"Always validate that input data is unique and matches expected values to prevent replay attacks and data manipulation vulnerabilities. This includes checking for duplicate submissions and verifying data integrity through hash comparisons.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Security","language":"Rust","updated":"2025-06-11","comments":2,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-validate-input-uniqueness.md"},{"slug":"neon-escape-sql-parameters","title":"Escape SQL parameters","description":"Always escape parameters in database connection strings to prevent SQL injection attacks. Direct string concatenation with user-provided or database-sourced values creates security vulnerabilities that can be exploited.","repository":"neondatabase/neon","domain":"data-systems","topic":"Security","language":"Sql","updated":"2025-06-11","comments":1,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-escape-sql-parameters.md"},{"slug":"quarkus-verify-token-security-level","title":"Verify token security level","description":"When refreshing or updating authentication tokens, always verify the new token maintains or exceeds the original token's security level. This applies to WebSocket connections, step-up authentication scenarios, or any case where tokens are refreshed during an active session.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Security","language":"Other","updated":"2025-06-10","comments":9,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-verify-token-security-level.md"},{"slug":"neon-design-domain-specific-error-types","title":"Design domain-specific error types","description":"Create and use domain-specific error types instead of generic errors or anyhow. This improves error handling clarity and ensures proper error propagation through the codebase.","repository":"neondatabase/neon","domain":"data-systems","topic":"Error Handling","language":"Rust","updated":"2025-06-10","comments":8,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-design-domain-specific-error-types.md"},{"slug":"opentofu-log-effectively-for-debugging","title":"Log effectively for debugging","description":"Always include meaningful log messages at appropriate levels to aid in debugging and system monitoring. Follow these guidelines: 1. **Never silently swallow errors** - Even during cleanup operations, log errors that might be helpful for debugging:","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Logging","language":"Go","updated":"2025-06-10","comments":8,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-log-effectively-for-debugging.md"},{"slug":"mastodon-batch-similar-operations","title":"batch similar operations","description":"When performing multiple similar operations (database queries, Redis calls, job enqueues, or data lookups), batch them together or eliminate redundancy to reduce overhead and improve performance.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Performance Optimization","language":"Ruby","updated":"2025-06-10","comments":5,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-batch-similar-operations.md"},{"slug":"mastodon-use-contextually-descriptive-names","title":"Use contextually descriptive names","description":"Names should clearly indicate their purpose and context to avoid confusion, especially when similar concepts exist in the same scope. Generic names like \"api\", \"params\", or \"arg1\" create ambiguity and make code harder to understand. Instead, use specific, meaningful identifiers that describe what they represent or do.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Naming Conventions","language":"TSX","updated":"2025-06-10","comments":5,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-use-contextually-descriptive-names.md"},{"slug":"material-ui-configure-css-layers","title":"Configure CSS layers","description":"When integrating Material UI with other styling solutions like Tailwind CSS v4, proper configuration of CSS layers is essential to ensure correct style precedence and override behavior.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Configurations","language":"Markdown","updated":"2025-06-10","comments":5,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-configure-css-layers.md"},{"slug":"neon-comprehensive-code-documentation","title":"Comprehensive code documentation","description":"Properly document code with clear, accurate, and useful comments using the correct syntax based on context: 1. Use `///` to document items (structs, functions, etc.) that follow the comment:","repository":"neondatabase/neon","domain":"data-systems","topic":"Documentation","language":"Rust","updated":"2025-06-10","comments":5,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-comprehensive-code-documentation.md"},{"slug":"tokio-optimize-hot-paths","title":"Optimize hot paths","description":"Identify and optimize frequently executed code paths to improve performance. Hot paths have a significant impact on overall application performance. Key strategies include:","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Performance Optimization","language":"Rust","updated":"2025-06-10","comments":5,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-optimize-hot-paths.md"},{"slug":"mastodon-prefer-early-returns","title":"prefer early returns","description":"Use early returns and guard clauses to reduce nested conditionals and improve code readability. This pattern makes the main logic flow clearer by handling edge cases upfront and avoiding deeply nested if-else structures.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Code Style","language":"TSX","updated":"2025-06-10","comments":4,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-prefer-early-returns.md"},{"slug":"material-ui-write-user-centric-documentation-guides","title":"Write user-centric documentation guides","description":"Documentation should be written with the user''s perspective in mind, using clear, action-oriented language and intuitive organization. Follow these principles:","repository":"mui/material-ui","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-06-10","comments":4,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-write-user-centric-documentation-guides.md"},{"slug":"prometheus-prevent-concurrent-data-races","title":"prevent concurrent data races","description":"Always analyze shared data access patterns to prevent race conditions in concurrent code. Use appropriate synchronization mechanisms based on access patterns and data ownership.","repository":"prometheus/prometheus","domain":"observability","topic":"Concurrency","language":"Go","updated":"2025-06-10","comments":4,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-prevent-concurrent-data-races.md"},{"slug":"react-native-minimize-public-api-surface","title":"minimize public API surface","description":"Carefully evaluate whether functionality needs to be exposed as public API. Keep implementations private when they're only used internally, and avoid creating public APIs that increase maintenance burden without clear benefit.","repository":"facebook/react-native","domain":"app-frameworks","topic":"API","language":"Other","updated":"2025-06-10","comments":4,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-minimize-public-api-surface.md"},{"slug":"anthropic-sdk-python-config-precedence-and-env-overrides","title":"Config precedence and env overrides","description":"When reading configuration from multiple sources (function arguments, environment variables, config files, defaults), implement and preserve a single, explicit precedence order, and ensure user-provided overrides beat environment-derived values.","repository":"anthropics/anthropic-sdk-python","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2025-06-10","comments":3,"stars":3392,"raw":"https://awesomereviewers.com/raw/anthropic-sdk-python-config-precedence-and-env-overrides.md"},{"slug":"inbox-zero-database-type-best-practices","title":"Database type best practices","description":"Select appropriate data types and defaults for database columns to ensure data integrity and simplify application code. For timestamp columns, use timezone-aware types (TIMESTAMPTZ) when working across different timezones or with UTC offsets. For ID columns, configure auto-generation at the database level using functions like gen_random_uuid() rather than...","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Database","language":"Sql","updated":"2025-06-10","comments":3,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-database-type-best-practices.md"},{"slug":"opencv-validate-tensor-dimensions","title":"Validate tensor dimensions","description":"When implementing AI model inference code, always validate tensor dimensions and shapes before manipulating them. Neural network outputs often have complex multi-dimensional structures that require careful handling. Adding explicit dimension checks prevents subtle runtime errors, improves code robustness, and makes debugging easier.","repository":"opencv/opencv","domain":"ml-systems","topic":"AI","language":"C++","updated":"2025-06-10","comments":3,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-validate-tensor-dimensions.md"},{"slug":"quarkus-document-dependency-versions","title":"Document dependency versions","description":"When managing dependency versions in configuration files, provide clear documentation to help maintainers understand version choices and relationships. Include links to repositories where versions can be verified, keep related versions aligned when appropriate, and add explanatory comments for version-related decisions.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Configurations","language":"Xml","updated":"2025-06-10","comments":3,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-document-dependency-versions.md"},{"slug":"temporal-use-dedicated-configuration-files","title":"Use dedicated configuration files","description":"Always use dedicated configuration files for specific configuration needs rather than modifying core build or system files. This practice improves maintainability, traceability, and scope control.","repository":"temporalio/temporal","domain":"orchestration","topic":"Configurations","language":"Other","updated":"2025-06-10","comments":3,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-use-dedicated-configuration-files.md"},{"slug":"airflow-share-documentation-configs","title":"Share documentation configs","description":"Documentation tooling and configuration files should leverage shared/centralized resources rather than maintaining duplicate copies across repositories. This reduces maintenance burden, ensures consistency, and simplifies updates.","repository":"apache/airflow","domain":"orchestration","topic":"Documentation","language":"Txt","updated":"2025-06-10","comments":2,"stars":40858,"raw":"https://awesomereviewers.com/raw/airflow-share-documentation-configs.md"},{"slug":"ant-design-test-network-performance","title":"Test network performance","description":"Always validate network performance and connectivity before suggesting alternative endpoints or making routing decisions. Implement timeout-based checks to ensure alternatives are actually faster or more accessible for the user's specific network conditions.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Networking","language":"JavaScript","updated":"2025-06-10","comments":2,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-test-network-performance.md"},{"slug":"duckdb-secure-sensitive-data-handling","title":"secure sensitive data handling","description":"When handling sensitive data like encryption keys, passwords, or authentication tokens, avoid using standard string types that can be easily copied and may persist in memory. Instead, use specialized secure data structures that prevent accidental copying and provide controlled memory management.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Security","language":"C++","updated":"2025-06-10","comments":2,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-secure-sensitive-data-handling.md"},{"slug":"opencv-maintain-build-compatibility","title":"Maintain build compatibility","description":"When modifying build scripts or configurations, ensure compatibility across all supported environments and properly test changes through CI pipelines. For tools with version-dependent features, add version checks and provide alternative implementations for older versions.","repository":"opencv/opencv","domain":"ml-systems","topic":"CI/CD","language":"Txt","updated":"2025-06-10","comments":2,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-maintain-build-compatibility.md"},{"slug":"prowler-flexible-ai-model-versions","title":"Flexible AI model versions","description":"When integrating LLM or AI models into your application, implement model selection in a way that accommodates the rapid evolution of AI capabilities without requiring frequent code deployments.","repository":"prowler-cloud/prowler","domain":"security","topic":"AI","language":"Python","updated":"2025-06-10","comments":2,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-flexible-ai-model-versions.md"},{"slug":"unstructured-eliminate-unnecessary-code","title":"eliminate unnecessary code","description":"Remove redundant operations, unnecessary code blocks, and verbose constructs to improve code clarity and maintainability. Focus on eliminating dead code, avoiding redundant loops, removing unnecessary conditional checks, and using more concise expressions where appropriate.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Code Style","language":"Python","updated":"2025-06-09","comments":14,"stars":12116,"raw":"https://awesomereviewers.com/raw/unstructured-eliminate-unnecessary-code.md"},{"slug":"v-add-comprehensive-test-coverage","title":"Add comprehensive test coverage","description":"When adding functionality or fixing bugs, always add new test functions rather than modifying existing ones to preserve test coverage. Ensure comprehensive testing by including edge cases, error conditions, and assertions for all public functions. Use meaningful, non-default values in tests to improve sensitivity to regressions.","repository":"vlang/v","domain":"runtimes","topic":"Testing","language":"Other","updated":"2025-06-09","comments":13,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-add-comprehensive-test-coverage.md"},{"slug":"crewai-prefer-pythonic-simplicity","title":"Prefer pythonic simplicity","description":"Use Python''s expressive features to write cleaner, more maintainable code by reducing nesting and improving readability. Follow these practices: 1. **Avoid unnecessary else blocks** after raising exceptions or returns:","repository":"crewaiinc/crewai","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2025-06-09","comments":8,"stars":33945,"raw":"https://awesomereviewers.com/raw/crewai-prefer-pythonic-simplicity.md"},{"slug":"mono-use-descriptive-names","title":"Use descriptive names","description":"Choose names that clearly communicate intent and purpose, avoiding vague or misleading terms. Names should be self-documenting and accurately reflect what the variable, function, or type represents.","repository":"rocicorp/mono","domain":"data-systems","topic":"Naming Conventions","language":"TypeScript","updated":"2025-06-09","comments":6,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-use-descriptive-names.md"},{"slug":"vscode-keep-apis-simple-javascript-like","title":"Keep APIs simple JavaScript-like","description":"Design APIs to be simple and idiomatic to JavaScript/TypeScript while maintaining proper encapsulation. Avoid complex type unions, forced undefined parameters, or implementation details leaking through interfaces.","repository":"microsoft/vscode","domain":"devtools","topic":"API","language":"TypeScript","updated":"2025-06-09","comments":6,"stars":174887,"raw":"https://awesomereviewers.com/raw/vscode-keep-apis-simple-javascript-like.md"},{"slug":"browser-use-environment-variable-configuration","title":"Environment variable configuration","description":"Prefer environment variables over hardcoded configuration values to improve flexibility and avoid forcing configuration choices on users. Always provide sensible defaults and implement proper validation.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2025-06-09","comments":5,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-environment-variable-configuration.md"},{"slug":"crewai-model-agnostic-ai-code","title":"Model-agnostic AI code","description":"When building applications that interact with AI models, avoid hardcoding model-specific behavior and instead design for flexibility across different LLM providers and versions. This approach increases resilience and makes your code more maintainable as the AI ecosystem evolves.","repository":"crewaiinc/crewai","domain":"ai-agents","topic":"AI","language":"Python","updated":"2025-06-09","comments":5,"stars":33945,"raw":"https://awesomereviewers.com/raw/crewai-model-agnostic-ai-code.md"},{"slug":"firecrawl-use-structured-error-logging","title":"Use structured error logging","description":"Always use the proper logger instance instead of console methods, and format error logs with structured data objects rather than string concatenation. Console logging methods like `console.error` can lead to log flooding in production and lack proper log level controls. Structured logging with error objects enables better log parsing, monitoring, and...","repository":"firecrawl/firecrawl","domain":"ai-agents","topic":"Logging","language":"TypeScript","updated":"2025-06-09","comments":5,"stars":54535,"raw":"https://awesomereviewers.com/raw/firecrawl-use-structured-error-logging.md"},{"slug":"rails-place-configurations-appropriately","title":"Place configurations appropriately","description":"Choose the right location and scope for your Rails configuration options to improve maintainability and clarity: 1. **Use appropriate namespaces** - For truly global configurations, place them on the module rather than on a specific class:","repository":"rails/rails","domain":"app-frameworks","topic":"Configurations","language":"Markdown","updated":"2025-06-09","comments":5,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-place-configurations-appropriately.md"},{"slug":"typescript-extract-complex-logical-expressions","title":"Extract complex logical expressions","description":"Complex logical expressions should be extracted into well-named variables or functions to improve code readability and maintainability. This applies to:","repository":"microsoft/typescript","domain":"runtimes","topic":"Code Style","language":"TypeScript","updated":"2025-06-09","comments":5,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-extract-complex-logical-expressions.md"},{"slug":"roo-code-names-reflect-semantic-purpose","title":"Names reflect semantic purpose","description":"Identifiers (variables, properties, keys, IDs) should accurately reflect their semantic purpose and context. Names should be chosen to clearly communicate the meaning and role of the element within its specific context, not just its technical type or generic purpose.","repository":"RooCodeInc/Roo-Code","domain":"ai-agents","topic":"Naming Conventions","language":"TSX","updated":"2025-06-09","comments":4,"stars":17288,"raw":"https://awesomereviewers.com/raw/roo-code-names-reflect-semantic-purpose.md"},{"slug":"azure-sdk-for-net-prefer-identity-based-authentication","title":"Prefer identity-based authentication","description":"Always prioritize modern identity-based authentication methods over traditional username/password credentials. This improves security by reducing credential exposure and management overhead.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Security","language":"Markdown","updated":"2025-06-09","comments":3,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-prefer-identity-based-authentication.md"},{"slug":"crewai-explicit-over-implicit","title":"Explicit over implicit","description":"Always explicitly configure important system components rather than relying on implicit defaults or environment variables. Document required configuration combinations and version requirements clearly to prevent subtle errors.","repository":"crewaiinc/crewai","domain":"ai-agents","topic":"Configurations","language":"Other","updated":"2025-06-09","comments":3,"stars":33945,"raw":"https://awesomereviewers.com/raw/crewai-explicit-over-implicit.md"},{"slug":"union-use-effect-option-consistently","title":"use Effect Option consistently","description":"Replace null, undefined, and error throwing with Effect's Option type for handling potentially missing values. This provides better type safety, composability, and prevents null reference errors.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Null Handling","language":"TypeScript","updated":"2025-06-09","comments":3,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-use-effect-option-consistently.md"},{"slug":"uv-short-circuit-evaluation-strategies","title":"Short-circuit evaluation strategies","description":"When implementing search or traversal algorithms, use short-circuit evaluation strategically to avoid unnecessary computation while ensuring correctness. Short-circuiting is beneficial when the first match is sufficient, but can lead to incorrect results when complete information is needed.","repository":"astral-sh/uv","domain":"devtools","topic":"Algorithms","language":"Rust","updated":"2025-06-09","comments":3,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-short-circuit-evaluation-strategies.md"},{"slug":"browser-use-avoid-hardcoded-api-assumptions","title":"Avoid hardcoded API assumptions","description":"API interfaces should not contain hardcoded implementation details or assume specific underlying technologies. Instead, make them configurable and implementation-agnostic to support different backends and configurations.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"API","language":"Python","updated":"2025-06-09","comments":2,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-avoid-hardcoded-api-assumptions.md"},{"slug":"prowler-consistent-environment-variable-naming","title":"Consistent environment variable naming","description":"When naming environment variables, ensure that names are both technically accurate and follow established project conventions: 1. Use terminology that precisely reflects the actual content and purpose of the variable, especially for security-related configurations.","repository":"prowler-cloud/prowler","domain":"security","topic":"Naming Conventions","language":"Other","updated":"2025-06-09","comments":2,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-consistent-environment-variable-naming.md"},{"slug":"react-native-use-proper-documentation-format","title":"Use proper documentation format","description":"Use the appropriate documentation format for the target programming language. In Kotlin files, use KDoc formatting instead of Javadoc formatting for consistency and proper tooling support.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Documentation","language":"Kotlin","updated":"2025-06-09","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-use-proper-documentation-format.md"},{"slug":"zed-precise-test-pattern-matching","title":"Precise test pattern matching","description":"When identifying test patterns in code, use specific equality predicates (`#eq?`) instead of list inclusion predicates (`#any-of?`) when matching against a single value. This improves clarity and can avoid potential false positives in test detection.","repository":"zed-industries/zed","domain":"devtools","topic":"Testing","language":"Other","updated":"2025-06-09","comments":2,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-precise-test-pattern-matching.md"},{"slug":"prometheus-explicit-authentication-logic","title":"explicit authentication logic","description":"Make authentication and security-related boolean conditions explicit and direct rather than using intermediate variables that obscure the logic. This improves code readability, reduces the risk of misconfiguration, and makes security decisions more auditable.","repository":"prometheus/prometheus","domain":"observability","topic":"Security","language":"Go","updated":"2025-06-09","comments":1,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-explicit-authentication-logic.md"},{"slug":"prowler-test-authentication-dependencies","title":"Test authentication dependencies","description":"When updating authentication-related dependencies or adding new authentication capabilities (like SAML, OAuth, etc.), thoroughly test all authentication flows to prevent security vulnerabilities. Authentication components often have complex interdependencies that can lead to unexpected failures when versions change.","repository":"prowler-cloud/prowler","domain":"security","topic":"Security","language":"Toml","updated":"2025-06-09","comments":1,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-test-authentication-dependencies.md"},{"slug":"ruff-use-explicit-permission-notations","title":"Use explicit permission notations","description":"When setting file permissions through system calls like `chmod`, always use explicit octal notation (with the `0o` prefix) rather than decimal integers. Decimal integers in permission contexts can lead to unintended access rights, creating security vulnerabilities through incorrect file permissions.","repository":"astral-sh/ruff","domain":"devtools","topic":"Security","language":"Rust","updated":"2025-06-09","comments":1,"stars":40619,"raw":"https://awesomereviewers.com/raw/ruff-use-explicit-permission-notations.md"},{"slug":"checkov-extract-focused-functions","title":"Extract focused functions","description":"Break down complex logic into small, well-named functions that each do one thing well. This improves code readability, maintainability, and testability by making the code's intent clearer and reducing cognitive load.","repository":"bridgecrewio/checkov","domain":"security","topic":"Code Style","language":"Python","updated":"2025-06-08","comments":10,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-extract-focused-functions.md"},{"slug":"v-choose-efficient-data-structures","title":"Choose efficient data structures","description":"Select data structures and algorithms based on performance characteristics and actual usage patterns rather than convenience or familiarity. Consider memory efficiency, computational complexity, and scaling behavior when making implementation choices.","repository":"vlang/v","domain":"runtimes","topic":"Algorithms","language":"Other","updated":"2025-06-08","comments":7,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-choose-efficient-data-structures.md"},{"slug":"chatgptbox-context-aware-null-checking","title":"Context-aware null checking","description":"Choose null checking patterns based on your function's purpose and intended behavior with empty values. For functions with fallback strategies, consider whether empty strings should trigger alternative methods or be treated as valid results.","repository":"ChatGPTBox-dev/chatGPTBox","domain":"ai-agents","topic":"Null Handling","language":"Other","updated":"2025-06-08","comments":2,"stars":10660,"raw":"https://awesomereviewers.com/raw/chatgptbox-context-aware-null-checking.md"},{"slug":"sentry-php-evolve-api-safely","title":"Evolve API safely","description":"When modifying existing APIs, implement changes that maintain backward compatibility while enabling new functionality. For public-facing APIs, avoid breaking changes outside of major version bumps.","repository":"getsentry/sentry-php","domain":"observability","topic":"API","language":"PHP","updated":"2025-06-07","comments":7,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-evolve-api-safely.md"},{"slug":"comfyui-use-logging-over-print","title":"use logging over print","description":"Replace all `print()` statements with appropriate logging calls using Python's built-in logging module. This applies to debug output, informational messages, and error reporting. Print statements should be reserved only for direct user interaction or when logging infrastructure is not available.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Logging","language":"Python","updated":"2025-06-07","comments":4,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-use-logging-over-print.md"},{"slug":"langfuse-database-migration-best-practices","title":"Database migration best practices","description":"When implementing database schema changes, follow these migration best practices to maintain data integrity and ensure backward compatibility: 1. **Create separate migration files** for new schema changes rather than modifying existing migrations. This ensures users who already ran previous migrations will get new fields added correctly.","repository":"langfuse/langfuse","domain":"observability","topic":"Migrations","language":"Sql","updated":"2025-06-07","comments":3,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-database-migration-best-practices.md"},{"slug":"zod-precise-validation-documentation","title":"Precise Validation Documentation","description":"When documenting inputs/validators, explicitly state (a) the units/meaning of any parameters (e.g., file size units), (b) what is truly validated (syntactic/format via regex vs semantic correctness), and (c) timezone/offset semantics using unambiguous wording (avoid phrasing that suggests an offset is “missing” when “Z” explicitly means zero offset). This...","repository":"colinhacks/zod","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-06-07","comments":3,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-precise-validation-documentation.md"},{"slug":"chatgptbox-optimize-ai-interactions","title":"Optimize AI interactions","description":"When working with AI models and LLMs, optimize both prompts and input data to improve model performance and reduce token usage. For prompts, be specific about the AI's role, requirements, and expected output format rather than using vague instructions. For input data, preprocess and clean content to remove unnecessary elements that could confuse the model...","repository":"ChatGPTBox-dev/chatGPTBox","domain":"ai-agents","topic":"AI","language":"Other","updated":"2025-06-07","comments":2,"stars":10660,"raw":"https://awesomereviewers.com/raw/chatgptbox-optimize-ai-interactions.md"},{"slug":"litellm-prefer-openai-compatibility","title":"prefer OpenAI compatibility","description":"When integrating new LLM providers or AI services, prioritize OpenAI-compatible patterns and reuse existing utilities rather than creating separate implementations. This approach reduces code duplication, leverages battle-tested functionality, and maintains consistency across the codebase.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"AI","language":"Python","updated":"2025-06-06","comments":12,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-prefer-openai-compatibility.md"},{"slug":"crewai-semantic-naming-patterns","title":"Semantic naming patterns","description":"Names should clearly communicate purpose, relationships, and domain context. Choose identifiers that reveal intent and accurately describe what they represent:","repository":"crewaiinc/crewai","domain":"ai-agents","topic":"Naming Conventions","language":"Python","updated":"2025-06-06","comments":8,"stars":33945,"raw":"https://awesomereviewers.com/raw/crewai-semantic-naming-patterns.md"},{"slug":"helix-consistent-descriptive-naming-conventions","title":"Consistent descriptive naming conventions","description":"Use consistent and descriptive naming conventions across the codebase: 1. Use kebab-case for configuration options and snake_case for internal modifiers","repository":"helix-editor/helix","domain":"devtools","topic":"Naming Conventions","language":"Markdown","updated":"2025-06-06","comments":6,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-consistent-descriptive-naming-conventions.md"},{"slug":"react-native-avoid-hungarian-notation","title":"avoid Hungarian notation","description":"Do not use Hungarian notation prefixes (like `m`, `s`) in variable and field names. Use descriptive, semantic names that clearly indicate the variable's purpose without encoding type or scope information in the name.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Naming Conventions","language":"Kotlin","updated":"2025-06-06","comments":5,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-avoid-hungarian-notation.md"},{"slug":"bun-deterministic-lock-management","title":"Deterministic lock management","description":"Always ensure locks are acquired and released in a deterministic manner in concurrent code. Use `defer` statements immediately after lock acquisition to guarantee release along all code paths, and acquire locks before accessing the protected resources to prevent race conditions.","repository":"oven-sh/bun","domain":"runtimes","topic":"Concurrency","language":"Other","updated":"2025-06-06","comments":3,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-deterministic-lock-management.md"},{"slug":"django-async-resource-cleanup-guarantees","title":"Async resource cleanup guarantees","description":"When implementing async context managers, always ensure proper resource cleanup even during task cancellation. Use try/finally blocks to guarantee that resources are released and context state is properly restored regardless of how execution terminates.","repository":"django/django","domain":"app-frameworks","topic":"Concurrency","language":"Python","updated":"2025-06-06","comments":3,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-async-resource-cleanup-guarantees.md"},{"slug":"rails-document-performance-implications","title":"Document performance implications","description":"Clearly document the performance implications of features and configurations to help users make informed decisions. Avoid overstating or understating performance impacts. Instead, provide specific context about when certain features might impact performance and in what environments they are appropriate.","repository":"rails/rails","domain":"app-frameworks","topic":"Performance Optimization","language":"Markdown","updated":"2025-06-06","comments":3,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-document-performance-implications.md"},{"slug":"brew-pin-github-actions","title":"Pin GitHub actions","description":"Always pin GitHub Actions to specific commit hashes rather than version tags (like @v4). Using version tags is a security vulnerability as the tag owner could change what commit the tag points to, potentially introducing malicious code into your workflow. This is a common supply chain security best practice.","repository":"Homebrew/brew","domain":"devtools","topic":"Security","language":"Yaml","updated":"2025-06-06","comments":2,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-pin-github-actions.md"},{"slug":"bun-optimize-database-interactions","title":"Optimize database interactions","description":"When working with database operations, prioritize efficiency by avoiding redundant query executions. Instead of executing statements multiple times to gather different pieces of information (like metadata or column types), cache or collect all necessary data during the initial execution.","repository":"oven-sh/bun","domain":"runtimes","topic":"Database","language":"C++","updated":"2025-06-06","comments":2,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-optimize-database-interactions.md"},{"slug":"inbox-zero-eliminate-documentation-redundancy","title":"Eliminate documentation redundancy","description":"Documentation should be concise and avoid repeating the same information in multiple places. Redundant content confuses readers, makes maintenance more difficult, and can lead to inconsistencies when only one copy gets updated.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-06-06","comments":2,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-eliminate-documentation-redundancy.md"},{"slug":"mastodon-consistent-dependency-versioning","title":"consistent dependency versioning","description":"Maintain consistent version constraint patterns across all dependencies in configuration files and avoid unstable versions that can cause build issues. Use caret (^) constraints uniformly for predictable updates within compatible ranges, and employ resolutions when necessary to prevent automatic resolution to beta or unstable versions.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2025-06-06","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-consistent-dependency-versioning.md"},{"slug":"playwright-document-configuration-formats-explicitly","title":"Document configuration formats explicitly","description":"When documenting environment variables and configuration options, explicitly list all supported value formats rather than using vague descriptions. Use individual backticks around each supported value for clear formatting.","repository":"microsoft/playwright","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2025-06-06","comments":2,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-document-configuration-formats-explicitly.md"},{"slug":"refact-optimize-timing-intervals","title":"optimize timing intervals","description":"Choose appropriate timing intervals for asynchronous operations to improve performance and responsiveness. For frequent polling of cheap operations, use shorter intervals (200ms instead of 1s) to reduce latency. For potentially blocking file system operations, use atomic patterns like rename-then-delete to avoid blocking the async runtime.","repository":"smallcloudai/refact","domain":"ai-agents","topic":"Performance Optimization","language":"Rust","updated":"2025-06-06","comments":2,"stars":3114,"raw":"https://awesomereviewers.com/raw/refact-optimize-timing-intervals.md"},{"slug":"vite-react-transformation-tool-clarity","title":"React transformation tool clarity","description":"When working with React in Vite projects, be precise about which transformation tools (Babel, SWC, Oxc, esbuild) handle specific aspects of React code processing. Different plugins use different tool combinations for JSX/TSX transformation versus React fast-refresh, and these can vary between development and build environments.","repository":"vitejs/vite","domain":"devtools","topic":"React","language":"Markdown","updated":"2025-06-06","comments":2,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-react-transformation-tool-clarity.md"},{"slug":"zed-explicit-over-implicit","title":"Explicit over implicit","description":"When designing APIs, prioritize explicit parameter identification over implicit context. APIs with clear, unambiguous parameters improve implementation, maintenance, and usage. Whenever a function could operate on multiple resources or have ambiguous behavior, include explicit parameters to clarify the intent.","repository":"zed-industries/zed","domain":"devtools","topic":"API","language":"Other","updated":"2025-06-06","comments":2,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-explicit-over-implicit.md"},{"slug":"bun-validate-buffer-boundaries","title":"Validate buffer boundaries","description":"When calling functions that process buffers, especially external C functions, always provide explicit buffer size parameters to prevent buffer overflow vulnerabilities. Buffer overflows are a common security vulnerability that can lead to memory corruption, unauthorized data access, and even remote code execution.","repository":"oven-sh/bun","domain":"runtimes","topic":"Security","language":"Other","updated":"2025-06-06","comments":1,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-validate-buffer-boundaries.md"},{"slug":"deno-minimize-memory-allocations","title":"minimize memory allocations","description":"Identify and eliminate unnecessary memory allocations in performance-critical code paths. This includes pre-allocating collections when the size is known, using static strings for common values, and avoiding intermediate data structures.","repository":"denoland/deno","domain":"runtimes","topic":"Performance Optimization","language":"Rust","updated":"2025-06-05","comments":9,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-minimize-memory-allocations.md"},{"slug":"lobe-chat-environment-variable-access","title":"Environment variable access","description":"Use direct `process.env` access and standardized configuration management instead of custom environment variable wrappers. Avoid redundant abstraction layers when the framework or libraries already handle environment variable inference automatically.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-06-05","comments":8,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-environment-variable-access.md"},{"slug":"opentelemetry-python-future-proof-api-design","title":"Future-proof API design","description":"Design APIs that can evolve without breaking existing code. Use keyword-only arguments (with `*,`) for optional parameters to make API extensions safer. This prevents positional argument errors when parameters change and allows for easier parameter reordering, addition, and deprecation.","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"API","language":"Python","updated":"2025-06-05","comments":7,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-future-proof-api-design.md"},{"slug":"azure-sdk-for-net-maintain-clean-code-structure","title":"Maintain clean code structure","description":"Keep code clean and well-organized by:\\n1. Removing unnecessary elements:\\n\\ \\   - Delete commented-out code that is no longer needed\\n   - Remove unused using\\ \\ directives","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Code Style","language":"C#","updated":"2025-06-05","comments":5,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-maintain-clean-code-structure.md"},{"slug":"azure-quickstart-templates-single-source-network-definitions","title":"Single Source Network Definitions","description":"When authoring ARM/Bicep templates, model networking topology as a single source of truth and avoid redundant resources/dependencies. Apply these rules:","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Networking","language":"Json","updated":"2025-06-05","comments":4,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-single-source-network-definitions.md"},{"slug":"brew-structured-environment-configuration","title":"Structured environment configuration","description":"Use structured environment variable handling with explicit validation instead of directly accessing ENV hash. Implement proper parsing for boolean values, default values, and type conversion. Consider making paths user-specific when creating temporary configurations.","repository":"Homebrew/brew","domain":"devtools","topic":"Configurations","language":"Ruby","updated":"2025-06-05","comments":4,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-structured-environment-configuration.md"},{"slug":"inbox-zero-handle-ai-operation-failures","title":"Handle AI operation failures","description":"Always implement proper error handling for AI service operations. AI services can fail due to rate limiting, network issues, or service outages. Wrap AI service calls in try-catch blocks to gracefully handle potential failures, log relevant error information, and provide appropriate fallbacks.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"AI","language":"TypeScript","updated":"2025-06-05","comments":4,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-handle-ai-operation-failures.md"},{"slug":"react-native-avoid-synchronous-main-dispatch","title":"Avoid synchronous main dispatch","description":"Avoid using `RCTUnsafeExecuteOnMainQueueSync` and similar synchronous main queue dispatch methods as they can cause deadlocks, especially in initialization code, dispatch_once blocks, or when called from background threads that may already hold main queue dependencies.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Concurrency","language":"Other","updated":"2025-06-05","comments":4,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-avoid-synchronous-main-dispatch.md"},{"slug":"terraform-guard-shared-state","title":"Guard shared state","description":"Consistently protect shared state with appropriate synchronization mechanisms and ensure proper cleanup to prevent race conditions and deadlocks in concurrent environments.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Concurrency","language":"Go","updated":"2025-06-05","comments":4,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-guard-shared-state.md"},{"slug":"inbox-zero-nextjs-async-behavior","title":"Next.js async behavior","description":"Understand and correctly implement the asynchronous behavior of Next.js APIs and components. Follow these guidelines: 1. Add `<Suspense>` boundaries around components that use hooks that can trigger suspense, such as `useSearchParams` in the Next.js App Router:","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Next","language":"TSX","updated":"2025-06-05","comments":3,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-nextjs-async-behavior.md"},{"slug":"opengrep-centralize-configuration-management","title":"centralize configuration management","description":"Configuration values should be defined in a single location and passed through proper data structures rather than duplicated across modules or stored in global state. This prevents inconsistencies, reduces error-prone code duplication, and improves maintainability.","repository":"opengrep/opengrep","domain":"security","topic":"Configurations","language":"Other","updated":"2025-06-05","comments":3,"stars":1546,"raw":"https://awesomereviewers.com/raw/opengrep-centralize-configuration-management.md"},{"slug":"prowler-parameterize-similar-tests","title":"Parameterize similar tests","description":"Write maintainable tests by using pytest parametrization for similar test cases instead of duplicating test logic. This makes tests easier to read, maintain, and extend when requirements change.","repository":"prowler-cloud/prowler","domain":"security","topic":"Testing","language":"Python","updated":"2025-06-05","comments":3,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-parameterize-similar-tests.md"},{"slug":"pytorch-reusable-workflow-design","title":"Reusable workflow design","description":"Design CI/CD workflows with reusability and clear naming conventions from the start. Use meaningful prefixes that reflect the conceptual purpose (like \"trunk\" for trunk-based development), and consider future extraction into standalone, parameterized actions when similar functionality might be needed across repositories.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"CI/CD","language":"Yaml","updated":"2025-06-05","comments":3,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-reusable-workflow-design.md"},{"slug":"router-environment-aware-api-usage","title":"environment-aware API usage","description":"Always detect the runtime environment before using environment-specific APIs or utilities. This is crucial for networking applications that may run in browsers, Node.js servers, or cross-platform contexts.","repository":"TanStack/router","domain":"app-frameworks","topic":"Networking","language":"TypeScript","updated":"2025-06-05","comments":3,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-environment-aware-api-usage.md"},{"slug":"argo-cd-configuration-ui-consistency","title":"Configuration UI consistency","description":"Ensure that configuration user interfaces accurately reflect the underlying configuration behavior and data structures. UI controls should provide clear, transparent mapping to the actual configuration values, including precedence rules and field relationships.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Configurations","language":"TSX","updated":"2025-06-05","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-configuration-ui-consistency.md"},{"slug":"neon-reliable-concurrency-synchronization","title":"Reliable concurrency synchronization","description":"When handling concurrent operations, prefer completion signals and proper thread management over arbitrary timeouts. This improves code reliability and prevents hangs or deadlocks.","repository":"neondatabase/neon","domain":"data-systems","topic":"Concurrency","language":"Python","updated":"2025-06-05","comments":2,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-reliable-concurrency-synchronization.md"},{"slug":"workerd-avoid-unnecessary-arc-wrapping","title":"avoid unnecessary Arc wrapping","description":"Don't wrap atomic types in Arc unless you need to share ownership across multiple owners. Atomic types like AtomicBool, AtomicU64, etc. are already thread-safe and can be used directly in structs that will be wrapped in Arc at a higher level.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"Concurrency","language":"Rust","updated":"2025-06-05","comments":2,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-avoid-unnecessary-arc-wrapping.md"},{"slug":"workerd-use-appropriate-api-methods","title":"Use appropriate API methods","description":"When integrating with external APIs or implementing interface methods, ensure you're using the correct API calls for your intended functionality. Consult the official documentation and examples to understand the purpose and proper usage of different methods.","repository":"cloudflare/workerd","domain":"cloud-infra","topic":"API","language":"Rust","updated":"2025-06-05","comments":2,"stars":6989,"raw":"https://awesomereviewers.com/raw/workerd-use-appropriate-api-methods.md"},{"slug":"vscode-shell-specific-input-escaping","title":"Shell-specific input escaping","description":"When processing user input that will be used in shell commands, implement shell-specific escaping mechanisms to prevent command injection vulnerabilities. Different shells (bash, PowerShell, zsh, fish) have different escaping requirements that must be handled appropriately.","repository":"microsoft/vscode","domain":"devtools","topic":"Security","language":"TypeScript","updated":"2025-06-05","comments":1,"stars":174887,"raw":"https://awesomereviewers.com/raw/vscode-shell-specific-input-escaping.md"},{"slug":"ai-document-api-schemas","title":"Document API schemas","description":"Add comprehensive JSDoc comments to all API interfaces, types, and schema definitions. This documentation should: 1. Include links to official external documentation when available","repository":"vercel/ai","domain":"ai-agents","topic":"Documentation","language":"TypeScript","updated":"2025-06-04","comments":5,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-document-api-schemas.md"},{"slug":"spring-framework-respect-annotation-processing-order","title":"Respect annotation processing order","description":"When designing Spring components, pay careful attention to the order in which annotations are processed, especially for inheritance scenarios. Spring processes annotations in a specific sequence that can affect bean initialization and override behavior.","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Spring","language":"Java","updated":"2025-06-04","comments":5,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-respect-annotation-processing-order.md"},{"slug":"ai-explicit-code-organization-patterns","title":"Explicit code organization patterns","description":"Maintain clear and explicit code organization patterns by following these guidelines: 1. Use explicit property visibility in classes: - Prefer public properties over getters/setters when no additional logic is needed","repository":"vercel/ai","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2025-06-04","comments":4,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-explicit-code-organization-patterns.md"},{"slug":"core-optimize-common-search-paths","title":"Optimize common search paths","description":"Implement dedicated fast paths for common search patterns while maintaining a complete fallback path for edge cases. This optimization pattern significantly improves performance for frequent operations while ensuring correctness for all scenarios.","repository":"vuejs/core","domain":"app-frameworks","topic":"Algorithms","language":"TypeScript","updated":"2025-06-04","comments":4,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-optimize-common-search-paths.md"},{"slug":"maplibre-native-use-proper-logging","title":"Use proper logging","description":"Always use the project's standard logging system (mbgl::Log) with appropriate log levels instead of ad-hoc solutions like std::cout, printf, or custom logging macros. This ensures consistent log formatting, proper filtering, and integration with test frameworks.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Logging","language":"C++","updated":"2025-06-04","comments":4,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-use-proper-logging.md"},{"slug":"polars-choose-appropriate-abstractions","title":"Choose appropriate abstractions","description":"When designing APIs, select data types and patterns that match how they will be consumed while facilitating long-term maintainability: 1. Use data types that naturally fit the intended usage pattern. For cloud paths, prefer `String`/`Box<str>` over `OsStr` when APIs you interact with expect string types:","repository":"pola-rs/polars","domain":"data-systems","topic":"API","language":"Rust","updated":"2025-06-04","comments":4,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-choose-appropriate-abstractions.md"},{"slug":"polars-optimize-data-transformations","title":"Optimize data transformations","description":"When implementing data processing operations, avoid unnecessary data transformations, copies, and conversions that can impact query performance. Consider these practices:","repository":"pola-rs/polars","domain":"data-systems","topic":"Database","language":"Rust","updated":"2025-06-04","comments":4,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-optimize-data-transformations.md"},{"slug":"quarkus-avoid-unnecessary-allocations","title":"Avoid unnecessary allocations","description":"Minimize object creation and memory allocations, especially in frequently called methods and hot code paths, to reduce garbage collection pressure and improve performance.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Performance Optimization","language":"Java","updated":"2025-06-04","comments":4,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-avoid-unnecessary-allocations.md"},{"slug":"langfuse-document-data-constraints","title":"Document data constraints","description":"Explicitly document all input and output constraints directly in API definitions. For inputs, specify validation rules such as length limits, character restrictions, and value ranges. For outputs, detail the exact format of returned data structures, including array ordering, boundary conditions (inclusive/exclusive), and semantic meanings of values. This...","repository":"langfuse/langfuse","domain":"observability","topic":"API","language":"Yaml","updated":"2025-06-04","comments":3,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-document-data-constraints.md"},{"slug":"neon-configuration-context-alignment","title":"Configuration context alignment","description":"Choose the appropriate configuration context based on how changes will be handled by the system. When defining custom configuration variables: 1. Use `PGC_POSTMASTER` for options that require a server restart or cannot be changed while the server is running","repository":"neondatabase/neon","domain":"data-systems","topic":"Configurations","language":"C","updated":"2025-06-04","comments":3,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-configuration-context-alignment.md"},{"slug":"spark-use-descriptive-names","title":"Use descriptive names","description":"Choose names that clearly convey purpose and context rather than generic or vague terms. Names should be self-documenting and provide sufficient information for developers to understand their role without additional investigation.","repository":"apache/spark","domain":"data-systems","topic":"Naming Conventions","language":"Java","updated":"2025-06-04","comments":3,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-use-descriptive-names.md"},{"slug":"supabase-database-entity-configuration","title":"Database entity configuration","description":"Configure database entities with appropriate defaults and clear type distinctions. For triggers, prefer AFTER/ROW over BEFORE/STATEMENT as defaults for most use cases. When working with database views, clearly distinguish between regular views and materialized views in your code. When counting database resources like replicas, ensure accurate counting by...","repository":"supabase/supabase","domain":"data-systems","topic":"Database","language":"TSX","updated":"2025-06-04","comments":3,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-database-entity-configuration.md"},{"slug":"firecrawl-preserve-null-semantics","title":"preserve null semantics","description":"When null or undefined values represent meaningful absence of data, preserve them rather than converting to default values like empty strings, arrays, or placeholder text. Converting these values can lose semantic meaning and create unnecessary data storage or processing overhead.","repository":"firecrawl/firecrawl","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2025-06-04","comments":2,"stars":54535,"raw":"https://awesomereviewers.com/raw/firecrawl-preserve-null-semantics.md"},{"slug":"inbox-zero-collections-use-plural-names","title":"Collections use plural names","description":"Always use plural names for properties representing collections (arrays/lists) in interfaces, types, and destructuring patterns. This ensures consistency between interface definitions and their usage throughout the codebase.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Naming Conventions","language":"TSX","updated":"2025-06-04","comments":2,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-collections-use-plural-names.md"},{"slug":"pytorch-optimize-container-operations","title":"Optimize container operations","description":"Minimize CPU overhead in container operations by using efficient data structure patterns: 1. **Use static containers** for fixed lookup tables or maps that are frequently accessed but rarely changed. This avoids reconstruction overhead on each function call:","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Performance Optimization","language":"Other","updated":"2025-06-04","comments":2,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-optimize-container-operations.md"},{"slug":"neon-harden-cicd-runners","title":"Harden CI/CD runners","description":"All CI/CD workflow jobs must implement security controls for network traffic, particularly using the step-security/harden-runner action or equivalent technology. This prevents potential supply chain attacks or unauthorized data exfiltration during automated builds and tests.","repository":"neondatabase/neon","domain":"data-systems","topic":"Security","language":"Yaml","updated":"2025-06-04","comments":1,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-harden-cicd-runners.md"},{"slug":"ollama-descriptive-balanced-naming","title":"Descriptive balanced naming","description":"Choose identifier names that clearly communicate their purpose while\\ \\ maintaining an appropriate balance between brevity and clarity. \\n\\n**Guidelines:**","repository":"ollama/ollama","domain":"llm-infra","topic":"Naming Conventions","language":"Go","updated":"2025-06-03","comments":8,"stars":145704,"raw":"https://awesomereviewers.com/raw/ollama-descriptive-balanced-naming.md"},{"slug":"rails-organize-tests-for-clarity","title":"Organize tests for clarity","description":"Structure tests to maximize clarity and maintainability by: 1. Placing related tests together in appropriate test files 2. Using built-in assertion helpers instead of raw assertions","repository":"rails/rails","domain":"app-frameworks","topic":"Testing","language":"Ruby","updated":"2025-06-03","comments":8,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-organize-tests-for-clarity.md"},{"slug":"react-native-avoid-operator","title":"avoid !! operator","description":"Avoid using the not-null assertion operator (`!!`) as it can cause runtime crashes if the assumption about non-nullability is incorrect. Instead, use safer alternatives that provide better error handling and code clarity.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Null Handling","language":"Kotlin","updated":"2025-06-03","comments":7,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-avoid-operator.md"},{"slug":"influxdb-follow-api-conventions","title":"Follow API conventions","description":"Design APIs following modern conventions and best practices to improve usability, maintainability, and consistency across your codebase. APIs should prioritize:","repository":"influxdata/influxdb","domain":"data-systems","topic":"API","language":"Rust","updated":"2025-06-03","comments":6,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-follow-api-conventions.md"},{"slug":"langfuse-hook-and-state-correctness","title":"Hook and state correctness","description":"Ensure React hooks and state updates follow best practices to prevent subtle bugs: 1. **Call hooks unconditionally** at the top level of your component or custom hook - never inside conditionals, loops, or nested functions:","repository":"langfuse/langfuse","domain":"observability","topic":"React","language":"TSX","updated":"2025-06-03","comments":6,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-hook-and-state-correctness.md"},{"slug":"prowler-least-privilege-principle","title":"Least privilege principle","description":"Always follow the principle of least privilege by granting the minimum permissions necessary for functionality. This applies to various security contexts:","repository":"prowler-cloud/prowler","domain":"security","topic":"Security","language":"Python","updated":"2025-06-03","comments":6,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-least-privilege-principle.md"},{"slug":"rails-minimize-public-api-surface","title":"Minimize public API surface","description":"Design APIs with a minimal public surface area by carefully controlling which methods and properties are exposed. Start with a restricted set of public methods and expand only when there's clear evidence of need. This approach makes APIs easier to maintain and evolve while reducing the risk of breaking changes.","repository":"rails/rails","domain":"app-frameworks","topic":"API","language":"Ruby","updated":"2025-06-03","comments":6,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-minimize-public-api-surface.md"},{"slug":"dspy-reduce-nesting-levels","title":"reduce nesting levels","description":"Minimize nested conditional statements and complex control flow by using early returns, guard clauses, and default value patterns. This improves code readability and maintainability by reducing cognitive load.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2025-06-03","comments":5,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-reduce-nesting-levels.md"},{"slug":"influxdb-descriptive-semantic-naming","title":"Descriptive semantic naming","description":"Create identifiers that clearly convey meaning through descriptive names and appropriate types. Two key practices improve code readability and prevent errors:","repository":"influxdata/influxdb","domain":"data-systems","topic":"Naming Conventions","language":"Rust","updated":"2025-06-03","comments":5,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-descriptive-semantic-naming.md"},{"slug":"influxdb-prefer-explicit-nullability","title":"Prefer explicit nullability","description":"Always make nullable states explicit in your code by leveraging Rust's type system. Use `Option<T>` rather than sentinel values (like empty structs or default values) to represent potentially missing data. When handling options, prefer idiomatic patterns like `.map()` with `.unwrap_or()` for transforming with fallbacks. Consider specialized types like...","repository":"influxdata/influxdb","domain":"data-systems","topic":"Null Handling","language":"Rust","updated":"2025-06-03","comments":5,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-prefer-explicit-nullability.md"},{"slug":"langfuse-memoize-computed-values","title":"Memoize computed values","description":"Cache the results of expensive operations and component renders to avoid redundant calculations during re-renders. This improves application performance, especially when working with large datasets or complex transformations.","repository":"langfuse/langfuse","domain":"observability","topic":"Performance Optimization","language":"TSX","updated":"2025-06-03","comments":5,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-memoize-computed-values.md"},{"slug":"novu-extract-repeated-patterns","title":"Extract repeated patterns","description":"Extract repeated code patterns, CSS classes, and constants to improve maintainability and reduce duplication. When the same values, classes, or logic appear multiple times, consolidate them into reusable constants or utilities.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Code Style","language":"TSX","updated":"2025-06-03","comments":5,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-extract-repeated-patterns.md"},{"slug":"temporal-domain-specific-error-boundaries","title":"Domain-specific error boundaries","description":"Define and use domain-specific error types within bounded contexts rather than relying on generic service errors. Each component/package should define its own error types that reflect its domain concepts, avoiding dependencies on external error frameworks.","repository":"temporalio/temporal","domain":"orchestration","topic":"Error Handling","language":"Go","updated":"2025-06-03","comments":5,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-domain-specific-error-boundaries.md"},{"slug":"appwrite-cypress-test-isolation","title":"Cypress test isolation","description":"Ensure end-to-end tests are properly isolated and follow best practices for reliability. Tests should avoid side effects that can impact other tests and eliminate practices that cause flaky results.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Testing","language":"JavaScript","updated":"2025-06-03","comments":4,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-cypress-test-isolation.md"},{"slug":"influxdb-use-structured-logging-fields","title":"Use structured logging fields","description":"Always use structured logging with descriptive field names rather than string interpolation. Include relevant context variables such as identifiers, durations, and parameters to make logs more useful for debugging and monitoring. This practice makes logs more searchable, filterable, and easier to analyze.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Logging","language":"Rust","updated":"2025-06-03","comments":4,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-use-structured-logging-fields.md"},{"slug":"terraform-explicit-protocol-interfaces","title":"Explicit protocol interfaces","description":"Design protocol interfaces with explicit behavior definitions rather than relying on implicit conventions. Clearly specify the purpose and expected handling of each field, especially when adding new parameters or response structures.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"API","language":"Other","updated":"2025-06-03","comments":4,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-explicit-protocol-interfaces.md"},{"slug":"appwrite-self-contained-test-scenarios","title":"Self-contained test scenarios","description":"Tests should be fully self-contained to ensure reliability and prevent unexpected failures. Each test scenario should: 1. Create any prerequisite data it needs rather than assuming it exists","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Testing","language":"Other","updated":"2025-06-03","comments":3,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-self-contained-test-scenarios.md"},{"slug":"brew-prevent-injection-vulnerabilities","title":"Prevent injection vulnerabilities","description":"Always sanitize input data before using it in sensitive operations to prevent injection vulnerabilities. This applies to shell commands, file operations, and URL handling.","repository":"Homebrew/brew","domain":"devtools","topic":"Security","language":"Ruby","updated":"2025-06-03","comments":3,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-prevent-injection-vulnerabilities.md"},{"slug":"deno-use-backticks-for-identifiers","title":"Use backticks for identifiers","description":"Wrap all code identifiers, method names, interface names, class names, and API references in JSDoc comments with backticks (`) for proper monospacing and improved readability.","repository":"denoland/deno","domain":"runtimes","topic":"Documentation","language":"TypeScript","updated":"2025-06-03","comments":3,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-use-backticks-for-identifiers.md"},{"slug":"refact-validate-null-undefined-values","title":"validate null undefined values","description":"Always perform explicit null and undefined checks before accessing object properties or using values in operations. Filter out undefined values from arrays and collections to prevent runtime errors and unexpected behavior.","repository":"smallcloudai/refact","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2025-06-03","comments":3,"stars":3114,"raw":"https://awesomereviewers.com/raw/refact-validate-null-undefined-values.md"},{"slug":"appwrite-consistent-language-in-naming","title":"Consistent language in naming","description":"Use a single language (preferably English) consistently throughout your codebase for all identifiers including interface names, classes, variables, and properties. Avoid mixing languages as this reduces code readability and creates inconsistent naming patterns.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2025-06-03","comments":2,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-consistent-language-in-naming.md"},{"slug":"appwrite-flexible-network-handling","title":"Flexible network handling","description":"When working with network connections and HTTP requests, implement flexible configuration patterns and robust response handling to prevent flaky behavior and ensure compatibility across environments.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Networking","language":"JavaScript","updated":"2025-06-03","comments":2,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-flexible-network-handling.md"},{"slug":"bun-judicious-move-semantics","title":"Judicious move semantics","description":"Apply C++ move semantics and lambda modifiers only when necessary. The `mutable` keyword should only be used in lambdas when you need to modify captured variables, including when using move operations on them:","repository":"oven-sh/bun","domain":"runtimes","topic":"Code Style","language":"C++","updated":"2025-06-03","comments":2,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-judicious-move-semantics.md"},{"slug":"bun-validate-network-inputs","title":"Validate network inputs","description":"Network code must validate all inputs and handle error conditions properly to prevent security vulnerabilities and reliability issues. This includes:","repository":"oven-sh/bun","domain":"runtimes","topic":"Networking","language":"C++","updated":"2025-06-03","comments":2,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-validate-network-inputs.md"},{"slug":"pytorch-type-appropriate-null-representation","title":"Type-appropriate null representation","description":"Always use type-appropriate mechanisms to represent the absence of a value. For objects, use default constructors rather than nullptr. For potentially absent values, consider using optional types. For pointers, use null checks before performing operations on them.","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Null Handling","language":"C++","updated":"2025-06-03","comments":2,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-type-appropriate-null-representation.md"},{"slug":"react-native-optimize-algorithmic-choices","title":"Optimize algorithmic choices","description":"When implementing algorithms, prioritize both correctness and efficiency by selecting the most appropriate data structures and computational approaches for each specific task. Ensure mathematical calculations follow established specifications and standards, and choose data structures that match the operation's requirements.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Algorithms","language":"Objective-C","updated":"2025-06-03","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-optimize-algorithmic-choices.md"},{"slug":"sonic-defensive-error-handling","title":"Defensive error handling","description":"Implement defensive checks when managing error state to prevent overwriting existing errors and add safeguards even when theoretically unnecessary. This approach helps avoid subtle bugs and makes code more robust against future modifications.","repository":"bytedance/sonic","domain":"runtimes","topic":"Error Handling","language":"Go","updated":"2025-06-03","comments":2,"stars":8532,"raw":"https://awesomereviewers.com/raw/sonic-defensive-error-handling.md"},{"slug":"union-ensure-semantic-precision","title":"Ensure semantic precision","description":"Choose names and identifiers that precisely convey their intended semantic meaning and avoid ambiguity or conflicts. Names should be specific enough to prevent confusion and clearly communicate their purpose within the codebase.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Naming Conventions","language":"TypeScript","updated":"2025-06-03","comments":2,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-ensure-semantic-precision.md"},{"slug":"appwrite-secure-credentials-management","title":"Secure credentials management","description":"Never store sensitive credentials (passwords, API keys, tokens, etc.) in plain text within code repositories. This practice poses a significant security risk as it can lead to unauthorized access if the repository is compromised or accidentally made public.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Security","language":"Other","updated":"2025-06-03","comments":1,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-secure-credentials-management.md"},{"slug":"appwrite-secure-file-uploads","title":"Secure file uploads","description":"Always implement and maintain robust scanning mechanisms for user-uploaded files to prevent malware distribution. When modifying infrastructure or services related to file handling, ensure alternative security controls are in place before removing existing protections.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Security","language":"Yaml","updated":"2025-06-03","comments":1,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-secure-file-uploads.md"},{"slug":"opentofu-craft-actionable-errors","title":"Craft actionable errors","description":"Create error messages that provide precise context, avoid unnecessary details, and give users clear actions to take. Error messages should include location information when possible, avoid jargon, and maintain a consistent tone without being patronizing.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Error Handling","language":"Go","updated":"2025-06-02","comments":11,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-craft-actionable-errors.md"},{"slug":"chef-fail-gracefully-always","title":"Fail gracefully always","description":"Ensure code handles errors robustly by using protective patterns that prevent resource leaks, provide clear diagnostics, and degrade gracefully when possible:","repository":"chef/chef","domain":"cloud-infra","topic":"Error Handling","language":"Ruby","updated":"2025-06-02","comments":9,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-fail-gracefully-always.md"},{"slug":"netty-semantic-over-generic-names","title":"Semantic over generic names","description":"Choose specific, descriptive names that clearly convey purpose over generic or abbreviated identifiers. Names should be self-documenting and unambiguous about their role.","repository":"netty/netty","domain":"runtimes","topic":"Naming Conventions","language":"Java","updated":"2025-06-02","comments":9,"stars":34227,"raw":"https://awesomereviewers.com/raw/netty-semantic-over-generic-names.md"},{"slug":"uv-clear-precise-documentation","title":"Clear precise documentation","description":"Documentation should use direct, precise language that accurately describes components and their behavior. Maintain consistent grammatical structure throughout related documentation sections for improved readability.","repository":"astral-sh/uv","domain":"devtools","topic":"Documentation","language":"Rust","updated":"2025-06-02","comments":8,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-clear-precise-documentation.md"},{"slug":"opencv-use-proper-assertions","title":"Use proper assertions","description":"Write tests with proper assertions to ensure reliability and maintainability. Follow these guidelines: 1. **Check for empty data** before proceeding with tests to prevent invalid test conditions:","repository":"opencv/opencv","domain":"ml-systems","topic":"Testing","language":"C++","updated":"2025-06-02","comments":7,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-use-proper-assertions.md"},{"slug":"playwright-validate-inputs-early","title":"validate inputs early","description":"Always validate function parameters and configuration options at the beginning of functions, providing specific and actionable error messages that guide users toward correct usage. This prevents downstream errors and improves developer experience.","repository":"microsoft/playwright","domain":"devtools","topic":"Error Handling","language":"TypeScript","updated":"2025-06-02","comments":7,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-validate-inputs-early.md"},{"slug":"playwright-extract-repeated-logic","title":"Extract repeated logic","description":"When you find yourself writing similar code patterns multiple times, extract them into reusable methods, constants, or leverage existing helpers. This improves maintainability and reduces the chance of inconsistencies.","repository":"microsoft/playwright","domain":"devtools","topic":"Code Style","language":"TypeScript","updated":"2025-06-02","comments":6,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-extract-repeated-logic.md"},{"slug":"cline-add-missing-error-handling","title":"Add missing error handling","description":"Wrap operations that can fail in try/catch blocks to prevent unhandled exceptions from crashing the application or leaving it in an inconsistent state. This is especially important for file operations, API calls, and critical initialization code.","repository":"cline/cline","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2025-06-02","comments":5,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-add-missing-error-handling.md"},{"slug":"ghostty-prevent-unnecessary-memory-operations","title":"Prevent unnecessary memory operations","description":"Avoid redundant memory allocations and copies when simpler alternatives exist. This includes: 1. Use in-place comparison functions instead of allocating for string operations","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Performance Optimization","language":"Other","updated":"2025-06-02","comments":4,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-prevent-unnecessary-memory-operations.md"},{"slug":"ghostty-semantic-name-clarity","title":"Semantic name clarity","description":"Names should clearly and accurately reflect the purpose of variables, methods, and other identifiers. Follow these principles: 1. Use descriptive, specific names that convey exact purpose","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Naming Conventions","language":"Swift","updated":"2025-06-02","comments":4,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-semantic-name-clarity.md"},{"slug":"influxdb-performance-conscious-metrics-implementation","title":"Performance-conscious metrics implementation","description":"Implement metrics collection that is both comprehensive and minimally impactful on system performance. Design your metrics system to avoid creating bottlenecks in critical paths.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Observability","language":"Rust","updated":"2025-06-02","comments":4,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-performance-conscious-metrics-implementation.md"},{"slug":"prometheus-configure-dependency-management-comprehensively","title":"Configure dependency management comprehensively","description":"When configuring dependency management tools like Renovate, ensure comprehensive setup that includes modern syntax, strategic dependency grouping, and controlled update policies. Use current configuration formats (e.g., cron syntax instead of deprecated natural language), implement proper dependency grouping strategies, and configure update separation for...","repository":"prometheus/prometheus","domain":"observability","topic":"Configurations","language":"Json","updated":"2025-06-02","comments":4,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-configure-dependency-management-comprehensively.md"},{"slug":"turborepo-configuration-precision-matters","title":"Configuration precision matters","description":"Ensure configuration files are precise and stable to prevent unexpected build failures and runtime issues. This includes: 1. **Use correct syntax in configuration files**","repository":"vercel/turborepo","domain":"devtools","topic":"Configurations","language":"Json","updated":"2025-06-02","comments":4,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-configuration-precision-matters.md"},{"slug":"uv-respect-connectivity-state","title":"Respect connectivity state","description":"Applications should gracefully handle different network connectivity states and provide appropriate feedback to users. Follow these guidelines: 1. **Check connectivity state before network operations** - Always verify if the application is in offline mode before attempting network requests","repository":"astral-sh/uv","domain":"devtools","topic":"Networking","language":"Rust","updated":"2025-06-02","comments":4,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-respect-connectivity-state.md"},{"slug":"bun-follow-standard-api-specifications","title":"Follow standard API specifications","description":"Ensure API implementations strictly adhere to published specifications, even when adding features or optimizations. Deviating from standard behavior can create compatibility issues with other implementations (like Node.js) that rely on specification-compliant behavior.","repository":"oven-sh/bun","domain":"runtimes","topic":"API","language":"C++","updated":"2025-06-02","comments":2,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-follow-standard-api-specifications.md"},{"slug":"neon-database-replica-promotion-safeguards","title":"Database replica promotion safeguards","description":"When implementing database replica promotion logic, avoid temporary workarounds that bypass validation checks. Instead, design a comprehensive approach that maintains data integrity throughout the promotion process. Consider these best practices:","repository":"neondatabase/neon","domain":"data-systems","topic":"Database","language":"Other","updated":"2025-06-02","comments":2,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-database-replica-promotion-safeguards.md"},{"slug":"neon-mind-transaction-boundaries","title":"Mind transaction boundaries","description":"Be conscious of implicit transaction boundaries when working with databases. Programming constructs can create unexpected transaction scopes that affect behavior and performance.","repository":"neondatabase/neon","domain":"data-systems","topic":"Database","language":"Python","updated":"2025-06-02","comments":2,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-mind-transaction-boundaries.md"},{"slug":"prowler-prefer-server-components","title":"Prefer server components","description":"Default to server components in Next.js applications to maximize the benefits of server-side rendering. Avoid adding \"use client\" directives unnecessarily, especially at the page level.","repository":"prowler-cloud/prowler","domain":"security","topic":"Next","language":"TSX","updated":"2025-06-02","comments":2,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-prefer-server-components.md"},{"slug":"workers-sdk-document-workflow-capabilities","title":"document workflow capabilities","description":"Workflow methods should include comments that document their orchestration capabilities and data access patterns. This helps developers understand the available temporal execution features and interaction methods.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Temporal","language":"JavaScript","updated":"2025-06-02","comments":2,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-document-workflow-capabilities.md"},{"slug":"workers-sdk-workflow-documentation-clarity","title":"workflow documentation clarity","description":"Ensure all workflow-related documentation, help text, and code comments use proper grammar and punctuation. Workflow systems involve complex orchestration, retries, and fault tolerance mechanisms that require clear, professional documentation for maintainability and developer understanding.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Temporal","language":"TypeScript","updated":"2025-06-02","comments":2,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-workflow-documentation-clarity.md"},{"slug":"prowler-avoid-localstorage-for-credentials","title":"Avoid localStorage for credentials","description":"Do not store user profiles, authentication tokens, or other sensitive user information in client-side storage mechanisms like localStorage or sessionStorage. This creates security vulnerabilities as these storage mechanisms are accessible to any JavaScript running on the page, including potential XSS attacks.","repository":"prowler-cloud/prowler","domain":"security","topic":"Security","language":"TypeScript","updated":"2025-06-02","comments":1,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-avoid-localstorage-for-credentials.md"},{"slug":"hyprland-prevent-null-dereferences","title":"prevent null dereferences","description":"Always verify pointers are valid before dereferencing to prevent crashes and undefined behavior. This applies to regular pointers, weak pointers, and return values from C functions that may return null.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Null Handling","language":"C++","updated":"2025-06-01","comments":7,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-prevent-null-dereferences.md"},{"slug":"desktop-organize-code-properly","title":"organize code properly","description":"Maintain clean code organization by separating concerns into appropriate classes and files. Extract large functions into smaller, focused methods, and avoid creating monolithic patches that become difficult to maintain.","repository":"zen-browser/desktop","domain":"devtools","topic":"Code Style","language":"Other","updated":"2025-06-01","comments":6,"stars":34711,"raw":"https://awesomereviewers.com/raw/desktop-organize-code-properly.md"},{"slug":"langfuse-explicit-null-value-checks","title":"Explicit null value checks","description":"Use explicit null/undefined checks instead of truthy/falsy checks when handling potentially null or undefined values. Relying on truthy/falsy checks can lead to bugs when dealing with valid falsy values like 0 or empty strings.","repository":"langfuse/langfuse","domain":"observability","topic":"Null Handling","language":"TypeScript","updated":"2025-06-01","comments":4,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-explicit-null-value-checks.md"},{"slug":"maplibre-native-variable-evaluation-context","title":"Variable evaluation context","description":"Be mindful of when and where environment variables and configuration values are evaluated in shell scripts, especially when working across different execution contexts (like host vs. container environments). Improper quoting can cause variables to be evaluated in the wrong context, leading to unexpected behavior.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Configurations","language":"Shell","updated":"2025-06-01","comments":2,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-variable-evaluation-context.md"},{"slug":"quarkus-consolidate-duplicate-configurations","title":"Consolidate duplicate configurations","description":"Maintain a single source of truth for configuration files instead of duplicating them across the codebase. Duplicated configurations (like banned-signatures.txt files) lead to maintenance challenges, potential inconsistencies, and confusion about which version is authoritative.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Configurations","language":"Txt","updated":"2025-06-01","comments":2,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-consolidate-duplicate-configurations.md"},{"slug":"fiber-ensure-comprehensive-test-coverage","title":"Ensure comprehensive test coverage","description":"All code paths, error conditions, and edge cases must have corresponding unit tests to ensure robust functionality and prevent regressions. This includes testing both success and failure scenarios, boundary conditions, and error handling paths.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Testing","language":"Go","updated":"2025-05-31","comments":9,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-ensure-comprehensive-test-coverage.md"},{"slug":"typescript-names-reveal-semantic-purpose","title":"Names reveal semantic purpose","description":"Choose names that clearly communicate the semantic purpose and behavior of code elements. Variable and function names should precisely reflect their role, return type, and intended usage.","repository":"microsoft/typescript","domain":"runtimes","topic":"Naming Conventions","language":"TypeScript","updated":"2025-05-31","comments":7,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-names-reveal-semantic-purpose.md"},{"slug":"nuxt-configuration-method-selection","title":"Configuration method selection","description":"Choose the appropriate configuration method based on when values are needed and whether they can change at runtime. Use `runtimeConfig` for values that need to be set via environment variables after build (especially secrets), `app.config` for public build-time configuration that won't change, and `process.env` only in server contexts when outside the Nuxt...","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Configurations","language":"Markdown","updated":"2025-05-31","comments":6,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-configuration-method-selection.md"},{"slug":"continue-choose-clear-semantic-names","title":"Choose clear semantic names","description":"Names should clearly and accurately convey their purpose, behavior, and content. Follow these guidelines: 1. Use positive boolean flags: ```typescript","repository":"continuedev/continue","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2025-05-31","comments":5,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-choose-clear-semantic-names.md"},{"slug":"deno-organize-code-structure","title":"organize code structure","description":"Maintain clean code organization by moving implementation details to appropriate locations, extracting reusable functionality, and keeping related code together. This improves maintainability and prevents bugs from poor encapsulation.","repository":"denoland/deno","domain":"runtimes","topic":"Code Style","language":"Rust","updated":"2025-05-30","comments":10,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-organize-code-structure.md"},{"slug":"openpilot-use-semantically-accurate-names","title":"Use semantically accurate names","description":"Variable, method, and class names should accurately reflect their actual behavior and purpose. Misleading or vague names create confusion and make code harder to understand and maintain.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Naming Conventions","language":"Python","updated":"2025-05-30","comments":9,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-use-semantically-accurate-names.md"},{"slug":"tensorflow-choose-efficient-implementations","title":"Choose efficient implementations","description":"When implementing algorithms, prioritize both correctness and performance by selecting appropriate data structures, optimizing memory usage, and leveraging language features.","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Algorithms","language":"Other","updated":"2025-05-30","comments":6,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-choose-efficient-implementations.md"},{"slug":"zod-consistent-clear-naming","title":"Consistent, clear naming","description":"Use naming that is unambiguous, consistent with the codebase, and semantically accurate. Apply: - Avoid shadowing: don’t reuse the same parameter name in a nested scope; either rename or move the nested function out.","repository":"colinhacks/zod","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2025-05-30","comments":5,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-consistent-clear-naming.md"},{"slug":"quarkus-avoid-wildcard-imports","title":"Avoid wildcard imports","description":"Wildcard (star) imports like `import java.util.*;` are prohibited in the codebase as they reduce code readability and can cause naming conflicts. Always import specific classes individually.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Code Style","language":"Java","updated":"2025-05-30","comments":4,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-avoid-wildcard-imports.md"},{"slug":"rails-human-readable-configuration-values","title":"Human-readable configuration values","description":"When writing configuration files, prioritize human readability and maintainability by using descriptive expressions instead of magic numbers or cryptic values. This makes code more understandable and easier to maintain.","repository":"rails/rails","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2025-05-30","comments":4,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-human-readable-configuration-values.md"},{"slug":"brew-document-non-obvious-decisions","title":"Document non-obvious decisions","description":"Always add clear comments explaining non-obvious code decisions such as magic numbers, arbitrary values, truncation limits, or special case handling. Convert magic numbers to named constants with explanatory comments when appropriate. This documentation helps future developers understand the reasoning behind code decisions and makes maintenance easier.","repository":"Homebrew/brew","domain":"devtools","topic":"Documentation","language":"Ruby","updated":"2025-05-30","comments":3,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-document-non-obvious-decisions.md"},{"slug":"browser-use-consistent-terminology-usage","title":"Consistent terminology usage","description":"Maintain consistent terminology and naming patterns throughout the codebase to avoid confusion and future conflicts. Use descriptive names that clearly indicate their purpose and remove unnecessary parameters or elements that don't serve a function.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Naming Conventions","language":"Python","updated":"2025-05-30","comments":3,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-consistent-terminology-usage.md"},{"slug":"istio-early-nil-checks","title":"Early nil checks","description":"Add nil and empty checks at the beginning of functions to prevent downstream issues and avoid unnecessary processing. This pattern improves code safety and performance by failing fast when inputs are invalid or empty.","repository":"istio/istio","domain":"orchestration","topic":"Null Handling","language":"Go","updated":"2025-05-30","comments":3,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-early-nil-checks.md"},{"slug":"langchainjs-chunked-data-processing","title":"Chunked data processing","description":"When processing large arrays or data structures, implement chunked processing to avoid stack size limitations and optimize performance. Break operations into manageable chunks rather than processing everything at once.","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Algorithms","language":"TypeScript","updated":"2025-05-30","comments":3,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-chunked-data-processing.md"},{"slug":"svelte-analyze-transitive-dependencies","title":"analyze transitive dependencies","description":"When implementing dependency analysis algorithms, ensure comprehensive tracking of both direct and transitive dependencies to avoid missing critical relationships. Many bugs arise from incomplete dependency graphs that fail to account for indirect connections.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Algorithms","language":"Markdown","updated":"2025-05-30","comments":3,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-analyze-transitive-dependencies.md"},{"slug":"browser-use-validate-connection-timeouts","title":"validate connection timeouts","description":"Always validate network connection states and implement explicit timeout handling to prevent zombie connections and ensure robust network operations. Connection objects can appear valid while actually being disconnected, and network operations without timeouts can hang indefinitely.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Networking","language":"Python","updated":"2025-05-30","comments":2,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-validate-connection-timeouts.md"},{"slug":"core-restrict-administrative-access","title":"Restrict administrative access","description":"Implement proper authorization controls for sensitive operations that can modify system configuration or create new entries. Administrative functions like service calls that create config entries should be restricted to admin-level access at minimum, or better yet, exposed as scoped integration APIs rather than general-purpose services. Additionally, ensure...","repository":"home-assistant/core","domain":"app-frameworks","topic":"Security","language":"Python","updated":"2025-05-30","comments":2,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-restrict-administrative-access.md"},{"slug":"runtime-document-non-obvious-logic","title":"Document non-obvious logic","description":"Add clear comments explaining the purpose and reasoning behind complex or non-obvious code logic. Comments should explain 'why' certain implementation choices were made or how specific variables and conditions function, rather than just restating what the code does. This is especially important for security-related checks, timing mechanisms, interruption...","repository":"dotnet/runtime","domain":"runtimes","topic":"Documentation","language":"C","updated":"2025-05-30","comments":2,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-document-non-obvious-logic.md"},{"slug":"runtime-use-utility-macros","title":"Use utility macros","description":"Use predefined utility macros for common operations instead of repeating manual calculations throughout your code. This improves readability, consistency, and reduces the likelihood of errors in calculations.","repository":"dotnet/runtime","domain":"runtimes","topic":"Code Style","language":"C","updated":"2025-05-30","comments":2,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-use-utility-macros.md"},{"slug":"signoz-reuse-existing-utilities","title":"reuse existing utilities","description":"Before creating new utility functions, check if existing ones can be reused or extended. Avoid code duplication by leveraging established utilities and creating single sources of truth for repeated patterns.","repository":"SigNoz/signoz","domain":"observability","topic":"Code Style","language":"TypeScript","updated":"2025-05-30","comments":2,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-reuse-existing-utilities.md"},{"slug":"deno-use-appropriate-error-types","title":"Use appropriate error types","description":"Functions should use specific, appropriate error handling mechanisms rather than generic or brittle approaches. This includes returning proper error codes when operations fail, using specific error types instead of generic `notImplemented` errors, and avoiding fragile error detection methods like string matching.","repository":"denoland/deno","domain":"runtimes","topic":"Error Handling","language":"TypeScript","updated":"2025-05-29","comments":4,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-use-appropriate-error-types.md"},{"slug":"react-native-proper-synchronization-practices","title":"proper synchronization practices","description":"Ensure thread safety by using appropriate synchronization mechanisms and understanding thread context. When working with shared mutable state, protect critical sections with proper synchronization to prevent race conditions and concurrent modifications. Choose the right synchronization approach for your use case - prefer language-provided utilities over...","repository":"facebook/react-native","domain":"app-frameworks","topic":"Concurrency","language":"Kotlin","updated":"2025-05-29","comments":4,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-proper-synchronization-practices.md"},{"slug":"browser-use-validate-file-inputs","title":"validate file inputs","description":"All file-related operations must implement comprehensive input validation and sanitization to prevent path traversal attacks, arbitrary file system access, and execution of malicious content. This is especially critical when handling user-provided file paths or when systems interact with AI agents that could be manipulated through prompt injection.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Security","language":"Python","updated":"2025-05-29","comments":3,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-validate-file-inputs.md"},{"slug":"runtime-parameterize-configuration-values","title":"Parameterize configuration values","description":"Extract hard-coded configuration values into variables, parameters, or templates to improve reusability and simplify maintenance. When the same value is used in multiple places or might need to change in the future, define it once and reference it throughout your configuration files.","repository":"dotnet/runtime","domain":"runtimes","topic":"Configurations","language":"Yaml","updated":"2025-05-29","comments":3,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-parameterize-configuration-values.md"},{"slug":"signoz-standardize-authentication-context-extraction","title":"standardize authentication context extraction","description":"Always use the standardized `authtypes.ClaimsFromContext` method for extracting authentication claims from request context, and handle errors properly. This ensures consistent authentication handling across the codebase and prevents potential security vulnerabilities from incorrect claim extraction.","repository":"SigNoz/signoz","domain":"observability","topic":"Security","language":"Go","updated":"2025-05-29","comments":3,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-standardize-authentication-context-extraction.md"},{"slug":"browser-use-avoid-logging-sensitive-content","title":"Avoid logging sensitive content","description":"Be cautious about what data gets included in log messages to prevent security risks and performance issues. Before logging file contents or user data, consider whether it could contain:","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Logging","language":"Python","updated":"2025-05-29","comments":2,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-avoid-logging-sensitive-content.md"},{"slug":"deno-remove-unnecessary-prefixes","title":"remove unnecessary prefixes","description":"Remove vendor prefixes from CSS properties that have achieved sufficient browser support across modern browsers. Before removing prefixes, verify browser compatibility using resources like MDN documentation to ensure the unprefixed property is well-supported.","repository":"denoland/deno","domain":"runtimes","topic":"Code Style","language":"Css","updated":"2025-05-29","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-remove-unnecessary-prefixes.md"},{"slug":"novu-strategic-error-handling","title":"Strategic error handling","description":"Implement strategic error handling by properly checking exception types and using try/catch blocks to distinguish between user errors and system errors. Avoid runtime errors from improper type checking and categorize exceptions based on their source and required response.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2025-05-29","comments":2,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-strategic-error-handling.md"},{"slug":"claude-code-pin-dependency-versions","title":"Pin dependency versions","description":"Always pin external dependencies to specific commit hashes rather than mutable references like tags or branch names to prevent supply chain attacks. This applies to GitHub Actions, package dependencies, Docker images, and similar resources - even if they're from your own repositories.","repository":"anthropics/claude-code","domain":"ai-agents","topic":"Security","language":"Yaml","updated":"2025-05-29","comments":1,"stars":25432,"raw":"https://awesomereviewers.com/raw/claude-code-pin-dependency-versions.md"},{"slug":"framework-explicit-null-handling","title":"Explicit null handling","description":"Use explicit identity comparisons for null checks and leverage modern PHP null-handling features to create more reliable, readable code. ## Key practices:","repository":"laravel/framework","domain":"app-frameworks","topic":"Null Handling","language":"PHP","updated":"2025-05-28","comments":9,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-explicit-null-handling.md"},{"slug":"temporal-specific-assertion-methods","title":"Specific assertion methods","description":"Use the most specific and descriptive assertion methods available in your test framework to improve test readability and failure diagnostics. Prefer methods that clearly state intent and produce helpful error messages.","repository":"temporalio/temporal","domain":"orchestration","topic":"Testing","language":"Go","updated":"2025-05-28","comments":6,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-specific-assertion-methods.md"},{"slug":"bun-network-api-compatibility","title":"Network API compatibility","description":"When implementing networking APIs that mirror Node.js functionality, ensure both behavior and error patterns match Node.js exactly. This is critical for maintaining compatibility with the Node.js ecosystem and ensuring that code works consistently across both environments.","repository":"oven-sh/bun","domain":"runtimes","topic":"Networking","language":"TypeScript","updated":"2025-05-28","comments":5,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-network-api-compatibility.md"},{"slug":"django-preserve-error-handling-context","title":"Preserve error handling context","description":"When handling exceptions, preserve the original error context and provide clear, actionable error messages. This helps with debugging and improves the developer experience. Key practices:","repository":"django/django","domain":"app-frameworks","topic":"Error Handling","language":"Python","updated":"2025-05-28","comments":5,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-preserve-error-handling-context.md"},{"slug":"temporal-optimize-metrics-label-cardinality","title":"Optimize metrics label cardinality","description":"Carefully manage metric label cardinality to prevent excessive memory usage and maintain system performance. Follow these guidelines: 1. Separate high-cardinality metrics:","repository":"temporalio/temporal","domain":"orchestration","topic":"Observability","language":"Go","updated":"2025-05-28","comments":5,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-optimize-metrics-label-cardinality.md"},{"slug":"uv-balance-test-performance-considerations","title":"Balance test performance considerations","description":"When writing tests, consider both thoroughness and execution time. For operations with significant overhead (like Python installations, downloads, or filesystem operations), it's acceptable to consolidate multiple assertions into a single test.","repository":"astral-sh/uv","domain":"devtools","topic":"Testing","language":"Rust","updated":"2025-05-28","comments":4,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-balance-test-performance-considerations.md"},{"slug":"fiber-prefer-standard-library-functions","title":"Prefer standard library functions","description":"When implementing algorithms, prioritize using standard library functions over manual implementations when they provide equivalent or better performance. The standard library is typically optimized and well-tested, making it a more reliable choice for common operations.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Algorithms","language":"Go","updated":"2025-05-28","comments":3,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-prefer-standard-library-functions.md"},{"slug":"react-router-http-protocol-compliance","title":"HTTP protocol compliance","description":"Ensure code adheres to HTTP protocol standards and handles different protocol versions correctly. This includes respecting protocol limitations, using appropriate status codes, and implementing proper fallbacks.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Networking","language":"TypeScript","updated":"2025-05-28","comments":3,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-http-protocol-compliance.md"},{"slug":"bun-thread-safe-state-transitions","title":"Thread-safe state transitions","description":"When modifying shared state in multithreaded code, implement proper checks and state transitions to prevent race conditions. This applies to flags, counters, and resource management.","repository":"oven-sh/bun","domain":"runtimes","topic":"Concurrency","language":"C++","updated":"2025-05-28","comments":2,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-thread-safe-state-transitions.md"},{"slug":"kilocode-document-performance-tool-lifecycle","title":"Document performance tool lifecycle","description":"When creating performance optimization tools, especially temporary dev-only utilities, clearly document their purpose, scope, and removal criteria in the README or documentation. This helps teams make informed decisions about maintenance vs. performance benefits over time.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Performance Optimization","language":"Markdown","updated":"2025-05-28","comments":2,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-document-performance-tool-lifecycle.md"},{"slug":"playwright-api-consistency-and-decoupling","title":"API consistency and decoupling","description":"APIs should maintain consistent behavior and avoid tight coupling to implementation details or environmental dependencies. Don't make API methods conditionally available based on state, and avoid exposing filesystem paths or other environment-specific concerns in component interfaces.","repository":"microsoft/playwright","domain":"devtools","topic":"API","language":"TSX","updated":"2025-05-28","comments":2,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-api-consistency-and-decoupling.md"},{"slug":"playwright-justify-dependency-changes","title":"Justify dependency changes","description":"Always provide clear justification when modifying dependency configurations, including version updates, dependency types, or new additions. Consider the impact on stability, compatibility, and end users before making changes.","repository":"microsoft/playwright","domain":"devtools","topic":"Configurations","language":"Json","updated":"2025-05-28","comments":2,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-justify-dependency-changes.md"},{"slug":"pytorch-choose-appropriate-pointer-types","title":"Choose appropriate pointer types","description":"Select the right pointer type based on ownership semantics to prevent null reference issues and memory leaks. Follow these guidelines: 1. Use smart pointers (`shared_ptr`, `unique_ptr`) when ownership transfer is needed","repository":"pytorch/pytorch","domain":"ml-systems","topic":"Null Handling","language":"Other","updated":"2025-05-28","comments":2,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-choose-appropriate-pointer-types.md"},{"slug":"runtime-enable-configurable-instrumentation","title":"Enable configurable instrumentation","description":"Always provide configurable options for performance instrumentation and hardware acceleration in your codebase. These options should be clearly documented and defaulted appropriately for common scenarios.","repository":"dotnet/runtime","domain":"runtimes","topic":"Performance Optimization","language":"Other","updated":"2025-05-28","comments":2,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-enable-configurable-instrumentation.md"},{"slug":"union-validate-input-constraints","title":"validate input constraints","description":"Always validate user inputs against expected formats, constraints, and business rules before processing them. Implement explicit validation checks that fail fast with clear error messages when inputs don't meet requirements. This prevents security vulnerabilities from malformed or malicious inputs.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Security","language":"TypeScript","updated":"2025-05-28","comments":1,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-validate-input-constraints.md"},{"slug":"maplibre-native-follow-modern-c-guidelines","title":"Follow modern C++ guidelines","description":"Adhere to the C++ Core Guidelines for improved code quality, readability, and maintainability. Follow these key practices: 1. **Use enum class instead of regular enums** for type safety and scope:","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Code Style","language":"Other","updated":"2025-05-27","comments":11,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-follow-modern-c-guidelines.md"},{"slug":"ollama-follow-godoc-conventions","title":"Follow GoDoc conventions","description":"Document code following Go''s official documentation style guide (https://tip.golang.org/doc/comment). All exported functions, types, interfaces, and struct fields should have descriptive comments.","repository":"ollama/ollama","domain":"llm-infra","topic":"Documentation","language":"Go","updated":"2025-05-27","comments":8,"stars":145704,"raw":"https://awesomereviewers.com/raw/ollama-follow-godoc-conventions.md"},{"slug":"maplibre-native-modern-c-style-practices","title":"Modern C++ style practices","description":"Apply modern C++ features and consistent syntax patterns to improve code readability and safety. Follow these guidelines: 1. Use modern C++ features:","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Code Style","language":"C++","updated":"2025-05-27","comments":7,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-modern-c-style-practices.md"},{"slug":"opentofu-specify-configuration-behaviors","title":"Specify configuration behaviors","description":"When implementing configuration features (variables, flags, resources), thoroughly document their behavior in all scenarios, especially edge cases and interactions with dependencies. Configuration options should have well-defined and tested behaviors across all contexts where they might be used.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Configurations","language":"Markdown","updated":"2025-05-27","comments":7,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-specify-configuration-behaviors.md"},{"slug":"core-write-comprehensive-test-cases","title":"Write comprehensive test cases","description":"Tests should thoroughly cover all code paths and edge cases. Each test case should: 1. Test distinct scenarios in separate test cases 2. Cover all logical branches and code paths","repository":"vuejs/core","domain":"app-frameworks","topic":"Testing","language":"TypeScript","updated":"2025-05-27","comments":6,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-write-comprehensive-test-cases.md"},{"slug":"django-write-focused-efficient-tests","title":"Write focused efficient tests","description":"Tests should be focused, efficient and meaningful. Follow these guidelines: 1. Avoid testing implementation details or already-tested functionality 2. Use clear, direct assertions that test actual behavior","repository":"django/django","domain":"app-frameworks","topic":"Testing","language":"Python","updated":"2025-05-27","comments":6,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-write-focused-efficient-tests.md"},{"slug":"langchainjs-validate-untrusted-input","title":"Validate untrusted input","description":"Always validate and sanitize user-provided inputs before using them in sensitive contexts like SQL queries, file paths, or URL requests. This prevents SQL injection, path traversal, SSRF, and similar attacks.","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2025-05-27","comments":5,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-validate-untrusted-input.md"},{"slug":"maplibre-native-document-public-api-completely","title":"Document public API completely","description":"All public APIs (files in `include/`) must have comprehensive documentation using either Doxygen-style or triple-slash comments. Documentation should include:","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Documentation","language":"Other","updated":"2025-05-27","comments":5,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-document-public-api-completely.md"},{"slug":"ollama-use-idiomatic-go-flow","title":"Use idiomatic Go flow","description":"Follow Go''s idiomatic control flow patterns to improve code readability and maintainability. Key practices include: 1. Prefer early returns over else blocks","repository":"ollama/ollama","domain":"llm-infra","topic":"Code Style","language":"Go","updated":"2025-05-27","comments":5,"stars":145704,"raw":"https://awesomereviewers.com/raw/ollama-use-idiomatic-go-flow.md"},{"slug":"prowler-secure-authentication-flows","title":"Secure authentication flows","description":"Implement authentication flows that protect sensitive information and follow secure credential management practices: 1. **Prevent domain enumeration attacks** by returning consistent responses regardless of whether the input (like domain name) is valid:","repository":"prowler-cloud/prowler","domain":"security","topic":"Security","language":"Markdown","updated":"2025-05-27","comments":5,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-secure-authentication-flows.md"},{"slug":"temporal-dynamic-config-usage-principles","title":"Dynamic config usage principles","description":"Use dynamic configuration selectively and effectively by following these principles: 1. Only use dynamic config for values that need runtime modification:","repository":"temporalio/temporal","domain":"orchestration","topic":"Configurations","language":"Go","updated":"2025-05-27","comments":4,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-dynamic-config-usage-principles.md"},{"slug":"aider-standardize-model-access","title":"Standardize model access","description":"When integrating AI models into applications, provide consistent configuration methods that support different access patterns (direct API, chat interfaces, or intermediary services like LiteLLM).","repository":"Aider-AI/aider","domain":"ai-agents","topic":"AI","language":"Python","updated":"2025-05-27","comments":3,"stars":35856,"raw":"https://awesomereviewers.com/raw/aider-standardize-model-access.md"},{"slug":"lmcache-ensure-metadata-consistency","title":"Ensure metadata consistency","description":"Always persist metadata alongside data and implement proper checking mechanisms to prevent duplicates and ensure consistency in distributed storage scenarios. When writing data to storage backends, metadata should be written atomically with the data itself. Additionally, implement separate checking logic for existence vs. active operations to prevent race...","repository":"LMCache/LMCache","domain":"llm-infra","topic":"Database","language":"Python","updated":"2025-05-27","comments":3,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-ensure-metadata-consistency.md"},{"slug":"maplibre-native-group-related-properties","title":"Group related properties","description":"Design APIs by organizing related properties into purpose-specific structures rather than flat parameter lists. This improves clarity about which properties apply in different contexts, enhances API documentation, and makes interfaces more maintainable as they evolve.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"API","language":"Other","updated":"2025-05-27","comments":3,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-group-related-properties.md"},{"slug":"netty-consistent-dependency-declarations","title":"Consistent dependency declarations","description":"Ensure dependency declarations in build configuration files use concrete values rather than variables that may not resolve properly at build time. Maintain consistency between related configuration files (like BOM and aggregator POMs) to prevent build failures.","repository":"netty/netty","domain":"runtimes","topic":"Configurations","language":"Xml","updated":"2025-05-27","comments":3,"stars":34227,"raw":"https://awesomereviewers.com/raw/netty-consistent-dependency-declarations.md"},{"slug":"prisma-maintain-clean-ci-configuration","title":"maintain clean CI configuration","description":"Keep CI/CD configuration files clean and self-documenting by removing outdated comments, using descriptive parameter names, and avoiding redundant specifications. Remove TODO comments that no longer reflect the current state of the codebase, choose parameter names that clearly indicate their scope and purpose, and rely on existing configuration files (like...","repository":"prisma/prisma","domain":"data-systems","topic":"CI/CD","language":"Yaml","updated":"2025-05-27","comments":3,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-maintain-clean-ci-configuration.md"},{"slug":"react-native-catch-specific-exceptions","title":"catch specific exceptions","description":"Always catch specific exception types rather than generic `Exception` to avoid masking unexpected errors and ensure intentional error handling. This practice helps distinguish between expected failure scenarios that should be handled gracefully and unexpected errors that indicate bugs.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Error Handling","language":"Kotlin","updated":"2025-05-27","comments":3,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-catch-specific-exceptions.md"},{"slug":"volcano-document-technical-details-clearly","title":"Document technical details clearly","description":"Ensure all technical documentation provides clear explanations and follows proper formatting conventions. Technical parameters, configuration options, and complex concepts should include explanatory comments or descriptions to make them accessible to users and maintainers.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Documentation","language":"Markdown","updated":"2025-05-27","comments":3,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-document-technical-details-clearly.md"},{"slug":"bun-document-configuration-variations","title":"Document configuration variations","description":"When documenting or implementing configuration options, always include variations needed for different environments and use cases. Ensure that your configuration files, installation guides, and rule definitions cover all common scenarios.","repository":"oven-sh/bun","domain":"runtimes","topic":"Configurations","language":"Markdown","updated":"2025-05-27","comments":2,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-document-configuration-variations.md"},{"slug":"prometheus-leverage-standard-algorithms","title":"leverage standard algorithms","description":"When implementing common algorithmic tasks like string parsing, sorting, or comparison operations, prefer built-in utilities and standard library functions over custom implementations. Standard algorithms are typically more efficient, well-tested, and maintainable than custom solutions.","repository":"prometheus/prometheus","domain":"observability","topic":"Algorithms","language":"Shell","updated":"2025-05-27","comments":2,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-leverage-standard-algorithms.md"},{"slug":"react-native-optimize-ci-platform-builds","title":"Optimize CI platform builds","description":"When configuring CI/CD build pipelines, limit builds to only the platforms your project actively supports and avoid building for out-of-tree (OOT) platforms that maintain separate forks. This reduces unnecessary CI overhead and build times. Additionally, design your build configuration to support parallelization by allowing platforms to be passed as...","repository":"facebook/react-native","domain":"app-frameworks","topic":"CI/CD","language":"JavaScript","updated":"2025-05-27","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-optimize-ci-platform-builds.md"},{"slug":"azure-sdk-for-net-externalize-sensitive-credentials","title":"Externalize sensitive credentials","description":"Never hardcode sensitive values such as client identifiers, API keys, connection strings, or passwords directly in code or configuration files. Instead, use secure mechanisms like environment variables, secret managers, or pipeline variable groups to inject these values at runtime. This practice reduces the risk of credential exposure in version control...","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Security","language":"Yaml","updated":"2025-05-27","comments":1,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-externalize-sensitive-credentials.md"},{"slug":"quarkus-prefer-modern-security","title":"Prefer modern security","description":"When implementing security features (such as artifact signing), use current best practices and prefer pure-Java security libraries over native executables whenever possible. This approach simplifies configuration, improves portability, and reduces security risks associated with native executable dependencies and their complex configurations.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Security","language":"Xml","updated":"2025-05-27","comments":1,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-prefer-modern-security.md"},{"slug":"volcano-document-security-implications","title":"Document security implications","description":"When writing documentation that involves handling sensitive data or security-related operations, always include explicit warnings about security implications and provide references to security best practices. Users may not be aware of default security behaviors that could expose sensitive information.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Security","language":"Markdown","updated":"2025-05-27","comments":1,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-document-security-implications.md"},{"slug":"langchainjs-typescript-naming-standards","title":"TypeScript naming standards","description":"Follow consistent naming conventions in TypeScript to improve code clarity, type safety, and developer experience: 1. **Capitalize types and interfaces**: All type and interface names should start with an uppercase letter.","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2025-05-26","comments":10,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-typescript-naming-standards.md"},{"slug":"v-improve-code-clarity","title":"Improve code clarity","description":"Write code that clearly expresses intent through explicit patterns, simplified logic, and readable structure. Avoid unnecessary complexity that obscures the code's purpose.","repository":"vlang/v","domain":"runtimes","topic":"Code Style","language":"Other","updated":"2025-05-26","comments":10,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-improve-code-clarity.md"},{"slug":"influxdb-minimize-critical-path-allocations","title":"Minimize critical path allocations","description":"Avoid unnecessary memory allocations in performance-critical code paths. These allocations not only consume memory but also trigger expensive CPU operations that can significantly impact system performance.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Performance Optimization","language":"Rust","updated":"2025-05-26","comments":8,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-minimize-critical-path-allocations.md"},{"slug":"uv-redact-url-credentials","title":"Redact URL credentials","description":"Always redact sensitive credentials in URLs before logging, displaying in error messages, or serializing to prevent accidental exposure of authentication information. Use dedicated wrapper types like `LogSafeUrl` that automatically handle credential redaction when displaying URLs:","repository":"astral-sh/uv","domain":"devtools","topic":"Security","language":"Rust","updated":"2025-05-26","comments":7,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-redact-url-credentials.md"},{"slug":"langchainjs-eliminate-redundant-code","title":"Eliminate redundant code","description":"Simplify code by eliminating redundancy and unnecessary complexity. This improves readability, reduces potential bugs, and makes the codebase easier to maintain.","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2025-05-26","comments":4,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-eliminate-redundant-code.md"},{"slug":"lobe-chat-configuration-file-consistency","title":"Configuration file consistency","description":"Ensure configuration values are consistent and properly coordinated across all related files (docker-compose, .env files, initialization scripts, workflows, etc.). Verify that port mappings, environment variables, and tokens don't conflict between files, and provide fallback configurations for critical settings.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Configurations","language":"Yaml","updated":"2025-05-26","comments":3,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-configuration-file-consistency.md"},{"slug":"ollama-complete-null-checks","title":"Complete null checks","description":"Always perform thorough null checks before dereferencing pointers, and ensure all operations on potentially null objects are contained within the null check block. This prevents null pointer dereferences and undefined behavior.","repository":"ollama/ollama","domain":"llm-infra","topic":"Null Handling","language":"C++","updated":"2025-05-26","comments":3,"stars":145705,"raw":"https://awesomereviewers.com/raw/ollama-complete-null-checks.md"},{"slug":"opencv-feature-flag-convention","title":"Feature flag convention","description":"Establish a consistent pattern for feature flags and dependency management in configuration files: 1. Use `WITH_*` or `OPENCV_ENABLE_*` variables to represent user intentions (features to enable if available)","repository":"opencv/opencv","domain":"ml-systems","topic":"Configurations","language":"Txt","updated":"2025-05-26","comments":3,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-feature-flag-convention.md"},{"slug":"polars-feature-flag-compatibility","title":"Feature flag compatibility","description":"Design code to work correctly with any combination of feature flags. When implementing conditional compilation with feature flags: 1. Use conditional imports for dependencies that are only needed when certain features are enabled:","repository":"pola-rs/polars","domain":"data-systems","topic":"Configurations","language":"Rust","updated":"2025-05-26","comments":3,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-feature-flag-compatibility.md"},{"slug":"volcano-secure-configuration-practices","title":"Secure configuration practices","description":"Implement secure configuration practices to protect sensitive data and prevent security vulnerabilities. This includes three key areas: 1. **Credential Protection**: Never store or transmit passwords and sensitive credentials in plain text. Use encryption tools, secure credential management systems, or environment variables with proper access controls.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Security","language":"Go","updated":"2025-05-26","comments":3,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-secure-configuration-practices.md"},{"slug":"langchainjs-match-configuration-documentation","title":"Match configuration documentation","description":"Configuration documentation must accurately reflect implementation details and behavior. Ensure that: 1. Code examples in documentation use the exact same property names and structure as the actual implementation","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2025-05-26","comments":2,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-match-configuration-documentation.md"},{"slug":"ollama-optimize-memory-allocations","title":"Optimize memory allocations","description":"Be strategic about memory allocations to improve performance in your C++ code. Consider two key optimization patterns: 1. **Pre-reserve container capacity**: When using containers like vectors that will grow to a predictable size, use `reserve()` with a reasonable initial capacity to reduce allocation overhead. This prevents multiple small reallocations as...","repository":"ollama/ollama","domain":"llm-infra","topic":"Performance Optimization","language":"C++","updated":"2025-05-26","comments":2,"stars":145705,"raw":"https://awesomereviewers.com/raw/ollama-optimize-memory-allocations.md"},{"slug":"opentofu-clear-relationship-descriptions","title":"Clear relationship descriptions","description":"When documenting algorithms or data structures with graph-like relationships, use precise terminology to describe connections between elements. This is especially important when explaining how operations traverse or transform structured data.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Algorithms","language":"Markdown","updated":"2025-05-26","comments":2,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-clear-relationship-descriptions.md"},{"slug":"appwrite-synchronize-configuration-values","title":"Synchronize configuration values","description":"Ensure all configuration values, particularly version numbers and environment variables, are consistent across related files to prevent subtle bugs and deployment issues. When updating configurations:","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2025-05-25","comments":6,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-synchronize-configuration-values.md"},{"slug":"comfyui-optimize-tensor-operation-chains","title":"Optimize tensor operation chains","description":"When working with PyTorch tensors, look for opportunities to optimize operation chains for better performance and memory efficiency. This involves two key strategies:","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Pytorch","language":"Python","updated":"2025-05-25","comments":2,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-optimize-tensor-operation-chains.md"},{"slug":"tree-sitter-cross-platform-configuration-examples","title":"Cross-platform configuration examples","description":"Ensure configuration examples and documentation work across different operating systems and clearly distinguish between required and optional configuration steps. Avoid platform-specific syntax that may not work universally, and explicitly state when configuration steps are optional versus mandatory.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Configurations","language":"Markdown","updated":"2025-05-25","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-cross-platform-configuration-examples.md"},{"slug":"helix-prefer-let-else-patterns","title":"prefer let-else patterns","description":"When handling Option types that require early returns on None values, prefer the let-else pattern over verbose match statements or if-let constructs. This pattern improves code readability, reduces nesting, and makes the control flow more explicit.","repository":"helix-editor/helix","domain":"devtools","topic":"Null Handling","language":"Rust","updated":"2025-05-24","comments":6,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-prefer-let-else-patterns.md"},{"slug":"openpilot-use-environment-variables","title":"Use environment variables","description":"Make configuration values configurable through environment variables with sensible defaults instead of hard-coding them. This improves flexibility and testability while maintaining backward compatibility.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Configurations","language":"Python","updated":"2025-05-24","comments":5,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-use-environment-variables.md"},{"slug":"prettier-validate-configuration-values","title":"validate configuration values","description":"Always validate configuration values and provide clear, actionable error messages when validation fails. Handle invalid values gracefully by either ignoring them or providing sensible defaults, and validate that configuration options are used in the correct context.","repository":"prettier/prettier","domain":"devtools","topic":"Configurations","language":"JavaScript","updated":"2025-05-24","comments":5,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-validate-configuration-values.md"},{"slug":"quarkus-prefer-optional-over-nulls","title":"Prefer Optional over nulls","description":"Use Java''s Optional API instead of null checks to improve code readability, safety, and maintainability. When dealing with potentially absent values:","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Null Handling","language":"Java","updated":"2025-05-24","comments":5,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-prefer-optional-over-nulls.md"},{"slug":"union-effect-based-api-clients","title":"Effect-based API clients","description":"Use Effect-based HTTP clients with specific error types instead of throwing generic exceptions or relying on third-party HTTP libraries like axios. API functions should return Effects with proper error types rather than throwing errors, enabling better error handling and composability.","repository":"unionlabs/union","domain":"cloud-infra","topic":"API","language":"TypeScript","updated":"2025-05-24","comments":4,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-effect-based-api-clients.md"},{"slug":"argo-cd-wrap-errors-with-context","title":"Wrap errors with context","description":"When propagating errors up the call stack, always wrap them with contextual information about the failing operation using fmt.Errorf with the %w verb. This practice significantly improves debugging by providing a clear trail of what operations were being performed when the error occurred.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Error Handling","language":"Go","updated":"2025-05-23","comments":8,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-wrap-errors-with-context.md"},{"slug":"mermaid-consistent-readability-rules","title":"Consistent Readability Rules","description":"Code should be readable and consistent: avoid inline “magic” expressions, prefer named values/helpers, and use uniform style primitives. Apply: - Replace inline calculations with a named variable/helper when the expression is meaningful or potentially repeated:","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Code Style","language":"Other","updated":"2025-05-23","comments":8,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-consistent-readability-rules.md"},{"slug":"rails-database-specific-query-optimization","title":"Database-specific query optimization","description":"Leverage database-specific features to optimize queries and improve performance. Different database engines have unique capabilities that can significantly enhance query efficiency when used appropriately.","repository":"rails/rails","domain":"app-frameworks","topic":"Database","language":"Ruby","updated":"2025-05-23","comments":7,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-database-specific-query-optimization.md"},{"slug":"azure-quickstart-templates-implicit-dependencies-only","title":"Implicit Dependencies Only","description":"For CI/CD stability and to avoid Bicep linter/build failures, do not add explicit `dependsOn` entries when Bicep can infer the dependency. **Rule** - **Remove unnecessary `dependsOn`** when the deployment order is already implied by:","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"CI/CD","language":"Other","updated":"2025-05-23","comments":5,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-implicit-dependencies-only.md"},{"slug":"langchainjs-documentation-completeness-check","title":"Documentation completeness check","description":"Ensure all documentation is complete, well-formatted, and maximally useful for developers. This includes: 1. **Use proper markdown syntax** for headings, lists, code blocks, and other formatting elements to ensure documents render correctly.","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Documentation","language":"Markdown","updated":"2025-05-23","comments":3,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-documentation-completeness-check.md"},{"slug":"maplibre-native-design-evolution-ready-apis","title":"Design evolution-ready APIs","description":"Design APIs that are both explicit in their usage and provide clear evolution paths. When designing APIs: 1. Prefer structured objects with named fields over primitive collections or multiple parameters to improve clarity and self-documentation","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"API","language":"Java","updated":"2025-05-23","comments":3,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-design-evolution-ready-apis.md"},{"slug":"mermaid-declarative-vue-component-data","title":"Declarative Vue Component Data","description":"In Vue SFCs, keep templates declarative and driven by explicit data. **Rules** 1. **Put static/config data in `<script setup>`**: define typed constants/arrays in the script rather than building or embedding data via template expressions.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Vue","language":"Other","updated":"2025-05-23","comments":3,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-declarative-vue-component-data.md"},{"slug":"prowler-use-configuration-placeholders","title":"Use configuration placeholders","description":"Avoid hardcoding specific values like regions, timeframes, or identifiers in configuration commands, examples, or settings. Instead, use descriptive placeholders that clearly indicate the type of value required. This practice:","repository":"prowler-cloud/prowler","domain":"security","topic":"Configurations","language":"Json","updated":"2025-05-23","comments":3,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-use-configuration-placeholders.md"},{"slug":"crewai-functional-code-examples","title":"Functional code examples","description":"Ensure all code examples in documentation are complete, accurate, and ready to run without modification. Since developers frequently copy and paste examples directly into their projects, include all required parameters and follow consistent patterns.","repository":"crewaiinc/crewai","domain":"ai-agents","topic":"Documentation","language":"Other","updated":"2025-05-23","comments":2,"stars":33945,"raw":"https://awesomereviewers.com/raw/crewai-functional-code-examples.md"},{"slug":"dify-document-configuration-choices","title":"Document configuration choices","description":"Configuration scripts and files should clearly document non-obvious choices, especially numeric IDs, special values, and environment-specific commands. Include comments explaining the purpose and reasoning behind configuration decisions to help future maintainers understand why specific values or approaches were chosen.","repository":"langgenius/dify","domain":"llm-infra","topic":"Configurations","language":"Shell","updated":"2025-05-23","comments":2,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-document-configuration-choices.md"},{"slug":"mermaid-preserve-api-contracts","title":"Preserve API Contracts","description":"When an endpoint or syntax is already used as a contract (e.g., chart grammar shared across features, or a stateful editor URL), avoid creating parallel interfaces or polluting the contract with unrelated concerns.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"API","language":"Other","updated":"2025-05-23","comments":2,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-preserve-api-contracts.md"},{"slug":"neon-modern-shell-syntax","title":"Modern shell syntax","description":"Prefer double brackets (`[[ ]]`) over single brackets (`[ ]`) in shell scripts for improved functionality and consistency. While double brackets don''t strictly require quotes around variables, maintaining consistent quoting practice is recommended even with double brackets:","repository":"neondatabase/neon","domain":"data-systems","topic":"Code Style","language":"Yaml","updated":"2025-05-23","comments":2,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-modern-shell-syntax.md"},{"slug":"react-native-avoid-unnecessary-allocations","title":"avoid unnecessary allocations","description":"When implementing algorithms and data structure operations, avoid unnecessary memory allocations, object creation, and data copying that can impact performance. Look for opportunities to leverage existing objects, references, and lazy evaluation patterns.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Algorithms","language":"C++","updated":"2025-05-23","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-avoid-unnecessary-allocations.md"},{"slug":"runtime-memory-barrier-pairing","title":"Memory barrier pairing","description":"When implementing low-level synchronization mechanisms in multi-threaded code, ensure that memory barriers are correctly paired between reader and writer operations. For each read barrier, implement a corresponding write barrier to maintain memory consistency and prevent race conditions.","repository":"dotnet/runtime","domain":"runtimes","topic":"Concurrency","language":"Other","updated":"2025-05-23","comments":2,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-memory-barrier-pairing.md"},{"slug":"volcano-review-security-permissions","title":"Review security permissions","description":"Carefully review all security permissions and privileges to ensure they follow the principle of least privilege. Avoid coupling unrelated permissions together and verify that elevated privileges are truly necessary.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Security","language":"Yaml","updated":"2025-05-23","comments":2,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-review-security-permissions.md"},{"slug":"mermaid-bundle-static-assets","title":"Bundle Static Assets","description":"Avoid directly linking UI/static assets (e.g., icons, images) to external domains. Keep them inside the repository and reference them via local paths so builds don’t depend on third-party availability, reduce tracking/privacy exposure, and minimize supply-chain risk.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Security","language":"Other","updated":"2025-05-23","comments":1,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-bundle-static-assets.md"},{"slug":"framework-optimize-for-code-readability","title":"Optimize for code readability","description":"Prioritize code readability over clever solutions by: 1. Using early returns to reduce nesting 2. Leveraging modern PHP features when they improve clarity","repository":"laravel/framework","domain":"app-frameworks","topic":"Code Style","language":"PHP","updated":"2025-05-22","comments":10,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-optimize-for-code-readability.md"},{"slug":"fiber-check-all-error-returns","title":"check all error returns","description":"Always check and handle error returns from function calls, even for operations that seem unlikely to fail. Ignoring errors can lead to silent failures, resource leaks, and unpredictable behavior in production.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Error Handling","language":"Go","updated":"2025-05-22","comments":7,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-check-all-error-returns.md"},{"slug":"langfuse-validate-all-inputs","title":"Validate all inputs","description":"All user-controlled inputs must be validated and sanitized before use to prevent injection attacks, unauthorized access, and other security vulnerabilities. This includes query parameters, environment variables, URLs, and database values.","repository":"langfuse/langfuse","domain":"observability","topic":"Security","language":"TypeScript","updated":"2025-05-22","comments":5,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-validate-all-inputs.md"},{"slug":"swe-agent-explicit-configuration-validation","title":"Explicit configuration validation","description":"Avoid using configuration values as implicit feature flags or logic triggers. Instead, validate configuration explicitly and make behavior predictable.","repository":"SWE-agent/SWE-agent","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2025-05-22","comments":5,"stars":16839,"raw":"https://awesomereviewers.com/raw/swe-agent-explicit-configuration-validation.md"},{"slug":"framework-optimize-loop-operations","title":"Optimize loop operations","description":"When writing loops, optimize for both readability and performance by following these key principles: 1. **Exit early** when a decision can be made: ```php","repository":"laravel/framework","domain":"app-frameworks","topic":"Algorithms","language":"PHP","updated":"2025-05-22","comments":4,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-optimize-loop-operations.md"},{"slug":"langchainjs-use-database-native-types","title":"Use database-native types","description":"Always leverage database-native data types and appropriate schema design to maximize performance and query capabilities. This includes: 1. Use database-specific type bindings when available instead of generic formats:","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Database","language":"TypeScript","updated":"2025-05-22","comments":4,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-use-database-native-types.md"},{"slug":"opengrep-prefer-built-in-error-utilities","title":"prefer built-in error utilities","description":"Use existing error handling utilities and appropriate error mechanisms instead of implementing manual error handling logic. This reduces code complexity, improves maintainability, and leverages well-tested library functions.","repository":"opengrep/opengrep","domain":"security","topic":"Error Handling","language":"Other","updated":"2025-05-22","comments":4,"stars":1546,"raw":"https://awesomereviewers.com/raw/opengrep-prefer-built-in-error-utilities.md"},{"slug":"supabase-document-intent-clearly","title":"Document intent clearly","description":"Add clear documentation that explains not just what code does, but why certain approaches were chosen. This applies to: 1. **Complex code sections**: Add explanatory comments to complex logic, particularly SQL queries","repository":"supabase/supabase","domain":"data-systems","topic":"Documentation","language":"TSX","updated":"2025-05-22","comments":4,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-document-intent-clearly.md"},{"slug":"appwrite-validate-configuration-formatting","title":"Validate configuration formatting","description":"Ensure all JSON configuration files adhere to proper syntax and formatting conventions. Common issues to avoid include: 1. **Invalid key-value syntax**: All JSON properties must use proper key-value format with double-quoted keys.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Code Style","language":"Json","updated":"2025-05-22","comments":3,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-validate-configuration-formatting.md"},{"slug":"langfuse-consistent-database-naming","title":"Consistent database naming","description":"Maintain consistent naming patterns across all database objects. Ensure that: 1. Related object names are aligned (e.g., indexes should reference their table names)","repository":"langfuse/langfuse","domain":"observability","topic":"Naming Conventions","language":"Sql","updated":"2025-05-22","comments":3,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-consistent-database-naming.md"},{"slug":"mastodon-optimize-network-configurations","title":"optimize network configurations","description":"Optimize network configurations by eliminating redundancy, using modern compression standards, and properly configuring load balancing. This includes setting sensible defaults to avoid duplicative parameters, leveraging efficient compression algorithms like zstd alongside gzip for better data transfer, and implementing proper load balancing with health...","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Networking","language":"Other","updated":"2025-05-22","comments":3,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-optimize-network-configurations.md"},{"slug":"nx-security-terminology-consistency","title":"Security terminology consistency","description":"Ensure consistent formatting and precise terminology when documenting security-related concepts, access controls, and system boundaries. Inconsistent or imprecise language in security documentation can lead to misunderstandings about permissions, access patterns, and security mechanisms.","repository":"nrwl/nx","domain":"devtools","topic":"Security","language":"Markdown","updated":"2025-05-22","comments":3,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-security-terminology-consistency.md"},{"slug":"electron-extract-reusable-workflow-components","title":"extract reusable workflow components","description":"Avoid duplicating workflow steps across multiple CI/CD pipelines by extracting common functionality into reusable actions. This improves maintainability, reduces inconsistencies, and ensures proper cross-platform compatibility when needed.","repository":"electron/electron","domain":"devtools","topic":"CI/CD","language":"Yaml","updated":"2025-05-22","comments":2,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-extract-reusable-workflow-components.md"},{"slug":"istio-validate-access-scope","title":"validate access scope","description":"When implementing security features that involve access control, authentication, or authorization, carefully validate that the changes don't inadvertently grant broader access than intended. This is particularly critical when dealing with secret access, trust domains, or credential handling.","repository":"istio/istio","domain":"orchestration","topic":"Security","language":"Go","updated":"2025-05-22","comments":2,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-validate-access-scope.md"},{"slug":"nx-cache-isolation-boundaries","title":"cache isolation boundaries","description":"When documenting caching systems, clearly specify cache isolation boundaries and access scopes to prevent confusion about cache behavior. Distinguish between global shared caches and isolated caches, and explain how different access levels affect cache storage and retrieval patterns.","repository":"nrwl/nx","domain":"devtools","topic":"Caching","language":"Markdown","updated":"2025-05-22","comments":2,"stars":27518,"raw":"https://awesomereviewers.com/raw/nx-cache-isolation-boundaries.md"},{"slug":"refact-ensure-semantic-naming-clarity","title":"Ensure semantic naming clarity","description":"Names should clearly communicate their actual behavior and preserve sufficient context for meaningful identification. For functions with conditional behavior, use descriptive suffixes like `_if_needed` or `_maybe` to indicate optionality. For paths and identifiers, maintain enough context to ensure usability - avoid over-shortening that removes essential...","repository":"smallcloudai/refact","domain":"ai-agents","topic":"Naming Conventions","language":"Rust","updated":"2025-05-22","comments":2,"stars":3114,"raw":"https://awesomereviewers.com/raw/refact-ensure-semantic-naming-clarity.md"},{"slug":"terminal-unicode-homoglyph-validation","title":"Unicode homoglyph validation","description":"Validate Unicode characters and detect potential homoglyph attacks where visually similar characters from different scripts could be used maliciously. Avoid overly broad patterns that automatically allow non-ASCII characters without proper validation, as these can hide security vulnerabilities.","repository":"microsoft/terminal","domain":"devtools","topic":"Security","language":"Txt","updated":"2025-05-22","comments":1,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-unicode-homoglyph-validation.md"},{"slug":"bazel-simplify-complex-code","title":"Simplify complex code","description":"Break down complex code structures into simpler, more readable forms to improve maintainability and reduce cognitive load. This involves several key practices:","repository":"bazelbuild/bazel","domain":"devtools","topic":"Code Style","language":"Java","updated":"2025-05-21","comments":15,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-simplify-complex-code.md"},{"slug":"bazel-executor-service-lifecycle","title":"Executor service lifecycle","description":"Properly manage executor service lifecycle to prevent resource leaks, deadlocks, and orphaned threads that can cause system inconsistencies. Key practices:","repository":"bazelbuild/bazel","domain":"devtools","topic":"Concurrency","language":"Java","updated":"2025-05-21","comments":7,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-executor-service-lifecycle.md"},{"slug":"helix-use-descriptive-names","title":"use descriptive names","description":"Choose specific, purpose-revealing names that clearly communicate intent rather than generic, abbreviated, or ambiguous terms. Names should describe what something does or represents, not what it doesn't do.","repository":"helix-editor/helix","domain":"devtools","topic":"Naming Conventions","language":"Rust","updated":"2025-05-21","comments":7,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-use-descriptive-names.md"},{"slug":"gin-document-code-behavior","title":"Document code behavior","description":"Document the \"why\" and \"how\" of your code, not just what it does. Add clear comments to explain: 1. Non-obvious behaviors and edge cases 2. Special input handling and transformations","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"Documentation","language":"Go","updated":"2025-05-21","comments":6,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-document-code-behavior.md"},{"slug":"material-ui-use-theme-utilities-consistently","title":"Use theme utilities consistently","description":"Always use theme utilities for consistent styling across the application instead of hard-coded values. Replace direct pixel values with theme functions like `theme.spacing()` for spacing, and access theme variables directly with `theme.vars.*` for theme-aware styling:","repository":"mui/material-ui","domain":"app-frameworks","topic":"Code Style","language":"JavaScript","updated":"2025-05-21","comments":6,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-use-theme-utilities-consistently.md"},{"slug":"drizzle-orm-prefer-nullish-coalescing-operator","title":"prefer nullish coalescing operator","description":"Use the nullish coalescing operator (`??`) instead of the logical OR operator (`||`) when you specifically want to provide fallback values only for `null` or `undefined`, not for other falsy values.","repository":"drizzle-team/drizzle-orm","domain":"data-systems","topic":"Null Handling","language":"TypeScript","updated":"2025-05-21","comments":5,"stars":29461,"raw":"https://awesomereviewers.com/raw/drizzle-orm-prefer-nullish-coalescing-operator.md"},{"slug":"influxdb-maintain-code-readability","title":"Maintain code readability","description":"Ensure code remains readable and maintainable by following these practices: 1. **Combine case statements with identical outcomes** to reduce duplication. When multiple cases have identical code blocks, group them together:","repository":"influxdata/influxdb","domain":"data-systems","topic":"Code Style","language":"Go","updated":"2025-05-21","comments":5,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-maintain-code-readability.md"},{"slug":"neon-document-concurrency-design-decisions","title":"Document concurrency design decisions","description":"Always document key concurrency design decisions in code, including: 1. Locking protocols and ordering between multiple locks 2. Assumptions about data access patterns and thread safety","repository":"neondatabase/neon","domain":"data-systems","topic":"Concurrency","language":"Rust","updated":"2025-05-21","comments":5,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-document-concurrency-design-decisions.md"},{"slug":"browser-use-validate-llm-reliability","title":"validate LLM reliability","description":"Always validate LLM capabilities before deployment and implement robust handling for unreliable responses. LLMs can vary significantly in capability and may return empty, invalid, or hallucinated responses that can break your application.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"AI","language":"Python","updated":"2025-05-21","comments":4,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-validate-llm-reliability.md"},{"slug":"supabase-follow-hooks-rules","title":"Follow hooks rules","description":"Adhere strictly to React hooks rules and best practices to ensure your components behave correctly and predictably. Common issues include: 1. **Manage dependencies properly**: Always include all dependencies in useEffect/useCallback dependency arrays or use useLatest() for values you intentionally exclude to prevent stale data issues.","repository":"supabase/supabase","domain":"data-systems","topic":"React","language":"TSX","updated":"2025-05-21","comments":4,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-follow-hooks-rules.md"},{"slug":"vitess-metric-design-best-practices","title":"Metric design best practices","description":"Design metrics to be reliable and maintainable by following these key principles: 1. Initialize metrics with zero values to ensure consistent existence:","repository":"vitessio/vitess","domain":"data-systems","topic":"Observability","language":"Go","updated":"2025-05-21","comments":4,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-metric-design-best-practices.md"},{"slug":"brew-use-ascii-only-urls","title":"Use ASCII-only URLs","description":"URLs in code should exclusively use ASCII characters for maximum security and compatibility. This prevents potential security vulnerabilities like homograph attacks and ensures consistent behavior across systems.","repository":"Homebrew/brew","domain":"devtools","topic":"Networking","language":"Ruby","updated":"2025-05-21","comments":3,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-use-ascii-only-urls.md"},{"slug":"neon-configurable-cache-parameters","title":"Configurable cache parameters","description":"Cache configurations should be runtime-configurable rather than hardcoded, with support for dynamic resizing when configuration changes. This practice improves adaptability to varying workloads and environments without requiring service restarts.","repository":"neondatabase/neon","domain":"data-systems","topic":"Caching","language":"Rust","updated":"2025-05-21","comments":3,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-configurable-cache-parameters.md"},{"slug":"pydantic-documentation-formatting-standards","title":"Documentation formatting standards","description":"Maintain consistent documentation formatting to ensure proper rendering and readability. Follow these key practices: 1. **Consistent code output display**: Standardize how objects are printed in examples. Either use `print(<inst>)` or `print(repr(<inst>))` consistently throughout the documentation.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Code Style","language":"Markdown","updated":"2025-05-21","comments":3,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-documentation-formatting-standards.md"},{"slug":"cal.com-optimize-component-memoization","title":"optimize component memoization","description":"When implementing React.memo for performance optimization, ensure props are structured to enable effective memoization. Pass individual primitive props separately rather than complex objects to allow React.memo to correctly detect unchanged props and prevent unnecessary re-renders.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Performance Optimization","language":"TSX","updated":"2025-05-21","comments":2,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-optimize-component-memoization.md"},{"slug":"cline-avoid-unnecessary-custom-hooks","title":"avoid unnecessary custom hooks","description":"Before creating custom hooks, evaluate whether existing solutions or simpler patterns can address the need. Custom hooks should provide clear value beyond what's available through established libraries, built-in React patterns, or direct component logic.","repository":"cline/cline","domain":"ai-agents","topic":"React","language":"TypeScript","updated":"2025-05-21","comments":2,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-avoid-unnecessary-custom-hooks.md"},{"slug":"grafana-workflow-permission-boundaries","title":"Workflow permission boundaries","description":"Always define explicit and minimal permission boundaries in GitHub Actions workflows to adhere to the principle of least privilege. By default, workflows have broad permissions that could be exploited if compromised. Specify permissions at either the workflow or job level to restrict the GITHUB_TOKEN to only required access levels.","repository":"grafana/grafana","domain":"observability","topic":"Security","language":"Yaml","updated":"2025-05-21","comments":2,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-workflow-permission-boundaries.md"},{"slug":"mastodon-documentation-audience-appropriateness","title":"Documentation audience appropriateness","description":"Ensure documentation content matches its intended audience and location. High-level documentation like README files should focus on essential information for the primary audience, while detailed technical information should be placed in developer-specific documentation. Avoid adding overly detailed or redundant information that may confuse or overwhelm...","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-05-21","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-documentation-audience-appropriateness.md"},{"slug":"openpilot-use-authoritative-data-sources","title":"Use authoritative data sources","description":"When working with network-related data, always read from the most direct and authoritative source available rather than making assumptions or relying on indirect indicators. This ensures accuracy and robustness in network operations.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Networking","language":"Other","updated":"2025-05-21","comments":2,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-use-authoritative-data-sources.md"},{"slug":"bazel-configuration-clarity-standards","title":"Configuration clarity standards","description":"Configuration options should be designed with clarity, consistency, and user experience as primary concerns. This includes several key practices: **Clear and specific help text**: Flag descriptions should explicitly explain their purpose and scope to avoid user confusion. For example, instead of generic descriptions, be specific about when and how the flag...","repository":"bazelbuild/bazel","domain":"devtools","topic":"Configurations","language":"Java","updated":"2025-05-20","comments":7,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-configuration-clarity-standards.md"},{"slug":"boto3-defensive-null-value-handling","title":"Defensive null value handling","description":"Always handle potential null/None values defensively by: 1. Using `.get()` for dictionary access instead of direct key access 2. Checking for None/falsy values before accessing their properties","repository":"boto/boto3","domain":"cloud-infra","topic":"Null Handling","language":"Python","updated":"2025-05-20","comments":7,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-defensive-null-value-handling.md"},{"slug":"svelte-measure-performance-impact","title":"Measure performance impact","description":"Before making performance-related changes, measure the actual impact with benchmarks and profiling. Many performance assumptions can be misleading without data.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Performance Optimization","language":"JavaScript","updated":"2025-05-20","comments":7,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-measure-performance-impact.md"},{"slug":"chef-choose-semantic-algorithms","title":"Choose semantic algorithms","description":"Select algorithms and data operations that match the semantic intent of your code rather than using convenient but potentially problematic approaches. For operations like version comparisons, string parsing, and collection filtering, choose specialized methods over generic ones.","repository":"chef/chef","domain":"cloud-infra","topic":"Algorithms","language":"Ruby","updated":"2025-05-20","comments":6,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-choose-semantic-algorithms.md"},{"slug":"opencv-guard-optional-dependencies","title":"Guard optional dependencies","description":"Configuration management requires careful handling of optional dependencies in both build scripts and source code. Always guard code that depends on optional modules or libraries with appropriate feature guards, and check for component existence before using them.","repository":"opencv/opencv","domain":"ml-systems","topic":"Configurations","language":"Other","updated":"2025-05-20","comments":5,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-guard-optional-dependencies.md"},{"slug":"signoz-use-appropriate-error-types","title":"Use appropriate error types","description":"Always use semantically correct error types and codes that match the actual failure scenario. This ensures proper error handling by callers and consistent API behavior across the system.","repository":"SigNoz/signoz","domain":"observability","topic":"Error Handling","language":"Go","updated":"2025-05-20","comments":5,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-use-appropriate-error-types.md"},{"slug":"tokio-structure-feature-flags-strategically","title":"Structure feature flags strategically","description":"Design feature flags to minimize dependency bloat while maximizing flexibility for users. Each optional dependency should be tied to a specific feature flag, allowing users to enable only the functionality they need.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Configurations","language":"Toml","updated":"2025-05-20","comments":5,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-structure-feature-flags-strategically.md"},{"slug":"gin-consistent-error-patterns","title":"Consistent error patterns","description":"Implement consistent error handling patterns throughout your codebase to improve readability and maintainability. **Key guidelines:** 1. Use named error variables instead of inline error creation","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"Error Handling","language":"Go","updated":"2025-05-20","comments":4,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-consistent-error-patterns.md"},{"slug":"material-ui-distinguish-nextjs-routers","title":"Distinguish Next.js routers","description":"Always provide separate implementation instructions for Next.js App Router (13+) and Pages Router. These routing systems have different file structures, initialization requirements, and component placement:","repository":"mui/material-ui","domain":"app-frameworks","topic":"Next","language":"Markdown","updated":"2025-05-20","comments":4,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-distinguish-nextjs-routers.md"},{"slug":"netty-preserve-backward-compatibility","title":"Preserve backward compatibility","description":"When evolving APIs in minor versions, always maintain backward compatibility to avoid breaking client code. Follow these principles: 1. **Don''t add abstract methods** to existing interfaces or abstract classes. Instead, provide default implementations:","repository":"netty/netty","domain":"runtimes","topic":"API","language":"Java","updated":"2025-05-20","comments":4,"stars":34227,"raw":"https://awesomereviewers.com/raw/netty-preserve-backward-compatibility.md"},{"slug":"rails-understand-query-method-behavior","title":"Understand query method behavior","description":"When working with database queries in Active Record, it's essential to understand the precise behavior of query methods to avoid unexpected results and performance issues.","repository":"rails/rails","domain":"app-frameworks","topic":"Database","language":"Markdown","updated":"2025-05-20","comments":4,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-understand-query-method-behavior.md"},{"slug":"gin-precompute-over-recalculate","title":"Precompute over recalculate","description":"Perform expensive calculations during initialization rather than on each request, and avoid unnecessary operations in frequently executed code paths. This significantly improves performance in high-traffic applications.","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"Performance Optimization","language":"Go","updated":"2025-05-20","comments":3,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-precompute-over-recalculate.md"},{"slug":"opentofu-document-reference-standards","title":"Document reference standards","description":"Maintain consistent and accurate reference practices throughout project documentation to enhance usability and maintainability. This includes: 1. **Verify link accuracy**: Ensure all document cross-references point to the correct filenames and paths. Double-check file extensions and names before submitting changes.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Documentation","language":"Markdown","updated":"2025-05-20","comments":3,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-document-reference-standards.md"},{"slug":"union-use-meaningful-error-types","title":"use meaningful error types","description":"Replace generic exceptions with context-specific error types that provide meaningful information about what went wrong. When wrapping errors from external libraries, always use the correct error types from those libraries and extract error details to preserve debugging information.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Error Handling","language":"TypeScript","updated":"2025-05-20","comments":3,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-use-meaningful-error-types.md"},{"slug":"gin-initialize-before-null-checking","title":"Initialize before null-checking","description":"When handling potentially nil values, ensure proper initialization order to prevent race conditions and null reference errors. This is critical for maintaining thread safety and following idiomatic Go patterns.","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"Null Handling","language":"Go","updated":"2025-05-20","comments":2,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-initialize-before-null-checking.md"},{"slug":"gin-preserve-security-configurations","title":"Preserve security configurations","description":"Always respect explicitly set security attributes and properly sanitize user inputs to prevent security vulnerabilities. When modifying security-related configurations:","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"Security","language":"Go","updated":"2025-05-20","comments":2,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-preserve-security-configurations.md"},{"slug":"lmcache-avoid-hardcoded-configuration-values","title":"Avoid hardcoded configuration values","description":"Configuration files and scripts should use placeholders, environment variables, or parameterized values instead of hardcoding specific configuration values. Hardcoded values make configurations inflexible and difficult to adapt across different environments or deployments.","repository":"LMCache/LMCache","domain":"llm-infra","topic":"Configurations","language":"Shell","updated":"2025-05-20","comments":2,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-avoid-hardcoded-configuration-values.md"},{"slug":"swe-agent-handle-ai-provider-inconsistencies","title":"Handle AI provider inconsistencies","description":"When integrating with AI model providers, implement defensive programming to handle API inconsistencies, bugs, and unexpected return types. AI provider libraries often have implementation bugs or return different types than documented, requiring robust error handling and type checking.","repository":"SWE-agent/SWE-agent","domain":"ai-agents","topic":"AI","language":"Python","updated":"2025-05-20","comments":2,"stars":16839,"raw":"https://awesomereviewers.com/raw/swe-agent-handle-ai-provider-inconsistencies.md"},{"slug":"teleport-avoid-platform-specific-ci-features","title":"avoid platform-specific CI features","description":"Avoid using CI platform-specific features in workflows to prevent vendor lock-in and ensure portability. Instead of relying on GitHub Actions artifacts, Docker Hub registries, or other platform-specific storage mechanisms, use cloud-agnostic alternatives like S3 for artifact storage and transfer between jobs.","repository":"gravitational/teleport","domain":"security","topic":"CI/CD","language":"Yaml","updated":"2025-05-20","comments":2,"stars":19109,"raw":"https://awesomereviewers.com/raw/teleport-avoid-platform-specific-ci-features.md"},{"slug":"tokio-simplify-configuration-flags","title":"Simplify configuration flags","description":"Keep configuration flags, feature toggles, and build settings concise and well-organized. Use simpler names where appropriate and consolidate related flags when possible to improve readability and maintainability.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Configurations","language":"Yaml","updated":"2025-05-20","comments":2,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-simplify-configuration-flags.md"},{"slug":"volcano-protocol-specific-network-discovery","title":"Protocol-specific network discovery","description":"When implementing network topology discovery features, use discovery methods that are appropriate for the specific network protocol being used. Different network protocols have different architectures and require different approaches for topology discovery.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Networking","language":"Markdown","updated":"2025-05-20","comments":2,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-protocol-specific-network-discovery.md"},{"slug":"fiber-extract-duplicate-logic","title":"Extract duplicate logic","description":"When code blocks become large or contain repetitive patterns, extract them into separate functions to improve readability and maintainability. This follows Clean Code principles of keeping functions short and focused on single responsibilities.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Code Style","language":"Go","updated":"2025-05-19","comments":6,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-extract-duplicate-logic.md"},{"slug":"inbox-zero-handle-nulls-with-types","title":"Handle nulls with types","description":"Enforce type safety by properly handling null and undefined values through TypeScript types and explicit checks. Avoid using non-null assertions (!) or type assertions (as any), and instead:","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Null Handling","language":"TSX","updated":"2025-05-19","comments":6,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-handle-nulls-with-types.md"},{"slug":"rails-contextual-error-messages","title":"Contextual error messages","description":"Error messages should provide sufficient context to understand and debug the problem efficiently. Include both the expected and actual values in error messages, along with specific information about what failed. This makes troubleshooting much more straightforward and reduces debugging time.","repository":"rails/rails","domain":"app-frameworks","topic":"Error Handling","language":"Ruby","updated":"2025-05-19","comments":4,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-contextual-error-messages.md"},{"slug":"terraform-consistent-documentation-formatting","title":"Consistent documentation formatting","description":"Maintain consistent style in documentation files to improve readability and professionalism. Specifically: 1. **Command references**: Use a consistent format when referring to CLI commands. Prefer either:","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Code Style","language":"Other","updated":"2025-05-19","comments":4,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-consistent-documentation-formatting.md"},{"slug":"duckdb-use-default-serialization-methods","title":"use default serialization methods","description":"When adding new properties to serialization methods, use `WritePropertyWithDefault` and `ReadPropertyWithDefault` instead of `WriteProperty` and `ReadProperty` to maintain backwards compatibility. This ensures that older versions can still deserialize data written by newer versions by providing sensible defaults for missing properties.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Migrations","language":"C++","updated":"2025-05-19","comments":3,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-use-default-serialization-methods.md"},{"slug":"helix-documentation-style-and-formatting","title":"Documentation style and formatting","description":"Maintain consistent documentation style by following these guidelines: 1. Use concise, descriptive language for configuration and feature descriptions","repository":"helix-editor/helix","domain":"devtools","topic":"Code Style","language":"Markdown","updated":"2025-05-19","comments":3,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-documentation-style-and-formatting.md"},{"slug":"runtime-preserve-pointer-authentication","title":"Preserve pointer authentication","description":"When implementing Pointer Authentication (PAC) for security, maintain signed pointers throughout their entire lifecycle to prevent potential security vulnerabilities. Avoid unnecessarily stripping PAC signatures from pointers that will be stored and later reused. This preserves the security guarantees that PAC is designed to provide.","repository":"dotnet/runtime","domain":"runtimes","topic":"Security","language":"C++","updated":"2025-05-19","comments":3,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-preserve-pointer-authentication.md"},{"slug":"duckdb-avoid-redundant-computations","title":"avoid redundant computations","description":"Move loop-invariant conditions and computations outside of iteration blocks to improve performance and reduce redundant processing. When the same check or calculation doesn't depend on loop variables, extract it to run once before the loop rather than repeating it for each iteration.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Performance Optimization","language":"Python","updated":"2025-05-19","comments":2,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-avoid-redundant-computations.md"},{"slug":"influxdb-centralize-workspace-configurations","title":"Centralize workspace configurations","description":"Centralize configuration settings like dependency versions and feature flags at the workspace level rather than duplicating them across individual crate files. This reduces maintenance overhead, prevents inconsistencies, and simplifies dependency management.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Configurations","language":"Toml","updated":"2025-05-19","comments":2,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-centralize-workspace-configurations.md"},{"slug":"lmcache-remove-redundant-ai-commands","title":"Remove redundant AI commands","description":"Eliminate duplicate or redundant commands when setting up AI infrastructure, model serving, or ML library installations. Redundant commands create confusion, increase maintenance overhead, and can lead to unexpected behavior in AI workflows.","repository":"LMCache/LMCache","domain":"llm-infra","topic":"AI","language":"Shell","updated":"2025-05-19","comments":2,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-remove-redundant-ai-commands.md"},{"slug":"material-ui-prefer-direct-property-access","title":"Prefer direct property access","description":"When property names are known at development time, use direct property access (e.g., `object.property`) over computed property access (e.g., `object[propertyName]`). This approach enhances code readability, enables better IDE autocompletion, improves type checking, and makes the code more maintainable.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2025-05-19","comments":2,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-prefer-direct-property-access.md"},{"slug":"signoz-validate-before-accessing","title":"validate before accessing","description":"Always validate bounds, nil pointers, and other potentially unsafe conditions before accessing values to prevent runtime panics and undefined behavior. This includes checking array/slice bounds, validating pointer references, and ensuring data structures are in expected states before use.","repository":"SigNoz/signoz","domain":"observability","topic":"Null Handling","language":"Go","updated":"2025-05-19","comments":2,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-validate-before-accessing.md"},{"slug":"mastodon-referrer-header-privacy","title":"referrer header privacy","description":"When implementing features that link to external sites, carefully consider referrer policies to prevent unintended disclosure of sensitive information about users or the origin server. HTTP referrer headers can inadvertently expose details about what type of community, instance, or service users belong to, which may have privacy or safety implications.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Security","language":"Yaml","updated":"2025-05-19","comments":1,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-referrer-header-privacy.md"},{"slug":"rails-self-documenting-identifier-names","title":"Self-documenting identifier names","description":"Use clear, self-documenting names for variables, methods, and classes\\ \\ that express intent without exposing unnecessary implementation details. \\n\\n\\ **For methods and variables:**","repository":"rails/rails","domain":"app-frameworks","topic":"Naming Conventions","language":"Ruby","updated":"2025-05-18","comments":9,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-self-documenting-identifier-names.md"},{"slug":"appwrite-use-language-specific-syntax","title":"Use language-specific syntax","description":"Code snippets must use the correct language-specific syntax and include all necessary imports to compile properly. When writing examples: 1. Include all required imports for the libraries and data structures used","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Code Style","language":"Markdown","updated":"2025-05-18","comments":6,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-use-language-specific-syntax.md"},{"slug":"router-validate-configuration-schemas","title":"validate configuration schemas","description":"Always validate configuration objects using proper schema validation (like Zod) before type casting or using the configuration values. Avoid unsafe type casting from input types to output types without validation, as this can lead to runtime errors when expected properties are undefined.","repository":"TanStack/router","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2025-05-18","comments":5,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-validate-configuration-schemas.md"},{"slug":"appwrite-ensure-proper-async-context","title":"Ensure proper async context","description":"Always wrap asynchronous operations (await, suspend functions, try-await) in the appropriate language-specific async context. Top-level await is generally not supported and will cause runtime errors.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Concurrency","language":"Markdown","updated":"2025-05-18","comments":4,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-ensure-proper-async-context.md"},{"slug":"prettier-measure-performance-impacts","title":"Measure performance impacts","description":"Always benchmark and measure actual performance impacts before making optimization decisions, rather than relying on assumptions. Performance characteristics can vary significantly across different runtimes, data sizes, and usage patterns.","repository":"prettier/prettier","domain":"devtools","topic":"Performance Optimization","language":"JavaScript","updated":"2025-05-18","comments":4,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-measure-performance-impacts.md"},{"slug":"rails-efficient-data-processing","title":"Efficient data processing","description":"When implementing algorithms that process large data streams or collections, use a chunking approach rather than processing the entire input at once. This improves memory efficiency and prevents out-of-memory errors for large inputs.","repository":"rails/rails","domain":"app-frameworks","topic":"Algorithms","language":"Ruby","updated":"2025-05-18","comments":4,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-efficient-data-processing.md"},{"slug":"v-explicit-null-checks","title":"explicit null checks","description":"Always verify that pointers and function return values are not null before dereferencing or using them. This prevents crashes and undefined behavior, especially when working with C functions or manual memory management.","repository":"vlang/v","domain":"runtimes","topic":"Null Handling","language":"Other","updated":"2025-05-18","comments":4,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-explicit-null-checks.md"},{"slug":"appwrite-guard-database-query-results","title":"Guard database query results","description":"Always validate database query results before accessing their methods or properties. Methods like `findOne()`, `getDocument()`, and similar database operations can return null or empty documents. Failing to check these results before access leads to runtime errors.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Null Handling","language":"PHP","updated":"2025-05-18","comments":3,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-guard-database-query-results.md"},{"slug":"appwrite-openapi-spec-compliance","title":"OpenAPI spec compliance","description":"Ensure all API definitions strictly follow OpenAPI specification standards to maintain compatibility with tooling and clients. This includes: 1. Match default values with their defined types:","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"API","language":"Json","updated":"2025-05-18","comments":3,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-openapi-spec-compliance.md"},{"slug":"polars-consistent-naming-standards","title":"Consistent naming standards","description":"Maintain consistent and standardized naming throughout the codebase: 1. **Use snake_case for multi-word identifiers**: Separate words in variable names, function names, and parameters with underscores.","repository":"pola-rs/polars","domain":"data-systems","topic":"Naming Conventions","language":"Python","updated":"2025-05-18","comments":3,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-consistent-naming-standards.md"},{"slug":"appwrite-context-appropriate-api-authentication","title":"Context-appropriate API authentication","description":"Always use the authentication method appropriate for your API client's execution context. Server-side SDKs should use API key authentication (with `setKey()`) rather than session-based authentication, which is meant for client-side applications.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2025-05-18","comments":2,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-context-appropriate-api-authentication.md"},{"slug":"appwrite-match-defaults-to-types","title":"Match defaults to types","description":"When specifying default values in schemas or configurations, ensure they match the declared type to prevent validation errors and unpredictable behavior. For object types, use empty objects (`{}`) not null, undefined, or arrays. For string types that should be empty by default, use empty strings (`\"\"`) not null. This practice improves type safety and...","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Null Handling","language":"Json","updated":"2025-05-18","comments":2,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-match-defaults-to-types.md"},{"slug":"appwrite-prevent-api-documentation-duplication","title":"Prevent API documentation duplication","description":"When maintaining API specification files (like OpenAPI or Swagger), ensure consistency and avoid duplication that can confuse documentation generators and API consumers:","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Documentation","language":"Json","updated":"2025-05-18","comments":2,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-prevent-api-documentation-duplication.md"},{"slug":"union-environment-aware-logging-configuration","title":"Environment-aware logging configuration","description":"Configure logging behavior dynamically based on the current environment to ensure appropriate log levels and destinations for development, staging, and production contexts. Development environments should use verbose logging (Trace/Debug) for debugging, while production should use minimal logging (Warning/Error) for performance. External logging services...","repository":"unionlabs/union","domain":"cloud-infra","topic":"Logging","language":"TypeScript","updated":"2025-05-18","comments":2,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-environment-aware-logging-configuration.md"},{"slug":"union-mock-external-dependencies","title":"Mock external dependencies","description":"Always mock external dependencies in tests to ensure isolation and reliability. Unit tests should not make real network calls, database queries, or interact with external services. Mock implementations must provide the same interface and requirements as their live counterparts to maintain test validity.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Testing","language":"TypeScript","updated":"2025-05-18","comments":2,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-mock-external-dependencies.md"},{"slug":"appwrite-use-proper-authentication","title":"Use proper authentication","description":"Always implement the correct authentication method for API clients as specified in the SDK documentation. Incorrect authentication methods can lead to security vulnerabilities, API access failures, or unintended behavior.","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Security","language":"Markdown","updated":"2025-05-18","comments":1,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-use-proper-authentication.md"},{"slug":"opencv-consistent-descriptive-naming","title":"Consistent descriptive naming","description":"Use clear, descriptive names that follow consistent patterns established in the codebase and broader programming standards. This includes: 1. Choose unambiguous function names that clearly communicate purpose and behavior:","repository":"opencv/opencv","domain":"ml-systems","topic":"Naming Conventions","language":"Other","updated":"2025-05-17","comments":10,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-consistent-descriptive-naming.md"},{"slug":"langfuse-surface-errors-to-users","title":"Surface errors to users","description":"Always provide user-visible feedback for errors instead of only logging to the console. This ensures users are aware of failures and can take appropriate action. This is especially important for:","repository":"langfuse/langfuse","domain":"observability","topic":"Error Handling","language":"TSX","updated":"2025-05-17","comments":7,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-surface-errors-to-users.md"},{"slug":"langchainjs-prefer-nullish-coalescing","title":"Prefer nullish coalescing","description":"When handling null or undefined values, use modern JavaScript patterns to write more robust and maintainable code: 1. Use the nullish coalescing operator (`??`) instead of logical OR (`||`) for defaults:","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2025-05-17","comments":6,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-prefer-nullish-coalescing.md"},{"slug":"opencv-optimize-container-access","title":"Optimize container access","description":"Choose efficient container types and optimize access patterns in performance-critical code. Avoid operations that cause hidden allocations and minimize overhead when accessing container elements.","repository":"opencv/opencv","domain":"ml-systems","topic":"Performance Optimization","language":"Other","updated":"2025-05-17","comments":5,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-optimize-container-access.md"},{"slug":"core-pause-tracking-during-side-effects","title":"Pause tracking during side-effects","description":"When executing side-effects in reactive systems (like event handlers, cleanup functions, or async operations), always pause reactivity tracking to prevent unintended dependencies from being captured. This prevents infinite loops, race conditions, and unexpected behavior that can occur when reactive state is accessed during side-effects.","repository":"vuejs/core","domain":"app-frameworks","topic":"Concurrency","language":"TypeScript","updated":"2025-05-17","comments":4,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-pause-tracking-during-side-effects.md"},{"slug":"helix-avoid-version-specific-documentation","title":"avoid version-specific documentation","description":"When writing build and deployment documentation, avoid hard-coding specific version numbers, toolchain assumptions, or environment-specific details that will become outdated or may not apply to all users. Instead, use generic language that describes the underlying requirement or constraint.","repository":"helix-editor/helix","domain":"devtools","topic":"CI/CD","language":"Markdown","updated":"2025-05-17","comments":3,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-avoid-version-specific-documentation.md"},{"slug":"helix-use-realistic-doc-examples","title":"Use realistic doc examples","description":"Documentation should include concrete, realistic examples that demonstrate practical usage rather than abstract concepts. This helps readers better understand the functionality and improves documentation accessibility for all skill levels.","repository":"helix-editor/helix","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2025-05-17","comments":3,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-use-realistic-doc-examples.md"},{"slug":"inbox-zero-remove-commented-out-code","title":"Remove commented out code","description":"Delete commented-out code instead of retaining it in the codebase. Commented code creates confusion, adds maintenance overhead, and clutters the source files. If code is no longer needed, remove it entirely - version control systems will preserve the history if it needs to be referenced later.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2025-05-17","comments":3,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-remove-commented-out-code.md"},{"slug":"traefik-optimize-selection-algorithms","title":"optimize selection algorithms","description":"When implementing selection algorithms that choose from a pool of candidates, design the algorithm to filter invalid options during the selection process rather than using retry logic after selection. Additionally, always include termination conditions to prevent infinite loops when no valid candidates remain.","repository":"traefik/traefik","domain":"cloud-infra","topic":"Algorithms","language":"Go","updated":"2025-05-17","comments":2,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-optimize-selection-algorithms.md"},{"slug":"prisma-extract-duplicate-code","title":"Extract duplicate code","description":"When you notice code patterns being repeated across multiple locations, extract them into reusable functions or constants to improve maintainability and follow DRY principles.","repository":"prisma/prisma","domain":"data-systems","topic":"Code Style","language":"TypeScript","updated":"2025-05-16","comments":7,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-extract-duplicate-code.md"},{"slug":"react-native-validate-before-accessing","title":"validate before accessing","description":"Always validate parameters for both null values and correct types before accessing their properties or methods. Provide safe fallback values when validation fails to prevent crashes and undefined behavior.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Null Handling","language":"Other","updated":"2025-05-16","comments":5,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-validate-before-accessing.md"},{"slug":"codex-avoid-hard-coded-configuration","title":"Avoid hard-coded configuration","description":"Make scripts and applications flexible by avoiding hard-coded configuration values. Instead, allow users to provide configuration through command-line flags, environment variables, or configuration files. When updating scripts to use configurable parameters:","repository":"openai/codex","domain":"ai-agents","topic":"Configurations","language":"Shell","updated":"2025-05-16","comments":4,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-avoid-hard-coded-configuration.md"},{"slug":"langfuse-pin-dependency-versions","title":"Pin dependency versions","description":"Always pin external dependencies to specific versions in CI/CD workflows to ensure build reproducibility, stability, and security. This applies to: 1. GitHub Actions (use tagged versions instead of branch names or commit SHAs)","repository":"langfuse/langfuse","domain":"observability","topic":"CI/CD","language":"Yaml","updated":"2025-05-16","comments":4,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-pin-dependency-versions.md"},{"slug":"lobe-chat-explicit-environment-declarations","title":"Explicit environment declarations","description":"Always explicitly declare environment variables in configuration files, even when they have default values. Use consistent naming conventions with appropriate prefixes for related variables, and clearly document when each variable is required versus optional.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Configurations","language":"Other","updated":"2025-05-16","comments":4,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-explicit-environment-declarations.md"},{"slug":"supabase-secure-authentication-flows","title":"Secure authentication flows","description":"Design APIs with secure authentication flows by following proper error handling and documentation practices. Avoid non-null assertions in authorization code, properly document URL format requirements, and provide clear configuration steps for auth providers.","repository":"supabase/supabase","domain":"data-systems","topic":"API","language":"Other","updated":"2025-05-16","comments":4,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-secure-authentication-flows.md"},{"slug":"deno-use-descriptive-identifiers","title":"Use descriptive identifiers","description":"Choose names that clearly communicate the purpose, functionality, and usage context of variables, methods, and types. Avoid ambiguous or overly generic names that require additional context to understand.","repository":"denoland/deno","domain":"runtimes","topic":"Naming Conventions","language":"TypeScript","updated":"2025-05-16","comments":3,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-use-descriptive-identifiers.md"},{"slug":"appwrite-consistent-database-parameters","title":"Consistent database parameters","description":"Maintain consistency and clarity in database-related parameters and configuration variables. Follow these practices: 1. Use descriptive variable names that match parameter names for clarity","repository":"appwrite/appwrite","domain":"app-frameworks","topic":"Database","language":"Other","updated":"2025-05-16","comments":2,"stars":51959,"raw":"https://awesomereviewers.com/raw/appwrite-consistent-database-parameters.md"},{"slug":"argo-cd-use-clear-descriptive-names","title":"Use clear, descriptive names","description":"Choose names that accurately describe their purpose and avoid unnecessary verbosity. Field names should semantically match what they contain or validate, and component names should be concise without redundant prefixes that don't add clarity.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Naming Conventions","language":"Other","updated":"2025-05-16","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-use-clear-descriptive-names.md"},{"slug":"netty-enable-header-validation","title":"Enable header validation","description":"Always enable HTTP header validation to prevent request/response splitting vulnerabilities. These attacks can occur when untrusted data containing CRLF sequences is inserted into HTTP headers, allowing attackers to inject additional headers or even response body content.","repository":"netty/netty","domain":"runtimes","topic":"Security","language":"Java","updated":"2025-05-16","comments":2,"stars":34227,"raw":"https://awesomereviewers.com/raw/netty-enable-header-validation.md"},{"slug":"supabase-use-null-strategically","title":"Use null strategically","description":"When handling empty or missing values, be intentional about using `null`, `undefined`, or empty strings based on how downstream systems interpret these values. In particular, when working with database operations (like PostgreSQL), use `null` instead of empty strings for fields that need to be cleared or constraints that should be dropped.","repository":"supabase/supabase","domain":"data-systems","topic":"Null Handling","language":"TypeScript","updated":"2025-05-16","comments":2,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-use-null-strategically.md"},{"slug":"bun-verify-cryptographic-function-behavior","title":"Verify cryptographic function behavior","description":"When implementing cryptographic algorithms, always verify the exact behavior and return values of security-critical functions. Misinterpreting how functions signal success or equality can lead to severe security vulnerabilities.","repository":"oven-sh/bun","domain":"runtimes","topic":"Security","language":"C++","updated":"2025-05-16","comments":1,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-verify-cryptographic-function-behavior.md"},{"slug":"dspy-implement-algorithms-correctly","title":"implement algorithms correctly","description":"Ensure algorithmic implementations use correct patterns, handle edge cases gracefully, and avoid silent failures. This includes using proper mathematical functions, correct object access methods, and robust error handling for each operation.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Algorithms","language":"Python","updated":"2025-05-15","comments":6,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-implement-algorithms-correctly.md"},{"slug":"pytorch-graceful-api-evolution","title":"Graceful API evolution","description":"When modifying, deprecating, or replacing APIs, ensure a smooth transition experience for developers by following these practices: 1. **Add deprecation warnings** when removing or changing public APIs to alert users:","repository":"pytorch/pytorch","domain":"ml-systems","topic":"API","language":"Python","updated":"2025-05-15","comments":6,"stars":91345,"raw":"https://awesomereviewers.com/raw/pytorch-graceful-api-evolution.md"},{"slug":"ollama-clear-recoverable-error-messages","title":"Clear recoverable error messages","description":"Error messages should be clear, actionable, and indicate whether recovery is possible. When designing error handling: 1. Use descriptive messages that explain what went wrong and how to fix it","repository":"ollama/ollama","domain":"llm-infra","topic":"Error Handling","language":"Go","updated":"2025-05-15","comments":5,"stars":145704,"raw":"https://awesomereviewers.com/raw/ollama-clear-recoverable-error-messages.md"},{"slug":"stagehand-use-structured-logging-consistently","title":"Use structured logging consistently","description":"Always use the established logging framework instead of console.log or ad-hoc logging approaches. This ensures consistent log formatting, proper log levels, and better log management across the application.","repository":"browserbase/stagehand","domain":"ai-agents","topic":"Logging","language":"TypeScript","updated":"2025-05-15","comments":5,"stars":16443,"raw":"https://awesomereviewers.com/raw/stagehand-use-structured-logging-consistently.md"},{"slug":"terraform-use-precise-semantic-names","title":"Use precise semantic names","description":"Choose names that accurately reflect the purpose and semantics of the entity being named. Avoid overloaded or ambiguous terms that could lead to confusion or misinterpretation.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Naming Conventions","language":"Other","updated":"2025-05-15","comments":5,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-use-precise-semantic-names.md"},{"slug":"opentelemetry-python-prevent-recursive-logging-calls","title":"Prevent recursive logging calls","description":"Avoid implementing logging calls that could trigger recursive logging patterns, which can lead to infinite loops and program crashes. This is particularly important in logging handlers, exporters, and instrumentation code.","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Logging","language":"Python","updated":"2025-05-15","comments":4,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-prevent-recursive-logging-calls.md"},{"slug":"ty-ensure-ci-dependency-reliability","title":"Ensure CI dependency reliability","description":"CI workflows should use the most current versions of dependencies and ensure all required tools are available. Avoid testing against potentially stale submodules or bundled dependencies by checking out the target repository directly. Use self-installing tools and hooks that handle their own installation to prevent failures due to missing dependencies.","repository":"astral-sh/ty","domain":"devtools","topic":"CI/CD","language":"Yaml","updated":"2025-05-15","comments":3,"stars":11919,"raw":"https://awesomereviewers.com/raw/ty-ensure-ci-dependency-reliability.md"},{"slug":"argo-cd-prevent-silent-failures","title":"Prevent silent failures","description":"Ensure that user actions and validations provide clear feedback rather than failing silently. When operations cannot be performed, disable UI elements or provide explicit error messages to inform users of the system state.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Error Handling","language":"TSX","updated":"2025-05-15","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-prevent-silent-failures.md"},{"slug":"neon-balance-flexibility-with-performance","title":"Balance flexibility with performance","description":"When designing APIs, carefully balance flexibility against performance constraints. More flexible APIs often come with implementation complexity and potential performance costs. Start by understanding how clients actually use your API, then optimize for those common patterns while providing just enough flexibility for legitimate edge cases.","repository":"neondatabase/neon","domain":"data-systems","topic":"API","language":"Other","updated":"2025-05-15","comments":2,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-balance-flexibility-with-performance.md"},{"slug":"novu-consistent-authentication-patterns","title":"consistent authentication patterns","description":"Use standardized authentication decorators consistently across all endpoints to ensure proper security coverage and follow the principle of least privilege. Always use @RequireAuthentication() as the primary way to protect endpoints, and explicitly use @SkipPermissionsCheck() for authenticated routes that don't require permission validation.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Security","language":"TypeScript","updated":"2025-05-15","comments":2,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-consistent-authentication-patterns.md"},{"slug":"novu-event-listener-management","title":"Event listener management","description":"Implement comprehensive event listener management by registering listeners on multiple relevant sources and providing appropriate fallback mechanisms. This ensures robust event handling across different environments and prevents missed events that could lead to inconsistent application state.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Networking","language":"TSX","updated":"2025-05-15","comments":2,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-event-listener-management.md"},{"slug":"novu-use-constructorname-context","title":"Use constructor.name context","description":"Always set logger context using `this.constructor.name` and configure it via the `setContext()` method rather than hardcoding context strings or passing context as parameters to individual log calls.","repository":"novuhq/novu","domain":"app-frameworks","topic":"Logging","language":"TypeScript","updated":"2025-05-15","comments":2,"stars":37700,"raw":"https://awesomereviewers.com/raw/novu-use-constructorname-context.md"},{"slug":"quarkus-prevent-metrics-cardinality-explosion","title":"Prevent metrics cardinality explosion","description":"When implementing metrics and telemetry in your application, avoid using dynamic values like path parameters or user IDs directly as metric tags or dimensions. This practice causes cardinality explosion, which leads to excessive memory usage, degraded performance, and can overwhelm your monitoring systems.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Observability","language":"Java","updated":"2025-05-15","comments":2,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-prevent-metrics-cardinality-explosion.md"},{"slug":"bazel-ensure-comprehensive-test-coverage","title":"Ensure comprehensive test coverage","description":"When implementing new functionality or modifying existing code, always add corresponding tests that comprehensively cover the changes. This includes testing the main functionality, edge cases, error conditions, and different execution paths.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Testing","language":"Java","updated":"2025-05-14","comments":9,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-ensure-comprehensive-test-coverage.md"},{"slug":"dspy-avoid-silent-failures","title":"avoid silent failures","description":"Always provide clear feedback when operations fail, even when continuing with fallbacks or alternative approaches. Silent failures make debugging extremely difficult and can lead to unexpected behavior in production systems.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2025-05-14","comments":9,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-avoid-silent-failures.md"},{"slug":"quarkus-api-evolution-strategy","title":"API evolution strategy","description":"Design APIs with future extensibility in mind by using parameter objects instead of direct method parameters. When an API might need additional parameters in the future, encapsulate them in an interface or class:","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"API","language":"Java","updated":"2025-05-14","comments":7,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-api-evolution-strategy.md"},{"slug":"opentofu-safe-lock-patterns","title":"Safe lock patterns","description":"When implementing concurrent operations, ensure locks are acquired and released properly in all execution paths. Always use patterns that guarantee lock release, and document lock acquisition order to prevent deadlocks.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Concurrency","language":"Go","updated":"2025-05-14","comments":6,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-safe-lock-patterns.md"},{"slug":"opentofu-prevent-backing-array-surprises","title":"Prevent backing array surprises","description":"When modifying slices in Go, be aware that appending to a slice with available capacity will modify the backing array, potentially affecting other slices that share the same backing storage. This can lead to subtle bugs where one operation unexpectedly affects seemingly unrelated variables.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Algorithms","language":"Go","updated":"2025-05-14","comments":4,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-prevent-backing-array-surprises.md"},{"slug":"django-feature-flags-over-vendors","title":"Feature flags over vendors","description":"When checking for database backend capabilities, always use feature flags rather than checking specific vendor names. This makes your code more maintainable and vendor-agnostic while allowing third-party backends to implement support through the feature flag system.","repository":"django/django","domain":"app-frameworks","topic":"Configurations","language":"Python","updated":"2025-05-14","comments":3,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-feature-flags-over-vendors.md"},{"slug":"influxdb-secure-token-lifecycle","title":"Secure token lifecycle","description":"Implement comprehensive lifecycle controls for authentication tokens to maintain security throughout token creation, usage, and deletion processes. Essential practices include:","repository":"influxdata/influxdb","domain":"data-systems","topic":"Security","language":"Rust","updated":"2025-05-14","comments":3,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-secure-token-lifecycle.md"},{"slug":"opentofu-explicit-versus-dynamic-configurations","title":"Explicit versus dynamic configurations","description":"Prefer explicit hardcoded configurations over dynamic ones when the configuration changes infrequently and control is important. While dynamic configurations (like API-driven or external service-based solutions) require less maintenance, explicit configurations provide better control and predictability.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Configurations","language":"Yaml","updated":"2025-05-14","comments":3,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-explicit-versus-dynamic-configurations.md"},{"slug":"opentofu-optimize-cicd-workflows","title":"Optimize CI/CD workflows","description":"Configure CI/CD workflows to maximize efficiency and improve developer experience. Consider these key optimization practices: 1. **Schedule automated jobs strategically**: Use offset minutes in cron schedules to avoid GitHub Actions high load times.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"CI/CD","language":"Yaml","updated":"2025-05-14","comments":3,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-optimize-cicd-workflows.md"},{"slug":"playwright-use-modern-null-safe-operators","title":"Use modern null-safe operators","description":"Prefer optional chaining (`?.`) and nullish coalescing (`??`) operators over verbose null checks and ternary expressions. These modern JavaScript operators provide cleaner, more readable code while preventing runtime errors from null or undefined values.","repository":"microsoft/playwright","domain":"devtools","topic":"Null Handling","language":"TSX","updated":"2025-05-14","comments":3,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-use-modern-null-safe-operators.md"},{"slug":"codex-pin-external-action-dependencies","title":"Pin external action dependencies","description":"Use full commit hashes instead of version tags when referencing third-party GitHub Actions in workflows to prevent unexpected behavior changes if the action is modified at its source. This ensures reproducible builds and improves security by protecting against supply chain attacks.","repository":"openai/codex","domain":"ai-agents","topic":"CI/CD","language":"Yaml","updated":"2025-05-14","comments":2,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-pin-external-action-dependencies.md"},{"slug":"codex-secure-cicd-pipelines","title":"Secure CI/CD pipelines","description":"Implement strict security controls in continuous integration and deployment workflows: 1. Pin external GitHub Actions to immutable commit hashes rather than mutable tags:","repository":"openai/codex","domain":"ai-agents","topic":"Security","language":"Yaml","updated":"2025-05-14","comments":2,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-secure-cicd-pipelines.md"},{"slug":"core-optimize-build-scripts","title":"Optimize build scripts","description":"Improve CI/CD pipeline efficiency by optimizing package.json scripts. Run compatible tasks in parallel using pattern matching capabilities of your package manager, and implement thorough cleanup scripts that remove all build artifacts and caches. This reduces build times and ensures consistent build environments.","repository":"vuejs/core","domain":"app-frameworks","topic":"CI/CD","language":"Json","updated":"2025-05-14","comments":2,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-optimize-build-scripts.md"},{"slug":"litellm-prioritize-naming-clarity","title":"Prioritize naming clarity","description":"Choose names that are immediately self-explanatory and unambiguous, even if they are more verbose. Names should convey their full meaning and context without requiring additional documentation or guesswork.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Naming Conventions","language":"Markdown","updated":"2025-05-14","comments":2,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-prioritize-naming-clarity.md"},{"slug":"prowler-environment-variables-for-configurations","title":"Environment variables for configurations","description":"Store all configurable values such as URLs, API endpoints, and external service locations in environment variables rather than hardcoding them in the codebase. This makes the application more maintainable, secure, and environment-adaptable.","repository":"prowler-cloud/prowler","domain":"security","topic":"Configurations","language":"TSX","updated":"2025-05-14","comments":2,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-environment-variables-for-configurations.md"},{"slug":"checkov-restrict-public-access","title":"Restrict public access","description":"Cloud resources should be configured to restrict public network access by default to minimize potential attack surfaces. Always explicitly disable public-facing endpoints and network interfaces unless absolutely necessary for the service to function.","repository":"bridgecrewio/checkov","domain":"security","topic":"Networking","language":"Python","updated":"2025-05-13","comments":10,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-restrict-public-access.md"},{"slug":"checkov-restrict-public-network","title":"Restrict public network","description":"Always configure cloud resources to restrict or disable public network access unless explicitly required for the application's functionality. Public network exposure increases the attack surface and should be minimized.","repository":"bridgecrewio/checkov","domain":"security","topic":"Networking","language":"Python","updated":"2025-05-13","comments":8,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-restrict-public-network.md"},{"slug":"fiber-follow-naming-patterns","title":"Follow naming patterns","description":"Maintain consistent naming conventions throughout the codebase by following established patterns and avoiding redundancy. Key principles include: 1. **Error naming**: Use the pattern `Err + [Subject] + [Error Condition]` (e.g., `ErrStorageRetrievalFailed` instead of `ErrNotGetStorage`)","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Naming Conventions","language":"Go","updated":"2025-05-13","comments":8,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-follow-naming-patterns.md"},{"slug":"framework-descriptive-configuration-keys","title":"Descriptive configuration keys","description":"Configuration keys should clearly indicate their value type, units, or expected format to prevent misunderstandings and errors. Include unit information directly in key names when appropriate and ensure documentation accurately reflects the default values and behavior.","repository":"laravel/framework","domain":"app-frameworks","topic":"Configurations","language":"PHP","updated":"2025-05-13","comments":4,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-descriptive-configuration-keys.md"},{"slug":"inbox-zero-prevent-workflow-recursion","title":"Prevent workflow recursion","description":"Control GitHub Actions workflow execution to avoid infinite loops and unnecessary builds. Implement these practices: 1. **Add `paths-ignore` filters** for generated files that might trigger the workflow again:","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2025-05-13","comments":4,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-prevent-workflow-recursion.md"},{"slug":"opencv-optimize-for-common-cases","title":"Optimize for common cases","description":"When implementing algorithms, create specialized versions for common cases to improve performance, while maintaining a generic version for completeness. For functions that process data with different channel counts, implement separate optimized code paths for 1-channel and 3-channel data, which represent the majority of image processing workloads.","repository":"opencv/opencv","domain":"ml-systems","topic":"Algorithms","language":"Other","updated":"2025-05-13","comments":4,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-optimize-for-common-cases.md"},{"slug":"vite-document-code-purposefully","title":"Document code purposefully","description":"High-quality code documentation improves maintainability and helps other developers understand your intentions. Follow these practices: 1. **Use appropriate JSDoc annotations** to indicate API visibility and status:","repository":"vitejs/vite","domain":"devtools","topic":"Documentation","language":"TypeScript","updated":"2025-05-13","comments":4,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-document-code-purposefully.md"},{"slug":"browser-use-pin-testing-dependency-versions","title":"Pin testing dependency versions","description":"Always specify explicit versions for testing frameworks and tools to ensure reproducible test environments across different deployment contexts. Avoid installing testing dependencies with implicit \"latest\" versions, which can lead to inconsistent test behavior and difficult-to-debug failures.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Testing","language":"Dockerfile","updated":"2025-05-13","comments":3,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-pin-testing-dependency-versions.md"},{"slug":"neon-performance-test-pragmatism","title":"Performance test pragmatism","description":"When designing performance tests, focus on efficiency and meaningful insights rather than exhaustive combinations. Consider these principles: 1. **Limit parameter combinations** to avoid excessive test duration. For example, instead of:","repository":"neondatabase/neon","domain":"data-systems","topic":"Performance Optimization","language":"Python","updated":"2025-05-13","comments":3,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-performance-test-pragmatism.md"},{"slug":"spring-framework-leverage-kotlin-null-safety","title":"Leverage Kotlin null-safety","description":"Utilize Kotlin''s null-safety features effectively to create cleaner, more robust code: 1. For class properties that will be initialized before use, prefer `lateinit var` over nullable types with `?`:","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Null Handling","language":"Kotlin","updated":"2025-05-13","comments":3,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-leverage-kotlin-null-safety.md"},{"slug":"union-reuse-existing-api-utilities","title":"Reuse existing API utilities","description":"Before implementing custom API utilities, serializers, or type identification methods, check if equivalent functionality already exists in the codebase or standard libraries. This prevents code duplication, ensures consistency across the API surface, and leverages well-tested implementations.","repository":"unionlabs/union","domain":"cloud-infra","topic":"API","language":"Rust","updated":"2025-05-13","comments":3,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-reuse-existing-api-utilities.md"},{"slug":"cline-isolate-mock-configurations","title":"isolate mock configurations","description":"When using Vitest mocking, avoid multiple `vi.mock` calls for the same module within a single test file, as mock calls are hoisted and can interfere with each other. Instead, organize tests requiring different mock configurations into separate test files or test suites with proper setup/teardown.","repository":"cline/cline","domain":"ai-agents","topic":"Testing","language":"TSX","updated":"2025-05-13","comments":2,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-isolate-mock-configurations.md"},{"slug":"mastodon-remove-redundant-code","title":"remove redundant code","description":"Identify and remove code elements that no longer serve a purpose, including unused imports, redundant function calls, and obsolete ESLint disable directives. This improves code readability and maintainability by eliminating unnecessary clutter.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2025-05-13","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-remove-redundant-code.md"},{"slug":"opentofu-protect-infrastructure-secrets","title":"Protect infrastructure secrets","description":"Infrastructure-as-code tools like OpenTofu may store sensitive information in plaintext state files, creating security risks for passwords, API keys, and other secrets. Always implement proper protection measures:","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Security","language":"Markdown","updated":"2025-05-13","comments":2,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-protect-infrastructure-secrets.md"},{"slug":"opentelemetry-python-write-purposeful-comments","title":"Write purposeful comments","description":"Comments should explain \"why\" and \"how\" rather than restating what is already obvious from the code. Focus on providing additional context, usage examples, or explanations that would help other developers understand the intent and proper usage of the code.","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Documentation","language":"Python","updated":"2025-05-12","comments":6,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-write-purposeful-comments.md"},{"slug":"ollama-guard-against-nil","title":"Guard against nil","description":"Always check for nil values and successful type assertions before accessing or dereferencing objects, especially when working with interfaces, type conversions, or functions that may return nil values.","repository":"ollama/ollama","domain":"llm-infra","topic":"Null Handling","language":"Go","updated":"2025-05-12","comments":5,"stars":145704,"raw":"https://awesomereviewers.com/raw/ollama-guard-against-nil.md"},{"slug":"inbox-zero-externalize-configuration-values","title":"Externalize configuration values","description":"Configuration files should not contain hardcoded values for usernames, credentials, hostnames, or environment-specific settings. Instead, use environment variables, templated values, or dynamic references that can adapt to different deployment contexts.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Configurations","language":"Yaml","updated":"2025-05-12","comments":3,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-externalize-configuration-values.md"},{"slug":"playwright-consistent-spacing-grid","title":"consistent spacing grid","description":"Use consistent spacing values that follow a standardized grid system, typically multiples of 4px or 8px, rather than arbitrary values. This ensures visual consistency across the UI and makes the design system more maintainable.","repository":"microsoft/playwright","domain":"devtools","topic":"Code Style","language":"Css","updated":"2025-05-12","comments":3,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-consistent-spacing-grid.md"},{"slug":"volcano-use-controlled-concurrency-patterns","title":"Use controlled concurrency patterns","description":"Implement proper concurrency control mechanisms to prevent resource exhaustion and ensure thread-safe operations. Use sync.Once for thread-safe initialization to avoid memory leaks, and employ goroutine pools or semaphores to limit concurrent operations instead of spawning unlimited goroutines.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Concurrency","language":"Go","updated":"2025-05-12","comments":2,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-use-controlled-concurrency-patterns.md"},{"slug":"hyperswitch-prefer-specific-cryptographic-libraries","title":"prefer specific cryptographic libraries","description":"When adding cryptographic dependencies, critically evaluate whether broad libraries like OpenSSL are necessary or if more specific, focused alternatives can meet your requirements. Broad cryptographic libraries often include extensive functionality that may not be needed, potentially increasing the attack surface and complexity.","repository":"juspay/hyperswitch","domain":"app-frameworks","topic":"Security","language":"Toml","updated":"2025-05-12","comments":1,"stars":34028,"raw":"https://awesomereviewers.com/raw/hyperswitch-prefer-specific-cryptographic-libraries.md"},{"slug":"mermaid-safe-urlsvg-escaping","title":"Safe URL/SVG Escaping","description":"When building URL-like strings that will be embedded into SVG attributes (e.g., `marker-end=\"url(...)\"`), do not rely on upstream HTML escaping. Apply context-specific escaping/encoding for the exact attribute syntax, ensuring correct escaping order (notably escape backslashes first) and covering all unsafe characters—not just parentheses.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Security","language":"Markdown","updated":"2025-05-12","comments":1,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-safe-urlsvg-escaping.md"},{"slug":"inbox-zero-minimize-redundant-operations","title":"Minimize redundant operations","description":"Optimize application performance by preventing unnecessary renders, calculations, and network operations. Implement proper memoization strategies, lift shared operations to parent components, and batch related tasks.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Performance Optimization","language":"TSX","updated":"2025-05-11","comments":6,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-minimize-redundant-operations.md"},{"slug":"inbox-zero-complete-hook-dependency-arrays","title":"Complete hook dependency arrays","description":"Ensure all hooks (useEffect, useCallback, useMemo) explicitly list every dependency used within their callback functions. Missing dependencies can lead to stale closures, unexpected behaviors, and hard-to-debug issues.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"React","language":"TSX","updated":"2025-05-11","comments":4,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-complete-hook-dependency-arrays.md"},{"slug":"supabase-pin-dependency-versions","title":"Pin dependency versions","description":"Always specify exact versions for dependencies in your configuration files and import statements to ensure consistent behavior across different environments. Unpinned dependencies can lead to unexpected breaking changes when packages are automatically updated to newer versions.","repository":"supabase/supabase","domain":"data-systems","topic":"Configurations","language":"Other","updated":"2025-05-11","comments":4,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-pin-dependency-versions.md"},{"slug":"react-native-maintain-api-backwards-compatibility","title":"maintain API backwards compatibility","description":"When modifying existing public APIs, prioritize backwards compatibility to avoid breaking external consumers. Before making changes that alter method signatures, property access patterns, or introduce new abstract methods, first investigate whether existing functionality can be preserved or extended.","repository":"facebook/react-native","domain":"app-frameworks","topic":"API","language":"Java","updated":"2025-05-11","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-maintain-api-backwards-compatibility.md"},{"slug":"zed-document-configuration-clearly","title":"Document configuration clearly","description":"When adding or modifying configuration parameters, especially in JSON settings files, ensure they are clearly documented with comments that explain: 1. The purpose of the parameter","repository":"zed-industries/zed","domain":"devtools","topic":"Code Style","language":"Json","updated":"2025-05-11","comments":2,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-document-configuration-clearly.md"},{"slug":"inbox-zero-prevent-async-race-conditions","title":"Prevent async race conditions","description":"Always guard against race conditions when working with asynchronous code. Implement these patterns to avoid unpredictable behavior: 1. **Always await async operations**","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Concurrency","language":"TSX","updated":"2025-05-10","comments":5,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-prevent-async-race-conditions.md"},{"slug":"ai-test-before-documenting","title":"Test before documenting","description":"Always thoroughly test API features and endpoints before documenting them, especially when integrating with third-party services. Documentation should accurately reflect the actual behavior of the API, including:","repository":"vercel/ai","domain":"ai-agents","topic":"API","language":"Other","updated":"2025-05-10","comments":3,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-test-before-documenting.md"},{"slug":"browser-use-optimize-docker-layers","title":"optimize Docker layers","description":"Avoid unnecessary duplication and bloat in Docker layers by trusting base images to provide standard tools and using appropriate installation methods. Instead of upgrading pip when the base image already provides it, trust the image's version to prevent duplicate copies across layers. When installing application code, use editable installs to avoid creating...","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Configurations","language":"Dockerfile","updated":"2025-05-10","comments":3,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-optimize-docker-layers.md"},{"slug":"mastodon-review-configuration-currency","title":"Review configuration currency","description":"Regularly audit and update configuration to align with current tool capabilities and best practices. Remove obsolete settings that are no longer needed due to tool evolution, and consolidate fragmented configuration approaches into more unified solutions.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Configurations","language":"JavaScript","updated":"2025-05-10","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-review-configuration-currency.md"},{"slug":"framework-use-semantic-exceptions","title":"Use semantic exceptions","description":"Choose exception types that accurately reflect the nature of the error. Use `LogicException` for developer errors like incorrect usage, `InvalidArgumentException` for invalid inputs, `OutOfBoundsException` for range violations, and specialized exceptions for domain-specific errors.","repository":"laravel/framework","domain":"app-frameworks","topic":"Error Handling","language":"PHP","updated":"2025-05-09","comments":8,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-use-semantic-exceptions.md"},{"slug":"bazel-prefer-simple-api-designs","title":"prefer simple API designs","description":"Design APIs with simple, direct interfaces rather than complex parameter passing patterns or unnecessary indirection. Use appropriate parameter types (e.g., `PathFragment` instead of `String`, `ImmutableMap` instead of `BiFunction`) and avoid expanding API surface area when existing patterns can be reused.","repository":"bazelbuild/bazel","domain":"devtools","topic":"API","language":"Java","updated":"2025-05-09","comments":7,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-prefer-simple-api-designs.md"},{"slug":"neon-stage-configuration-changes-gradually","title":"Stage configuration changes gradually","description":"When introducing configuration changes that affect multiple system components, implement them in stages to ensure smooth transitions and backward compatibility. Follow these steps:","repository":"neondatabase/neon","domain":"data-systems","topic":"Configurations","language":"Rust","updated":"2025-05-09","comments":5,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-stage-configuration-changes-gradually.md"},{"slug":"azure-quickstart-templates-consistent-arm-json-formatting","title":"Consistent ARM Json Formatting","description":"For ARM templates, enforce deterministic JSON formatting and standardized property ordering to keep diffs small and templates readable. **Rules** 1. **Keep property order consistent**: follow the Azure “sort order of properties” guidance (move keys to the expected order).","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Code Style","language":"Json","updated":"2025-05-09","comments":4,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-consistent-arm-json-formatting.md"},{"slug":"quarkus-secure-authentication-defaults","title":"Secure authentication defaults","description":"Configure authentication mechanisms with secure default settings to prevent security vulnerabilities. When implementing WebAuthn or similar authentication protocols:","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Security","language":"Java","updated":"2025-05-09","comments":4,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-secure-authentication-defaults.md"},{"slug":"react-native-descriptive-specific-naming","title":"descriptive specific naming","description":"Use descriptive and specific names that clearly communicate purpose and context. Method names should indicate their platform target when applicable, test names should describe the expected behavior, and function names should follow consistent conventions.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Naming Conventions","language":"JavaScript","updated":"2025-05-09","comments":4,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-descriptive-specific-naming.md"},{"slug":"electron-document-error-handling-limitations","title":"Document error handling limitations","description":"When documenting error handling mechanisms, always provide complete context about how they work, including any limitations, edge cases, and alternative approaches. This prevents developers from making incorrect assumptions about behavior.","repository":"electron/electron","domain":"devtools","topic":"Error Handling","language":"Markdown","updated":"2025-05-09","comments":3,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-document-error-handling-limitations.md"},{"slug":"crewai-fail-securely-by-default","title":"Fail securely by default","description":"When designing systems that handle sensitive operations, always default to the most secure behavior rather than prioritizing convenience. This practice applies to error handling, execution environments, and security-critical fallbacks.","repository":"crewaiinc/crewai","domain":"ai-agents","topic":"Security","language":"Python","updated":"2025-05-09","comments":2,"stars":33945,"raw":"https://awesomereviewers.com/raw/crewai-fail-securely-by-default.md"},{"slug":"material-ui-consistent-package-naming","title":"Consistent package naming","description":"Use consistent and meaningful naming patterns for packages based on their purpose, visibility, and scope. This improves clarity in build scripts, dependencies, and during development.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Naming Conventions","language":"Json","updated":"2025-05-09","comments":2,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-consistent-package-naming.md"},{"slug":"playwright-graceful-process-termination","title":"graceful process termination","description":"Implement systematic cleanup mechanisms that handle process termination signals without generating excessive error output. Use a generic disposable pattern to manage resources that need cleanup during exit, SIGINT, or other termination scenarios.","repository":"microsoft/playwright","domain":"devtools","topic":"Error Handling","language":"JavaScript","updated":"2025-05-09","comments":2,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-graceful-process-termination.md"},{"slug":"react-native-use-appropriate-log-levels","title":"Use appropriate log levels","description":"Choose logging levels that match the intended audience and purpose of the message. Use debug or silent logging for internal operations, optional behaviors, and retry logic that shouldn't be visible to end users. Reserve console output and higher log levels (info, warning, error) for user-relevant information.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Logging","language":"JavaScript","updated":"2025-05-09","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-use-appropriate-log-levels.md"},{"slug":"union-organize-for-readability","title":"organize for readability","description":"Structure code to minimize repetition and improve clarity through appropriate abstraction and import organization. When code contains repetitive patterns, create wrapper functions to eliminate boilerplate. For modules with structured exports (like ADTs), prefer qualified imports over individual named imports to maintain clear namespace organization.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Code Style","language":"TypeScript","updated":"2025-05-09","comments":2,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-organize-for-readability.md"},{"slug":"tokio-optimize-algorithmic-complexity","title":"Optimize algorithmic complexity","description":"Always consider the time and space complexity implications of your code. Choose data structures and algorithms that minimize computational overhead and memory usage for your specific use cases.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Algorithms","language":"Rust","updated":"2025-05-08","comments":8,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-optimize-algorithmic-complexity.md"},{"slug":"tokio-use-option-methods-idiomatically","title":"Use Option methods idiomatically","description":"When dealing with Optional values, prefer Rust's built-in Option methods over manual null checks. This makes code more concise, self-documenting, and less error-prone by leveraging Rust's type system to enforce null safety at compile time.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Null Handling","language":"Rust","updated":"2025-05-08","comments":6,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-use-option-methods-idiomatically.md"},{"slug":"inbox-zero-ensure-api-contract-integrity","title":"Ensure API contract integrity","description":"Maintain strict consistency between API implementation and contract by ensuring: 1. Request/response schemas match exactly between client and server 2. All required parameters are validated and documented","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2025-05-08","comments":4,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-ensure-api-contract-integrity.md"},{"slug":"opentofu-minimize-api-surface","title":"Minimize API surface","description":"Design APIs with minimal exposed surface by encapsulating implementation details within packages. When designing APIs, expose only what's necessary for consumers while keeping internal details hidden.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"API","language":"Go","updated":"2025-05-08","comments":4,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-minimize-api-surface.md"},{"slug":"ai-consistent-ai-interfaces","title":"Consistent AI interfaces","description":"Maintain consistent naming patterns and parameter structures across AI provider implementations. This makes the SDK more intuitive and reduces developer friction when switching between different AI models or providers.","repository":"vercel/ai","domain":"ai-agents","topic":"AI","language":"Markdown","updated":"2025-05-08","comments":2,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-consistent-ai-interfaces.md"},{"slug":"tokio-write-focused-single-purpose-tests","title":"Write focused single-purpose tests","description":"Break down large test cases into smaller, focused tests that each verify a single feature or behavior. Each test should have a clear purpose that is evident from its name and structure. This improves test maintainability, readability, and makes failures easier to debug.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Testing","language":"Rust","updated":"2025-05-07","comments":8,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-write-focused-single-purpose-tests.md"},{"slug":"turborepo-design-ergonomic-apis","title":"Design ergonomic APIs","description":"Create APIs that are both easy to use correctly and hard to use incorrectly. Focus on: 1. **Use pattern matching for safer error handling** instead of unwrapping values that might be null:","repository":"vercel/turborepo","domain":"devtools","topic":"API","language":"Rust","updated":"2025-05-07","comments":5,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-design-ergonomic-apis.md"},{"slug":"maplibre-native-enforce-clear-data-ownership","title":"Enforce clear data ownership","description":"Always establish and maintain clear ownership semantics in concurrent code to prevent data races. This includes: 1. Use RAII patterns for resource management (especially locks)","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Concurrency","language":"C++","updated":"2025-05-07","comments":4,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-enforce-clear-data-ownership.md"},{"slug":"maplibre-native-dry-class-hierarchies","title":"DRY class hierarchies","description":"Follow the Don't Repeat Yourself (DRY) principle when designing class hierarchies. Extract common functionality into base classes and avoid duplicating state or methods in subclasses. When extending a class, delegate to parent implementations rather than redefining functionality.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Code Style","language":"Java","updated":"2025-05-07","comments":3,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-dry-class-hierarchies.md"},{"slug":"maplibre-native-prefer-values-over-pointers","title":"Prefer values over pointers","description":"When designing classes and interfaces, prefer passing lightweight objects by value rather than using raw pointers or converting smart pointers to raw pointers using `.get()`. This eliminates the risk of null dereferences and dangling pointer issues.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Null Handling","language":"Other","updated":"2025-05-07","comments":3,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-prefer-values-over-pointers.md"},{"slug":"argo-cd-validate-conceptual-api-types","title":"validate conceptual API types","description":"When defining API types, enums, or interfaces, ensure they represent accurate conceptual distinctions within the domain model rather than implementation details or delivery mechanisms. Each type should correspond to a meaningful category that users and developers can clearly understand and differentiate.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"API","language":"TypeScript","updated":"2025-05-07","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-validate-conceptual-api-types.md"},{"slug":"codex-workspace-version-configuration","title":"Workspace version configuration","description":"Standardize version management across multi-crate Rust projects by using workspace versioning. This reduces duplication and ensures consistency across all crates in your project.","repository":"openai/codex","domain":"ai-agents","topic":"Configurations","language":"Toml","updated":"2025-05-07","comments":2,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-workspace-version-configuration.md"},{"slug":"mastodon-leverage-build-tool-automation","title":"leverage build tool automation","description":"Modern build tools like Vite automatically handle many performance optimizations that previously required manual implementation. Trust these automated capabilities rather than duplicating effort with manual resource hints and preloading directives.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Performance Optimization","language":"Other","updated":"2025-05-07","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-leverage-build-tool-automation.md"},{"slug":"supabase-safe-database-operations","title":"Safe database operations","description":"When modifying database structures or executing dynamic SQL queries, prioritize both performance and safety: 1. **Use non-blocking operations** for schema changes in production databases. For example, when creating indexes on potentially busy tables, use `CREATE INDEX CONCURRENTLY` instead of standard `CREATE INDEX`:","repository":"supabase/supabase","domain":"data-systems","topic":"Database","language":"TypeScript","updated":"2025-05-07","comments":2,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-safe-database-operations.md"},{"slug":"vscode-configuration-naming-conventions","title":"Configuration naming conventions","description":"When adding new configuration settings, follow these naming conventions to maintain consistency and clarity: 1. **For related components**: Use a unified setting with resource scope instead of creating duplicate settings. For example, instead of having separate `typescript.maximumHoverLength` and `javascript.maximumHoverLength` settings, create a single...","repository":"microsoft/vscode","domain":"devtools","topic":"Configurations","language":"Json","updated":"2025-05-07","comments":2,"stars":174887,"raw":"https://awesomereviewers.com/raw/vscode-configuration-naming-conventions.md"},{"slug":"browser-use-prefer-authentication-tokens","title":"prefer authentication tokens","description":"When configuring authentication in CI/CD workflows, prefer using tokens over passwords for enhanced security. Tokens can be scoped with specific permissions, rotated more easily, and provide better audit trails compared to passwords. This is particularly important for service-to-service authentication where credentials are stored as secrets.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Security","language":"Yaml","updated":"2025-05-07","comments":1,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-prefer-authentication-tokens.md"},{"slug":"litellm-design-extensible-permission-systems","title":"Design extensible permission systems","description":"When implementing authorization features, design permission systems that can accommodate future security requirements rather than adding permissions directly to existing tables. Create dedicated permission tables with proper relationships to entity tables to ensure authorization can be properly enforced.","repository":"BerriAI/litellm","domain":"llm-infra","topic":"Security","language":"Prisma","updated":"2025-05-07","comments":1,"stars":28310,"raw":"https://awesomereviewers.com/raw/litellm-design-extensible-permission-systems.md"},{"slug":"ghostty-documentation-clarity-and-formatting","title":"Documentation clarity and formatting","description":"Ensure documentation is clear, precise, and consistently formatted. Key practices include: 1. **Be explicit and unambiguous** - Define terms that might be unclear and provide specific guidance:","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Documentation","language":"Yaml","updated":"2025-05-06","comments":8,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-documentation-clarity-and-formatting.md"},{"slug":"rails-minimize-unnecessary-object-allocations","title":"Minimize unnecessary object allocations","description":"Avoid creating unnecessary objects, especially in frequently executed code paths. This includes being mindful of implicit object allocations from common Ruby operations like array methods, string concatenations, and temporary variable creation.","repository":"rails/rails","domain":"app-frameworks","topic":"Performance Optimization","language":"Ruby","updated":"2025-05-06","comments":6,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-minimize-unnecessary-object-allocations.md"},{"slug":"browser-use-optimize-ci-performance","title":"optimize CI performance","description":"Structure CI workflows to minimize execution time and resource usage through strategic job organization, caching, and elimination of redundant operations.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"CI/CD","language":"Yaml","updated":"2025-05-06","comments":4,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-optimize-ci-performance.md"},{"slug":"ollama-reuse-buffers-strategically","title":"Reuse buffers strategically","description":"For frequently called methods or hot code paths, reuse allocations instead of creating new buffers on each call. This significantly reduces GC pressure and improves performance in memory-intensive operations.","repository":"ollama/ollama","domain":"llm-infra","topic":"Performance Optimization","language":"Go","updated":"2025-05-06","comments":4,"stars":145704,"raw":"https://awesomereviewers.com/raw/ollama-reuse-buffers-strategically.md"},{"slug":"zed-hierarchical-configuration-organization","title":"Hierarchical configuration organization","description":"Organize configuration settings hierarchically by grouping related settings under meaningful namespaces rather than creating numerous top-level settings. This improves maintainability, discoverability, and reduces configuration sprawl as your application grows.","repository":"zed-industries/zed","domain":"devtools","topic":"Configurations","language":"Json","updated":"2025-05-06","comments":3,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-hierarchical-configuration-organization.md"},{"slug":"supabase-connection-resilience-patterns","title":"Connection resilience patterns","description":"Implement resilient networking connections with retry mechanisms for all client-service interactions. When establishing connections to external services or databases, include proper retry logic with backoff strategies to handle temporary network instabilities or service unavailability. Monitor connection counts and states across different connection types...","repository":"supabase/supabase","domain":"data-systems","topic":"Networking","language":"TypeScript","updated":"2025-05-06","comments":2,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-connection-resilience-patterns.md"},{"slug":"quarkus-clear-database-configuration-examples","title":"Clear database configuration examples","description":"Database configuration examples in documentation should be correct, minimal, and include proper context. Provide only essential configuration properties rather than defaults or environment-specific values that would change in production. Use proper syntax and be precise about component interactions.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Database","language":"Other","updated":"2025-05-05","comments":5,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-clear-database-configuration-examples.md"},{"slug":"material-ui-standardize-code-formatting-patterns","title":"Standardize code formatting patterns","description":"Maintain consistent code formatting patterns across the codebase to improve readability and maintainability. This includes: 1. Use consistent spacing and indentation","repository":"mui/material-ui","domain":"app-frameworks","topic":"Code Style","language":"Markdown","updated":"2025-05-05","comments":4,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-standardize-code-formatting-patterns.md"},{"slug":"opencv-document-properly-with-references","title":"Document properly with references","description":"Always separate code from documentation and use proper referencing techniques. Documentation should be in markdown files when extensive, while code should be in files that are regularly checked for compilation.","repository":"opencv/opencv","domain":"ml-systems","topic":"Documentation","language":"Other","updated":"2025-05-05","comments":4,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-document-properly-with-references.md"},{"slug":"argo-cd-validate-configuration-appropriateness","title":"Validate configuration appropriateness","description":"Ensure configurations are contextually appropriate and properly validated for their intended use case. This includes verifying that configuration options are suitable for the target resource type, handling configuration state transitions correctly, and choosing appropriate dependencies.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Configurations","language":"Other","updated":"2025-05-05","comments":3,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-validate-configuration-appropriateness.md"},{"slug":"continue-layer-documentation-by-complexity","title":"Layer documentation by complexity","description":"Structure documentation to be approachable for beginners while remaining comprehensive for all users. Keep main pages focused on common use cases with simplified examples, and move advanced configurations to separate, linked sections. When documenting features, start with basic usage before detailing exceptions or edge cases.","repository":"continuedev/continue","domain":"ai-agents","topic":"Documentation","language":"Other","updated":"2025-05-05","comments":2,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-layer-documentation-by-complexity.md"},{"slug":"duckdb-preserve-api-backward-compatibility","title":"Preserve API backward compatibility","description":"When modifying existing APIs, ensure that current usage patterns continue to work unchanged. This applies to command-line interfaces, library APIs, REST endpoints, and any client-facing interfaces. Always provide migration paths that maintain existing behavior while introducing improvements.","repository":"duckdb/duckdb","domain":"data-systems","topic":"API","language":"Python","updated":"2025-05-05","comments":2,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-preserve-api-backward-compatibility.md"},{"slug":"mastodon-framework-aware-text-composition","title":"Framework-aware text composition","description":"When writing user-facing text (error messages, notifications, labels), understand how your framework automatically processes and modifies that text before it reaches users. Many frameworks like Rails automatically combine messages with attribute names or apply other transformations that can result in redundant or grammatically incorrect output.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Documentation","language":"Yaml","updated":"2025-05-05","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-framework-aware-text-composition.md"},{"slug":"prometheus-avoid-github-template-injection","title":"avoid GitHub template injection","description":"Avoid using GitHub workflow template expressions `${{ }}` directly in shell commands within `run:` steps, as this can lead to template injection vulnerabilities. Untrusted input like branch names, PR titles, or commit messages can be crafted to execute arbitrary code since GitHub template expansion happens before workflow execution.","repository":"prometheus/prometheus","domain":"observability","topic":"Security","language":"Yaml","updated":"2025-05-05","comments":1,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-avoid-github-template-injection.md"},{"slug":"helix-minimize-allocations-and-syscalls","title":"Minimize allocations and syscalls","description":"Optimize performance by minimizing unnecessary memory allocations and system calls. Key practices: 1. Avoid unnecessary String allocations: ```rust // Instead of","repository":"helix-editor/helix","domain":"devtools","topic":"Performance Optimization","language":"Rust","updated":"2025-05-04","comments":10,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-minimize-allocations-and-syscalls.md"},{"slug":"ollama-comprehensive-test-coverage","title":"Comprehensive test coverage","description":"Test functions should provide comprehensive coverage of both expected and edge cases. Include tests for: 1. **Boundary conditions**: Test zero, minimum, maximum values, and other special cases.","repository":"ollama/ollama","domain":"llm-infra","topic":"Testing","language":"Go","updated":"2025-05-04","comments":5,"stars":145704,"raw":"https://awesomereviewers.com/raw/ollama-comprehensive-test-coverage.md"},{"slug":"node-export-environment-variables-once","title":"Export environment variables once","description":"When writing shell scripts, set and export all environment variables at the top of the script rather than modifying them repeatedly throughout the script. This improves readability, maintainability, and prevents inconsistent environments between commands.","repository":"nodejs/node","domain":"runtimes","topic":"Configurations","language":"Shell","updated":"2025-05-04","comments":3,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-export-environment-variables-once.md"},{"slug":"parlant-make-test-descriptions-specific","title":"Make test descriptions specific","description":"Test scenarios and steps should use specific, descriptive language that clearly communicates what is being tested and what behavior is expected. Avoid vague or ambiguous terms that leave room for interpretation.","repository":"emcie-co/parlant","domain":"ai-agents","topic":"Documentation","language":"Other","updated":"2025-05-04","comments":2,"stars":12205,"raw":"https://awesomereviewers.com/raw/parlant-make-test-descriptions-specific.md"},{"slug":"brew-clear-error-recovery-paths","title":"Clear error recovery paths","description":"Implement error handling that provides both clear recovery paths for users and graceful degradation for the system. This includes: 1. Clear, actionable error messages that guide users to resolution","repository":"Homebrew/brew","domain":"devtools","topic":"Error Handling","language":"Ruby","updated":"2025-05-03","comments":6,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-clear-error-recovery-paths.md"},{"slug":"cline-strategic-telemetry-implementation","title":"Strategic telemetry implementation","description":"Implement telemetry collection strategically to ensure system reliability and meaningful data capture. Place telemetry calls where relevant context is available, use non-blocking patterns for time-sensitive operations, and avoid unnecessary abstraction.","repository":"cline/cline","domain":"ai-agents","topic":"Observability","language":"TypeScript","updated":"2025-05-03","comments":4,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-strategic-telemetry-implementation.md"},{"slug":"django-validate-configuration-changes","title":"Validate configuration changes","description":"Before modifying default configuration settings, thoroughly understand and test their implications. Django's default configurations often include important safeguards that prevent subtle bugs.","repository":"django/django","domain":"app-frameworks","topic":"Configurations","language":"Txt","updated":"2025-05-03","comments":3,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-validate-configuration-changes.md"},{"slug":"mastodon-optimize-collection-iterations","title":"optimize collection iterations","description":"Avoid multiple passes through the same data structure when a single iteration can accomplish the same work. This reduces computational complexity and improves performance, especially for large datasets.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Algorithms","language":"Ruby","updated":"2025-05-03","comments":3,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-optimize-collection-iterations.md"},{"slug":"union-clean-documentation-links","title":"Clean documentation links","description":"When writing Rust documentation links, separate the display name from the full path to improve readability of generated docs. Use the short type name as the display text and provide the full path as the link target. This makes the documentation less noisy and easier to read.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Documentation","language":"Rust","updated":"2025-05-03","comments":2,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-clean-documentation-links.md"},{"slug":"poetry-prefer-simple-readable-code","title":"prefer simple readable code","description":"Write code that prioritizes clarity and simplicity over cleverness. This improves maintainability and reduces cognitive load for other developers. Key practices:","repository":"python-poetry/poetry","domain":"devtools","topic":"Code Style","language":"Python","updated":"2025-05-02","comments":10,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-prefer-simple-readable-code.md"},{"slug":"temporal-ensure-deterministic-execution","title":"Ensure deterministic execution","description":"When working with Temporal workflows, maintaining deterministic behavior\\ \\ is critical for reliable replay and execution across distributed systems. \\n\\n\\ Key practices:","repository":"temporalio/temporal","domain":"orchestration","topic":"Temporal","language":"Go","updated":"2025-05-02","comments":4,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-ensure-deterministic-execution.md"},{"slug":"spark-proper-synchronization-patterns","title":"Proper synchronization patterns","description":"When implementing synchronization mechanisms, avoid common anti-patterns that can lead to performance issues or incorrect behavior. Use proper condition variables with timeouts instead of indefinite or busy waiting, and ensure condition checks occur after wait operations.","repository":"apache/spark","domain":"data-systems","topic":"Concurrency","language":"Other","updated":"2025-05-02","comments":3,"stars":41554,"raw":"https://awesomereviewers.com/raw/spark-proper-synchronization-patterns.md"},{"slug":"duckdb-maintain-formatting-consistency","title":"maintain formatting consistency","description":"Ensure consistent formatting patterns and styles throughout the codebase, both when writing new code and refactoring existing code. When making style improvements or refactoring, preserve the original behavior while applying consistent formatting standards.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Code Style","language":"Python","updated":"2025-05-02","comments":2,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-maintain-formatting-consistency.md"},{"slug":"vitess-size-fields-appropriately","title":"Size fields appropriately","description":"When designing database schemas, choose field types and sizes that accommodate both current and anticipated future data volumes. Undersized fields can cause production issues and limit functionality when data grows beyond initial expectations. Additionally, ensure consistency between related fields that store similar data or participate in the same...","repository":"vitessio/vitess","domain":"data-systems","topic":"Database","language":"Sql","updated":"2025-05-02","comments":2,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-size-fields-appropriately.md"},{"slug":"cline-avoid-interactive-authentication-automation","title":"avoid interactive authentication automation","description":"When building scripts or applications that require user authentication, avoid automating interactive authentication processes that could cause system instability or security issues. Instead, check authentication status programmatically and delegate the actual authentication to the user.","repository":"cline/cline","domain":"ai-agents","topic":"Security","language":"JavaScript","updated":"2025-05-02","comments":1,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-avoid-interactive-authentication-automation.md"},{"slug":"turborepo-propagate-errors-with-context","title":"Propagate errors with context","description":"Properly propagate errors to callers with sufficient context rather than handling them prematurely or hiding them. Let the caller decide how to handle errors when they have the appropriate context.","repository":"vercel/turborepo","domain":"devtools","topic":"Error Handling","language":"Rust","updated":"2025-05-01","comments":9,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-propagate-errors-with-context.md"},{"slug":"react-router-hook-dependencies-stability","title":"Hook dependencies stability","description":"Ensure hook dependencies are minimal, stable, and follow React''s rules to prevent unnecessary re-renders and maintain predictable behavior. This includes:","repository":"remix-run/react-router","domain":"app-frameworks","topic":"React","language":"TSX","updated":"2025-05-01","comments":6,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-hook-dependencies-stability.md"},{"slug":"router-enhance-code-clarity","title":"Enhance code clarity","description":"Ensure all code examples and documentation are as clear and complete as possible for developers. This includes adding clarifying inline comments to explain non-obvious behavior, including all necessary import statements, and structuring information for maximum readability.","repository":"TanStack/router","domain":"app-frameworks","topic":"React","language":"Markdown","updated":"2025-05-01","comments":6,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-enhance-code-clarity.md"},{"slug":"ai-consistent-provider-options","title":"Consistent provider options","description":"When designing APIs that support multiple providers or service integrations, implement consistent patterns for handling provider-specific options. This includes proper validation, separation of request vs. non-request options, and clear type definitions.","repository":"vercel/ai","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2025-05-01","comments":5,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-consistent-provider-options.md"},{"slug":"lobe-chat-api-parameter-consolidation","title":"API parameter consolidation","description":"When designing API functions with multiple parameters, consolidate optional or related parameters into a single options object to improve extensibility and maintainability. This pattern prevents function signatures from becoming unwieldy and allows for easier future parameter additions without breaking changes.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2025-05-01","comments":5,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-api-parameter-consolidation.md"},{"slug":"ollama-document-synchronization-intent","title":"Document synchronization intent","description":"Always clearly document the purpose and scope of synchronization primitives (mutexes, read-write locks) by: 1. Placing them directly adjacent to the data they protect","repository":"ollama/ollama","domain":"llm-infra","topic":"Concurrency","language":"Go","updated":"2025-05-01","comments":5,"stars":145704,"raw":"https://awesomereviewers.com/raw/ollama-document-synchronization-intent.md"},{"slug":"quarkus-document-public-apis","title":"Document public APIs","description":"All public APIs, interfaces, and methods should include comprehensive JavaDoc that clearly explains their purpose, parameters, return values, and any non-obvious behaviors. This is especially important for:","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Documentation","language":"Java","updated":"2025-05-01","comments":5,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-document-public-apis.md"},{"slug":"codex-leverage-style-tools","title":"Leverage style tools","description":"Maintain consistent code style by using and respecting the project's established formatting tools and patterns. Run linters and formatters (`pnpm run format`, `pnpm run lint`) before committing code. Organize logical expressions for clarity and consistency, and prefer language constructs that work well with static analysis tools.","repository":"openai/codex","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2025-05-01","comments":4,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-leverage-style-tools.md"},{"slug":"ollama-optimize-ai-implementation-patterns","title":"Optimize AI implementation patterns","description":"When implementing AI systems, prioritize established patterns and optimizations rather than creating new implementations for existing problems. This applies to all aspects of AI development:","repository":"ollama/ollama","domain":"llm-infra","topic":"AI","language":"Other","updated":"2025-05-01","comments":3,"stars":145705,"raw":"https://awesomereviewers.com/raw/ollama-optimize-ai-implementation-patterns.md"},{"slug":"vite-explicit-version-requirements","title":"Explicit version requirements","description":"Always specify explicit Node.js version requirements in configuration files to ensure compatibility with language features and APIs. When updating supported versions, verify feature compatibility and document reasoning behind version constraints.","repository":"vitejs/vite","domain":"devtools","topic":"Configurations","language":"JavaScript","updated":"2025-05-01","comments":2,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-explicit-version-requirements.md"},{"slug":"quarkus-standardize-configuration-paths","title":"Standardize configuration paths","description":"Follow consistent patterns for storing and referencing configuration files across projects. Place custom configuration files in standardized locations (e.g., `src/main/docker` for Dockerfiles, `.s2i` for S2I environment files) and use consistent naming conventions. When referencing file paths in configuration properties, use relative paths from the project...","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2025-04-30","comments":10,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-standardize-configuration-paths.md"},{"slug":"crewai-structure-errors-with-intent","title":"Structure errors with intent","description":"Implement error handling with clear intent and proper propagation. Follow these principles: 1. Use structured try/catch blocks with specific error types","repository":"crewaiinc/crewai","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2025-04-30","comments":6,"stars":33945,"raw":"https://awesomereviewers.com/raw/crewai-structure-errors-with-intent.md"},{"slug":"turborepo-eliminate-code-duplication","title":"Eliminate code duplication","description":"Avoid duplicating logic, patterns, or data across the codebase. When similar code appears in multiple places, extract it into reusable functions or methods.","repository":"vercel/turborepo","domain":"devtools","topic":"Code Style","language":"Rust","updated":"2025-04-30","comments":6,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-eliminate-code-duplication.md"},{"slug":"terraform-prefer-modern-authentication","title":"Prefer modern authentication","description":"Always use modern identity-based authentication methods instead of static credentials when accessing external systems. This reduces security risks associated with credential management, rotation, and potential exposure.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Security","language":"Other","updated":"2025-04-30","comments":5,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-prefer-modern-authentication.md"},{"slug":"netty-configurable-over-hardcoded","title":"Configurable over hardcoded","description":"Make configuration parameters configurable rather than hardcoding values, especially for limits, sizes, and thresholds. Provide reasonable defaults but allow users to override through:","repository":"netty/netty","domain":"runtimes","topic":"Configurations","language":"Java","updated":"2025-04-30","comments":4,"stars":34227,"raw":"https://awesomereviewers.com/raw/netty-configurable-over-hardcoded.md"},{"slug":"opentofu-proper-span-lifecycle","title":"Proper span lifecycle","description":"Always ensure trace spans are properly closed in all code execution paths to prevent trace leaks that can distort observability data. This is particularly critical when creating spans within loops, conditional blocks, or functions with multiple exit points.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Observability","language":"Go","updated":"2025-04-30","comments":4,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-proper-span-lifecycle.md"},{"slug":"prowler-document-authentication-requirements","title":"Document authentication requirements","description":"When creating or modifying APIs, always provide comprehensive documentation for authentication methods and prerequisites. For each authentication approach:","repository":"prowler-cloud/prowler","domain":"security","topic":"API","language":"Markdown","updated":"2025-04-30","comments":4,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-document-authentication-requirements.md"},{"slug":"react-native-preserve-component-patterns","title":"preserve component patterns","description":"When refactoring React components, maintain essential component patterns including type annotations, ref forwarding capabilities, and thoughtful component composition. Avoid losing important functionality during simplification.","repository":"facebook/react-native","domain":"app-frameworks","topic":"React","language":"JavaScript","updated":"2025-04-30","comments":4,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-preserve-component-patterns.md"},{"slug":"crewai-clear-ai-component-interfaces","title":"Clear AI component interfaces","description":"When designing AI components and tools, use domain-specific terminology and provide clear interface documentation to enhance usability and integration. This includes:","repository":"crewaiinc/crewai","domain":"ai-agents","topic":"AI","language":"Other","updated":"2025-04-30","comments":3,"stars":33945,"raw":"https://awesomereviewers.com/raw/crewai-clear-ai-component-interfaces.md"},{"slug":"router-choose-efficient-algorithms","title":"Choose efficient algorithms","description":"Prefer built-in methods and appropriate data structures over manual implementations to improve both performance and code readability. Consider the computational complexity and trade-offs of different approaches.","repository":"TanStack/router","domain":"app-frameworks","topic":"Algorithms","language":"TSX","updated":"2025-04-30","comments":3,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-choose-efficient-algorithms.md"},{"slug":"nuxt-consistent-code-formatting","title":"consistent code formatting","description":"Maintain consistent formatting standards across code and documentation to improve readability and maintainability. This includes proper ordering of logical conditions and consistent use of backticks for code values in comments.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"React","language":"TypeScript","updated":"2025-04-30","comments":2,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-consistent-code-formatting.md"},{"slug":"prisma-consistent-error-object-usage","title":"consistent error object usage","description":"Always use proper Error objects when throwing exceptions, maintain consistent error handling contracts, and ensure type safety in error scenarios. Avoid throwing primitive strings, mixing throw/return patterns, or unsafe type assertions on error objects.","repository":"prisma/prisma","domain":"data-systems","topic":"Error Handling","language":"TypeScript","updated":"2025-04-29","comments":7,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-consistent-error-object-usage.md"},{"slug":"electron-ensure-comprehensive-test-coverage","title":"Ensure comprehensive test coverage","description":"Always verify that tests cover all relevant scenarios, edge cases, and conditions rather than just the happy path. When reviewing or writing tests, actively look for missing test cases and suggest additional coverage.","repository":"electron/electron","domain":"devtools","topic":"Testing","language":"TypeScript","updated":"2025-04-29","comments":6,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-ensure-comprehensive-test-coverage.md"},{"slug":"terraform-include-descriptive-documentation","title":"Include descriptive documentation","description":"Provide complete, clear descriptions for all configuration elements in documentation. Every output, variable, argument, and configuration option should include descriptive text explaining its purpose, requirements, and usage from the consumer's perspective.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Documentation","language":"Other","updated":"2025-04-29","comments":5,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-include-descriptive-documentation.md"},{"slug":"deno-prefer-safe-optional-returns","title":"prefer safe optional returns","description":"When designing APIs and handling potentially missing or unavailable values, prefer returning optional types (Option<T>, Result<T, E>) over operations that can panic or fail unsafely. This promotes defensive programming and null safety.","repository":"denoland/deno","domain":"runtimes","topic":"Null Handling","language":"Rust","updated":"2025-04-29","comments":4,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-prefer-safe-optional-returns.md"},{"slug":"stagehand-organize-code-properly","title":"organize code properly","description":"Maintain clear code organization by placing code in appropriate files, directories, and modules. Respect module boundaries and create logical directory structures that reflect the code's purpose and domain.","repository":"browserbase/stagehand","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2025-04-29","comments":4,"stars":16443,"raw":"https://awesomereviewers.com/raw/stagehand-organize-code-properly.md"},{"slug":"terraform-ensure-test-isolation","title":"Ensure test isolation","description":"Tests should be completely isolated from each other and clean up after\\ \\ themselves to prevent interference. \\n\\n1. **Use testing utilities properly**:\\ \\ Leverage the standard library's testing helpers correctly.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Testing","language":"Go","updated":"2025-04-29","comments":4,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-ensure-test-isolation.md"},{"slug":"ai-validate-pattern-matching","title":"Validate pattern matching","description":"When implementing algorithms that involve pattern matching or data parsing, ensure robustness across all edge cases and clearly document the algorithm''s behavior. This is particularly important for:","repository":"vercel/ai","domain":"ai-agents","topic":"Algorithms","language":"TypeScript","updated":"2025-04-29","comments":3,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-validate-pattern-matching.md"},{"slug":"bazel-environment-aware-configuration-testing","title":"Environment-aware configuration testing","description":"When writing tests for configuration-dependent functionality, implement environment detection and conditional logic to handle platform-specific differences. Tests should detect system capabilities and adjust expectations accordingly rather than assuming uniform behavior across all environments.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Configurations","language":"Shell","updated":"2025-04-29","comments":3,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-environment-aware-configuration-testing.md"},{"slug":"deno-add-comprehensive-test-coverage","title":"Add comprehensive test coverage","description":"Ensure that all functionality, especially complex or quirky features, has corresponding unit tests. When adding new features or modifying existing code, proactively identify areas that lack test coverage and add appropriate tests.","repository":"denoland/deno","domain":"runtimes","topic":"Testing","language":"Rust","updated":"2025-04-29","comments":3,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-add-comprehensive-test-coverage.md"},{"slug":"deno-choose-appropriate-algorithms","title":"Choose appropriate algorithms","description":"When implementing functionality, carefully evaluate different algorithmic approaches and data structures to choose the most appropriate solution. Consider factors like performance requirements, correctness, maintainability, and whether existing libraries can be leveraged instead of custom implementations.","repository":"denoland/deno","domain":"runtimes","topic":"Algorithms","language":"Rust","updated":"2025-04-29","comments":3,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-choose-appropriate-algorithms.md"},{"slug":"dify-balance-cicd-trade-offs","title":"Balance CI/CD trade-offs","description":"When configuring CI/CD pipelines, balance comprehensive coverage and security with practical constraints like resource usage, tool compatibility, and project context. Avoid blindly applying best practices without considering their impact on functionality and efficiency.","repository":"langgenius/dify","domain":"llm-infra","topic":"CI/CD","language":"Yaml","updated":"2025-04-29","comments":3,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-balance-cicd-trade-offs.md"},{"slug":"cline-optimize-workflow-maintainability","title":"optimize workflow maintainability","description":"Design CI/CD workflows for long-term maintainability by using consolidated commands and extracting reusable components. Instead of listing individual build steps that may change over time, prefer consolidated npm scripts like `npm run pretest` that encapsulate the full build process. This approach reduces the need to update workflows when underlying build...","repository":"cline/cline","domain":"ai-agents","topic":"CI/CD","language":"Yaml","updated":"2025-04-29","comments":2,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-optimize-workflow-maintainability.md"},{"slug":"mastodon-use-semantic-null-handling","title":"Use semantic null handling","description":"When designing APIs and data structures, be intentional about null and undefined usage. Use null and undefined with distinct semantic meanings rather than interchangeably. For example, undefined can indicate \"not yet loaded\" while null indicates \"does not exist\". However, avoid nullable types when simpler alternatives serve the same purpose - if an empty...","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Null Handling","language":"TypeScript","updated":"2025-04-29","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-use-semantic-null-handling.md"},{"slug":"material-ui-use-direct-path-imports","title":"Use direct path imports","description":"For optimal performance, use direct path imports instead of barrel imports when working with UI component libraries like Material UI. This practice improves both production bundle size through better tree-shaking and significantly enhances development server performance.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Performance Optimization","language":"Markdown","updated":"2025-04-29","comments":2,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-use-direct-path-imports.md"},{"slug":"prometheus-use-proper-configuration-tooling","title":"Use proper configuration tooling","description":"When working with configuration files and values, prefer dedicated tools and canonical sources over manual text manipulation or secondary configuration files. Use language-specific tools for modifications (e.g., `go mod edit -go=1.23` instead of `sed` commands on go.mod) and extract configuration values from their primary sources rather than derived files.","repository":"prometheus/prometheus","domain":"observability","topic":"Configurations","language":"Shell","updated":"2025-04-29","comments":2,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-use-proper-configuration-tooling.md"},{"slug":"prowler-parameterize-configuration-values","title":"Parameterize configuration values","description":"Always extract configuration values (like versions, paths, or other changeable settings) into parameters rather than hardcoding them directly in multiple places. This creates a single source of truth, simplifies updates, and makes your code more maintainable.","repository":"prowler-cloud/prowler","domain":"security","topic":"Configurations","language":"Dockerfile","updated":"2025-04-29","comments":2,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-parameterize-configuration-values.md"},{"slug":"signoz-avoid-inline-object-creation","title":"avoid inline object creation","description":"Inline objects and functions created within render methods are recreated on every render, causing unnecessary re-renders of child components when passed as props. This impacts performance by triggering component updates even when the actual functionality hasn't changed.","repository":"SigNoz/signoz","domain":"observability","topic":"Performance Optimization","language":"TSX","updated":"2025-04-29","comments":2,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-avoid-inline-object-creation.md"},{"slug":"uv-cache-sharing-strategy","title":"Cache sharing strategy","description":"When implementing caching in build systems, carefully configure cache sharing behavior based on your concurrency requirements. Improper sharing settings can lead to build failures when multiple processes attempt to access the same cache simultaneously.","repository":"astral-sh/uv","domain":"devtools","topic":"Caching","language":"Dockerfile","updated":"2025-04-29","comments":2,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-cache-sharing-strategy.md"},{"slug":"uv-optimize-docker-build-caching","title":"Optimize docker build caching","description":"Leverage Docker BuildKit's cache and bind mount capabilities to dramatically improve CI build times and reduce image sizes. Instead of copying source files into intermediate layers, use bind mounts to provide build context and cache mounts for package managers and build artifacts.","repository":"astral-sh/uv","domain":"devtools","topic":"CI/CD","language":"Dockerfile","updated":"2025-04-29","comments":2,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-optimize-docker-build-caching.md"},{"slug":"netty-document-public-apis","title":"Document public APIs","description":"All public-facing APIs must be thoroughly documented with clear javadocs. This includes: 1. **Classes and interfaces**: When creating or changing a class/interface to public visibility, add comprehensive documentation explaining its purpose and usage.","repository":"netty/netty","domain":"runtimes","topic":"Documentation","language":"Java","updated":"2025-04-28","comments":9,"stars":34227,"raw":"https://awesomereviewers.com/raw/netty-document-public-apis.md"},{"slug":"opencv-use-optimized-functions","title":"Use optimized functions","description":"When implementing algorithms, prefer using OpenCV's built-in optimized functions over writing custom implementations. OpenCV's library functions are typically vectorized, extensively tested, and optimized for performance across different platforms and hardware architectures.","repository":"opencv/opencv","domain":"ml-systems","topic":"Algorithms","language":"C++","updated":"2025-04-28","comments":7,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-use-optimized-functions.md"},{"slug":"vitess-optimize-data-structures","title":"Optimize data structures","description":"Choose and implement data structures with careful consideration of algorithmic complexity, memory usage, and Go''s specific performance characteristics. Pay attention to:","repository":"vitessio/vitess","domain":"data-systems","topic":"Algorithms","language":"Go","updated":"2025-04-28","comments":6,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-optimize-data-structures.md"},{"slug":"pydantic-write-targeted-specific-tests","title":"Write targeted, specific tests","description":"Tests should validate specific, well-defined behaviors with clear assertions that directly relate to what's being tested. Avoid writing overly general or unfocused tests that try to cover too much at once, as these are often harder to maintain and debug when they fail.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Testing","language":"Python","updated":"2025-04-28","comments":4,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-write-targeted-specific-tests.md"},{"slug":"langchainjs-consistent-ai-naming","title":"Consistent AI naming","description":"Use specific and consistent naming conventions when referencing AI services, models, and their parameters throughout your codebase. Always include the full provider name (e.g., \"AzureOpenAI\" instead of just \"Azure\") to clearly distinguish between different AI services and avoid ambiguity.","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"AI","language":"JavaScript","updated":"2025-04-28","comments":3,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-consistent-ai-naming.md"},{"slug":"zed-maintain-consistent-naming","title":"Maintain consistent naming","description":"Ensure naming follows consistent patterns throughout the codebase in both style and structure: 1. Use agreed-upon case style for identifiers (e.g., snake_case for functions):","repository":"zed-industries/zed","domain":"devtools","topic":"Naming Conventions","language":"Other","updated":"2025-04-28","comments":3,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-maintain-consistent-naming.md"},{"slug":"comfyui-structure-documentation-comprehensively","title":"Structure documentation comprehensively","description":"Documentation should provide complete, practical information while maintaining logical organization and information hierarchy. Ensure sections include all necessary details for users to successfully implement or understand the feature, and organize content to flow logically from basic to advanced concepts.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Documentation","language":"Markdown","updated":"2025-04-28","comments":2,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-structure-documentation-comprehensively.md"},{"slug":"langchainjs-platform-appropriate-environment-variables","title":"Platform-appropriate environment variables","description":"Always use the correct syntax for accessing environment variables based on the target platform. In JavaScript/Node.js environments, use `process.env.VARIABLE_NAME` instead of syntaxes from other languages (e.g., Python's `os.environ`).","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Configurations","language":"JavaScript","updated":"2025-04-28","comments":2,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-platform-appropriate-environment-variables.md"},{"slug":"quarkus-spring-di-precedence-rules","title":"Spring DI precedence rules","description":"When developing Quarkus extensions that interact with classes containing Spring annotations (like `@Service`, `@Component`, etc.), ensure your extension respects Spring DI's scope definitions by setting appropriate annotation transformer priorities.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"Spring","language":"Java","updated":"2025-04-28","comments":2,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-spring-di-precedence-rules.md"},{"slug":"neon-prefer-opt-in-security","title":"Prefer opt-in security","description":"When implementing security features that modify data presentation or alter normal data access patterns (like anonymization, masking, or redaction), design them to be explicitly enabled by users rather than activated by default. Default-enabled data transformation creates security and usability concerns as users may not expect or desire their data to be...","repository":"neondatabase/neon","domain":"data-systems","topic":"Security","language":"Dockerfile","updated":"2025-04-28","comments":1,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-prefer-opt-in-security.md"},{"slug":"prowler-nextjs-directory-structure","title":"Next.js directory structure","description":"Keep the Next.js `/app` directory strictly for routing purposes as per framework conventions. Non-routing related code like tools, utilities, and services should be moved to appropriate directories such as `/lib/`. This improves code organization, maintainability, and follows Next.js best practices.","repository":"prowler-cloud/prowler","domain":"security","topic":"Code Style","language":"TypeScript","updated":"2025-04-27","comments":10,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-nextjs-directory-structure.md"},{"slug":"frp-handle-errors-completely","title":"Handle errors completely","description":"Always handle errors comprehensively by checking return values, implementing proper error propagation, and ensuring resources are cleaned up. Errors that are ignored or improperly handled can lead to resource leaks, unexpected behavior, or application crashes.","repository":"fatedier/frp","domain":"cloud-infra","topic":"Error Handling","language":"Go","updated":"2025-04-27","comments":5,"stars":95938,"raw":"https://awesomereviewers.com/raw/frp-handle-errors-completely.md"},{"slug":"traefik-network-information-extraction","title":"Network information extraction","description":"When extracting network information from connections (such as remote addresses, proxy IPs, or forwarded headers), implement robust extraction methods that don't depend on specific connection wrapper ordering or implementation details. Use iterative unwrapping patterns and ensure all relevant network information is properly preserved and forwarded.","repository":"traefik/traefik","domain":"cloud-infra","topic":"Networking","language":"Go","updated":"2025-04-27","comments":4,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-network-information-extraction.md"},{"slug":"vitess-explicit-nil-handling","title":"Explicit nil handling","description":"Always handle nil values explicitly in your code to improve clarity and prevent subtle bugs. When a function needs to deal with potentially nil values:","repository":"vitessio/vitess","domain":"data-systems","topic":"Null Handling","language":"Go","updated":"2025-04-27","comments":4,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-explicit-nil-handling.md"},{"slug":"zed-maintain-style-consistency","title":"Maintain style consistency","description":"Ensure consistent styling is maintained across related elements in the codebase. This applies to: 1. **Visual assets**: Icons and images should match the established dimensions and styling of existing assets.","repository":"zed-industries/zed","domain":"devtools","topic":"Code Style","language":"Other","updated":"2025-04-27","comments":3,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-maintain-style-consistency.md"},{"slug":"browser-use-organize-tests-by-category","title":"organize tests by category","description":"Structure test suites into clear, logical categories and run them as separate CI jobs for better parallelization, maintainability, and failure identification. This approach makes it easier to understand test failures, enables targeted testing, and improves CI performance through parallel execution.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Testing","language":"Yaml","updated":"2025-04-27","comments":2,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-organize-tests-by-category.md"},{"slug":"frp-check-context-cancellation","title":"Check context cancellation","description":"Always implement proper cancellation mechanisms in concurrent code to prevent goroutine leaks and enable timely shutdown. Two key practices: 1. Add context checks at the beginning of loops in goroutines:","repository":"fatedier/frp","domain":"cloud-infra","topic":"Concurrency","language":"Go","updated":"2025-04-27","comments":2,"stars":95938,"raw":"https://awesomereviewers.com/raw/frp-check-context-cancellation.md"},{"slug":"alacritty-avoid-unwrap-on-nullables","title":"Avoid unwrap on nullables","description":"Never use `unwrap()` on nullable values that could reasonably be None, as this can cause crashes that are harder for users to work around than bugs. Instead, provide graceful fallbacks or proper error handling.","repository":"alacritty/alacritty","domain":"devtools","topic":"Null Handling","language":"Rust","updated":"2025-04-26","comments":5,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-avoid-unwrap-on-nullables.md"},{"slug":"union-avoid-hardcoded-configuration","title":"avoid hardcoded configuration","description":"Avoid hardcoding configuration values directly in code. Instead, make parameters configurable through CLI arguments, config files, environment variables, or runtime queries, while providing sensible defaults.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Configurations","language":"Rust","updated":"2025-04-26","comments":3,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-avoid-hardcoded-configuration.md"},{"slug":"prettier-refactor-complex-conditions","title":"refactor complex conditions","description":"Break down complex inline conditions and nested logic into separate, well-named functions or simpler expressions to improve code readability and maintainability.","repository":"prettier/prettier","domain":"devtools","topic":"Code Style","language":"JavaScript","updated":"2025-04-25","comments":9,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-refactor-complex-conditions.md"},{"slug":"compose-environment-variable-validation","title":"Environment variable validation","description":"Always validate environment variables and provide appropriate fallbacks when using them for configuration. Environment variables should be checked for existence and non-empty values before use, with clear fallback behavior defined.","repository":"docker/compose","domain":"orchestration","topic":"Configurations","language":"Go","updated":"2025-04-25","comments":8,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-environment-variable-validation.md"},{"slug":"prettier-prefer-efficient-algorithms","title":"prefer efficient algorithms","description":"Choose more efficient algorithmic approaches by leveraging built-in methods and APIs instead of implementing manual solutions. This includes using iterator methods over manual loops, direct comparisons over complex operations, and existing path traversal APIs over custom implementations.","repository":"prettier/prettier","domain":"devtools","topic":"Algorithms","language":"JavaScript","updated":"2025-04-25","comments":6,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-prefer-efficient-algorithms.md"},{"slug":"opentofu-document-with-examples","title":"Document with examples","description":"Always include clear, contextual examples when documenting APIs, interfaces, or command-line functionality. Examples significantly improve understanding and reduce ambiguity, particularly for new or complex features. Maintain consistent terminology throughout documentation, avoiding unexplained jargon or abbreviations.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"API","language":"Markdown","updated":"2025-04-25","comments":5,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-document-with-examples.md"},{"slug":"polars-defer-expensive-operations","title":"Defer expensive operations","description":"Avoid triggering expensive computations prematurely in your code. Operations like `collect()`, intensive IO operations, or algorithms with quadratic complexity should be deferred until absolutely necessary to prevent wasted computational resources.","repository":"pola-rs/polars","domain":"data-systems","topic":"Performance Optimization","language":"Python","updated":"2025-04-25","comments":4,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-defer-expensive-operations.md"},{"slug":"brew-environment-variable-safety","title":"Environment variable safety","description":"When configuring environment variables, especially those related to paths, implement these safety practices: 1. Validate path accessibility before use to ensure the environment is properly configured","repository":"Homebrew/brew","domain":"devtools","topic":"Configurations","language":"Shell","updated":"2025-04-25","comments":3,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-environment-variable-safety.md"},{"slug":"react-router-extract-test-helpers","title":"Extract test helpers","description":"Create reusable helper functions for common test setup patterns to reduce duplication and improve maintainability. When you find yourself repeating the same mock objects, test data structures, or setup code across multiple tests, extract them into shared utilities.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Testing","language":"TSX","updated":"2025-04-25","comments":3,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-extract-test-helpers.md"},{"slug":"codex-verify-state-before-execution","title":"Verify state before execution","description":"When scheduling asynchronous operations in concurrent environments, always verify the system state hasn't changed before executing critical operations to prevent race conditions. This is especially important in interactive applications where user actions (like cancellations) might occur between the time an operation is scheduled and when it executes.","repository":"openai/codex","domain":"ai-agents","topic":"Concurrency","language":"TypeScript","updated":"2025-04-25","comments":2,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-verify-state-before-execution.md"},{"slug":"opentofu-provider-instance-management","title":"Provider instance management","description":"Ensure proper configuration of provider instances when using environment-specific settings. When using `for_each` with providers, carefully manage the lifecycle of provider instances to avoid warnings or errors during resource operations.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Configurations","language":"Other","updated":"2025-04-25","comments":2,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-provider-instance-management.md"},{"slug":"stagehand-configurable-model-selection","title":"Configurable model selection","description":"Avoid hard-coding model names and provider-specific configurations throughout the codebase. Instead, implement flexible model selection patterns that support runtime configuration and consistent naming conventions across different AI providers.","repository":"browserbase/stagehand","domain":"ai-agents","topic":"AI","language":"TypeScript","updated":"2025-04-24","comments":9,"stars":16443,"raw":"https://awesomereviewers.com/raw/stagehand-configurable-model-selection.md"},{"slug":"workers-sdk-dependency-version-constraints","title":"dependency version constraints","description":"Ensure consistent and appropriate dependency version constraints across all package.json files. Use flexible version ranges for peer dependencies to avoid forcing unnecessary upgrades, maintain minimum supported versions that align with project requirements, and keep template dependencies up-to-date for consistency.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Configurations","language":"Json","updated":"2025-04-24","comments":8,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-dependency-version-constraints.md"},{"slug":"langchainjs-preserve-api-backward-compatibility","title":"Preserve API backward compatibility","description":"When modifying existing APIs, maintain backward compatibility by implementing changes in a non-breaking way. Use method overloading, optional parameters, or deprecation notices rather than direct breaking changes.","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2025-04-24","comments":7,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-preserve-api-backward-compatibility.md"},{"slug":"codex-prefer-specific-identifiers","title":"Prefer specific identifiers","description":"Always use specific, descriptive names for identifiers rather than generic terms. Names should clearly indicate their purpose and context, making code more readable and self-documenting. This applies to variables, parameters, types, and files.","repository":"openai/codex","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2025-04-24","comments":4,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-prefer-specific-identifiers.md"},{"slug":"codex-propagate-errors-appropriately","title":"Propagate errors appropriately","description":"Allow errors to bubble up to their appropriate handling layers rather than catching them prematurely. Catching errors at incorrect levels can prevent proper error handling, recovery mechanisms, and specialized handlers (like rate limiting logic) from functioning as intended.","repository":"openai/codex","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2025-04-24","comments":3,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-propagate-errors-appropriately.md"},{"slug":"prowler-tenant-aware-query-optimization","title":"Tenant-aware query optimization","description":"Always include tenant_id filters in database queries for multi-tenant systems to maintain data isolation and improve query performance. In ORM queries, explicitly filter by tenant_id even when using Row Level Security (RLS) as a defense-in-depth measure and to help the query optimizer.","repository":"prowler-cloud/prowler","domain":"security","topic":"Database","language":"Python","updated":"2025-04-24","comments":3,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-tenant-aware-query-optimization.md"},{"slug":"react-router-prefer-explicit-readable-constructs","title":"prefer explicit readable constructs","description":"Choose explicit and semantic code constructs that enhance readability over more concise but less clear alternatives. This improves code maintainability and reduces cognitive load for developers.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Code Style","language":"TSX","updated":"2025-04-24","comments":3,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-prefer-explicit-readable-constructs.md"},{"slug":"celery-api-examples-clarity","title":"Api examples clarity","description":"API docs and interface examples must be unambiguous and cover defaults. Apply this standard when writing or updating API documentation: - **Validate example syntax**: For query strings, use **one** `?` to start the query and **`&`** for every additional parameter. Avoid ambiguous/incorrect examples like multiple `?` in the same query string.","repository":"celery/celery","domain":"orchestration","topic":"API","language":"Other","updated":"2025-04-24","comments":2,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-api-examples-clarity.md"},{"slug":"cline-handle-async-operations-safely","title":"Handle async operations safely","description":"Always wrap asynchronous operations in try-catch blocks to prevent unhandled promise rejections and provide graceful error recovery. This is especially important for browser APIs that may fail due to user permissions, network issues, or browser compatibility.","repository":"cline/cline","domain":"ai-agents","topic":"Error Handling","language":"TSX","updated":"2025-04-24","comments":2,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-handle-async-operations-safely.md"},{"slug":"temporal-optimize-api-consumption","title":"Optimize API consumption","description":"When interacting with APIs, minimize network requests and improve code maintainability by: 1. Extracting repetitive API call patterns into reusable functions","repository":"temporalio/temporal","domain":"orchestration","topic":"API","language":"Yaml","updated":"2025-04-24","comments":2,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-optimize-api-consumption.md"},{"slug":"pr-agent-logging-consistency-and-safety","title":"Logging consistency and safety","description":"When writing/adjusting code, treat logging as part of error handling: - Use the right level: log request- or operation-failure conditions at `error`/`exception` (not `warning`).","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"Logging","language":"Python","updated":"2025-04-23","comments":7,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-logging-consistency-and-safety.md"},{"slug":"fiber-evaluate-nil-check-necessity","title":"Evaluate nil check necessity","description":"Before adding nil checks, evaluate whether they are actually necessary or if they represent false positives from static analysis tools. Consider Go's built-in nil safety patterns and semantics.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Null Handling","language":"Go","updated":"2025-04-23","comments":5,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-evaluate-nil-check-necessity.md"},{"slug":"agents-balance-organization-with-constraints","title":"Balance organization with constraints","description":"When making code organization decisions, consider the broader impact beyond just eliminating duplication or following patterns. Sometimes a slightly less \"clean\" solution is preferable when it preserves type safety, maintains clear class responsibilities, or avoids exposing unnecessary implementation details.","repository":"cloudflare/agents","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2025-04-23","comments":3,"stars":2312,"raw":"https://awesomereviewers.com/raw/agents-balance-organization-with-constraints.md"},{"slug":"ghostty-encapsulate-implementation-details","title":"Encapsulate implementation details","description":"When designing APIs, create appropriate abstractions that hide platform-specific or low-level implementation details from consuming code. Avoid exposing raw interfaces outside their designated modules and minimize unnecessary dependencies.","repository":"ghostty-org/ghostty","domain":"devtools","topic":"API","language":"Other","updated":"2025-04-23","comments":3,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-encapsulate-implementation-details.md"},{"slug":"nuxt-benchmark-algorithmic-optimizations","title":"Benchmark algorithmic optimizations","description":"Always validate performance improvements with benchmarks rather than assuming algorithmic optimizations provide benefits. Many seemingly faster approaches may not deliver measurable gains or may even perform worse in practice.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Algorithms","language":"TypeScript","updated":"2025-04-23","comments":3,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-benchmark-algorithmic-optimizations.md"},{"slug":"agents-validate-connection-protocols","title":"validate connection protocols","description":"Always validate network connection types, required parameters, and protocol-specific headers before processing requests. This prevents runtime errors and ensures proper connection handling across different network protocols.","repository":"cloudflare/agents","domain":"ai-agents","topic":"Networking","language":"TypeScript","updated":"2025-04-23","comments":2,"stars":2312,"raw":"https://awesomereviewers.com/raw/agents-validate-connection-protocols.md"},{"slug":"crewai-consistent-configuration-declarations","title":"Consistent configuration declarations","description":"Ensure configuration specifications (such as version requirements, environment settings, and tool declarations) are consistent and not duplicated across project files. Redundant or contradictory configuration declarations create maintenance issues and confusion.","repository":"crewaiinc/crewai","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2025-04-23","comments":2,"stars":33945,"raw":"https://awesomereviewers.com/raw/crewai-consistent-configuration-declarations.md"},{"slug":"codex-restrict-command-whitelist","title":"Restrict command whitelist","description":"When configuring command whitelists for auto-approval, include only commands with limited capabilities that cannot be exploited for malicious purposes. Powerful tools like text editors (e.g., vim) should be avoided as they provide broad system access and functionality that could introduce security vulnerabilities if auto-approved.","repository":"openai/codex","domain":"ai-agents","topic":"Security","language":"Markdown","updated":"2025-04-23","comments":1,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-restrict-command-whitelist.md"},{"slug":"ghostty-sanitize-debug-output","title":"Sanitize debug output","description":"Never print or log sensitive information such as tokens, passwords, or secrets that might be present in environment variables or configuration. When debugging with environment variables, always sanitize the output by filtering out sensitive keys.","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Security","language":"Python","updated":"2025-04-23","comments":1,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-sanitize-debug-output.md"},{"slug":"grafana-update-vulnerable-dependencies","title":"Update vulnerable dependencies","description":"Always update dependencies with known security vulnerabilities to their patched versions. Dependencies with security issues can introduce vulnerabilities into your application even if your own code is secure.","repository":"grafana/grafana","domain":"observability","topic":"Security","language":"Other","updated":"2025-04-23","comments":1,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-update-vulnerable-dependencies.md"},{"slug":"checkov-support-all-target-environments","title":"Support all target environments","description":"When managing dependency configurations (Pipfiles, requirements.txt, lock files), ensure compatibility with all supported environments in your project. Package version requirements should work across all supported Python versions and deployment environments.","repository":"bridgecrewio/checkov","domain":"security","topic":"Configurations","language":"Other","updated":"2025-04-22","comments":3,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-support-all-target-environments.md"},{"slug":"express-implement-least-privilege","title":"Implement least privilege","description":"Apply the principle of least privilege for all repository and system access to enhance security. Each role should be granted only the permissions necessary to perform their specific responsibilities:","repository":"expressjs/express","domain":"app-frameworks","topic":"Security","language":"Markdown","updated":"2025-04-22","comments":3,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-implement-least-privilege.md"},{"slug":"opentofu-names-preserve-cognitive-context","title":"Names preserve cognitive context","description":"Choose variable, function, and type names that preserve cognitive context by clearly indicating their purpose and relationship to surrounding code. Names should help readers understand the code's intent without having to deeply analyze implementation details.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Naming Conventions","language":"Go","updated":"2025-04-22","comments":3,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-names-preserve-cognitive-context.md"},{"slug":"ant-design-consistent-dependency-formatting","title":"consistent dependency formatting","description":"Maintain consistent formatting and organization when managing dependencies in package.json files. Use semver range notation (^) consistently for all dependencies to allow compatible updates, and make targeted changes rather than bulk updates to preserve clean git history and blame information.","repository":"ant-design/ant-design","domain":"app-frameworks","topic":"Code Style","language":"Json","updated":"2025-04-22","comments":2,"stars":95882,"raw":"https://awesomereviewers.com/raw/ant-design-consistent-dependency-formatting.md"},{"slug":"checkov-ensure-dependency-compatibility","title":"Ensure dependency compatibility","description":"When adding or updating dependencies in configuration files (Pipfile, requirements.txt), ensure compatibility with all supported Python versions in the project. Generated lock files and specific version constraints should work with the minimum supported Python version to prevent CI failures or production issues.","repository":"bridgecrewio/checkov","domain":"security","topic":"Configurations","language":"Other","updated":"2025-04-22","comments":2,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-ensure-dependency-compatibility.md"},{"slug":"signoz-prefer-realistic-testing","title":"Prefer realistic testing","description":"Write tests that closely mirror real user interactions and application behavior rather than relying on artificial test-specific constructs. This approach creates more robust and maintainable tests.","repository":"SigNoz/signoz","domain":"observability","topic":"Testing","language":"TSX","updated":"2025-04-22","comments":2,"stars":23369,"raw":"https://awesomereviewers.com/raw/signoz-prefer-realistic-testing.md"},{"slug":"tree-sitter-document-configuration-changes","title":"Document configuration changes","description":"When modifying configuration files (tsconfig.json, environment configs, build settings, etc.), always provide clear explanations for why the changes are necessary, what benefits they provide, and any potential impacts. Configuration changes can significantly affect build processes, development workflows, and application behavior, so reviewers and future...","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Configurations","language":"Json","updated":"2025-04-22","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-document-configuration-changes.md"},{"slug":"checkov-write-pythonic-code","title":"Write pythonic code","description":"Embrace Python''s idiomatic programming style to make your code more readable, concise, and maintainable. Follow these Pythonic patterns: 1. **Use truthiness checks** instead of explicit length comparisons:","repository":"bridgecrewio/checkov","domain":"security","topic":"Code Style","language":"Python","updated":"2025-04-21","comments":8,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-write-pythonic-code.md"},{"slug":"polars-ci-workflow-configuration-best","title":"CI workflow configuration best","description":"Configure GitHub Actions workflows to maximize reliability and maintainability. Follow these key practices: 1. **Always test with latest patches**: Use `check-latest: true` when setting up language environments to ensure you''re testing with the most recent patch versions rather than potentially outdated cached versions.","repository":"pola-rs/polars","domain":"data-systems","topic":"CI/CD","language":"Yaml","updated":"2025-04-21","comments":3,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-ci-workflow-configuration-best.md"},{"slug":"browser-use-document-configuration-decisions","title":"Document configuration decisions","description":"Configuration files should be self-explanatory and maintainable by including explicit version constraints and explanatory comments for non-obvious choices. This prevents future confusion and ensures reproducible environments.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Configurations","language":"Toml","updated":"2025-04-21","comments":2,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-document-configuration-decisions.md"},{"slug":"cline-ai-provider-consistency","title":"AI provider consistency","description":"Ensure consistent patterns and configurations across all AI model providers to maintain code maintainability and scalability. This includes providing proper default configurations for all providers and minimizing provider-specific conditional logic that can become unwieldy as more AI models are integrated.","repository":"cline/cline","domain":"ai-agents","topic":"AI","language":"TSX","updated":"2025-04-21","comments":2,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-ai-provider-consistency.md"},{"slug":"nest-choose-meaningful-identifier-names","title":"Choose meaningful identifier names","description":"Names for variables, methods, and classes should be descriptive, semantically accurate, and consistent with established conventions. Follow these guidelines:","repository":"nestjs/nest","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2025-04-20","comments":9,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-choose-meaningful-identifier-names.md"},{"slug":"cline-validate-algorithmic-correctness","title":"validate algorithmic correctness","description":"Always verify algorithms work correctly across edge cases and boundary conditions through concrete examples and mathematical validation. Pay special attention to preventing infinite recursion and ensuring mathematical formulas produce expected results.","repository":"cline/cline","domain":"ai-agents","topic":"Algorithms","language":"TypeScript","updated":"2025-04-20","comments":3,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-validate-algorithmic-correctness.md"},{"slug":"inbox-zero-guard-against-null-chains","title":"Guard against null chains","description":"Prevent null pointer exceptions by validating object chains before accessing nested properties. Use early returns with null checks instead of optional chaining when the rest of the function depends on a non-null value.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Null Handling","language":"TypeScript","updated":"2025-04-20","comments":3,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-guard-against-null-chains.md"},{"slug":"checkov-lambda-cors-protection","title":"Lambda CORS protection","description":"When implementing network security checks for AWS Lambda functions, ensure that CORS (Cross-Origin Resource Sharing) policies are verified on the core Lambda function resources, not just on function URL endpoints. This prevents open CORS policies that could expose your Lambda functions to unauthorized cross-origin requests.","repository":"bridgecrewio/checkov","domain":"security","topic":"Networking","language":"Yaml","updated":"2025-04-20","comments":2,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-lambda-cors-protection.md"},{"slug":"checkov-target-core-resources","title":"Target core resources","description":"When implementing network security checks for serverless functions like AWS Lambda, ensure you target the core function resources rather than just their endpoints. Security checks for configurations like CORS policies should be applied to the primary Lambda resources (`AWS::Lambda::Function`, `aws_lambda_function`) rather than only their URL interfaces...","repository":"bridgecrewio/checkov","domain":"security","topic":"Networking","language":"Yaml","updated":"2025-04-20","comments":2,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-target-core-resources.md"},{"slug":"inbox-zero-ensure-schema-migration-consistency","title":"Ensure schema-migration consistency","description":"When modifying database schemas, ensure complete alignment between schema definitions and SQL migration scripts. Every field, column, constraint, or relationship defined in your schema must have a corresponding migration operation.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Migrations","language":"Prisma","updated":"2025-04-20","comments":2,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-ensure-schema-migration-consistency.md"},{"slug":"browser-use-safe-attribute-access","title":"Safe attribute access","description":"Always use defensive programming patterns when accessing object attributes, especially when dealing with optional or potentially None values. Use hasattr() checks before accessing attributes, prefer public accessor methods over private attributes, and add null checks when accessing nested properties.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2025-04-19","comments":3,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-safe-attribute-access.md"},{"slug":"codex-proper-packagejson-structure","title":"Proper package.json structure","description":"Maintain clean and properly structured package.json files by following these principles: 1. Categorize dependencies correctly - place development tools and testing libraries in `devDependencies`, not in regular `dependencies`. This ensures smaller production builds and clearer dependency management.","repository":"openai/codex","domain":"ai-agents","topic":"Configurations","language":"Json","updated":"2025-04-19","comments":2,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-proper-packagejson-structure.md"},{"slug":"traefik-configuration-validation-consistency","title":"Configuration validation consistency","description":"Ensure configuration fields use consistent validation patterns, appropriate data types, and proper bounds checking. This includes using correct regex patterns for duration fields, consistent type usage across similar fields, and implementing cross-field validation where relationships exist.","repository":"traefik/traefik","domain":"cloud-infra","topic":"Configurations","language":"Go","updated":"2025-04-18","comments":12,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-configuration-validation-consistency.md"},{"slug":"opentofu-document-intent-and-limitations","title":"Document intent and limitations","description":"Clearly document the intended purpose, scope limitations, and design decisions in your code. For all exported types, functions, and variables, provide comprehensive comments explaining their purpose, usage patterns, expected behavior, and any deliberate limitations.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Documentation","language":"Go","updated":"2025-04-18","comments":8,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-document-intent-and-limitations.md"},{"slug":"influxdb-structured-logging-best-practices","title":"Structured logging best practices","description":"Use structured logging with appropriate field types and context to make logs more useful for troubleshooting. Choose specific field types over generic ones, include relevant metrics, and select appropriate log levels based on information importance.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Logging","language":"Go","updated":"2025-04-18","comments":5,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-structured-logging-best-practices.md"},{"slug":"opentelemetry-python-write-reliable-test-cases","title":"Write reliable test cases","description":"Create deterministic and reliable test cases by following these guidelines: 1. Use hardcoded values instead of random data to ensure reproducibility:","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Testing","language":"Python","updated":"2025-04-18","comments":4,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-write-reliable-test-cases.md"},{"slug":"union-use-structured-logging-fields","title":"Use structured logging fields","description":"Prefer structured logging fields over string formatting in tracing logs to improve searchability, parsing, and consistency. Use field syntax like `field = %value` or `%field` instead of embedding values directly in log messages. Keep log messages single-line, lowercase, and include relevant context as separate fields.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Logging","language":"Rust","updated":"2025-04-18","comments":4,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-use-structured-logging-fields.md"},{"slug":"vite-clean-configuration-organization","title":"Clean configuration organization","description":"Organize configuration settings logically and avoid redundancy in project configuration files. Group related options into appropriate sections, eliminate duplicated settings (especially those already provided by extended configurations), and document non-obvious choices with explanatory comments.","repository":"vitejs/vite","domain":"devtools","topic":"Configurations","language":"Json","updated":"2025-04-18","comments":4,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-clean-configuration-organization.md"},{"slug":"vite-leverage-native-tooling","title":"Leverage native tooling","description":"Prioritize native or Rust-based implementations of build tools over their JavaScript counterparts to significantly improve performance in both development and build phases. Tools like Rolldown (replacing Rollup and esbuild) can reduce build times and provide a more consistent experience between development and production environments.","repository":"vitejs/vite","domain":"devtools","topic":"Performance Optimization","language":"Markdown","updated":"2025-04-18","comments":4,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-leverage-native-tooling.md"},{"slug":"zod-documentation-must-explain","title":"Documentation Must Explain","description":"Ensure inline docs and comments are accurate, clear, and justified: - **Match implementation defaults:** If JSDoc mentions “default”, it must reflect what the code actually does. If there’s a real default value, document it (e.g., with an `@default` tag).","repository":"colinhacks/zod","domain":"app-frameworks","topic":"Documentation","language":"TypeScript","updated":"2025-04-18","comments":4,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-documentation-must-explain.md"},{"slug":"cline-validate-untrusted-inputs","title":"validate untrusted inputs","description":"Always validate and sanitize untrusted inputs to prevent injection attacks and security vulnerabilities. This includes path inputs that could lead to directory traversal attacks and content that may contain malicious HTML entities.","repository":"cline/cline","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2025-04-18","comments":3,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-validate-untrusted-inputs.md"},{"slug":"opencv-meaningful-semantic-naming","title":"Meaningful semantic naming","description":"Choose names that clearly communicate purpose and follow consistent patterns across the codebase: 1. Use generic function names when the functionality is reusable, with parameters for specific values:","repository":"opencv/opencv","domain":"ml-systems","topic":"Naming Conventions","language":"Python","updated":"2025-04-18","comments":3,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-meaningful-semantic-naming.md"},{"slug":"argo-cd-api-parameter-extensibility","title":"API parameter extensibility","description":"Design APIs to support multiple parameters from the beginning rather than limiting them to single parameter inputs. This prevents future refactoring needs and provides better extensibility for complex operations.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"API","language":"TSX","updated":"2025-04-18","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-api-parameter-extensibility.md"},{"slug":"dify-separate-ai-instructions","title":"Separate AI instructions","description":"Always separate AI model instructions from user input to prevent prompt injection vulnerabilities and maintain clear architectural boundaries. Use system messages for AI instructions and user messages for actual user content, rather than embedding user input directly into instruction templates.","repository":"langgenius/dify","domain":"llm-infra","topic":"AI","language":"Python","updated":"2025-04-18","comments":2,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-separate-ai-instructions.md"},{"slug":"nuxt-filter-sensitive-data-server-side","title":"Filter sensitive data server-side","description":"Always filter sensitive data at the API/server level before sending responses to the client. Never rely on client-side filtering or assume that data not displayed in the UI is secure. Any data sent to the client should be considered public and accessible to anyone with malicious intent.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Security","language":"Markdown","updated":"2025-04-18","comments":2,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-filter-sensitive-data-server-side.md"},{"slug":"opencv-document-configuration-version-requirements","title":"Document configuration version requirements","description":"Make build configuration options explicit and document their version dependencies. When introducing configuration parameters that are version-specific, clearly indicate compatibility requirements and provide command-line options to make constraints optional when appropriate.","repository":"opencv/opencv","domain":"ml-systems","topic":"Configurations","language":"Python","updated":"2025-04-18","comments":2,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-document-configuration-version-requirements.md"},{"slug":"playwright-handle-errors-explicitly","title":"Handle errors explicitly","description":"Always provide explicit error handling instead of allowing silent failures or blank screens. Any place where an error can occur but is not handled explicitly is a bug. When errors occur, communicate clearly to users what went wrong and suggest recovery actions when possible.","repository":"microsoft/playwright","domain":"devtools","topic":"Error Handling","language":"TSX","updated":"2025-04-18","comments":2,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-handle-errors-explicitly.md"},{"slug":"pr-agent-secure-ci-invocation","title":"Secure CI Invocation","description":"When updating CI/CD pipeline configuration for third-party tools, apply two security rules: (1) never embed secret values directly in command-line arguments; (2) pin third-party images/actions to immutable digests to prevent supply-chain drift.","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"Security","language":"Markdown","updated":"2025-04-18","comments":2,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-secure-ci-invocation.md"},{"slug":"codex-prevent-command-injection","title":"Prevent command injection","description":"Always use child_process.spawn() with array arguments instead of exec() with string concatenation when executing system commands. This prevents command injection vulnerabilities that can occur when untrusted input is incorporated into command strings.","repository":"openai/codex","domain":"ai-agents","topic":"Security","language":"TSX","updated":"2025-04-18","comments":1,"stars":31275,"raw":"https://awesomereviewers.com/raw/codex-prevent-command-injection.md"},{"slug":"mastodon-extract-complex-logic","title":"Extract complex logic","description":"Break down complex methods into smaller, well-named private methods to improve readability and maintainability. When a method contains multiple responsibilities, nested conditionals, or complex logic blocks, extract these into descriptive private methods.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Code Style","language":"Ruby","updated":"2025-04-17","comments":6,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-extract-complex-logic.md"},{"slug":"opentofu-structure-tests-thoroughly","title":"Structure tests thoroughly","description":"Create well-structured tests with thorough coverage of both expected success and error conditions. Name test cases descriptively to clearly identify their purpose, and separate test logic from test data when using table-driven tests.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Testing","language":"Go","updated":"2025-04-17","comments":6,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-structure-tests-thoroughly.md"},{"slug":"dify-simplify-complex-logic","title":"simplify complex logic","description":"Improve code readability by reducing complexity and nesting through early returns, extracting complex logic into dedicated functions, and using clear parameter naming.","repository":"langgenius/dify","domain":"llm-infra","topic":"Code Style","language":"Python","updated":"2025-04-17","comments":5,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-simplify-complex-logic.md"},{"slug":"hyprland-prefer-stderror-code-parameters","title":"prefer std::error_code parameters","description":"When using std::filesystem operations, prefer passing std::error_code parameters instead of relying on try-catch blocks for error handling. This approach provides better performance and more explicit error checking.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Error Handling","language":"C++","updated":"2025-04-17","comments":4,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-prefer-stderror-code-parameters.md"},{"slug":"traefik-validate-input-sanitization","title":"validate input sanitization","description":"Always maintain input sanitization and validation mechanisms to prevent security vulnerabilities. Disabling built-in security features like path sanitization can expose applications to path traversal attacks and routing manipulation.","repository":"traefik/traefik","domain":"cloud-infra","topic":"Security","language":"Markdown","updated":"2025-04-17","comments":4,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-validate-input-sanitization.md"},{"slug":"cal.com-avoid-nested-ternaries","title":"Avoid nested ternaries","description":"Avoid using nested ternary operators as they significantly reduce code readability and make debugging difficult. Complex conditional logic should be refactored into clear, readable structures using if-else statements, early returns, or extracted helper functions.","repository":"calcom/cal.com","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2025-04-17","comments":3,"stars":37732,"raw":"https://awesomereviewers.com/raw/cal.com-avoid-nested-ternaries.md"},{"slug":"crewai-test-behavior-not-calls","title":"Test behavior not calls","description":"Tests should validate actual system behavior rather than just verifying method calls. When writing tests, focus on asserting the expected outcomes and side effects rather than simply checking if methods were invoked.","repository":"crewaiinc/crewai","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2025-04-17","comments":3,"stars":33945,"raw":"https://awesomereviewers.com/raw/crewai-test-behavior-not-calls.md"},{"slug":"deno-document-network-apis-comprehensively","title":"Document network APIs comprehensively","description":"Network APIs and interfaces should include comprehensive documentation with clear descriptions, practical examples, and proper configuration guidance. This is especially important for complex protocols like WebSockets, HTTPS, and specialized network transports.","repository":"denoland/deno","domain":"runtimes","topic":"Networking","language":"TypeScript","updated":"2025-04-17","comments":3,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-document-network-apis-comprehensively.md"},{"slug":"electron-validate-external-input-safely","title":"validate external input safely","description":"Always validate and sanitize external input using established libraries rather than manual string manipulation or custom parsing. External input includes user data, environment variables, command line arguments, and data from untrusted sources. Manual construction of structured data (like JSON) with user input creates injection vulnerabilities.","repository":"electron/electron","domain":"devtools","topic":"Security","language":"Other","updated":"2025-04-17","comments":3,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-validate-external-input-safely.md"},{"slug":"material-ui-document-implementation-decisions","title":"Document implementation decisions","description":"Add explanatory comments for non-obvious implementation details, especially when maintaining backward compatibility or implementing complex logic that isn't immediately clear without context. This helps other developers understand the reasoning behind design decisions and implementation choices.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Documentation","language":"JavaScript","updated":"2025-04-17","comments":3,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-document-implementation-decisions.md"},{"slug":"mermaid-consistent-identifier-naming","title":"Consistent Identifier Naming","description":"Use consistent, standards-aligned naming for identifiers, especially for user-facing text/URLs and registry keys. - ID casing: Use `ID` (not `Id`) when it’s normal prose/descriptions; only use `Id` if an external API/storage contract explicitly requires it.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Naming Conventions","language":"Markdown","updated":"2025-04-17","comments":3,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-consistent-identifier-naming.md"},{"slug":"deeplearning4j-prevent-memory-leaks","title":"Prevent memory leaks","description":"Always ensure proper memory management when using dynamic allocation. Memory leaks are a critical performance issue that can degrade application performance over time and eventually lead to resource exhaustion.","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Performance Optimization","language":"C++","updated":"2025-04-17","comments":2,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-prevent-memory-leaks.md"},{"slug":"hyprland-optimize-workflow-triggers","title":"optimize workflow triggers","description":"Design CI/CD workflows with intentional triggers and conditions to avoid unnecessary executions, rate limiting, and contextually inappropriate behavior. Use specific event triggers and conditional statements to ensure workflow steps run only when needed and appropriate.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"CI/CD","language":"Yaml","updated":"2025-04-17","comments":2,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-optimize-workflow-triggers.md"},{"slug":"nuxt-documentation-formatting-consistency","title":"documentation formatting consistency","description":"Ensure consistent formatting throughout documentation by applying these standards: wrap code terms, variable names, and boolean values in backticks (`data`, `error`, `status`, `true`, `false`), use proper markdown link syntax with leading slashes (`/docs/guide/...` instead of `docs/guide/...`), maintain consistent punctuation and spacing in code examples,...","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Next","language":"Markdown","updated":"2025-04-16","comments":16,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-documentation-formatting-consistency.md"},{"slug":"kong-nil-safe-input-normalization","title":"Nil-Safe Input Normalization","description":"When handling optional/null values, normalize and guard them at the boundary so downstream code never has to guess. Apply these rules: 1) Keep safe fallbacks for optional config fields (don’t delete “default” logic unless the field is strictly required).","repository":"Kong/kong","domain":"cloud-infra","topic":"Null Handling","language":"Other","updated":"2025-04-16","comments":10,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-nil-safe-input-normalization.md"},{"slug":"kong-document-split-contracts","title":"Document Split Contracts","description":"When implementing algorithmic transformations that clients depend on (especially split/partition functions and any logic that rebuilds/serializes structured strings), treat semantics as a stable API: explicitly define and document the contract (edge cases, limits, nil/empty handling, delimiter rules), and guarantee deterministic output by not relying on...","repository":"Kong/kong","domain":"cloud-infra","topic":"Algorithms","language":"Other","updated":"2025-04-16","comments":9,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-document-split-contracts.md"},{"slug":"kong-semantic-naming-rules","title":"Semantic Naming Rules","description":"Adopt a naming standard where identifiers encode meaning, don’t clash with framework semantics, and don’t obscure behavior. Guidelines: - Avoid reserved/special filenames and namespace collisions. If a module filename has framework semantics (e.g., `api.lua` in plugin contexts), don’t reuse it for unrelated code—rename or place code where it can’t be...","repository":"Kong/kong","domain":"cloud-infra","topic":"Naming Conventions","language":"Other","updated":"2025-04-16","comments":7,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-semantic-naming-rules.md"},{"slug":"influxdb-clear-configuration-parameters","title":"Clear configuration parameters","description":"Configuration parameters should be descriptively named, well documented, and have sensible defaults that are visible to users. This makes your application more user-friendly and reduces confusion.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Configurations","language":"Rust","updated":"2025-04-16","comments":5,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-clear-configuration-parameters.md"},{"slug":"n8n-manage-database-connections","title":"Manage database connections","description":"Always properly manage database connections to prevent resource leaks and improve application stability. Implement these key practices: 1. Release connections back to the pool after use with a try/finally block","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Database","language":"TypeScript","updated":"2025-04-16","comments":5,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-manage-database-connections.md"},{"slug":"ollama-use-environment-variables","title":"Use environment variables","description":"Use environment variables instead of hardcoding configuration values such as file paths, port numbers, or system-specific locations. This makes the code more flexible across different platforms, installation methods, and user preferences.","repository":"ollama/ollama","domain":"llm-infra","topic":"Configurations","language":"Go","updated":"2025-04-16","comments":5,"stars":145704,"raw":"https://awesomereviewers.com/raw/ollama-use-environment-variables.md"},{"slug":"crewai-default-none-not-empty","title":"Default None not empty","description":"Always use `None` as the default value for optional parameters and class attributes instead of empty collections (`[]`, `{}`, `\"\"`) or other mutable defaults. This prevents sharing mutable state between instances and makes null checks more explicit.","repository":"crewaiinc/crewai","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2025-04-16","comments":4,"stars":33945,"raw":"https://awesomereviewers.com/raw/crewai-default-none-not-empty.md"},{"slug":"lobe-chat-css-utility-usage","title":"CSS utility usage","description":"Use CSS utility functions and avoid complex inline calculations for better maintainability and readability. Prefer `cx()` from useStyles for combining CSS classes instead of template literals, and use `css` from antd-style for simple styles without design tokens.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Code Style","language":"TSX","updated":"2025-04-16","comments":4,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-css-utility-usage.md"},{"slug":"tokio-granular-feature-flags","title":"Granular feature flags","description":"Feature flags should be designed with granularity to ensure dependencies are only required when absolutely necessary. When adding functionality that requires additional dependencies, create separate features rather than adding those dependencies to existing features.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Configurations","language":"Toml","updated":"2025-04-16","comments":4,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-granular-feature-flags.md"},{"slug":"typescript-cache-expensive-computed-values","title":"Cache expensive computed values","description":"Cache frequently accessed or computed values to avoid redundant calculations and property lookups. This applies to: 1. Loop invariant values 2. Expensive computations","repository":"microsoft/typescript","domain":"runtimes","topic":"Performance Optimization","language":"TypeScript","updated":"2025-04-16","comments":4,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-cache-expensive-computed-values.md"},{"slug":"better-auth-improve-documentation-clarity","title":"Improve documentation clarity","description":"Write clear, accessible, and consistent documentation by using descriptive link text and providing complete, realistic examples. Avoid generic link text like \"here\" or \"click here\" - instead, describe what the link leads to. Ensure code examples are comprehensive and consistent across all documentation.","repository":"better-auth/better-auth","domain":"security","topic":"Documentation","language":"Other","updated":"2025-04-16","comments":2,"stars":19651,"raw":"https://awesomereviewers.com/raw/better-auth-improve-documentation-clarity.md"},{"slug":"browser-use-model-initialization-formatting","title":"Model initialization formatting","description":"Maintain consistent formatting when initializing AI models and agents. Use proper spacing around assignment operators and consistent indentation for constructor parameters to improve code readability and follow Python style conventions.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"AI","language":"Other","updated":"2025-04-16","comments":2,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-model-initialization-formatting.md"},{"slug":"browser-use-preserve-exception-context","title":"preserve exception context","description":"When handling exceptions, always preserve the original error context to aid in debugging and error diagnosis. This involves two key practices: (1) Include the exception class name when converting exceptions to strings, and (2) Use exception chaining when re-raising exceptions.","repository":"browser-use/browser-use","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2025-04-16","comments":2,"stars":69139,"raw":"https://awesomereviewers.com/raw/browser-use-preserve-exception-context.md"},{"slug":"deno-use-standard-api-interfaces","title":"Use standard API interfaces","description":"Always prefer established API interfaces and patterns over custom or alternative approaches. This ensures compatibility, maintainability, and follows expected conventions.","repository":"denoland/deno","domain":"runtimes","topic":"API","language":"TypeScript","updated":"2025-04-16","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-use-standard-api-interfaces.md"},{"slug":"n8n-remove-commented-code-immediately","title":"Remove commented code immediately","description":"Commented-out code should be removed immediately rather than committed to the codebase. Keeping commented code creates confusion, adds unnecessary noise, and makes the codebase harder to maintain. If code is no longer needed, delete it - version control systems will preserve the history if it needs to be referenced later.","repository":"n8n-io/n8n","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2025-04-16","comments":2,"stars":122978,"raw":"https://awesomereviewers.com/raw/n8n-remove-commented-code-immediately.md"},{"slug":"opentofu-preserve-sensitive-data-marks","title":"Preserve sensitive data marks","description":"Carefully handle data marked as sensitive throughout the codebase to maintain security properties. Ensure that sensitive marks are only removed when necessary, and be aware that operations on marked data (such as reordering from nested to top level) could have security implications.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Security","language":"Go","updated":"2025-04-16","comments":1,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-preserve-sensitive-data-marks.md"},{"slug":"terraform-use-environment-variables","title":"Use environment variables","description":"When working with configurations that require sensitive data (credentials, tokens, passwords), always use environment variables instead of hardcoding values directly in configuration files. This prevents sensitive information from being stored in version control systems, state files, or plan outputs.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Configurations","language":"Other","updated":"2025-04-15","comments":21,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-use-environment-variables.md"},{"slug":"terraform-resource-cleanup-on-errors","title":"Resource cleanup on errors","description":"Always ensure proper resource cleanup in error paths to prevent leaks. Use defer functions with explicit error checking for closing operations, and log any close errors that occur during cleanup.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Error Handling","language":"Go","updated":"2025-04-15","comments":4,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-resource-cleanup-on-errors.md"},{"slug":"core-use-configuration-constants","title":"Use configuration constants","description":"Always use predefined constants from `homeassistant.const` instead of string literals when accessing configuration data. For required configuration keys that must be present, use direct dictionary access (`entry.data[CONF_KEY]`) rather than `.get()` with defaults, as this provides better error handling and makes the required nature of the configuration...","repository":"home-assistant/core","domain":"app-frameworks","topic":"Configurations","language":"Python","updated":"2025-04-15","comments":3,"stars":80450,"raw":"https://awesomereviewers.com/raw/core-use-configuration-constants.md"},{"slug":"ai-versioning-for-migrations","title":"Versioning for migrations","description":"Use appropriate version bumps to signal migration requirements and maintain clear upgrade paths. Flag breaking changes with major version bumps to help with release notes and upgrade guides. External contributors should use patch bumps only, while minor and major version changes are reserved for the core team.","repository":"vercel/ai","domain":"ai-agents","topic":"Migrations","language":"Markdown","updated":"2025-04-15","comments":2,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-versioning-for-migrations.md"},{"slug":"langfuse-capitalize-acronyms-consistently","title":"Capitalize acronyms consistently","description":"Use standard capitalization for acronyms in all identifiers, method names, variables, and other code elements. Common acronyms like 'API', 'URL', 'JSON', 'HTML', and 'XML' should be written in all uppercase letters.","repository":"langfuse/langfuse","domain":"observability","topic":"Naming Conventions","language":"Json","updated":"2025-04-15","comments":2,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-capitalize-acronyms-consistently.md"},{"slug":"temporal-analyze-algorithm-tradeoffs","title":"Analyze algorithm tradeoffs","description":"When implementing functionality that involves multiple possible algorithmic approaches, explicitly analyze the complexity tradeoffs between alternatives before making a decision. Consider factors such as:","repository":"temporalio/temporal","domain":"orchestration","topic":"Algorithms","language":"Other","updated":"2025-04-15","comments":2,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-analyze-algorithm-tradeoffs.md"},{"slug":"tree-sitter-optimize-memory-usage-patterns","title":"optimize memory usage patterns","description":"Focus on reducing memory footprint and improving cache efficiency through careful data structure design and function parameter optimization. Consider using smaller data types when the value range permits, and design function interfaces to minimize memory overhead.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Performance Optimization","language":"C","updated":"2025-04-15","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-optimize-memory-usage-patterns.md"},{"slug":"dspy-optional-dependency-management","title":"Optional dependency management","description":"Avoid including optional or provider-specific dependencies in the main dependency list. Dependencies should only be required if they are essential for core functionality that all users need.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Configurations","language":"Toml","updated":"2025-04-14","comments":4,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-optional-dependency-management.md"},{"slug":"langfuse-prevent-flaky-test-timing","title":"Prevent flaky test timing","description":"Replace non-deterministic timing patterns with reliable alternatives to prevent flaky tests. This includes: 1. Use element-based waits instead of fixed timeouts:","repository":"langfuse/langfuse","domain":"observability","topic":"Testing","language":"TypeScript","updated":"2025-04-14","comments":4,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-prevent-flaky-test-timing.md"},{"slug":"turborepo-define-api-boundaries","title":"Define API boundaries","description":"Clearly specify what constitutes your public API contract to manage versioning expectations and documentation requirements. Distinguish between structured outputs intended for programmatic consumption versus human-readable outputs that may change without being considered breaking changes.","repository":"vercel/turborepo","domain":"devtools","topic":"API","language":"Other","updated":"2025-04-14","comments":4,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-define-api-boundaries.md"},{"slug":"prisma-prioritize-searchable-names","title":"Prioritize searchable names","description":"Choose names that are easily searchable and immediately understandable, avoiding unclear abbreviations and symbols that hinder discoverability. Names should communicate their purpose clearly without requiring domain knowledge to decode.","repository":"prisma/prisma","domain":"data-systems","topic":"Naming Conventions","language":"Yaml","updated":"2025-04-14","comments":2,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-prioritize-searchable-names.md"},{"slug":"query-deterministic-test-assertions","title":"Deterministic Test Assertions","description":"For tests, prefer deterministic, intention-revealing assertions and keep runtime tests and type-only tests strictly separated. Apply: 1) Use the right matcher for the claim","repository":"tanstack/query","domain":"app-frameworks","topic":"Testing","language":"TSX","updated":"2025-04-13","comments":12,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-deterministic-test-assertions.md"},{"slug":"query-respect-angular-di","title":"Respect Angular DI","description":"When integrating with Angular’s DI and reactivity, follow these rules: - **Dependency access:** For hook-like utilities, accept an optional **Injector** (or injector-derived path) so the function can be executed both **inside and outside** the normal injection context. Use Angular’s injection-context/assert-injector helpers to resolve dependencies from the...","repository":"tanstack/query","domain":"app-frameworks","topic":"Angular","language":"TypeScript","updated":"2025-04-13","comments":6,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-respect-angular-di.md"},{"slug":"ai-maintain-api-naming-consistency","title":"Maintain API naming consistency","description":"When working with AI model interfaces and result objects, ensure consistent property naming across related components. The AI ecosystem involves multiple providers and model types, making naming consistency crucial for maintainable code.","repository":"vercel/ai","domain":"ai-agents","topic":"AI","language":"TypeScript","updated":"2025-04-13","comments":5,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-maintain-api-naming-consistency.md"},{"slug":"ai-verify-properties-before-logging","title":"Verify properties before logging","description":"When logging object properties, always verify that the property names exactly match the actual structure of the object being logged. Incorrect property names (like 'responses' instead of 'response') or non-existent properties will result in undefined values in logs, reducing their usefulness for debugging and troubleshooting.","repository":"vercel/ai","domain":"ai-agents","topic":"Logging","language":"TypeScript","updated":"2025-04-13","comments":5,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-verify-properties-before-logging.md"},{"slug":"ai-place-configurations-appropriately","title":"Place configurations appropriately","description":"Configuration options should be organized based on their nature and scope of use. Place model-specific configurations in constructor parameters or config objects rather than in general settings objects that might be shared across models. Additionally, standardized settings should be consistent across providers and not duplicated in provider-specific options.","repository":"vercel/ai","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-04-13","comments":4,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-place-configurations-appropriately.md"},{"slug":"cline-ai-capability-documentation","title":"AI capability documentation","description":"When documenting AI systems, models, or assistants, ensure technical terminology is precise and capabilities are clearly scoped. Use consistent language to describe what the AI can and cannot do, avoiding vague or overstated claims. For AI agents or assistants, explicitly detail their tools, permissions, and limitations.","repository":"cline/cline","domain":"ai-agents","topic":"AI","language":"Markdown","updated":"2025-04-13","comments":2,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-ai-capability-documentation.md"},{"slug":"deno-avoid-tooling-workarounds","title":"avoid tooling workarounds","description":"Avoid code patterns that require workarounds for tooling limitations or create maintenance burdens. This includes using contextual keywords as identifiers that cause formatter edge cases, and relying on @ts-ignore comments to suppress type checking.","repository":"denoland/deno","domain":"runtimes","topic":"Code Style","language":"JavaScript","updated":"2025-04-13","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-avoid-tooling-workarounds.md"},{"slug":"brew-follow-support-tiers","title":"Follow support tiers","description":"Configure your Homebrew installation according to the defined support tiers to ensure optimal functionality and support. For Tier 1 support (fully supported):","repository":"Homebrew/brew","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2025-04-12","comments":12,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-follow-support-tiers.md"},{"slug":"aider-handle-errors-gracefully","title":"Handle errors gracefully","description":"Always implement appropriate error handling to prevent crashes while providing clear feedback to users. Consider these principles: 1. **Decide on error propagation strategy**: Determine whether errors should be handled locally or propagated to a higher-level handler based on severity and recoverability.","repository":"Aider-AI/aider","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2025-04-12","comments":4,"stars":35856,"raw":"https://awesomereviewers.com/raw/aider-handle-errors-gracefully.md"},{"slug":"ollama-platform-aware-configuration-documentation","title":"Platform-aware configuration documentation","description":"Always document platform-specific configuration differences and requirements thoroughly. When writing documentation or implementing configuration-related code, explicitly address variations across different operating systems and environments.","repository":"ollama/ollama","domain":"llm-infra","topic":"Configurations","language":"Markdown","updated":"2025-04-11","comments":4,"stars":145705,"raw":"https://awesomereviewers.com/raw/ollama-platform-aware-configuration-documentation.md"},{"slug":"prisma-proper-async-error-testing","title":"proper async error testing","description":"When testing for expected errors in async code, use Jest's built-in async error testing patterns instead of try-catch blocks with expectations inside catch handlers. Expectations in catch blocks can be silently skipped if the code stops failing, leading to false positives.","repository":"prisma/prisma","domain":"data-systems","topic":"Testing","language":"TypeScript","updated":"2025-04-11","comments":4,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-proper-async-error-testing.md"},{"slug":"tokio-optimize-algorithmic-efficiency","title":"Optimize algorithmic efficiency","description":"Pay careful attention to operations inside loops and recursive functions to avoid unexpected algorithmic complexity. Be particularly vigilant about: 1. **Hidden O(n²) operations**: Avoid operations that iterate over entire collections inside loops, as they can degrade performance significantly.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Algorithms","language":"Rust","updated":"2025-04-11","comments":4,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-optimize-algorithmic-efficiency.md"},{"slug":"traefik-descriptive-contextual-logging","title":"descriptive contextual logging","description":"Log messages should be descriptive, contextual, and provide actionable information. Include relevant context such as service names, configuration details, or affected components. When logging errors or warnings, explain what happened, why it matters, and what action is being taken or should be taken.","repository":"traefik/traefik","domain":"cloud-infra","topic":"Logging","language":"Go","updated":"2025-04-11","comments":3,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-descriptive-contextual-logging.md"},{"slug":"opentofu-contextualize-security-findings","title":"Contextualize security findings","description":"When reporting security vulnerabilities, include sufficient context beyond just vulnerability IDs or codes. Always preserve standard identifiers (like GO-YYYY-NNNN) in titles while adding descriptive information about affected components, versions, and modules. This makes vulnerabilities easier to prioritize, track, and remediate.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Security","language":"Yaml","updated":"2025-04-11","comments":2,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-contextualize-security-findings.md"},{"slug":"nest-strategic-dependency-configuration","title":"Strategic dependency configuration","description":"Configure dependencies in package.json strategically based on how they''re used in your project: 1. **Direct dependencies** - Only for packages required for normal operation","repository":"nestjs/nest","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2025-04-10","comments":5,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-strategic-dependency-configuration.md"},{"slug":"nest-package-dependency-configuration","title":"Package dependency configuration","description":"Configure dependencies appropriately in package.json based on usage patterns and requirements. This improves package maintainability, flexibility, and reduces unnecessary dependencies.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2025-04-10","comments":4,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-package-dependency-configuration.md"},{"slug":"prettier-api-documentation-clarity","title":"API documentation clarity","description":"Ensure API documentation provides clear, accurate, and comprehensive information for developers. This includes precise function signatures, detailed parameter descriptions, correct terminology, and helpful external references.","repository":"prettier/prettier","domain":"devtools","topic":"API","language":"Markdown","updated":"2025-04-10","comments":4,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-api-documentation-clarity.md"},{"slug":"material-ui-defensively-handle-nullables","title":"Defensively handle nullables","description":"When working with values that could be null or undefined, implement defensive coding patterns to prevent runtime errors. This practice is essential for robust React applications.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Null Handling","language":"JavaScript","updated":"2025-04-10","comments":3,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-defensively-handle-nullables.md"},{"slug":"router-environment-file-management","title":"Environment file management","description":"Ensure proper handling of environment files by following these practices: (1) Add actual environment files (`.env`, `.env.local`, etc.) to `.gitignore` to prevent sensitive data from being committed, (2) Include example environment files (`.env.example`) in version control to help other developers understand required configuration, and (3) Add clear...","repository":"TanStack/router","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2025-04-10","comments":3,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-environment-file-management.md"},{"slug":"material-ui-write-timeless-documentation","title":"Write timeless documentation","description":"Documentation should be written to remain clear and useful regardless of when it's read. Avoid references to temporary contexts like \"in this PR,\" \"original behavior,\" or \"current implementation\" that will lose meaning over time. Instead, precisely describe behaviors, changes, and functionality in a way that will remain clear to developers reading the code...","repository":"mui/material-ui","domain":"app-frameworks","topic":"Documentation","language":"TypeScript","updated":"2025-04-10","comments":2,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-write-timeless-documentation.md"},{"slug":"nuxt-precise-language-usage","title":"precise language usage","description":"Use precise, natural language in documentation to improve clarity and readability. Focus on accurate word choice, proper grammar, and natural phrasing that flows well for readers.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-04-09","comments":11,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-precise-language-usage.md"},{"slug":"kotlin-minimize-unnecessary-work","title":"Minimize unnecessary work","description":"Optimize performance by reducing the amount of computation performed, especially on data that won''t appear in the final result. Apply these strategies:","repository":"JetBrains/kotlin","domain":"runtimes","topic":"Performance Optimization","language":"Kotlin","updated":"2025-04-09","comments":7,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-minimize-unnecessary-work.md"},{"slug":"opentofu-reduce-code-nesting","title":"Reduce code nesting","description":"Minimize nesting levels and complexity in your code to improve readability and maintainability. Use early returns instead of deeply nested conditions, and restructure switch statements to reduce complexity.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Code Style","language":"Go","updated":"2025-04-09","comments":6,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-reduce-code-nesting.md"},{"slug":"compose-network-api-precision","title":"Network API precision","description":"Use the appropriate Docker network API method based on the specific behavior you need. NetworkList and NetworkInspect have different matching behaviors that can lead to unexpected results if used incorrectly.","repository":"docker/compose","domain":"orchestration","topic":"Networking","language":"Go","updated":"2025-04-09","comments":3,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-network-api-precision.md"},{"slug":"ai-optimize-ci-type-checking","title":"Optimize CI type checking","description":"Configure separate TypeScript type-checking strategies for CI environments and local development. CI pipelines should run complete type checks that validate the entire codebase, while local development can use faster configurations to improve developer productivity.","repository":"vercel/ai","domain":"ai-agents","topic":"CI/CD","language":"Json","updated":"2025-04-09","comments":2,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-optimize-ci-type-checking.md"},{"slug":"langfuse-materialize-database-indexes","title":"Materialize database indexes","description":"Always materialize database indexes after creation to ensure they are fully built and immediately available for queries. This is especially important in migration scripts where database performance shouldn't be compromised during or after the migration process. Without materialization, indexes may not be immediately usable, causing potential performance...","repository":"langfuse/langfuse","domain":"observability","topic":"Database","language":"Sql","updated":"2025-04-09","comments":2,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-materialize-database-indexes.md"},{"slug":"prisma-document-configuration-alternatives","title":"Document configuration alternatives","description":"When documenting configuration setup, provide multiple formats and approaches to accommodate different tools, platforms, and environments. Include both the base command and tool-specific configuration examples when applicable.","repository":"prisma/prisma","domain":"data-systems","topic":"Configurations","language":"Markdown","updated":"2025-04-09","comments":2,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-document-configuration-alternatives.md"},{"slug":"temporal-protobuf-extensibility-patterns","title":"Protobuf extensibility patterns","description":"When designing Protocol Buffer APIs, use `oneof` fields to create extensible message structures that maintain compatibility while providing type safety. This pattern allows APIs to evolve over time by adding new message variants without breaking existing clients.","repository":"temporalio/temporal","domain":"orchestration","topic":"API","language":"Other","updated":"2025-04-09","comments":2,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-protobuf-extensibility-patterns.md"},{"slug":"workers-sdk-design-repeatable-ci-workflows","title":"Design repeatable CI workflows","description":"CI workflows should be idempotent and handle cleanup automatically to avoid manual intervention and ensure reliable execution. When designing workflows that create resources, branches, or temporary artifacts, always include cleanup steps that can run safely multiple times.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"CI/CD","language":"Yaml","updated":"2025-04-09","comments":2,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-design-repeatable-ci-workflows.md"},{"slug":"zod-run-type-resolution-checks","title":"Run Type Resolution Checks","description":"Add a CI/pre-release gate that validates your published package’s JavaScript + TypeScript type resolution. Use `@arethetypeswrong/cli` to catch broken `exports`/subpath import mappings across CJS/ESM and Node versions, and configure it to your supported runtime matrix (e.g., ignore known/unavoidable legacy Node failures via `--profile`).","repository":"colinhacks/zod","domain":"app-frameworks","topic":"CI/CD","language":"Json","updated":"2025-04-09","comments":2,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-run-type-resolution-checks.md"},{"slug":"cline-restrict-external-dependencies","title":"Restrict external dependencies","description":"Dependencies from packages outside your organization's trusted domain pose security risks and should be avoided in pull requests. When package-lock.json files include external dependencies, they introduce potential vulnerabilities that bypass internal security controls.","repository":"cline/cline","domain":"ai-agents","topic":"Security","language":"Json","updated":"2025-04-09","comments":1,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-restrict-external-dependencies.md"},{"slug":"mastodon-use-safe-type-guards","title":"Use safe type guards","description":"When implementing type guards for nullable or unknown types, use the `in` operator and property existence checks instead of type casting. This approach provides better null safety by verifying that properties exist before accessing them, preventing runtime errors from null or undefined values.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Null Handling","language":"TSX","updated":"2025-04-08","comments":3,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-use-safe-type-guards.md"},{"slug":"zed-respect-language-specific-conventions","title":"Respect language-specific conventions","description":"Always adhere to the established formatting and syntax conventions of each programming language while maintaining consistency across related language configurations. This includes:","repository":"zed-industries/zed","domain":"devtools","topic":"Code Style","language":"Toml","updated":"2025-04-08","comments":3,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-respect-language-specific-conventions.md"},{"slug":"kubeflow-enforce-least-privilege","title":"Enforce least privilege","description":"Configure all systems with the minimum permissions required to function. For Kubernetes deployments, use security contexts that prevent privilege escalation and running as root:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Security","language":"Yaml","updated":"2025-04-08","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-enforce-least-privilege.md"},{"slug":"agent-zero-sanitize-model-output","title":"Sanitize Model Output","description":"When handling untrusted model/text output that will be serialized into JSON (or rendered in a UI), normalize it before output generation—specifically strip or escape tag-like content (e.g., “<think>…</think>”) so it cannot corrupt JSON or break downstream parsing.","repository":"agent0ai/agent-zero","domain":"ai-agents","topic":"Security","language":"Other","updated":"2025-04-08","comments":1,"stars":17612,"raw":"https://awesomereviewers.com/raw/agent-zero-sanitize-model-output.md"},{"slug":"agent-zero-sanitize-untrusted-tags","title":"Sanitize untrusted tags","description":"Treat any tag/markup coming from user input, LLM output, or external commands as untrusted. Validate and sanitize it at the earliest boundary before embedding into JSON or rendering in the UI—e.g., strip/escape disallowed tags so they can’t break parsers or visuals.","repository":"agent0ai/agent-zero","domain":"ai-agents","topic":"Security","language":"Shell","updated":"2025-04-08","comments":1,"stars":17612,"raw":"https://awesomereviewers.com/raw/agent-zero-sanitize-untrusted-tags.md"},{"slug":"influxdb-avoid-unnecessary-work","title":"Avoid unnecessary work","description":"When optimizing performance-critical code paths, eliminate redundant operations and unnecessary processing: 1. **Exit loops early** when a decision has been made and no further iterations are needed:","repository":"influxdata/influxdb","domain":"data-systems","topic":"Performance Optimization","language":"Go","updated":"2025-04-07","comments":4,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-avoid-unnecessary-work.md"},{"slug":"influxdb-prefer-configurable-values","title":"Prefer configurable values","description":"Always use configurable values instead of hardcoded defaults when available. This ensures that user preferences are respected throughout the application lifecycle and prevents unexpected behavior.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Configurations","language":"Go","updated":"2025-04-07","comments":4,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-prefer-configurable-values.md"},{"slug":"ollama-loose-api-coupling","title":"Loose API coupling","description":"Maintain a clear separation between API definitions and their implementations by avoiding direct passing of API structures to implementation layers. Extract only the necessary values from API structures when passing data downstream.","repository":"ollama/ollama","domain":"llm-infra","topic":"API","language":"Go","updated":"2025-04-07","comments":4,"stars":145704,"raw":"https://awesomereviewers.com/raw/ollama-loose-api-coupling.md"},{"slug":"hyprland-optimize-with-bit-manipulation","title":"optimize with bit manipulation","description":"Use bit manipulation techniques to optimize memory usage and computational efficiency in data structures and enums. For flag enums, consistently use bit-shift notation `(1 << n)` to make bit positions explicit and enable efficient bitwise operations. For compact data representation, leverage bitfields within unions to pack multiple boolean flags into...","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Algorithms","language":"Other","updated":"2025-04-07","comments":3,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-optimize-with-bit-manipulation.md"},{"slug":"react-native-validate-configuration-formats","title":"Validate configuration formats","description":"Ensure configuration values use the correct data format expected by target systems and avoid duplication by sourcing from authoritative locations when possible. Mismatched formats can cause runtime failures, while duplicated configurations create maintenance overhead and inconsistency risks.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Configurations","language":"Yaml","updated":"2025-04-07","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-validate-configuration-formats.md"},{"slug":"volcano-api-validation-consistency","title":"API validation consistency","description":"Ensure API validation rules and type definitions remain consistent across all validation layers and components. When implementing validation logic, verify that kubebuilder annotations, manual validation functions, and API type definitions all enforce the same constraints and use compatible data types.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"API","language":"Go","updated":"2025-04-07","comments":2,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-api-validation-consistency.md"},{"slug":"helix-nest-related-configuration-options","title":"Nest related configuration options","description":"Group related configuration options into nested TOML sections rather than using flat key-value pairs. This improves readability, maintainability, and makes relationships between settings more explicit.","repository":"helix-editor/helix","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2025-04-06","comments":3,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-nest-related-configuration-options.md"},{"slug":"langfuse-proper-configuration-placement","title":"Proper configuration placement","description":"Place configuration files and settings at the appropriate level in your repository structure. In monorepos, some configurations must be at the root level while others belong at the package level.","repository":"langfuse/langfuse","domain":"observability","topic":"Configurations","language":"Json","updated":"2025-04-06","comments":2,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-proper-configuration-placement.md"},{"slug":"stagehand-provide-contextual-error-messages","title":"Provide contextual error messages","description":"Error messages should include specific context about what went wrong and provide actionable guidance for resolution. Avoid generic error messages that leave developers guessing about the root cause or solution.","repository":"browserbase/stagehand","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2025-04-05","comments":5,"stars":16443,"raw":"https://awesomereviewers.com/raw/stagehand-provide-contextual-error-messages.md"},{"slug":"influxdb-use-descriptive-names","title":"Use descriptive names","description":"Names in code should be self-documenting, accurately reflect purpose, and follow consistent conventions. Apply these principles throughout your code:","repository":"influxdata/influxdb","domain":"data-systems","topic":"Naming Conventions","language":"Go","updated":"2025-04-04","comments":8,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-use-descriptive-names.md"},{"slug":"mono-websocket-lifecycle-management","title":"WebSocket lifecycle management","description":"Ensure proper WebSocket connection lifecycle management by using `once()` instead of `on()` for cleanup operations and separating initialization from construction to avoid race conditions.","repository":"rocicorp/mono","domain":"data-systems","topic":"Networking","language":"TypeScript","updated":"2025-04-04","comments":4,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-websocket-lifecycle-management.md"},{"slug":"nuxt-strategic-component-loading","title":"Strategic component loading","description":"Choose component loading strategies based on when interactivity is actually needed, not just code splitting. Lazy prefixed components only control chunk size but still load eagerly with the page's scripts. Use delayed hydration for components that don't need immediate interactivity, avoiding unnecessary JavaScript execution during initial page load. Be...","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Performance Optimization","language":"Markdown","updated":"2025-04-03","comments":4,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-strategic-component-loading.md"},{"slug":"ai-async-error-callbacks","title":"Async error callbacks","description":"When handling asynchronous operations, especially those that might continue running in the background after the main consumer has moved on, provide error callback options to ensure errors are properly reported and handled. This pattern prevents silent failures in background tasks and enables proper logging, monitoring, and recovery.","repository":"vercel/ai","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2025-04-03","comments":3,"stars":15590,"raw":"https://awesomereviewers.com/raw/ai-async-error-callbacks.md"},{"slug":"playwright-document-build-configuration-changes","title":"Document build configuration changes","description":"When modifying build tool configurations, especially during migrations, provide detailed technical justification for each change. Document why specific options, plugins, or flags are being added, removed, or modified with concrete reasoning.","repository":"microsoft/playwright","domain":"devtools","topic":"CI/CD","language":"JavaScript","updated":"2025-04-03","comments":2,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-document-build-configuration-changes.md"},{"slug":"shaders-precision-resize-and-singleton-style","title":"Precision Resize and Singleton Style","description":"When performance or visual stability matters (e.g., zoom/antialiasing), prefer precision-first measurement and avoid expensive DOM churn. Apply these rules:","repository":"paper-design/shaders","domain":"app-frameworks","topic":"Performance Optimization","language":"TypeScript","updated":"2025-04-03","comments":2,"stars":3286,"raw":"https://awesomereviewers.com/raw/shaders-precision-resize-and-singleton-style.md"},{"slug":"likec4-disallow-unsafe-schemes","title":"disallow unsafe schemes","description":"Treat resource URIs and external references as untrusted input: normalize and validate schemes, and reject anything not on an explicit allowlist. Motivation: schemes such as file: (and other unsafe schemes like javascript: or data: when used for resources) can expose local files or enable injection attacks, and are commonly blocked by browsers — so they...","repository":"likec4/likec4","domain":"devtools","topic":"Security","language":"TypeScript","updated":"2025-04-03","comments":1,"stars":2582,"raw":"https://awesomereviewers.com/raw/likec4-disallow-unsafe-schemes.md"},{"slug":"brew-minimize-unnecessary-operations","title":"Minimize unnecessary operations","description":"Optimize performance by eliminating redundant operations and arranging code to avoid unnecessary computations, especially in frequently executed paths. Follow these principles:","repository":"Homebrew/brew","domain":"devtools","topic":"Performance Optimization","language":"Ruby","updated":"2025-04-02","comments":6,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-minimize-unnecessary-operations.md"},{"slug":"opencv-maintain-code-consistency","title":"Maintain code consistency","description":"Keep code clean and consistent with established project conventions. This includes: 1. Follow existing formatting style in files: ```cpp // Follow Allman style if file uses it","repository":"opencv/opencv","domain":"ml-systems","topic":"Code Style","language":"Other","updated":"2025-04-02","comments":5,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-maintain-code-consistency.md"},{"slug":"material-ui-standardize-build-configurations","title":"Standardize build configurations","description":"When configuring module builds, maintain consistent and explicit configuration for different module formats (CJS, ESM, modern) to ensure compatibility across environments. Package exports should be clearly defined with appropriate conditions for each module system.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2025-04-02","comments":4,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-standardize-build-configurations.md"},{"slug":"opencv-framework-synchronization-practices","title":"Framework synchronization practices","description":"When implementing concurrent code, always use the framework''s provided synchronization primitives rather than direct language features. This ensures compatibility across all build configurations and platforms:","repository":"opencv/opencv","domain":"ml-systems","topic":"Concurrency","language":"C++","updated":"2025-04-02","comments":4,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-framework-synchronization-practices.md"},{"slug":"openpilot-be-specific-with-exceptions","title":"Be specific with exceptions","description":"Avoid catching broad exception types like `Exception` and instead catch specific exceptions that you expect and can handle appropriately. When errors occur, they should be explicit rather than failing silently, and should include proper logging or re-raising when necessary.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Error Handling","language":"Python","updated":"2025-04-02","comments":4,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-be-specific-with-exceptions.md"},{"slug":"terraform-configuration-override-precedence","title":"Configuration override precedence","description":"When designing systems with configurations that can be specified at multiple levels (global vs local, environment vs file, default vs override), establish and document a clear precedence model. Always prioritize more specific configurations over general ones.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Configurations","language":"Go","updated":"2025-04-02","comments":4,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-configuration-override-precedence.md"},{"slug":"material-ui-explicit-configuration-resolution","title":"Explicit configuration resolution","description":"Always use explicit path resolution and document ordering requirements in configuration files to prevent environment-dependent issues. This makes configurations more reliable and self-documenting.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Configurations","language":"JavaScript","updated":"2025-04-02","comments":3,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-explicit-configuration-resolution.md"},{"slug":"material-ui-nextjs-integration-patterns","title":"Next.js integration patterns","description":"When integrating with Next.js, follow framework-specific patterns carefully and stay updated with API changes to ensure proper server-side rendering and optimal code.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Next","language":"TSX","updated":"2025-04-02","comments":2,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-nextjs-integration-patterns.md"},{"slug":"prisma-design-runtime-specific-api-exports","title":"Design runtime-specific API exports","description":"When designing APIs that need to work across different JavaScript runtimes (Node.js, edge environments, browsers), create explicit export configurations that account for runtime-specific implementations. Different runtimes may require different API implementations that aren't interchangeable, so provide separate entry points rather than trying to create a...","repository":"prisma/prisma","domain":"data-systems","topic":"API","language":"Json","updated":"2025-04-02","comments":2,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-design-runtime-specific-api-exports.md"},{"slug":"cli-use-descriptive-names","title":"Use descriptive names","description":"Choose names that clearly communicate purpose, content, and intent. Avoid generic or ambiguous identifiers that require additional context to understand.","repository":"snyk/cli","domain":"security","topic":"Naming Conventions","language":"TypeScript","updated":"2025-04-01","comments":9,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-use-descriptive-names.md"},{"slug":"netty-memory-ordering-needs-barriers","title":"Memory ordering needs barriers","description":"Ensure proper memory ordering in concurrent code by using appropriate memory barriers and atomic operations based on the access pattern. When implementing release-store semantics, place the store fence before the actual store to prevent instruction reordering:","repository":"netty/netty","domain":"runtimes","topic":"Concurrency","language":"Java","updated":"2025-04-01","comments":6,"stars":34227,"raw":"https://awesomereviewers.com/raw/netty-memory-ordering-needs-barriers.md"},{"slug":"cli-validate-environment-variables-early","title":"validate environment variables early","description":"Environment variables should be validated early in the application lifecycle with descriptive, actionable error messages. Use specific, namespaced variable names to avoid conflicts in CI/CD environments and other systems. When possible, avoid hardcoding configuration values and instead use configuration files or well-defined environment variables.","repository":"snyk/cli","domain":"security","topic":"Configurations","language":"Other","updated":"2025-04-01","comments":3,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-validate-environment-variables-early.md"},{"slug":"fiber-validate-security-inputs","title":"Validate security inputs","description":"Always validate security-critical inputs to prevent DoS attacks and injection vulnerabilities. Implement size limits, scheme restrictions, and format validation for user-controlled data that affects security mechanisms.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Security","language":"Go","updated":"2025-04-01","comments":3,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-validate-security-inputs.md"},{"slug":"grafana-avoid-plaintext-credentials","title":"Avoid plaintext credentials","description":"Never include plaintext passwords or credentials in connection strings, configuration files, or documentation examples. This creates security vulnerabilities as credentials could be exposed in logs, version control, or to unauthorized personnel.","repository":"grafana/grafana","domain":"observability","topic":"Security","language":"Markdown","updated":"2025-04-01","comments":1,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-avoid-plaintext-credentials.md"},{"slug":"react-native-extract-complex-logic","title":"extract complex logic","description":"Break down complex functions and large files into smaller, focused units with clear responsibilities. Extract complex logic into well-named helper functions, split large files into focused modules, and prefer `const` over `let` for variables that won't be reassigned.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Code Style","language":"JavaScript","updated":"2025-03-31","comments":7,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-extract-complex-logic.md"},{"slug":"vitess-extract-shared-code-patterns","title":"Extract shared code patterns","description":"Identify and extract repeated code patterns into reusable functions to improve maintainability and reduce duplication. When similar code appears in multiple places, create a shared helper function that captures the common logic.","repository":"vitessio/vitess","domain":"data-systems","topic":"Code Style","language":"Go","updated":"2025-03-31","comments":6,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-extract-shared-code-patterns.md"},{"slug":"turborepo-validate-performance-impact-first","title":"Validate performance impact first","description":"Always validate performance changes through profiling or benchmarking before implementation, and favor memory-efficient patterns when making optimizations. Key practices:","repository":"vercel/turborepo","domain":"devtools","topic":"Performance Optimization","language":"Rust","updated":"2025-03-31","comments":5,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-validate-performance-impact-first.md"},{"slug":"fiber-use-context-for-configuration","title":"Use context for configuration","description":"When accessing application state or configuration within request handlers, always use the context method `c.App().State()` instead of direct app instance references. This pattern ensures proper context isolation, supports dependency injection, and works correctly in multi-file applications where the app instance may not be directly accessible.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Configurations","language":"Markdown","updated":"2025-03-31","comments":4,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-use-context-for-configuration.md"},{"slug":"playwright-secure-authentication-state-files","title":"Secure authentication state files","description":"Authentication state files (such as browser session files, cookies, or tokens) contain sensitive credentials that can lead to full account takeover if exposed. These files must never be committed to version control systems as they could be used to impersonate users or test accounts.","repository":"microsoft/playwright","domain":"devtools","topic":"Security","language":"Markdown","updated":"2025-03-31","comments":2,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-secure-authentication-state-files.md"},{"slug":"aider-thread-safe-message-dispatching","title":"Thread-safe message dispatching","description":"When implementing communication between multiple threads, ensure that messages are correctly routed to their intended recipients. Avoid designs where all worker threads consume from a single shared queue when messages are intended for specific threads, as this creates race conditions where messages can be processed by the wrong thread.","repository":"Aider-AI/aider","domain":"ai-agents","topic":"Concurrency","language":"Python","updated":"2025-03-30","comments":2,"stars":35856,"raw":"https://awesomereviewers.com/raw/aider-thread-safe-message-dispatching.md"},{"slug":"framework-manage-dependencies-wisely","title":"Manage dependencies wisely","description":"When configuring dependencies in composer.json files, follow these guidelines to ensure maintainable and reliable configurations: 1. **Only include direct dependencies**: Add dependencies only when they are directly used by your package. If a dependency is accessed through another package, don''t include it directly.","repository":"laravel/framework","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2025-03-29","comments":5,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-manage-dependencies-wisely.md"},{"slug":"lobe-chat-configuration-merging-precedence","title":"Configuration merging precedence","description":"When merging configuration objects, always preserve existing values and follow clear precedence rules to avoid unintentionally overriding settings. Use spread operators carefully and ensure the merge logic is implemented at the appropriate layer (preferably in action/store layer rather than component level).","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Configurations","language":"TSX","updated":"2025-03-29","comments":3,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-configuration-merging-precedence.md"},{"slug":"deno-comprehensive-test-verification","title":"comprehensive test verification","description":"Write tests that comprehensively verify functionality by covering related scenarios and testing complete outputs rather than partial matches. This approach makes tests more resilient to code changes and ensures thorough validation.","repository":"denoland/deno","domain":"runtimes","topic":"Testing","language":"Other","updated":"2025-03-29","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-comprehensive-test-verification.md"},{"slug":"duckdb-comprehensive-test-coverage","title":"comprehensive test coverage","description":"Ensure thorough test coverage by systematically testing edge cases, boundary conditions, failure scenarios, and different data types. When implementing new functionality, consider all possible input variations, error conditions, and integration points.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Testing","language":"Other","updated":"2025-03-28","comments":7,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-comprehensive-test-coverage.md"},{"slug":"istio-feature-flag-lifecycle-management","title":"Feature flag lifecycle management","description":"Establish clear guidelines for feature flag creation, default values, and removal strategy based on risk assessment and user impact. **When to use feature flags:**","repository":"istio/istio","domain":"orchestration","topic":"Configurations","language":"Go","updated":"2025-03-28","comments":6,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-feature-flag-lifecycle-management.md"},{"slug":"vite-environment-variable-management","title":"Environment variable management","description":"When working with environment variables in Vite applications, be explicit about variable loading behavior and precedence. Environment variables from `.env` files are always loaded regardless of mode, with mode-specific files (`.env.[mode]`) taking precedence over generic ones.","repository":"vitejs/vite","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2025-03-28","comments":5,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-environment-variable-management.md"},{"slug":"terraform-clarify-test-documentation","title":"Clarify test documentation","description":"Ensure all testing-related documentation is clear, accurate, and user-focused. Use precise terminology when describing test components, fully explain configuration attributes with their effects, and provide complete examples that demonstrate proper usage.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Testing","language":"Other","updated":"2025-03-28","comments":4,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-clarify-test-documentation.md"},{"slug":"neovim-consistent-algorithm-interfaces","title":"consistent algorithm interfaces","description":"When designing interfaces for filtering, traversal, or search algorithms, research existing codebase patterns to maintain consistency in terminology and boolean logic. Before introducing new parameter names like \"skip\", \"filter\", \"match\", or \"predicate\", analyze which terms are already established in similar contexts.","repository":"neovim/neovim","domain":"devtools","topic":"Algorithms","language":"Txt","updated":"2025-03-28","comments":3,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-consistent-algorithm-interfaces.md"},{"slug":"prisma-avoid-quadratic-complexity","title":"avoid quadratic complexity","description":"When processing collections, be mindful of time complexity and avoid accidentally creating O(N²) algorithms, especially when simpler O(N) alternatives exist.","repository":"prisma/prisma","domain":"data-systems","topic":"Algorithms","language":"TypeScript","updated":"2025-03-28","comments":3,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-avoid-quadratic-complexity.md"},{"slug":"prisma-centralize-configuration-logic","title":"Centralize configuration logic","description":"Avoid scattering configuration defaults, validation, and loading logic across multiple functions. Instead, centralize these concerns in dedicated configuration modules or at the entry points of your application.","repository":"prisma/prisma","domain":"data-systems","topic":"Configurations","language":"TypeScript","updated":"2025-03-28","comments":3,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-centralize-configuration-logic.md"},{"slug":"react-native-validate-before-operations","title":"validate before operations","description":"Always explicitly check for null, undefined, or missing properties/methods before performing operations that could fail. JavaScript's loose typing and the fact that `typeof null === 'object'` can lead to runtime errors if values aren't validated first.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Null Handling","language":"JavaScript","updated":"2025-03-28","comments":3,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-validate-before-operations.md"},{"slug":"terraform-technical-precision-matters","title":"Technical precision matters","description":"When documenting algorithms, data structures, and computational processes, use precise and objective language rather than subjective assessments. Replace phrases like \"better approach\" with specific technical comparisons that highlight concrete differences, such as:","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Algorithms","language":"Other","updated":"2025-03-28","comments":3,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-technical-precision-matters.md"},{"slug":"duckdb-prefer-environment-variables","title":"prefer environment variables","description":"When configuring behavior that needs to work across different execution contexts (CI workflows, manual runs, different build systems), prefer environment variables over command-line flags or hardcoded options. Environment variables provide broader compatibility and can be easily overridden without modifying scripts or commands.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Configurations","language":"Yaml","updated":"2025-03-28","comments":2,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-prefer-environment-variables.md"},{"slug":"istio-security-behavior-clarity","title":"Security behavior clarity","description":"When documenting or describing security-related changes, especially bug fixes and behavioral modifications, ensure clear and explicit communication of security implications. Use proper security terminology and clearly describe both the problematic behavior and the fix.","repository":"istio/istio","domain":"orchestration","topic":"Security","language":"Yaml","updated":"2025-03-28","comments":2,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-security-behavior-clarity.md"},{"slug":"nuxt-safe-error-data-handling","title":"safe error data handling","description":"When processing error data that may contain unsafe or undefined values, use safe parsing methods and defensive programming techniques to prevent secondary exceptions during error handling.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2025-03-28","comments":2,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-safe-error-data-handling.md"},{"slug":"prisma-validate-sensitive-operations","title":"Validate sensitive operations","description":"Always implement safety checks before performing operations that could expose sensitive data or cause destructive changes. This includes validating targets before file deletion and sanitizing credentials in error messages.","repository":"prisma/prisma","domain":"data-systems","topic":"Security","language":"TypeScript","updated":"2025-03-28","comments":2,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-validate-sensitive-operations.md"},{"slug":"db-gpt-clean-typing-and-dry","title":"Clean typing and DRY","description":"Adopt a “type-correct, DRY, and clean” coding style. Rules: 1) Make type hints compile and be precise - If you use `Dict`, `List`, `Union`, etc., import them from `typing` (or use built-in `dict`/`list` where appropriate).","repository":"eosphoros-ai/DB-GPT","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2025-03-27","comments":7,"stars":18703,"raw":"https://awesomereviewers.com/raw/db-gpt-clean-typing-and-dry.md"},{"slug":"parlant-comprehensive-test-coverage","title":"comprehensive test coverage","description":"Ensure tests are comprehensive and explicit to prevent regressions and gaps in coverage. Tests should cover all scenarios including edge cases, error conditions, and boundary conditions. Avoid vague assertions that could pass even when the implementation is incorrect.","repository":"emcie-co/parlant","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2025-03-27","comments":6,"stars":12205,"raw":"https://awesomereviewers.com/raw/parlant-comprehensive-test-coverage.md"},{"slug":"helix-avoid-hardcoded-configuration-values","title":"avoid hardcoded configuration values","description":"Avoid hardcoding configuration values that affect user experience or behavior. Instead, make these values configurable with sensible defaults. This is especially important for timing values, thresholds, and user-facing constants that different users may want to customize.","repository":"helix-editor/helix","domain":"devtools","topic":"Configurations","language":"Rust","updated":"2025-03-27","comments":4,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-avoid-hardcoded-configuration-values.md"},{"slug":"istio-document-observability-rationale","title":"Document observability rationale","description":"When introducing, modifying, or removing observability features (tracing, metrics, monitoring configurations), always include clear documentation explaining the rationale, use cases, and migration guidance. Users need to understand why they would want to use a feature and how it solves their specific problems.","repository":"istio/istio","domain":"orchestration","topic":"Observability","language":"Yaml","updated":"2025-03-27","comments":4,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-document-observability-rationale.md"},{"slug":"parlant-simplify-algorithmic-implementations","title":"Simplify algorithmic implementations","description":"Favor clear, simple algorithmic implementations over complex custom logic. When faced with algorithmic choices, prefer built-in functions, direct approaches, and well-structured decomposition into stages.","repository":"emcie-co/parlant","domain":"ai-agents","topic":"Algorithms","language":"Python","updated":"2025-03-27","comments":4,"stars":12205,"raw":"https://awesomereviewers.com/raw/parlant-simplify-algorithmic-implementations.md"},{"slug":"semgrep-validate-environment-variable-usage","title":"validate environment variable usage","description":"Always validate environment variables with proper fallback logic and avoid unnecessary usage in tests or when defaults suffice. Check for truthiness rather than explicit None comparisons to handle empty strings, and ensure configuration values match their declared types and intended usage.","repository":"semgrep/semgrep","domain":"security","topic":"Configurations","language":"Python","updated":"2025-03-27","comments":4,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-validate-environment-variable-usage.md"},{"slug":"crewai-typed-api-client-abstractions","title":"Typed API client abstractions","description":"When designing API clients, encapsulate responses in typed objects rather than passing raw JSON throughout your codebase. This improves maintainability, enables better error handling, and provides type safety.","repository":"crewaiinc/crewai","domain":"ai-agents","topic":"API","language":"Python","updated":"2025-03-27","comments":3,"stars":33945,"raw":"https://awesomereviewers.com/raw/crewai-typed-api-client-abstractions.md"},{"slug":"playwright-use-semantically-clear-names","title":"Use semantically clear names","description":"Names should clearly communicate their actual purpose and be consistent across similar contexts. Avoid names that mislead about functionality or create confusion about the component's role.","repository":"microsoft/playwright","domain":"devtools","topic":"Naming Conventions","language":"TSX","updated":"2025-03-27","comments":2,"stars":76113,"raw":"https://awesomereviewers.com/raw/playwright-use-semantically-clear-names.md"},{"slug":"ui-tars-desktop-use-cross-platform-build-commands","title":"Use cross-platform build commands","description":"Replace native shell commands in package.json scripts with cross-platform alternatives to ensure build consistency across different operating systems. Native commands like `rm -rf` fail on Windows, breaking CI/CD pipelines that run on mixed environments.","repository":"bytedance/UI-TARS-desktop","domain":"ai-agents","topic":"CI/CD","language":"Json","updated":"2025-03-27","comments":2,"stars":18021,"raw":"https://awesomereviewers.com/raw/ui-tars-desktop-use-cross-platform-build-commands.md"},{"slug":"cli-pin-dependency-versions","title":"Pin dependency versions","description":"Always pin dependencies to exact versions in package.json instead of using semantic version ranges (^, ~) to ensure reproducible builds and prevent unintentional version drift during deployments.","repository":"snyk/cli","domain":"security","topic":"Configurations","language":"Json","updated":"2025-03-26","comments":6,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-pin-dependency-versions.md"},{"slug":"ghostty-in-tree-build-configurations","title":"In-tree build configurations","description":"Keep all build configuration files (Snapcraft, Flatpak manifests, etc.) in the repository alongside your code to ensure they are tested, versioned, and maintained together with the application. This approach facilitates CI testing, allows for regression detection, and ensures consistency across distribution methods.","repository":"ghostty-org/ghostty","domain":"devtools","topic":"CI/CD","language":"Yaml","updated":"2025-03-26","comments":4,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-in-tree-build-configurations.md"},{"slug":"logseq-fail-fast-explicitly","title":"Fail fast explicitly","description":"When critical components or operations fail, throw explicit errors rather than silently continuing or returning nil. Silent failures can mislead users into thinking operations succeeded when they didn't, potentially causing data loss or inconsistent application state.","repository":"logseq/logseq","domain":"app-frameworks","topic":"Error Handling","language":"Other","updated":"2025-03-26","comments":4,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-fail-fast-explicitly.md"},{"slug":"drizzle-orm-optimize-algorithmic-performance","title":"optimize algorithmic performance","description":"Prioritize algorithmic efficiency and avoid unnecessary computational overhead, especially in type-level operations and validation logic. When multiple approaches achieve the same result, choose the one with better performance characteristics.","repository":"drizzle-team/drizzle-orm","domain":"data-systems","topic":"Algorithms","language":"TypeScript","updated":"2025-03-26","comments":3,"stars":29461,"raw":"https://awesomereviewers.com/raw/drizzle-orm-optimize-algorithmic-performance.md"},{"slug":"supabase-explicit-role-security-management","title":"Explicit role security management","description":"Always be explicit about role privileges when configuring database security. Remember that both `authenticated` and `anon` roles typically have default privileges that need to be explicitly revoked. Use SQL migrations rather than GUI tools to manage role permissions for better version control and reproducibility.","repository":"supabase/supabase","domain":"data-systems","topic":"Database","language":"Other","updated":"2025-03-26","comments":3,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-explicit-role-security-management.md"},{"slug":"drizzle-orm-intuitive-api-method-design","title":"intuitive API method design","description":"Design API methods with intuitive names and signatures that follow established conventions and provide good ergonomics. Avoid method names that conflict with well-known patterns from other domains, and prefer streamlined method signatures that reduce unnecessary verbosity.","repository":"drizzle-team/drizzle-orm","domain":"data-systems","topic":"API","language":"TypeScript","updated":"2025-03-26","comments":2,"stars":29461,"raw":"https://awesomereviewers.com/raw/drizzle-orm-intuitive-api-method-design.md"},{"slug":"mastodon-complete-react-eslint-setup","title":"complete React ESLint setup","description":"When configuring ESLint for React projects, ensure you include comprehensive React-specific configurations beyond the basic setup. Include both the React import plugin configuration and JSX runtime configuration to get enhanced linting rules and automatic fixes.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"React","language":"Other","updated":"2025-03-26","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-complete-react-eslint-setup.md"},{"slug":"supabase-concise-performance-documentation","title":"Concise performance documentation","description":"When documenting performance metrics, benchmarks, or scalability information, prioritize clarity and conciseness. Avoid redundant wording, use consistent terminology when listing features, and structure information in a scannable format. Clear performance documentation helps developers understand system capabilities, set appropriate expectations, and make...","repository":"supabase/supabase","domain":"data-systems","topic":"Performance Optimization","language":"Other","updated":"2025-03-26","comments":2,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-concise-performance-documentation.md"},{"slug":"kong-verify-downloaded-artifacts","title":"Verify Downloaded Artifacts","description":"Any CI/install workflow that downloads a binary or other external artifact must verify its integrity before use. Apply this standard: - Prefer immutable references (commit SHA/immutable artifact IDs) when your tooling supports it.","repository":"Kong/kong","domain":"cloud-infra","topic":"Security","language":"Txt","updated":"2025-03-26","comments":1,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-verify-downloaded-artifacts.md"},{"slug":"react-router-dependency-version-ranges","title":"dependency version ranges","description":"When configuring dependencies in package.json, use version ranges that maintain backwards compatibility and follow semantic versioning principles. For peer dependencies, prefer ranges that support multiple major versions when possible to avoid forcing consumers to upgrade unnecessarily.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2025-03-25","comments":5,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-dependency-version-ranges.md"},{"slug":"zed-document-configuration-constraints-clearly","title":"Document configuration constraints clearly","description":"When defining configuration options, always clearly document parameter constraints, valid ranges, and behaviors. For numeric values, explicitly state acceptable ranges and how out-of-range values are handled. Configuration options should have appropriate granularity - avoid simple booleans when more nuanced control is beneficial.","repository":"zed-industries/zed","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2025-03-24","comments":5,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-document-configuration-constraints-clearly.md"},{"slug":"polars-organize-tests-efficiently","title":"Organize tests efficiently","description":"Write maintainable, well-structured tests that are easy to understand and extend. Tests should remain simple and focused on their specific validation purpose.","repository":"pola-rs/polars","domain":"data-systems","topic":"Testing","language":"Python","updated":"2025-03-24","comments":4,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-organize-tests-efficiently.md"},{"slug":"tokenizers-prefer-explicit-api-design","title":"Prefer explicit API design","description":"When designing APIs, favor simple and explicit interfaces over flexible but complex ones. This reduces cognitive load, improves compile-time checking, and makes the code more maintainable.","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"API","language":"Rust","updated":"2025-03-24","comments":4,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-prefer-explicit-api-design.md"},{"slug":"vscode-handle-configuration-value-changes","title":"Handle configuration value changes","description":"Configuration values should be properly initialized and stay updated throughout their lifecycle. Follow these guidelines: 1. Initialize configuration values immediately upon service creation, not just in change handlers:","repository":"microsoft/vscode","domain":"devtools","topic":"Configurations","language":"TypeScript","updated":"2025-03-24","comments":4,"stars":174887,"raw":"https://awesomereviewers.com/raw/vscode-handle-configuration-value-changes.md"},{"slug":"neon-cache-performance-preservation","title":"Cache performance preservation","description":"When implementing database failover or restart mechanisms, ensure performance consistency by preserving and prewarming caches. Database performance can significantly degrade after restarts due to cold caches (buffer pools, file system cache, query plan cache), especially for large workloads.","repository":"neondatabase/neon","domain":"data-systems","topic":"Database","language":"Markdown","updated":"2025-03-24","comments":3,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-cache-performance-preservation.md"},{"slug":"opencv-cleanup-before-errors","title":"Cleanup before errors","description":"Always ensure all resources are properly released before raising errors to prevent resource leaks. This practice is essential for maintaining system stability and avoiding memory leaks in both normal and error conditions.","repository":"opencv/opencv","domain":"ml-systems","topic":"Error Handling","language":"Other","updated":"2025-03-24","comments":3,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-cleanup-before-errors.md"},{"slug":"fastapi-optimize-io-with-async","title":"Optimize IO with async","description":"FastAPI's performance advantage comes from its asynchronous foundation built on Starlette and Uvicorn, using `uvloop` which is significantly faster than Python's default asyncio implementation. To maximize application performance, use asynchronous programming patterns for IO-bound operations such as database queries, API requests, and file operations.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Performance Optimization","language":"Markdown","updated":"2025-03-24","comments":2,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-optimize-io-with-async.md"},{"slug":"helix-api-documentation-accuracy","title":"API documentation accuracy","description":"Ensure API documentation accurately describes actual behavior and avoids subjective commentary that may become outdated. Documentation should clearly explain how features interact, what the expected behavior is, and avoid qualitative assessments about performance or quality that can change over time.","repository":"helix-editor/helix","domain":"devtools","topic":"API","language":"Markdown","updated":"2025-03-24","comments":2,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-api-documentation-accuracy.md"},{"slug":"lobe-chat-respect-browser-behavior","title":"Respect browser behavior","description":"Always consider and respect browser native behaviors when implementing web application features. Avoid conflicts with built-in browser shortcuts and choose appropriate client vs server-side approaches based on the execution environment.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Networking","language":"TSX","updated":"2025-03-24","comments":2,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-respect-browser-behavior.md"},{"slug":"neon-document-connection-transitions","title":"Document connection transitions","description":"When implementing systems that involve network connection state changes (such as during failovers, restarts, or component promotions), explicitly document and implement connection handling strategy for all affected components.","repository":"neondatabase/neon","domain":"data-systems","topic":"Networking","language":"Markdown","updated":"2025-03-24","comments":2,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-document-connection-transitions.md"},{"slug":"tensorflow-build-dependency-synchronization","title":"Build dependency synchronization","description":"When adding new imports to code files, always synchronize by updating the corresponding dependencies in BUILD files. Different build environments enforce dependency rules with varying strictness, so proper configuration is essential even if local builds succeed. This helps prevent errors like:","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Configurations","language":"Python","updated":"2025-03-24","comments":2,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-build-dependency-synchronization.md"},{"slug":"langfuse-encrypt-sensitive-credentials","title":"Encrypt sensitive credentials","description":"Sensitive credentials such as API keys, passwords, access tokens, and secret keys should never be stored in plain text in databases or configuration files. This creates significant security risks if the database is compromised or if unauthorized access occurs.","repository":"langfuse/langfuse","domain":"observability","topic":"Security","language":"Sql","updated":"2025-03-24","comments":1,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-encrypt-sensitive-credentials.md"},{"slug":"nest-descriptive-identifier-names","title":"Descriptive identifier names","description":"Choose identifier names (variables, functions, parameters, classes) that clearly describe their purpose, content, or behavior. Replace generic terms like `value`, `data`, or `options` with more specific alternatives that convey meaning.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2025-03-23","comments":7,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-descriptive-identifier-names.md"},{"slug":"neon-scope-jwt-authentication-tokens","title":"Scope JWT authentication tokens","description":"Always include tenant, timeline, and endpoint identifiers in JWT tokens used for service authentication. This ensures proper isolation between tenants and prevents unauthorized access across endpoints or timelines, even within the same tenant hierarchy.","repository":"neondatabase/neon","domain":"data-systems","topic":"Security","language":"Markdown","updated":"2025-03-23","comments":4,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-scope-jwt-authentication-tokens.md"},{"slug":"claude-code-fail-fast-principle","title":"Fail fast principle","description":"When writing security-sensitive shell scripts, use strict error handling to fail immediately on errors rather than attempting fallbacks or continuing silently. Always include `set -euo pipefail` to exit on errors, treat unbound variables as errors, and propagate pipeline failures. This prevents partial application of security configurations that could leave...","repository":"anthropics/claude-code","domain":"ai-agents","topic":"Error Handling","language":"Shell","updated":"2025-03-23","comments":2,"stars":25432,"raw":"https://awesomereviewers.com/raw/claude-code-fail-fast-principle.md"},{"slug":"framework-optimize-migration-code","title":"Optimize migration code","description":"When writing database migration code, prioritize clarity and efficiency to ensure migrations are reliable and maintainable across environments. Apply these practices:","repository":"laravel/framework","domain":"app-frameworks","topic":"Migrations","language":"PHP","updated":"2025-03-22","comments":4,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-optimize-migration-code.md"},{"slug":"brew-standardize-api-integration-patterns","title":"Standardize API integration patterns","description":"Establish consistent patterns for API integrations by following these guidelines: 1. Document API endpoint usage specifically: - Clearly specify which components use each endpoint","repository":"Homebrew/brew","domain":"devtools","topic":"API","language":"Ruby","updated":"2025-03-21","comments":7,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-standardize-api-integration-patterns.md"},{"slug":"duckdb-optimize-hot-path-performance","title":"optimize hot path performance","description":"Avoid expensive operations in frequently executed code paths by implementing performance optimizations such as lookup tables, result caching, conditional initialization, and object reuse.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Performance Optimization","language":"Other","updated":"2025-03-21","comments":4,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-optimize-hot-path-performance.md"},{"slug":"spring-framework-use-environment-independent-defaults","title":"Use environment-independent defaults","description":"When designing configuration options, avoid relying on environment-specific defaults such as system character encodings, file paths, or platform-specific features. Instead, specify explicit defaults that work consistently across all supported environments. This prevents subtle bugs that manifest only in specific environments.","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Configurations","language":"Java","updated":"2025-03-21","comments":4,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-use-environment-independent-defaults.md"},{"slug":"svelte-state-boundary-management","title":"state boundary management","description":"Ensure proper state management when passing reactive values across component and function boundaries. State reactivity can be lost when values are read at the point of return rather than through getters, setters, or object properties.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"React","language":"Markdown","updated":"2025-03-21","comments":4,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-state-boundary-management.md"},{"slug":"fiber-choose-descriptive-property-names","title":"Choose descriptive property names","description":"Property and configuration field names should clearly communicate their purpose, behavior, and relationships to other components. Avoid ambiguous or misleading names that require additional context to understand.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Naming Conventions","language":"Markdown","updated":"2025-03-21","comments":3,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-choose-descriptive-property-names.md"},{"slug":"rails-consistent-terminology-usage","title":"Consistent terminology usage","description":"Always use consistent terminology for the same concept throughout your codebase, documentation, and user interfaces. When multiple terms could describe the same thing, choose one definitive term and use it consistently everywhere.","repository":"rails/rails","domain":"app-frameworks","topic":"Naming Conventions","language":"Other","updated":"2025-03-21","comments":3,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-consistent-terminology-usage.md"},{"slug":"supabase-optimize-large-field-queries","title":"Optimize large field queries","description":"When working with database queries that process large text fields or arrays, choose operations that minimize data conversion and processing overhead. This can lead to dramatic performance improvements.","repository":"supabase/supabase","domain":"data-systems","topic":"Performance Optimization","language":"TypeScript","updated":"2025-03-21","comments":2,"stars":86070,"raw":"https://awesomereviewers.com/raw/supabase-optimize-large-field-queries.md"},{"slug":"vite-separate-configuration-responsibilities","title":"Separate configuration responsibilities","description":"Design configuration files with clear separation of responsibilities and maintain flexibility for future changes. Avoid unnecessarily bundling configurations together when they serve different purposes, as this can create tight coupling and make future transitions difficult.","repository":"vitejs/vite","domain":"devtools","topic":"Configurations","language":"Other","updated":"2025-03-21","comments":2,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-separate-configuration-responsibilities.md"},{"slug":"volcano-use-latest-patch-versions","title":"Use latest patch versions","description":"When configuring dependencies in Dockerfiles and other configuration files, use the latest patch versions while keeping major and minor versions fixed. Patch versions typically contain important security fixes and bug corrections without introducing breaking changes. For example, prefer `golang:1.23.7` over `golang:1.23.0`, as \"small versions will fix some...","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Configurations","language":"Dockerfile","updated":"2025-03-21","comments":2,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-use-latest-patch-versions.md"},{"slug":"cline-validate-svg-security-context","title":"validate SVG security context","description":"SVG files can execute code when loaded, making them a potential security vulnerability. Before using SVGs, evaluate the deployment context and security requirements. Different environments have different restrictions - for example, VS Code marketplace prohibits user-provided SVGs due to security concerns, while webview-hosted SVGs may be acceptable. When...","repository":"cline/cline","domain":"ai-agents","topic":"Security","language":"Other","updated":"2025-03-21","comments":1,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-validate-svg-security-context.md"},{"slug":"netty-simplify-control-flow","title":"Simplify control flow","description":"Streamline code by simplifying control flow structures to improve readability. Eliminate unnecessary nesting and verbosity by applying these guidelines:","repository":"netty/netty","domain":"runtimes","topic":"Code Style","language":"Java","updated":"2025-03-20","comments":7,"stars":34227,"raw":"https://awesomereviewers.com/raw/netty-simplify-control-flow.md"},{"slug":"fastapi-use-pytest-fixtures-effectively","title":"Use pytest fixtures effectively","description":"Tests should use pytest fixtures to improve organization, promote test isolation, and avoid code duplication. Fixtures provide a clean way to set up test dependencies, manage test state, and create reusable test components.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Testing","language":"Python","updated":"2025-03-20","comments":4,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-use-pytest-fixtures-effectively.md"},{"slug":"express-modern-typescript-style","title":"Modern TypeScript style","description":"Use modern TypeScript syntax and conventions throughout the codebase. This includes: - Using `const` instead of `var` for variable declarations unless reassignment is needed","repository":"expressjs/express","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2025-03-20","comments":2,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-modern-typescript-style.md"},{"slug":"react-native-component-initialization-state","title":"Component initialization state","description":"Ensure components properly handle initialization state during their lifecycle, particularly when being recycled or updated. Components should explicitly track whether they have been initialized and force initial value setting when necessary, rather than relying on property comparison alone.","repository":"facebook/react-native","domain":"app-frameworks","topic":"React","language":"Other","updated":"2025-03-20","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-component-initialization-state.md"},{"slug":"vitess-avoid-skipping-e2e-tests","title":"Avoid skipping e2e tests","description":"Do not use the `skip_e2e` flag to bypass end-to-end tests that fail. Instead, fix the test implementation by providing appropriate test data or modifying the test to make it pass correctly. This maintains the integrity of the test suite and ensures that code changes are properly validated.","repository":"vitessio/vitess","domain":"data-systems","topic":"Testing","language":"Json","updated":"2025-03-20","comments":2,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-avoid-skipping-e2e-tests.md"},{"slug":"tensorflow-use-proper-types","title":"Use proper types","description":"Maintain code clarity by using appropriate type declarations and parameter passing conventions: 1. **Prefer explicit types over `auto` when the type is known and simple**:","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Code Style","language":"Other","updated":"2025-03-19","comments":10,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-use-proper-types.md"},{"slug":"spring-boot-documentation-clarity-principles","title":"Documentation clarity principles","description":"When writing technical documentation, adhere to these core principles to ensure clarity and effectiveness: 1. **Use precise technical terminology**: Choose the most accurate terms for technical concepts and be consistent with product names. Remove unnecessary qualifiers when context is clear.","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Documentation","language":"Other","updated":"2025-03-19","comments":6,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-documentation-clarity-principles.md"},{"slug":"material-ui-test-behavior-not-implementation","title":"Test behavior not implementation","description":"Focus tests on user behavior and outcomes rather than implementation details. Structure tests to simulate real user interactions and verify expected results. This creates more robust tests that remain valid even when implementation changes.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Testing","language":"JavaScript","updated":"2025-03-19","comments":4,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-test-behavior-not-implementation.md"},{"slug":"mono-verify-authorization-before-operations","title":"verify authorization before operations","description":"Always verify that users have proper authorization to access and modify resources before performing any data operations. This prevents privilege escalation attacks and unauthorized data access.","repository":"rocicorp/mono","domain":"data-systems","topic":"Security","language":"TypeScript","updated":"2025-03-19","comments":4,"stars":2091,"raw":"https://awesomereviewers.com/raw/mono-verify-authorization-before-operations.md"},{"slug":"openpilot-optimize-data-structure-selection","title":"optimize data structure selection","description":"Choose data structures and algorithms based on their computational complexity and access patterns rather than convenience. Consider performance implications when selecting between alternatives.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Algorithms","language":"Python","updated":"2025-03-19","comments":4,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-optimize-data-structure-selection.md"},{"slug":"clickhouse-avoid-redundant-cache-lookups","title":"avoid redundant cache lookups","description":"When implementing cache functionality, avoid performing the same cache lookup multiple times. Instead, store and reuse the result from the first lookup to improve performance.","repository":"ClickHouse/ClickHouse","domain":"data-systems","topic":"Caching","language":"C++","updated":"2025-03-19","comments":2,"stars":42425,"raw":"https://awesomereviewers.com/raw/clickhouse-avoid-redundant-cache-lookups.md"},{"slug":"helix-omit-redundant-configuration","title":"omit redundant configuration","description":"Remove configuration keys that explicitly set values identical to their defaults. This reduces visual clutter, minimizes maintenance overhead, and prevents confusion about which settings are intentionally customized versus accidentally duplicated.","repository":"helix-editor/helix","domain":"devtools","topic":"Configurations","language":"Toml","updated":"2025-03-19","comments":2,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-omit-redundant-configuration.md"},{"slug":"influxdb-document-versioning-strategies","title":"Document versioning strategies","description":"Establish and clearly document versioning strategies in configuration files, both for your application and its dependencies. For application versioning, include detailed explanations of each component in the version string:","repository":"influxdata/influxdb","domain":"data-systems","topic":"Configurations","language":"Yaml","updated":"2025-03-19","comments":2,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-document-versioning-strategies.md"},{"slug":"ollama-extract-duplicated-code","title":"Extract duplicated code","description":"Identify repeated code segments and extract them into reusable functions or variables. This improves maintainability, reduces the risk of inconsistencies, and makes the code more concise.","repository":"ollama/ollama","domain":"llm-infra","topic":"Code Style","language":"Other","updated":"2025-03-19","comments":2,"stars":145705,"raw":"https://awesomereviewers.com/raw/ollama-extract-duplicated-code.md"},{"slug":"vitess-pin-environment-versions","title":"Pin environment versions","description":"Always use explicit version tags for CI/CD environments (runners, containers, images, tool versions) instead of floating references like 'latest'. This practice prevents unexpected breakages when upstream environments are updated and gives the team control over when to upgrade. When upgrading is necessary, do it in a dedicated PR to properly test the...","repository":"vitessio/vitess","domain":"data-systems","topic":"CI/CD","language":"Yaml","updated":"2025-03-19","comments":2,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-pin-environment-versions.md"},{"slug":"terraform-sanitize-command-inputs","title":"Sanitize command inputs","description":"When constructing commands that will be executed, always sanitize input values to prevent command injection vulnerabilities. Never directly substitute user-supplied or externally-sourced data into command strings without proper validation and sanitization.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Security","language":"Go","updated":"2025-03-19","comments":1,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-sanitize-command-inputs.md"},{"slug":"nuxt-explicit-response-types","title":"explicit response types","description":"Always specify explicit response types when making API calls, especially for prerendered routes or external APIs. In production environments, response headers may not be preserved as expected, leading to incorrect content-type detection that can break applications in unpredictable ways.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2025-03-18","comments":5,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-explicit-response-types.md"},{"slug":"opentelemetry-python-handle-exceptions-appropriately","title":"Handle exceptions appropriately","description":"When implementing error handling logic, be deliberate about which exception types you catch and where you handle them. 1. **Catch `Exception`, not `BaseException`** - Classes that directly inherit from `BaseException` (like `GeneratorExit` or `KeyboardInterrupt`) are not technical errors and should generally propagate:","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Error Handling","language":"Python","updated":"2025-03-18","comments":5,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-handle-exceptions-appropriately.md"},{"slug":"vite-secure-workflow-permissions","title":"Secure workflow permissions","description":"Define explicit and minimal permissions in GitHub Actions workflows to ensure proper operation while maintaining security. Workflows should only have permissions necessary for their intended tasks, and permission checks should occur early in the workflow to prevent unnecessary actions.","repository":"vitejs/vite","domain":"devtools","topic":"CI/CD","language":"Yaml","updated":"2025-03-18","comments":3,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-secure-workflow-permissions.md"},{"slug":"celery-synchronized-async-handoffs","title":"Synchronized Async Handoffs","description":"When delegating work to concurrent/asynchronous execution (tasks, workers, background processes), ensure: 1) **State ordering:** the async code cannot observe missing/partial state. For DB-backed workflows, enqueue/start tasks only after the transaction commits.","repository":"celery/celery","domain":"orchestration","topic":"Concurrency","language":"Other","updated":"2025-03-18","comments":2,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-synchronized-async-handoffs.md"},{"slug":"terraform-explicit-dependency-graph","title":"Explicit dependency graph","description":"When implementing algorithms involving dependencies between components or operations, model the dependency graph explicitly rather than relying on implicit ordering. Explicit graph modeling facilitates cycle detection, enables parallel execution of independent operations, and provides clear visualization of relationships between components.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Algorithms","language":"Go","updated":"2025-03-18","comments":2,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-explicit-dependency-graph.md"},{"slug":"zed-background-process-blocking-operations","title":"Background process blocking operations","description":"Always move potentially blocking operations to background threads to maintain UI responsiveness. Use appropriate spawning mechanisms based on the operation type:","repository":"zed-industries/zed","domain":"devtools","topic":"Concurrency","language":"Rust","updated":"2025-03-17","comments":4,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-background-process-blocking-operations.md"},{"slug":"fiber-maintain-clean-linter-configs","title":"maintain clean linter configs","description":"Ensure linter configuration files are well-maintained by avoiding duplicate entries, using current non-deprecated options, and implementing security-conscious restrictions. Remove any duplicate configuration blocks, replace deprecated linters with their modern equivalents, and configure restrictive policies for dangerous imports that require explicit...","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Configurations","language":"Yaml","updated":"2025-03-17","comments":3,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-maintain-clean-linter-configs.md"},{"slug":"kilocode-enhance-poor-error-messages","title":"enhance poor error messages","description":"When external APIs or dependencies provide cryptic or unhelpful error messages, wrap them with user-friendly, actionable guidance. This is especially important when the external service returns terse responses that don't help users understand what went wrong or how to fix it.","repository":"kilo-org/kilocode","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2025-03-17","comments":2,"stars":7302,"raw":"https://awesomereviewers.com/raw/kilocode-enhance-poor-error-messages.md"},{"slug":"opencv-thread-safe-resource-cleanup","title":"Thread-safe resource cleanup","description":"When implementing resource cleanup in concurrent applications, avoid using deprecated finalizers and instead use PhantomReference-based cleanup mechanisms that ensure thread safety.","repository":"opencv/opencv","domain":"ml-systems","topic":"Concurrency","language":"Java","updated":"2025-03-17","comments":2,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-thread-safe-resource-cleanup.md"},{"slug":"prometheus-make-build-steps-visible","title":"Make build steps visible","description":"Build processes should provide clear, visible feedback about the operations being performed rather than suppressing output or running silently. This transparency helps developers understand what's happening during builds, aids in debugging when issues occur, and builds confidence that expected operations (like code signing) are actually executing.","repository":"prometheus/prometheus","domain":"observability","topic":"CI/CD","language":"Other","updated":"2025-03-17","comments":2,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-make-build-steps-visible.md"},{"slug":"vite-document-protocol-configurations-clearly","title":"Document protocol configurations clearly","description":"When documenting network protocol configurations (TLS, HTTP/2, CORS), provide specific details about required options, default values, and explicit behavior. Avoid ambiguous terminology like \"sufficient values\" and instead specify exactly what options are needed and how different settings interact.","repository":"vitejs/vite","domain":"devtools","topic":"Networking","language":"Markdown","updated":"2025-03-17","comments":2,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-document-protocol-configurations-clearly.md"},{"slug":"framework-design-flexible-apis","title":"Design flexible APIs","description":"When designing APIs, prioritize flexibility and developer experience by: 1. **Accept broader parameter types** - Use `callable` instead of `Closure` to support various invocation patterns:","repository":"laravel/framework","domain":"app-frameworks","topic":"API","language":"PHP","updated":"2025-03-16","comments":5,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-design-flexible-apis.md"},{"slug":"fiber-explicit-cicd-configuration","title":"explicit CI/CD configuration","description":"Always use explicit configuration in CI/CD workflows rather than relying on defaults or convenience shortcuts. This includes pinning exact tool versions, specifying action parameters explicitly, and choosing reliable installation methods.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2025-03-16","comments":3,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-explicit-cicd-configuration.md"},{"slug":"tensorflow-consistent-variable-naming","title":"Consistent variable naming","description":"Use ALL_CAPS for constants and environment variables in shell scripts, and reference these variables consistently throughout the script with proper quoting. This improves code readability and prevents errors when handling paths with spaces.","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Naming Conventions","language":"Shell","updated":"2025-03-15","comments":2,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-consistent-variable-naming.md"},{"slug":"tensorflow-verify-platform-compatibility-first","title":"Verify platform compatibility first","description":"When writing networking code that interacts with platform-specific features, always check for the existence of platform-specific functions or resources before attempting to use them. This prevents runtime errors when your code runs in different environments (Windows, Linux, macOS, containers) that might have different capabilities or implementations.","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Networking","language":"Shell","updated":"2025-03-15","comments":2,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-verify-platform-compatibility-first.md"},{"slug":"influxdb-manage-complete-cache-lifecycle","title":"Manage complete cache lifecycle","description":"Implement comprehensive cache lifecycle management focusing on three key aspects: 1. Idempotent Creation: Make cache creation idempotent by returning success for identical configurations and error only for conflicting ones. This enables reliable automation and prevents redundant cache instances.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Caching","language":"Rust","updated":"2025-03-14","comments":5,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-manage-complete-cache-lifecycle.md"},{"slug":"argo-cd-validate-external-urls","title":"validate external URLs","description":"Always validate and sanitize external URLs before opening them or using them in navigation operations to prevent URL injection attacks. Implement domain allowlists to restrict which external domains are permitted, and avoid directly passing user-controlled or external URL data to functions like window.open() without proper validation.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Security","language":"TSX","updated":"2025-03-14","comments":1,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-validate-external-urls.md"},{"slug":"react-router-avoid-timing-dependent-tests","title":"avoid timing-dependent tests","description":"Tests should not rely on fixed delays, arbitrary timeouts, or assume deterministic ordering of asynchronous operations. Instead, use proper waiting mechanisms and sort results when order doesn't matter.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Testing","language":"TypeScript","updated":"2025-03-13","comments":2,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-avoid-timing-dependent-tests.md"},{"slug":"spring-boot-maintain-consistent-naming-patterns","title":"Maintain consistent naming patterns","description":"Follow established naming patterns and conventions throughout the codebase to ensure consistency and clarity. This includes: 1. Use existing naming patterns for similar concepts:","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Naming Conventions","language":"Java","updated":"2025-03-12","comments":7,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-maintain-consistent-naming-patterns.md"},{"slug":"ollama-optimize-with-standard-library","title":"Optimize with standard library","description":"When implementing algorithms, prefer using Go's standard library over custom implementations or external dependencies for common operations. The standard library offers well-tested, efficient implementations for many algorithmic needs.","repository":"ollama/ollama","domain":"llm-infra","topic":"Algorithms","language":"Go","updated":"2025-03-12","comments":6,"stars":145704,"raw":"https://awesomereviewers.com/raw/ollama-optimize-with-standard-library.md"},{"slug":"tokio-flexible-consistent-api-patterns","title":"Flexible consistent API patterns","description":"Design APIs with flexibility and consistency by leveraging established patterns and avoiding unnecessary constraints. Accept generic type bounds instead of concrete types to provide more flexibility to users and simplify usage.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"API","language":"Rust","updated":"2025-03-12","comments":6,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-flexible-consistent-api-patterns.md"},{"slug":"helix-follow-established-conventions","title":"Follow established conventions","description":"Configuration settings should align with official language documentation and established community standards rather than arbitrary personal preferences. This applies to indentation styles, formatter configurations, and syntax requirements.","repository":"helix-editor/helix","domain":"devtools","topic":"Code Style","language":"Toml","updated":"2025-03-12","comments":5,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-follow-established-conventions.md"},{"slug":"ui-react-rendering-safeguards","title":"React rendering safeguards","description":"This standard ensures your React components render correctly and efficiently, preventing common pitfalls that cause errors or performance issues. ### Proper key usage","repository":"shadcn-ui/ui","domain":"app-frameworks","topic":"React","language":"TSX","updated":"2025-03-12","comments":4,"stars":90568,"raw":"https://awesomereviewers.com/raw/ui-react-rendering-safeguards.md"},{"slug":"ghostty-centralize-configuration-values","title":"Centralize configuration values","description":"Hardcoded configuration values scattered throughout codebases create maintenance burdens and increase the risk of inconsistency. Define configuration values (like versions, paths, and feature flags) in a single location and reference them elsewhere.","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Configurations","language":"Yaml","updated":"2025-03-12","comments":3,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-centralize-configuration-values.md"},{"slug":"markitdown-improve-documentation-discoverability","title":"Improve documentation discoverability","description":"Ensure that important information about code purpose, behavior, and context is easily discoverable through proper documentation placement and completeness. Add comprehensive docstrings to modules, classes, and functions that explain their purpose and usage. Place critical implementation details in docstrings rather than inline comments to improve...","repository":"microsoft/markitdown","domain":"llm-infra","topic":"Documentation","language":"Python","updated":"2025-03-12","comments":3,"stars":76602,"raw":"https://awesomereviewers.com/raw/markitdown-improve-documentation-discoverability.md"},{"slug":"prisma-api-abstraction-levels","title":"API abstraction levels","description":"Functions and utilities should operate at appropriate abstraction levels without being aware of higher-level concepts or implementation details. This prevents tight coupling and improves reusability and testability.","repository":"prisma/prisma","domain":"data-systems","topic":"API","language":"TypeScript","updated":"2025-03-12","comments":3,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-api-abstraction-levels.md"},{"slug":"deno-avoid-redundant-observability-data","title":"avoid redundant observability data","description":"When implementing observability features like tracing and monitoring, avoid exposing redundant information that can be inferred from existing data, and use appropriate abstraction levels rather than exposing internal implementation details through public APIs.","repository":"denoland/deno","domain":"runtimes","topic":"Observability","language":"TypeScript","updated":"2025-03-12","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-avoid-redundant-observability-data.md"},{"slug":"deno-manage-async-operation-lifecycle","title":"Manage async operation lifecycle","description":"When working with async operations, carefully manage execution context and resource references across await boundaries to prevent context corruption and resource leaks.","repository":"denoland/deno","domain":"runtimes","topic":"Concurrency","language":"TypeScript","updated":"2025-03-12","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-manage-async-operation-lifecycle.md"},{"slug":"deno-null-checks-before-operations","title":"null checks before operations","description":"Always check for null or undefined values before performing operations on objects, accessing properties, or calling methods. This prevents runtime errors that occur when attempting to operate on null/undefined values.","repository":"denoland/deno","domain":"runtimes","topic":"Null Handling","language":"TypeScript","updated":"2025-03-12","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-null-checks-before-operations.md"},{"slug":"ghostty-generate-dynamic-configurations","title":"Generate dynamic configurations","description":"Always generate configuration files programmatically when they contain dynamic content that changes frequently or needs to stay in sync with the application (like version numbers, release dates, or build timestamps). Manual maintenance of such files is tedious, error-prone, and creates maintenance overhead.","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Configurations","language":"Xml","updated":"2025-03-12","comments":2,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-generate-dynamic-configurations.md"},{"slug":"claude-code-least-privilege-networking","title":"Least privilege networking","description":"Restrict network access to only what's necessary for your application to function, using explicit allowlisting rather than trying to block malicious traffic. Network traffic should be denied by default and only specifically required destinations should be allowed.","repository":"anthropics/claude-code","domain":"ai-agents","topic":"Security","language":"Shell","updated":"2025-03-12","comments":1,"stars":25432,"raw":"https://awesomereviewers.com/raw/claude-code-least-privilege-networking.md"},{"slug":"workers-sdk-configuration-file-consistency","title":"Configuration file consistency","description":"Ensure consistent patterns for configuration files, proper exclusion of development artifacts, and clear environment-specific handling across projects.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Configurations","language":"Markdown","updated":"2025-03-11","comments":5,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-configuration-file-consistency.md"},{"slug":"prowler-parameterize-security-commands","title":"Parameterize security commands","description":"When writing security-related CLI commands or remediation steps, always use standardized parameter placeholders (e.g., `<REGION>`, `<RESOURCE_NAME>`) instead of hardcoded values. This practice ensures commands are adaptable across different environments, prevents implementation errors, and makes security remediation steps more reliable. Properly...","repository":"prowler-cloud/prowler","domain":"security","topic":"Security","language":"Json","updated":"2025-03-11","comments":4,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-parameterize-security-commands.md"},{"slug":"polars-favor-clarity-over-brevity","title":"Favor clarity over brevity","description":"Always prioritize code readability and maintainability over concise but cryptic implementations. Extract repeated logic into well-named helper functions, use keyword-only arguments for clearer APIs, and structure complex string operations for better readability.","repository":"pola-rs/polars","domain":"data-systems","topic":"Code Style","language":"Python","updated":"2025-03-11","comments":3,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-favor-clarity-over-brevity.md"},{"slug":"pr-agent-validate-llm-config","title":"Validate LLM Config","description":"Ensure any LLM configuration is provider/model compatible by (1) validating cross-parameter constraints (especially token budget vs max output) and (2) applying only parameters supported by that specific provider/model (e.g., don’t set `temperature` for configs that don’t allow it). This prevents runtime BadRequest errors and reduces wasted latency/cost.","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"AI","language":"Markdown","updated":"2025-03-11","comments":2,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-validate-llm-config.md"},{"slug":"prowler-enable-database-resilience","title":"Enable database resilience","description":"Always configure appropriate resilience features for database services to ensure data durability and high availability. This includes: 1. **Enable regular backups with sufficient retention periods** for all database clusters to prevent data loss","repository":"prowler-cloud/prowler","domain":"security","topic":"Database","language":"Json","updated":"2025-03-11","comments":2,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-enable-database-resilience.md"},{"slug":"prowler-log-exceptions-with-context","title":"Log exceptions with context","description":"When handling exceptions in your code, ensure they are properly logged with sufficient context to aid debugging. For critical exceptions, use Sentry to track them alongside regular logging. For handled exceptions, include both the object being processed and the exception details in your log message.","repository":"prowler-cloud/prowler","domain":"security","topic":"Logging","language":"Python","updated":"2025-03-11","comments":2,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-log-exceptions-with-context.md"},{"slug":"kotlin-effective-api-samples","title":"Effective API samples","description":"Create clear, comprehensive, and properly structured code samples to\\ \\ document API usage. Follow these principles:\\n\\n1. **Organize samples properly:**\\n\\ \\   - Place samples after doc blocks","repository":"JetBrains/kotlin","domain":"runtimes","topic":"Documentation","language":"Kotlin","updated":"2025-03-10","comments":8,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-effective-api-samples.md"},{"slug":"kotlin-test-edge-cases","title":"Test edge cases","description":"Ensure tests verify both basic functionality and edge cases. Tests that only cover the happy path can miss critical bugs in boundary conditions and special scenarios.","repository":"JetBrains/kotlin","domain":"runtimes","topic":"Testing","language":"Kotlin","updated":"2025-03-10","comments":7,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-test-edge-cases.md"},{"slug":"ollama-ai-memory-management","title":"AI memory management","description":"Document and implement proper memory management strategies for AI model inference to prevent out-of-memory errors and optimize performance. When developing AI applications or documentation:","repository":"ollama/ollama","domain":"llm-infra","topic":"AI","language":"Markdown","updated":"2025-03-10","comments":3,"stars":145705,"raw":"https://awesomereviewers.com/raw/ollama-ai-memory-management.md"},{"slug":"poetry-pin-configuration-versions","title":"Pin configuration versions","description":"Always pin specific versions for base images, dependencies, and environment configurations to ensure reproducible builds and prevent unexpected failures from upstream changes.","repository":"python-poetry/poetry","domain":"devtools","topic":"Configurations","language":"Dockerfile","updated":"2025-03-10","comments":3,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-pin-configuration-versions.md"},{"slug":"argo-cd-simplify-nested-conditionals","title":"simplify nested conditionals","description":"Combine multiple nested if statements using logical operators (and/or) to improve code readability and reduce unnecessary indentation. Remove redundant nil checks when they are unnecessary, especially when subsequent checks would naturally handle the nil case.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Code Style","language":"Other","updated":"2025-03-10","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-simplify-nested-conditionals.md"},{"slug":"ollama-ai-dependency-decoupling-strategy","title":"AI dependency decoupling strategy","description":"Implement clear boundaries between your core AI system and external machine learning libraries through abstraction layers. This facilitates future library updates or replacements as AI technology evolves. When integrating external libraries (like llama.cpp), establish documented synchronization processes and gradually work toward independence, especially...","repository":"ollama/ollama","domain":"llm-infra","topic":"AI","language":"C++","updated":"2025-03-10","comments":2,"stars":145705,"raw":"https://awesomereviewers.com/raw/ollama-ai-dependency-decoupling-strategy.md"},{"slug":"spring-boot-structured-log-message-quality","title":"Structured log message quality","description":"Design log messages to be clear, concise, and properly structured to maximize their utility for debugging and monitoring. When using structured logging, configure reasonable limits for data complexity to prevent resource exhaustion and ensure logs remain usable.","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Logging","language":"Java","updated":"2025-03-10","comments":2,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-structured-log-message-quality.md"},{"slug":"express-maintain-api-types","title":"Maintain API types","description":"Ensure API type definitions accurately reflect current implementations. When maintaining TypeScript definitions for APIs, regularly audit them against the actual source code to prevent developers from using non-existent or deprecated features.","repository":"expressjs/express","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2025-03-09","comments":2,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-maintain-api-types.md"},{"slug":"ghostty-document-configs-comprehensively","title":"Document configs comprehensively","description":"Configuration options must be documented comprehensively with: 1. Clear, descriptive name using appropriate platform prefixes (e.g., ''gtk-'' for GTK-specific options)","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Configurations","language":"Other","updated":"2025-03-08","comments":6,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-document-configs-comprehensively.md"},{"slug":"opentelemetry-python-precise-configuration-specifications","title":"Precise configuration specifications","description":"Ensure configuration files use tool-specific syntax and conventions while leveraging appropriate defaults. Be intentional about version constraints and conditionals in dependency specifications.","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Configurations","language":"Toml","updated":"2025-03-08","comments":4,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-precise-configuration-specifications.md"},{"slug":"router-maintain-backward-compatibility","title":"Maintain backward compatibility","description":"When evolving APIs, always maintain backward compatibility to avoid breaking existing user code. Support both old and new syntax during transition periods, and use deprecation warnings to guide users toward new patterns.","repository":"TanStack/router","domain":"app-frameworks","topic":"API","language":"TSX","updated":"2025-03-08","comments":4,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-maintain-backward-compatibility.md"},{"slug":"router-environment-aware-configuration-management","title":"Environment-aware configuration management","description":"Ensure configuration management accounts for different environments and maintains backward compatibility during migrations. This includes using safe access patterns for global objects, versioning configuration keys, and preserving environment-specific behavior.","repository":"TanStack/router","domain":"app-frameworks","topic":"Configurations","language":"TSX","updated":"2025-03-08","comments":3,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-environment-aware-configuration-management.md"},{"slug":"cline-document-configuration-assumptions","title":"Document configuration assumptions","description":"When documenting configuration settings, environment setup, or system requirements, explicitly state assumptions about the target environment and provide accurate default values. Avoid making implicit assumptions that may not apply to all users or deployment scenarios.","repository":"cline/cline","domain":"ai-agents","topic":"Configurations","language":"Markdown","updated":"2025-03-08","comments":2,"stars":48299,"raw":"https://awesomereviewers.com/raw/cline-document-configuration-assumptions.md"},{"slug":"opentofu-separate-configuration-lifecycles","title":"Separate configuration lifecycles","description":"Maintain clear separation between different stages of configuration processing by creating dedicated structures for each phase of the configuration lifecycle. Divide configuration handling into distinct phases:","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Configurations","language":"Go","updated":"2025-03-07","comments":8,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-separate-configuration-lifecycles.md"},{"slug":"nuxt-explicit-api-design","title":"explicit API design","description":"Design APIs with explicit parameters, consistent return types, and clear interfaces to improve usability and maintainability. Avoid boolean flags in favor of option objects, ensure consistent return types across all code paths, and use proper TypeScript overloads for type safety.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2025-03-07","comments":6,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-explicit-api-design.md"},{"slug":"ui-meaningful-consistent-identifiers","title":"Meaningful consistent identifiers","description":"Choose descriptive, semantically accurate names for variables, types, and components that clearly communicate their purpose. Maintain consistency throughout your codebase by:","repository":"shadcn-ui/ui","domain":"app-frameworks","topic":"Naming Conventions","language":"TSX","updated":"2025-03-07","comments":5,"stars":90568,"raw":"https://awesomereviewers.com/raw/ui-meaningful-consistent-identifiers.md"},{"slug":"ncnn-intentional-test-coverage","title":"Intentional Test Coverage","description":"All unit tests should be (1) intentionally designed for coverage, (2) non-redundant, and (3) maintainable. Apply these rules: 1) Enforce correctness with invariants","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Testing","language":"C++","updated":"2025-03-07","comments":4,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-intentional-test-coverage.md"},{"slug":"opentelemetry-python-maintain-consistent-naming","title":"Maintain consistent naming","description":"Ensure naming conventions are consistent across your codebase and related repositories. When naming commands, functions, variables, or attributes: 1. Check existing conventions in the current and related codebases","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Naming Conventions","language":"Markdown","updated":"2025-03-07","comments":3,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-maintain-consistent-naming.md"},{"slug":"bun-use-branch-prediction","title":"Use branch prediction","description":"Optimize performance-critical algorithms by using branch prediction hints to guide the CPU. Add `UNLIKELY` macros for error conditions, boundary checks, or exceptional cases that rarely evaluate to true, and `LIKELY` for common execution paths. This helps the CPU's branch predictor make better decisions, reducing pipeline stalls and improving execution...","repository":"oven-sh/bun","domain":"runtimes","topic":"Algorithms","language":"C++","updated":"2025-03-07","comments":2,"stars":79093,"raw":"https://awesomereviewers.com/raw/bun-use-branch-prediction.md"},{"slug":"brew-simplify-complex-code-blocks","title":"Simplify complex code blocks","description":"Break down complex code blocks and expressions into simpler, more readable components. Complex boolean logic, nested conditions, and multi-operation lines should be refactored for clarity.","repository":"Homebrew/brew","domain":"devtools","topic":"Code Style","language":"Ruby","updated":"2025-03-06","comments":5,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-simplify-complex-code-blocks.md"},{"slug":"nuxt-cache-lifecycle-management","title":"Cache lifecycle management","description":"Implement comprehensive cache lifecycle management that includes proper key management, invalidation strategies, and cleanup mechanisms. Cache implementations should handle the full lifecycle from creation to cleanup to prevent memory leaks, stale data, and unbounded growth.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Caching","language":"TypeScript","updated":"2025-03-06","comments":4,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-cache-lifecycle-management.md"},{"slug":"union-api-interface-design","title":"API interface design","description":"Design APIs with clean abstractions, logical data organization, and proper layer separation. Structure interfaces to group related data hierarchically and provide convenient helper functions instead of requiring manual object construction.","repository":"unionlabs/union","domain":"cloud-infra","topic":"API","language":"Other","updated":"2025-03-06","comments":4,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-api-interface-design.md"},{"slug":"quarkus-document-deployment-strategy-constraints","title":"Document deployment strategy constraints","description":"Always document and enforce appropriate deployment strategies for different application types in your CI/CD pipeline configuration. Different deployment strategies have specific constraints that must be considered for successful application delivery.","repository":"quarkusio/quarkus","domain":"app-frameworks","topic":"CI/CD","language":"Other","updated":"2025-03-06","comments":3,"stars":14667,"raw":"https://awesomereviewers.com/raw/quarkus-document-deployment-strategy-constraints.md"},{"slug":"markitdown-validate-before-processing","title":"validate before processing","description":"Always validate input state and types before performing operations to prevent runtime errors and unexpected behavior. This includes checking data types before applying type-specific operations and preserving object state when performing validation checks.","repository":"microsoft/markitdown","domain":"llm-infra","topic":"Null Handling","language":"Python","updated":"2025-03-06","comments":2,"stars":76602,"raw":"https://awesomereviewers.com/raw/markitdown-validate-before-processing.md"},{"slug":"vite-vue-component-import-handling","title":"Vue component import handling","description":"When working with Vue single-file components, pay special attention to how imports are processed, particularly with query parameters. URL handling can significantly impact module resolution and hot module replacement (HMR).","repository":"vitejs/vite","domain":"devtools","topic":"Vue","language":"TypeScript","updated":"2025-03-06","comments":2,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-vue-component-import-handling.md"},{"slug":"fastapi-document-all-responses","title":"Document all responses","description":"When designing APIs, thoroughly document all possible responses your endpoints can return, not just the \"happy path\" success cases. Include documentation for:","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2025-03-05","comments":8,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-document-all-responses.md"},{"slug":"v-function-documentation-standards","title":"function documentation standards","description":"All public functions and methods must be documented with comments that `v doc` can understand. Documentation should start with the function name and clearly explain the function''s behavior and purpose. For static methods, explicitly identify them as such (e.g., \"MethodName static method returns...\").","repository":"vlang/v","domain":"runtimes","topic":"Documentation","language":"Other","updated":"2025-03-05","comments":7,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-function-documentation-standards.md"},{"slug":"query-explicit-undefined-defaults","title":"Explicit Undefined Defaults","description":"Prevent `undefined`/`void`/falsy values from becoming accidental runtime states. Apply these rules: 1. **Eliminate transient `undefined`**: If a value can be absent (e.g., localStorage, optional query data), wire an explicit `defaultValue` so hooks/state initialize to a concrete value and consumers never render an “undefined first frame”.","repository":"tanstack/query","domain":"app-frameworks","topic":"Null Handling","language":"TSX","updated":"2025-03-05","comments":5,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-explicit-undefined-defaults.md"},{"slug":"svelte-avoid-expensive-operations","title":"avoid expensive operations","description":"Identify and eliminate computationally expensive operations through early termination, better data structures, and algorithmic optimizations. Look for opportunities to short-circuit loops, cache results, and choose more efficient algorithms.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Algorithms","language":"JavaScript","updated":"2025-03-05","comments":5,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-avoid-expensive-operations.md"},{"slug":"markitdown-explicit-api-parameters","title":"explicit API parameters","description":"Make API parameters explicit and named rather than hiding them in **kwargs. This improves clarity, enables better validation, and provides clearer interfaces for callers.","repository":"microsoft/markitdown","domain":"llm-infra","topic":"API","language":"Python","updated":"2025-03-05","comments":4,"stars":76602,"raw":"https://awesomereviewers.com/raw/markitdown-explicit-api-parameters.md"},{"slug":"spring-framework-consistent-style-conventions","title":"Consistent style conventions","description":"Apply consistent formatting and organization conventions throughout the codebase to enhance readability and maintainability: 1. Follow the project''s `.editorconfig` settings for indentation style (tabs vs spaces) and other formatting rules.","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Code Style","language":"Other","updated":"2025-03-05","comments":4,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-consistent-style-conventions.md"},{"slug":"polars-database-api-abstraction","title":"Database API abstraction","description":"When designing database interaction layers, carefully consider when to create wrapper methods versus allowing direct use of underlying libraries. Add abstraction only when it provides significant value through error handling, feature consolidation, or version compatibility management.","repository":"pola-rs/polars","domain":"data-systems","topic":"Database","language":"Python","updated":"2025-03-05","comments":3,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-database-api-abstraction.md"},{"slug":"yoga-optimize-build-configurations","title":"Optimize build configurations","description":"When configuring CMake builds, carefully select compiler and linker flags that optimize for performance while maintaining cross-platform compatibility. Performance-oriented flags can significantly impact runtime speed, binary size, and resource utilization, but must be applied conditionally based on the target platform and compiler.","repository":"facebook/yoga","domain":"runtimes","topic":"Performance Optimization","language":"Txt","updated":"2025-03-05","comments":3,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-optimize-build-configurations.md"},{"slug":"ollama-complete-http-protocol-handling","title":"Complete HTTP protocol handling","description":"When implementing HTTP client functionality, ensure comprehensive support for all standard HTTP status codes and secure connection scenarios: 1. Support all standard redirect status codes (301, 302, 303, 307, 308), not just a subset:","repository":"ollama/ollama","domain":"llm-infra","topic":"Networking","language":"Go","updated":"2025-03-05","comments":2,"stars":145705,"raw":"https://awesomereviewers.com/raw/ollama-complete-http-protocol-handling.md"},{"slug":"spring-boot-environment-variables-best-practices","title":"Environment variables best practices","description":"When working with environment variables in configuration files, follow these practices to ensure reliability and testability: 1. Use placeholder syntax `${ENV_VAR}` to reference environment variables in both properties and YAML configuration files","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2025-03-05","comments":2,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-environment-variables-best-practices.md"},{"slug":"turborepo-hybrid-monorepo-testing","title":"Hybrid monorepo testing","description":"When working with tests in a monorepo, implement a hybrid testing approach that balances local development experience with CI performance. Set up local Vitest configurations in each package while also configuring a root workspace for unified testing. This preserves Turborepo's caching benefits in CI while providing a better developer experience.","repository":"vercel/turborepo","domain":"devtools","topic":"Testing","language":"Other","updated":"2025-03-05","comments":2,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-hybrid-monorepo-testing.md"},{"slug":"kafka-avoid-password-conversions","title":"avoid password conversions","description":"When handling sensitive data like passwords, avoid unnecessary type conversions that create additional copies in memory. Pass char[] arrays directly to methods that accept them instead of converting to String and back to char[]. This minimizes the number of sensitive data copies in memory and reduces the attack surface.","repository":"apache/kafka","domain":"data-systems","topic":"Security","language":"Java","updated":"2025-03-05","comments":1,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-avoid-password-conversions.md"},{"slug":"azure-quickstart-templates-source-only-template-inputs","title":"Source-only Template Inputs","description":"Default to a single source-of-truth for infrastructure-as-code and ensure CI/CD owns generated deployment artifacts. This reduces drift and keeps pipeline behavior predictable.","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"CI/CD","language":"Json","updated":"2025-03-04","comments":5,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-source-only-template-inputs.md"},{"slug":"polars-explicit-configuration-precedence","title":"Explicit configuration precedence","description":"Implement a clear configuration resolution chain that follows a consistent precedence pattern: explicit parameters first, then environment variables, then default values. This ensures predictable behavior and proper respect for user-provided settings at different levels.","repository":"pola-rs/polars","domain":"data-systems","topic":"Configurations","language":"Python","updated":"2025-03-04","comments":5,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-explicit-configuration-precedence.md"},{"slug":"router-use-parameterized-testing","title":"Use parameterized testing","description":"When testing multiple scenarios with similar logic, use your testing framework's built-in parameterized testing features (`test.each`, `describe.each`, `it.each`) instead of manual `forEach` loops or duplicated test functions. This approach reduces code duplication, improves readability, and makes it easier to add new test cases.","repository":"TanStack/router","domain":"app-frameworks","topic":"Testing","language":"TypeScript","updated":"2025-03-04","comments":5,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-use-parameterized-testing.md"},{"slug":"vite-minimize-memory-allocations","title":"Minimize memory allocations","description":"Choose methods and patterns that reduce unnecessary memory allocations and object creation to improve performance. When working with buffers, prefer direct methods like `Buffer.byteLength()` over approaches that create intermediate objects:","repository":"vitejs/vite","domain":"devtools","topic":"Performance Optimization","language":"TypeScript","updated":"2025-03-04","comments":4,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-minimize-memory-allocations.md"},{"slug":"fastapi-clear-informative-errors","title":"Clear informative errors","description":"Error messages should be clear, specific, and provide enough context to understand the issue without exposing unnecessary implementation details. When handling errors:","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Error Handling","language":"Python","updated":"2025-03-04","comments":2,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-clear-informative-errors.md"},{"slug":"semgrep-avoid-failwith-patterns","title":"avoid failwith patterns","description":"Avoid using `failwith`, `assert false`, and similar blunt error handling mechanisms that can turn recoverable errors into unrecoverable ones. Instead, prefer more robust approaches:","repository":"semgrep/semgrep","domain":"security","topic":"Error Handling","language":"Other","updated":"2025-03-03","comments":9,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-avoid-failwith-patterns.md"},{"slug":"polars-evaluate-algorithmic-complexity-tradeoffs","title":"Evaluate algorithmic complexity tradeoffs","description":"When implementing algorithms, carefully evaluate tradeoffs between performance optimizations and code maintainability. Consider: 1. Early vs Late Optimization:","repository":"pola-rs/polars","domain":"data-systems","topic":"Algorithms","language":"Rust","updated":"2025-03-03","comments":5,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-evaluate-algorithmic-complexity-tradeoffs.md"},{"slug":"pydantic-document-configuration-relationships","title":"Document configuration relationships","description":"When designing configuration options that interact with each other, clearly document these relationships and consider implementing safeguards against invalid combinations. This is especially important for boolean flags controlling related behaviors.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Configurations","language":"Python","updated":"2025-03-03","comments":4,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-document-configuration-relationships.md"},{"slug":"turborepo-keep-build-tooling-updated","title":"Keep build tooling updated","description":"Maintain up-to-date build and CI/CD tooling to leverage the latest features, performance improvements, and security patches. Regularly check for updates to build orchestration tools like Turborepo and use provided codemods for seamless upgrades. When configuring build pipelines, optimize task dependencies by using topological approaches (like Turborepo's...","repository":"vercel/turborepo","domain":"devtools","topic":"CI/CD","language":"Json","updated":"2025-03-03","comments":4,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-keep-build-tooling-updated.md"},{"slug":"dspy-synchronize-configuration-environments","title":"synchronize configuration environments","description":"Ensure configuration values remain consistent between local development and CI/CD environments, and document the rationale behind environment-specific settings. Version mismatches and undocumented configuration behavior can lead to unexpected failures and developer confusion.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Configurations","language":"Yaml","updated":"2025-03-03","comments":2,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-synchronize-configuration-environments.md"},{"slug":"lobe-chat-provide-contextual-guidance","title":"Provide contextual guidance","description":"Documentation should provide clear contextual information that helps users understand when they need to take specific actions versus when configurations are automatically handled. Include deployment-specific details and maintain consistent cross-referencing syntax throughout.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Documentation","language":"Other","updated":"2025-03-03","comments":2,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-provide-contextual-guidance.md"},{"slug":"mermaid-semantics-preserving-formatting","title":"Semantics-Preserving Formatting","description":"Code-style changes (formatting, spacing, selector tweaks, spell/lint adjustments) must not alter semantics or intended content. - CSS: scope styling to the minimal element needed (avoid global or overly broad selectors). Prefer targeted selectors like:","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Code Style","language":"Html","updated":"2025-03-03","comments":2,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-semantics-preserving-formatting.md"},{"slug":"ollama-model-precision-matters","title":"Model precision matters","description":"When deploying AI models on specialized hardware accelerators (GPUs, NPUs), ensure you're using compatible model precision formats. Different hardware platforms have different optimal precision requirements that significantly impact performance and compatibility.","repository":"ollama/ollama","domain":"llm-infra","topic":"AI","language":"Shell","updated":"2025-03-03","comments":2,"stars":145705,"raw":"https://awesomereviewers.com/raw/ollama-model-precision-matters.md"},{"slug":"query-meaningful-identifier-naming","title":"Meaningful Identifier Naming","description":"Use names that clearly reflect the thing being identified, and ensure renamed identifiers don’t accidentally couple to old data or misleading conventions.","repository":"tanstack/query","domain":"app-frameworks","topic":"Naming Conventions","language":"TSX","updated":"2025-03-03","comments":2,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-meaningful-identifier-naming.md"},{"slug":"union-avoid-unnecessary-memory-operations","title":"avoid unnecessary memory operations","description":"Be mindful of memory usage when working with large data structures. Avoid unnecessary clones of large objects, remove unused large fields from data structures, and prefer references when possible. Large data structures can significantly impact both memory usage and execution speed.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Performance Optimization","language":"Rust","updated":"2025-03-03","comments":2,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-avoid-unnecessary-memory-operations.md"},{"slug":"volcano-avoid-unnecessary-privilege-tools","title":"avoid unnecessary privilege tools","description":"Do not install privilege escalation tools like sudo, su, or doas in containers unless they are explicitly required for the application's functionality. Most containers run as root by default, making sudo redundant and potentially creating security vulnerabilities by expanding the attack surface.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Security","language":"Dockerfile","updated":"2025-03-03","comments":1,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-avoid-unnecessary-privilege-tools.md"},{"slug":"rails-test-helpers-for-maintainability","title":"Test helpers for maintainability","description":"Create reusable helper methods for common testing operations to improve test maintainability and consistency. Design these helpers to be appropriate for their specific test context (integration vs system tests) and resilient to implementation changes.","repository":"rails/rails","domain":"app-frameworks","topic":"Testing","language":"Other","updated":"2025-03-02","comments":2,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-test-helpers-for-maintainability.md"},{"slug":"duckdb-ensure-comprehensive-test-coverage","title":"ensure comprehensive test coverage","description":"Tests should validate all relevant code paths and actually exercise the functionality they claim to test. When adding tests for new features, ensure they stress the new behavior rather than just existing functionality that was already covered.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Testing","language":"Python","updated":"2025-03-01","comments":2,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-ensure-comprehensive-test-coverage.md"},{"slug":"inbox-zero-secure-dependency-management","title":"Secure dependency management","description":"Always maintain secure dependencies by following these two critical security practices: 1. **Keep dependencies updated with the latest security patches** - Regularly check for and apply updates that contain security fixes. Pin to specific versions but review them frequently.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Security","language":"Json","updated":"2025-03-01","comments":1,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-secure-dependency-management.md"},{"slug":"influxdb-promote-code-clarity","title":"Promote code clarity","description":"Write code that prioritizes clarity and maintainability over brevity. This involves several key practices: 1. **Extract repeated code blocks into helper functions**","repository":"influxdata/influxdb","domain":"data-systems","topic":"Code Style","language":"Rust","updated":"2025-02-28","comments":8,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-promote-code-clarity.md"},{"slug":"vitess-prevent-concurrent-access-races","title":"Prevent concurrent access races","description":"When sharing data across goroutines, always use proper synchronization mechanisms to prevent race conditions. Race conditions are difficult to debug and can cause intermittent failures that only appear under load.","repository":"vitessio/vitess","domain":"data-systems","topic":"Concurrency","language":"Go","updated":"2025-02-28","comments":8,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-prevent-concurrent-access-races.md"},{"slug":"fastapi-technical-term-consistency","title":"Technical term consistency","description":"When working with multilingual codebases or documentation, maintain consistent naming conventions for technical terms across all languages. Consider the following practices:","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Naming Conventions","language":"Markdown","updated":"2025-02-28","comments":7,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-technical-term-consistency.md"},{"slug":"opentelemetry-python-optimize-configuration-structure","title":"Optimize configuration structure","description":"Structure configuration files like tox.ini to maximize maintainability and efficiency. Use factor prefixes (e.g., \"test-opentelemetry:\", \"lint:\") to install packages only for specific environments, avoiding unnecessary dependencies. When naming environments, avoid characters that have special meaning in the tool (e.g., use \"precommit\" instead of...","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Configurations","language":"Other","updated":"2025-02-28","comments":5,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-optimize-configuration-structure.md"},{"slug":"workers-sdk-ensure-test-isolation","title":"ensure test isolation","description":"Tests must be isolated and not leak state between runs. This includes properly cleaning up mocks, spies, and any global state modifications to ensure reliable and maintainable test suites.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Testing","language":"TypeScript","updated":"2025-02-28","comments":4,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-ensure-test-isolation.md"},{"slug":"ollama-path-traversal-prevention","title":"Path traversal prevention","description":"Implement multiple validation layers to prevent path traversal attacks. File paths provided by users or external systems must be validated before use in filesystem operations:","repository":"ollama/ollama","domain":"llm-infra","topic":"Security","language":"Go","updated":"2025-02-28","comments":2,"stars":145705,"raw":"https://awesomereviewers.com/raw/ollama-path-traversal-prevention.md"},{"slug":"vitess-clear-metric-documentation","title":"Clear metric documentation","description":"When adding, modifying, or deprecating metrics, ensure comprehensive and clear documentation. Include: 1. Descriptive names for new metrics that reflect their purpose","repository":"vitessio/vitess","domain":"data-systems","topic":"Observability","language":"Markdown","updated":"2025-02-28","comments":2,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-clear-metric-documentation.md"},{"slug":"claude-code-avoid-privileged-installations","title":"Avoid privileged installations","description":"Always recommend user-level package installations rather than using administrative/root privileges. Installing packages with elevated permissions can compromise system security and stability. Documentation and scripts should explicitly guide users toward safer installation practices.","repository":"anthropics/claude-code","domain":"ai-agents","topic":"Security","language":"Markdown","updated":"2025-02-28","comments":1,"stars":25432,"raw":"https://awesomereviewers.com/raw/claude-code-avoid-privileged-installations.md"},{"slug":"tokio-optimize-memory-allocation","title":"Optimize memory allocation","description":"Be deliberate about memory allocation patterns to improve performance. Implement these practices: 1. **Pre-allocate collections when the size is known**:","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Performance Optimization","language":"Rust","updated":"2025-02-27","comments":6,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-optimize-memory-allocation.md"},{"slug":"comfyui-optimize-ci-resource-usage","title":"optimize CI resource usage","description":"Design CI/CD workflows to minimize unnecessary resource consumption and provide faster feedback. Avoid triggering builds when changes don't impact the build output, use appropriate event triggers, and implement clean artifact management strategies.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"CI/CD","language":"Yaml","updated":"2025-02-27","comments":5,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-optimize-ci-resource-usage.md"},{"slug":"pydantic-eliminate-redundant-computation","title":"Eliminate redundant computation","description":"Identify and eliminate redundant or duplicate computation paths in your code, especially for expensive operations like schema generation, type resolution, or recursive traversals. This improves performance and reduces resource usage.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Algorithms","language":"Python","updated":"2025-02-27","comments":5,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-eliminate-redundant-computation.md"},{"slug":"helix-standardize-build-configuration-patterns","title":"Standardize build configuration patterns","description":"Explicitly define and standardize build configuration patterns across the project to ensure consistent behavior and optimal performance. Use explicit build type declarations and separate configurations for development and release builds.","repository":"helix-editor/helix","domain":"devtools","topic":"Configurations","language":"Other","updated":"2025-02-27","comments":4,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-standardize-build-configuration-patterns.md"},{"slug":"pydantic-semantic-over-syntactic","title":"Semantic over syntactic","description":"Choose names that clearly communicate the purpose and behavior of your code elements, focusing on semantic meaning rather than just syntax. Names should instantly convey what something is or does without requiring readers to investigate implementation details.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Naming Conventions","language":"Python","updated":"2025-02-27","comments":4,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-semantic-over-syntactic.md"},{"slug":"tokio-secure-unsafe-code","title":"Secure unsafe code","description":"When working with unsafe code, follow these practices to minimize security vulnerabilities: 1. **Minimize scope**: Limit unsafe blocks to only the operations that require them.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Security","language":"Rust","updated":"2025-02-27","comments":4,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-secure-unsafe-code.md"},{"slug":"tokio-minimize-unsafe-code","title":"Minimize unsafe code","description":"When writing code that requires unsafe operations, follow these critical security practices: 1. Minimize the scope of unsafe blocks to only the specific operations that require them","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Security","language":"Rust","updated":"2025-02-27","comments":3,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-minimize-unsafe-code.md"},{"slug":"turborepo-use-workspace-dependencies-consistently","title":"Use workspace dependencies consistently","description":"Always use workspace-level dependency declarations (`workspace = true`) rather than specifying exact versions in individual crates. This ensures consistency across your project, simplifies maintenance, and reduces the risk of version conflicts.","repository":"vercel/turborepo","domain":"devtools","topic":"Configurations","language":"Toml","updated":"2025-02-27","comments":2,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-use-workspace-dependencies-consistently.md"},{"slug":"workers-sdk-provide-specific-examples","title":"Provide specific examples","description":"Documentation should include concrete, actionable examples and use clear, unambiguous terminology to eliminate confusion for developers. Avoid vague instructions that leave developers guessing about implementation details.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Documentation","language":"Markdown","updated":"2025-02-27","comments":2,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-provide-specific-examples.md"},{"slug":"workers-sdk-prefer-standard-crypto-functions","title":"prefer standard crypto functions","description":"Use Node.js built-in crypto module functions instead of third-party cryptographic libraries when possible. The built-in crypto module is well-maintained, follows established standards, and provides better security guarantees than external alternatives.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Security","language":"TypeScript","updated":"2025-02-27","comments":1,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-prefer-standard-crypto-functions.md"},{"slug":"mermaid-deterministic-testing-practices","title":"Deterministic Testing Practices","description":"Integration/e2e tests should be deterministic and directly tied to specified behavior. Apply these rules: 1) Avoid time-based waits. Wait for an observable condition (DOM element present, network idle, event emitted, SVG rendered) instead of `cy.wait(500)`.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Testing","language":"JavaScript","updated":"2025-02-26","comments":6,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-deterministic-testing-practices.md"},{"slug":"compose-write-deterministic-test-assertions","title":"Write deterministic test assertions","description":"Tests should be deterministic and explicit in their assertions to ensure reliability and maintainability. Follow these guidelines: 1. Use explicit assertions instead of ambiguous string matching","repository":"docker/compose","domain":"orchestration","topic":"Testing","language":"Go","updated":"2025-02-26","comments":4,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-write-deterministic-test-assertions.md"},{"slug":"fastapi-use-early-returns","title":"Use early returns","description":"Decrease indentation levels in your code by using early returns for edge cases and guard conditions. This approach improves readability by reducing nesting and making the code flow more linear.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Code Style","language":"Python","updated":"2025-02-26","comments":4,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-use-early-returns.md"},{"slug":"helix-consistent-naming-conventions","title":"consistent naming conventions","description":"Maintain consistent naming patterns throughout your codebase, following established conventions and ensuring uniformity within the same context. This includes using correct syntax for configuration values, matching case conventions for related identifiers, organizing entries systematically (like alphabetically), and choosing descriptive names that clearly...","repository":"helix-editor/helix","domain":"devtools","topic":"Naming Conventions","language":"Toml","updated":"2025-02-26","comments":4,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-consistent-naming-conventions.md"},{"slug":"influxdb-prevent-nil-dereferences","title":"Prevent nil dereferences","description":"Always verify that pointers, slices, or arrays are non-nil and have sufficient elements before attempting to access their members. Use appropriate checks in the correct order to prevent runtime panics.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Null Handling","language":"Go","updated":"2025-02-26","comments":4,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-prevent-nil-dereferences.md"},{"slug":"pydantic-balance-documentation-thoroughness","title":"Balance documentation thoroughness","description":"Documentation should balance completeness with avoiding redundancy. When documenting complex features: 1. Centralize detailed explanations in a single location","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-02-26","comments":4,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-balance-documentation-thoroughness.md"},{"slug":"pydantic-consistent-configuration-patterns","title":"Consistent configuration patterns","description":"When working with configurations in Pydantic models, maintain consistency by using `ConfigDict()` instead of plain dictionaries for better type checking support and IDE assistance. This provides explicit typing and makes your configuration intentions clearer.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Configurations","language":"Markdown","updated":"2025-02-26","comments":4,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-consistent-configuration-patterns.md"},{"slug":"compose-ci-security-boundaries","title":"CI security boundaries","description":"Maintain strict security boundaries in CI/CD workflows by treating CI as a validation-only system and carefully managing third-party dependencies. CI should never automatically modify contributor code or commits - its role is to verify that everything is correct, not to replace proper development practices.","repository":"docker/compose","domain":"orchestration","topic":"CI/CD","language":"Yaml","updated":"2025-02-26","comments":3,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-ci-security-boundaries.md"},{"slug":"prettier-environment-specific-error-handling","title":"Environment-specific error handling","description":"Separate development-time assertions from production error handling based on the runtime environment. Development assertions should be used to catch programming errors and validate internal assumptions during development, while production code should focus on graceful error handling with meaningful user-facing messages.","repository":"prettier/prettier","domain":"devtools","topic":"Error Handling","language":"JavaScript","updated":"2025-02-26","comments":3,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-environment-specific-error-handling.md"},{"slug":"pydantic-preserve-language-conventions","title":"Preserve language conventions","description":"When designing APIs that bridge between programming languages and external data formats (like JSON, XML, etc.), maintain language-specific naming conventions in your code while using aliases to accommodate external data formats. For Python APIs:","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2025-02-26","comments":3,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-preserve-language-conventions.md"},{"slug":"lobe-chat-environment-specific-configuration-handling","title":"Environment-specific configuration handling","description":"When writing configuration scripts, ensure they handle environment-specific differences properly by using predefined path variables and adapting commands for different operating systems. Use consistent variable naming for paths that may vary between environments, and implement OS detection when commands have different syntax across platforms.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Configurations","language":"Shell","updated":"2025-02-26","comments":2,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-environment-specific-configuration-handling.md"},{"slug":"lobe-chat-nextjs-auth-configuration","title":"Next.js auth configuration","description":"Follow auth.js standardized environment variable naming conventions and use explicit function declarations for OAuth providers. Use the `AUTH_[PROVIDER_ID]_ID` format for environment variables as auth.js automatically reads these. Avoid deprecated naming patterns that will be removed in future versions. Explicitly declare scope and profile handling...","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Next","language":"TypeScript","updated":"2025-02-26","comments":2,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-nextjs-auth-configuration.md"},{"slug":"material-ui-parameterize-build-processes","title":"Parameterize build processes","description":"When designing build scripts for multi-package repositories, use parameterization to handle special cases rather than creating duplicate scripts with minor variations. This approach maintains consistency while accommodating package-specific needs. For example, instead of hardcoding different behaviors, add flags that can modify behavior:","repository":"mui/material-ui","domain":"app-frameworks","topic":"CI/CD","language":"Json","updated":"2025-02-26","comments":2,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-parameterize-build-processes.md"},{"slug":"vitess-use-testify-assertion-libraries","title":"Use testify assertion libraries","description":"Replace manual if-error checks with `testify`'s `assert` and `require` packages to make tests more readable, maintainable, and with better error messages.","repository":"vitessio/vitess","domain":"data-systems","topic":"Testing","language":"Go","updated":"2025-02-25","comments":12,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-use-testify-assertion-libraries.md"},{"slug":"react-native-configuration-validation-and-defaults","title":"Configuration validation and defaults","description":"Always validate configuration structure before accessing properties and provide sensible defaults while preserving explicit user overrides. Configuration code should defensively check for the existence of nested properties and gracefully handle missing or malformed configuration.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Configurations","language":"JavaScript","updated":"2025-02-25","comments":7,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-configuration-validation-and-defaults.md"},{"slug":"tensorflow-meaningful-consistent-names","title":"Meaningful consistent names","description":"Choose names that are both semantically precise and follow consistent conventions. Names should accurately reflect behavior and purpose while adhering to established patterns in the codebase.","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Naming Conventions","language":"Other","updated":"2025-02-25","comments":7,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-meaningful-consistent-names.md"},{"slug":"fastapi-protocol-specific-error-handling","title":"Protocol-specific error handling","description":"Handle errors and responses appropriately based on the network protocol being used. Different protocols have different mechanisms for error reporting and communication patterns.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Networking","language":"Markdown","updated":"2025-02-25","comments":5,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-protocol-specific-error-handling.md"},{"slug":"tensorflow-validate-before-dereference","title":"Validate before dereference","description":"Always check that pointers, optional values, and results of type casts are valid before dereferencing or using them. This prevents null pointer exceptions, undefined behavior, and potential crashes in production.","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Null Handling","language":"Other","updated":"2025-02-25","comments":5,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-validate-before-dereference.md"},{"slug":"fastapi-respect-async-execution-order","title":"Respect async execution order","description":"When working with asynchronous code, always be mindful of the execution order of operations, particularly with regards to yielded dependencies, middleware, and background tasks. This affects resource management, error handling, and overall application flow.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Concurrency","language":"Markdown","updated":"2025-02-25","comments":4,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-respect-async-execution-order.md"},{"slug":"stagehand-api-parameter-design","title":"API parameter design","description":"Design API methods with structured object parameters instead of ordered parameters or loose typing. Use proper TypeScript types rather than `any`, and consider parameter patterns that enhance safety and flexibility.","repository":"browserbase/stagehand","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2025-02-25","comments":4,"stars":16443,"raw":"https://awesomereviewers.com/raw/stagehand-api-parameter-design.md"},{"slug":"ghostty-centralize-configuration-management","title":"Centralize configuration management","description":"Avoid hardcoded or duplicated configuration values by centralizing them in a dedicated location. When configurations are needed across multiple components, extract the logic for accessing and applying them so it can be reused. This prevents inconsistencies when configurations change and makes the codebase more maintainable.","repository":"ghostty-org/ghostty","domain":"devtools","topic":"Configurations","language":"Swift","updated":"2025-02-25","comments":3,"stars":32864,"raw":"https://awesomereviewers.com/raw/ghostty-centralize-configuration-management.md"},{"slug":"aider-compatible-null-annotations","title":"Compatible null annotations","description":"When annotating optional or nullable types in Python, ensure compatibility across all supported Python versions. For codebases supporting Python 3.9:","repository":"Aider-AI/aider","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2025-02-25","comments":2,"stars":35856,"raw":"https://awesomereviewers.com/raw/aider-compatible-null-annotations.md"},{"slug":"comfyui-leverage-native-configuration-features","title":"leverage native configuration features","description":"When configuring applications in containerized environments, prefer using the application's built-in configuration mechanisms over extensive external configuration like multiple volume mounts or environment variable overrides. This approach reduces complexity, improves maintainability, and leverages the application's intended configuration patterns.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Configurations","language":"Yaml","updated":"2025-02-25","comments":2,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-leverage-native-configuration-features.md"},{"slug":"sonic-empty-vs-nil-distinction","title":"Empty vs nil distinction","description":"Always distinguish between nil and empty values when handling nullable types, as they carry different semantic meanings and can affect program behavior. Nil represents the absence of a value, while empty represents a zero-length but initialized value.","repository":"bytedance/sonic","domain":"runtimes","topic":"Null Handling","language":"Go","updated":"2025-02-25","comments":2,"stars":8532,"raw":"https://awesomereviewers.com/raw/sonic-empty-vs-nil-distinction.md"},{"slug":"logseq-ensure-semantic-naming-accuracy","title":"Ensure semantic naming accuracy","description":"Names should accurately reflect the actual behavior, purpose, and scope of functions, variables, and classes. Misleading or inaccurate names create confusion and maintenance burden.","repository":"logseq/logseq","domain":"app-frameworks","topic":"Naming Conventions","language":"Other","updated":"2025-02-24","comments":9,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-ensure-semantic-naming-accuracy.md"},{"slug":"tokio-graceful-error-handling","title":"Graceful error handling","description":"Prioritize graceful error handling over panicking by providing fallbacks and propagating rich context. When operations can fail: 1. For non-critical failures, use fallbacks instead of unwrap():","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Error Handling","language":"Rust","updated":"2025-02-24","comments":5,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-graceful-error-handling.md"},{"slug":"boto3-structure-for-readability","title":"Structure for readability","description":"Prioritize code readability by structuring code in a way that makes it easy to understand at a glance. This includes: 1. Break complex conditions into clearer if-else blocks for better comprehension:","repository":"boto/boto3","domain":"cloud-infra","topic":"Code Style","language":"Python","updated":"2025-02-24","comments":4,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-structure-for-readability.md"},{"slug":"pydantic-categorize-error-types","title":"Categorize error types","description":"Distinguish between different categories of errors and handle each appropriately. Specifically: 1. **Validation errors** occur during normal operation when input data doesn''t match expectations. These should be caught and handled gracefully.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Error Handling","language":"Markdown","updated":"2025-02-24","comments":3,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-categorize-error-types.md"},{"slug":"vitess-robust-network-handling","title":"Robust network handling","description":"Always implement proper network timeout handling and address formatting to ensure robust connectivity across different network conditions and IP protocols.","repository":"vitessio/vitess","domain":"data-systems","topic":"Networking","language":"Go","updated":"2025-02-24","comments":3,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-robust-network-handling.md"},{"slug":"comfyui-container-security-best-practices","title":"Container security best practices","description":"Implement comprehensive security measures in containerized applications to prevent privilege escalation, injection attacks, and unauthorized access. This includes proper user configuration, variable quoting, and secure process handling.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Security","language":"Dockerfile","updated":"2025-02-23","comments":2,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-container-security-best-practices.md"},{"slug":"deno-validate-configuration-schemas","title":"validate configuration schemas","description":"Configuration schemas should be actively validated, well-documented, and kept up-to-date through automated testing. Use appropriate schema types (enums vs strings) based on whether values are constrained, provide comprehensive descriptions that include examples and supported formats, and implement automated tests to ensure schemas remain current with code...","repository":"denoland/deno","domain":"runtimes","topic":"Configurations","language":"Json","updated":"2025-02-23","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-validate-configuration-schemas.md"},{"slug":"prettier-documentation-example-consistency","title":"Documentation example consistency","description":"Ensure all code examples and documentation maintain consistent formatting standards, use descriptive variable names, and apply proper syntax highlighting. This includes using meaningful identifiers instead of cryptic names like `a60`, applying correct language tags for syntax highlighting (e.g., `css` instead of `jsx` for CSS code), and providing clear...","repository":"prettier/prettier","domain":"devtools","topic":"Code Style","language":"Markdown","updated":"2025-02-22","comments":8,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-documentation-example-consistency.md"},{"slug":"dspy-dependency-lock-file-management","title":"Dependency lock file management","description":"Always commit dependency lock files (poetry.lock, package-lock.json, etc.) to version control and maintain their consistency across development environments. Lock files ensure reproducible builds and prevent environment mismatches that can cause unexpected changes or build failures.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Configurations","language":"Other","updated":"2025-02-22","comments":2,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-dependency-lock-file-management.md"},{"slug":"lobe-chat-consistent-naming-patterns","title":"consistent naming patterns","description":"Maintain consistent naming conventions within related groups of identifiers. When naming related variables, functions, or constants, use the same naming pattern and style to improve code readability and maintainability.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2025-02-21","comments":6,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-consistent-naming-patterns.md"},{"slug":"pydantic-standardize-dependency-management","title":"Standardize dependency management","description":"Maintain consistent dependency management practices across CI workflows to ensure reliable builds and tests. Use the same tool (e.g., UV, PDM) throughout workflows and specify Python versions explicitly. Avoid redundant dependency specifications when dependencies are already included in other groups.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2025-02-21","comments":6,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-standardize-dependency-management.md"},{"slug":"svelte-choose-descriptive-names","title":"Choose descriptive names","description":"Prioritize semantic clarity and descriptive naming over brevity or convenience. Avoid esoteric, abbreviated, or ambiguous identifiers that require mental translation to understand their purpose.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Naming Conventions","language":"JavaScript","updated":"2025-02-21","comments":6,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-choose-descriptive-names.md"},{"slug":"cli-comprehensive-test-coverage","title":"comprehensive test coverage","description":"Ensure thorough test coverage by extracting complex logic into small, testable functions and using appropriate testing utilities. When encountering complex code blocks, break them into smaller functions that can be tested in isolation. Use Go's built-in testing utilities like `t.Setenv()` instead of `os.Setenv()` for environment variables, and...","repository":"snyk/cli","domain":"security","topic":"Testing","language":"Go","updated":"2025-02-21","comments":5,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-comprehensive-test-coverage.md"},{"slug":"ollama-abstract-model-operations-cleanly","title":"Abstract model operations cleanly","description":"When implementing AI model operations, create clean abstractions through interfaces that separate core mathematical operations from specific implementations. This enables:","repository":"ollama/ollama","domain":"llm-infra","topic":"AI","language":"Go","updated":"2025-02-21","comments":5,"stars":145704,"raw":"https://awesomereviewers.com/raw/ollama-abstract-model-operations-cleanly.md"},{"slug":"react-native-document-configuration-logic","title":"Document configuration logic","description":"Always add clear, explanatory comments for conditional configuration logic, architectural decisions, and platform-specific handling. Configuration code often involves complex decision trees, temporary solutions during transitions, and platform-specific workarounds that may not be immediately obvious to other developers.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2025-02-21","comments":5,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-document-configuration-logic.md"},{"slug":"tokio-socket-configuration-guidance","title":"Socket configuration guidance","description":"When implementing networking APIs, always clearly document socket modes, configuration options, and platform-specific behaviors. Be explicit about blocking versus non-blocking mode implications, required flags, and ensure consistent API design across related components.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Networking","language":"Rust","updated":"2025-02-21","comments":5,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-socket-configuration-guidance.md"},{"slug":"fastapi-secure-jwt-authentication","title":"Secure JWT authentication","description":"Implement secure authentication using JWT tokens by following these best practices: 1. **Use secure libraries**: Prefer well-maintained libraries like `PyJWT` for JWT handling and `passlib` with bcrypt for password hashing:","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Security","language":"Markdown","updated":"2025-02-21","comments":3,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-secure-jwt-authentication.md"},{"slug":"influxdb-explicit-security-parameters","title":"Explicit security parameters","description":"Security-critical features should be implemented as required parameters rather than optional parameters or option functions. This forces developers to make explicit decisions about security settings, preventing accidental omissions that could introduce vulnerabilities.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Security","language":"Go","updated":"2025-02-21","comments":3,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-explicit-security-parameters.md"},{"slug":"turborepo-graceful-error-recovery","title":"Graceful error recovery","description":"Implement error handling that accumulates diagnostics rather than failing immediately, especially for operations that could help users identify and fix problems. Design systems to continue functioning when possible, with configurable strictness levels.","repository":"vercel/turborepo","domain":"devtools","topic":"Error Handling","language":"Other","updated":"2025-02-21","comments":2,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-graceful-error-recovery.md"},{"slug":"django-escape-untrusted-input","title":"Escape untrusted input","description":"Always use appropriate escaping mechanisms when handling input from untrusted sources to prevent injection attacks. User-provided data that contains special characters or operators can be interpreted in unintended ways if not properly escaped, leading to security vulnerabilities like XSS, SQL injection, or command injection.","repository":"django/django","domain":"app-frameworks","topic":"Security","language":"Txt","updated":"2025-02-21","comments":1,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-escape-untrusted-input.md"},{"slug":"alacritty-write-audience-appropriate-documentation","title":"Write audience-appropriate documentation","description":"Documentation should be written from the perspective of its intended audience, using language and detail levels appropriate for that audience. Focus on what matters most to the reader rather than technical implementation details.","repository":"alacritty/alacritty","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2025-02-20","comments":5,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-write-audience-appropriate-documentation.md"},{"slug":"bazel-preserve-exception-causes","title":"preserve exception causes","description":"When catching an exception and re-throwing a different exception type, always preserve the original exception as the cause. This maintains the full stack trace and context, making debugging significantly easier.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Error Handling","language":"Java","updated":"2025-02-20","comments":4,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-preserve-exception-causes.md"},{"slug":"firecrawl-preserve-error-context","title":"preserve error context","description":"Always maintain complete error information when logging or re-throwing errors to enable effective debugging and monitoring. This includes using structured logging instead of console methods, chaining original errors when throwing new ones, and ensuring underlying errors are not masked by generic error handling.","repository":"firecrawl/firecrawl","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2025-02-20","comments":3,"stars":54535,"raw":"https://awesomereviewers.com/raw/firecrawl-preserve-error-context.md"},{"slug":"firecrawl-validate-environment-variables-early","title":"validate environment variables early","description":"Environment variables should be validated at startup or module initialization rather than at runtime usage. Use non-null assertion operators or explicit validation checks to fail fast when required configuration is missing, preventing delayed runtime errors and making configuration issues immediately apparent during development and deployment.","repository":"firecrawl/firecrawl","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-02-20","comments":2,"stars":54535,"raw":"https://awesomereviewers.com/raw/firecrawl-validate-environment-variables-early.md"},{"slug":"pydantic-safe-attribute-access-pattern","title":"Safe attribute access pattern","description":"Always use safe attribute access patterns to handle potentially null or undefined attributes. Instead of direct attribute access that might raise AttributeError, use `getattr()` with a default value. This pattern prevents null reference errors and makes code more robust.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Null Handling","language":"Python","updated":"2025-02-19","comments":4,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-safe-attribute-access-pattern.md"},{"slug":"turborepo-document-cache-strategies","title":"Document cache strategies","description":"Always provide clear documentation and implementation for caching strategies, including key generation, invalidation policies, and default behaviors. When implementing caching:","repository":"vercel/turborepo","domain":"devtools","topic":"Caching","language":"Other","updated":"2025-02-19","comments":3,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-document-cache-strategies.md"},{"slug":"fastapi-use-universally-understandable-identifiers","title":"Use universally understandable identifiers","description":"When naming variables, functions, routes, and other code elements, use clear, neutral terminology that will be understood by all developers regardless of their cultural or domain-specific knowledge. This is especially important in tests, examples, and documentation where context may not be obvious.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Naming Conventions","language":"Python","updated":"2025-02-19","comments":2,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-use-universally-understandable-identifiers.md"},{"slug":"firecrawl-api-endpoint-simplicity","title":"API endpoint simplicity","description":"Design API endpoints with concise, direct naming that clearly communicates their purpose without unnecessary verbosity. Avoid redundant prefixes or overly descriptive names that make endpoints harder to remember and use. Choose built-in language features over custom implementations when possible to improve reliability and maintainability.","repository":"firecrawl/firecrawl","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2025-02-19","comments":2,"stars":54535,"raw":"https://awesomereviewers.com/raw/firecrawl-api-endpoint-simplicity.md"},{"slug":"workers-sdk-explicit-configuration-definitions","title":"Explicit configuration definitions","description":"Ensure all configuration dependencies and environment variables are explicitly defined rather than relying on implicit behavior or assumptions. This prevents issues from version drift, missing definitions, or unclear dependencies.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Configurations","language":"Yaml","updated":"2025-02-19","comments":2,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-explicit-configuration-definitions.md"},{"slug":"django-use-descriptive-identifier-names","title":"Use descriptive identifier names","description":"Choose clear, descriptive names for variables, functions, and classes that accurately convey their purpose and follow framework conventions. Avoid abbreviations, single-letter names, or generic placeholders that might confuse readers.","repository":"django/django","domain":"app-frameworks","topic":"Naming Conventions","language":"Python","updated":"2025-02-18","comments":7,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-use-descriptive-identifier-names.md"},{"slug":"mermaid-identifier-naming-consistency","title":"Identifier Naming Consistency","description":"Use naming that is explicit, consistent, and self-describing. Rules: - Avoid magic strings for statement/type/keyword values: create named constants (and reuse them).","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Naming Conventions","language":"JavaScript","updated":"2025-02-18","comments":5,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-identifier-naming-consistency.md"},{"slug":"stagehand-leverage-typescript-null-safety","title":"Leverage TypeScript null safety","description":"Use TypeScript's type system proactively to prevent null and undefined issues at compile time rather than handling them reactively at runtime. This includes using exhaustive pattern matching, explicit type annotations, and avoiding type casting that can hide null safety problems.","repository":"browserbase/stagehand","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2025-02-18","comments":5,"stars":16443,"raw":"https://awesomereviewers.com/raw/stagehand-leverage-typescript-null-safety.md"},{"slug":"material-ui-event-triggered-network-requests","title":"Event-triggered network requests","description":"When implementing user interactions that trigger network requests, use precise event handling techniques to ensure reliable network operations. Specifically, check event properties like `event.button` (which button was pressed) rather than `event.buttons` (which buttons are currently pressed) to correctly handle user intent.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Networking","language":"JavaScript","updated":"2025-02-18","comments":4,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-event-triggered-network-requests.md"},{"slug":"mastodon-network-resource-limits","title":"Network resource limits","description":"Implement protective limits for network operations to prevent resource exhaustion and denial-of-service attacks. Network operations should have bounded resource consumption to avoid overwhelming servers or clients.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Networking","language":"Ruby","updated":"2025-02-18","comments":3,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-network-resource-limits.md"},{"slug":"turborepo-use-functional-null-handling","title":"Use functional null handling","description":"Leverage Rust''s functional operators for handling nullable and optional values. Instead of using unwrap() or explicit if-statements, prefer combinators like ok(), and_then(), map_or_else() and the ? operator with Option types. This leads to more concise, readable, and null-safe code:","repository":"vercel/turborepo","domain":"devtools","topic":"Null Handling","language":"Rust","updated":"2025-02-18","comments":3,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-use-functional-null-handling.md"},{"slug":"deno-comprehensive-test-coverage","title":"comprehensive test coverage","description":"Ensure tests cover both happy path scenarios and edge cases, including error conditions and boundary behaviors. Always wrap test code in proper test functions to leverage framework benefits like sanitizers and proper test isolation.","repository":"denoland/deno","domain":"runtimes","topic":"Testing","language":"TypeScript","updated":"2025-02-18","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-comprehensive-test-coverage.md"},{"slug":"spring-boot-bean-lifecycle-management","title":"Bean lifecycle management","description":"When using containers and external services in Spring applications (especially with Testcontainers), declare them as Spring beans rather than static fields to ensure proper lifecycle management. This approach ensures that the application context will shut down clients first and then containers, preventing connection errors during shutdown.","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Spring","language":"Other","updated":"2025-02-18","comments":2,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-bean-lifecycle-management.md"},{"slug":"terraform-descriptive-migration-functions","title":"Descriptive migration functions","description":"Name migration-related functions descriptively to convey their exact purpose and context of use. Include detailed documentation explaining when and how each function should be executed in the migration workflow. For example, instead of ambiguous names like `maintenancerelease`, use more specific terms like `setupBackportBranch` or `prepareMaintenanceBranch`...","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Migrations","language":"Shell","updated":"2025-02-18","comments":2,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-descriptive-migration-functions.md"},{"slug":"kafka-verify-authorization-permissions","title":"verify authorization permissions","description":"Ensure that authorization checks use the appropriate permission level for the specific operation being performed. Operations that only read data should use READ permissions, while operations that modify data should use WRITE permissions. Using overly permissive authorization can lead to privilege escalation vulnerabilities.","repository":"apache/kafka","domain":"data-systems","topic":"Security","language":"Other","updated":"2025-02-18","comments":1,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-verify-authorization-permissions.md"},{"slug":"kong-deterministic-isolated-testing","title":"Deterministic isolated testing","description":"Make integration/unit tests deterministic, isolated, and robust against async timing and ordering. Checklist - **No ordering dependence:** Each test must be runnable alone; avoid modifying a shared plugin/config mid-suite. For configuration permutations, create separate routes/services (or fully separate instances) per permutation.","repository":"Kong/kong","domain":"cloud-infra","topic":"Testing","language":"Other","updated":"2025-02-17","comments":9,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-deterministic-isolated-testing.md"},{"slug":"azure-quickstart-templates-config-completeness-and-environment","title":"Config completeness and environment","description":"Use deployment-time configuration (parameters/derived values) instead of hardcoded or partially-specified settings, and ensure env/config entries required for the selected feature/identity are fully present.","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Configurations","language":"Other","updated":"2025-02-17","comments":7,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-config-completeness-and-environment.md"},{"slug":"react-native-simplify-redundant-logic","title":"simplify redundant logic","description":"Eliminate redundant conditional logic, extract duplicated code, and choose simpler patterns over complex implementations. This improves code readability and maintainability by reducing cognitive load.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Code Style","language":"Other","updated":"2025-02-17","comments":7,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-simplify-redundant-logic.md"},{"slug":"spring-boot-meaningful-exception-design","title":"Meaningful exception design","description":"Design exceptions to provide clear context, preserve stack traces, and propagate correctly through your system. Key practices include: 1. Choose the most appropriate exception type based on the error condition:","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Error Handling","language":"Java","updated":"2025-02-17","comments":6,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-meaningful-exception-design.md"},{"slug":"kong-validate-inputs-securely","title":"Validate Inputs Securely","description":"Treat runtime-derived values (env vars, request data, rendered attributes) as untrusted unless they’re validated by the framework’s schema/typedefs or hardened with allowlists.","repository":"Kong/kong","domain":"cloud-infra","topic":"Security","language":"Other","updated":"2025-02-17","comments":5,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-validate-inputs-securely.md"},{"slug":"parlant-preserve-exception-context","title":"preserve exception context","description":"When handling exceptions, preserve the original exception context and provide clear, actionable error information. Avoid creating new exceptions that lose important details from the original error, and replace generic error handling (like assertions) with specific, user-friendly messages.","repository":"emcie-co/parlant","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2025-02-17","comments":5,"stars":12205,"raw":"https://awesomereviewers.com/raw/parlant-preserve-exception-context.md"},{"slug":"opentofu-document-phased-migration-paths","title":"Document phased migration paths","description":"When replacing an existing system feature with a new implementation, provide a clear and well-documented phased migration path. Design your system to support both old and new approaches simultaneously during a transition period, allowing users to migrate gradually without disruption.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Migrations","language":"Markdown","updated":"2025-02-17","comments":2,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-document-phased-migration-paths.md"},{"slug":"opentofu-review-consistency-assumptions","title":"Review consistency assumptions","description":"Periodically reassess your database operations based on updated consistency guarantees offered by storage technologies. As database services evolve over time, operations initially designed to work around consistency limitations may become unnecessary overhead that impacts performance.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Database","language":"Markdown","updated":"2025-02-17","comments":2,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-review-consistency-assumptions.md"},{"slug":"openpilot-platform-specific-socket-configuration","title":"Platform-specific socket configuration","description":"When configuring TCP socket options, always check the platform and apply appropriate settings for each operating system. Different platforms support different socket options and may require different approaches for connection management.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Networking","language":"Python","updated":"2025-02-16","comments":2,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-platform-specific-socket-configuration.md"},{"slug":"mermaid-yaml-first-config-schema","title":"YAML-first config schema","description":"When adding or changing configurable behavior, define it in the correct config scope and expose it via YAML/frontmatter—don’t introduce new diagram-specific syntax/directives, and don’t place diagram-only options in global config.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2025-02-15","comments":4,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-yaml-first-config-schema.md"},{"slug":"nuxt-check-ssr-context","title":"Check SSR context","description":"Always verify execution context (server vs client) before running client-specific operations in SSR applications. Many hydration errors and unexpected behaviors stem from client-only code executing during server-side rendering.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Next","language":"TypeScript","updated":"2025-02-15","comments":3,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-check-ssr-context.md"},{"slug":"query-redact-transported-errors","title":"Redact Transported Errors","description":"When you serialize/dehydrate async results (queries, promises, RSC/RPC payloads), treat error objects as sensitive and do not transport raw server error details to the client/shared layer. Use a default redaction policy and make the behavior explicitly configurable and documented.","repository":"tanstack/query","domain":"app-frameworks","topic":"Security","language":"TypeScript","updated":"2025-02-15","comments":2,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-redact-transported-errors.md"},{"slug":"traefik-complete-api-documentation","title":"complete API documentation","description":"Ensure all API configuration options are fully documented with accurate default values, required field indicators, and complete parameter tables. Missing configuration options, incorrect defaults, or incomplete documentation tables create confusion and implementation errors for developers.","repository":"traefik/traefik","domain":"cloud-infra","topic":"API","language":"Markdown","updated":"2025-02-14","comments":5,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-complete-api-documentation.md"},{"slug":"react-native-dependency-management-strategy","title":"dependency management strategy","description":"When configuring dependencies in package.json, follow these strategic principles to ensure stable and maintainable package management: **Peer Dependencies**: Use peer dependencies judiciously to enable proper package hoisting while avoiding forced installations for all consumers. As noted: \"We still need it here for it to be hoisted correctly. But we can...","repository":"facebook/react-native","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2025-02-14","comments":4,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-dependency-management-strategy.md"},{"slug":"vitess-log-levels-and-clarity","title":"Log levels and clarity","description":"Choose appropriate log levels and write clear, meaningful log messages that provide necessary context without creating noise. Follow these guidelines:","repository":"vitessio/vitess","domain":"data-systems","topic":"Logging","language":"Go","updated":"2025-02-14","comments":4,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-log-levels-and-clarity.md"},{"slug":"waveterm-protect-shared-state","title":"Protect shared state","description":"Ensure mutable shared data is never exposed or accessed without explicit synchronization. When data crosses goroutine boundaries you must either copy it, provide a concurrency-safe accessor that returns a snapshot, or protect it with proper synchronization (mutexes, atomics, or reference counting). This prevents races when marshaling, iterating, or doing...","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Concurrency","language":"Go","updated":"2025-02-13","comments":8,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-protect-shared-state.md"},{"slug":"rails-prefer-simpler-expressions","title":"Prefer simpler expressions","description":"Always choose the simplest, most readable way to express your code logic.\\ \\ Unnecessary complexity makes code harder to understand and maintain. \\n\\nWhen\\ \\ writing conditionals, method calls, or data transformations, ask yourself: \\\"\\ Is there a clearer way to express this?\\\"","repository":"rails/rails","domain":"app-frameworks","topic":"Code Style","language":"Ruby","updated":"2025-02-13","comments":6,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-prefer-simpler-expressions.md"},{"slug":"traefik-complete-observability-router-options","title":"complete observability router options","description":"When documenting router configuration options for any provider (Docker, Consul Catalog, ECS, KV stores, Nomad, etc.), ensure that all observability-related router options are included and properly documented. This is critical for enabling comprehensive monitoring, tracing, and logging capabilities.","repository":"traefik/traefik","domain":"cloud-infra","topic":"Observability","language":"Markdown","updated":"2025-02-13","comments":6,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-complete-observability-router-options.md"},{"slug":"turborepo-semantic-naming-conventions","title":"Semantic naming conventions","description":"Use names that clearly convey the purpose and content of variables, parameters, and properties. When working with objects, always access specific properties rather than using the object directly in string operations to prevent \"[object Object]\" outputs. Include proper type declarations for parameters that describe their structure.","repository":"vercel/turborepo","domain":"devtools","topic":"Naming Conventions","language":"TypeScript","updated":"2025-02-13","comments":3,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-semantic-naming-conventions.md"},{"slug":"openpilot-pin-external-action-versions","title":"pin external action versions","description":"Always pin external GitHub Actions to specific commit hashes rather than using tags or branch names, and prefer built-in runner capabilities when available. This improves security by preventing supply chain attacks and ensures reproducible builds.","repository":"commaai/openpilot","domain":"ml-systems","topic":"CI/CD","language":"Yaml","updated":"2025-02-13","comments":2,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-pin-external-action-versions.md"},{"slug":"prowler-configure-observability-variables","title":"Configure observability variables","description":"Always define all necessary environment variables for observability tools in configuration files, even if using default values. For error tracking services like Sentry, include both connection strings and contextual variables to ensure comprehensive error reporting. This improves troubleshooting by providing environment and release information with each...","repository":"prowler-cloud/prowler","domain":"security","topic":"Observability","language":"Other","updated":"2025-02-13","comments":2,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-configure-observability-variables.md"},{"slug":"react-native-platform-aware-configuration-messages","title":"platform-aware configuration messages","description":"Configuration-related error messages, troubleshooting guidance, and feature flags should be accurate and account for platform-specific differences. When providing configuration instructions or enabling features conditionally, ensure the guidance reflects the actual capabilities and limitations of each target platform.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Configurations","language":"C++","updated":"2025-02-13","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-platform-aware-configuration-messages.md"},{"slug":"terraform-secure-checkout-configurations","title":"Secure checkout configurations","description":"When configuring GitHub Actions workflows, pay special attention to the checkout action''s configuration to ensure both correctness and security: 1. In `pull_request_target` workflows, always specify the reference explicitly to ensure you''re working with the intended branch:","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"CI/CD","language":"Yaml","updated":"2025-02-13","comments":2,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-secure-checkout-configurations.md"},{"slug":"kong-hot-path-performance-rules","title":"Hot-Path Performance Rules","description":"Default to performance-aware coding for hot paths (proxy routing, request parsing, metrics/serialization, and request body handling): - **Avoid unnecessary periodic work**: only schedule timers or run refresh logic when the correctness mode requires it.","repository":"Kong/kong","domain":"cloud-infra","topic":"Performance Optimization","language":"Other","updated":"2025-02-12","comments":9,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-hot-path-performance-rules.md"},{"slug":"influxdb-lock-with-defer-unlock","title":"Lock with defer unlock","description":"Always follow the lock-defer-unlock pattern when protecting shared resources with mutexes. Acquire the lock, immediately use defer to ensure unlock, then perform operations on the protected resource. This prevents deadlocks and ensures locks are released even when functions exit unexpectedly.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Concurrency","language":"Go","updated":"2025-02-12","comments":8,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-lock-with-defer-unlock.md"},{"slug":"pydantic-cache-expensive-computations","title":"Cache expensive computations","description":"Implement strategic caching and memoization for expensive or frequently repeated computations to avoid redundant work. This can significantly improve performance in hot code paths.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Performance Optimization","language":"Python","updated":"2025-02-12","comments":5,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-cache-expensive-computations.md"},{"slug":"netty-protect-network-buffer-lifecycle","title":"Protect network buffer lifecycle","description":"When handling network buffers in protocol implementations, ensure proper lifecycle management to prevent memory leaks and data corruption. Key practices:","repository":"netty/netty","domain":"runtimes","topic":"Networking","language":"Java","updated":"2025-02-12","comments":4,"stars":34227,"raw":"https://awesomereviewers.com/raw/netty-protect-network-buffer-lifecycle.md"},{"slug":"prettier-cache-correctness-validation","title":"Cache correctness validation","description":"Ensure caching implementations store the correct data and use appropriate strategies for the context. Cache should store the final processed output, not intermediate or input data, and should include strategy options for different security/performance requirements.","repository":"prettier/prettier","domain":"devtools","topic":"Caching","language":"JavaScript","updated":"2025-02-12","comments":4,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-cache-correctness-validation.md"},{"slug":"react-router-simplify-configuration-setup","title":"Simplify configuration setup","description":"Avoid redundant configuration parameters and prefer automated solutions over manual maintenance. Remove configuration options that duplicate library defaults, replace manual dependency lists with programmatic detection, and eliminate unused configuration logic when usage patterns change.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Configurations","language":"JavaScript","updated":"2025-02-12","comments":4,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-simplify-configuration-setup.md"},{"slug":"fiber-update-documentation-proactively","title":"Update documentation proactively","description":"When code behavior changes, new features are added, or potential usage pitfalls are identified, proactively update all relevant documentation including API docs, inline comments, and usage warnings. This ensures developers have accurate information about execution order, blocking operations, and proper usage patterns.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Documentation","language":"Go","updated":"2025-02-12","comments":3,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-update-documentation-proactively.md"},{"slug":"react-router-avoid-redundant-computations","title":"avoid redundant computations","description":"Identify and eliminate repeated expensive operations to improve performance. Cache computationally expensive objects like regex patterns, API results, or complex calculations outside of loops and repeated execution contexts. Implement early exit conditions when possible to avoid unnecessary processing.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Performance Optimization","language":"TypeScript","updated":"2025-02-12","comments":3,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-avoid-redundant-computations.md"},{"slug":"fastapi-use-streaming-generators","title":"Use streaming generators","description":"When processing large files or datasets, implement generator functions that yield data incrementally rather than loading everything into memory at once. This approach significantly improves memory efficiency and enables handling of arbitrarily large datasets that wouldn't fit in memory.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Algorithms","language":"Markdown","updated":"2025-02-12","comments":2,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-use-streaming-generators.md"},{"slug":"prettier-cache-invalidation-strategy","title":"cache invalidation strategy","description":"Implement comprehensive cache invalidation mechanisms that automatically handle format changes between versions while providing clear manual removal options. When cache formats change, automatically detect and remove incompatible cache files to prevent runtime errors. Additionally, document cache locations and provide accurate removal commands for manual...","repository":"prettier/prettier","domain":"devtools","topic":"Caching","language":"Markdown","updated":"2025-02-12","comments":2,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-cache-invalidation-strategy.md"},{"slug":"stagehand-ai-dependency-classification","title":"AI dependency classification","description":"When adding AI/ML libraries to a project, carefully consider whether they belong in `dependencies` or `devDependencies`. Libraries used for examples, experimentation, or development tooling should be classified as `devDependencies` to avoid bloating production bundles. Maintain consistency by avoiding install scripts in package.json for dev-only AI...","repository":"browserbase/stagehand","domain":"ai-agents","topic":"AI","language":"Json","updated":"2025-02-12","comments":2,"stars":16443,"raw":"https://awesomereviewers.com/raw/stagehand-ai-dependency-classification.md"},{"slug":"swe-agent-document-configuration-decisions","title":"Document configuration decisions","description":"When making configuration changes, especially those involving version specifications or constraints, include explanatory comments with links to relevant issues, PRs, or documentation. This provides context for future maintainers and makes the reasoning behind configuration decisions transparent and traceable.","repository":"SWE-agent/SWE-agent","domain":"ai-agents","topic":"Configurations","language":"Yaml","updated":"2025-02-12","comments":2,"stars":16839,"raw":"https://awesomereviewers.com/raw/swe-agent-document-configuration-decisions.md"},{"slug":"chef-document-with-examples","title":"Document with examples","description":"Always include comprehensive documentation with clear examples for properties, methods, and code patterns. Documentation should include: 1. **Property descriptions**: Use the `description:` attribute to explain what each property does","repository":"chef/chef","domain":"cloud-infra","topic":"Documentation","language":"Ruby","updated":"2025-02-11","comments":7,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-document-with-examples.md"},{"slug":"kong-network-semantics-consistency","title":"Network semantics consistency","description":"When implementing HTTP/TCP/WebSocket/networking logic, treat protocol semantics as “correctness-critical”: don’t rely on accidental behavior, and don’t assume inputs are single-valued.","repository":"Kong/kong","domain":"cloud-infra","topic":"Networking","language":"Other","updated":"2025-02-11","comments":7,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-network-semantics-consistency.md"},{"slug":"react-router-provide-explicit-error-handling","title":"Provide explicit error handling","description":"Create custom, descriptive errors instead of allowing external dependencies or systems to fail with generic messages. Use consistent error handling utilities throughout the codebase rather than implementing ad-hoc error responses.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2025-02-11","comments":4,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-provide-explicit-error-handling.md"},{"slug":"inbox-zero-handle-errors-with-care","title":"Handle errors with care","description":"Always implement comprehensive error handling for asynchronous operations, external API calls, and database operations. Catch errors at appropriate levels, log them with sufficient context for debugging, and provide meaningful error responses or recovery mechanisms.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2025-02-10","comments":10,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-handle-errors-with-care.md"},{"slug":"inbox-zero-sanitize-external-content","title":"Sanitize external content","description":"Always sanitize and validate external content before processing or rendering it to prevent security vulnerabilities like XSS (Cross-Site Scripting) and injection attacks. This applies to HTML content from emails, user inputs, URL parameters, and any data from untrusted sources.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Security","language":"TSX","updated":"2025-02-10","comments":3,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-sanitize-external-content.md"},{"slug":"markitdown-documentation-language-precision","title":"Documentation language precision","description":"Ensure documentation uses precise, accurate language that clearly describes functionality and highlights important behaviors users need to understand. Avoid vague or misleading terms that could confuse users about what the code actually does.","repository":"microsoft/markitdown","domain":"llm-infra","topic":"Documentation","language":"Markdown","updated":"2025-02-10","comments":3,"stars":76602,"raw":"https://awesomereviewers.com/raw/markitdown-documentation-language-precision.md"},{"slug":"openpilot-benchmark-performance-changes","title":"Benchmark performance changes","description":"Always include performance benchmarks when making changes that could impact execution speed, CPU usage, or resource consumption. This prevents performance regressions and validates optimization claims.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Performance Optimization","language":"Python","updated":"2025-02-10","comments":3,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-benchmark-performance-changes.md"},{"slug":"prettier-ensure-semantic-naming-accuracy","title":"Ensure semantic naming accuracy","description":"Names should accurately reflect the actual behavior, constraints, and purpose of the code element they represent. Misleading names create confusion and make code harder to understand and maintain.","repository":"prettier/prettier","domain":"devtools","topic":"Naming Conventions","language":"TypeScript","updated":"2025-02-10","comments":3,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-ensure-semantic-naming-accuracy.md"},{"slug":"waveterm-explicit-organized-code","title":"Explicit, organized code","description":"Write code that is explicit, predictable, and organized to improve readability and avoid subtle bugs. What to do: - Make control flow explicit. In switch statements and other control structures always use break/return/continue as appropriate. If fallthrough is intentional, annotate it with a clear comment or a lint directive (e.g. // fallthrough). Example...","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Code Style","language":"TypeScript","updated":"2025-02-09","comments":3,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-explicit-organized-code.md"},{"slug":"ollama-keep-container-images-current","title":"Keep container images current","description":"Always use up-to-date and supported container images in Dockerfiles and configuration files. Before specifying a base image or version: 1. Verify the image hasn''t been deprecated","repository":"ollama/ollama","domain":"llm-infra","topic":"Configurations","language":"Dockerfile","updated":"2025-02-09","comments":2,"stars":145705,"raw":"https://awesomereviewers.com/raw/ollama-keep-container-images-current.md"},{"slug":"openpilot-parameterize-hardcoded-api-values","title":"Parameterize hardcoded API values","description":"When designing APIs or interfaces, avoid hardcoding string literals, configuration values, or identifiers that could be made configurable through parameters. This makes the API more flexible, reusable, and maintainable by allowing callers to specify their own values rather than being locked into fixed behavior.","repository":"commaai/openpilot","domain":"ml-systems","topic":"API","language":"Other","updated":"2025-02-09","comments":2,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-parameterize-hardcoded-api-values.md"},{"slug":"langchain-prevent-uv-overwrites","title":"Prevent uv Overwrites","description":"When CI workflows mix multiple uv steps (e.g., install built wheels, then run tests/lint), make dependency installation *deterministic* and prevent later steps from overwriting earlier artifact installs.","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"CI/CD","language":"Yaml","updated":"2025-02-08","comments":4,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-prevent-uv-overwrites.md"},{"slug":"mastodon-comprehensive-authorization-checks","title":"comprehensive authorization checks","description":"Always implement thorough authorization checks at the earliest appropriate point in request processing, rather than relying solely on downstream filtering. This includes verifying user permissions, access rights, and relationship constraints (such as blocking status) before granting access to resources.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Security","language":"JavaScript","updated":"2025-02-08","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-comprehensive-authorization-checks.md"},{"slug":"unstructured-use-semantically-clear-names","title":"Use semantically clear names","description":"Choose variable, method, and class names that clearly express their purpose and functionality to avoid confusion and improve code readability. Names should accurately reflect what the code does rather than how it's implemented.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Naming Conventions","language":"Python","updated":"2025-02-07","comments":12,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-use-semantically-clear-names.md"},{"slug":"unstructured-optimize-algorithmic-complexity","title":"optimize algorithmic complexity","description":"When implementing algorithms, prioritize performance by avoiding unnecessary computations and choosing efficient approaches. Consider algorithmic complexity early in design and look for opportunities to eliminate redundant operations or expensive calculations when simpler alternatives exist.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Algorithms","language":"Python","updated":"2025-02-07","comments":4,"stars":12116,"raw":"https://awesomereviewers.com/raw/unstructured-optimize-algorithmic-complexity.md"},{"slug":"vite-restrict-server-access","title":"Restrict server access","description":"Always configure server security settings with explicit allowed lists rather than permissive values. Using `true` for settings like `server.allowedHosts` or `server.cors` creates serious security vulnerabilities by allowing any website to access your development server through DNS rebinding attacks, potentially exposing source code and sensitive content.","repository":"vitejs/vite","domain":"devtools","topic":"Security","language":"Markdown","updated":"2025-02-07","comments":3,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-restrict-server-access.md"},{"slug":"framework-precise-testing-dependency-versioning","title":"Precise testing dependency versioning","description":"When specifying testing library dependencies, always use explicit minimum patch versions rather than development branches or broad version constraints. This practice ensures consistent and reproducible test environments across development, CI systems, and production builds.","repository":"laravel/framework","domain":"app-frameworks","topic":"Testing","language":"Json","updated":"2025-02-07","comments":2,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-precise-testing-dependency-versioning.md"},{"slug":"pydantic-data-structure-correctness","title":"Data structure correctness","description":"Ensure data structures are accurately represented with their proper constraints and valid implementations, particularly for recursive structures. When documenting or implementing collections:","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Algorithms","language":"Markdown","updated":"2025-02-07","comments":2,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-data-structure-correctness.md"},{"slug":"waveterm-use-network-timeouts","title":"Use network timeouts","description":"Ensure all network operations are cancellable, timeout-protected, and executed where the resource lives. Motivation - Network calls can hang, run on the wrong machine, or transfer too much data. Apply consistent patterns to avoid resource leaks, unresponsive reads, and incorrect behavior when operating on remote resources.","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Networking","language":"Go","updated":"2025-02-06","comments":6,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-use-network-timeouts.md"},{"slug":"react-router-configure-rendering-modes-clearly","title":"Configure rendering modes clearly","description":"Ensure clear distinction and proper handling between different rendering modes (SSR, SSG, SPA) with appropriate conditional logic for each mode's specific requirements.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Next","language":"TypeScript","updated":"2025-02-06","comments":5,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-configure-rendering-modes-clearly.md"},{"slug":"waveterm-specify-api-contracts","title":"Specify API contracts","description":"State and document explicit, unambiguous contracts for all API endpoints and RPC messages, especially around resource identity, data encoding, and file-operation semantics. Motivation: inconsistent assumptions about where a path comes from, whether payloads are encoded, and what ReadAt/WriteAt should return lead to brittle clients and surprising server...","repository":"wavetermdev/waveterm","domain":"devtools","topic":"API","language":"Go","updated":"2025-02-06","comments":5,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-specify-api-contracts.md"},{"slug":"inbox-zero-test-all-code-paths","title":"Test all code paths","description":"Write comprehensive tests that cover all code paths including edge cases, error conditions, and different parameter combinations. Each test file should include:","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Testing","language":"TypeScript","updated":"2025-02-06","comments":4,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-test-all-code-paths.md"},{"slug":"tensorflow-centralize-configuration-settings","title":"Centralize configuration settings","description":"Place configuration settings in centralized, appropriate locations rather than duplicating them across multiple files. This improves maintainability by ensuring changes only need to be made in one place.","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Configurations","language":"Other","updated":"2025-02-06","comments":4,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-centralize-configuration-settings.md"},{"slug":"stagehand-prefer-lazy-computation","title":"prefer lazy computation","description":"Avoid precomputing expensive operations when they may not be needed, especially for large datasets. Instead, compute values on-demand when they are actually required. This prevents unnecessary work and improves performance for scenarios where only a subset of computed values will be used.","repository":"browserbase/stagehand","domain":"ai-agents","topic":"Algorithms","language":"TypeScript","updated":"2025-02-06","comments":3,"stars":16443,"raw":"https://awesomereviewers.com/raw/stagehand-prefer-lazy-computation.md"},{"slug":"semgrep-use-proper-uri-parsing","title":"Use proper URI parsing","description":"When working with URLs and URIs in networking code, use proper URI parsing libraries and types instead of string manipulation or regex validation. This approach is more robust, handles edge cases correctly, and provides better type safety.","repository":"semgrep/semgrep","domain":"security","topic":"Networking","language":"Other","updated":"2025-02-06","comments":2,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-use-proper-uri-parsing.md"},{"slug":"checkov-prevent-sensitive-data-exposure","title":"Prevent sensitive data exposure","description":"Never log or store sensitive information (passwords, tokens, secrets) in clear text. This common security vulnerability can lead to credential leaks and unauthorized access.","repository":"bridgecrewio/checkov","domain":"security","topic":"Security","language":"Python","updated":"2025-02-05","comments":20,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-prevent-sensitive-data-exposure.md"},{"slug":"checkov-protect-sensitive-data","title":"Protect sensitive data","description":"Never log, display, or store sensitive information like passwords, tokens, or secrets in clear text. This creates significant security vulnerabilities that could lead to unauthorized access and data breaches.","repository":"bridgecrewio/checkov","domain":"security","topic":"Security","language":"Python","updated":"2025-02-05","comments":16,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-protect-sensitive-data.md"},{"slug":"typescript-optimize-critical-loops","title":"Optimize critical loops","description":"When implementing algorithms with nested loops or recursive operations, carefully analyze the computational complexity and optimize the critical path. Pay attention to loop ordering, early termination conditions, and unnecessary recomputation.","repository":"microsoft/typescript","domain":"runtimes","topic":"Algorithms","language":"TypeScript","updated":"2025-02-05","comments":8,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-optimize-critical-loops.md"},{"slug":"react-native-early-returns-prevent-waste","title":"Early returns prevent waste","description":"Add early return statements and duplicate checks to avoid unnecessary computations, memory allocations, and API calls. This pattern prevents performance degradation by stopping expensive operations before they begin.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Performance Optimization","language":"JavaScript","updated":"2025-02-05","comments":5,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-early-returns-prevent-waste.md"},{"slug":"ollama-use-portable-path-configurations","title":"Use portable path configurations","description":"Build and configuration scripts should use portable path handling techniques to ensure they work correctly across different environments and installations.","repository":"ollama/ollama","domain":"llm-infra","topic":"Configurations","language":"Shell","updated":"2025-02-05","comments":3,"stars":145705,"raw":"https://awesomereviewers.com/raw/ollama-use-portable-path-configurations.md"},{"slug":"prettier-documentation-clarity-standards","title":"Documentation clarity standards","description":"Ensure documentation is clear, precise, and technically accurate to prevent confusion and build errors. This includes proper escaping of special characters, consistent terminology, version-specific accuracy, and unambiguous language.","repository":"prettier/prettier","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2025-02-04","comments":6,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-documentation-clarity-standards.md"},{"slug":"express-optimize-dependency-automation","title":"Optimize dependency automation","description":"Configure automated dependency update tools (like Dependabot) to balance security needs against developer cognitive load. Set monthly intervals instead of weekly to reduce PR noise, limit the number of concurrent PRs, and consider excluding major version updates that could cause compatibility issues.","repository":"expressjs/express","domain":"app-frameworks","topic":"Configurations","language":"Yaml","updated":"2025-02-04","comments":4,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-optimize-dependency-automation.md"},{"slug":"prowler-memory-usage-optimization","title":"Memory usage optimization","description":"Optimize memory usage in high-performance applications by implementing explicit memory management techniques. This includes: 1. **Configure cache limits** to prevent excessive memory consumption:","repository":"prowler-cloud/prowler","domain":"security","topic":"Performance Optimization","language":"Python","updated":"2025-02-04","comments":4,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-memory-usage-optimization.md"},{"slug":"electron-organize-code-structure","title":"organize code structure","description":"Make deliberate structural decisions that improve code maintainability and readability. Consider the appropriate implementation layer, proper encapsulation patterns, and logical organization of code components.","repository":"electron/electron","domain":"devtools","topic":"Code Style","language":"TypeScript","updated":"2025-02-04","comments":3,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-organize-code-structure.md"},{"slug":"dify-responsible-ai-management","title":"Responsible AI management","description":"Ensure AI models are managed responsibly throughout their lifecycle and have appropriate boundaries on their decision-making authority. When deprecating AI models, maintain backward compatibility by marking old models as deprecated rather than removing them entirely. Additionally, prevent AI models from controlling sensitive parameters that could lead to...","repository":"langgenius/dify","domain":"llm-infra","topic":"AI","language":"Yaml","updated":"2025-02-04","comments":2,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-responsible-ai-management.md"},{"slug":"fastapi-explicit-exception-propagation","title":"Explicit exception propagation","description":"Always be explicit about how exceptions are handled, propagated, and recovered from in your code. When catching exceptions, either re-raise them or raise appropriate new exceptions to ensure proper error flow through the system.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Error Handling","language":"Markdown","updated":"2025-02-01","comments":3,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-explicit-exception-propagation.md"},{"slug":"likec4-gate-ui-features","title":"Gate UI features","description":"Ensure UI elements (buttons, icons, tooltips, overlays) are only registered or rendered when the corresponding configuration or feature flag is enabled. Also ensure feature flags are passed into components or a central store so components make rendering decisions from configuration rather than hard-coded assumptions.","repository":"likec4/likec4","domain":"devtools","topic":"Configurations","language":"TSX","updated":"2025-02-01","comments":2,"stars":2582,"raw":"https://awesomereviewers.com/raw/likec4-gate-ui-features.md"},{"slug":"fastapi-avoid-blocking-in-async","title":"Avoid blocking in async","description":"When working with asynchronous code, ensure that I/O operations (like file reads/writes) don't block the event loop. Blocking operations in async contexts can lead to performance degradation, deadlocks, or unexpected behavior.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Concurrency","language":"Python","updated":"2025-01-31","comments":2,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-avoid-blocking-in-async.md"},{"slug":"ollama-purpose-reflecting-file-names","title":"Purpose-reflecting file names","description":"File names should clearly communicate their purpose and functionality. Avoid generic, ambiguous, or numbered names (like \"Makefile2\") that don't convey the file's actual role or lead to recurring questions.","repository":"ollama/ollama","domain":"llm-infra","topic":"Naming Conventions","language":"Other","updated":"2025-01-31","comments":2,"stars":145705,"raw":"https://awesomereviewers.com/raw/ollama-purpose-reflecting-file-names.md"},{"slug":"influxdb-vet-security-critical-dependencies","title":"Vet security-critical dependencies","description":"When introducing new dependencies, especially those handling sensitive operations like language interpreters, perform comprehensive security due diligence before adoption. Evaluate each dependency against these security criteria:","repository":"influxdata/influxdb","domain":"data-systems","topic":"Security","language":"Toml","updated":"2025-01-31","comments":1,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-vet-security-critical-dependencies.md"},{"slug":"compose-follow-existing-naming-patterns","title":"Follow existing naming patterns","description":"Maintain consistency with established naming conventions throughout the codebase. When adding new flags, functions, or variables, examine existing similar implementations and follow the same patterns for naming, separators, and structure.","repository":"docker/compose","domain":"orchestration","topic":"Naming Conventions","language":"Go","updated":"2025-01-30","comments":12,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-follow-existing-naming-patterns.md"},{"slug":"poetry-api-backwards-compatibility","title":"API backwards compatibility","description":"When evolving public APIs, prioritize backwards compatibility through proper deprecation strategies and careful interface design. Avoid breaking changes by using overloads, deprecation warnings, and gradual migration paths.","repository":"python-poetry/poetry","domain":"devtools","topic":"API","language":"Python","updated":"2025-01-30","comments":4,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-api-backwards-compatibility.md"},{"slug":"python-validate-security-inputs","title":"Validate Security Inputs","description":"Security-sensitive code should *fail fast* with explicit validation of inputs and security parameters. That means: (1) validate structure/format (e.g., exact length, allowed characters), (2) validate ranges per component (e.g., IPv4 octets must be 0–255), (3) validate logical invariants the algorithm assumes (e.g., arrival time ≤ deadline), and (4) in...","repository":"TheAlgorithms/Python","domain":"docs","topic":"Security","language":"Python","updated":"2025-01-30","comments":4,"stars":220912,"raw":"https://awesomereviewers.com/raw/python-validate-security-inputs.md"},{"slug":"poetry-explicit-configuration-specification","title":"explicit configuration specification","description":"Always explicitly specify configuration values rather than relying on defaults or implicit behavior. Poetry requires unambiguous configuration to function correctly, and many issues arise from incomplete or assumed specifications.","repository":"python-poetry/poetry","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2025-01-29","comments":9,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-explicit-configuration-specification.md"},{"slug":"svelte-use-modern-null-safe-operators","title":"use modern null-safe operators","description":"Prefer modern JavaScript null-safe operators over verbose conditional checks to improve code readability and prevent null-related errors. Use optional chaining (?.) for safe property access, nullish coalescing (??) for default values, and nullish coalescing assignment (??=) for lazy initialization.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Null Handling","language":"JavaScript","updated":"2025-01-29","comments":9,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-use-modern-null-safe-operators.md"},{"slug":"pydantic-consistent-term-capitalization","title":"Consistent term capitalization","description":"Follow consistent capitalization rules for technical terms, acronyms, and library names throughout your codebase and documentation: 1. **Capitalize standard acronyms**: Use ''URL'', ''JSON'', ''API'', ''HTML'', ''CSS'', ''Unicode'', etc. rather than lowercase versions.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Naming Conventions","language":"Markdown","updated":"2025-01-29","comments":7,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-consistent-term-capitalization.md"},{"slug":"langchainjs-avoid-hardcoded-configurations","title":"Avoid hardcoded configurations","description":"Always parameterize values that might vary across different environments or users instead of hardcoding them in your code. This applies to API endpoints, regions, dimensions, credentials, and other configuration values.","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-01-29","comments":4,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-avoid-hardcoded-configurations.md"},{"slug":"cli-configuration-naming-consistency","title":"Configuration naming consistency","description":"Ensure configuration elements (environment variables, feature flags, config files) maintain consistent naming and clear documentation across code, logs, and documentation. Mismatched names between implementation and logging/documentation create confusion and debugging difficulties.","repository":"snyk/cli","domain":"security","topic":"Configurations","language":"JavaScript","updated":"2025-01-29","comments":3,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-configuration-naming-consistency.md"},{"slug":"deno-benchmark-performance-assumptions","title":"benchmark performance assumptions","description":"Always validate performance assumptions with concrete benchmarks rather than making optimization decisions based on intuition. When considering performance trade-offs between different implementation approaches, write targeted benchmarks to measure the actual impact.","repository":"denoland/deno","domain":"runtimes","topic":"Performance Optimization","language":"JavaScript","updated":"2025-01-29","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-benchmark-performance-assumptions.md"},{"slug":"cli-document-intent-and-reasoning","title":"Document intent and reasoning","description":"Add comments that explain the reasoning, intent, or context behind code decisions, especially for non-obvious logic, workarounds, or business requirements. Focus on the \"why\" rather than just the \"what\" to help future maintainers understand the decision-making process.","repository":"snyk/cli","domain":"security","topic":"Documentation","language":"TypeScript","updated":"2025-01-28","comments":7,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-document-intent-and-reasoning.md"},{"slug":"tokio-structure-api-doc-blocks","title":"Structure API doc blocks","description":"Each public API documentation block should follow a consistent structure: 1. Start with a single-line summary that concisely describes the item 2. Add an empty line after the summary","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Documentation","language":"Rust","updated":"2025-01-28","comments":5,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-structure-api-doc-blocks.md"},{"slug":"markitdown-handle-async-concurrency-properly","title":"Handle async concurrency properly","description":"When writing async endpoints, ensure that long-running CPU-bound operations don't block the event loop and that concurrent requests don't conflict over shared resources. CPU-bound operations should be offloaded to thread pools using asyncio.run_in_executor() or similar mechanisms. Additionally, avoid using predictable file paths or shared resources that can...","repository":"microsoft/markitdown","domain":"llm-infra","topic":"Concurrency","language":"Python","updated":"2025-01-28","comments":2,"stars":76602,"raw":"https://awesomereviewers.com/raw/markitdown-handle-async-concurrency-properly.md"},{"slug":"router-avoid-unnecessary-workflow-restrictions","title":"avoid unnecessary workflow restrictions","description":"Remove unnecessary approval gates, custom tokens, and restrictive conditions in CI/CD workflows when existing security measures are sufficient. Over-restrictive workflows create friction without meaningful security benefits.","repository":"TanStack/router","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2025-01-28","comments":2,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-avoid-unnecessary-workflow-restrictions.md"},{"slug":"better-auth-optimize-database-queries","title":"Optimize database queries","description":"Avoid inefficient database query patterns by using batch operations and appropriate query types. Instead of making multiple individual queries, use batch queries with `in` clauses. When you only need counts, use count queries rather than fetching full records.","repository":"better-auth/better-auth","domain":"security","topic":"Database","language":"TypeScript","updated":"2025-01-27","comments":2,"stars":19651,"raw":"https://awesomereviewers.com/raw/better-auth-optimize-database-queries.md"},{"slug":"react-native-avoid-unnecessary-component-complexity","title":"avoid unnecessary component complexity","description":"When designing React components and their APIs, resist the temptation to add features, props, or methods that provide limited or no real value to developers. Components should expose only functionality that serves genuine use cases and avoids introducing maintenance burden or developer confusion.","repository":"facebook/react-native","domain":"app-frameworks","topic":"React","language":"Kotlin","updated":"2025-01-27","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-avoid-unnecessary-component-complexity.md"},{"slug":"react-native-use-kotlin-testing-idioms","title":"Use Kotlin testing idioms","description":"When writing tests in Kotlin, prefer Kotlin-specific testing libraries and language features over their Java equivalents. Use Mockito Kotlin instead of standard Mockito for more idiomatic syntax, and leverage Kotlin language features like `apply` blocks to make test setup code more concise and readable.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Testing","language":"Kotlin","updated":"2025-01-27","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-use-kotlin-testing-idioms.md"},{"slug":"react-router-use-descriptive-semantic-names","title":"Use descriptive semantic names","description":"Choose variable, function, and type names that clearly communicate their purpose and context. Prioritize readability and semantic meaning over brevity.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2025-01-24","comments":6,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-use-descriptive-semantic-names.md"},{"slug":"chef-standardize-installation-directory-paths","title":"Standardize installation directory paths","description":"Maintain consistent and separate installation paths for different build types to prevent conflicts and improve system organization. Use `/hab` directory for Habitat builds and `/opt/chef` for Omnibus installations.","repository":"chef/chef","domain":"cloud-infra","topic":"Configurations","language":"Other","updated":"2025-01-24","comments":4,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-standardize-installation-directory-paths.md"},{"slug":"influxdb-document-complete-data-flows","title":"Document complete data flows","description":"When documenting database systems, ensure all documentation includes complete end-to-end data flows. Both diagrams and textual descriptions should clearly indicate:","repository":"influxdata/influxdb","domain":"data-systems","topic":"Database","language":"Markdown","updated":"2025-01-24","comments":3,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-document-complete-data-flows.md"},{"slug":"nuxt-build-documentation-clarity","title":"Build documentation clarity","description":"Ensure build and deployment documentation clearly explains processes, outputs, and environment options to prevent CI/CD pipeline issues. Documentation should comprehensively cover build context separation, deployment targets, and generated artifacts.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"CI/CD","language":"Markdown","updated":"2025-01-24","comments":3,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-build-documentation-clarity.md"},{"slug":"mastodon-optimize-react-hooks","title":"Optimize React hooks","description":"Avoid unnecessary useCallback and useEffect dependencies to improve performance and code clarity. When event handlers are only used within a useEffect, define them locally inside the effect rather than using useCallback. This eliminates the need for the callback hook and reduces re-renders. Additionally, understand that refs don't need to be included in...","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"React","language":"JSX","updated":"2025-01-24","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-optimize-react-hooks.md"},{"slug":"nuxt-improve-code-readability","title":"improve code readability","description":"Add line breaks and proper spacing between logical blocks within functions to improve code readability. When functions become complex with multiple logical sections, consider extracting nested logic into separate functions.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2025-01-24","comments":2,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-improve-code-readability.md"},{"slug":"unstructured-pep-257-docstring-compliance","title":"PEP 257 docstring compliance","description":"All public modules, classes, methods, and functions must have docstrings that follow PEP 257 formatting standards. This ensures consistent, professional documentation across the codebase.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Documentation","language":"Python","updated":"2025-01-23","comments":11,"stars":12116,"raw":"https://awesomereviewers.com/raw/unstructured-pep-257-docstring-compliance.md"},{"slug":"opentelemetry-python-structured-changelog-documentation","title":"Structured changelog documentation","description":"Maintain consistent and informative changelog documentation by following these practices: 1. Structure changelogs with an \"Unreleased\" section at the top where all pending changes are documented before release","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Documentation","language":"Markdown","updated":"2025-01-23","comments":3,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-structured-changelog-documentation.md"},{"slug":"tree-sitter-descriptive-naming-patterns","title":"descriptive naming patterns","description":"Use descriptive names that clearly indicate the expected format, convention, or constraints. This applies to template variables, configuration keys, and validation patterns. Names should communicate not just what something is, but how it should be formatted or what rules it follows.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Naming Conventions","language":"Json","updated":"2025-01-23","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-descriptive-naming-patterns.md"},{"slug":"waveterm-defensive-nil-handling","title":"defensive nil handling","description":"Always validate values and short-circuit on errors; guard uses of possibly nil/empty values while avoiding redundant checks when types guarantee non-nil.","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Null Handling","language":"Go","updated":"2025-01-22","comments":6,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-defensive-nil-handling.md"},{"slug":"kong-cache-consistency-rules","title":"Cache Consistency Rules","description":"When implementing caching, make coherence and invalidation explicit and configuration-driven: - If a setting promises immediate consistency (e.g., “strict”), do not perform lazy reloads; rely on the update pipeline to keep cached data correct.","repository":"Kong/kong","domain":"cloud-infra","topic":"Caching","language":"Other","updated":"2025-01-22","comments":4,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-cache-consistency-rules.md"},{"slug":"argo-cd-structured-condition-evaluation","title":"structured condition evaluation","description":"When implementing health checks, use comprehensive condition evaluation patterns instead of simple field comparisons. Check multiple condition attributes (type, status, reason, message) to ensure accurate health status determination.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Observability","language":"Other","updated":"2025-01-22","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-structured-condition-evaluation.md"},{"slug":"kong-consistent-actionable-logging","title":"Consistent, Actionable Logging","description":"When adding/modifying logs, follow these rules: 1) Use the Kong logging API - Prefer `kong.log.<level>` (e.g., `kong.log.err(...)`) over `ngx.log(...)` to keep logging consistent with Kong conventions.","repository":"Kong/kong","domain":"cloud-infra","topic":"Logging","language":"Other","updated":"2025-01-21","comments":11,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-consistent-actionable-logging.md"},{"slug":"kong-concurrency-primitive-semantics","title":"Concurrency primitive semantics","description":"When introducing async work, retries, or batching: 1) Use each concurrency primitive for its intended role - Don’t repurpose a queue as a parallel executor. If you need the same per-entry logic from both the queue and direct callers, extract it into a shared function/module and have both paths call it.","repository":"Kong/kong","domain":"cloud-infra","topic":"Concurrency","language":"Other","updated":"2025-01-21","comments":10,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-concurrency-primitive-semantics.md"},{"slug":"spring-boot-follow-consistent-style-conventions","title":"Follow consistent style conventions","description":"Spring Boot projects maintain specific coding style conventions for consistency and readability. When contributing code, adhere to the following style guidelines:","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Code Style","language":"Java","updated":"2025-01-21","comments":8,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-follow-consistent-style-conventions.md"},{"slug":"netty-use-null-validation-utilities","title":"Use null validation utilities","description":"Consistently use utility methods like `ObjectUtil.checkNotNull()` or `Objects.requireNonNull()` to validate that parameters are not null. When assigning parameters to instance variables, combine the null check with the assignment for cleaner, more maintainable code:","repository":"netty/netty","domain":"runtimes","topic":"Null Handling","language":"Java","updated":"2025-01-21","comments":6,"stars":34227,"raw":"https://awesomereviewers.com/raw/netty-use-null-validation-utilities.md"},{"slug":"nest-structure-exception-handling-patterns","title":"Structure exception handling patterns","description":"Implement consistent exception handling using framework-provided mechanisms rather than ad-hoc try-catch blocks or manual error propagation. Use appropriate exception classes and interceptors to handle errors at the right architectural level.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2025-01-21","comments":4,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-structure-exception-handling-patterns.md"},{"slug":"vitess-environment-portable-configuration-management","title":"Environment-portable configuration management","description":"Ensure all configurations are environment-portable and follow current best practices for the target platforms. This includes: 1. Using environment variables instead of hardcoded paths or user-specific values","repository":"vitessio/vitess","domain":"data-systems","topic":"Configurations","language":"Other","updated":"2025-01-21","comments":4,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-environment-portable-configuration-management.md"},{"slug":"vitess-standardize-error-wrapping-patterns","title":"Standardize error wrapping patterns","description":"Use consistent error wrapping patterns to preserve error context and ensure proper error code propagation. Always: 1. Use vterrors.New/Errorf when creating new errors to include error codes","repository":"vitessio/vitess","domain":"data-systems","topic":"Error Handling","language":"Go","updated":"2025-01-21","comments":4,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-standardize-error-wrapping-patterns.md"},{"slug":"tokenizers-test-algorithmic-behavior","title":"Test algorithmic behavior","description":"When testing algorithms, verify their actual functionality rather than just checking for proper instantiation or property modification. Ensure your tests capture the core behaviors of the algorithm under various parameters.","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"Algorithms","language":"Python","updated":"2025-01-21","comments":2,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-test-algorithmic-behavior.md"},{"slug":"checkov-safe-dictionary-navigation","title":"Safe dictionary navigation","description":"Always use the `.get()` method with appropriate default values when accessing dictionaries instead of direct key access with brackets. This prevents KeyError exceptions when keys don't exist and provides predictable default values. For nested dictionaries, chain `.get()` calls with empty dictionaries as defaults for intermediate levels.","repository":"bridgecrewio/checkov","domain":"security","topic":"Null Handling","language":"Python","updated":"2025-01-20","comments":9,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-safe-dictionary-navigation.md"},{"slug":"opentelemetry-python-optimize-code-location-scope","title":"Optimize code location scope","description":"Place code in the most specific and appropriate location to improve findability and maintainability. Follow these principles: 1. Avoid generic utility modules - place code in specific, relevant modules","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Code Style","language":"Python","updated":"2025-01-20","comments":7,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-optimize-code-location-scope.md"},{"slug":"tokio-network-api-design-consistency","title":"Network API design consistency","description":"When designing networking APIs, maintain consistency with existing interfaces while ensuring proper cross-platform compatibility. Follow these key principles:","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Networking","language":"Rust","updated":"2025-01-20","comments":6,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-network-api-design-consistency.md"},{"slug":"express-propagate-errors-properly","title":"Propagate errors properly","description":"Always forward errors to the framework's error handling pipeline instead of swallowing them or handling them inconsistently. This enables centralized error handling, consistent user experiences, and proper error logging.","repository":"expressjs/express","domain":"app-frameworks","topic":"Error Handling","language":"JavaScript","updated":"2025-01-20","comments":5,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-propagate-errors-properly.md"},{"slug":"netty-release-resources-consistently","title":"Release resources consistently","description":"Always ensure resources are properly released, especially in exception paths. Use try-finally blocks to guarantee cleanup of buffers, streams, and other resources even when errors occur.","repository":"netty/netty","domain":"runtimes","topic":"Error Handling","language":"Java","updated":"2025-01-20","comments":5,"stars":34227,"raw":"https://awesomereviewers.com/raw/netty-release-resources-consistently.md"},{"slug":"v-runtime-configurable-defaults","title":"Runtime configurable defaults","description":"Prefer runtime-configurable values over hardcoded constants to allow users to customize behavior without recompilation. Use environment variables with `os.getenv_opt()` for runtime configuration instead of compile-time constants with `$d()`, and consider environment variables instead of complex CLI parsing.","repository":"vlang/v","domain":"runtimes","topic":"Configurations","language":"Other","updated":"2025-01-20","comments":5,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-runtime-configurable-defaults.md"},{"slug":"argo-cd-document-network-requirements","title":"document network requirements","description":"When documenting network-dependent features, explicitly specify all network configuration requirements including protocol support, certificate handling, and infrastructure setup. Users often encounter connectivity issues due to undocumented network prerequisites.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Networking","language":"Markdown","updated":"2025-01-20","comments":4,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-document-network-requirements.md"},{"slug":"developer-roadmap-auth-gated-validation","title":"Auth-Gated Validation","description":"Apply security controls at the UI/component level and ensure input validation is centralized. 1) Auth-state gating (authorization/flow correctness) - Don’t render or enable actions when the user’s authentication state makes them invalid. Check auth state at the component boundary.","repository":"kamranahmedse/developer-roadmap","domain":"docs","topic":"Security","language":"TSX","updated":"2025-01-20","comments":2,"stars":354523,"raw":"https://awesomereviewers.com/raw/developer-roadmap-auth-gated-validation.md"},{"slug":"neon-limit-concurrent-access-slots","title":"Limit concurrent access slots","description":"Design concurrency mechanisms based on actual usage patterns rather than theoretical maximum connections. When implementing locking or state tracking for concurrent operations, limit the number of concurrent slots to a reasonable value (e.g., 128) that reflects the expected concurrency level, rather than scaling to the maximum number of possible backends...","repository":"neondatabase/neon","domain":"data-systems","topic":"Concurrency","language":"Other","updated":"2025-01-20","comments":2,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-limit-concurrent-access-slots.md"},{"slug":"netty-check-feature-compatibility","title":"Check feature compatibility","description":"When using kernel-specific networking features like io_uring, always implement runtime detection of feature support before enabling them. This ensures your code remains compatible across different kernel versions while taking advantage of newer optimizations when available.","repository":"netty/netty","domain":"runtimes","topic":"Networking","language":"C","updated":"2025-01-20","comments":2,"stars":34227,"raw":"https://awesomereviewers.com/raw/netty-check-feature-compatibility.md"},{"slug":"tree-sitter-api-documentation-synchronization","title":"API documentation synchronization","description":"Ensure that all API documentation, including code examples and integration guides, accurately reflects the current API state. When API changes occur (such as import/export modifications, new entry points, or version compatibility updates), corresponding documentation must be updated immediately to prevent developer confusion and integration errors.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"API","language":"Markdown","updated":"2025-01-20","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-api-documentation-synchronization.md"},{"slug":"tree-sitter-ensure-semantic-naming-clarity","title":"Ensure semantic naming clarity","description":"Names should clearly convey their semantic purpose and avoid conflicts that reduce code readability. This applies to imports, types, variables, and methods.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Naming Conventions","language":"TypeScript","updated":"2025-01-20","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-ensure-semantic-naming-clarity.md"},{"slug":"router-serialize-dynamic-code-inputs","title":"Serialize dynamic code inputs","description":"Always serialize or sanitize user-controlled data before embedding it in dynamically generated code to prevent code injection vulnerabilities. Unsanitized inputs containing special characters like quotes can break JavaScript syntax or enable malicious code execution.","repository":"TanStack/router","domain":"app-frameworks","topic":"Security","language":"TypeScript","updated":"2025-01-20","comments":1,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-serialize-dynamic-code-inputs.md"},{"slug":"electron-avoid-exposing-sensitive-apis","title":"Avoid exposing sensitive APIs","description":"Do not enable configurations that expose Node.js or Electron APIs to untrusted web content in renderer processes. This includes avoiding `nodeIntegration: true` for remote content and not directly exposing IPC APIs in preload scripts.","repository":"electron/electron","domain":"devtools","topic":"Security","language":"Markdown","updated":"2025-01-19","comments":4,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-avoid-exposing-sensitive-apis.md"},{"slug":"hyprland-consistent-naming-conventions","title":"consistent naming conventions","description":"Follow the project''s established naming conventions consistently across all code. Use camelCase for variables, functions, and parameters, avoiding Hungarian notation and snake_case. Apply type-specific prefixes: classes should have a ''C'' prefix (e.g., `CXCBConnection`), enums should have an ''e'' prefix (e.g., `eAutoDirs`), and enum values should be in CAPS...","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Naming Conventions","language":"Other","updated":"2025-01-18","comments":6,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-consistent-naming-conventions.md"},{"slug":"tree-sitter-conditional-compilation-guards","title":"Conditional compilation guards","description":"Always use appropriate preprocessor directives to guard platform-specific, version-dependent, or feature-specific code. Ensure that conditional compilation checks accurately reflect the actual availability of features and APIs, not just version numbers or single configuration flags.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Configurations","language":"C","updated":"2025-01-18","comments":4,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-conditional-compilation-guards.md"},{"slug":"rails-environment-specific-logger-configuration","title":"Environment-specific logger configuration","description":"Configure loggers in environment-specific files rather than in application.rb or initializers. Different environments (development, test, production) typically require different logging levels and configurations, and Rails is designed to support this pattern.","repository":"rails/rails","domain":"app-frameworks","topic":"Logging","language":"Markdown","updated":"2025-01-18","comments":3,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-environment-specific-logger-configuration.md"},{"slug":"v-avoid-breaking-api-changes","title":"Avoid breaking API changes","description":"When modifying existing public APIs, always maintain backward compatibility to avoid breaking existing users. Breaking changes include altering function signatures, removing public functions, or changing function visibility from public to private.","repository":"vlang/v","domain":"runtimes","topic":"API","language":"Other","updated":"2025-01-18","comments":3,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-avoid-breaking-api-changes.md"},{"slug":"electron-descriptive-error-messages","title":"Descriptive error messages","description":"Error messages should be descriptive, contextual, and self-identifying to aid debugging and user understanding. Include relevant context like method names, parameter values, or identifiers that help locate the source of the error.","repository":"electron/electron","domain":"devtools","topic":"Error Handling","language":"Other","updated":"2025-01-17","comments":5,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-descriptive-error-messages.md"},{"slug":"influxdb-handle-errors-by-criticality","title":"Handle errors by criticality","description":"Choose error handling strategies based on operation criticality:\\n\\n\\ 1. For critical operations that could corrupt data or state:\\n   - Use assertions/panics\\ \\ to fail fast","repository":"influxdata/influxdb","domain":"data-systems","topic":"Error Handling","language":"Rust","updated":"2025-01-17","comments":5,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-handle-errors-by-criticality.md"},{"slug":"influxdb-avoid-flaky-test-patterns","title":"Avoid flaky test patterns","description":"Write reliable tests by avoiding common patterns that can lead to flaky behavior. Specifically: 1. Avoid arbitrary timeouts and sleeps in tests. Instead, use proper test infrastructure or wait for specific conditions.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Testing","language":"Rust","updated":"2025-01-17","comments":4,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-avoid-flaky-test-patterns.md"},{"slug":"tree-sitter-optimize-ci-workflow-syntax","title":"Optimize CI workflow syntax","description":"Write cleaner and more maintainable CI/CD workflows by following established syntax patterns and best practices. Use GitHub Actions' built-in features like `working-directory` instead of manual directory changes, employ proper shell quoting and efficient commands, and prefer single-line commands when appropriate.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"CI/CD","language":"Yaml","updated":"2025-01-17","comments":4,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-optimize-ci-workflow-syntax.md"},{"slug":"mastodon-extract-view-complexity","title":"Extract view complexity","description":"Keep views clean and readable by extracting complex logic to appropriate locations. Move database queries with complex conditions to model scopes, extract reusable form fields to partials, and move complex conditional logic to helper methods.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Code Style","language":"Other","updated":"2025-01-17","comments":3,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-extract-view-complexity.md"},{"slug":"lmcache-simplify-configuration-interfaces","title":"Simplify configuration interfaces","description":"Design configuration interfaces that prioritize user experience by providing sensible defaults, using clear naming conventions, and logically grouping related options. Complex tools with many configuration parameters should minimize the cognitive load on users through thoughtful interface design.","repository":"LMCache/LMCache","domain":"llm-infra","topic":"Configurations","language":"Markdown","updated":"2025-01-17","comments":2,"stars":3800,"raw":"https://awesomereviewers.com/raw/lmcache-simplify-configuration-interfaces.md"},{"slug":"db-gpt-robust-llm-integration","title":"Robust LLM Integration","description":"When integrating LLMs/embeddings into production code, treat the model as unreliable: enforce a stable IO contract (especially JSON), validate and safely recover from format mismatches, and route model calls through the project’s unified abstractions with configurable parameters.","repository":"eosphoros-ai/DB-GPT","domain":"ai-agents","topic":"AI","language":"Python","updated":"2025-01-16","comments":6,"stars":18703,"raw":"https://awesomereviewers.com/raw/db-gpt-robust-llm-integration.md"},{"slug":"db-gpt-catch-expected-exceptions","title":"Catch Expected Exceptions","description":"When handling failures, avoid broad try/except that hides root causes. Catch only the exceptions you expect, log a warning (with enough context to debug), and preserve the original error/stack trace. For unsupported/unimplemented functionality or dependency/version mismatches, fail explicitly with clear, actionable error messages.","repository":"eosphoros-ai/DB-GPT","domain":"ai-agents","topic":"Error Handling","language":"Python","updated":"2025-01-16","comments":5,"stars":18703,"raw":"https://awesomereviewers.com/raw/db-gpt-catch-expected-exceptions.md"},{"slug":"maplibre-native-configure-platform-specific-builds","title":"Configure platform-specific builds","description":"Ensure build and distribution configurations are properly documented and optimized for each target platform. For cross-platform projects, explicitly document which configuration flags are needed for different build scenarios and package manager integrations.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Configurations","language":"Markdown","updated":"2025-01-16","comments":4,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-configure-platform-specific-builds.md"},{"slug":"openpilot-prefer-asynchronous-operations","title":"Prefer asynchronous operations","description":"Use asynchronous patterns to prevent blocking operations from degrading system performance, especially in UI contexts and real-time systems. Prefer higher-level async abstractions like std::future over manual thread management when possible, as they provide automatic thread management, better exception handling, and simpler code maintenance.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Concurrency","language":"Other","updated":"2025-01-16","comments":4,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-prefer-asynchronous-operations.md"},{"slug":"react-native-eliminate-unnecessary-computations","title":"Eliminate unnecessary computations","description":"Identify and remove redundant operations, unnecessary copies, and repeated computations that add algorithmic overhead without providing value. This includes avoiding redundant hash operations, using const references instead of copies, implementing memoization for expensive lookups, and making conscious space-time tradeoffs.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Algorithms","language":"Other","updated":"2025-01-16","comments":4,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-eliminate-unnecessary-computations.md"},{"slug":"svelte-simplify-and-deduplicate-code","title":"Simplify and deduplicate code","description":"Write concise, non-redundant code by eliminating unnecessary duplication and using simpler syntax where possible. This improves readability and maintainability.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2025-01-16","comments":4,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-simplify-and-deduplicate-code.md"},{"slug":"typescript-consistent-message-terminology","title":"Consistent message terminology","description":"Use clear, consistent terminology in all error messages and user-facing text. Avoid technical jargon that might confuse users, and maintain consistency in language patterns across the codebase:","repository":"microsoft/typescript","domain":"runtimes","topic":"Naming Conventions","language":"Json","updated":"2025-01-16","comments":2,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-consistent-message-terminology.md"},{"slug":"workers-sdk-maintain-clean-project-structure","title":"maintain clean project structure","description":"Keep your codebase organized and clutter-free by removing unnecessary files, directories, and artifacts that serve no functional purpose. When tools have compatibility issues with certain file types, configure appropriate ignore patterns rather than leaving problematic files to cause confusion or errors.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Code Style","language":"Other","updated":"2025-01-16","comments":2,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-maintain-clean-project-structure.md"},{"slug":"v-document-cryptographic-requirements","title":"Document cryptographic requirements","description":"Security-critical functions, especially those involving cryptographic operations, must include clear and accurate documentation about their security requirements and assumptions. This is essential for preventing misuse that could lead to vulnerabilities.","repository":"vlang/v","domain":"runtimes","topic":"Security","language":"Other","updated":"2025-01-16","comments":1,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-document-cryptographic-requirements.md"},{"slug":"v-explicit-cryptographic-parameters","title":"explicit cryptographic parameters","description":"Always explicitly specify security-critical parameters in cryptographic operations rather than relying on default values. This prevents vulnerabilities that could arise from misunderstood defaults or future changes to default behavior.","repository":"vlang/v","domain":"runtimes","topic":"Security","language":"Markdown","updated":"2025-01-16","comments":1,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-explicit-cryptographic-parameters.md"},{"slug":"express-standardize-dependency-version-notation","title":"Standardize dependency version notation","description":"When specifying dependencies in package.json, follow consistent version notation patterns that align with your project''s stability and compatibility requirements:","repository":"expressjs/express","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2025-01-15","comments":7,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-standardize-dependency-version-notation.md"},{"slug":"db-gpt-null-safe-data-access","title":"Null-Safe Data Access","description":"Write code so nullable/missing data can’t cause runtime errors. Apply these rules: 1) Declare nullability in types - If a parameter or field defaults to `None`, type it as `Optional[...]`.","repository":"eosphoros-ai/DB-GPT","domain":"ai-agents","topic":"Null Handling","language":"Python","updated":"2025-01-15","comments":6,"stars":18703,"raw":"https://awesomereviewers.com/raw/db-gpt-null-safe-data-access.md"},{"slug":"poetry-complete-config-setting-integration","title":"Complete config setting integration","description":"When adding new configuration settings, ensure they are properly integrated across all required system components. Configuration settings must be registered in multiple locations to function correctly and be discoverable by users.","repository":"python-poetry/poetry","domain":"devtools","topic":"Configurations","language":"Python","updated":"2025-01-15","comments":4,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-complete-config-setting-integration.md"},{"slug":"pydantic-structured-configuration-management","title":"Structured configuration management","description":"Configuration files should follow official standards, have up-to-date tool settings, and appropriate dependency constraints. This ensures consistent behavior across environments and compatibility with the project's requirements.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Configurations","language":"Toml","updated":"2025-01-15","comments":3,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-structured-configuration-management.md"},{"slug":"pydantic-avoid-shared-structure-mutation","title":"Avoid shared structure mutation","description":"When implementing algorithms that manipulate complex nested data structures, avoid directly mutating shared objects that might be referenced elsewhere in the system. Mutations can lead to unexpected side effects and hard-to-trace bugs, particularly when the same structure is referenced in multiple places.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Algorithms","language":"Python","updated":"2025-01-15","comments":2,"stars":24364,"raw":"https://awesomereviewers.com/raw/pydantic-avoid-shared-structure-mutation.md"},{"slug":"influxdb-use-testify-assertions","title":"Use testify assertions","description":"Always use the testify package (require/assert) in tests instead of standard Go testing assertions. The testify library provides more descriptive failure messages that make debugging test failures easier and faster.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Testing","language":"Go","updated":"2025-01-14","comments":7,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-use-testify-assertions.md"},{"slug":"chef-document-configuration-decisions","title":"Document configuration decisions","description":"Add clear comments explaining the rationale behind configuration decisions, especially for workarounds, compatibility fixes, or environment-specific settings. This helps future maintainers understand why certain configurations exist and prevents accidental removal of necessary settings during refactoring.","repository":"chef/chef","domain":"cloud-infra","topic":"Configurations","language":"Yaml","updated":"2025-01-14","comments":4,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-document-configuration-decisions.md"},{"slug":"maplibre-native-extract-workflow-scripts","title":"Extract workflow scripts","description":"Move complex scripts out of workflow YAML files into separate, dedicated script files in your repository. This practice significantly improves workflow maintainability, enables local testing of CI logic, and makes code reviews more effective.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2025-01-14","comments":4,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-extract-workflow-scripts.md"},{"slug":"maplibre-native-standard-configuration-files","title":"Standard configuration files","description":"Use standardized, tool-specific configuration files instead of embedding configurations in CI scripts or other build files. This improves discoverability, ensures consistency between local development and CI environments, and provides self-documentation for required settings.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Configurations","language":"Yaml","updated":"2025-01-14","comments":2,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-standard-configuration-files.md"},{"slug":"turborepo-design-for-testability","title":"Design for testability","description":"Extract complex logic into separate, pure functions to improve testability. Functions with clear inputs and outputs are easier to test in isolation without complex mocking or setup.","repository":"vercel/turborepo","domain":"devtools","topic":"Testing","language":"TypeScript","updated":"2025-01-14","comments":2,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-design-for-testability.md"},{"slug":"v-use-prod-for-performance","title":"use `-prod` for performance","description":"Always use the `-prod` compiler flag when building performance-critical code or running benchmarks. The `-prod` flag automatically enables essential optimization settings including `-O3` and `-flto` (Link Time Optimization), eliminating the need to manually specify these common performance flags.","repository":"vlang/v","domain":"runtimes","topic":"Performance Optimization","language":"Markdown","updated":"2025-01-14","comments":2,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-use-prod-for-performance.md"},{"slug":"vitess-manage-workflow-state-transitions","title":"Manage workflow state transitions","description":"When working with temporal workflows, always implement explicit state transitions rather than abrupt deletions. Workflows should proceed through well-defined states (like running, stopped, or frozen) to ensure proper lifecycle management and durable execution.","repository":"vitessio/vitess","domain":"data-systems","topic":"Temporal","language":"Go","updated":"2025-01-14","comments":2,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-manage-workflow-state-transitions.md"},{"slug":"tokio-organize-code-logically","title":"Organize code logically","description":"Group related code elements together with a consistent and logical structure. Place stable fields and functionality first, followed by conditional or unstable features.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Code Style","language":"Rust","updated":"2025-01-13","comments":6,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-organize-code-logically.md"},{"slug":"jan-cross-platform-configuration-simplification","title":"Cross-platform configuration simplification","description":"When writing configuration files and scripts, prioritize cross-platform compatibility while keeping configurations simple and maintainable. Use platform-aware tools like `run-script-os` for npm scripts that need platform-specific behavior, but prefer built-in solutions and global defaults over complex custom configurations.","repository":"menloresearch/jan","domain":"llm-infra","topic":"Configurations","language":"Json","updated":"2025-01-13","comments":4,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-cross-platform-configuration-simplification.md"},{"slug":"kong-api-surface-compatibility","title":"API surface compatibility","description":"Treat any change to a public interface (PDK function signatures, plugin config/schema fields, or other externally-consumed API contracts) as a compatibility commitment.","repository":"Kong/kong","domain":"cloud-infra","topic":"API","language":"Other","updated":"2025-01-13","comments":4,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-api-surface-compatibility.md"},{"slug":"rails-content-security-policy-configuration","title":"Content security policy configuration","description":"Implement Content Security Policy (CSP) configurations appropriately for your application's context. Use report-only mode during implementation to avoid breaking functionality while testing policies.","repository":"rails/rails","domain":"app-frameworks","topic":"Security","language":"Ruby","updated":"2025-01-13","comments":4,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-content-security-policy-configuration.md"},{"slug":"unstructured-prefer-efficient-operations","title":"prefer efficient operations","description":"Choose efficient operations and algorithms over expensive alternatives, particularly when processing data or performing file operations. Avoid operations that create unnecessary intermediate objects or make repeated system calls when vectorized or batch operations are available.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Performance Optimization","language":"Python","updated":"2025-01-13","comments":3,"stars":12116,"raw":"https://awesomereviewers.com/raw/unstructured-prefer-efficient-operations.md"},{"slug":"vite-targeted-yet-comprehensive","title":"Targeted yet comprehensive","description":"Write focused tests that verify specific functionality without unnecessary setup, while still ensuring complete coverage of edge cases. Instead of duplicating complex structures, create minimal test cases that target individual features directly.","repository":"vitejs/vite","domain":"devtools","topic":"Testing","language":"JavaScript","updated":"2025-01-13","comments":2,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-targeted-yet-comprehensive.md"},{"slug":"vitess-document-configuration-precedence","title":"Document configuration precedence","description":"When implementing multiple configuration methods (e.g., config files, command-line flags, environment variables), clearly document the precedence order and warn users about potential conflicts. Unclear precedence rules can lead to unexpected system behavior and difficult troubleshooting.","repository":"vitessio/vitess","domain":"data-systems","topic":"Configurations","language":"Txt","updated":"2025-01-13","comments":2,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-document-configuration-precedence.md"},{"slug":"prowler-fix-dependency-vulnerabilities","title":"Fix dependency vulnerabilities","description":"Security vulnerabilities in dependencies must be addressed immediately rather than bypassed with flags like `--no-verify`. When security scans identify vulnerabilities in libraries like the one detected in pyjwt:","repository":"prowler-cloud/prowler","domain":"security","topic":"Security","language":"Yaml","updated":"2025-01-13","comments":1,"stars":11834,"raw":"https://awesomereviewers.com/raw/prowler-fix-dependency-vulnerabilities.md"},{"slug":"poetry-explicit-null-handling","title":"Explicit null handling","description":"Use explicit and clear patterns when handling null/None values to improve code readability and maintainability. Avoid complex conditional expressions, unnecessary type casting, and ambiguous nullable types.","repository":"python-poetry/poetry","domain":"devtools","topic":"Null Handling","language":"Python","updated":"2025-01-12","comments":8,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-explicit-null-handling.md"},{"slug":"langchainjs-throw-meaningful-errors","title":"Throw meaningful errors","description":"Always throw specific, actionable errors instead of returning unexpected values or simply logging issues. Error messages should be clear, concise, and contain the exact reason for failure without redundancy.","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Error Handling","language":"TypeScript","updated":"2025-01-12","comments":5,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-throw-meaningful-errors.md"},{"slug":"brew-fail-with-messages","title":"Fail with messages","description":"Functions and scripts should never fail silently. When detecting error conditions, always provide clear error messages to stderr that include context about what failed and why, then return an appropriate non-zero exit code. For user-facing commands, include guidance about correct usage when applicable.","repository":"Homebrew/brew","domain":"devtools","topic":"Error Handling","language":"Shell","updated":"2025-01-12","comments":3,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-fail-with-messages.md"},{"slug":"dspy-preserve-thread-local-state","title":"preserve thread-local state","description":"When launching threads in DSPy, ensure that child threads inherit the parent thread's local overrides to maintain consistent behavior across concurrent executions. DSPy uses thread-local settings that must be properly propagated to avoid subtle runtime issues.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Concurrency","language":"Python","updated":"2025-01-12","comments":3,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-preserve-thread-local-state.md"},{"slug":"poetry-manage-testing-dependencies","title":"manage testing dependencies","description":"Ensure testing dependencies are properly organized, avoid redundancy, and proactively manage unmaintained packages. Place testing-specific dependencies in the correct dependency groups (e.g., `group.test.dependencies` rather than `group.dev.dependencies`). Before adding new testing libraries, verify that existing dependencies don't already provide the same...","repository":"python-poetry/poetry","domain":"devtools","topic":"Testing","language":"Toml","updated":"2025-01-12","comments":3,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-manage-testing-dependencies.md"},{"slug":"kong-consistent-early-exit-style","title":"Consistent Early-Exit Style","description":"When updating/adding code, prioritize readability and predictable control-flow: - Use early exits (return/goto/continue) for error/invalid states to avoid deep nesting/extra indentation.","repository":"Kong/kong","domain":"cloud-infra","topic":"Code Style","language":"Other","updated":"2025-01-11","comments":6,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-consistent-early-exit-style.md"},{"slug":"svelte-documentation-clarity-standards","title":"Documentation clarity standards","description":"Ensure technical documentation clearly distinguishes between similar but different concepts, uses precise language, and provides unambiguous explanations. When documenting Vue features, explicitly label and differentiate between reactive and non-reactive data, different directive behaviors, and component patterns.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Vue","language":"Markdown","updated":"2025-01-11","comments":4,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-documentation-clarity-standards.md"},{"slug":"comfyui-environment-variable-consistency","title":"Environment variable consistency","description":"Ensure consistent formatting and proper usage of environment variables in Dockerfiles. Remove unnecessary quotes from ENV declarations and choose between ARG and ENV based on their intended scope - use ARG for build-time configuration that may change between builds, and ENV for runtime configuration that containers need during execution.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Configurations","language":"Dockerfile","updated":"2025-01-11","comments":3,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-environment-variable-consistency.md"},{"slug":"unstructured-validate-configuration-defaults","title":"validate configuration defaults","description":"Configuration parameters should be properly validated with appropriate defaults and clear handling of edge cases. Avoid using arbitrary defaults when values should be explicitly required, and ensure configuration validation distinguishes between None, empty, and zero values.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Configurations","language":"Python","updated":"2025-01-10","comments":9,"stars":12116,"raw":"https://awesomereviewers.com/raw/unstructured-validate-configuration-defaults.md"},{"slug":"alacritty-explain-code-intent","title":"Explain code intent","description":"Comments and documentation should explain WHY code exists and what purpose it serves, not just describe what the code does. Focus on the reasoning, motivation, and intent behind implementation decisions.","repository":"alacritty/alacritty","domain":"devtools","topic":"Documentation","language":"Rust","updated":"2025-01-10","comments":8,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-explain-code-intent.md"},{"slug":"maplibre-native-structure-documentation-effectively","title":"Structure documentation effectively","description":"Documentation should prioritize clear organization with a logical flow to help developers find information quickly. Apply these practices: 1. Use descriptive headings and titles that directly communicate content purpose","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2025-01-10","comments":5,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-structure-documentation-effectively.md"},{"slug":"vite-break-down-complex-functions","title":"Break down complex functions","description":"Improve code readability and maintainability by decomposing large, complex functions into smaller, focused ones. When a function handles multiple responsibilities or becomes difficult to understand at a glance, extract logical parts into well-named helper functions.","repository":"vitejs/vite","domain":"devtools","topic":"Code Style","language":"TypeScript","updated":"2025-01-10","comments":4,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-break-down-complex-functions.md"},{"slug":"opencv-check-nulls-directly","title":"Check nulls directly","description":"Check objects directly for null/empty state instead of using separate tracking variables. Always perform null checks early in your functions, before entering resource-intensive blocks or operations that assume non-null values.","repository":"opencv/opencv","domain":"ml-systems","topic":"Null Handling","language":"Other","updated":"2025-01-10","comments":2,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-check-nulls-directly.md"},{"slug":"polars-redact-sensitive-credentials","title":"Redact sensitive credentials","description":"When implementing authentication or handling credentials, always redact sensitive information (keys, tokens, passwords) in logs and debug output. Using placeholder text like \"<redacted>\" or obfuscation techniques ensures credentials aren't accidentally exposed through logs, which could lead to security breaches.","repository":"pola-rs/polars","domain":"data-systems","topic":"Security","language":"Rust","updated":"2025-01-10","comments":1,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-redact-sensitive-credentials.md"},{"slug":"poetry-dependency-constraint-consistency","title":"dependency constraint consistency","description":"Maintain consistent formatting and rationale for dependency version constraints in configuration files. Use caret notation (`^1.0.0`) instead of range notation (`>=1,<2`) for cleaner syntax when specifying compatible version ranges. When constraining to specific Python versions, choose between explicit version strings (`\"3.7\"`) and comparison operators...","repository":"python-poetry/poetry","domain":"devtools","topic":"Configurations","language":"Toml","updated":"2025-01-09","comments":7,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-dependency-constraint-consistency.md"},{"slug":"langchainjs-comprehensive-ai-documentation","title":"Comprehensive AI documentation","description":"When documenting AI integrations, provide comprehensive examples that showcase all common initialization and usage patterns. Documentation should include:","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"AI","language":"Other","updated":"2025-01-09","comments":4,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-comprehensive-ai-documentation.md"},{"slug":"lobe-chat-dependency-version-management","title":"Dependency version management","description":"Use semantic versioning ranges for dependencies instead of \"latest\" or overly broad ranges. Avoid \"latest\" as it can cause caching issues during updates. Maintain minimum required version semantics to ensure compatibility - if your code requires features from version 4.4, specify \"^4.4\" rather than \"^4\" to prevent runtime errors when using tools like pnpm...","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Configurations","language":"Json","updated":"2025-01-08","comments":3,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-dependency-version-management.md"},{"slug":"rails-configure-at-proper-scope","title":"Configure at proper scope","description":"Place configuration options at their proper scope within the framework hierarchy. Avoid tight coupling between components and ensure user configurations aren't accidentally overridden.","repository":"rails/rails","domain":"app-frameworks","topic":"Configurations","language":"Ruby","updated":"2025-01-07","comments":7,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-configure-at-proper-scope.md"},{"slug":"influxdb-wrap-errors-with-context","title":"Wrap errors with context","description":"Always wrap errors with meaningful context using fmt.Errorf and %w verb. Include relevant identifiers (filenames, IDs, paths) in error messages to aid debugging. This helps pinpoint error sources and simplifies troubleshooting.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Error Handling","language":"Go","updated":"2025-01-07","comments":6,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-wrap-errors-with-context.md"},{"slug":"ncnn-header-hygiene-rules","title":"Header hygiene rules","description":"Keep headers “composition-safe” and minimal. Apply these rules: - **Do not define non-inline function implementations in headers.** Put the implementation in a `.cpp` file to avoid multiple-definition/linker problems.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Code Style","language":"Other","updated":"2025-01-07","comments":6,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-header-hygiene-rules.md"},{"slug":"svelte-complete-code-examples","title":"Complete code examples","description":"Ensure all code examples are complete, functional, and accurately demonstrate the intended concepts. Code examples should include all necessary imports, variable declarations, and interactive elements to be self-contained and runnable.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Code Style","language":"Markdown","updated":"2025-01-07","comments":4,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-complete-code-examples.md"},{"slug":"svelte-avoid-unclear-abbreviations","title":"avoid unclear abbreviations","description":"Use clear, descriptive names instead of abbreviated variable names that reduce code readability. Abbreviations like `mult` should be replaced with more conventional or descriptive alternatives. Additionally, maintain consistent naming conventions: use `snake_case` for internal code and `camelCase` for user-facing APIs.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Naming Conventions","language":"Markdown","updated":"2025-01-07","comments":2,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-avoid-unclear-abbreviations.md"},{"slug":"chef-externalize-configuration-values","title":"Externalize configuration values","description":"Avoid hardcoding configuration values directly in scripts, especially for values that might change between environments or contain sensitive information. Instead, use environment variables, build parameters, or secrets management systems.","repository":"chef/chef","domain":"cloud-infra","topic":"Configurations","language":"Shell","updated":"2025-01-06","comments":6,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-externalize-configuration-values.md"},{"slug":"chef-prefer-guard-clauses","title":"Prefer guard clauses","description":"Use guard clauses with early returns for null checking instead of wrapping code in conditional blocks. This improves readability by reducing nesting and making the code's \"happy path\" more evident.","repository":"chef/chef","domain":"cloud-infra","topic":"Null Handling","language":"Ruby","updated":"2025-01-06","comments":5,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-prefer-guard-clauses.md"},{"slug":"tokio-document-null-safety-assumptions","title":"Document null safety assumptions","description":"When writing code that handles potentially null, undefined, or uninitialized values, always document safety assumptions with clear comments. This is especially important for unsafe blocks that manipulate raw pointers, uninitialized memory, or perform type conversions.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Null Handling","language":"Rust","updated":"2025-01-06","comments":4,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-document-null-safety-assumptions.md"},{"slug":"openpilot-standardize-configuration-approaches","title":"Standardize configuration approaches","description":"When documenting or implementing configuration procedures, prioritize standard, unified approaches over custom or platform-specific solutions. This applies to setup scripts, environment activation, and configuration management.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Configurations","language":"Markdown","updated":"2025-01-06","comments":3,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-standardize-configuration-approaches.md"},{"slug":"turborepo-framework-specific-entrypoints-organization","title":"Framework-specific entrypoints organization","description":"When creating libraries that integrate with Next.js or other frameworks, organize your code with separate entrypoints for each supported framework. This approach improves bundling efficiency, prevents dependency conflicts, and makes framework-specific code easier to maintain.","repository":"vercel/turborepo","domain":"devtools","topic":"Next","language":"Other","updated":"2025-01-06","comments":2,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-framework-specific-entrypoints-organization.md"},{"slug":"unstructured-parameterize-hardcoded-configuration-values","title":"Parameterize hardcoded configuration values","description":"Replace hardcoded values in configuration files with parameterized variables to improve flexibility and maintainability. Use build arguments (ARG) and environment variables (ENV) in Dockerfiles instead of embedding specific versions, paths, or other configuration values directly in the code.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Configurations","language":"Dockerfile","updated":"2025-01-06","comments":2,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-parameterize-hardcoded-configuration-values.md"},{"slug":"fastapi-consistent-dependency-versioning","title":"Consistent dependency versioning","description":"When updating dependency version constraints in requirements files, ensure consistency with versions pinned by other dependencies in your project. Check what versions are used by major dependent packages before setting your own constraints to avoid compatibility issues.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Configurations","language":"Txt","updated":"2025-01-05","comments":2,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-consistent-dependency-versioning.md"},{"slug":"tree-sitter-strategic-configuration-exclusions","title":"Strategic configuration exclusions","description":"When configuring build exclusions in package manifests or configuration files, be strategic and minimal. Only exclude files that cause actual build issues (like non-source files that generate compilation warnings), while preserving important files such as licenses and directories that may be relevant for future features. Modern tooling often handles file...","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Configurations","language":"Swift","updated":"2025-01-04","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-strategic-configuration-exclusions.md"},{"slug":"vitess-consistent-database-apis","title":"Consistent database APIs","description":"Design database APIs with consistent patterns for response structures and error handling. Follow established conventions in your codebase, even when it means returning empty response objects for error-only operations.","repository":"vitessio/vitess","domain":"data-systems","topic":"Database","language":"Other","updated":"2025-01-04","comments":2,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-consistent-database-apis.md"},{"slug":"tree-sitter-use-descriptive-identifiers","title":"Use descriptive identifiers","description":"Choose identifiers that clearly communicate their purpose, content, or role rather than using generic or abbreviated names. Names should be self-documenting and reduce the need to reference documentation or implementation details to understand what they represent.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Naming Conventions","language":"Rust","updated":"2025-01-03","comments":5,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-use-descriptive-identifiers.md"},{"slug":"influxdb-include-explanatory-examples","title":"Include explanatory examples","description":"Always enhance documentation with concrete, illustrative examples that demonstrate expected inputs, formats, or outputs. Examples significantly improve comprehension and reduce ambiguity, especially for complex parameters, commands, or return values.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Documentation","language":"Rust","updated":"2025-01-03","comments":4,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-include-explanatory-examples.md"},{"slug":"logseq-separate-user-system-data","title":"Separate user system data","description":"Separate user-facing data from system/implementation data using proper namespacing and schema design to prevent data pollution and improve user experience.","repository":"logseq/logseq","domain":"app-frameworks","topic":"Database","language":"Other","updated":"2025-01-03","comments":4,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-separate-user-system-data.md"},{"slug":"tree-sitter-provide-clear-error-context","title":"Provide clear error context","description":"Always provide meaningful, specific error messages that help users understand what went wrong and why. Use descriptive language that indicates what was expected versus what was encountered. Leverage error context tools like `with_context()` to add relevant information about the operation that failed, and use debug formatting for error display to show...","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Error Handling","language":"Rust","updated":"2025-01-03","comments":4,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-provide-clear-error-context.md"},{"slug":"alacritty-follow-metadata-specifications","title":"Follow metadata specifications","description":"When writing metadata files (such as AppStream, package manifests, or configuration files), always consult and follow the official specifications precisely. Pay special attention to case-sensitive identifiers, valid values, and required formats.","repository":"alacritty/alacritty","domain":"devtools","topic":"Documentation","language":"Xml","updated":"2025-01-03","comments":3,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-follow-metadata-specifications.md"},{"slug":"material-ui-effect-hook-best-practices","title":"Effect hook best practices","description":"When using React effect hooks, follow these practices to ensure predictable behavior and prevent memory leaks: 1. **Use stable dependency arrays**: Create a reusable constant for empty dependency arrays rather than creating a new array on each render.","repository":"mui/material-ui","domain":"app-frameworks","topic":"React","language":"TypeScript","updated":"2025-01-03","comments":3,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-effect-hook-best-practices.md"},{"slug":"stagehand-abstract-environment-variables","title":"abstract environment variables","description":"Avoid directly referencing environment variables throughout your codebase. Instead, abstract them into named constants with sensible defaults at module boundaries. This improves readability, makes configuration explicit, and prevents scattered environment variable access.","repository":"browserbase/stagehand","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2025-01-03","comments":3,"stars":16443,"raw":"https://awesomereviewers.com/raw/stagehand-abstract-environment-variables.md"},{"slug":"stagehand-configure-workflow-triggers","title":"Configure workflow triggers","description":"Ensure GitHub Actions workflows are triggered appropriately by configuring branch patterns and path filters to balance CI efficiency with comprehensive coverage. Workflows should run on all relevant branches (not just main) while using path filters to avoid unnecessary executions.","repository":"browserbase/stagehand","domain":"ai-agents","topic":"CI/CD","language":"Yaml","updated":"2025-01-03","comments":3,"stars":16443,"raw":"https://awesomereviewers.com/raw/stagehand-configure-workflow-triggers.md"},{"slug":"boto3-use-appropriate-comment-syntax","title":"Use appropriate comment syntax","description":"Choose the correct comment syntax based on the file type and processing system to ensure documentation serves its intended purpose. For template files (like Jinja), use template-specific comments rather than HTML comments to prevent documentation from appearing in rendered output. Always include explanatory comments for files that might seem unnecessary but...","repository":"boto/boto3","domain":"cloud-infra","topic":"Documentation","language":"Html","updated":"2025-01-03","comments":2,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-use-appropriate-comment-syntax.md"},{"slug":"hyprland-avoid-unintentional-defaults","title":"Avoid unintentional defaults","description":"When designing configuration interfaces, be intentional about default values and consider their impact on user behavior and data quality. Avoid defaults that users might unconsciously accept without proper consideration, especially for critical settings.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Configurations","language":"Yaml","updated":"2025-01-03","comments":2,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-avoid-unintentional-defaults.md"},{"slug":"mastodon-minimize-html-attack-surface","title":"Minimize HTML attack surface","description":"When allowing HTML attributes or rendering user-generated content, explicitly limit the attack surface by restricting allowed properties to a minimal, vetted set rather than permitting broad categories of attributes.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Security","language":"Ruby","updated":"2025-01-03","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-minimize-html-attack-surface.md"},{"slug":"volcano-resource-specific-optimization-factors","title":"Resource-specific optimization factors","description":"Configure different optimization parameters for different resource types (CPU, memory, GPU) rather than applying uniform settings across all resources. Different resources have distinct characteristics and usage patterns that require tailored optimization strategies for maximum performance and utilization.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Performance Optimization","language":"Markdown","updated":"2025-01-03","comments":2,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-resource-specific-optimization-factors.md"},{"slug":"db-gpt-performance-guardrails","title":"Performance Guardrails","description":"When implementing knowledge-graph storage/search, proactively prevent expensive work and payload bloat by following these rules: 1) Minimize returned payloads (especially vectors)","repository":"eosphoros-ai/DB-GPT","domain":"ai-agents","topic":"Performance Optimization","language":"Python","updated":"2025-01-02","comments":5,"stars":18703,"raw":"https://awesomereviewers.com/raw/db-gpt-performance-guardrails.md"},{"slug":"langchainjs-consistent-naming-conventions","title":"Consistent naming conventions","description":"Maintain consistent and explicit naming conventions across your codebase that reflect: 1. **Component dependencies**: Class/function names should explicitly indicate their external dependencies and integrations to improve clarity and avoid confusion.","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Naming Conventions","language":"Other","updated":"2025-01-02","comments":3,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-consistent-naming-conventions.md"},{"slug":"workers-sdk-eliminate-redundant-null-checks","title":"eliminate redundant null checks","description":"Remove unnecessary null/undefined checks when you already have sufficient validation in place, and use proper type guards instead of type assertions for better null safety.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Null Handling","language":"TypeScript","updated":"2025-01-02","comments":3,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-eliminate-redundant-null-checks.md"},{"slug":"hyprland-explain-documentation-rationale","title":"Explain documentation rationale","description":"When writing user-facing documentation, always explain WHY a guideline or requirement exists, not just WHAT users should do. Users are more likely to follow instructions when they understand the reasoning behind them.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Documentation","language":"Yaml","updated":"2025-01-02","comments":2,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-explain-documentation-rationale.md"},{"slug":"tokio-optimize-ci-job-structure","title":"Optimize CI job structure","description":"Structure your CI workflows to maximize performance and clarity. Each job should have a single, clear responsibility with these guidelines: 1. **One toolchain per job**: Keep jobs focused with a single Rust toolchain version per job. Multiple toolchains in one job create confusion about which version is being used for each command.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"CI/CD","language":"Yaml","updated":"2025-01-01","comments":3,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-optimize-ci-job-structure.md"},{"slug":"tokio-optimize-job-structure","title":"Optimize job structure","description":"Structure CI jobs for clarity, parallelism, and efficiency. Each job should have a single, well-defined purpose to prevent confusion about which tools and versions are being used.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"CI/CD","language":"Yaml","updated":"2025-01-01","comments":3,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-optimize-job-structure.md"},{"slug":"sonic-optimize-algorithms-by-characteristics","title":"optimize algorithms by characteristics","description":"When implementing algorithms, make optimization decisions based on the specific characteristics of your data types and usage patterns rather than using generic approaches. Consider factors like type semantics, memory layout, and processing requirements to choose the most appropriate algorithmic strategy.","repository":"bytedance/sonic","domain":"runtimes","topic":"Algorithms","language":"Go","updated":"2024-12-31","comments":3,"stars":8532,"raw":"https://awesomereviewers.com/raw/sonic-optimize-algorithms-by-characteristics.md"},{"slug":"developer-roadmap-manage-generated-configs","title":"Manage Generated Configs","description":"When working with configuration JSON files, treat them as tool- and schema-backed artifacts: - **Never manually edit auto-generated configuration/content files.** If a change is required, update the generator/template or revert the diff.","repository":"kamranahmedse/developer-roadmap","domain":"docs","topic":"Configurations","language":"Json","updated":"2024-12-30","comments":3,"stars":354523,"raw":"https://awesomereviewers.com/raw/developer-roadmap-manage-generated-configs.md"},{"slug":"firecrawl-avoid-async-race-conditions","title":"Avoid async race conditions","description":"Ensure proper async/await handling and consider concurrent execution patterns to prevent race conditions and improve performance. When working with asynchronous operations, always use await for promises and avoid mixing promise chains with async/await syntax. Additionally, identify opportunities to run independent operations concurrently rather than...","repository":"firecrawl/firecrawl","domain":"ai-agents","topic":"Concurrency","language":"TypeScript","updated":"2024-12-30","comments":2,"stars":54535,"raw":"https://awesomereviewers.com/raw/firecrawl-avoid-async-race-conditions.md"},{"slug":"django-transaction-aware-task-enqueuing","title":"Transaction-aware task enqueuing","description":"When working with background tasks that depend on database changes, ensure tasks are enqueued only after the related transaction has successfully committed. This prevents tasks from operating on uncommitted or rolled-back data, avoiding race conditions and inconsistent states.","repository":"django/django","domain":"app-frameworks","topic":"Celery","language":"Txt","updated":"2024-12-28","comments":3,"stars":84182,"raw":"https://awesomereviewers.com/raw/django-transaction-aware-task-enqueuing.md"},{"slug":"tree-sitter-api-pattern-consistency","title":"API pattern consistency","description":"When designing new API functions, maintain consistent patterns across the codebase and avoid creating precedents that lead to function proliferation or inconsistent interfaces. Consider how the design will scale to similar use cases and whether it aligns with existing API conventions.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"API","language":"Other","updated":"2024-12-28","comments":3,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-api-pattern-consistency.md"},{"slug":"firecrawl-preserve-raw-network-data","title":"preserve raw network data","description":"Always preserve raw network response data early in the processing pipeline before applying any transformations or parsing. Once network data is processed or encoded, critical information may be permanently lost and cannot be recovered later.","repository":"firecrawl/firecrawl","domain":"ai-agents","topic":"Networking","language":"TypeScript","updated":"2024-12-28","comments":2,"stars":54535,"raw":"https://awesomereviewers.com/raw/firecrawl-preserve-raw-network-data.md"},{"slug":"tree-sitter-measure-performance-implications","title":"measure performance implications","description":"When making design decisions that could impact performance, evaluate resource implications and provide concrete measurements rather than assumptions. Consider memory usage, binary size, and allocation patterns in your choices.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Performance Optimization","language":"Other","updated":"2024-12-28","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-measure-performance-implications.md"},{"slug":"framework-escape-column-names-properly","title":"Escape column names properly","description":"Always use the appropriate wrapping/escaping mechanism when generating SQL to prevent syntax errors and SQL injection vulnerabilities, especially when handling:","repository":"laravel/framework","domain":"app-frameworks","topic":"Database","language":"PHP","updated":"2024-12-27","comments":5,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-escape-column-names-properly.md"},{"slug":"gin-descriptive-idiomatic-identifiers","title":"Descriptive idiomatic identifiers","description":"Use descriptive names for variables, types, and interfaces that follow Go language idioms. Avoid single-letter variables or cryptic abbreviations that reduce code readability.","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"Naming Conventions","language":"Go","updated":"2024-12-27","comments":4,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-descriptive-idiomatic-identifiers.md"},{"slug":"volcano-use-descriptive-consistent-naming","title":"Use descriptive consistent naming","description":"Choose names that are self-explanatory, descriptive, and consistent across the codebase. Avoid abbreviated or informal naming that requires additional explanation. Follow language-specific conventions and include units or data types where appropriate.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Naming Conventions","language":"Markdown","updated":"2024-12-26","comments":5,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-use-descriptive-consistent-naming.md"},{"slug":"drizzle-orm-consistent-naming-patterns","title":"consistent naming patterns","description":"Maintain consistent naming conventions across similar constructs in your codebase. This includes using consistent prefixes for related methods and following established patterns for file imports and extensions.","repository":"drizzle-team/drizzle-orm","domain":"data-systems","topic":"Naming Conventions","language":"TypeScript","updated":"2024-12-26","comments":2,"stars":29461,"raw":"https://awesomereviewers.com/raw/drizzle-orm-consistent-naming-patterns.md"},{"slug":"waveterm-config-hygiene","title":"config hygiene","description":"Keep repository configuration files canonical, documented, and free of personal workspace/debug artifacts. Why: Config files determine runtime behavior and developer onboarding. Committing personal IDE or temporary debug configs pollutes the repo, causes accidental formatting/behavior differences, and hides the canonical way to run the app. Likewise,...","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Configurations","language":"Json","updated":"2024-12-26","comments":2,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-config-hygiene.md"},{"slug":"fiber-prefer-existing-apis","title":"prefer existing APIs","description":"When adding new functionality, prioritize reusing existing methods and interfaces rather than creating new ones. This maintains API consistency, reduces cognitive load for developers, and prevents unnecessary duplication.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"API","language":"Go","updated":"2024-12-23","comments":6,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-prefer-existing-apis.md"},{"slug":"prometheus-force-re-sign-darwin-binaries","title":"Force re-sign Darwin binaries","description":"When building binaries for macOS (Darwin), always force re-sign them to prevent compatibility issues caused by pre-existing signatures. Use the `--force` flag with codesign to overwrite any existing signatures that might interfere with binary execution.","repository":"prometheus/prometheus","domain":"observability","topic":"Security","language":"Other","updated":"2024-12-23","comments":1,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-force-re-sign-darwin-binaries.md"},{"slug":"alacritty-avoid-unnecessary-operations","title":"avoid unnecessary operations","description":"Eliminate redundant work by implementing early returns, avoiding unnecessary clones/references, and skipping computations when results won't be used. This fundamental optimization reduces CPU cycles and improves performance across hot code paths.","repository":"alacritty/alacritty","domain":"devtools","topic":"Performance Optimization","language":"Rust","updated":"2024-12-22","comments":5,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-avoid-unnecessary-operations.md"},{"slug":"opencv-prevent-null-vulnerabilities","title":"Prevent null vulnerabilities","description":"Use container classes and smart pointers instead of manual memory allocation to prevent null pointer dereferences and memory leaks. **Instead of raw memory allocation:**","repository":"opencv/opencv","domain":"ml-systems","topic":"Null Handling","language":"C++","updated":"2024-12-21","comments":6,"stars":82865,"raw":"https://awesomereviewers.com/raw/opencv-prevent-null-vulnerabilities.md"},{"slug":"chef-explicit-configuration-over-implicit","title":"Explicit configuration over implicit","description":"Always define explicit configuration defaults rather than relying on implicit behavior or autovivification. Configuration values should: 1. Use explicit nil defaults instead of undefined values","repository":"chef/chef","domain":"cloud-infra","topic":"Configurations","language":"Ruby","updated":"2024-12-20","comments":5,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-explicit-configuration-over-implicit.md"},{"slug":"mastodon-optimize-test-organization","title":"optimize test organization","description":"Organize tests to minimize factory creation, reduce duplication, and improve performance by chaining assertions and extracting common values. **Key practices:**","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Testing","language":"Ruby","updated":"2024-12-20","comments":4,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-optimize-test-organization.md"},{"slug":"query-avoid-subscription-race-windows","title":"Avoid subscription race windows","description":"When code derives state from an external cache/store (or wraps promises), treat subscription setup and promise resolution as concurrent events. Ensure your implementation is race-safe and doesn’t use stale inputs.","repository":"tanstack/query","domain":"app-frameworks","topic":"Concurrency","language":"TypeScript","updated":"2024-12-20","comments":4,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-avoid-subscription-race-windows.md"},{"slug":"waveterm-synchronize-resource-claims","title":"Synchronize resource claims","description":"When asynchronous operations cross process or component boundaries (backend <> frontend, websocket events, UI lifecycle), design explicit synchronization instead of relying on ad-hoc timing. Apply these rules:","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Concurrency","language":"TypeScript","updated":"2024-12-20","comments":3,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-synchronize-resource-claims.md"},{"slug":"polars-cross-platform-feature-flags","title":"Cross-platform feature flags","description":"When documenting package installation commands with feature flags, ensure compatibility across different operating systems. Windows handles quoted package specifications differently than Unix-based systems, which can lead to installation failures.","repository":"pola-rs/polars","domain":"data-systems","topic":"Configurations","language":"Markdown","updated":"2024-12-20","comments":2,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-cross-platform-feature-flags.md"},{"slug":"sonic-numeric-api-completeness","title":"Numeric API completeness","description":"When designing APIs that handle numeric values, ensure comprehensive support for different integer types (Int64, Uint64) based on range requirements and use case needs. Consider practical constraints such as migration costs and legacy system compatibility when deciding between unified or separate configuration options.","repository":"bytedance/sonic","domain":"runtimes","topic":"API","language":"Go","updated":"2024-12-20","comments":2,"stars":8532,"raw":"https://awesomereviewers.com/raw/sonic-numeric-api-completeness.md"},{"slug":"inbox-zero-quote-shell-substitutions","title":"Quote shell substitutions","description":"Always enclose command substitutions in double quotes when assigning to variables or using in shell scripts to prevent word splitting vulnerabilities. Unquoted command substitutions can lead to unexpected behavior or security vulnerabilities if the output contains spaces or special characters, potentially enabling command injection attacks.","repository":"elie222/inbox-zero","domain":"app-frameworks","topic":"Security","language":"Yaml","updated":"2024-12-20","comments":1,"stars":8267,"raw":"https://awesomereviewers.com/raw/inbox-zero-quote-shell-substitutions.md"},{"slug":"boto3-function-focused-code-organization","title":"Function-focused code organization","description":"Files should contain only code related to their named purpose, with proper organization and formatting. When adding functionality: 1. Place code in files that match their purpose (e.g., theme-related code belongs in general utilities, not in specialized modules)","repository":"boto/boto3","domain":"cloud-infra","topic":"Code Style","language":"JavaScript","updated":"2024-12-19","comments":2,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-function-focused-code-organization.md"},{"slug":"fastapi-environment-specific-database-configuration","title":"Environment-specific database configuration","description":"Configure database connections differently based on the environment. Use lightweight file-based databases like SQLite for development and testing, but deploy robust server-based databases like PostgreSQL in production. This approach simplifies local development while ensuring your application has appropriate scalability and reliability in production.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Database","language":"Markdown","updated":"2024-12-19","comments":2,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-environment-specific-database-configuration.md"},{"slug":"markitdown-follow-configuration-best-practices","title":"Follow configuration best practices","description":"Always adhere to official guidelines and proper validation when setting up configurations, whether for dependencies, file formats, or environment setup. This prevents subtle issues that can cause tests to pass incorrectly or create environment conflicts.","repository":"microsoft/markitdown","domain":"llm-infra","topic":"Configurations","language":"Other","updated":"2024-12-19","comments":2,"stars":76602,"raw":"https://awesomereviewers.com/raw/markitdown-follow-configuration-best-practices.md"},{"slug":"waveterm-avoid-chatty-mouse-events","title":"Avoid chatty mouse events","description":"Motivation: High-frequency events like mousemove are \"chatty\" and can cause excessive CPU usage and layout thrashing. Prefer lower-rate pointer events (mouseenter/mouseleave) or throttled handlers attached to specific elements, and minimize repeated DOM writes by toggling classes. Always attach and remove listeners in lifecycle hooks and guard against null...","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Performance Optimization","language":"TSX","updated":"2024-12-19","comments":2,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-avoid-chatty-mouse-events.md"},{"slug":"turborepo-descriptive-unambiguous-identifiers","title":"Descriptive, unambiguous identifiers","description":"Choose names that clearly express intent and behavior while avoiding ambiguity. Identifiers should communicate their purpose to other developers without requiring them to read implementation details.","repository":"vercel/turborepo","domain":"devtools","topic":"Naming Conventions","language":"Rust","updated":"2024-12-17","comments":8,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-descriptive-unambiguous-identifiers.md"},{"slug":"react-router-prefer-built-in-react-types","title":"prefer built-in React types","description":"Favor React's built-in types over custom interfaces when possible, and consolidate to standard library types for better maintainability and type safety. Use `PropsWithChildren` instead of creating custom component prop interfaces, leverage generics for type flexibility, and migrate away from deprecated types in favor of type-safe alternatives.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"React","language":"TypeScript","updated":"2024-12-17","comments":4,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-prefer-built-in-react-types.md"},{"slug":"markitdown-validate-configuration-assumptions","title":"Validate configuration assumptions","description":"Before adding or modifying configuration settings, understand the underlying tool capabilities and test your assumptions. Many configuration issues arise from assumptions about what's needed without investigating whether the tool already provides the desired functionality or has specific constraints.","repository":"microsoft/markitdown","domain":"llm-infra","topic":"Configurations","language":"Json","updated":"2024-12-17","comments":2,"stars":76602,"raw":"https://awesomereviewers.com/raw/markitdown-validate-configuration-assumptions.md"},{"slug":"stagehand-ai-provider-naming-standards","title":"AI provider naming standards","description":"Maintain consistent and proper naming conventions for AI model providers throughout code, documentation, and comments. Use official capitalization (e.g., \"OpenAI\" not \"openai\") and provide clear documentation about which AI services are required versus optional.","repository":"browserbase/stagehand","domain":"ai-agents","topic":"AI","language":"Markdown","updated":"2024-12-17","comments":2,"stars":16443,"raw":"https://awesomereviewers.com/raw/stagehand-ai-provider-naming-standards.md"},{"slug":"zed-warn-against-sudo","title":"Warn against sudo","description":"Applications that may need elevated privileges should explicitly warn against running the entire application with sudo. Instead, implement and document proper privilege escalation mechanisms (like polkit on Linux) for specific tasks requiring higher permissions.","repository":"zed-industries/zed","domain":"devtools","topic":"Security","language":"Shell","updated":"2024-12-17","comments":1,"stars":62119,"raw":"https://awesomereviewers.com/raw/zed-warn-against-sudo.md"},{"slug":"drizzle-orm-database-type-consistency","title":"Database type consistency","description":"Ensure database-specific types, imports, and serialization are used consistently throughout the codebase. This prevents runtime errors, improves type safety, and maintains proper data handling across different database systems.","repository":"drizzle-team/drizzle-orm","domain":"data-systems","topic":"Database","language":"TypeScript","updated":"2024-12-16","comments":15,"stars":29461,"raw":"https://awesomereviewers.com/raw/drizzle-orm-database-type-consistency.md"},{"slug":"db-gpt-semantic-naming-rules","title":"Semantic Naming Rules","description":"Use names that accurately reflect meaning, scope (internal vs external), and responsibility—and keep them consistent with existing/base APIs. Apply these rules:","repository":"eosphoros-ai/DB-GPT","domain":"ai-agents","topic":"Naming Conventions","language":"Python","updated":"2024-12-16","comments":8,"stars":18703,"raw":"https://awesomereviewers.com/raw/db-gpt-semantic-naming-rules.md"},{"slug":"waveterm-favor-reusable-helpers","title":"Favor reusable helpers","description":"Centralize repeated UI logic and prefer modern, consistent JS style. When you see duplicated logic, ad-hoc class strings, local copies of global state, or repeated boolean checks, extract them into small, well-named helpers (or model/computed methods) and apply consistent ES/React idioms.","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Code Style","language":"TSX","updated":"2024-12-16","comments":8,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-favor-reusable-helpers.md"},{"slug":"tokio-fast-deterministic-tests","title":"Fast deterministic tests","description":"Avoid using real sleeps or delays in tests as they significantly slow down the test suite and can introduce flakiness. Instead, use simulated time with the `start_paused` parameter for time-dependent tests:","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Testing","language":"Rust","updated":"2024-12-16","comments":5,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-fast-deterministic-tests.md"},{"slug":"db-gpt-configurable-search-parameters","title":"Configurable Search Parameters","description":"All retrieval/exploration code (graph + vector/ANN) must be implemented as a staged algorithm with explicit, configurable search hyperparameters, and with correct graph element semantics.","repository":"eosphoros-ai/DB-GPT","domain":"ai-agents","topic":"Algorithms","language":"Python","updated":"2024-12-16","comments":3,"stars":18703,"raw":"https://awesomereviewers.com/raw/db-gpt-configurable-search-parameters.md"},{"slug":"mastodon-complete-translatable-sentences","title":"Complete translatable sentences","description":"Use complete sentences in translatable strings rather than breaking them into fragments, even if this results in some repetition. Sentence fragments make translation difficult or impossible for languages with different grammatical structures, and they provide insufficient context for translators.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Documentation","language":"TSX","updated":"2024-12-16","comments":3,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-complete-translatable-sentences.md"},{"slug":"waveterm-config-accuracy-and-safety","title":"Config accuracy and safety","description":"Confirm that configuration artifacts (docs, config files, and ignore lists) match actual runtime behavior and preserve developer workflows. Why: Incorrect docs or overly broad ignore rules cause confusion and break common development scenarios (hot UI changes, devcontainer editor settings, in-container git commits).","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Configurations","language":"Other","updated":"2024-12-16","comments":3,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-config-accuracy-and-safety.md"},{"slug":"fiber-document-error-conditions-clearly","title":"Document error conditions clearly","description":"Always provide clear documentation for error conditions, unsafe usage patterns, and failure scenarios in API documentation. Include explicit warnings about potential data races, undefined behavior, and error propagation to help developers avoid common pitfalls.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Error Handling","language":"Markdown","updated":"2024-12-16","comments":2,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-document-error-conditions-clearly.md"},{"slug":"influxdb-document-function-signatures","title":"Document function signatures","description":"Always document function parameters and return values in the function header comment or interface definition. This is particularly important when a function returns multiple values or when the meaning of return values might not be immediately obvious.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Documentation","language":"Go","updated":"2024-12-16","comments":2,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-document-function-signatures.md"},{"slug":"duckdb-avoid-redundant-lookups","title":"avoid redundant lookups","description":"When working with associative containers (sets, maps, unordered_set, unordered_map), avoid performing redundant lookups by using single operations that combine lookup and insertion/modification. The common anti-pattern is to first check if an element exists with `find()`, then perform a separate `insert()` operation, which results in two hash table lookups.","repository":"duckdb/duckdb","domain":"data-systems","topic":"Algorithms","language":"C++","updated":"2024-12-15","comments":3,"stars":32061,"raw":"https://awesomereviewers.com/raw/duckdb-avoid-redundant-lookups.md"},{"slug":"langchainjs-dependency-classification-standards","title":"Dependency classification standards","description":"Properly classify dependencies in package.json according to their usage pattern and project guidelines. This ensures correct build behavior, optimizes package size, and prevents dependency conflicts.","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Configurations","language":"Json","updated":"2024-12-13","comments":4,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-dependency-classification-standards.md"},{"slug":"langchainjs-constructor-over-setter","title":"Constructor over setter","description":"Prefer passing configuration through constructor parameters rather than setting properties after instantiation. This makes APIs more predictable, enables immutability, and clearly communicates required dependencies at creation time. Additionally, use consistent method naming conventions like `.invoke()` for primary API methods.","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"API","language":"Other","updated":"2024-12-13","comments":3,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-constructor-over-setter.md"},{"slug":"likec4-guard-nullable-values","title":"Guard nullable values","description":"Always check for null/undefined before accessing values or rendering UI instead of relying on non‑null assertions or unconditional usage. Prefer optional chaining and explicit guards in logic and conditional rendering in JSX.","repository":"likec4/likec4","domain":"devtools","topic":"Null Handling","language":"TSX","updated":"2024-12-13","comments":2,"stars":2582,"raw":"https://awesomereviewers.com/raw/likec4-guard-nullable-values.md"},{"slug":"vite-propagate-errors-with-context","title":"Propagate errors with context","description":"Always propagate errors with proper context and recovery strategy. Use try-catch blocks for both synchronous and asynchronous operations, ensure error information is preserved, and provide meaningful error messages.","repository":"vitejs/vite","domain":"devtools","topic":"Error Handling","language":"TypeScript","updated":"2024-12-12","comments":5,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-propagate-errors-with-context.md"},{"slug":"langchainjs-simplify-code-organization","title":"Simplify code organization","description":"Maintain clean code organization by eliminating unnecessary abstractions and preventing codebase fragmentation. This applies both at the component level and module level:","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Code Style","language":"JavaScript","updated":"2024-12-12","comments":2,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-simplify-code-organization.md"},{"slug":"lobe-chat-pin-docker-base-versions","title":"Pin Docker base versions","description":"Always specify exact version numbers for Docker base images instead of using floating tags like `lts` or `latest`. Floating tags can introduce unexpected breaking changes when they automatically update to newer versions, potentially causing build failures or runtime issues in production environments.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Configurations","language":"Dockerfile","updated":"2024-12-12","comments":2,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-pin-docker-base-versions.md"},{"slug":"react-native-prefer-explicit-code","title":"prefer explicit code","description":"Write code that explicitly states its intent rather than relying on implicit behavior or complex constructs. This improves readability and maintainability by making the code's purpose immediately clear to other developers.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Code Style","language":"C++","updated":"2024-12-11","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-prefer-explicit-code.md"},{"slug":"electron-consistent-platform-identifiers","title":"consistent platform identifiers","description":"When naming platform identifiers, choose one naming convention and use it consistently throughout the codebase. Prefer established ecosystem standards when available, such as Node.js `process.platform` values (`win32`, `darwin`, `linux`) over custom variations.","repository":"electron/electron","domain":"devtools","topic":"Naming Conventions","language":"Yaml","updated":"2024-12-10","comments":2,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-consistent-platform-identifiers.md"},{"slug":"framework-mark-sensitive-parameters","title":"Mark sensitive parameters","description":"Always use the `#[\\SensitiveParameter]` attribute for parameters containing sensitive information such as passwords, tokens, API keys, and personal identifiable information. This prevents accidental exposure of sensitive data in logs, stack traces, and debugging information, which could otherwise lead to security breaches.","repository":"laravel/framework","domain":"app-frameworks","topic":"Security","language":"PHP","updated":"2024-12-10","comments":2,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-mark-sensitive-parameters.md"},{"slug":"vitess-database-configuration-best-practices","title":"Database configuration best practices","description":"When implementing or modifying database-related configurations, follow these principles: 1. Use semantically appropriate types for configuration parameters (e.g., `Duration` instead of `float` for time values)","repository":"vitessio/vitess","domain":"data-systems","topic":"Database","language":"Markdown","updated":"2024-12-10","comments":2,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-database-configuration-best-practices.md"},{"slug":"cli-handle-all-errors-explicitly","title":"Handle all errors explicitly","description":"Always explicitly handle errors rather than assuming they are handled by dependencies or ignoring them. Every function that returns an error should have that error checked and handled appropriately. Use proper error wrapping with fmt.Errorf and the %w verb to maintain error chains, and ensure resource cleanup with defer statements even when errors occur.","repository":"snyk/cli","domain":"security","topic":"Error Handling","language":"Go","updated":"2024-12-09","comments":7,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-handle-all-errors-explicitly.md"},{"slug":"cli-prevent-silent-test-failures","title":"prevent silent test failures","description":"Tests must explicitly fail when expected conditions are not met, rather than silently exiting early or using weak assertions that can hide real issues. Silent test failures create false confidence in test suites and can mask regressions.","repository":"snyk/cli","domain":"security","topic":"Testing","language":"TypeScript","updated":"2024-12-09","comments":7,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-prevent-silent-test-failures.md"},{"slug":"react-native-ensure-exception-safety","title":"ensure exception safety","description":"Always ensure proper exception safety by placing cleanup code in @finally blocks, using stack-allocated exceptions, and implementing comprehensive exception handling for different types. Resource cleanup must occur even when exceptions are thrown to prevent memory leaks.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Error Handling","language":"Other","updated":"2024-12-09","comments":3,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-ensure-exception-safety.md"},{"slug":"union-maintain-naming-consistency","title":"Maintain naming consistency","description":"Ensure consistent terminology and naming conventions across the entire codebase. Use the same identifier names for the same concepts throughout all modules, files, and APIs. Avoid defining the same logical entity with different names in different places.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Naming Conventions","language":"Other","updated":"2024-12-09","comments":3,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-maintain-naming-consistency.md"},{"slug":"react-router-configure-react-build-environments","title":"Configure React build environments","description":"Ensure proper environment and module configuration for React applications to load the correct versions and entrypoints across different build contexts. This includes setting NODE_ENV appropriately and configuring import paths for optimal React loading.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"React","language":"JavaScript","updated":"2024-12-09","comments":2,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-configure-react-build-environments.md"},{"slug":"svelte-ssr-documentation-clarity","title":"SSR documentation clarity","description":"Ensure server-side rendering documentation is grammatically correct and clearly explains the differences between server and client contexts. Documentation should explicitly describe hydration behavior, performance implications, and function availability constraints.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Next","language":"Markdown","updated":"2024-12-09","comments":2,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-ssr-documentation-clarity.md"},{"slug":"union-avoid-suppressing-typescript-errors","title":"avoid suppressing TypeScript errors","description":"Do not use `@ts-expect-error` comments to suppress TypeScript errors, especially those related to null, undefined, or type safety. These errors are designed to catch potential runtime issues and should be properly resolved instead of silenced.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Null Handling","language":"Other","updated":"2024-12-09","comments":2,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-avoid-suppressing-typescript-errors.md"},{"slug":"yoga-verify-configuration-completeness","title":"verify configuration completeness","description":"Always verify that configuration files completely and accurately specify their requirements. This includes ensuring all related files are included and using appropriate minimum versions or glob patterns.","repository":"facebook/yoga","domain":"runtimes","topic":"Configurations","language":"Json","updated":"2024-12-09","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-verify-configuration-completeness.md"},{"slug":"poetry-consistent-semantic-naming","title":"consistent semantic naming","description":"Names should follow established team conventions while accurately reflecting their purpose and functionality. Inconsistent naming schemes and misleading identifiers create confusion and maintenance overhead.","repository":"python-poetry/poetry","domain":"devtools","topic":"Naming Conventions","language":"Yaml","updated":"2024-12-08","comments":2,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-consistent-semantic-naming.md"},{"slug":"react-native-prefer-micro-optimizations","title":"Prefer micro-optimizations","description":"Apply small performance improvements that accumulate to significant gains. Focus on efficient memory usage, API choices, and avoiding unnecessary operations.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Performance Optimization","language":"Other","updated":"2024-12-06","comments":5,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-prefer-micro-optimizations.md"},{"slug":"nest-prevent-async-race-conditions","title":"Prevent async race conditions","description":"Design async operations to prevent race conditions, memory leaks, and ensure proper resource cleanup. Key principles: 1. Avoid mutating shared state in async operations","repository":"nestjs/nest","domain":"app-frameworks","topic":"Concurrency","language":"TypeScript","updated":"2024-12-06","comments":4,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-prevent-async-race-conditions.md"},{"slug":"dspy-cache-key-serialization","title":"Cache key serialization","description":"When implementing caching for functions that accept complex objects (dictionaries with mixed types, Pydantic models, callables), ensure proper cache key generation by filtering out non-serializable objects and converting complex types to serializable formats.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Caching","language":"Python","updated":"2024-12-06","comments":3,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-cache-key-serialization.md"},{"slug":"react-router-remove-obsolete-configuration-options","title":"Remove obsolete configuration options","description":"Proactively remove configuration options that are no longer functional or relevant to prevent developer confusion and potential bugs. When configuration options become obsolete due to architectural changes or package migrations, removing them from type definitions and interfaces is preferable to keeping them as non-functional placeholders.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Configurations","language":"TSX","updated":"2024-12-06","comments":2,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-remove-obsolete-configuration-options.md"},{"slug":"router-comprehensive-test-validation","title":"comprehensive test validation","description":"Tests should validate all relevant aspects of the system to ensure comprehensive coverage. This includes incorporating type checking into test execution, validating file operations and generation processes, and ensuring end-to-end functionality works correctly. Different types of tests serve different validation purposes and should be used strategically.","repository":"TanStack/router","domain":"app-frameworks","topic":"Testing","language":"Json","updated":"2024-12-06","comments":2,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-comprehensive-test-validation.md"},{"slug":"fiber-include-practical-examples","title":"Include practical examples","description":"Documentation should include practical, working examples that demonstrate real-world usage scenarios. When introducing new features, methods, or concepts, provide concrete code examples that show users how to apply them in practice. This is especially important when mentioning functionality multiple times without demonstration, or when documenting complex...","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2024-12-05","comments":4,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-include-practical-examples.md"},{"slug":"react-native-optimize-algorithmic-efficiency","title":"optimize algorithmic efficiency","description":"When implementing algorithms, especially in performance-critical paths like scroll handlers or layout methods, prioritize computational efficiency and avoid expensive operations. Consider algorithmic complexity and choose more efficient approaches when dealing with large datasets or frequently called methods.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Algorithms","language":"Java","updated":"2024-12-05","comments":4,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-optimize-algorithmic-efficiency.md"},{"slug":"react-native-avoid-expensive-allocations","title":"Avoid expensive allocations","description":"Minimize object creation and expensive operations in performance-critical code paths, particularly in frequently called methods like onDraw, layout operations, and UI updates.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Performance Optimization","language":"Java","updated":"2024-12-05","comments":3,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-avoid-expensive-allocations.md"},{"slug":"dify-manage-side-effects-properly","title":"Manage side effects properly","description":"Avoid performing side effects directly in component render functions. Use useEffect for side effects like API calls, DOM manipulations, or state changes that should occur after render. Wrap functions with useCallback when they need to be optimized or used as dependencies, and use async/await for proper asynchronous handling.","repository":"langgenius/dify","domain":"llm-infra","topic":"React","language":"TSX","updated":"2024-12-05","comments":2,"stars":114231,"raw":"https://awesomereviewers.com/raw/dify-manage-side-effects-properly.md"},{"slug":"dspy-add-comprehensive-test-coverage","title":"Add comprehensive test coverage","description":"When introducing new functionality, always include corresponding test coverage that extends existing test infrastructure and validates the feature across multiple scenarios. This ensures robustness and maintains code quality standards.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Testing","language":"Markdown","updated":"2024-12-05","comments":2,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-add-comprehensive-test-coverage.md"},{"slug":"react-native-configuration-consistency-management","title":"configuration consistency management","description":"Maintain consistent configuration references across all code branches and document temporary configuration code for future cleanup. Configuration inconsistencies can lead to compilation errors and maintenance debt.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Configurations","language":"Java","updated":"2024-12-05","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-configuration-consistency-management.md"},{"slug":"spring-boot-clear-structured-logging-documentation","title":"Clear structured logging documentation","description":"Document structured logging implementations with clarity, explicitly noting precedence rules and interactions with other logging configurations. Always highlight important considerations (such as custom configurations taking precedence) prominently in the main documentation rather than as footnotes or warnings that might be missed.","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Logging","language":"Other","updated":"2024-12-05","comments":2,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-clear-structured-logging-documentation.md"},{"slug":"checkov-choose-optimal-algorithms","title":"Choose optimal algorithms","description":"Always select appropriate data structures and algorithms based on their performance characteristics and the specific operations your code needs to perform. This can significantly improve both code readability and execution efficiency.","repository":"bridgecrewio/checkov","domain":"security","topic":"Algorithms","language":"Python","updated":"2024-12-04","comments":8,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-choose-optimal-algorithms.md"},{"slug":"ui-organize-tailwind-classes","title":"Organize tailwind classes","description":"Structure your Tailwind CSS classes for readability and maintainability. Instead of long chains of conditional classes with `&&` operators, use object syntax with clear naming patterns. This improves code readability and makes maintenance significantly easier.","repository":"shadcn-ui/ui","domain":"app-frameworks","topic":"Code Style","language":"TSX","updated":"2024-12-04","comments":7,"stars":90568,"raw":"https://awesomereviewers.com/raw/ui-organize-tailwind-classes.md"},{"slug":"polars-create-demonstrative-examples","title":"Create demonstrative examples","description":"Include clear, concise examples in documentation that effectively demonstrate functionality. Follow these principles for better documentation examples:","repository":"pola-rs/polars","domain":"data-systems","topic":"Documentation","language":"Python","updated":"2024-12-04","comments":3,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-create-demonstrative-examples.md"},{"slug":"spring-boot-validate-nulls-properly","title":"Validate nulls properly","description":"Always use appropriate null validation mechanisms to prevent NullPointerExceptions and ensure code robustness. For string parameters: - Use `Assert.hasText(profile, \"Profile must have text\")` instead of `Assert.notNull()` when you need to validate both null and empty strings","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Null Handling","language":"Java","updated":"2024-12-04","comments":3,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-validate-nulls-properly.md"},{"slug":"polars-use-consistent-temporal-types","title":"Use consistent temporal types","description":"When implementing or modifying temporal operations, maintain consistent data types that align with existing temporal functions. Specifically, use Int8 for datetime components with small ranges (months, days, hours, minutes, seconds) and Int32/Int64 for larger values (years, microseconds). This approach reduces unnecessary type casting, improves code...","repository":"pola-rs/polars","domain":"data-systems","topic":"Temporal","language":"Rust","updated":"2024-12-04","comments":2,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-use-consistent-temporal-types.md"},{"slug":"workers-sdk-telemetry-documentation-consistency","title":"telemetry documentation consistency","description":"Maintain consistent formatting and style when documenting telemetry and observability systems. This includes using parallel structure in lists, consistent terminology, and clear explanations of what data is collected and why.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Observability","language":"Markdown","updated":"2024-12-04","comments":2,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-telemetry-documentation-consistency.md"},{"slug":"workers-sdk-privacy-documentation-clarity","title":"Privacy documentation clarity","description":"When documenting data collection practices, telemetry, or analytics features, explicitly enumerate what sensitive information is NOT collected to ensure transparency and build user trust. Privacy statements should be clear, comprehensive, and easily understandable.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Security","language":"Markdown","updated":"2024-12-04","comments":1,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-privacy-documentation-clarity.md"},{"slug":"pydantic-specific-types-for-performance","title":"Specific types for performance","description":"Using concrete types instead of abstract container classes in data models improves validation performance. More specific types require fewer checks and coercion attempts, resulting in faster validation. Additionally, ensure proper model parametrization to prevent unnecessary revalidation, which can trigger validators repeatedly.","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Performance Optimization","language":"Markdown","updated":"2024-12-03","comments":2,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-specific-types-for-performance.md"},{"slug":"react-native-thread-safe-shared-state","title":"Thread-safe shared state","description":"Ensure that shared mutable state is properly protected against concurrent access to prevent race conditions and data corruption. When multiple threads can access the same mutable data, use appropriate synchronization mechanisms such as ThreadLocal, locks, or atomic operations.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Concurrency","language":"Java","updated":"2024-12-02","comments":10,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-thread-safe-shared-state.md"},{"slug":"semgrep-prefer-simple-readable-code","title":"prefer simple readable code","description":"Choose clarity and simplicity over clever or complex constructs. Avoid unnecessary abstractions, complex function compositions, and \"clever\" code patterns that sacrifice readability for brevity.","repository":"semgrep/semgrep","domain":"security","topic":"Code Style","language":"Other","updated":"2024-12-02","comments":9,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-prefer-simple-readable-code.md"},{"slug":"stagehand-keep-build-scripts-portable","title":"Keep build scripts portable","description":"Build scripts should remain environment-agnostic and free from personal customizations or assumptions about end-user needs. Avoid including local-specific commands (like clipboard operations) and let consumers make their own decisions about optimizations like minification.","repository":"browserbase/stagehand","domain":"ai-agents","topic":"CI/CD","language":"Json","updated":"2024-12-02","comments":2,"stars":16443,"raw":"https://awesomereviewers.com/raw/stagehand-keep-build-scripts-portable.md"},{"slug":"poetry-pin-tool-versions-explicitly","title":"Pin tool versions explicitly","description":"Always specify exact versions for tools and dependencies in CI/CD workflows to ensure reproducible builds and avoid issues with cached or default system versions. Use package managers and version pinning rather than relying on system-installed tools.","repository":"python-poetry/poetry","domain":"devtools","topic":"CI/CD","language":"Yaml","updated":"2024-11-30","comments":2,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-pin-tool-versions-explicitly.md"},{"slug":"fiber-simplify-logging-integrations","title":"simplify logging integrations","description":"When implementing custom logging integrations, prioritize simplicity and completeness over complex abstractions. Avoid creating overly complicated wrapper structures that developers must recreate for basic logging functionality. Instead, provide simple, reusable patterns that support all necessary logging levels and are easy to understand and maintain.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Logging","language":"Markdown","updated":"2024-11-29","comments":2,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-simplify-logging-integrations.md"},{"slug":"react-router-organize-test-scripts-properly","title":"organize test scripts properly","description":"Keep base test scripts generic and create specialized variants for specific workflows. Base scripts like \"test\" should remain simple and flexible, allowing developers to pass additional arguments via CLI. For specialized workflows, create separate scripts with descriptive names.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Testing","language":"Json","updated":"2024-11-29","comments":2,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-organize-test-scripts-properly.md"},{"slug":"maplibre-native-externalize-configuration-values","title":"Externalize configuration values","description":"Use environment variables and external configuration mechanisms instead of hard-coding values in build scripts. This makes your build system more flexible, maintainable, and adaptable to different environments.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Configurations","language":"Kotlin","updated":"2024-11-28","comments":3,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-externalize-configuration-values.md"},{"slug":"serverless-promise-error-handling-patterns","title":"Promise error handling patterns","description":"When handling promise errors, use the second callback parameter of `.then()` instead of `.catch()` when you want to handle only the specific promise rejection and avoid accidentally catching programmer errors from the success handler. Use `.catch()` only when you intend to handle all errors in the promise chain.","repository":"serverless/serverless","domain":"cloud-infra","topic":"Error Handling","language":"JavaScript","updated":"2024-11-27","comments":7,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-promise-error-handling-patterns.md"},{"slug":"material-ui-consistent-component-api-patterns","title":"Consistent component API patterns","description":"Design component APIs with consistent patterns that promote extensibility and clear usage. Prefer generic prop structures like `slotProps` over specific props (such as `InputProps`, `InputLabelProps`) for better maintainability and consistency across components.","repository":"mui/material-ui","domain":"app-frameworks","topic":"API","language":"JavaScript","updated":"2024-11-27","comments":3,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-consistent-component-api-patterns.md"},{"slug":"awesome-go-environment-variable-defaults","title":"Environment variable defaults","description":"Configuration values should be externalized to environment variables with sensible defaults to avoid hard-coding values in source code. This approach improves flexibility, security, and maintainability by allowing different configurations across environments without code changes.","repository":"avelino/awesome-go","domain":"docs","topic":"Configurations","language":"Go","updated":"2024-11-27","comments":2,"stars":151435,"raw":"https://awesomereviewers.com/raw/awesome-go-environment-variable-defaults.md"},{"slug":"vite-precise-documentation-language","title":"Precise documentation language","description":"Use specific and clear language in all documentation to improve user understanding and avoid ambiguity. Favor precise terminology over vague descriptors, while balancing specificity with maintainability concerns.","repository":"vitejs/vite","domain":"devtools","topic":"Documentation","language":"Other","updated":"2024-11-27","comments":2,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-precise-documentation-language.md"},{"slug":"openpilot-eliminate-unnecessary-code","title":"eliminate unnecessary code","description":"Remove redundant code constructs and prefer concise, direct patterns that improve readability and maintainability. This includes eliminating unnecessary widget/layout creation, using ternary operators for simple conditionals, direct initialization patterns, and simplifying complex calculations with named constants.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Code Style","language":"Other","updated":"2024-11-26","comments":5,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-eliminate-unnecessary-code.md"},{"slug":"lobe-chat-consider-ssr-impact","title":"Consider SSR impact","description":"When using Next.js dynamic imports, carefully evaluate whether to disable server-side rendering (SSR) based on the component's purpose and impact on user experience.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Next","language":"TSX","updated":"2024-11-26","comments":3,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-consider-ssr-impact.md"},{"slug":"openpilot-optimize-git-network-operations","title":"Optimize git network operations","description":"When performing git operations that involve network communication, use proper syntax and efficient strategies to minimize data transfer and ensure correct remote branch handling.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Networking","language":"Shell","updated":"2024-11-26","comments":2,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-optimize-git-network-operations.md"},{"slug":"react-native-manage-component-state-dependencies","title":"manage component state dependencies","description":"Ensure React components have all necessary state information before rendering and that lifecycle events don't cause unintended state interactions. Components should validate they have required data (like sizing information) before updating, and state changes should be carefully managed to prevent side effects.","repository":"facebook/react-native","domain":"app-frameworks","topic":"React","language":"Java","updated":"2024-11-26","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-manage-component-state-dependencies.md"},{"slug":"vite-permission-hierarchy-awareness","title":"Permission hierarchy awareness","description":"When implementing permission checks, understand the hierarchical nature of permissions and avoid redundant checks. Higher-level permissions typically include lower-level ones. Ensure your authorization logic accounts for permission relationships to maintain security while keeping code efficient.","repository":"vitejs/vite","domain":"devtools","topic":"Security","language":"Yaml","updated":"2024-11-26","comments":1,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-permission-hierarchy-awareness.md"},{"slug":"framework-keep-ci-configurations-minimal","title":"Keep CI configurations minimal","description":"When configuring CI workflows, include only the extensions, tools, and settings that are necessary for the specific tests being run. Avoid adding unnecessary PHP extensions (such as `xml` or `xdebug`) to workflow configurations unless they''re explicitly required. Similarly, keep coverage disabled (`coverage: none`) in CI pipelines by default to improve...","repository":"laravel/framework","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2024-11-25","comments":14,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-keep-ci-configurations-minimal.md"},{"slug":"framework-disable-coverage-in-workflows","title":"Disable coverage in workflows","description":"Keep code coverage tools disabled in CI/CD workflows unless they're specifically needed for generating coverage reports. Enabling coverage tools like xdebug in GitHub Actions can significantly slow down pipeline execution without providing value when reports aren't being collected or analyzed.","repository":"laravel/framework","domain":"app-frameworks","topic":"Testing","language":"Yaml","updated":"2024-11-25","comments":4,"stars":33763,"raw":"https://awesomereviewers.com/raw/framework-disable-coverage-in-workflows.md"},{"slug":"dspy-ai-signature-consistency","title":"AI signature consistency","description":"Ensure AI model signatures maintain consistency between field types and descriptions, and avoid redundant prompting techniques when the desired behavior is already captured in the signature definition.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"AI","language":"Other","updated":"2024-11-25","comments":2,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-ai-signature-consistency.md"},{"slug":"developer-roadmap-concise-performance-guidance","title":"Concise Performance Guidance","description":"When writing performance optimization standards/docs, keep the lead section brief and immediately actionable: provide a short overview plus a checklist of the key techniques, and move any deep technical explanation into linked resources.","repository":"kamranahmedse/developer-roadmap","domain":"docs","topic":"Performance Optimization","language":"Markdown","updated":"2024-11-24","comments":2,"stars":354523,"raw":"https://awesomereviewers.com/raw/developer-roadmap-concise-performance-guidance.md"},{"slug":"alacritty-keep-documentation-together","title":"Keep documentation together","description":"Documentation should keep related information physically close together rather than separating it across different sections. When documenting configuration options, provide detailed explanations and defaults directly with each option definition instead of collecting them in distant sections.","repository":"alacritty/alacritty","domain":"devtools","topic":"Documentation","language":"Other","updated":"2024-11-23","comments":2,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-keep-documentation-together.md"},{"slug":"brew-prefer-flags-over-conditionals","title":"Prefer flags over conditionals","description":"When implementing environment-specific or version-dependent behavior, use feature flags or configuration variables instead of complex conditional logic. This approach makes configuration management more maintainable and easier to adjust when requirements change.","repository":"Homebrew/brew","domain":"devtools","topic":"Configurations","language":"Other","updated":"2024-11-23","comments":2,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-prefer-flags-over-conditionals.md"},{"slug":"deno-verify-algorithm-correctness","title":"Verify algorithm correctness","description":"Ensure algorithms produce expected results by validating data flow and checking that all execution paths return meaningful values rather than undefined or incorrect results. Pay special attention to conditional logic that filters or processes data, and verify that functions receive the necessary arguments to perform their intended operations.","repository":"denoland/deno","domain":"runtimes","topic":"Algorithms","language":"JavaScript","updated":"2024-11-23","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-verify-algorithm-correctness.md"},{"slug":"waveterm-use-design-tokens","title":"Use design tokens","description":"Centralize visual styles and prefer theme variables over hardcoded values. Motivation: duplicate hardcoded colors, repeated color classes, inconsistent sizing, and ad-hoc styles reduce maintainability and make global theme changes error-prone. How to apply it:","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Code Style","language":"Other","updated":"2024-11-22","comments":4,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-use-design-tokens.md"},{"slug":"desktop-platform-specific-configuration-separation","title":"Platform-specific configuration separation","description":"Configuration options should be separated between common/shared settings and platform-specific settings to avoid build failures and ensure proper cross-platform compatibility. When a configuration option is not supported on all target platforms or architectures, it must be moved from common configuration files to individual platform-specific configuration...","repository":"zen-browser/desktop","domain":"devtools","topic":"Configurations","language":"Other","updated":"2024-11-22","comments":2,"stars":34711,"raw":"https://awesomereviewers.com/raw/desktop-platform-specific-configuration-separation.md"},{"slug":"react-native-follow-existing-naming-conventions","title":"Follow existing naming conventions","description":"When adding new variables, methods, or constants, always follow the naming conventions already established in the codebase. Before introducing new identifiers, examine existing code in the same file and related files to understand the established patterns, including prefixes, suffixes, and naming styles.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Naming Conventions","language":"Java","updated":"2024-11-22","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-follow-existing-naming-conventions.md"},{"slug":"pydantic-robust-error-messaging","title":"Robust error messaging","description":"Create clear, specific, and actionable error messages that help users understand and resolve issues, while implementing defensive error handling to maintain system integrity. Follow these principles:","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Error Handling","language":"Python","updated":"2024-11-21","comments":5,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-robust-error-messaging.md"},{"slug":"hyprland-semantic-variable-naming","title":"Semantic variable naming","description":"Variable names should clearly convey their purpose, type, and units to improve code readability and prevent errors. Follow these naming conventions: **Unit specification**: Include units in variable names when dealing with measurements or time values. Use suffixes like `Us` for microseconds, `Ms` for milliseconds, etc.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Naming Conventions","language":"C++","updated":"2024-11-21","comments":4,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-semantic-variable-naming.md"},{"slug":"langchainjs-ai-dependency-management","title":"AI dependency management","description":"When integrating AI models and language processing libraries, follow these dependency management best practices: 1. Use specific model integration packages instead of general-purpose AI SDKs. For example:","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"AI","language":"Json","updated":"2024-11-21","comments":3,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-ai-dependency-management.md"},{"slug":"svelte-runtime-html-escaping","title":"Runtime HTML escaping","description":"HTML escaping must occur at runtime, not during compilation or build time, to properly prevent XSS vulnerabilities. When content is escaped too early in the process, it may not account for dynamic values or runtime context that could introduce security risks.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Security","language":"JavaScript","updated":"2024-11-21","comments":2,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-runtime-html-escaping.md"},{"slug":"v-clear-technical-writing","title":"Clear technical writing","description":"Ensure technical documentation uses clear, grammatically correct language with consistent formatting when explaining naming conventions and code structure. This includes proper capitalization, precise word choice, consistent code formatting with backticks, and clear sentence structure.","repository":"vlang/v","domain":"runtimes","topic":"Naming Conventions","language":"Markdown","updated":"2024-11-20","comments":7,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-clear-technical-writing.md"},{"slug":"maplibre-native-prefer-safe-null-handling","title":"Prefer safe null handling","description":"Use explicit, safe practices when dealing with potentially null resources to prevent memory leaks and undefined behavior. Key guidelines: 1. **Use `nullptr` instead of `NULL`** in all C++ code, even when calling C functions:","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Null Handling","language":"C++","updated":"2024-11-20","comments":5,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-prefer-safe-null-handling.md"},{"slug":"kong-isolate-config-state","title":"Isolate config state","description":"Configurable behavior must be isolated per plugin/consumer instance, and derived/internal values must not be injected into the schema-defined `conf` object. This prevents cross-request/config leakage and keeps schema validation predictable—especially during deprecations.","repository":"Kong/kong","domain":"cloud-infra","topic":"Configurations","language":"Other","updated":"2024-11-20","comments":3,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-isolate-config-state.md"},{"slug":"bazel-document-algorithmic-reasoning","title":"Document algorithmic reasoning","description":"When implementing algorithms that involve data transformations, platform-specific behavior, or non-obvious computational choices, always include comments explaining the underlying reasoning and assumptions. This is especially critical for:","repository":"bazelbuild/bazel","domain":"devtools","topic":"Algorithms","language":"Other","updated":"2024-11-20","comments":2,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-document-algorithmic-reasoning.md"},{"slug":"stagehand-control-caching-through-instantiation","title":"Control caching through instantiation","description":"When implementing optional caching functionality, control cache behavior through conditional instantiation at higher abstraction levels rather than adding conditional logic within cache implementations themselves. This approach maintains cleaner separation of concerns and avoids scattered conditional checks throughout cache methods.","repository":"browserbase/stagehand","domain":"ai-agents","topic":"Caching","language":"TypeScript","updated":"2024-11-20","comments":2,"stars":16443,"raw":"https://awesomereviewers.com/raw/stagehand-control-caching-through-instantiation.md"},{"slug":"volcano-avoid-external-configuration-dependencies","title":"Avoid external configuration dependencies","description":"When designing configuration management systems, avoid strong dependencies on external projects for configuration logic and data structures. External projects may not evolve at the same pace as your codebase, creating maintenance burdens and potential compatibility issues.","repository":"volcano-sh/volcano","domain":"orchestration","topic":"Configurations","language":"Other","updated":"2024-11-20","comments":2,"stars":4899,"raw":"https://awesomereviewers.com/raw/volcano-avoid-external-configuration-dependencies.md"},{"slug":"react-native-minimize-public-api-exposure","title":"minimize public API exposure","description":"Keep internal implementation details private to reduce security attack surface. Public properties in header files can be accessed and potentially manipulated by external code, creating security vulnerabilities. Store internal state using private instance variables in the implementation file instead of exposing them through public properties.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Security","language":"Other","updated":"2024-11-20","comments":1,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-minimize-public-api-exposure.md"},{"slug":"router-memoize-for-render-optimization","title":"memoize for render optimization","description":"Use React memoization techniques strategically to prevent unnecessary re-renders and recomputations when values change infrequently. Apply React.memo to components that receive stable props, and useMemo for expensive computations that depend on rarely-changing values.","repository":"TanStack/router","domain":"app-frameworks","topic":"Performance Optimization","language":"TSX","updated":"2024-11-19","comments":2,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-memoize-for-render-optimization.md"},{"slug":"tree-sitter-complete-technical-documentation","title":"Complete technical documentation","description":"When documenting technical features, APIs, or data structures, provide comprehensive coverage that includes related functionality and detailed explanations rather than minimal inline comments.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Documentation","language":"Markdown","updated":"2024-11-19","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-complete-technical-documentation.md"},{"slug":"cli-debug-logging-reliability","title":"debug logging reliability","description":"Ensure debug logging behaves correctly by only activating when debug flags are explicitly enabled, while providing comprehensive coverage of all relevant cases when active. Debug logs should not cause application failures and should be printed for all error conditions, not just specific subsets.","repository":"snyk/cli","domain":"security","topic":"Logging","language":"TypeScript","updated":"2024-11-18","comments":4,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-debug-logging-reliability.md"},{"slug":"dspy-use-standardized-logging-pattern","title":"Use standardized logging pattern","description":"Always use the standardized logging pattern with module-level loggers instead of print statements or direct logging calls. This ensures consistent logging behavior, proper log level control, and better debugging capabilities across the codebase.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"Logging","language":"Python","updated":"2024-11-18","comments":4,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-use-standardized-logging-pattern.md"},{"slug":"bazel-use-semantically-clear-names","title":"Use semantically clear names","description":"Choose names that clearly express their purpose and avoid patterns that can lead to confusion or bugs. Names should be self-documenting and unambiguous in their meaning.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Naming Conventions","language":"Other","updated":"2024-11-15","comments":5,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-use-semantically-clear-names.md"},{"slug":"checkov-preserve-api-compatibility","title":"Preserve API compatibility","description":"When modifying existing APIs, function signatures, or return structures, always maintain backward compatibility to prevent breaking dependent code. This applies to both internal interfaces between components and external API integrations.","repository":"bridgecrewio/checkov","domain":"security","topic":"API","language":"Python","updated":"2024-11-15","comments":4,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-preserve-api-compatibility.md"},{"slug":"poetry-use-appropriate-logging-levels","title":"Use appropriate logging levels","description":"Use debug-level logging for technical details and error information that aids developer troubleshooting, while keeping user-facing messages clean and informative. Avoid exposing verbose technical details directly to users, but ensure they are available for debugging.","repository":"python-poetry/poetry","domain":"devtools","topic":"Logging","language":"Python","updated":"2024-11-15","comments":4,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-use-appropriate-logging-levels.md"},{"slug":"nextchat-react-hooks-best-practices","title":"React hooks best practices","description":"Always call React hooks at the top level of components and custom hooks to comply with the Rules of Hooks. Handle conditional logic inside hook bodies rather than conditionally calling hooks. When optimizing performance, choose the appropriate hook: use `useMemo` for computed values and `useCallback` for function references.","repository":"ChatGPTNextWeb/NextChat","domain":"ai-agents","topic":"React","language":"TSX","updated":"2024-11-14","comments":2,"stars":85721,"raw":"https://awesomereviewers.com/raw/nextchat-react-hooks-best-practices.md"},{"slug":"cli-graceful-error-handling","title":"Graceful error handling","description":"Implement robust error handling that provides fallback mechanisms, ensures proper resource cleanup, and delivers user-friendly error messages without exposing internal details.","repository":"snyk/cli","domain":"security","topic":"Error Handling","language":"TypeScript","updated":"2024-11-13","comments":10,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-graceful-error-handling.md"},{"slug":"nextchat-dynamic-api-behavior-detection","title":"Dynamic API behavior detection","description":"APIs should determine behavior based on runtime request characteristics rather than static configuration flags. This enables multiple API providers and models to coexist and ensures proper handling of provider-specific requirements.","repository":"ChatGPTNextWeb/NextChat","domain":"ai-agents","topic":"API","language":"TypeScript","updated":"2024-11-13","comments":4,"stars":85721,"raw":"https://awesomereviewers.com/raw/nextchat-dynamic-api-behavior-detection.md"},{"slug":"express-purposeful-style-changes","title":"Purposeful style changes","description":"Code style modifications should accompany functional improvements rather than being submitted as standalone changes. When improving code, prefer modern JavaScript syntax like object spread over older patterns or external dependencies.","repository":"expressjs/express","domain":"app-frameworks","topic":"Code Style","language":"Markdown","updated":"2024-11-13","comments":3,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-purposeful-style-changes.md"},{"slug":"pydantic-explicit-over-implicit","title":"Explicit over implicit","description":"Always prefer explicit configuration settings over relying on implicit defaults or environmental behaviors in CI workflows and build configurations. This is particularly important for:","repository":"pydantic/pydantic","domain":"app-frameworks","topic":"Configurations","language":"Yaml","updated":"2024-11-13","comments":3,"stars":24377,"raw":"https://awesomereviewers.com/raw/pydantic-explicit-over-implicit.md"},{"slug":"qwen3-configuration-parameter-documentation","title":"Configuration parameter documentation","description":"Ensure all configuration parameters have explicit default values and are thoroughly documented. When using argparse with `action='store_true'`, always pair it with `default=False`. Document parameter purposes, valid values, and default behaviors in README files. For dependency management, separate conflicting requirements into different files to avoid...","repository":"QwenLM/Qwen3","domain":"ml-systems","topic":"Configurations","language":"Markdown","updated":"2024-11-13","comments":3,"stars":24226,"raw":"https://awesomereviewers.com/raw/qwen3-configuration-parameter-documentation.md"},{"slug":"qwen3-verify-ai-library-compatibility","title":"Verify AI library compatibility","description":"When specifying AI/ML library dependencies, ensure version compatibility between related packages and verify that prebuilt binaries are available for the target environment. Many AI libraries like auto_gptq, autoawq, and flash_attn are compiled against specific versions of PyTorch and CUDA, and version mismatches can force compilation from source or cause...","repository":"QwenLM/Qwen3","domain":"ml-systems","topic":"AI","language":"Txt","updated":"2024-11-13","comments":3,"stars":24226,"raw":"https://awesomereviewers.com/raw/qwen3-verify-ai-library-compatibility.md"},{"slug":"boto3-write-clear-examples","title":"Write clear examples","description":"Create comprehensive code examples in documentation that demonstrate common operations and use proper formatting. Use double backticks (``) for inline code references in reStructuredText, and wrap code blocks in proper directives:","repository":"boto/boto3","domain":"cloud-infra","topic":"Documentation","language":"Other","updated":"2024-11-12","comments":5,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-write-clear-examples.md"},{"slug":"boto3-consistent-region-configuration","title":"Consistent region configuration","description":"Always maintain consistency in region configurations throughout your application. Instead of hardcoding endpoints, use proper region configuration which allows for better maintainability and fewer errors. When working with region-dependent services like S3, ensure your client configuration region matches the service requirements.","repository":"boto/boto3","domain":"cloud-infra","topic":"Configurations","language":"Other","updated":"2024-11-12","comments":4,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-consistent-region-configuration.md"},{"slug":"boto3-demonstrate-canonical-api-patterns","title":"Demonstrate canonical API patterns","description":"Always provide examples that demonstrate the recommended and most current API usage patterns. This includes: 1. Using the most up-to-date API operations (e.g., prefer ListObjectsV2 over ListObjects)","repository":"boto/boto3","domain":"cloud-infra","topic":"API","language":"Other","updated":"2024-11-12","comments":3,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-demonstrate-canonical-api-patterns.md"},{"slug":"fiber-enforce-secure-tls-configuration","title":"Enforce secure TLS configuration","description":"Always configure TLS connections with secure minimum version requirements and proper certificate handling. Network communications should enforce TLS 1.2 or higher to prevent security vulnerabilities from outdated protocols.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Networking","language":"Go","updated":"2024-11-12","comments":3,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-enforce-secure-tls-configuration.md"},{"slug":"mastodon-safe-proxy-configuration","title":"Safe proxy configuration","description":"When configuring proxy settings for network applications, always use proper compilation methods to prevent runtime errors and ensure consistent IP address handling across different connection types. Improper proxy configuration can cause server crashes when IP addresses are accessed, particularly when using string-based configurations with multiple values.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Networking","language":"JavaScript","updated":"2024-11-12","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-safe-proxy-configuration.md"},{"slug":"polars-edge-case-algorithm-handling","title":"Edge case algorithm handling","description":"When implementing algorithms, pay special attention to edge cases, particularly empty collections. Define and document how your algorithm behaves in these boundary conditions following consistent mathematical or programming conventions.","repository":"pola-rs/polars","domain":"data-systems","topic":"Algorithms","language":"Markdown","updated":"2024-11-12","comments":2,"stars":34296,"raw":"https://awesomereviewers.com/raw/polars-edge-case-algorithm-handling.md"},{"slug":"celery-explicit-config-behavior","title":"Explicit config behavior","description":"Ensure configuration behavior is predictable, validated, and migration-friendly: - Precedence: When combining env vars, settings, and defaults, explicitly define and implement the precedence order (and document/announce any change). Avoid “surprising” priority flips.","repository":"celery/celery","domain":"orchestration","topic":"Configurations","language":"Python","updated":"2024-11-11","comments":8,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-explicit-config-behavior.md"},{"slug":"poetry-optimize-algorithmic-efficiency","title":"optimize algorithmic efficiency","description":"Choose efficient algorithms and data structures to avoid unnecessary computational complexity. Look for opportunities to replace expensive operations with more efficient alternatives, especially when dealing with collections and search operations.","repository":"python-poetry/poetry","domain":"devtools","topic":"Algorithms","language":"Python","updated":"2024-11-11","comments":7,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-optimize-algorithmic-efficiency.md"},{"slug":"node-secure-resource-loading","title":"Secure resource loading","description":"Always validate and securely load external resources like libraries, configuration files, and modules to prevent tampering and hijacking attacks. When implementing security features that depend on system components:","repository":"nodejs/node","domain":"runtimes","topic":"Security","language":"Other","updated":"2024-11-11","comments":2,"stars":112178,"raw":"https://awesomereviewers.com/raw/node-secure-resource-loading.md"},{"slug":"vite-self-referential-worker-urls","title":"Self-referential worker URLs","description":"When creating Web Workers for network communication, use self-referential URL patterns that are resilient to file renaming. This improves portability and reliability of your networking code.","repository":"vitejs/vite","domain":"devtools","topic":"Networking","language":"JavaScript","updated":"2024-11-11","comments":2,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-self-referential-worker-urls.md"},{"slug":"turborepo-boundary-case-handling","title":"Boundary case handling","description":"Always handle boundary conditions explicitly in algorithms to prevent unexpected behavior. When implementing algorithms that involve iteration, traversal, or boundary checks, consider different approaches based on the specific requirements:","repository":"vercel/turborepo","domain":"devtools","topic":"Algorithms","language":"Rust","updated":"2024-11-08","comments":4,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-boundary-case-handling.md"},{"slug":"react-native-leverage-framework-cache-mechanisms","title":"leverage framework cache mechanisms","description":"When implementing caching functionality, prefer using framework-provided cache mechanisms over manual cache management. Frameworks typically offer optimized cache handling that includes automatic error propagation, efficient multi-level cache checking, and built-in performance optimizations that are difficult to replicate manually.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Caching","language":"Kotlin","updated":"2024-11-08","comments":3,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-leverage-framework-cache-mechanisms.md"},{"slug":"vite-manage-configuration-inheritance-carefully","title":"Manage configuration inheritance carefully","description":"When designing configuration systems, establish clear default values and inheritance patterns. Follow these principles: 1. Set explicit defaults that can be overridden by frameworks and users","repository":"vitejs/vite","domain":"devtools","topic":"Configurations","language":"TypeScript","updated":"2024-11-07","comments":4,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-manage-configuration-inheritance-carefully.md"},{"slug":"deno-extract-complex-inline-logic","title":"Extract complex inline logic","description":"When functions contain complex inline logic or duplicated code, extract this logic into separate functions or shared utilities to improve readability and maintainability. Complex inline code makes functions harder to understand and test, while duplication creates synchronization issues and increases the likelihood of bugs.","repository":"denoland/deno","domain":"runtimes","topic":"Code Style","language":"TypeScript","updated":"2024-11-07","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-extract-complex-inline-logic.md"},{"slug":"zod-consistent-scoped-naming","title":"Consistent Scoped Naming","description":"Use consistent, semantic naming patterns for externally visible identifiers—especially package names and command/script names. - **Packages/registry entries:** Prefer the correct scope and canonical name format (typically `@scope/name`) aligned with ownership and established ecosystem conventions. If the project belongs under a scope (e.g., `@zod`), use...","repository":"colinhacks/zod","domain":"app-frameworks","topic":"Naming Conventions","language":"Json","updated":"2024-11-07","comments":2,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-consistent-scoped-naming.md"},{"slug":"openai-python-intention-revealing-naming","title":"Intention-Revealing Naming","description":"Write names that clearly communicate meaning, scope/intent, and project terminology—especially on public APIs/CLI and when calling helpers. Apply: - Match canonical terms: use the team/docs/external-provider wording for user-facing strings and public parameters (e.g., `endpoint`).","repository":"openai/openai-python","domain":"ai-agents","topic":"Naming Conventions","language":"Python","updated":"2024-11-06","comments":7,"stars":30731,"raw":"https://awesomereviewers.com/raw/openai-python-intention-revealing-naming.md"},{"slug":"nextchat-simplify-conditional-logic","title":"Simplify conditional logic","description":"Break down complex conditional expressions and control flow into simpler, more readable forms. Use early returns and guard clauses to reduce nesting and avoid unnecessary computations. Avoid chaining multiple conditions with || or && operators when the logic can be made clearer through restructuring.","repository":"ChatGPTNextWeb/NextChat","domain":"ai-agents","topic":"Code Style","language":"TypeScript","updated":"2024-11-06","comments":3,"stars":85721,"raw":"https://awesomereviewers.com/raw/nextchat-simplify-conditional-logic.md"},{"slug":"bazel-avoid-brittle-algorithms","title":"avoid brittle algorithms","description":"Replace fragile algorithmic approaches with robust, well-tested alternatives. Brittle algorithms that rely on manual parsing, string manipulation, or assumptions about data format are prone to failure and difficult to maintain.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Algorithms","language":"Python","updated":"2024-11-06","comments":2,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-avoid-brittle-algorithms.md"},{"slug":"drizzle-orm-track-migration-state-immediately","title":"track migration state immediately","description":"Ensure migration state is recorded in the database immediately after each migration file is successfully applied, rather than batching all state updates at the end. This prevents inconsistent states where migrations are partially applied but not tracked, leaving users unable to determine which migrations have been executed.","repository":"drizzle-team/drizzle-orm","domain":"data-systems","topic":"Migrations","language":"TypeScript","updated":"2024-11-06","comments":2,"stars":29461,"raw":"https://awesomereviewers.com/raw/drizzle-orm-track-migration-state-immediately.md"},{"slug":"ink-documentation-quality-standards","title":"Documentation quality standards","description":"Ensure documentation follows proper formatting standards and provides complete, practical information for developers. Use JSDoc tags correctly - `@default` should contain actual TypeScript values, not descriptive sentences. When the default value is conditional or complex, use plain text descriptions instead.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"Documentation","language":"TypeScript","updated":"2024-11-06","comments":2,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-documentation-quality-standards.md"},{"slug":"qwen3-ai-library-version-compatibility","title":"AI library version compatibility","description":"When documenting AI/ML model deployment and inference procedures, always test and specify compatible library versions to prevent runtime failures. Version incompatibilities in AI libraries can cause critical errors like inference failures, probability tensor issues, or model output corruption.","repository":"QwenLM/Qwen3","domain":"ml-systems","topic":"AI","language":"Other","updated":"2024-11-06","comments":2,"stars":24226,"raw":"https://awesomereviewers.com/raw/qwen3-ai-library-version-compatibility.md"},{"slug":"developer-roadmap-accurate-ai-content","title":"Accurate AI Content","description":"When writing AI/LLM-related documentation or roadmap material, ensure it (a) states model limitations precisely, (b) stays in the correct scope for the node/context, and (c) explains implementations in terms of the underlying pipeline (prefer pre-trained tools) rather than framework specifics.","repository":"kamranahmedse/developer-roadmap","domain":"docs","topic":"AI","language":"Markdown","updated":"2024-11-04","comments":6,"stars":354523,"raw":"https://awesomereviewers.com/raw/developer-roadmap-accurate-ai-content.md"},{"slug":"parlant-organize-import-groups","title":"organize import groups","description":"Imports should be organized into distinct groups with proper spacing for better readability. Group all third-party library imports together in one contiguous block, followed by a blank line, then group all local/relative imports in another block. This separation makes it immediately clear which dependencies are external versus internal to the project.","repository":"emcie-co/parlant","domain":"ai-agents","topic":"Code Style","language":"TSX","updated":"2024-11-03","comments":2,"stars":12205,"raw":"https://awesomereviewers.com/raw/parlant-organize-import-groups.md"},{"slug":"tree-sitter-clarify-api-documentation","title":"Clarify API documentation","description":"API documentation should provide clear, unambiguous explanations of function behavior, return values, and edge cases. Avoid vague or obscure wording that leaves developers guessing about implementation details.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Documentation","language":"Other","updated":"2024-11-02","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-clarify-api-documentation.md"},{"slug":"tree-sitter-validate-inputs-early","title":"validate inputs early","description":"Functions should validate input parameters at the beginning and return appropriate error indicators (like false, null, or error codes) rather than proceeding with invalid data. This prevents downstream errors and provides clear feedback to callers about invalid usage.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Error Handling","language":"C","updated":"2024-11-02","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-validate-inputs-early.md"},{"slug":"influxdb-choose-optimal-data-structures","title":"Choose optimal data structures","description":"Select data structures based on specific access patterns and performance requirements. When both fast lookup and predictable iteration order are needed, specialized structures like IndexMap offer benefits over standard HashMap:","repository":"influxdata/influxdb","domain":"data-systems","topic":"Algorithms","language":"Rust","updated":"2024-11-01","comments":6,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-choose-optimal-data-structures.md"},{"slug":"react-native-simplify-parsing-algorithms","title":"Simplify parsing algorithms","description":"When implementing parsing or processing algorithms, prioritize simplification and reusability over complex custom solutions. Convert complex conditional logic into simpler, well-defined data structures and reusable functions. Use established, proven algorithms from reliable sources rather than deriving custom implementations.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Algorithms","language":"JavaScript","updated":"2024-11-01","comments":3,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-simplify-parsing-algorithms.md"},{"slug":"alacritty-configuration-validation-feedback","title":"Configuration validation feedback","description":"Always validate configuration options and provide clear feedback to users about potential issues. This includes warning about unused configuration keys, preventing redundant options, and ensuring cross-platform compatibility.","repository":"alacritty/alacritty","domain":"devtools","topic":"Configurations","language":"Rust","updated":"2024-10-31","comments":5,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-configuration-validation-feedback.md"},{"slug":"react-router-typescript-configuration-setup","title":"TypeScript configuration setup","description":"Ensure proper TypeScript configuration for generated types and development workflow. This includes setting up gitignore patterns, configuring tsconfig.json for type generation, and integrating typegen into build scripts.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Configurations","language":"Markdown","updated":"2024-10-30","comments":3,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-typescript-configuration-setup.md"},{"slug":"dspy-handle-optional-dependencies-gracefully","title":"Handle optional dependencies gracefully","description":"When integrating with external AI libraries, models, or services, handle optional dependencies gracefully to avoid affecting users who don't need those features. Use local imports within class constructors or methods rather than module-level imports, and provide clear error messages when dependencies are missing.","repository":"stanfordnlp/dspy","domain":"ai-agents","topic":"AI","language":"Python","updated":"2024-10-29","comments":8,"stars":27813,"raw":"https://awesomereviewers.com/raw/dspy-handle-optional-dependencies-gracefully.md"},{"slug":"chef-secure-credential-management","title":"Secure credential management","description":"When handling passwords, certificates, or keys in your code, implement secure encryption and storage mechanisms to prevent exposure of sensitive data.","repository":"chef/chef","domain":"cloud-infra","topic":"Security","language":"Ruby","updated":"2024-10-29","comments":5,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-secure-credential-management.md"},{"slug":"desktop-consistent-css-spacing","title":"consistent CSS spacing","description":"Ensure consistent spacing across UI components by using CSS custom properties for padding/margins and applying spacing only when elements exist. This prevents visual inconsistencies between different UI states and modes.","repository":"zen-browser/desktop","domain":"devtools","topic":"Code Style","language":"Css","updated":"2024-10-29","comments":2,"stars":34711,"raw":"https://awesomereviewers.com/raw/desktop-consistent-css-spacing.md"},{"slug":"langchainjs-follow-documentation-standards","title":"Follow documentation standards","description":"Ensure all documentation follows established templates and includes required sections. When referencing components, add links to their documentation pages. Documentation for each component type (like LLMs or vector stores) should follow its specific template format and include standard sections such as \"Overview\" with links to conceptual guides and...","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Documentation","language":"Other","updated":"2024-10-28","comments":5,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-follow-documentation-standards.md"},{"slug":"checkov-use-appropriate-logging-levels","title":"Use appropriate logging levels","description":"Select the correct logging level based on the importance and visibility requirements of the information. Choose WARNING for issues that should be visible by default and may require attention, INFO for general operational messages, and DEBUG for detailed information needed only during troubleshooting. Additionally, ensure log messages include sufficient...","repository":"bridgecrewio/checkov","domain":"security","topic":"Logging","language":"Python","updated":"2024-10-27","comments":5,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-use-appropriate-logging-levels.md"},{"slug":"tree-sitter-validate-algorithm-boundaries","title":"validate algorithm boundaries","description":"Always validate boundary conditions and termination criteria in algorithms to prevent infinite loops, out-of-bounds access, and incorrect behavior. This includes checking loop bounds against variable type limits, validating range parameters, and ensuring proper termination conditions.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Algorithms","language":"C","updated":"2024-10-27","comments":4,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-validate-algorithm-boundaries.md"},{"slug":"union-preserve-original-error-codes","title":"preserve original error codes","description":"When handling errors, preserve the original error information rather than replacing it with generic error constants. This maintains better debugging information and error traceability throughout the system.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Error Handling","language":"Other","updated":"2024-10-25","comments":2,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-preserve-original-error-codes.md"},{"slug":"maplibre-native-validate-noexcept-guarantees","title":"Validate noexcept guarantees","description":"Only mark functions as `noexcept` when you can guarantee they won''t throw exceptions under any circumstances. Common pitfalls include: 1. **Hidden allocations**: Operations like vector operations, `std::make_tuple`, or working with collections might allocate memory and throw.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Error Handling","language":"Other","updated":"2024-10-24","comments":8,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-validate-noexcept-guarantees.md"},{"slug":"nuxt-optimize-array-operations","title":"optimize array operations","description":"Pre-allocate arrays when the final size is known and consolidate multiple iterations into single loops to reduce memory allocations and improve performance.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Performance Optimization","language":"TypeScript","updated":"2024-10-24","comments":4,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-optimize-array-operations.md"},{"slug":"bazel-clarify-configuration-examples","title":"Clarify configuration examples","description":"Configuration documentation should provide concrete, platform-specific examples rather than generic placeholders, and use precise terminology to avoid confusion. Generic paths like `/path/to/repository` leave developers uncertain about actual implementation.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2024-10-24","comments":3,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-clarify-configuration-examples.md"},{"slug":"deeplearning4j-eliminate-redundant-code","title":"Eliminate redundant code","description":"Keep code clean by removing all forms of redundancy that affect readability and maintainability. This includes: 1. Avoid duplicate macro/constant definitions that could cause conflicts or confusion","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Code Style","language":"Other","updated":"2024-10-24","comments":3,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-eliminate-redundant-code.md"},{"slug":"react-native-replace-magic-numbers","title":"Replace magic numbers","description":"Replace magic numbers with named constants to improve code readability and maintainability. Magic numbers make code harder to understand and maintain, as their purpose and significance are not immediately clear to other developers.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Code Style","language":"Java","updated":"2024-10-24","comments":2,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-replace-magic-numbers.md"},{"slug":"svelte-format-complex-css-selectors","title":"Format complex CSS selectors","description":"When working with complex CSS selectors that include multiple nested pseudo-selectors like `:is()`, `:where()`, `:not()`, and `:has()`, maintain consistent formatting and consider breaking long selector chains for better readability. This is particularly important in Svelte components where selectors may need `:global()` wrappers.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Code Style","language":"Other","updated":"2024-10-24","comments":2,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-format-complex-css-selectors.md"},{"slug":"unstructured-extensible-parameter-design","title":"extensible parameter design","description":"Design API parameters to support future extension without breaking changes. Use string enums instead of boolean flags when the parameter might need additional values later, implement comprehensive parameter forwarding with **kwargs, and avoid overly specific parameter designs that limit future flexibility.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"API","language":"Python","updated":"2024-10-23","comments":5,"stars":12116,"raw":"https://awesomereviewers.com/raw/unstructured-extensible-parameter-design.md"},{"slug":"nuxt-conditional-component-bundling","title":"conditional component bundling","description":"When adding conditional components to your application, ensure they are only bundled when actually needed to avoid unnecessary bundle bloat. This is especially important for optional features or components that depend on specific configurations.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Next","language":"Other","updated":"2024-10-22","comments":2,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-conditional-component-bundling.md"},{"slug":"unstructured-maintain-established-naming-conventions","title":"maintain established naming conventions","description":"Ensure all naming follows established patterns and conventions already present in the codebase. When introducing new identifiers or modifying existing ones, they must conform to the team's built-in expectations and standard patterns to maintain consistency across the system.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Naming Conventions","language":"Json","updated":"2024-10-22","comments":2,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-maintain-established-naming-conventions.md"},{"slug":"turborepo-precise-documentation-links","title":"Precise documentation links","description":"When creating error messages related to security, permissions, or access controls, always provide specific links to relevant documentation. Use query parameters, anchors, or other mechanisms to direct users to the exact section of documentation that addresses their issue, rather than linking to generic pages.","repository":"vercel/turborepo","domain":"devtools","topic":"Security","language":"Rust","updated":"2024-10-22","comments":1,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-precise-documentation-links.md"},{"slug":"kotlin-keep-code-clearly-organized","title":"Keep code clearly organized","description":"Maintain code readability and organization by extracting focused, well-named functions and using appropriate scoping. Break down complex logic into smaller, focused functions and utilize extension functions when appropriate to improve code clarity.","repository":"JetBrains/kotlin","domain":"runtimes","topic":"Code Style","language":"Kotlin","updated":"2024-10-21","comments":7,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-keep-code-clearly-organized.md"},{"slug":"azure-quickstart-templates-optional-null-patterns","title":"Optional Null Patterns","description":"When a value is optional in Bicep, use **nullable parameter types** and **null-safe property emission** instead of sentinel values (like empty strings) or `json('null')`.","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Null Handling","language":"Other","updated":"2024-10-21","comments":6,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-optional-null-patterns.md"},{"slug":"db-gpt-use-adapter-upsert","title":"Use Adapter Upsert","description":"When writing to a database/graph store, make the storage adapter the source of truth for schema details and persist data idempotently. Apply these rules:","repository":"eosphoros-ai/DB-GPT","domain":"ai-agents","topic":"Database","language":"Python","updated":"2024-10-21","comments":4,"stars":18703,"raw":"https://awesomereviewers.com/raw/db-gpt-use-adapter-upsert.md"},{"slug":"react-router-use-modern-javascript-patterns","title":"use modern JavaScript patterns","description":"Adopt modern JavaScript syntax and patterns to improve code quality and maintainability. This includes using current language features over deprecated alternatives, proper variable declarations, and modern conditional operators.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Code Style","language":"Markdown","updated":"2024-10-20","comments":3,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-use-modern-javascript-patterns.md"},{"slug":"desktop-disable-sensitive-data-defaults","title":"disable sensitive data defaults","description":"Features that handle sensitive data such as credit card information, passwords, or personal details should never be enabled by default. These features must require explicit user opt-in to ensure users consciously consent to the handling of their sensitive information.","repository":"zen-browser/desktop","domain":"devtools","topic":"Security","language":"JavaScript","updated":"2024-10-20","comments":1,"stars":34711,"raw":"https://awesomereviewers.com/raw/desktop-disable-sensitive-data-defaults.md"},{"slug":"poetry-documentation-clarity-standards","title":"Documentation clarity standards","description":"Ensure documentation is grammatically correct, clearly structured, and uses precise terminology. Avoid verbose or repetitive explanations, and provide specific details that help users understand exactly what will happen.","repository":"python-poetry/poetry","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2024-10-19","comments":5,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-documentation-clarity-standards.md"},{"slug":"maplibre-native-descriptive-named-constants","title":"Descriptive named constants","description":"Replace magic numbers and unclear variables with descriptive named constants using appropriate naming conventions. This improves code readability, maintainability, and prevents errors.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Naming Conventions","language":"C++","updated":"2024-10-19","comments":4,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-descriptive-named-constants.md"},{"slug":"svelte-descriptive-migration-comments","title":"Descriptive migration comments","description":"When adding migration task comments, always include specific details about why manual intervention is required rather than using generic instructions. This helps developers understand the underlying issue and implement the correct fix more efficiently.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Migrations","language":"Other","updated":"2024-10-18","comments":3,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-descriptive-migration-comments.md"},{"slug":"openai-python-documentation-deduping","title":"Documentation Deduping","description":"When updating technical docs, avoid duplicating environment-specific setup or repeated troubleshooting steps. Prefer linking to the canonical upstream documentation for shell/env configuration, and keep only minimal project-specific commands (e.g., where you truly provide “permanent activation” instructions). Also consolidate identical “fix-it” guidance...","repository":"openai/openai-python","domain":"ai-agents","topic":"Documentation","language":"Markdown","updated":"2024-10-18","comments":2,"stars":30731,"raw":"https://awesomereviewers.com/raw/openai-python-documentation-deduping.md"},{"slug":"developer-roadmap-doc-intro-and-links","title":"Doc Intro And Links","description":"For roadmap/technical documentation pages, follow these rules: - **Use correct Markdown structure**: prefer headings (e.g., `## Section`) over HTML line breaks like `<br/>`.","repository":"kamranahmedse/developer-roadmap","domain":"docs","topic":"Documentation","language":"Markdown","updated":"2024-10-17","comments":8,"stars":354523,"raw":"https://awesomereviewers.com/raw/developer-roadmap-doc-intro-and-links.md"},{"slug":"typescript-module-resolution-hierarchy","title":"Module resolution hierarchy","description":"When configuring TypeScript projects, establish a clear understanding of module and type resolution hierarchies, especially when using different package managers like npm or Yarn's Plug'n'Play (PnP).","repository":"microsoft/typescript","domain":"runtimes","topic":"Configurations","language":"TypeScript","updated":"2024-10-17","comments":6,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-module-resolution-hierarchy.md"},{"slug":"tokenizers-optimize-workflow-triggers","title":"Optimize workflow triggers","description":"Configure CI workflows with targeted triggers and path filters to balance thoroughness with efficiency. Run critical build jobs on every commit for affected components, while avoiding unnecessary builds when changes don't impact certain components.","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"CI/CD","language":"Yaml","updated":"2024-10-17","comments":3,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-optimize-workflow-triggers.md"},{"slug":"spring-boot-inherit-organization-security-policies","title":"Inherit organization security policies","description":"Before implementing custom security documentation or procedures, check if your organization already provides standardized security policies that your repository can inherit. This avoids duplication, ensures consistency across projects, and leverages platform-specific security features. For GitHub repositories, organization-level security policies (.github...","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Security","language":"Markdown","updated":"2024-10-17","comments":1,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-inherit-organization-security-policies.md"},{"slug":"nuxt-use-consistent-terminology","title":"Use consistent terminology","description":"Prioritize consistent, clear, and beginner-friendly terminology throughout your codebase and documentation. Choose names that are intuitive for users rather than technically precise but confusing. Maintain consistency with established patterns and style guidelines.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Naming Conventions","language":"Markdown","updated":"2024-10-16","comments":7,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-use-consistent-terminology.md"},{"slug":"react-router-configure-build-tools-properly","title":"configure build tools properly","description":"Ensure build configurations use proper package.json exports fields and TypeScript settings to avoid hard-coded paths and module format inconsistencies. Build tools should be configured to handle module resolution and output formats correctly to prevent runtime issues.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"CI/CD","language":"JavaScript","updated":"2024-10-16","comments":2,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-configure-build-tools-properly.md"},{"slug":"maplibre-native-preallocate-collection-capacity","title":"Preallocate collection capacity","description":"When the final size of a collection is known before adding elements, use `reserve()` to preallocate memory capacity. This optimization eliminates multiple reallocations and copy operations during insertions, improving both performance and memory usage patterns. This is particularly beneficial in performance-critical code paths where collections are...","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Performance Optimization","language":"C++","updated":"2024-10-15","comments":4,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-preallocate-collection-capacity.md"},{"slug":"yoga-optimize-memory-layout","title":"optimize memory layout","description":"Prioritize memory-efficient data structures and algorithms by favoring stack allocation over heap allocation, utilizing bit packing for compact storage, and applying proper bit masking for data integrity. When designing iterators or containers, consider whether operations can avoid dynamic allocation - most backtracking scenarios use empty vectors that...","repository":"facebook/yoga","domain":"runtimes","topic":"Algorithms","language":"Other","updated":"2024-10-15","comments":4,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-optimize-memory-layout.md"},{"slug":"nextchat-measure-performance-concerns","title":"Measure performance concerns","description":"Before assuming performance issues exist, measure actual execution time and resource usage. When performance problems are confirmed, eliminate unnecessary operations like redundant initializations, blocking operations, or wasteful resource usage.","repository":"ChatGPTNextWeb/NextChat","domain":"ai-agents","topic":"Performance Optimization","language":"TSX","updated":"2024-10-14","comments":3,"stars":85721,"raw":"https://awesomereviewers.com/raw/nextchat-measure-performance-concerns.md"},{"slug":"react-native-meaningful-documentation-practices","title":"Meaningful documentation practices","description":"Documentation should enhance code understanding rather than duplicate information already present in the code. Avoid redundant type annotations in JSDoc when type systems like Flow are already used. Instead, focus on explaining intent, complex logic, and providing context that aids debugging and maintenance.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Documentation","language":"JavaScript","updated":"2024-10-14","comments":3,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-meaningful-documentation-practices.md"},{"slug":"typescript-consistent-type-algorithms","title":"Consistent type algorithms","description":"Implement consistent algorithms for type compatibility and comparison across different data structures. When developing type checking logic, ensure similar operations (like assignment compatibility, intersection, or mapping) behave predictably regardless of the underlying type structure.","repository":"microsoft/typescript","domain":"runtimes","topic":"Algorithms","language":"Txt","updated":"2024-10-13","comments":4,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-consistent-type-algorithms.md"},{"slug":"hyprland-no-braces-short-ifs","title":"no braces short ifs","description":"Remove braces around single-statement if blocks to maintain consistent code style and improve readability. This applies to all control flow statements with single statements, including if, else if, and else blocks.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Code Style","language":"C++","updated":"2024-10-12","comments":17,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-no-braces-short-ifs.md"},{"slug":"core-vue-component-type-safety","title":"Vue component type safety","description":"When defining Vue components with TypeScript, use appropriate component definition patterns to ensure proper type inference and avoid breaking type changes.","repository":"vuejs/core","domain":"app-frameworks","topic":"Vue","language":"TSX","updated":"2024-10-12","comments":3,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-vue-component-type-safety.md"},{"slug":"vite-runtime-agnostic-api-design","title":"Runtime-agnostic API design","description":"When designing APIs for systems that support multiple JavaScript runtimes, prioritize decoupling server state from user modules. This approach enables code to run consistently across different environments (Node.js, browsers, edge runtimes) without relying on runtime-specific features.","repository":"vitejs/vite","domain":"devtools","topic":"API","language":"Markdown","updated":"2024-10-11","comments":5,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-runtime-agnostic-api-design.md"},{"slug":"developer-roadmap-use-approved-naming","title":"Use Approved Naming","description":"Use precise, guideline-approved naming for identifiers (tags), technical terminology, and headings—so names are unambiguous, consistent, and match the actual meaning.","repository":"kamranahmedse/developer-roadmap","domain":"docs","topic":"Naming Conventions","language":"Markdown","updated":"2024-10-11","comments":4,"stars":354523,"raw":"https://awesomereviewers.com/raw/developer-roadmap-use-approved-naming.md"},{"slug":"unstructured-enhance-documentation-detail","title":"Enhance documentation detail","description":"Documentation should provide comprehensive detail that enables users to understand impacts and developers to understand implementation. For breaking changes, include migration guidance, deprecated features, and specific functional changes. For technical documentation, provide granular step-by-step explanations that trace execution flow.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Documentation","language":"Markdown","updated":"2024-10-11","comments":2,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-enhance-documentation-detail.md"},{"slug":"vite-configure-ssr-environments","title":"Configure SSR environments","description":"When implementing server-side rendering in Next.js projects that use Vite as a bundler, ensure proper environment separation between client and server code. Create distinct module execution environments to prevent leaking server-only code to the client and to support hot module replacement (HMR) during development.","repository":"vitejs/vite","domain":"devtools","topic":"Next","language":"Markdown","updated":"2024-10-11","comments":2,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-configure-ssr-environments.md"},{"slug":"spring-framework-validate-security-sensitive-inputs","title":"Validate security-sensitive inputs","description":"Always use appropriate validation mechanisms for security-sensitive inputs to prevent vulnerabilities. When implementing validation for headers, origins, user inputs, or any security-related data, consult security documentation and use established validators rather than creating custom validation logic.","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Security","language":"Java","updated":"2024-10-11","comments":1,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-validate-security-sensitive-inputs.md"},{"slug":"influxdb-stable-schema-identifiers","title":"Stable schema identifiers","description":"Use persistent identifiers for schema elements rather than relying on positional information or enumeration, which can break when schema changes occur. Assign unique, immutable IDs to database objects like tables and columns, and ensure these IDs remain stable throughout the object's lifecycle.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Database","language":"Rust","updated":"2024-10-10","comments":5,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-stable-schema-identifiers.md"},{"slug":"tokio-test-diverse-configurations","title":"Test diverse configurations","description":"Configure test suites to run under multiple specialized environments to catch issues that might not appear in standard test runs. This includes testing with different compiler configurations, using specialized testing tools, and properly preserving environment variables when adding test-specific flags.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Testing","language":"Yaml","updated":"2024-10-10","comments":2,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-test-diverse-configurations.md"},{"slug":"tokio-test-production-configurations-too","title":"Test production configurations too","description":"Include testing configurations that mirror production environments to catch issues that might only manifest in release builds. For example, testing with panic=abort can reveal issues that wouldn't appear when testing with the default panic=unwind setting. Similarly, when using specialized testing tools like Miri, configure the appropriate flags to ensure...","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Testing","language":"Yaml","updated":"2024-10-10","comments":2,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-test-production-configurations-too.md"},{"slug":"likec4-respect-provider-context","title":"Respect provider context","description":"Ensure library-provided integration points are used so styles and portals behave correctly in host environments (e.g., shadow roots, webcomponents). Motivation","repository":"likec4/likec4","domain":"devtools","topic":"React","language":"TSX","updated":"2024-10-09","comments":2,"stars":2582,"raw":"https://awesomereviewers.com/raw/likec4-respect-provider-context.md"},{"slug":"maplibre-native-accurate-documentation-references","title":"Accurate documentation references","description":"Ensure all code documentation includes appropriate reference links that are current and accurate. When porting code or migrating between frameworks, preserve all documentation comments with their external references. For API documentation, verify that links point to the correct and up-to-date specification documentation.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Documentation","language":"Kotlin","updated":"2024-10-09","comments":2,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-accurate-documentation-references.md"},{"slug":"ui-preprocess-data-early","title":"Preprocess data early","description":"Transform and prepare data structures at their source rather than during consumption. This includes flattening nested objects, sorting collections, and other manipulations that make data more efficient to process downstream.","repository":"shadcn-ui/ui","domain":"app-frameworks","topic":"Algorithms","language":"TSX","updated":"2024-10-09","comments":2,"stars":90568,"raw":"https://awesomereviewers.com/raw/ui-preprocess-data-early.md"},{"slug":"spring-framework-clone-network-headers-carefully","title":"Clone network headers carefully","description":"When working with HTTP or WebSocket headers in networking code, be cautious about header manipulation, cloning, and lifecycle management. Native headers in server implementations are often pooled and may be recycled after initial processing.","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Networking","language":"Java","updated":"2024-10-08","comments":3,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-clone-network-headers-carefully.md"},{"slug":"aider-isolate-test-environments","title":"Isolate test environments","description":"Tests should be isolated from the production environment to prevent side effects and ensure reproducibility. This principle has two main applications:","repository":"Aider-AI/aider","domain":"ai-agents","topic":"Testing","language":"Python","updated":"2024-10-08","comments":2,"stars":35856,"raw":"https://awesomereviewers.com/raw/aider-isolate-test-environments.md"},{"slug":"hyprland-validate-environment-variables","title":"validate environment variables","description":"Always validate that environment variables are properly defined and consistently named before using them in scripts or build processes. Undefined or misnamed variables can cause silent failures or unexpected behavior in builds and deployments.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Configurations","language":"Shell","updated":"2024-10-08","comments":2,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-validate-environment-variables.md"},{"slug":"cli-use-centralized-loggers","title":"Use centralized loggers","description":"Always use centrally supplied loggers from the invocation context or configuration instead of creating new logger instances, using log.Default(), or direct output methods like fmt.Println(). This ensures consistent debug configuration, proper log level control, and centralized logging behavior across the entire application.","repository":"snyk/cli","domain":"security","topic":"Logging","language":"Go","updated":"2024-10-07","comments":8,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-use-centralized-loggers.md"},{"slug":"opentelemetry-python-explicit-ci-configurations","title":"Explicit CI configurations","description":"Always use explicit, specific configurations in CI/CD pipelines to prevent ambiguity and conflicts. This includes: 1. **Clear environment naming** - Use specific environment names to avoid test execution conflicts between components. For example, prefer `py3{8,9,10,11,12}-test-opentelemetry-proto-protobuf5` over more ambiguous patterns like...","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"CI/CD","language":"Other","updated":"2024-10-07","comments":3,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-explicit-ci-configurations.md"},{"slug":"developer-roadmap-consistent-network-docs","title":"Consistent Network Docs","description":"Ensure all networking-related documentation uses consistent terminology, clean markdown formatting, and readable structure. Apply this standard to any page covering protocols/features like Pub/Sub, WebSockets, SSE, MQTT, etc.","repository":"kamranahmedse/developer-roadmap","domain":"docs","topic":"Networking","language":"Markdown","updated":"2024-10-07","comments":2,"stars":354523,"raw":"https://awesomereviewers.com/raw/developer-roadmap-consistent-network-docs.md"},{"slug":"router-clear-contextual-error-messages","title":"Clear contextual error messages","description":"Error messages should be specific, contextually relevant, and provide actionable guidance to developers. Avoid generic or ambiguous error text that could apply to multiple scenarios.","repository":"TanStack/router","domain":"app-frameworks","topic":"Error Handling","language":"TSX","updated":"2024-10-06","comments":2,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-clear-contextual-error-messages.md"},{"slug":"python-idiomatic-style-commands","title":"Idiomatic Style Commands","description":"When writing style guidance (including README/CONTRIBUTING snippets), keep examples concise and readable: 1) Use idiomatic tool invocations (avoid redundant arguments)","repository":"TheAlgorithms/Python","domain":"docs","topic":"Code Style","language":"Markdown","updated":"2024-10-05","comments":2,"stars":220912,"raw":"https://awesomereviewers.com/raw/python-idiomatic-style-commands.md"},{"slug":"terminal-protocol-response-formatting","title":"Protocol response formatting","description":"When implementing terminal protocol responses (CSI, DCS, OSC sequences), ensure proper formatting with correct terminators and maintain protocol transparency. Terminal protocols require specific response formats with appropriate terminators - CSI responses should use the same C1 mode as the request, DCS responses need proper DCS/ST framing, and OSC...","repository":"microsoft/terminal","domain":"devtools","topic":"Networking","language":"C++","updated":"2024-10-05","comments":2,"stars":99242,"raw":"https://awesomereviewers.com/raw/terminal-protocol-response-formatting.md"},{"slug":"tree-sitter-target-specific-cmake-configurations","title":"target-specific CMake configurations","description":"Use target-specific CMake commands instead of global ones to ensure proper scoping and avoid polluting the global build environment. This improves maintainability and prevents unintended side effects when building multiple targets.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Configurations","language":"Txt","updated":"2024-10-05","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-target-specific-cmake-configurations.md"},{"slug":"awesome-go-categorize-by-primary-purpose","title":"Categorize by primary purpose","description":"When organizing configuration tools, environment management utilities, and settings-related projects, classify them based on their primary function and intended use case rather than their implementation details or secondary benefits. This ensures clear, consistent categorization that helps developers quickly identify the right tools for their configuration...","repository":"avelino/awesome-go","domain":"docs","topic":"Configurations","language":"Markdown","updated":"2024-10-04","comments":2,"stars":151435,"raw":"https://awesomereviewers.com/raw/awesome-go-categorize-by-primary-purpose.md"},{"slug":"influxdb-choose-appropriate-lock-primitives","title":"Choose appropriate lock primitives","description":"Select lock types based on access patterns - prefer RWLock over Mutex for read-heavy operations to enable concurrent reads while allowing exclusive write access. Minimize lock scope to essential operations and avoid holding locks across await points in async code.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Concurrency","language":"Rust","updated":"2024-10-03","comments":8,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-choose-appropriate-lock-primitives.md"},{"slug":"material-ui-document-design-decisions","title":"Document design decisions","description":"When making architectural choices or modifying existing APIs, document your reasoning directly in the code or in type definitions. This helps other developers understand the \"why\" behind changes and prevents future regressions.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Documentation","language":"TSX","updated":"2024-10-03","comments":2,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-document-design-decisions.md"},{"slug":"vite-clean-network-resources","title":"Clean network resources","description":"Always properly close and clean up network connections to prevent memory leaks and resource exhaustion. When establishing WebSocket connections or other network resources, ensure they are explicitly closed and event listeners are removed when no longer needed. Additionally, implement resilient error handling strategies for network operations by using...","repository":"vitejs/vite","domain":"devtools","topic":"Networking","language":"TypeScript","updated":"2024-10-03","comments":2,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-clean-network-resources.md"},{"slug":"vite-optimize-glob-operations","title":"Optimize glob operations","description":"When using glob patterns for file system operations, ensure optimal performance and consistent behavior by configuring glob libraries appropriately and handling paths efficiently:","repository":"vitejs/vite","domain":"devtools","topic":"Algorithms","language":"TypeScript","updated":"2024-10-02","comments":4,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-optimize-glob-operations.md"},{"slug":"opentelemetry-python-adapt-for-linter-compatibility","title":"Adapt for linter compatibility","description":"When writing or modifying code, design patterns and templates to be compatible with linting tools. This is especially important for generated code and template systems.","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Code Style","language":"Other","updated":"2024-10-02","comments":2,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-adapt-for-linter-compatibility.md"},{"slug":"prettier-consistent-spacing-patterns","title":"consistent spacing patterns","description":"Maintain consistent spacing patterns around operators, keywords, and interpolation syntax throughout the codebase. This improves readability and reduces cognitive load when scanning code.","repository":"prettier/prettier","domain":"devtools","topic":"Code Style","language":"Other","updated":"2024-10-01","comments":6,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-consistent-spacing-patterns.md"},{"slug":"cli-write-actionable-documentation","title":"Write actionable documentation","description":"Documentation should be written in active voice with concrete examples and clear context. Avoid passive constructions and vague references that leave readers guessing about implementation details or expectations.","repository":"snyk/cli","domain":"security","topic":"Documentation","language":"Markdown","updated":"2024-10-01","comments":4,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-write-actionable-documentation.md"},{"slug":"fiber-configurable-logging-controls","title":"Configurable logging controls","description":"Make logging behavior configurable rather than hardcoded, and avoid manipulating global state for logging purposes. Provide configuration options to enable/disable specific log messages, especially for warnings or debug information that could become spammy. Instead of overwriting global variables like os.Stdout and os.Stderr for testing, use dependency...","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Logging","language":"Go","updated":"2024-10-01","comments":2,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-configurable-logging-controls.md"},{"slug":"spring-boot-alphabetical-ordering-requirement","title":"Alphabetical ordering requirement","description":"Always maintain alphabetical ordering for lists of elements including dependencies, modules, configuration entries, and other similar collections. This convention improves code organization, makes it easier to locate items, prevents duplications, and ensures consistency across the codebase.","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Code Style","language":"Other","updated":"2024-09-30","comments":6,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-alphabetical-ordering-requirement.md"},{"slug":"react-router-implement-recursive-safeguards","title":"Implement recursive safeguards","description":"When implementing recursive algorithms, always include cycle detection and early termination conditions to prevent infinite recursion and improve performance. This is especially critical in graph traversal, AST processing, and dependency analysis where circular references can occur.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Algorithms","language":"TypeScript","updated":"2024-09-30","comments":2,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-implement-recursive-safeguards.md"},{"slug":"core-choose-semantic-descriptive-names","title":"Choose semantic descriptive names","description":"Names should be clear, descriptive and follow consistent patterns. Choose names that accurately reflect the purpose and behavior of the code element:","repository":"vuejs/core","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2024-09-29","comments":6,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-choose-semantic-descriptive-names.md"},{"slug":"prettier-modern-configuration-formats","title":"Modern configuration formats","description":"Prefer ES module configuration files with TypeScript annotations over JSON formats for better developer experience and tooling support. Use `.js` or `.mjs` extensions with proper type annotations to enable IDE autocompletion and type safety.","repository":"prettier/prettier","domain":"devtools","topic":"Configurations","language":"Markdown","updated":"2024-09-29","comments":5,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-modern-configuration-formats.md"},{"slug":"tree-sitter-cmake-custom-command-design","title":"CMake custom command design","description":"When implementing CMake build automation for code generation, carefully choose between `add_custom_command` and `add_custom_target` based on your execution requirements. Use `add_custom_command` with explicit OUTPUT and DEPENDS for files that should be automatically generated when missing or when dependencies change. Add `add_custom_target` only when you...","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"CI/CD","language":"Txt","updated":"2024-09-29","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-cmake-custom-command-design.md"},{"slug":"brew-avoid-variable-name-abbreviations","title":"Avoid variable name abbreviations","description":"Use complete, descriptive variable names instead of abbreviations to enhance code readability and maintainability. Short abbreviations like `dir`, `repo`, and single-letter variables often obscure the purpose of the variable and make code harder to understand for new contributors.","repository":"Homebrew/brew","domain":"devtools","topic":"Naming Conventions","language":"Shell","updated":"2024-09-25","comments":4,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-avoid-variable-name-abbreviations.md"},{"slug":"spring-boot-reference-existing-configurations","title":"Reference existing configurations","description":"When setting up configuration files, reference existing configuration sources rather than duplicating values or logic. This creates a single source of truth, reduces maintenance overhead, and prevents inconsistencies between different environments.","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Configurations","language":"Yaml","updated":"2024-09-25","comments":3,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-reference-existing-configurations.md"},{"slug":"nextchat-consistent-styling-approach","title":"Consistent styling approach","description":"Maintain consistency in styling approaches within components and across the codebase. Avoid mixing className and inline styles in the same component - choose one approach and stick with it throughout the component. When working with reusable UI library components, keep them generic by using className for styling rather than adding component-specific inline...","repository":"ChatGPTNextWeb/NextChat","domain":"ai-agents","topic":"Code Style","language":"TSX","updated":"2024-09-25","comments":2,"stars":85721,"raw":"https://awesomereviewers.com/raw/nextchat-consistent-styling-approach.md"},{"slug":"spring-boot-consistent-terminology-usage","title":"Consistent terminology usage","description":"When referring to technical concepts in documentation and code comments, use proper full names and consistent terminology: 1. Use full official names instead of abbreviations or shortened forms (e.g., \"Kubernetes\" instead of \"K8s\")","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Naming Conventions","language":"Other","updated":"2024-09-25","comments":2,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-consistent-terminology-usage.md"},{"slug":"svelte-write-clear-test-cases","title":"Write clear test cases","description":"Tests should be written with clear intent and expectations. Use descriptive names that accurately reflect what the test validates, and include both positive and negative test cases to demonstrate expected behavior through contrast. Organize tests in appropriate suites based on their purpose (e.g., validation tests vs. runtime tests).","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Testing","language":"Other","updated":"2024-09-25","comments":2,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-write-clear-test-cases.md"},{"slug":"opentofu-defensive-null-handling","title":"Defensive null handling","description":"Always initialize data structures before use, particularly before accessing them in loops or conditional blocks. Check for null values before accessing their properties, and provide clear, contextual error messages when null values are not allowed.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Null Handling","language":"Go","updated":"2024-09-24","comments":5,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-defensive-null-handling.md"},{"slug":"brew-document-configuration-decisions","title":"Document configuration decisions","description":"When making configuration changes, especially those that deviate from standard practices or involve deprecation notices, always include clear explanatory comments. Temporary modifications to configuration settings should document both the reason and expected duration of the exception.","repository":"Homebrew/brew","domain":"devtools","topic":"Configurations","language":"Yaml","updated":"2024-09-24","comments":2,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-document-configuration-decisions.md"},{"slug":"nextchat-package-manager-consistency","title":"Package manager consistency","description":"Maintain consistent package manager usage throughout the project lifecycle. When a project uses yarn (indicated by yarn.lock), avoid committing npm's package-lock.json file, as having both lock files can cause dependency resolution conflicts and inconsistent builds across different environments.","repository":"ChatGPTNextWeb/NextChat","domain":"ai-agents","topic":"Configurations","language":"Json","updated":"2024-09-24","comments":2,"stars":85721,"raw":"https://awesomereviewers.com/raw/nextchat-package-manager-consistency.md"},{"slug":"poetry-use-descriptive-names","title":"Use descriptive names","description":"Variable, method, and class names should clearly and accurately describe their purpose, content, or behavior. Misleading or vague names create confusion and make code harder to understand and maintain.","repository":"python-poetry/poetry","domain":"devtools","topic":"Naming Conventions","language":"Python","updated":"2024-09-23","comments":7,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-use-descriptive-names.md"},{"slug":"prettier-maintain-api-backward-compatibility","title":"maintain API backward compatibility","description":"When evolving public APIs, prioritize backward compatibility and avoid breaking changes to existing interfaces. Support both legacy and new syntax when standards evolve, and clearly document any deprecations.","repository":"prettier/prettier","domain":"devtools","topic":"API","language":"JavaScript","updated":"2024-09-23","comments":4,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-maintain-api-backward-compatibility.md"},{"slug":"mastodon-avoid-redundant-computations","title":"avoid redundant computations","description":"Identify and eliminate computations that are performed repeatedly when they could be executed once. This includes moving loop-invariant checks outside of loops and reducing callback overhead that creates unnecessary function declarations.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Performance Optimization","language":"JavaScript","updated":"2024-09-23","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-avoid-redundant-computations.md"},{"slug":"argo-cd-null-check-before-method-calls","title":"null-check before method calls","description":"Always verify that properties are not null or undefined before calling methods on them to prevent runtime errors. This is especially important when filtering, mapping, or processing arrays where some objects may have missing or undefined properties.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Null Handling","language":"TSX","updated":"2024-09-21","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-null-check-before-method-calls.md"},{"slug":"spring-framework-spring-code-style","title":"Spring code style","description":"Follow Spring Framework's code style guidelines to ensure consistency\\ \\ across the codebase. Key rules include:\\n\\n1. **Import statements**: \\n   - Use\\ \\ specific imports rather than wildcard imports","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Code Style","language":"Java","updated":"2024-09-20","comments":13,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-spring-code-style.md"},{"slug":"union-choose-appropriate-async-primitives","title":"Choose appropriate async primitives","description":"Select async/concurrency primitives based on your specific usage patterns and requirements rather than defaulting to generic solutions. Different async contexts benefit from different tools:","repository":"unionlabs/union","domain":"cloud-infra","topic":"Concurrency","language":"Rust","updated":"2024-09-20","comments":3,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-choose-appropriate-async-primitives.md"},{"slug":"ui-complete-configuration-paths","title":"Complete configuration paths","description":"Always verify that configuration files include all necessary file paths and extensions, particularly for framework-specific settings. Common issues include missing file extensions for TypeScript files, incorrect directory paths, and configurations that don't account for framework-specific directory structures.","repository":"shadcn-ui/ui","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2024-09-19","comments":3,"stars":90568,"raw":"https://awesomereviewers.com/raw/ui-complete-configuration-paths.md"},{"slug":"vite-complete-deployment-commands","title":"Complete deployment commands","description":"Always ensure build commands in CI/CD configurations include all necessary steps for successful deployment, particularly dependency installation. Incomplete commands are a common source of deployment failures.","repository":"vitejs/vite","domain":"devtools","topic":"CI/CD","language":"Markdown","updated":"2024-09-19","comments":2,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-complete-deployment-commands.md"},{"slug":"nextchat-use-semantically-accurate-names","title":"Use semantically accurate names","description":"Variable, method, and type names should precisely reflect their actual content, purpose, or scope. Names that misrepresent what they contain or do create confusion and make code harder to understand and maintain.","repository":"ChatGPTNextWeb/NextChat","domain":"ai-agents","topic":"Naming Conventions","language":"TypeScript","updated":"2024-09-18","comments":3,"stars":85721,"raw":"https://awesomereviewers.com/raw/nextchat-use-semantically-accurate-names.md"},{"slug":"react-router-graceful-error-handling","title":"graceful error handling","description":"Implement error handling that gracefully degrades when operations fail, uses consistent reporting patterns, and considers security implications. Always wrap potentially failing operations in try-catch blocks, provide meaningful fallback behavior, and follow established error reporting conventions.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Error Handling","language":"TSX","updated":"2024-09-18","comments":3,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-graceful-error-handling.md"},{"slug":"linux-use-semantic-identifiers","title":"Use semantic identifiers","description":"Choose semantically appropriate identifiers and types that clearly represent their purpose. This includes using the correct data type (e.g., boolean for flags instead of integers) and ensuring proper spelling of all identifiers.","repository":"torvalds/linux","domain":"runtimes","topic":"Naming Conventions","language":"C","updated":"2024-09-18","comments":2,"stars":197350,"raw":"https://awesomereviewers.com/raw/linux-use-semantic-identifiers.md"},{"slug":"turborepo-minimize-lock-duration","title":"Minimize lock duration","description":"When using locks in asynchronous code, minimize the scope and duration for which locks are held, especially across `.await` points. Holding locks during asynchronous operations can block progress in other tasks and lead to decreased concurrency or even deadlocks.","repository":"vercel/turborepo","domain":"devtools","topic":"Concurrency","language":"Rust","updated":"2024-09-16","comments":3,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-minimize-lock-duration.md"},{"slug":"jan-avoid-external-urls","title":"Avoid external URLs","description":"Links to external repositories or domains in documentation and code can create security vulnerabilities through URL hijacking attacks. Malicious actors could potentially gain control of external domains and redirect users to harmful content or credential harvesting sites.","repository":"menloresearch/jan","domain":"llm-infra","topic":"Security","language":"Markdown","updated":"2024-09-16","comments":1,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-avoid-external-urls.md"},{"slug":"nest-comprehensive-dependency-security-checks","title":"Comprehensive dependency security checks","description":"Regularly check dependencies for security vulnerabilities using multiple sources, not just npm audit. As shown in the discussion, some vulnerabilities may not be reported by npm audit but are still present and documented elsewhere.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Security","language":"Json","updated":"2024-09-16","comments":1,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-comprehensive-dependency-security-checks.md"},{"slug":"nest-proactive-dependency-security","title":"Proactive dependency security","description":"Always maintain dependencies at their latest secure versions, even when automated vulnerability scanning tools (like `npm audit`) don't report issues. Regularly check release notes and security advisories for your dependencies, as some security fixes may not be detected by automated tools.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Security","language":"Json","updated":"2024-09-16","comments":1,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-proactive-dependency-security.md"},{"slug":"unstructured-environment-variable-patterns","title":"Environment variable patterns","description":"Use consistent patterns for environment variable handling in shell scripts. Always provide sensible defaults using the `${VAR:-default}` syntax, validate required variables early with clear error messages, and preserve the ability to override configuration values.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Configurations","language":"Shell","updated":"2024-09-13","comments":5,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-environment-variable-patterns.md"},{"slug":"influxdb-type-over-primitives","title":"Type over primitives","description":"Use domain-specific types instead of primitives (like strings, []byte, or generic maps) to represent domain concepts in algorithms. This makes assumptions explicit, prevents errors, and enables stronger type checking. For example, rather than passing raw byte slices for different kinds of series keys:","repository":"influxdata/influxdb","domain":"data-systems","topic":"Algorithms","language":"Go","updated":"2024-09-13","comments":3,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-type-over-primitives.md"},{"slug":"comfyui-optimize-cache-key-design","title":"Optimize cache key design","description":"Design cache keys to avoid performance pitfalls and ensure reliable cache behavior. Cache keys should be lightweight, hashable, and deterministic to prevent unnecessary cache misses and memory bloat.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Caching","language":"Python","updated":"2024-09-12","comments":3,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-optimize-cache-key-design.md"},{"slug":"maplibre-native-cross-platform-test-management","title":"Cross-platform test management","description":"When working with tests that run across multiple platforms (iOS, Android, etc.), ensure proper configuration and handling of platform-specific issues:","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Testing","language":"Json","updated":"2024-09-12","comments":2,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-cross-platform-test-management.md"},{"slug":"compose-explicit-configuration-management","title":"explicit configuration management","description":"Make all configuration settings explicit and well-documented, avoiding implicit defaults and auto-detection where possible. This includes dependency versions, build flags, environment variables, and tool configurations.","repository":"docker/compose","domain":"orchestration","topic":"Configurations","language":"Other","updated":"2024-09-11","comments":7,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-explicit-configuration-management.md"},{"slug":"brew-decouple-ci-from-code","title":"Decouple CI from code","description":"Separate CI configuration from code that serves other purposes. When variables or settings affect both user-facing behavior and CI pipeline behavior, extract CI-specific logic into dedicated configuration files. This prevents unintended CI pipeline changes when updating user-facing functionality and allows for better coordination between code changes and CI...","repository":"Homebrew/brew","domain":"devtools","topic":"CI/CD","language":"Shell","updated":"2024-09-11","comments":2,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-decouple-ci-from-code.md"},{"slug":"svelte-follow-snake-case-convention","title":"Follow snake_case convention","description":"Consistently use snake_case naming throughout the codebase for variables, methods, and identifiers to maintain established conventions. When the codebase has adopted snake_case as the standard, all new code should follow this pattern rather than introducing camelCase or other naming styles.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2024-09-11","comments":2,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-follow-snake-case-convention.md"},{"slug":"cli-use-centralized-configuration-access","title":"Use centralized configuration access","description":"Always access configuration values through the configuration object rather than direct helper functions or environment variables. This ensures consistent behavior across the application and provides proper abstraction from the underlying value sources.","repository":"snyk/cli","domain":"security","topic":"Configurations","language":"Go","updated":"2024-09-10","comments":4,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-use-centralized-configuration-access.md"},{"slug":"argo-cd-environment-variable-validation","title":"Environment variable validation","description":"Scripts that depend on environment variables should validate their presence and values early, providing clear error messages that guide users toward resolution. When checking environment variables, ensure logical flow doesn't create unreachable code blocks.","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Configurations","language":"Shell","updated":"2024-09-10","comments":2,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-environment-variable-validation.md"},{"slug":"jan-use-centralized-model-state","title":"Use centralized model state","description":"Always access AI model information, parameters, and configuration through centralized state management rather than direct access or hardcoded values. This ensures consistency, maintainability, and proper separation of concerns when working with AI models.","repository":"menloresearch/jan","domain":"llm-infra","topic":"AI","language":"TSX","updated":"2024-09-10","comments":2,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-use-centralized-model-state.md"},{"slug":"langchain-notebook-dependency-install","title":"Notebook dependency install","description":"When authoring AI/LLM tutorials in Jupyter notebooks, ensure dependency installation is done with correct notebook syntax and that nearby explanatory text is unambiguous.","repository":"langchain-ai/langchain","domain":"ai-agents","topic":"AI","language":"Other","updated":"2024-09-10","comments":2,"stars":136312,"raw":"https://awesomereviewers.com/raw/langchain-notebook-dependency-install.md"},{"slug":"serverless-complete-cicd-documentation","title":"Complete CI/CD documentation","description":"Ensure all CI/CD documentation is comprehensive and technically accurate, covering complete workflows and tooling capabilities. Incomplete or incorrect documentation leads to deployment failures, misconfigurations, and developer confusion.","repository":"serverless/serverless","domain":"cloud-infra","topic":"CI/CD","language":"Markdown","updated":"2024-09-10","comments":2,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-complete-cicd-documentation.md"},{"slug":"vite-escape-html-content-properly","title":"Escape HTML content properly","description":"Always use specialized HTML escaping functions when outputting dynamic content to prevent Cross-Site Scripting (XSS) vulnerabilities. Don't rely on general serialization methods like JSON.stringify which may not correctly escape all HTML-sensitive characters or may add unnecessary escapes.","repository":"vitejs/vite","domain":"devtools","topic":"Security","language":"TypeScript","updated":"2024-09-10","comments":1,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-escape-html-content-properly.md"},{"slug":"spring-boot-document-configuration-properties-completely","title":"Document configuration properties completely","description":"Configuration properties should be fully documented with clear descriptions, explicit default values, and proper metadata. This helps users understand and configure the application correctly.","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Configurations","language":"Java","updated":"2024-09-09","comments":6,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-document-configuration-properties-completely.md"},{"slug":"spring-boot-property-description-conventions","title":"Property description conventions","description":"When documenting configuration properties in Spring Boot applications, follow these conventions for clarity and consistency: 1. Avoid starting descriptions with articles like \"the\" or \"a\"","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Documentation","language":"Java","updated":"2024-09-09","comments":5,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-property-description-conventions.md"},{"slug":"kubeflow-structure-for-navigation","title":"Structure for navigation","description":"Documentation should be structured to optimize user navigation and information discovery. When organizing documentation elements: 1. Group related information into logical categories to help users find relevant content faster","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Documentation","language":"Yaml","updated":"2024-09-09","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-structure-for-navigation.md"},{"slug":"turborepo-handle-errors-appropriately","title":"Handle errors appropriately","description":"Implement appropriate error handling strategies based on the criticality of operations. For non-critical operations that could fail (like file operations and JSON parsing), use try/catch blocks to handle errors gracefully and continue execution with proper logging. For critical operations where execution cannot reasonably continue, provide clear error...","repository":"vercel/turborepo","domain":"devtools","topic":"Error Handling","language":"TypeScript","updated":"2024-09-09","comments":2,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-handle-errors-appropriately.md"},{"slug":"kubeflow-centralize-configuration-values","title":"Centralize configuration values","description":"Store all configuration values in dedicated configuration files rather than hardcoding them throughout the application. This makes the codebase more maintainable and reduces the need for code changes when configurations change.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Configurations","language":"TypeScript","updated":"2024-09-06","comments":5,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-centralize-configuration-values.md"},{"slug":"kubeflow-structured-documentation-with-examples","title":"Structured documentation with examples","description":"Create comprehensive documentation with clear structure and practical examples. Documentation should include: 1. **Standard documentation files** like README.md, CHANGELOG.md, and CONTRIBUTING.md, even if they primarily link to external resources. Search engines index these standard files, improving project discoverability.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Documentation","language":"Markdown","updated":"2024-09-06","comments":5,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-structured-documentation-with-examples.md"},{"slug":"influxdb-complete-schema-management","title":"Complete schema management","description":"When working with database systems that have flexible schemas (like InfluxDB), ensure complete schema discovery and proper merging from all data sources before processing operations. Incomplete schema handling leads to missing columns, data corruption, or export failures.","repository":"influxdata/influxdb","domain":"data-systems","topic":"Database","language":"Go","updated":"2024-09-05","comments":3,"stars":30268,"raw":"https://awesomereviewers.com/raw/influxdb-complete-schema-management.md"},{"slug":"ui-complete-optional-chaining","title":"Complete optional chaining","description":"When using optional chaining (`?.`), ensure that **all subsequent operations** in the chain are also protected from null/undefined values. A common mistake is only protecting the initial object access while leaving subsequent method calls or property accesses vulnerable.","repository":"shadcn-ui/ui","domain":"app-frameworks","topic":"Null Handling","language":"TSX","updated":"2024-09-05","comments":3,"stars":90568,"raw":"https://awesomereviewers.com/raw/ui-complete-optional-chaining.md"},{"slug":"ui-prevent-object-recreations","title":"Prevent object recreations","description":"Avoid creating new objects and functions repeatedly during renders to reduce memory pressure and improve performance. Implement these practices: 1. **Move static data outside components:**","repository":"shadcn-ui/ui","domain":"app-frameworks","topic":"Performance Optimization","language":"TSX","updated":"2024-09-05","comments":3,"stars":90568,"raw":"https://awesomereviewers.com/raw/ui-prevent-object-recreations.md"},{"slug":"db-gpt-use-explicit-types","title":"Use explicit types","description":"在组件/页面代码中保持表达清晰、类型明确，避免冗余与 `any`。\\n\\n- 布尔表达式：不要写 `flag ? true : false`，可直接传布尔值本身。\\n\\ \\  - 例如：\\n    ```tsx\\n    // bad\\n    multiple={data.is_list ? true : false}","repository":"eosphoros-ai/DB-GPT","domain":"ai-agents","topic":"Code Style","language":"TSX","updated":"2024-09-04","comments":3,"stars":18703,"raw":"https://awesomereviewers.com/raw/db-gpt-use-explicit-types.md"},{"slug":"vite-evolve-apis-with-compatibility","title":"Evolve APIs with compatibility","description":"When evolving APIs, maintain backwards compatibility while introducing new features by following a staged deprecation approach: 1. Introduce new APIs alongside existing ones without deprecation warnings","repository":"vitejs/vite","domain":"devtools","topic":"API","language":"TypeScript","updated":"2024-09-03","comments":4,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-evolve-apis-with-compatibility.md"},{"slug":"cli-use-file-locks","title":"Use file locks","description":"When multiple processes or goroutines need to access shared file system resources concurrently, use file locks (flock) to prevent race conditions and ensure mutual exclusion. This is particularly important for operations like certificate file management, directory creation, and other file system modifications that could conflict.","repository":"snyk/cli","domain":"security","topic":"Concurrency","language":"Go","updated":"2024-09-03","comments":2,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-use-file-locks.md"},{"slug":"openpilot-maintain-cicd-parity","title":"maintain CI/CD parity","description":"Ensure CI/CD pipeline tools run with the same configuration, flags, and behavior as developers use locally. This prevents masking errors in CI/CD that developers would encounter in their local environment and maintains consistency in the development workflow.","repository":"commaai/openpilot","domain":"ml-systems","topic":"CI/CD","language":"Shell","updated":"2024-09-03","comments":2,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-maintain-cicd-parity.md"},{"slug":"kubeflow-centralize-configuration-constants","title":"Centralize configuration constants","description":"Store configuration constants, defaults, and environment variable mappings in dedicated configuration files rather than duplicating them across the codebase. This provides a single source of truth, improves maintainability, and reduces errors from inconsistent values.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Configurations","language":"Python","updated":"2024-09-02","comments":4,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-centralize-configuration-constants.md"},{"slug":"opentelemetry-python-choose-data-structures-wisely","title":"Choose data structures wisely","description":"Select data structures based on your specific access patterns and performance requirements. Using the right data structure can simplify your code and improve performance significantly.","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Algorithms","language":"Python","updated":"2024-09-02","comments":4,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-choose-data-structures-wisely.md"},{"slug":"union-validate-network-addresses","title":"Validate network addresses","description":"Always validate network addresses according to their specific protocol requirements and maintain consistent encoding throughout the application. Different blockchain networks have distinct address formats and validation rules that must be enforced to prevent communication failures.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Networking","language":"Other","updated":"2024-09-02","comments":2,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-validate-network-addresses.md"},{"slug":"likec4-avoid-raw-injection","title":"avoid raw injection","description":"When generating and inserting HTML or CSS as raw strings, treat it as untrusted input and avoid direct injection into the DOM. Constructing <style> tags or innerHTML from dynamic values can enable XSS if any part of those values is attacker-controlled.","repository":"likec4/likec4","domain":"devtools","topic":"Security","language":"TSX","updated":"2024-09-01","comments":1,"stars":2582,"raw":"https://awesomereviewers.com/raw/likec4-avoid-raw-injection.md"},{"slug":"langfuse-avoid-automatic-package-execution","title":"Avoid automatic package execution","description":"Using `npx --yes` bypasses security prompts and automatically installs packages without verification, which could lead to supply chain attacks if package names are typosquatted or compromised. Always install required tools as explicit dependencies in your project.","repository":"langfuse/langfuse","domain":"observability","topic":"Security","language":"Shell","updated":"2024-08-31","comments":1,"stars":13574,"raw":"https://awesomereviewers.com/raw/langfuse-avoid-automatic-package-execution.md"},{"slug":"spring-framework-spring-annotation-best-practices","title":"Spring annotation best practices","description":"When working with Spring annotations, follow these guidelines to avoid common issues: 1. **Use interface types for dependency injection**: When autowiring dependencies, declare fields using the interface type rather than the implementation class. This ensures proper behavior with proxies and AOP.","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Spring","language":"Other","updated":"2024-08-30","comments":4,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-spring-annotation-best-practices.md"},{"slug":"logseq-defer-expensive-operations","title":"Defer expensive operations","description":"Avoid performing expensive computations until they are actually needed, and eliminate redundant work in hot code paths. This includes delaying database pulls, moving expensive object creation outside functions, and removing unnecessary operations.","repository":"logseq/logseq","domain":"app-frameworks","topic":"Performance Optimization","language":"Other","updated":"2024-08-29","comments":5,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-defer-expensive-operations.md"},{"slug":"turborepo-use-affected-mode","title":"Use affected mode","description":"Optimize CI pipelines by running tasks only on packages affected by code changes. Use the `--affected` flag in Turborepo commands to automatically filter tasks to packages with changes, significantly reducing CI execution time in large monorepos.","repository":"vercel/turborepo","domain":"devtools","topic":"CI/CD","language":"Other","updated":"2024-08-28","comments":3,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-use-affected-mode.md"},{"slug":"svelte-document-non-obvious-behavior","title":"Document non-obvious behavior","description":"Write documentation that explains behavior and context that may not be obvious to newcomers, even if it seems clear to experienced developers. Include explanations for domain-specific concepts, data structure representations, and implicit behaviors that could confuse someone unfamiliar with the codebase.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Documentation","language":"TypeScript","updated":"2024-08-28","comments":2,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-document-non-obvious-behavior.md"},{"slug":"chef-consistent-descriptive-naming-patterns","title":"Consistent descriptive naming patterns","description":"Use clear, descriptive names that follow consistent patterns across the codebase. For methods and properties: 1. Use intention-revealing names that clearly indicate purpose","repository":"chef/chef","domain":"cloud-infra","topic":"Naming Conventions","language":"Ruby","updated":"2024-08-27","comments":7,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-consistent-descriptive-naming-patterns.md"},{"slug":"developer-roadmap-fail-fast-cicd-steps","title":"Fail-Fast CI/CD Steps","description":"When building CI/CD pipelines, keep them scope-focused and deterministic, and add explicit quality gates so failures stop the deployment. Apply: - Put workflows in the conventional location and naming your team standard expects (e.g., `.github/workflows/main.yml`).","repository":"kamranahmedse/developer-roadmap","domain":"docs","topic":"CI/CD","language":"Markdown","updated":"2024-08-27","comments":5,"stars":354523,"raw":"https://awesomereviewers.com/raw/developer-roadmap-fail-fast-cicd-steps.md"},{"slug":"query-deterministic-error-propagation","title":"Deterministic Error Propagation","description":"When handling async work, cancellation, retries, or hydration/prefetch, ensure errors are propagated consistently and control flow can’t leave callers stuck.","repository":"tanstack/query","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2024-08-27","comments":4,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-deterministic-error-propagation.md"},{"slug":"bazel-organize-code-for-readability","title":"Organize code for readability","description":"Structure code to minimize complexity and improve readability through logical organization. This includes using early returns to reduce nesting levels and ordering operations in a logical sequence.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Code Style","language":"Python","updated":"2024-08-26","comments":2,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-organize-code-for-readability.md"},{"slug":"maplibre-native-conditional-observability-instrumentation","title":"Conditional observability instrumentation","description":"Wrap all tracing, profiling, and debugging instrumentation in appropriate conditional compilation blocks (like `MLN_TRACY_ENABLE`) to prevent performance overhead in production builds. When adding trace points:","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Observability","language":"C++","updated":"2024-08-26","comments":2,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-conditional-observability-instrumentation.md"},{"slug":"mastodon-consistent-route-nesting","title":"consistent route nesting","description":"Maintain consistent URL patterns and nesting structures across similar API endpoints to ensure predictable and intuitive interfaces. When designing routes for related resources, apply the same nesting strategy throughout the application rather than mixing top-level and nested approaches.","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"API","language":"Other","updated":"2024-08-25","comments":2,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-consistent-route-nesting.md"},{"slug":"mermaid-pin-actions-shas","title":"Pin Actions SHAs","description":"For security-sensitive CI workflows, pin third-party GitHub Actions to immutable commit SHAs (not floating tags like `v3`/`v4`). This prevents supply-chain risk from upstream tag changes. Use Dependabot (or equivalent) to keep pinned SHAs updated automatically.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Security","language":"Yaml","updated":"2024-08-24","comments":1,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-pin-actions-shas.md"},{"slug":"kubeflow-environment-variable-management","title":"Environment variable management","description":"Manage environment variables in Docker configurations with appropriate scope, placement, and documentation: 1. **Set environment variables with appropriate scope**:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Configurations","language":"Dockerfile","updated":"2024-08-23","comments":5,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-environment-variable-management.md"},{"slug":"maplibre-native-lock-responsibly-always","title":"Lock responsibly, always","description":"Ensure proper management of locks and concurrent resources throughout their lifecycle. When implementing concurrency: 1. Encapsulate locking/unlocking in appropriate methods rather than duplicating code","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Concurrency","language":"Java","updated":"2024-08-23","comments":2,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-lock-responsibly-always.md"},{"slug":"core-strict-props-event-handling","title":"Strict props event handling","description":"Enforce strict typing and consistent handling of component props and events to ensure type safety, runtime validation, and maintainable component interfaces. Key guidelines:","repository":"vuejs/core","domain":"app-frameworks","topic":"Vue","language":"TypeScript","updated":"2024-08-22","comments":6,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-strict-props-event-handling.md"},{"slug":"argo-cd-consolidate-rbac-permissions","title":"consolidate RBAC permissions","description":"Avoid duplicating RBAC permissions across different deployment configurations or installation modes. When the same service or controller needs permissions in multiple contexts (e.g., cluster-wide vs namespace-scoped deployments), consolidate these permissions into a unified, well-defined role structure rather than maintaining separate, potentially...","repository":"argoproj/argo-cd","domain":"orchestration","topic":"Security","language":"Yaml","updated":"2024-08-22","comments":1,"stars":20149,"raw":"https://awesomereviewers.com/raw/argo-cd-consolidate-rbac-permissions.md"},{"slug":"core-maintain-consistent-code-style","title":"Maintain consistent code style","description":"Follow project-wide code style conventions to ensure consistency and\\ \\ readability. Key practices include:\\n\\n1. Use consistent spacing and formatting:\\n\\ \\   - Maintain blank lines between test cases","repository":"vuejs/core","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2024-08-21","comments":5,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-maintain-consistent-code-style.md"},{"slug":"kubeflow-standardize-network-tools","title":"Standardize network tools","description":"When performing network operations in build scripts or containers, prefer `curl` over `wget` for HTTP requests to standardize dependencies and improve portability. Use the specific flags `-fsSL` for silent operation with proper error handling, and explicitly specify output destinations.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Networking","language":"Dockerfile","updated":"2024-08-21","comments":4,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-standardize-network-tools.md"},{"slug":"serverless-provide-contextual-explanations","title":"Provide contextual explanations","description":"Documentation should explain the reasoning, context, and practical implications behind code examples, not just show syntax or commands. Include explanations of why developers would use specific approaches, how different options work together, and what to expect from running commands.","repository":"serverless/serverless","domain":"cloud-infra","topic":"Documentation","language":"Markdown","updated":"2024-08-21","comments":3,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-provide-contextual-explanations.md"},{"slug":"router-defensive-null-checking","title":"defensive null checking","description":"Always perform explicit null and undefined checks before accessing object properties or methods to prevent runtime errors. This defensive programming approach ensures code robustness when dealing with potentially missing data.","repository":"TanStack/router","domain":"app-frameworks","topic":"Null Handling","language":"Markdown","updated":"2024-08-21","comments":2,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-defensive-null-checking.md"},{"slug":"checkov-meaningful-identifier-names","title":"Meaningful identifier names","description":"Choose descriptive and semantic identifiers that clearly convey purpose, role, and behavior. Avoid vague, generic names in favor of specific ones that enhance code readability and self-documentation.","repository":"bridgecrewio/checkov","domain":"security","topic":"Naming Conventions","language":"Python","updated":"2024-08-20","comments":7,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-meaningful-identifier-names.md"},{"slug":"kotlin-use-defensive-null-checks","title":"Use defensive null checks","description":"When working with properties or methods that could potentially be null, use Kotlin's null safety features defensively even if you believe the value should never be null. This prevents runtime exceptions when assumptions change or when interacting with Java/third-party code.","repository":"JetBrains/kotlin","domain":"runtimes","topic":"Null Handling","language":"Kotlin","updated":"2024-08-19","comments":4,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-use-defensive-null-checks.md"},{"slug":"developer-roadmap-treat-untrusted-data-safely","title":"Treat Untrusted Data Safely","description":"Security rule: Treat anything from the client (sessions, form fields, query params, template-bound values) as untrusted at runtime. Enforce safety on the server and use framework safe defaults for output encoding/sanitization. Only use “bypass”/escape hatches when you can prove the value’s origin and safety, and document that proof.","repository":"kamranahmedse/developer-roadmap","domain":"docs","topic":"Security","language":"Markdown","updated":"2024-08-18","comments":4,"stars":354523,"raw":"https://awesomereviewers.com/raw/developer-roadmap-treat-untrusted-data-safely.md"},{"slug":"turborepo-link-terms-provide-examples","title":"Link terms, provide examples","description":"When writing technical documentation, link to related concepts the first time they are mentioned, and include concrete examples to illustrate complex features or functionality.","repository":"vercel/turborepo","domain":"devtools","topic":"Documentation","language":"Other","updated":"2024-08-18","comments":2,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-link-terms-provide-examples.md"},{"slug":"kubeflow-document-with-precision","title":"Document with precision","description":"Write informative, consistent, and precise code comments throughout your codebase. When documenting code: 1. **Be specific with references** - When referencing external repositories or sources, link to specific versions and files, not just directories. Use precise language to describe the relationship between your code and external sources.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Documentation","language":"Dockerfile","updated":"2024-08-17","comments":3,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-document-with-precision.md"},{"slug":"parlant-configuration-design-clarity","title":"Configuration design clarity","description":"Design configuration with clear semantics and appropriate scope. Avoid global constants for values that can be handled locally, and ensure configuration parameters have logical, non-contradictory meanings.","repository":"emcie-co/parlant","domain":"ai-agents","topic":"Configurations","language":"Other","updated":"2024-08-17","comments":2,"stars":12205,"raw":"https://awesomereviewers.com/raw/parlant-configuration-design-clarity.md"},{"slug":"prettier-use-descriptive-variable-names","title":"Use descriptive variable names","description":"Choose variable and function names that clearly communicate their purpose, type, and context. Avoid abbreviations, overly generic terms, and names that could be confused for different types.","repository":"prettier/prettier","domain":"devtools","topic":"Naming Conventions","language":"JavaScript","updated":"2024-08-16","comments":8,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-use-descriptive-variable-names.md"},{"slug":"developer-roadmap-valid-angular-examples","title":"Valid Angular Examples","description":"When adding Angular examples (docs, snippets, templates), ensure they are both *syntactically/semantically valid* and shown in the *correct template context*.","repository":"kamranahmedse/developer-roadmap","domain":"docs","topic":"Angular","language":"Markdown","updated":"2024-08-15","comments":6,"stars":354523,"raw":"https://awesomereviewers.com/raw/developer-roadmap-valid-angular-examples.md"},{"slug":"turborepo-use-jsdoc-deprecation-standards","title":"Use JSDoc deprecation standards","description":"When marking code as deprecated, use JSDoc standards to provide clear guidance for developers. Always use the `@deprecated` tag followed by when it was deprecated and what should be used instead. Additionally, use the `{@link}` tag to create clickable references to replacement functionality.","repository":"vercel/turborepo","domain":"devtools","topic":"Documentation","language":"TypeScript","updated":"2024-08-15","comments":2,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-use-jsdoc-deprecation-standards.md"},{"slug":"typescript-use-absolute-paths","title":"Use absolute paths","description":"When specifying file paths in configuration files (like ESLint or TypeScript configs), use absolute paths rather than relative paths to avoid path resolution issues. Tools may interpret relative paths differently based on their internal working directory, leading to unexpected behavior.","repository":"microsoft/typescript","domain":"runtimes","topic":"Configurations","language":"Other","updated":"2024-08-15","comments":2,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-use-absolute-paths.md"},{"slug":"opentelemetry-python-return-collections-not-none","title":"Return collections not None","description":"Return empty collections (lists, dicts, sets) instead of None when representing empty states. This reduces null checking boilerplate, prevents null reference errors, and makes code more predictable. When a function returns a collection type, an empty collection communicates \"no items\" more clearly than None and allows direct operations without defensive...","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Null Handling","language":"Python","updated":"2024-08-14","comments":4,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-return-collections-not-none.md"},{"slug":"turborepo-choose-logging-levels-wisely","title":"Choose logging levels wisely","description":"Select appropriate logging levels based on the frequency and importance of the logged operation. Use `trace` for high-frequency operations (e.g., operations executed once per package or file) to prevent log noise at lower verbosity levels, and reserve `debug` for less frequent, more significant events or aggregated information.","repository":"vercel/turborepo","domain":"devtools","topic":"Logging","language":"Rust","updated":"2024-08-13","comments":4,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-choose-logging-levels-wisely.md"},{"slug":"awesome-go-enforce-coverage-thresholds","title":"Enforce coverage thresholds","description":"All code contributions must meet a minimum test coverage threshold of 80% before being accepted. This ensures adequate testing and helps maintain code quality standards across the project.","repository":"avelino/awesome-go","domain":"docs","topic":"Testing","language":"Markdown","updated":"2024-08-13","comments":3,"stars":151435,"raw":"https://awesomereviewers.com/raw/awesome-go-enforce-coverage-thresholds.md"},{"slug":"prettier-use-descriptive-names","title":"Use descriptive names","description":"Choose names that clearly communicate purpose and meaning rather than implementation details or obscure abbreviations. Names should be easily understood by other developers and reflect what the identifier actually represents or does.","repository":"prettier/prettier","domain":"devtools","topic":"Naming Conventions","language":"Markdown","updated":"2024-08-13","comments":2,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-use-descriptive-names.md"},{"slug":"unstructured-document-configuration-parameters-clearly","title":"Document configuration parameters clearly","description":"When documenting configuration objects and their parameters, provide clear explanations of each parameter's purpose, whether it's required or optional, and why optional parameters are useful for development. Use backticks to format code symbols, parameter names, class names, and error types for better readability.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Configurations","language":"Markdown","updated":"2024-08-13","comments":2,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-document-configuration-parameters-clearly.md"},{"slug":"unstructured-use-descriptive-specific-names","title":"Use descriptive specific names","description":"Choose names that clearly indicate their context and purpose rather than generic terms. Generic names can be ambiguous and make code harder to understand, especially when the same codebase handles multiple contexts or domains.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Naming Conventions","language":"Markdown","updated":"2024-08-13","comments":2,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-use-descriptive-specific-names.md"},{"slug":"kafka-secure-gpg-verification","title":"Secure GPG verification","description":"When downloading and verifying packages using GPG signatures, follow secure practices to ensure authenticity and prevent security vulnerabilities. Use hardcoded GPG keys rather than dynamic ones, employ reliable keyservers, set proper GNUPGHOME environment, and clean up GPG processes after verification.","repository":"apache/kafka","domain":"data-systems","topic":"Security","language":"Dockerfile","updated":"2024-08-13","comments":1,"stars":30575,"raw":"https://awesomereviewers.com/raw/kafka-secure-gpg-verification.md"},{"slug":"nest-configurable-log-formatting","title":"Configurable log formatting","description":"Design logging systems with customizable formatting and output options. Separate formatting logic into protected methods that can be overridden by derived logger implementations.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Logging","language":"TypeScript","updated":"2024-08-12","comments":4,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-configurable-log-formatting.md"},{"slug":"nest-standardize-logger-configuration-patterns","title":"Standardize logger configuration patterns","description":"Maintain consistent logger configuration and usage patterns across the application while leveraging built-in customization options. This promotes maintainable logging practices and ensures uniform log output.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Logging","language":"TypeScript","updated":"2024-08-12","comments":4,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-standardize-logger-configuration-patterns.md"},{"slug":"maplibre-native-reserve-container-capacity-early","title":"Reserve container capacity early","description":"When using containers like `unordered_map`, `unordered_set`, or vectors in performance-critical code, always pre-allocate space by calling `reserve()` before adding elements. This prevents expensive rehashing or reallocation operations during insertion, which can cause significant performance degradation, especially in rendering loops or frequently called...","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Performance Optimization","language":"Other","updated":"2024-08-12","comments":3,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-reserve-container-capacity-early.md"},{"slug":"awesome-go-exported-functions-documentation","title":"exported functions documentation","description":"All exported functions, types, and methods must include Go-style documentation comments that clearly explain their purpose, parameters, return values, and usage. This is a fundamental requirement for code quality and maintainability.","repository":"avelino/awesome-go","domain":"docs","topic":"Documentation","language":"Markdown","updated":"2024-08-12","comments":2,"stars":151435,"raw":"https://awesomereviewers.com/raw/awesome-go-exported-functions-documentation.md"},{"slug":"cli-maintain-cicd-boundaries","title":"maintain CI/CD boundaries","description":"Ensure clear separation between different CI/CD concerns and maintain accurate documentation of automated processes. Release artifacts like release notes should not be committed to main development branches, and testing workflows should be clearly documented with accurate branch-specific behaviors.","repository":"snyk/cli","domain":"security","topic":"CI/CD","language":"Markdown","updated":"2024-08-12","comments":2,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-maintain-cicd-boundaries.md"},{"slug":"kong-release-note-formatting","title":"Release note formatting","description":"When updating documentation that is consumed by automated release tooling (such as changelog YAML), verify both the semantic classification and the generated markdown rendering.","repository":"Kong/kong","domain":"cloud-infra","topic":"Documentation","language":"Yaml","updated":"2024-08-12","comments":2,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-release-note-formatting.md"},{"slug":"unstructured-intentional-naming-patterns","title":"intentional naming patterns","description":"Recognize when seemingly redundant naming patterns serve specific technical purposes rather than being mistakes or oversights. Some naming conventions that appear duplicative are actually intentional and necessary for technical reasons.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Naming Conventions","language":"Other","updated":"2024-08-12","comments":2,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-intentional-naming-patterns.md"},{"slug":"maplibre-native-structured-coroutine-management","title":"Structured coroutine management","description":"Always bind coroutine scopes to appropriate lifecycles and follow consistent patterns for asynchronous operations. Prefer suspending functions over class-based approaches when possible, and ensure proper job cancellation to prevent memory leaks.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Concurrency","language":"Kotlin","updated":"2024-08-09","comments":4,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-structured-coroutine-management.md"},{"slug":"aider-externalize-configuration-values","title":"Externalize configuration values","description":"Always externalize configuration values rather than hardcoding them directly in the code. This improves maintainability, enables easier configuration changes, and ensures consistency across the codebase.","repository":"Aider-AI/aider","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2024-08-08","comments":4,"stars":35856,"raw":"https://awesomereviewers.com/raw/aider-externalize-configuration-values.md"},{"slug":"core-align-configurations-with-usage","title":"Align configurations with usage","description":"Configuration files should accurately reflect the actual requirements and characteristics of your codebase. When setting up TypeScript configurations:","repository":"vuejs/core","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2024-08-08","comments":2,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-align-configurations-with-usage.md"},{"slug":"jan-use-configuration-constants","title":"Use configuration constants","description":"Always use named constants, enums, or well-defined configuration objects instead of magic strings, numbers, or inline literals for configuration values. This improves maintainability, reduces typos, enables better IDE support, and makes configuration changes easier to track.","repository":"menloresearch/jan","domain":"llm-infra","topic":"Configurations","language":"TSX","updated":"2024-08-07","comments":4,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-use-configuration-constants.md"},{"slug":"unstructured-document-configuration-reasoning","title":"Document configuration reasoning","description":"Always document the reasoning behind configuration decisions, especially for temporary settings like dependency pins, parameter choices, and version constraints. Include explanations of why the configuration was needed, what problem it solves, and when it might be safe to remove or update.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Configurations","language":"Other","updated":"2024-08-07","comments":4,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-document-configuration-reasoning.md"},{"slug":"ollama-complete-documentation-coverage","title":"Complete documentation coverage","description":"Documentation should comprehensively cover all supported options, variations, and potential future use cases. When creating documentation: 1. Use generic titles and structures that can accommodate future additions","repository":"ollama/ollama","domain":"llm-infra","topic":"Documentation","language":"Markdown","updated":"2024-08-07","comments":2,"stars":145705,"raw":"https://awesomereviewers.com/raw/ollama-complete-documentation-coverage.md"},{"slug":"deeplearning4j-clean-up-your-code","title":"Clean up your code","description":"Maintain clean, professional code by removing development artifacts\\ \\ and improving readability:\\n\\n1. **Remove debug code before committing**:\\n  \\ \\ - Delete all debugging print statements","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Code Style","language":"Java","updated":"2024-08-06","comments":13,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-clean-up-your-code.md"},{"slug":"istio-configuration-documentation-standards","title":"Configuration documentation standards","description":"Ensure all user-configurable options are properly documented and discoverable, while keeping configuration files clean and focused. Configuration files serve as APIs that users rely on to understand available options.","repository":"istio/istio","domain":"orchestration","topic":"Configurations","language":"Yaml","updated":"2024-08-06","comments":3,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-configuration-documentation-standards.md"},{"slug":"istio-flexible-configuration-defaults","title":"Flexible configuration defaults","description":"Configuration values should provide sensible defaults while remaining adaptable to different environments and deployment contexts. Use conditional assignment and guards to handle variations in runtime environments, deployment tools, and system configurations.","repository":"istio/istio","domain":"orchestration","topic":"Configurations","language":"Other","updated":"2024-08-06","comments":2,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-flexible-configuration-defaults.md"},{"slug":"nextchat-prevent-security-vulnerabilities","title":"Prevent security vulnerabilities","description":"Proactively identify and prevent common security vulnerabilities in code, particularly around sensitive data handling and input validation. Avoid logging sensitive information like API keys, tokens, or passwords that could be exposed in log files. Implement robust input validation using proper parsing methods rather than simple string operations that can be...","repository":"ChatGPTNextWeb/NextChat","domain":"ai-agents","topic":"Security","language":"TypeScript","updated":"2024-08-06","comments":2,"stars":85721,"raw":"https://awesomereviewers.com/raw/nextchat-prevent-security-vulnerabilities.md"},{"slug":"checkov-document-configuration-consistently","title":"Document configuration consistently","description":"Ensure all configuration options are clearly documented and follow consistent naming and syntax conventions. This includes: 1. **Explicitly document prerequisites** - Clearly state all required tools, dependencies, and environment variables needed for configuration. For example, when jq is required for processing:","repository":"bridgecrewio/checkov","domain":"security","topic":"Configurations","language":"Markdown","updated":"2024-08-05","comments":6,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-document-configuration-consistently.md"},{"slug":"nextchat-implement-stable-sorting","title":"Implement stable sorting","description":"When implementing sorting algorithms for collections, ensure stable and predictable ordering to avoid inconsistencies from operations like Object.values(). Use multi-level sorting criteria and consider sequence-based approaches for complex ordering requirements.","repository":"ChatGPTNextWeb/NextChat","domain":"ai-agents","topic":"Algorithms","language":"TypeScript","updated":"2024-08-05","comments":2,"stars":85721,"raw":"https://awesomereviewers.com/raw/nextchat-implement-stable-sorting.md"},{"slug":"openpilot-cache-expensive-operations","title":"Cache expensive operations","description":"Identify operations that are expensive and called frequently, then optimize them by caching results, moving to appropriate lifecycle events, or replacing with faster alternatives. Expensive operations like parameter reads, system calls, or complex computations should not be repeated unnecessarily in hot code paths.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Performance Optimization","language":"Other","updated":"2024-08-05","comments":2,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-cache-expensive-operations.md"},{"slug":"developer-roadmap-react-docs-with-scope","title":"React Docs With Scope","description":"When adding or updating React documentation, include usage-scoped, actionable guidance—not just headings. Apply this checklist: - **Purpose (what it is):** Start with a plain-language definition.","repository":"kamranahmedse/developer-roadmap","domain":"docs","topic":"React","language":"Markdown","updated":"2024-08-02","comments":2,"stars":354523,"raw":"https://awesomereviewers.com/raw/developer-roadmap-react-docs-with-scope.md"},{"slug":"prisma-document-network-configuration","title":"Document network configuration","description":"When configuring network settings in containerized services, always document the reasoning behind specific choices, especially for port mappings and security-related flags. This helps other developers understand the configuration and prevents accidental misconfigurations.","repository":"prisma/prisma","domain":"data-systems","topic":"Networking","language":"Yaml","updated":"2024-08-02","comments":2,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-document-network-configuration.md"},{"slug":"nest-benchmark-before-optimizing","title":"Benchmark before optimizing","description":"When making performance-critical decisions, always validate your approach with benchmarks using realistic data sizes and use cases rather than relying on theoretical assumptions.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Performance Optimization","language":"TypeScript","updated":"2024-08-01","comments":4,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-benchmark-before-optimizing.md"},{"slug":"workers-sdk-audit-third-party-dependencies","title":"audit third-party dependencies","description":"Before using third-party actions, libraries, or dependencies that require access to sensitive data (tokens, secrets, credentials), conduct a thorough security audit. Third-party code, especially when source is obfuscated or built/compiled, poses significant security risks when granted access to sensitive resources.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Security","language":"Yaml","updated":"2024-08-01","comments":1,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-audit-third-party-dependencies.md"},{"slug":"checkov-consistent-naming-conventions","title":"Consistent naming conventions","description":"Maintain consistent naming patterns throughout the codebase to improve readability and reduce confusion: 1. **Use descriptive names that reflect purpose**:","repository":"bridgecrewio/checkov","domain":"security","topic":"Naming Conventions","language":"Python","updated":"2024-07-30","comments":10,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-consistent-naming-conventions.md"},{"slug":"maplibre-native-handle-errors-by-severity","title":"Handle errors by severity","description":"Choose error handling mechanisms based on error severity and recoverability: 1. Use throws for unrecoverable errors that prevent system operation: ```cpp","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Error Handling","language":"C++","updated":"2024-07-30","comments":6,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-handle-errors-by-severity.md"},{"slug":"checkov-thorough-test-assertions","title":"Thorough test assertions","description":"Ensure tests thoroughly validate functionality through comprehensive assertions. When writing tests: 1. Assert all relevant aspects of the expected behavior, not just presence/absence or simple success/failure","repository":"bridgecrewio/checkov","domain":"security","topic":"Testing","language":"Python","updated":"2024-07-30","comments":5,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-thorough-test-assertions.md"},{"slug":"opentelemetry-python-pin-dependency-versions","title":"Pin dependency versions","description":"Always use exact version pinning (==) for dependencies in requirements files rather than version ranges. This ensures build reproducibility and prevents unexpected behavior when dependencies release new versions.","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Configurations","language":"Txt","updated":"2024-07-30","comments":4,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-pin-dependency-versions.md"},{"slug":"jan-use-descriptive-names","title":"Use descriptive names","description":"Choose variable and function names that clearly communicate their purpose, type, and behavior. Names should be self-documenting and immediately understandable to other developers without requiring additional context.","repository":"menloresearch/jan","domain":"llm-infra","topic":"Naming Conventions","language":"TypeScript","updated":"2024-07-30","comments":3,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-use-descriptive-names.md"},{"slug":"neon-precise-algorithm-terminology","title":"Precise algorithm terminology","description":"When implementing and documenting algorithms, use precise terminology and be explicit about metrics, operations, and data structures to avoid ambiguity and ensure correctness.","repository":"neondatabase/neon","domain":"data-systems","topic":"Algorithms","language":"Markdown","updated":"2024-07-30","comments":3,"stars":19015,"raw":"https://awesomereviewers.com/raw/neon-precise-algorithm-terminology.md"},{"slug":"checkov-safe-dictionary-access","title":"Safe dictionary access","description":"Always use safe dictionary access patterns when handling potentially null or missing values. This prevents KeyError and AttributeError exceptions that can crash your application.","repository":"bridgecrewio/checkov","domain":"security","topic":"Null Handling","language":"Python","updated":"2024-07-29","comments":8,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-safe-dictionary-access.md"},{"slug":"serverless-eliminate-redundant-operations","title":"Eliminate redundant operations","description":"Identify and eliminate repeated expensive operations to improve performance. Look for opportunities to cache results, avoid duplicate computations, and minimize unnecessary work.","repository":"serverless/serverless","domain":"cloud-infra","topic":"Performance Optimization","language":"JavaScript","updated":"2024-07-29","comments":7,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-eliminate-redundant-operations.md"},{"slug":"maplibre-native-externalize-config-values","title":"Externalize config values","description":"Replace hardcoded \"magic numbers\" and environment-specific logic with externally configurable values. Use preprocessor definitions, build flags, or configuration constants to make your code adaptable to different environments and requirements.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Configurations","language":"C++","updated":"2024-07-29","comments":3,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-externalize-config-values.md"},{"slug":"checkov-minimize-workflow-complexity","title":"Minimize workflow complexity","description":"Keep GitHub Actions workflows efficient and maintainable by eliminating redundant configurations and ensuring comprehensive test coverage: 1. **Avoid redundant environment variables** - Use the minimum number of variables needed to achieve your workflow goals. When one variable can be derived from another, don''t store both.","repository":"bridgecrewio/checkov","domain":"security","topic":"CI/CD","language":"Yaml","updated":"2024-07-29","comments":2,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-minimize-workflow-complexity.md"},{"slug":"svelte-prefer-testing-libraries","title":"prefer testing libraries","description":"When testing components, use established testing libraries like @testing-library/svelte instead of low-level DOM manipulation approaches. Low-level testing with direct mount/unmount and querySelector calls is brittle and requires frequent updates when component structure changes. Testing libraries provide user-focused APIs that are more robust to...","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Testing","language":"Markdown","updated":"2024-07-26","comments":5,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-prefer-testing-libraries.md"},{"slug":"prettier-organize-tests-properly","title":"Organize tests properly","description":"Tests should be well-structured with clear separation of concerns, proper grouping, and appropriate cleanup mechanisms. Separate different types of tests (performance vs functional), use descriptive test blocks, and ensure proper isolation to prevent side effects between tests.","repository":"prettier/prettier","domain":"devtools","topic":"Testing","language":"JavaScript","updated":"2024-07-26","comments":3,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-organize-tests-properly.md"},{"slug":"bazel-document-network-interface-purposes","title":"Document network interface purposes","description":"When implementing multiple network-related interfaces or classes that handle similar operations (like downloading), clearly document the purpose, scope, and differences between each interface to prevent confusion and misuse.","repository":"bazelbuild/bazel","domain":"devtools","topic":"Networking","language":"Java","updated":"2024-07-26","comments":2,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-document-network-interface-purposes.md"},{"slug":"nextchat-configuration-backward-compatibility","title":"Configuration backward compatibility","description":"When modifying configuration schemas or adding new configuration options, always ensure backward compatibility with existing deployments. Long-running systems with many user deployments require smooth migration paths from old configurations to new ones.","repository":"ChatGPTNextWeb/NextChat","domain":"ai-agents","topic":"Configurations","language":"TypeScript","updated":"2024-07-25","comments":2,"stars":85721,"raw":"https://awesomereviewers.com/raw/nextchat-configuration-backward-compatibility.md"},{"slug":"maplibre-native-document-containerized-builds","title":"Document containerized builds","description":"When using Docker for build environments, provide complete, tested instructions that users can copy-paste without modification. Include proper user permission handling to prevent file ownership issues, and ensure commands work as documented.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"CI/CD","language":"Markdown","updated":"2024-07-24","comments":2,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-document-containerized-builds.md"},{"slug":"cli-consistent-readable-patterns","title":"consistent readable patterns","description":"Maintain consistent coding patterns and prioritize readability to make code easier to understand and maintain. This includes using consistent approaches for similar operations, avoiding overly complex constructions, and ensuring code follows predictable patterns.","repository":"snyk/cli","domain":"security","topic":"Code Style","language":"TypeScript","updated":"2024-07-23","comments":12,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-consistent-readable-patterns.md"},{"slug":"compose-use-structured-logging-framework","title":"Use structured logging framework","description":"Prefer structured logging frameworks like logrus over direct fmt output functions for consistency, proper log levels, and better log management. This ensures uniform logging behavior across the codebase and enables proper log level filtering and formatting.","repository":"docker/compose","domain":"orchestration","topic":"Logging","language":"Go","updated":"2024-07-23","comments":2,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-use-structured-logging-framework.md"},{"slug":"maplibre-native-style-compliant-example-code","title":"Style-compliant example code","description":"Example code in documentation and tutorials should adhere to project style guidelines and demonstrate best practices. Avoid using internal classes or implementation details that are inaccessible to users. Instead, use public APIs and concrete resources that developers can directly copy into their applications.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Code Style","language":"Markdown","updated":"2024-07-23","comments":2,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-style-compliant-example-code.md"},{"slug":"nuxt-use-proper-http-utilities","title":"Use proper HTTP utilities","description":"When handling HTTP cookies and headers, use dedicated utility functions instead of manual string manipulation. Manual parsing of HTTP headers, especially cookies, can lead to incorrect behavior due to the complexity of HTTP header formats.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Networking","language":"Markdown","updated":"2024-07-22","comments":2,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-use-proper-http-utilities.md"},{"slug":"prettier-benchmark-performance-optimizations","title":"Benchmark performance optimizations","description":"Always measure and validate performance optimizations with concrete benchmarks before implementing them. Performance assumptions can be misleading, and minor gains may not justify added complexity or reduced correctness.","repository":"prettier/prettier","domain":"devtools","topic":"Performance Optimization","language":"Markdown","updated":"2024-07-22","comments":2,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-benchmark-performance-optimizations.md"},{"slug":"spring-boot-include-database-specific-migration-dependencies","title":"Include database-specific migration dependencies","description":"When implementing database migrations with tools like Flyway, ensure you include the appropriate database-specific dependency for your target database. As of Flyway V10.0.0, all databases except in-memory or file-based ones (such as H2 or SQLite) require their own specific dependency package.","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Migrations","language":"Other","updated":"2024-07-22","comments":2,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-include-database-specific-migration-dependencies.md"},{"slug":"workers-sdk-design-intuitive-api-interfaces","title":"Design intuitive API interfaces","description":"APIs should be designed with user experience in mind, accepting inputs in formats users naturally encounter and providing clear customization options with well-documented defaults.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"API","language":"Markdown","updated":"2024-07-22","comments":2,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-design-intuitive-api-interfaces.md"},{"slug":"tensorflow-complete-docstring-structure","title":"Complete docstring structure","description":"Function documentation should follow a consistent structure that includes all necessary components to be complete and usable. Each docstring should: 1. Start with a one-line summary that concisely describes the function''s purpose","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Documentation","language":"Python","updated":"2024-07-21","comments":4,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-complete-docstring-structure.md"},{"slug":"sonic-use-semantic-naming","title":"Use semantic naming","description":"Choose names that clearly communicate the purpose, meaning, and scope of variables, functions, constants, and files. Names should be self-documenting and immediately convey their role to other developers.","repository":"bytedance/sonic","domain":"runtimes","topic":"Naming Conventions","language":"Go","updated":"2024-07-18","comments":3,"stars":8532,"raw":"https://awesomereviewers.com/raw/sonic-use-semantic-naming.md"},{"slug":"checkov-azure-encryption-property-names","title":"Azure encryption property names","description":"When configuring encryption settings for Azure resources in ARM templates, always use the correct property names as documented in the Azure API specifications. Specifically for Azure Compute disks, use `enableDoubleEncryption` instead of `doubleEncryptionEnabled` to configure double encryption. Using incorrect property names can result in security...","repository":"bridgecrewio/checkov","domain":"security","topic":"Security","language":"Json","updated":"2024-07-15","comments":2,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-azure-encryption-property-names.md"},{"slug":"checkov-use-correct-encryption-properties","title":"Use correct encryption properties","description":"When configuring security features in Azure ARM templates, always use the correct property names as specified in the Azure documentation. For double encryption of Azure Compute disks, use \"enableDoubleEncryption\" rather than \"doubleEncryptionEnabled\". Using incorrect property names may result in security features not being properly applied, potentially...","repository":"bridgecrewio/checkov","domain":"security","topic":"Security","language":"Json","updated":"2024-07-15","comments":2,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-use-correct-encryption-properties.md"},{"slug":"prettier-angular-syntax-parsing","title":"Angular syntax parsing","description":"When implementing Angular syntax parsing, ensure robust handling of Angular-specific constructs by properly distinguishing AST node types and normalizing flexible syntax patterns.","repository":"prettier/prettier","domain":"devtools","topic":"Angular","language":"JavaScript","updated":"2024-07-13","comments":2,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-angular-syntax-parsing.md"},{"slug":"nuxt-prefer-null-comparisons","title":"prefer != null comparisons","description":"When checking for null or undefined values, prefer the concise `!= null` comparison over explicit checks or array-based methods. This pattern effectively handles both null and undefined while preserving other falsy values like `false`, `0`, or empty strings.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Null Handling","language":"TypeScript","updated":"2024-07-12","comments":3,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-prefer-null-comparisons.md"},{"slug":"tensorflow-use-consistent-error-handling","title":"Use consistent error handling","description":"Apply standardized error handling patterns across your codebase for improved reliability and debugging. For new code, use the `absl` error types instead of `tsl::errors` and include descriptive error messages with context.","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Error Handling","language":"Other","updated":"2024-07-11","comments":9,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-use-consistent-error-handling.md"},{"slug":"tokenizers-modular-model-components","title":"Modular model components","description":"Design machine learning model code with clear component boundaries and proper separation of concerns. Each component (tokenizer, normalizer, model, etc.) should have a single responsibility with appropriate visibility modifiers.","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"AI","language":"Rust","updated":"2024-07-11","comments":3,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-modular-model-components.md"},{"slug":"union-sql-query-best-practices","title":"SQL query best practices","description":"Always include ORDER BY clauses in paginated queries to ensure consistent results across multiple requests. Without explicit ordering, databases may return results in different orders each time, making pagination unreliable and potentially causing data to be skipped or duplicated.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Database","language":"Rust","updated":"2024-07-11","comments":3,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-sql-query-best-practices.md"},{"slug":"opentelemetry-python-telemetry-version-pinning","title":"Telemetry version pinning","description":"When specifying observability frameworks like OpenTelemetry in requirements files, use the compatible release operator (~=) with only the major and minor version numbers, omitting the patch version. This ensures you receive bug fixes in patch releases while protecting against potential breaking changes in minor versions.","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Observability","language":"Txt","updated":"2024-07-11","comments":2,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-telemetry-version-pinning.md"},{"slug":"compose-keep-code-structure-flat","title":"Keep code structure flat","description":"Maintain code readability by minimizing nesting depth and using appropriate control structures. Prefer flat code organization over deeply nested conditions. When dealing with multiple conditions:","repository":"docker/compose","domain":"orchestration","topic":"Code Style","language":"Go","updated":"2024-07-10","comments":4,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-keep-code-structure-flat.md"},{"slug":"union-optimize-database-queries","title":"Optimize database queries","description":"When writing database queries, prioritize both performance and correctness. Avoid unnecessary joins that can significantly impact query performance - fetch only essential data and use separate services or caches for additional lookups. Also ensure your filtering logic doesn't inadvertently exclude valid records, particularly with boundary conditions.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Database","language":"TypeScript","updated":"2024-07-10","comments":2,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-optimize-database-queries.md"},{"slug":"cli-balance-concurrent-operations","title":"Balance concurrent operations","description":"When implementing concurrent operations, carefully balance performance gains with resource consumption and system stability. Set conservative concurrency limits initially and adjust based on performance metrics rather than assuming higher parallelism is always better.","repository":"snyk/cli","domain":"security","topic":"Concurrency","language":"TypeScript","updated":"2024-07-09","comments":3,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-balance-concurrent-operations.md"},{"slug":"express-exclude-sensitive-configurations","title":"Exclude sensitive configurations","description":"Do not commit sensitive, time-limited, or environment-specific configuration files to version control. Instead: 1. For files with expiration dates (like SSL certificates):","repository":"expressjs/express","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2024-07-08","comments":2,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-exclude-sensitive-configurations.md"},{"slug":"kotlin-prefer-descriptive-errors","title":"Prefer descriptive errors","description":"When handling errors in your code, always provide detailed context in error messages to aid debugging. Use Kotlin's standard error handling functions instead of directly throwing exceptions or using non-null assertions.","repository":"JetBrains/kotlin","domain":"runtimes","topic":"Error Handling","language":"Kotlin","updated":"2024-07-05","comments":6,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-prefer-descriptive-errors.md"},{"slug":"tree-sitter-simplify-conditional-logic","title":"Simplify conditional logic","description":"Improve code readability by simplifying complex conditional expressions and control flow structures. Factor out repeated boolean expressions from nested conditions, use early returns instead of result variables when possible, and consolidate related conditional blocks.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Code Style","language":"C","updated":"2024-07-05","comments":4,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-simplify-conditional-logic.md"},{"slug":"opentelemetry-python-follow-python-naming-conventions","title":"Follow Python naming conventions","description":"Use consistent Python naming conventions to improve code readability and maintainability: 1. Use snake_case for functions and variables: ```python # Bad","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Naming Conventions","language":"Python","updated":"2024-07-04","comments":5,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-follow-python-naming-conventions.md"},{"slug":"comfyui-use-optional-chaining-operators","title":"Use optional chaining operators","description":"Use optional chaining (`?.`) and nullish coalescing (`??`) operators instead of manual null checks to safely access nested properties and provide fallback values. These operators prevent runtime errors when dealing with potentially null or undefined values and result in cleaner, more readable code.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Null Handling","language":"JavaScript","updated":"2024-07-04","comments":2,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-use-optional-chaining-operators.md"},{"slug":"unstructured-database-schema-compliance","title":"Database schema compliance","description":"Ensure database integrations use correct field names, data types, and schema conventions specific to each database system. Different databases have special field naming requirements and data type expectations that must be respected to avoid runtime errors and ensure proper functionality.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Database","language":"Python","updated":"2024-07-03","comments":4,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-database-schema-compliance.md"},{"slug":"unstructured-improve-code-readability","title":"improve code readability","description":"Format code to enhance readability and maintainability by breaking long lines and extracting repeated values into variables. Long command lines with multiple parameters should be split across multiple lines with proper line continuation, placing each parameter on its own line. When the same value (like URLs, paths, or configuration strings) appears multiple...","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Code Style","language":"Shell","updated":"2024-07-02","comments":2,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-improve-code-readability.md"},{"slug":"tokio-follow-naming-conventions","title":"Follow naming conventions","description":"Choose names that follow established API conventions and guidelines\\ \\ to create a consistent, intuitive codebase:\\n\\n1. For conversions or views:\\n\\ \\   - Use `as_*` for cheap, reference-based conversions","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Naming Conventions","language":"Rust","updated":"2024-07-01","comments":7,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-follow-naming-conventions.md"},{"slug":"tokio-prefer-explicit-over-concise","title":"Prefer explicit over concise","description":"Choose explicit and unambiguous names over concise but unclear ones. When a method, type, or variable has a specific behavior or purpose, the name should clearly communicate that, even if it results in longer names.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Naming Conventions","language":"Rust","updated":"2024-07-01","comments":6,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-prefer-explicit-over-concise.md"},{"slug":"kubeflow-harden-container-security","title":"Harden container security","description":"When building container images, ensure they''re compatible with restricted Kubernetes security contexts. Use numeric UIDs instead of symbolic usernames, and test compatibility with the following security constraints:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Security","language":"Dockerfile","updated":"2024-06-30","comments":1,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-harden-container-security.md"},{"slug":"ui-add-interactive-element-roles","title":"Add interactive element roles","description":"When adding event handlers like `onClick` to non-interactive elements such as `div`, always include appropriate ARIA roles and keyboard event handlers. This prevents accessibility issues and reduces security vulnerabilities by ensuring all interactive elements are properly identified and managed.","repository":"shadcn-ui/ui","domain":"app-frameworks","topic":"Security","language":"TSX","updated":"2024-06-30","comments":1,"stars":90568,"raw":"https://awesomereviewers.com/raw/ui-add-interactive-element-roles.md"},{"slug":"union-validate-input-before-submission","title":"Validate input before submission","description":"Always validate user input before enabling form submission to prevent processing of invalid or malicious data. This includes checking for empty required fields, format validation, and business logic constraints. Implement validation checks in the form's disabled state or submission handler to ensure only valid data can be processed.","repository":"unionlabs/union","domain":"cloud-infra","topic":"Security","language":"Other","updated":"2024-06-30","comments":1,"stars":74800,"raw":"https://awesomereviewers.com/raw/union-validate-input-before-submission.md"},{"slug":"octokit.net-file-specific-indentation-standards","title":"File-specific indentation standards","description":"Maintain consistent indentation based on file type to ensure code readability and prevent unwanted whitespace changes in PRs. Use 4 spaces for C# (.cs) files and 2 spaces for configuration files (like JSON, devcontainer files).","repository":"octokit/octokit.net","domain":"devtools","topic":"Code Style","language":"Json","updated":"2024-06-29","comments":2,"stars":2793,"raw":"https://awesomereviewers.com/raw/octokit.net-file-specific-indentation-standards.md"},{"slug":"router-validate-client-inputs","title":"validate client inputs","description":"Always validate and sanitize client-provided data on the server side before processing. Client-side data, including form inputs, query parameters, and request bodies, should never be trusted without proper validation as it can be easily manipulated by malicious users.","repository":"TanStack/router","domain":"app-frameworks","topic":"Security","language":"Markdown","updated":"2024-06-29","comments":1,"stars":11590,"raw":"https://awesomereviewers.com/raw/router-validate-client-inputs.md"},{"slug":"react-router-cancel-aborted-async-operations","title":"Cancel aborted async operations","description":"When working with async operations that can be aborted (like HTTP requests), ensure proper cancellation of related promises and deferred operations to prevent memory leaks and unnecessary work. This applies to both operations created after abortion has occurred and those created before abortion.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Concurrency","language":"TypeScript","updated":"2024-06-28","comments":3,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-cancel-aborted-async-operations.md"},{"slug":"react-router-handle-ssr-hydration-mismatches","title":"Handle SSR hydration mismatches","description":"When implementing server-side rendering, proactively handle scenarios where server and client rendering may produce different outputs to prevent hydration errors. This commonly occurs with dynamic URLs, route matching, and encoded characters.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Next","language":"TSX","updated":"2024-06-28","comments":2,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-handle-ssr-hydration-mismatches.md"},{"slug":"fiber-document-mutex-usage","title":"Document mutex usage","description":"Always document mutex fields and their purpose, ensure proper locking/unlocking patterns, and avoid redundant locks when underlying structures are already thread-safe. When using mutexes, clearly indicate what data they protect and why the synchronization is necessary.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Concurrency","language":"Go","updated":"2024-06-27","comments":4,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-document-mutex-usage.md"},{"slug":"runtime-decompose-complex-algorithms","title":"Decompose complex algorithms","description":"When implementing algorithms, break down complex methods that handle multiple concerns into smaller, more focused methods. This improves maintainability, makes edge cases easier to handle, and allows for more flexible reuse of algorithm components.","repository":"dotnet/runtime","domain":"runtimes","topic":"Algorithms","language":"C","updated":"2024-06-27","comments":4,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-decompose-complex-algorithms.md"},{"slug":"unstructured-avoid-hardcoded-secrets","title":"avoid hardcoded secrets","description":"Never include real API keys, passwords, or other sensitive credentials directly in source code, including example files and configuration. This creates security vulnerabilities and risks credential exposure in version control systems.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Security","language":"Python","updated":"2024-06-27","comments":2,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-avoid-hardcoded-secrets.md"},{"slug":"openpilot-tool-specific-configuration-compatibility","title":"Tool-specific configuration compatibility","description":"When working with configuration files that support multiple tools or package managers, ensure that configuration syntax and constraints accommodate all supported tools while maintaining functionality across the ecosystem.","repository":"commaai/openpilot","domain":"ml-systems","topic":"Configurations","language":"Toml","updated":"2024-06-26","comments":4,"stars":58214,"raw":"https://awesomereviewers.com/raw/openpilot-tool-specific-configuration-compatibility.md"},{"slug":"deno-mirror-related-api-methods","title":"Mirror related API methods","description":"When designing APIs with related method pairs (such as send/receive, input/output, or request/response), ensure their signatures and parameter structures mirror each other for consistency and developer ergonomics.","repository":"denoland/deno","domain":"runtimes","topic":"API","language":"JavaScript","updated":"2024-06-26","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-mirror-related-api-methods.md"},{"slug":"elasticsearch-document-performance-tradeoffs","title":"Document performance tradeoffs","description":"Always explicitly document the performance implications of API parameters, limit changes, and features that could significantly impact resource usage. When introducing functionality that offers a tradeoff between capabilities and performance, provide clear warnings and specific details about:","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Performance Optimization","language":"Other","updated":"2024-06-24","comments":2,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-document-performance-tradeoffs.md"},{"slug":"bazel-automate-sensitive-ci-artifacts","title":"Automate sensitive CI artifacts","description":"Large files and security-sensitive artifacts should be automatically generated in CI/CD pipelines rather than manually committed to version control. This reduces security risks from potentially malicious content and ensures artifacts stay current with the codebase.","repository":"bazelbuild/bazel","domain":"devtools","topic":"CI/CD","language":"Other","updated":"2024-06-21","comments":2,"stars":24489,"raw":"https://awesomereviewers.com/raw/bazel-automate-sensitive-ci-artifacts.md"},{"slug":"hyprland-api-inputoutput-validation","title":"API input/output validation","description":"Ensure robust parsing of API inputs and proper formatting of outputs to prevent parsing errors and unexpected behavior. API implementations must handle edge cases where command identifiers might appear within parameter values, and all output formats must properly escape special characters.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"API","language":"C++","updated":"2024-06-19","comments":2,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-api-inputoutput-validation.md"},{"slug":"nuxt-optimize-cicd-configurations","title":"optimize CI/CD configurations","description":"Review CI/CD workflow configurations for both performance optimizations and accuracy in conditional logic. This includes minimizing resource usage where possible and ensuring all conditional statements use correct values.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2024-06-19","comments":2,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-optimize-cicd-configurations.md"},{"slug":"nuxt-validate-cicd-timing-checks","title":"Validate CI/CD timing checks","description":"When implementing timing-based security checks in CI/CD workflows, ensure that timestamp comparisons use tamper-proof data sources that cannot be manipulated through commit history manipulation or force pushes. Always verify that the timestamps being compared (such as PR updated_at vs comment created_at) come from authoritative sources that reflect actual...","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Security","language":"Yaml","updated":"2024-06-15","comments":1,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-validate-cicd-timing-checks.md"},{"slug":"checkov-implement-pre-commit-hooks","title":"Implement pre-commit hooks","description":"Automate quality and security checks by implementing pre-commit hooks in your Git repositories to catch issues early in the development process. Pre-commit hooks run specified checks automatically when files change, before code is committed, helping to enforce standards without manual intervention.","repository":"bridgecrewio/checkov","domain":"security","topic":"CI/CD","language":"Markdown","updated":"2024-06-13","comments":2,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-implement-pre-commit-hooks.md"},{"slug":"query-use-suspense-only-when-ready","title":"Use Suspense Only When Ready","description":"In Next.js SSR/app-router, do not use `useSuspenseQuery` unless your server prefetch + hydration setup guarantees the data is already in the cache such that the component will not suspend.","repository":"tanstack/query","domain":"app-frameworks","topic":"Next","language":"Markdown","updated":"2024-06-11","comments":5,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-use-suspense-only-when-ready.md"},{"slug":"tokenizers-handle-nullable-types-idiomatically","title":"Handle nullable types idiomatically","description":"Use Rust's idiomatic patterns when working with Option and Result types\\ \\ to prevent panics and improve code clarity. \\n\\n**Avoid unwrapping**\\nPrefer pattern\\ \\ matching or propagating errors instead of using `.unwrap()` which can cause runtime\\ \\ panics:","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"Null Handling","language":"Rust","updated":"2024-06-10","comments":5,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-handle-nullable-types-idiomatically.md"},{"slug":"tokenizers-version-ai-dependencies-appropriately","title":"Version AI dependencies appropriately","description":"When adding or updating dependencies for AI/ML libraries in your project, follow these two key practices: 1. **Set appropriate version constraints** that balance stability with access to improvements. For rapidly evolving AI libraries like HuggingFace Hub, avoid overly restrictive upper bounds that prevent compatible updates, but also avoid excessively...","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"AI","language":"Toml","updated":"2024-06-07","comments":2,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-version-ai-dependencies-appropriately.md"},{"slug":"spring-framework-minimize-lock-contention","title":"Minimize lock contention","description":"When implementing thread-safe code, minimize the scope and duration of locks to reduce contention and improve performance. Keep critical sections small, avoid redundant operations under locks, and consider whether pessimistic locking is appropriate for your use case.","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Concurrency","language":"Java","updated":"2024-06-06","comments":4,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-minimize-lock-contention.md"},{"slug":"kotlin-copy-external-string-inputs","title":"Copy external string inputs","description":"When storing string pointers from external sources (like command-line arguments), always validate the input and create managed copies to prevent null references and lifetime issues. This practice ensures that your stored references remain valid throughout your program's execution and prevents potential crashes from null or invalid pointers.","repository":"JetBrains/kotlin","domain":"runtimes","topic":"Null Handling","language":"C++","updated":"2024-06-06","comments":2,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-copy-external-string-inputs.md"},{"slug":"express-optimize-hot-paths","title":"Optimize hot paths","description":"When writing code that will be executed frequently (hot paths), prioritize performance optimizations that reduce overhead. This includes: 1. **Move expensive operations out of frequently executed blocks**: Place resource-intensive operations like `require()` calls at module initialization rather than in request handlers or response methods.","repository":"expressjs/express","domain":"app-frameworks","topic":"Performance Optimization","language":"JavaScript","updated":"2024-06-05","comments":4,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-optimize-hot-paths.md"},{"slug":"spring-boot-explicit-security-configurations","title":"Explicit security configurations","description":"When configuring security-related features, always use the most specific configurer classes to make security decisions explicit and improve code readability. For example, when disabling CSRF protection in Spring Security, use `CsrfConfigurer::disable` instead of the more generic `AbstractHttpConfigurer::disable`:","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Security","language":"Java","updated":"2024-06-04","comments":8,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-explicit-security-configurations.md"},{"slug":"sentry-php-include-practical-examples","title":"Include practical examples","description":"Enhance technical documentation with clear, practical code examples that demonstrate usage. This applies to: 1. Changelog entries for new features 2. API documentation","repository":"getsentry/sentry-php","domain":"observability","topic":"Documentation","language":"Markdown","updated":"2024-06-04","comments":4,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-include-practical-examples.md"},{"slug":"checkov-choose-optimal-data-structures","title":"Choose optimal data structures","description":"Select the most appropriate data structure based on the specific operations your algorithm needs to perform. This choice can dramatically impact performance and code clarity:","repository":"bridgecrewio/checkov","domain":"security","topic":"Algorithms","language":"Python","updated":"2024-06-03","comments":5,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-choose-optimal-data-structures.md"},{"slug":"awesome-go-optimize-ci-efficiency","title":"optimize CI efficiency","description":"Optimize CI/CD pipelines by minimizing resource usage and avoiding unnecessary operations. Use lightweight package alternatives when possible (e.g., `vim-nox` instead of `vim` for text processing), implement conditional execution to run steps only when relevant files change, and leverage automatic dependency resolution instead of manual listings.","repository":"avelino/awesome-go","domain":"docs","topic":"CI/CD","language":"Yaml","updated":"2024-06-03","comments":3,"stars":151435,"raw":"https://awesomereviewers.com/raw/awesome-go-optimize-ci-efficiency.md"},{"slug":"tree-sitter-optimize-dependency-configurations","title":"optimize dependency configurations","description":"When configuring dependencies in package manifests, prioritize efficiency and maintainability by avoiding redundant dependencies, using flexible versioning, and explicitly managing features. Before adding new dependencies, check if existing ones already provide the required functionality. Use version ranges (like \"^1.0\") instead of exact pins to allow...","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Configurations","language":"Toml","updated":"2024-05-31","comments":3,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-optimize-dependency-configurations.md"},{"slug":"serverless-explicit-observability-configuration","title":"explicit observability configuration","description":"Ensure observability features are configured explicitly with clear documentation about their scope and impact. Avoid relying on implicit defaults or ambiguous configuration that could mislead users about what monitoring capabilities are being enabled or disabled.","repository":"serverless/serverless","domain":"cloud-infra","topic":"Observability","language":"Markdown","updated":"2024-05-31","comments":2,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-explicit-observability-configuration.md"},{"slug":"lobe-chat-use-semantic-naming","title":"Use semantic naming","description":"Choose names that reflect purpose and meaning rather than visual appearance, position, or implementation details. This improves code clarity, supports internationalization, and makes the codebase more maintainable.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Naming Conventions","language":"TSX","updated":"2024-05-28","comments":2,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-use-semantic-naming.md"},{"slug":"traefik-remove-unused-code-elements","title":"Remove unused code elements","description":"Eliminate unnecessary code elements including unused parameters, struct tags, methods, and dead code to improve code cleanliness and maintainability. Unused code creates confusion for maintainers and adds unnecessary complexity to the codebase.","repository":"traefik/traefik","domain":"cloud-infra","topic":"Code Style","language":"Go","updated":"2024-05-27","comments":3,"stars":55772,"raw":"https://awesomereviewers.com/raw/traefik-remove-unused-code-elements.md"},{"slug":"prisma-research-configuration-format-support","title":"Research configuration format support","description":"When migrating configuration files to newer formats, research current ecosystem support before defaulting to compatibility layers. Many tools and plugins may already support modern formats even if documentation suggests otherwise.","repository":"prisma/prisma","domain":"data-systems","topic":"Configurations","language":"Other","updated":"2024-05-24","comments":2,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-research-configuration-format-support.md"},{"slug":"opentelemetry-python-sanitize-observability-data-exports","title":"Sanitize observability data exports","description":"When exporting observability data (metrics, traces, logs) to external systems, properly sanitize all data fields to ensure compatibility and consistency. Key requirements:","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Observability","language":"Python","updated":"2024-05-23","comments":6,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-sanitize-observability-data-exports.md"},{"slug":"maplibre-native-document-platform-requirements","title":"Document platform requirements","description":"When setting or changing minimum platform version requirements, always document the specific technical reasons for these decisions. Include: 1. Features or APIs that necessitate the change (e.g., std::filesystem requiring macOS 10.15+)","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2024-05-22","comments":4,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-document-platform-requirements.md"},{"slug":"semgrep-add-ci-safety-checks","title":"Add CI safety checks","description":"Implement defensive checks and error handling in CI/CD workflows to prevent failures and ensure robust operations. This includes validating preconditions, checking for edge cases, and using appropriate tools that preserve important information.","repository":"semgrep/semgrep","domain":"security","topic":"CI/CD","language":"Other","updated":"2024-05-22","comments":4,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-add-ci-safety-checks.md"},{"slug":"unstructured-python-version-standardization","title":"Python version standardization","description":"Establish and document a consistent Python version standard for dependency compilation across the project. Team confusion about which Python version to use for pip-compile leads to build inconsistencies, compatibility issues, and wasted development time.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Configurations","language":"Txt","updated":"2024-05-22","comments":2,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-python-version-standardization.md"},{"slug":"maplibre-native-default-to-minimum-permissions","title":"Default to minimum permissions","description":"Always default to the least invasive privacy settings and explicitly request elevated permissions only when necessary for specific functionality. For location-based features, start with reduced accuracy and request precise location only when required with a clear purpose explanation.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Security","language":"Swift","updated":"2024-05-20","comments":1,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-default-to-minimum-permissions.md"},{"slug":"ui-accessible-security-indicators","title":"Accessible security indicators","description":"Ensure all security-related UI elements such as warnings, error messages, and destructive action buttons meet WCAG contrast standards. Poor contrast in these elements creates an accessibility issue that can prevent users from noticing important security warnings or destructive actions, potentially leading to security vulnerabilities.","repository":"shadcn-ui/ui","domain":"app-frameworks","topic":"Security","language":"Css","updated":"2024-05-20","comments":1,"stars":90568,"raw":"https://awesomereviewers.com/raw/ui-accessible-security-indicators.md"},{"slug":"langchainjs-update-documentation-configuration","title":"Update documentation configuration","description":"When adding new files or components to the project, ensure that documentation configuration is updated accordingly. This includes adding new files to TypeDoc options in tsconfig.json to maintain complete API documentation coverage. Additionally, clearly mark deprecated components and direct developers to use the recommended alternatives instead of extending...","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"Documentation","language":"Json","updated":"2024-05-17","comments":2,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-update-documentation-configuration.md"},{"slug":"query-maintain-predictable-configs","title":"Maintain Predictable Configs","description":"Configuration files should be predictable for every developer and remain maintainable over time. - Prefer explicit, stable values in runtime/version files (pin a specific version) so `nvm use`/install instructions work consistently. If you use an alias (like an LTS channel), ensure the exact alias form is supported (e.g., correct casing) and document why...","repository":"tanstack/query","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2024-05-16","comments":2,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-maintain-predictable-configs.md"},{"slug":"unstructured-centralize-configuration-sources","title":"Centralize configuration sources","description":"Maintain configuration settings in a single authoritative source to avoid duplication and inconsistencies across multiple files. When possible, use `pyproject.toml` as the primary configuration file and remove redundant specifications from other files like `.pre-commit-config.yaml` and `Makefile`.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Configurations","language":"Toml","updated":"2024-05-16","comments":2,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-centralize-configuration-sources.md"},{"slug":"unstructured-validate-api-parameter-formats","title":"Validate API parameter formats","description":"Ensure API parameters match the expected format and structure of target APIs before runtime. Validate parameter types, required fields, and data structures during development rather than discovering mismatches through runtime errors.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"API","language":"Shell","updated":"2024-05-15","comments":2,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-validate-api-parameter-formats.md"},{"slug":"boto3-comprehensive-api-documentation","title":"Comprehensive API documentation","description":"Always provide comprehensive API documentation that includes accurate examples, complete parameter descriptions, and clarifications about parameter usage. This helps users understand how to properly use your API and reduces support questions.","repository":"boto/boto3","domain":"cloud-infra","topic":"Documentation","language":"Python","updated":"2024-05-14","comments":6,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-comprehensive-api-documentation.md"},{"slug":"core-evolve-apis-gracefully","title":"Evolve APIs gracefully","description":"When modifying or extending APIs, prioritize backward compatibility while providing clear migration paths for future changes. Follow these practices:","repository":"vuejs/core","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2024-05-14","comments":6,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-evolve-apis-gracefully.md"},{"slug":"spring-framework-design-for-api-extension","title":"Design for API extension","description":"When designing APIs, prioritize extensibility by providing clear extension points and avoiding direct exposure of implementation details. This allows for future enhancements without breaking compatibility.","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"API","language":"Java","updated":"2024-05-13","comments":5,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-design-for-api-extension.md"},{"slug":"tensorflow-validate-quantization-parameters-carefully","title":"Validate quantization parameters carefully","description":"When implementing quantized operations in ML models, thoroughly validate quantization parameters to ensure correctness and prevent subtle numerical errors. Key validation points:","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"AI","language":"Other","updated":"2024-05-13","comments":5,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-validate-quantization-parameters-carefully.md"},{"slug":"tensorflow-optimize-loop-operations","title":"Optimize loop operations","description":"Minimize expensive operations within inner loops to improve performance. Key practices include: 1. Extract loop-invariant calculations outside of loops","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Performance Optimization","language":"Other","updated":"2024-05-10","comments":5,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-optimize-loop-operations.md"},{"slug":"semgrep-use-typed-interfaces","title":"Use typed interfaces","description":"Prefer typed interfaces over dictionary access to enable static type checking and prevent null reference errors. When accessing data structures, use typed objects with defined fields rather than dictionary key access, as this allows mypy to detect typos and missing fields at compile time.","repository":"semgrep/semgrep","domain":"security","topic":"Null Handling","language":"Python","updated":"2024-05-10","comments":3,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-use-typed-interfaces.md"},{"slug":"tensorflow-separate-test-data","title":"Separate test data","description":"Large test data should be separated from test logic to improve readability and maintainability. Move test data into separate files or define as constants at the top of test files. This makes the test bodies clearer and easier to understand.","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Testing","language":"Other","updated":"2024-05-10","comments":3,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-separate-test-data.md"},{"slug":"semgrep-use-descriptive-names","title":"Use descriptive names","description":"Names should clearly and accurately describe their purpose, avoiding abbreviations, acronyms, and misleading terms. This applies to variables, functions, types, constructors, and modules.","repository":"semgrep/semgrep","domain":"security","topic":"Naming Conventions","language":"Other","updated":"2024-05-07","comments":9,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-use-descriptive-names.md"},{"slug":"azure-quickstart-templates-deterministic-resource-naming","title":"Deterministic Resource Naming","description":"Use deterministic, semantically correct identifiers for ARM template parameters and resource names—especially where idempotency and uniqueness are required.","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Naming Conventions","language":"Json","updated":"2024-05-07","comments":7,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-deterministic-resource-naming.md"},{"slug":"compose-configuration-documentation-clarity","title":"Configuration documentation clarity","description":"Ensure configuration documentation clearly and accurately describes environment variables, command-line flags, and their relationships. Pay special attention to precedence rules, equivalent options, and proper grammar when explaining configuration behavior.","repository":"docker/compose","domain":"orchestration","topic":"Configurations","language":"Yaml","updated":"2024-05-07","comments":4,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-configuration-documentation-clarity.md"},{"slug":"core-prefer-safe-dom-manipulations","title":"Prefer safe DOM manipulations","description":"When manipulating DOM content, prefer safer alternatives to innerHTML when possible to prevent Cross-Site Scripting (XSS) vulnerabilities. For example, when clearing element content, use textContent instead of innerHTML:","repository":"vuejs/core","domain":"app-frameworks","topic":"Security","language":"TypeScript","updated":"2024-05-06","comments":2,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-prefer-safe-dom-manipulations.md"},{"slug":"react-router-distinguish-falsy-vs-nullish","title":"distinguish falsy vs nullish","description":"When handling potentially null or undefined values, carefully choose between the logical OR (`||`) and nullish coalescing (`??`) operators based on whether you want to preserve other falsy values.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Null Handling","language":"TSX","updated":"2024-05-06","comments":2,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-distinguish-falsy-vs-nullish.md"},{"slug":"uv-document-build-configurations","title":"Document build configurations","description":"When setting Rust build configurations, especially in CI/Docker environments, explicitly document optimization choices and their tradeoffs. Consider whether configurations should live in Cargo.toml, .cargo/config.toml, or as environment variables in CI scripts. For Docker builds, document RUSTFLAGS options like optimization levels, relocation models, and...","repository":"astral-sh/uv","domain":"devtools","topic":"Configurations","language":"Dockerfile","updated":"2024-05-05","comments":2,"stars":60322,"raw":"https://awesomereviewers.com/raw/uv-document-build-configurations.md"},{"slug":"awesome-go-vet-dependency-supply-chains","title":"Vet dependency supply chains","description":"When adding new dependencies, especially security-related ones, thoroughly evaluate them for supply chain attack risks. Look for red flags such as: repositories with many empty or automated commits, lack of transparent build processes (prefer GitHub Actions over opaque automation), use of unofficial forks instead of original packages, and suspicious account...","repository":"avelino/awesome-go","domain":"docs","topic":"Security","language":"Markdown","updated":"2024-05-05","comments":1,"stars":151435,"raw":"https://awesomereviewers.com/raw/awesome-go-vet-dependency-supply-chains.md"},{"slug":"alacritty-prefer-early-returns","title":"prefer early returns","description":"Use early returns and guard clauses to reduce nesting levels and improve code readability. When you have multiple conditional branches or error conditions, return early from the function rather than creating deeply nested if-else structures.","repository":"alacritty/alacritty","domain":"devtools","topic":"Code Style","language":"Rust","updated":"2024-05-03","comments":5,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-prefer-early-returns.md"},{"slug":"hyprland-precise-configuration-patterns","title":"Precise configuration patterns","description":"Use precise file patterns and correct installation paths in CMake configuration to avoid unintended inclusions and ensure proper system integration. Overly broad patterns can consume unrelated files from subprojects, while incorrect paths can break package discovery.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Configurations","language":"Txt","updated":"2024-05-02","comments":4,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-precise-configuration-patterns.md"},{"slug":"alacritty-configuration-documentation-accuracy","title":"Configuration documentation accuracy","description":"Ensure configuration documentation is accurate, consistent, and clearly indicates optional versus required values. Use consistent terminology throughout documentation, provide accurate technical details, and make examples actionable for developers.","repository":"alacritty/alacritty","domain":"devtools","topic":"Configurations","language":"Other","updated":"2024-04-30","comments":5,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-configuration-documentation-accuracy.md"},{"slug":"grafana-opt-in-configurable-caching","title":"Opt-in configurable caching","description":"Implement caching mechanisms as opt-in features with explicit configuration options rather than as defaults. This approach prevents unexpected behavior and allows teams to deliberately enable caching where beneficial.","repository":"grafana/grafana","domain":"observability","topic":"Caching","language":"TypeScript","updated":"2024-04-30","comments":2,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-opt-in-configurable-caching.md"},{"slug":"kotlin-use-modern-test-infrastructure","title":"Use modern test infrastructure","description":"Always add new tests to the current recommended test infrastructure rather than legacy systems that are being phased out. This reduces technical debt and ensures tests remain maintainable as the codebase evolves.","repository":"JetBrains/kotlin","domain":"runtimes","topic":"Testing","language":"Other","updated":"2024-04-30","comments":2,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-use-modern-test-infrastructure.md"},{"slug":"lobe-chat-contextual-error-handling","title":"Contextual error handling","description":"Implement error handling that is both architecturally localized and contextually specific to provide better user experience and system resilience. Use localized error boundaries to prevent cascading failures while ensuring error messages are specific to the actual problem and provide actionable guidance.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"Error Handling","language":"TSX","updated":"2024-04-30","comments":2,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-contextual-error-handling.md"},{"slug":"semgrep-ensure-comprehensive-test-coverage","title":"Ensure comprehensive test coverage","description":"Tests should validate all expected behaviors, variants, and edge cases rather than covering only the happy path. When implementing tests, ensure you include scenarios for all relevant configurations, types, or levels that your code supports.","repository":"semgrep/semgrep","domain":"security","topic":"Testing","language":"Yaml","updated":"2024-04-29","comments":3,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-ensure-comprehensive-test-coverage.md"},{"slug":"lobe-chat-account-for-model-variations","title":"Account for model variations","description":"When implementing features that interact with AI models, consider the behavioral differences between various models and adjust parameters accordingly. Different AI models have distinct characteristics such as output speed, token generation patterns, and response formats that can significantly impact user experience.","repository":"lobehub/lobe-chat","domain":"ai-agents","topic":"AI","language":"TSX","updated":"2024-04-29","comments":2,"stars":65138,"raw":"https://awesomereviewers.com/raw/lobe-chat-account-for-model-variations.md"},{"slug":"waveterm-explicit-api-shapes","title":"Explicit API shapes","description":"Require API surfaces (payloads, function contracts, and compact descriptor grammars) to be explicit, well-documented, and normalized at the boundary. This reduces client/server surprises, clarifies intent (single vs collection), and ensures deterministic parsing.","repository":"wavetermdev/waveterm","domain":"devtools","topic":"API","language":"TypeScript","updated":"2024-04-26","comments":5,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-explicit-api-shapes.md"},{"slug":"semgrep-use-consistent-javascript-syntax","title":"use consistent JavaScript syntax","description":"Maintain consistent use of modern JavaScript syntax throughout networking code to improve reliability and maintainability. Use `const` or `let` instead of `var` for variable declarations, and prefer strict equality (`===`) over loose equality (`==`) for comparisons.","repository":"semgrep/semgrep","domain":"security","topic":"Networking","language":"JavaScript","updated":"2024-04-26","comments":2,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-use-consistent-javascript-syntax.md"},{"slug":"semgrep-design-consistent-tracing-interfaces","title":"Design consistent tracing interfaces","description":"When implementing observability features like tracing, prioritize consistent and extensible API design. Use structured annotations that can accommodate future configuration options rather than simple flags. Place tracing instrumentation directly on the functions being measured rather than creating wrapper functions. Follow established naming conventions...","repository":"semgrep/semgrep","domain":"security","topic":"Observability","language":"Other","updated":"2024-04-25","comments":4,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-design-consistent-tracing-interfaces.md"},{"slug":"material-ui-follow-library-recommendations","title":"Follow library recommendations","description":"When writing tests, prioritize following the official recommendations and best practices of testing libraries (like Playwright) even if they appear more verbose than alternatives. Library recommendations typically address edge cases, improve reliability, and future-proof your tests.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Testing","language":"TypeScript","updated":"2024-04-25","comments":2,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-follow-library-recommendations.md"},{"slug":"unstructured-write-clear-test-cases","title":"Write clear test cases","description":"Structure test cases for maximum readability and maintainability by following these principles: 1. Organize each test in three distinct parts separated by blank lines:","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Testing","language":"Python","updated":"2024-04-24","comments":9,"stars":12116,"raw":"https://awesomereviewers.com/raw/unstructured-write-clear-test-cases.md"},{"slug":"opentofu-use-relative-documentation-links","title":"Use relative documentation links","description":"When documenting error handling mechanisms, always use relative path references (`../path/to/file.mdx`) instead of absolute paths (`/docs/path/to/file`) when creating documentation links. This ensures documentation about error handling, assertions, validations, and error recovery patterns remains navigable even when documentation structures change.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Error Handling","language":"Other","updated":"2024-04-24","comments":2,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-use-relative-documentation-links.md"},{"slug":"elasticsearch-complete-api-parameter-documentation","title":"Complete API parameter documentation","description":"API endpoints must include comprehensive documentation for all parameters. For each parameter, clearly specify: 1. Whether it''s required or optional 2. The data type and format","repository":"elastic/elasticsearch","domain":"data-systems","topic":"API","language":"Other","updated":"2024-04-23","comments":2,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-complete-api-parameter-documentation.md"},{"slug":"jan-model-description-accuracy","title":"model description accuracy","description":"Ensure AI model descriptions are specific, capability-focused, and avoid marketing language or temporal references like \"latest\". Descriptions should clearly communicate what the model excels at and its intended use cases to help users make informed selection decisions.","repository":"menloresearch/jan","domain":"llm-infra","topic":"AI","language":"Json","updated":"2024-04-22","comments":4,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-model-description-accuracy.md"},{"slug":"swe-agent-api-version-management","title":"API version management","description":"When integrating with external APIs, explicitly handle version differences and use parameterized configurations instead of hardcoded values. Different API versions often require different request methods, endpoints, or parameters, so version-specific logic should be clearly defined to prevent incorrect API calls.","repository":"SWE-agent/SWE-agent","domain":"ai-agents","topic":"API","language":"Python","updated":"2024-04-20","comments":3,"stars":16839,"raw":"https://awesomereviewers.com/raw/swe-agent-api-version-management.md"},{"slug":"zod-define-validation-contracts","title":"Define Validation Contracts","description":"When adding/maintaining API validation schemas, make the input contract explicit: specify exactly what input types are accepted, and whether the schema is parsing (strict mapping) or coercing/converting values. Don’t rely on assumptions about built-in JS semantics or on a single runtime’s concrete types.","repository":"colinhacks/zod","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2024-04-19","comments":4,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-define-validation-contracts.md"},{"slug":"zod-explicit-null-handling","title":"Explicit null handling","description":"Treat `null`/`undefined` and “absence vs presence” as first-class concerns. - **TypeScript:** Keep null safety effective by ensuring `strictNullChecks` is enabled and not overridden by extended configs (explicitly set it to `true` if needed).","repository":"colinhacks/zod","domain":"app-frameworks","topic":"Null Handling","language":"Markdown","updated":"2024-04-19","comments":3,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-explicit-null-handling.md"},{"slug":"zod-deterministic-parse-fallbacks","title":"Deterministic Parse Fallbacks","description":"When parsing inputs that may be invalid (e.g., string → boolean), do not rely on implicit/unclear failure behavior. Instead, decide explicitly how parse errors should be handled and make it deterministic.","repository":"colinhacks/zod","domain":"app-frameworks","topic":"Error Handling","language":"Markdown","updated":"2024-04-19","comments":2,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-deterministic-parse-fallbacks.md"},{"slug":"semgrep-document-configuration-troubleshooting","title":"Document configuration troubleshooting","description":"Configuration files and scripts should include comprehensive documentation that helps developers understand their purpose, scope, and how to troubleshoot common issues. This includes adding comments that explain what the configuration does, what errors might occur, and specific steps to resolve them.","repository":"semgrep/semgrep","domain":"security","topic":"Configurations","language":"Shell","updated":"2024-04-18","comments":3,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-document-configuration-troubleshooting.md"},{"slug":"cli-maintain-build-environment-parity","title":"maintain build environment parity","description":"Ensure that local development and CI/CD environments use identical build commands and dependency management strategies to prevent deployment issues and environment drift. When introducing local-specific build targets, consider whether the same approach should be adopted in CI pipelines to maintain consistency.","repository":"snyk/cli","domain":"security","topic":"CI/CD","language":"Other","updated":"2024-04-18","comments":2,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-maintain-build-environment-parity.md"},{"slug":"express-pin-action-commit-hashes","title":"Pin action commit hashes","description":"Always pin third-party GitHub Actions to specific commit hashes rather than semantic version tags (like `@v1`). This prevents automatic execution of potentially malicious code if the maintainer updates the tag. Additionally, minimize permission scopes for any tokens used in workflows, and consider replacing third-party actions with direct implementations...","repository":"expressjs/express","domain":"app-frameworks","topic":"Security","language":"Yaml","updated":"2024-04-18","comments":1,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-pin-action-commit-hashes.md"},{"slug":"opentofu-secure-encryption-key-backups","title":"Secure encryption key backups","description":"Always implement proper encryption key management procedures, including secure backups of encryption keys before enabling encryption features. Without proper key backups, encrypted data can become permanently inaccessible, creating security and operational risks.","repository":"opentofu/opentofu","domain":"cloud-infra","topic":"Security","language":"Other","updated":"2024-04-18","comments":1,"stars":25901,"raw":"https://awesomereviewers.com/raw/opentofu-secure-encryption-key-backups.md"},{"slug":"waveterm-centralize-constants-and-structure","title":"Centralize constants and structure","description":"Motivation Keep code readable, consistent and easy to change by centralizing configuration, constants and mutable state, and by extracting repeated flows into well-scoped helpers or service types.","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Code Style","language":"Go","updated":"2024-04-17","comments":5,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-centralize-constants-and-structure.md"},{"slug":"semgrep-document-configuration-choices","title":"Document configuration choices","description":"Add explanatory comments for non-obvious configuration settings, especially when they deviate from defaults or serve specific purposes. Configuration choices that aren't immediately clear should include comments explaining their rationale, impact, or relationship to other settings.","repository":"semgrep/semgrep","domain":"security","topic":"Configurations","language":"Other","updated":"2024-04-17","comments":4,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-document-configuration-choices.md"},{"slug":"semgrep-simplify-complex-logic","title":"Simplify complex logic","description":"Break down complex code structures into simpler, more readable forms. Long indented blocks, verbose conditionals, and repetitive patterns should be simplified to improve code clarity and maintainability.","repository":"semgrep/semgrep","domain":"security","topic":"Code Style","language":"Python","updated":"2024-04-17","comments":4,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-simplify-complex-logic.md"},{"slug":"refact-separate-multiple-imports","title":"Separate multiple imports","description":"When importing multiple items from the same module, use separate import statements instead of combining them on a single line. This improves code readability and makes it easier to track individual imports during code reviews and refactoring.","repository":"smallcloudai/refact","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2024-04-17","comments":2,"stars":3114,"raw":"https://awesomereviewers.com/raw/refact-separate-multiple-imports.md"},{"slug":"waveterm-centralize-database-operations","title":"Centralize database operations","description":"Keep all SQL and DB-specific logic in a single dbops layer and expose a small, consistent API that handles common patterns: insert/update (use REPLACE/UPSERT), delete, queries, and serialization of complex fields. Motivation: reduces duplicated SQL across packages, avoids mismatch between INSERT vs UPDATE code paths, and centralizes...","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Database","language":"Go","updated":"2024-04-17","comments":2,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-centralize-database-operations.md"},{"slug":"waveterm-config-precedence","title":"Config precedence","description":"Establish a clear configuration precedence and control policy: explicit user-supplied settings take priority over automatic detection, unless a centralized policy (e.g., cloud/service-side limits or security constraints) explicitly disallows client overrides. Motivation: prevents surprising behavior while allowing deliberate overrides and enforcing...","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Configurations","language":"Go","updated":"2024-04-16","comments":2,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-config-precedence.md"},{"slug":"go-maintain-backward-compatibility","title":"maintain backward compatibility","description":"When modifying existing APIs, preserve original parameter types and return signatures to avoid breaking client code. Even when internal implementations change or new functionality is added, the public interface should remain stable for existing consumers.","repository":"golang/go","domain":"runtimes","topic":"API","language":"Go","updated":"2024-04-13","comments":2,"stars":129599,"raw":"https://awesomereviewers.com/raw/go-maintain-backward-compatibility.md"},{"slug":"tokio-code-block-formatting-standards","title":"Code block formatting standards","description":"When documenting code examples and shell commands in project documentation, follow these formatting standards to ensure consistency and clarity: 1. **Use appropriate language specifiers**:","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Documentation","language":"Markdown","updated":"2024-04-12","comments":4,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-code-block-formatting-standards.md"},{"slug":"tokio-clear-command-documentation","title":"Clear command documentation","description":"When documenting shell commands in technical documentation, use the `shell` language identifier instead of `bash` as commands are typically relevant to any shell. Separate commands and their output into different code blocks to make it clearer what users should actually input. This improves readability and prevents users from accidentally copying output...","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Documentation","language":"Markdown","updated":"2024-04-12","comments":3,"stars":28989,"raw":"https://awesomereviewers.com/raw/tokio-clear-command-documentation.md"},{"slug":"semgrep-document-code-purpose","title":"Document code purpose","description":"Ensure that code elements have clear documentation explaining their purpose, behavior, and context. This includes function parameters (especially non-obvious ones), complex business logic, and magic values or constants.","repository":"semgrep/semgrep","domain":"security","topic":"Documentation","language":"Python","updated":"2024-04-11","comments":4,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-document-code-purpose.md"},{"slug":"prettier-use-cross-platform-commands","title":"Use cross-platform commands","description":"When writing CI/CD scripts and documentation, prefer Node.js APIs over shell commands for file operations to ensure cross-platform compatibility. Shell commands like `echo \"content\" > file` don't work consistently across different operating systems, particularly Windows, which can cause CI/CD pipelines to fail.","repository":"prettier/prettier","domain":"devtools","topic":"CI/CD","language":"Markdown","updated":"2024-04-10","comments":2,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-use-cross-platform-commands.md"},{"slug":"waveterm-sanitize-css-values","title":"Sanitize CSS values","description":"When generating CSS from external data (JSON, user input, theme files), validate and sanitize both CSS property names and values before injecting them into style elements to prevent style-breaking input and XSS/style injection.","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Security","language":"TSX","updated":"2024-04-10","comments":1,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-sanitize-css-values.md"},{"slug":"semgrep-benchmark-performance-assumptions","title":"Benchmark performance assumptions","description":"Always validate performance concerns with actual measurements before making optimization decisions. Avoid making assumptions about what is \"too slow\" without benchmarking evidence.","repository":"semgrep/semgrep","domain":"security","topic":"Performance Optimization","language":"Other","updated":"2024-04-09","comments":4,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-benchmark-performance-assumptions.md"},{"slug":"rails-semantic-html-usage","title":"Semantic HTML usage","description":"Use HTML elements according to their semantic purpose to ensure proper accessibility and code organization. Choose elements based on their intended role, not just how they appear visually:","repository":"rails/rails","domain":"app-frameworks","topic":"Code Style","language":"Other","updated":"2024-04-09","comments":3,"stars":57027,"raw":"https://awesomereviewers.com/raw/rails-semantic-html-usage.md"},{"slug":"spring-boot-consistent-observability-data","title":"Consistent observability data","description":"When implementing observability features, always ensure consistency in your data model, especially with tags and attributes. This helps prevent issues with backends that expect consistent tag sets.","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Observability","language":"Java","updated":"2024-04-05","comments":7,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-consistent-observability-data.md"},{"slug":"semgrep-validate-ci-pipeline-inputs","title":"Validate CI pipeline inputs","description":"Always validate and sanitize dynamic inputs in CI/CD pipelines before using them in URLs, file operations, or other system interactions. This includes environment variables, repository names, file paths, and user-provided parameters that could contain special characters, spaces, or unexpected formats.","repository":"semgrep/semgrep","domain":"security","topic":"CI/CD","language":"Python","updated":"2024-04-05","comments":2,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-validate-ci-pipeline-inputs.md"},{"slug":"workers-sdk-use-configuration-placeholders","title":"Use configuration placeholders","description":"Configuration files should use placeholder values like `<TBD>` instead of hardcoded values for fields that need to be dynamically replaced by tooling or build processes. This ensures that automated systems can properly substitute the correct values during project setup or deployment.","repository":"cloudflare/workers-sdk","domain":"cloud-infra","topic":"Configurations","language":"Toml","updated":"2024-04-02","comments":2,"stars":3379,"raw":"https://awesomereviewers.com/raw/workers-sdk-use-configuration-placeholders.md"},{"slug":"semgrep-require-module-documentation","title":"require module documentation","description":"All modules containing functions should have corresponding .mli files with comprehensive documentation. The .mli file must include: 1. **Module purpose**: A clear, high-level description of what the module does and why it exists","repository":"semgrep/semgrep","domain":"security","topic":"Documentation","language":"Other","updated":"2024-03-31","comments":11,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-require-module-documentation.md"},{"slug":"tokenizers-smart-configuration-defaults","title":"Smart configuration defaults","description":"Prefer smart configuration defaults that auto-detect the environment instead of requiring explicit configuration flags. When possible, implement automatic detection of the runtime context and provide sensible defaults while still allowing explicit overrides.","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"Configurations","language":"Python","updated":"2024-03-30","comments":2,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-smart-configuration-defaults.md"},{"slug":"semgrep-add-comprehensive-test-coverage","title":"Add comprehensive test coverage","description":"Ensure all code changes include appropriate unit tests and address any identified testing gaps immediately. When reviewing code, verify that: 1. **New functionality has corresponding tests**: Every new feature or significant code change should include unit tests that exercise the new behavior.","repository":"semgrep/semgrep","domain":"security","topic":"Testing","language":"Other","updated":"2024-03-29","comments":3,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-add-comprehensive-test-coverage.md"},{"slug":"alacritty-platform-specific-api-documentation","title":"Platform-specific API documentation","description":"The provided discussions focus on terminal emulator documentation and configuration issues, but do not contain any content related to networking (network protocols, HTTP requests, TCP/IP, DNS, websockets, data transfer, network security, or connection management).","repository":"alacritty/alacritty","domain":"devtools","topic":"Networking","language":"Other","updated":"2024-03-28","comments":4,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-platform-specific-api-documentation.md"},{"slug":"celery-celery-integration-correctness","title":"Celery Integration Correctness","description":"Celery should only execute tasks when its assumptions about state and message format are guaranteed. Apply these rules: 1) Django: trigger tasks after the DB commit","repository":"celery/celery","domain":"orchestration","topic":"Celery","language":"Other","updated":"2024-03-28","comments":2,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-celery-integration-correctness.md"},{"slug":"cli-avoid-hardcoded-configuration-values","title":"avoid hardcoded configuration values","description":"Replace hardcoded URLs, ports, file paths, and environment-specific strings with configurable parameters. Hardcoded values make code difficult to test, deploy across different environments, and maintain over time.","repository":"snyk/cli","domain":"security","topic":"Configurations","language":"TypeScript","updated":"2024-03-27","comments":4,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-avoid-hardcoded-configuration-values.md"},{"slug":"spring-framework-use-assertj-correctly","title":"Use AssertJ correctly","description":"Spring Framework tests must use AssertJ for assertions rather than JUnit''s `Assertions`, Spring''s `Assert` class, or plain `assert` statements. Follow these AssertJ best practices:","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Testing","language":"Java","updated":"2024-03-26","comments":7,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-use-assertj-correctly.md"},{"slug":"spring-framework-api-boundary-null-handling","title":"API boundary null handling","description":"Establish consistent null handling patterns at API boundaries to prevent null pointer exceptions and improve code clarity: 1. Validate method parameters using explicit null checks:","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Null Handling","language":"Java","updated":"2024-03-26","comments":5,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-api-boundary-null-handling.md"},{"slug":"mermaid-document-intent-consistently","title":"Document intent consistently","description":"When code changes affect how people understand or use behavior—especially grammar directives/annotations or feature support—add documentation that explains intent and keeps docs aligned with current functionality.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Documentation","language":"Other","updated":"2024-03-26","comments":2,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-document-intent-consistently.md"},{"slug":"unstructured-embedding-provider-configuration","title":"embedding provider configuration","description":"When configuring embedding providers in AI integrations, ensure proper dimension specification and use dedicated test files for different providers. Always specify the embedding dimension that matches your chosen provider (e.g., 384 for huggingface embedders) and avoid modifying existing configurations for testing purposes.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"AI","language":"Shell","updated":"2024-03-26","comments":2,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-embedding-provider-configuration.md"},{"slug":"semgrep-defensive-authorization-checks","title":"Defensive authorization checks","description":"Always implement explicit authentication and authorization checks before granting access to premium features or sensitive operations, even when other conditions might imply proper authorization. Use defensive programming to prevent accidental privilege escalation.","repository":"semgrep/semgrep","domain":"security","topic":"Security","language":"Python","updated":"2024-03-25","comments":3,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-defensive-authorization-checks.md"},{"slug":"semgrep-use-descriptive-variable-names","title":"Use descriptive variable names","description":"Choose variable and parameter names that clearly communicate their purpose and avoid misleading or cryptic naming. Names should be self-documenting and reduce cognitive load for other developers.","repository":"semgrep/semgrep","domain":"security","topic":"Naming Conventions","language":"Python","updated":"2024-03-25","comments":3,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-use-descriptive-variable-names.md"},{"slug":"gin-early-return-pattern","title":"Early return pattern","description":"Prefer returning early from functions rather than nesting conditions. When a condition can lead to an early exit, handle it immediately and return rather than wrapping the main logic in else blocks. This approach reduces nesting, improves code readability, and reduces cognitive load.","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"Code Style","language":"Go","updated":"2024-03-22","comments":3,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-early-return-pattern.md"},{"slug":"unstructured-separate-formatting-changes","title":"separate formatting changes","description":"Keep formatting and style changes separate from functional code changes to maintain clear, reviewable diffs. When making functional changes, avoid simultaneously reordering imports, adjusting whitespace, or making other cosmetic modifications that obscure the actual logic changes. If formatting improvements are needed, submit them as standalone pull...","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Code Style","language":"Other","updated":"2024-03-22","comments":2,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-separate-formatting-changes.md"},{"slug":"waveterm-prefer-semantic-names","title":"Prefer semantic names","description":"Make identifiers convey intent: include meaningful domain fields in types and choose function names that reflect user-facing semantics (not internal storage order). When internal representation differs from user expectations (for example newest items appended to the end, but UI cycles newest-first), rename functions to express the user direction and add a...","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Naming Conventions","language":"TypeScript","updated":"2024-03-22","comments":2,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-prefer-semantic-names.md"},{"slug":"react-router-document-configuration-rationale","title":"Document configuration rationale","description":"When adding or modifying configuration files, always include clear comments or documentation explaining the reasoning behind non-obvious choices, especially when suppressing warnings, excluding files, or making decisions that deviate from defaults.","repository":"remix-run/react-router","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2024-03-21","comments":3,"stars":55270,"raw":"https://awesomereviewers.com/raw/react-router-document-configuration-rationale.md"},{"slug":"cli-use-optional-chaining","title":"Use optional chaining","description":"Always use optional chaining (`?.`) and null checks when accessing properties or methods on objects that might be null or undefined. This prevents runtime crashes and makes code more robust.","repository":"snyk/cli","domain":"security","topic":"Null Handling","language":"TypeScript","updated":"2024-03-19","comments":5,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-use-optional-chaining.md"},{"slug":"semgrep-conservative-security-assumptions","title":"Conservative security assumptions","description":"When implementing security measures, always err on the side of caution by making conservative assumptions about potential risks. This principle applies across multiple security contexts:","repository":"semgrep/semgrep","domain":"security","topic":"Security","language":"Other","updated":"2024-03-19","comments":3,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-conservative-security-assumptions.md"},{"slug":"brew-correct-github-actions-annotations","title":"Correct GitHub Actions annotations","description":"When using GitHub Actions workflow commands for annotations, always include double colons in the syntax (::command::). Proper formatting ensures warnings and errors are correctly displayed in the GitHub Actions UI and processed by workflow runners.","repository":"Homebrew/brew","domain":"devtools","topic":"CI/CD","language":"Ruby","updated":"2024-03-14","comments":4,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-correct-github-actions-annotations.md"},{"slug":"cli-optimize-ci-resource-allocation","title":"optimize CI resource allocation","description":"Match CI/CD resource allocation to actual job requirements rather than using oversized configurations globally. Create specialized executors and resource classes for different job types to optimize cost and performance.","repository":"snyk/cli","domain":"security","topic":"CI/CD","language":"Yaml","updated":"2024-03-14","comments":3,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-optimize-ci-resource-allocation.md"},{"slug":"refact-avoid-problematic-identifier-names","title":"avoid problematic identifier names","description":"Choose identifier names that avoid system compatibility issues and follow proper naming conventions. Avoid reserved words, system-problematic names, and invalid characters that can cause issues across different platforms or violate language standards.","repository":"smallcloudai/refact","domain":"ai-agents","topic":"Naming Conventions","language":"Python","updated":"2024-03-14","comments":2,"stars":3114,"raw":"https://awesomereviewers.com/raw/refact-avoid-problematic-identifier-names.md"},{"slug":"prisma-official-product-naming","title":"Official product naming","description":"When referencing external products, libraries, or services in documentation and code, always use their official names exactly as specified by the vendor, and treat them as proper nouns without articles.","repository":"prisma/prisma","domain":"data-systems","topic":"Naming Conventions","language":"Markdown","updated":"2024-03-13","comments":2,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-official-product-naming.md"},{"slug":"cli-synchronize-configuration-values","title":"synchronize configuration values","description":"Ensure configuration values remain consistent and aligned across all related files, environments, and systems. When updating versions, parameters, or settings in one location, verify and update corresponding values in other configuration files to prevent mismatches that can lead to build failures or environment pollution.","repository":"snyk/cli","domain":"security","topic":"Configurations","language":"Yaml","updated":"2024-03-11","comments":3,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-synchronize-configuration-values.md"},{"slug":"istio-consistent-log-formatting","title":"consistent log formatting","description":"Maintain consistent formatting conventions across log messages to improve code readability and debugging effectiveness. Use proper format specifiers (%v for errors, not %s), maintain consistent spacing around punctuation (no spaces before colons), and ensure consistent label semantics when logging similar data structures.","repository":"istio/istio","domain":"orchestration","topic":"Logging","language":"Go","updated":"2024-03-11","comments":3,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-consistent-log-formatting.md"},{"slug":"material-ui-use-screen-queries","title":"Use screen queries","description":"When writing component tests, prefer using global `screen` queries from Testing Library instead of container-specific queries or passing query functions as parameters. This approach keeps the test environment simple and consistent across the codebase.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Testing","language":"TSX","updated":"2024-03-10","comments":2,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-use-screen-queries.md"},{"slug":"refact-model-appropriate-configuration","title":"model-appropriate configuration","description":"Ensure AI models use configuration settings that match their specific architecture and requirements. Different model families (e.g., BigCode vs LLaMA) require different tokenizer configurations, memory management settings, and parameter mappings. Avoid using generic or copy-pasted configurations across different model types.","repository":"smallcloudai/refact","domain":"ai-agents","topic":"AI","language":"Python","updated":"2024-03-09","comments":4,"stars":3114,"raw":"https://awesomereviewers.com/raw/refact-model-appropriate-configuration.md"},{"slug":"cli-defensive-shell-script-configuration","title":"defensive shell script configuration","description":"Configure shell scripts with defensive practices to ensure reliability and debuggability. Use appropriate `set` options for error handling and debugging, implement safe defaults that require explicit opt-in for risky operations, and preserve execution state when changing directories.","repository":"snyk/cli","domain":"security","topic":"Configurations","language":"Shell","updated":"2024-03-08","comments":3,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-defensive-shell-script-configuration.md"},{"slug":"semgrep-choose-efficient-algorithms","title":"Choose efficient algorithms","description":"When implementing algorithms, prioritize computational efficiency by selecting appropriate data structures and avoiding unnecessarily complex approaches. Consider the time complexity of your solution and whether built-in functions or better data structures could improve performance.","repository":"semgrep/semgrep","domain":"security","topic":"Algorithms","language":"Other","updated":"2024-03-07","comments":5,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-choose-efficient-algorithms.md"},{"slug":"alacritty-use-constraining-types","title":"Use constraining types","description":"API functions should use specific types and enums to clearly communicate valid parameter values rather than accepting arbitrary generic types that suggest any value is acceptable.","repository":"alacritty/alacritty","domain":"devtools","topic":"API","language":"Rust","updated":"2024-03-07","comments":3,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-use-constraining-types.md"},{"slug":"esbuild-cross-platform-api-consistency","title":"cross-platform API consistency","description":"Design APIs to provide consistent behavior and user experience across different runtime environments and module systems. Abstract platform-specific differences behind a uniform interface so users don't need to handle environment-specific logic.","repository":"evanw/esbuild","domain":"devtools","topic":"API","language":"TypeScript","updated":"2024-03-07","comments":2,"stars":39161,"raw":"https://awesomereviewers.com/raw/esbuild-cross-platform-api-consistency.md"},{"slug":"jan-use-platform-specific-endpoints","title":"Use platform-specific endpoints","description":"When configuring API integrations, always use the actual platform-specific endpoints and identifiers rather than generic placeholders. Generic configurations often lead to integration failures and confusion for users following documentation.","repository":"menloresearch/jan","domain":"llm-infra","topic":"API","language":"Other","updated":"2024-03-07","comments":2,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-use-platform-specific-endpoints.md"},{"slug":"semgrep-ci-workflow-optimization","title":"CI workflow optimization","description":"Optimize CI/CD workflows by prioritizing reliability over convenience and leveraging built-in platform features. When workflows generate files or have complex dependencies, use brute-force approaches like `make clean; make` to ensure reproducible builds, even if it seems inefficient. Simplify workflow steps by using native GitHub Actions features instead of...","repository":"semgrep/semgrep","domain":"security","topic":"CI/CD","language":"Yaml","updated":"2024-03-06","comments":4,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-ci-workflow-optimization.md"},{"slug":"semgrep-defensive-optional-handling","title":"Defensive optional handling","description":"Always handle optional and nullable values defensively by checking for null/empty states before use and handling multiple optional values independently. Use explicit null coalescing patterns to provide safe defaults, and avoid nesting optional value logic when they should be processed independently.","repository":"semgrep/semgrep","domain":"security","topic":"Null Handling","language":"Other","updated":"2024-03-06","comments":3,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-defensive-optional-handling.md"},{"slug":"nest-document-configuration-behaviors","title":"Document configuration behaviors","description":"Always document configuration options thoroughly, especially for module and service settings. For each configuration property: 1. Provide clear descriptions of what the option does","repository":"nestjs/nest","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2024-03-05","comments":4,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-document-configuration-behaviors.md"},{"slug":"fiber-avoid-count1-flag","title":"avoid `-count=1` flag","description":"Avoid using the `-count=1` flag in Go test commands unless specifically required to disable test caching. Removing this flag enables concurrent test execution, which not only improves test performance but more importantly allows for better detection of data races during testing.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Testing","language":"Yaml","updated":"2024-03-04","comments":2,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-avoid-count1-flag.md"},{"slug":"hyprland-precise-documentation-language","title":"Precise documentation language","description":"Documentation language should be precise, unambiguous, and clearly scoped to prevent misinterpretation while maintaining readability. Avoid open-ended terms that could be misunderstood or exploited, and use established terminology when dealing with legal, technical, or domain-specific concepts.","repository":"hyprwm/Hyprland","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2024-03-02","comments":4,"stars":28863,"raw":"https://awesomereviewers.com/raw/hyprland-precise-documentation-language.md"},{"slug":"poetry-document-configuration-clearly","title":"Document configuration clearly","description":"Configuration files, hooks, and settings should include clear, accurate descriptions that explain their purpose and behavior. Descriptions should match the actual functionality and help developers understand what the configuration does and why it exists.","repository":"python-poetry/poetry","domain":"devtools","topic":"Configurations","language":"Yaml","updated":"2024-02-29","comments":4,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-document-configuration-clearly.md"},{"slug":"semgrep-use-appropriate-test-markers","title":"use appropriate test markers","description":"Test markers and annotations should match the test type and context they're applied to. Different test categories (unit tests, e2e tests, integration tests) require different markers to ensure proper test organization and execution.","repository":"semgrep/semgrep","domain":"security","topic":"Testing","language":"Python","updated":"2024-02-29","comments":2,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-use-appropriate-test-markers.md"},{"slug":"mermaid-add-screenshot-coverage","title":"Add screenshot coverage","description":"When adding a new rendering demo or introducing a new configuration/YAML option, always update the relevant Cypress integration/screenshot tests so the feature is exercised and captured automatically.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Testing","language":"Html","updated":"2024-02-28","comments":2,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-add-screenshot-coverage.md"},{"slug":"poetry-configure-http-requests-properly","title":"Configure HTTP requests properly","description":"When making HTTP requests, use standard library enums for status codes, set appropriate timeouts, and handle redirects efficiently. Avoid raw status code numbers in favor of HTTPStatus enums for better readability and maintainability. Always configure timeouts to prevent indefinite hanging, preferably making them configurable via environment variables with...","repository":"python-poetry/poetry","domain":"devtools","topic":"Networking","language":"Python","updated":"2024-02-26","comments":5,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-configure-http-requests-properly.md"},{"slug":"tensorflow-tensor-aware-control-flow","title":"Tensor-aware control flow","description":"When working with TensorFlow tensors, avoid using Python comparison operators (`<`, `>=`, `==`) or conditional checks that expect Boolean scalars. Python operators evaluate eagerly and won't work correctly with tensors that represent deferred computations.","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"AI","language":"Python","updated":"2024-02-26","comments":4,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-tensor-aware-control-flow.md"},{"slug":"poetry-cache-expensive-computations","title":"Cache expensive computations","description":"Identify expensive operations that may be called multiple times and implement appropriate caching mechanisms to avoid redundant computation. Use `@cached_property` for class properties that involve expensive calculations, store expensive method calls in local variables when used repeatedly in loops, and consider memoization for frequently accessed data that...","repository":"python-poetry/poetry","domain":"devtools","topic":"Performance Optimization","language":"Python","updated":"2024-02-25","comments":4,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-cache-expensive-computations.md"},{"slug":"fiber-justified-nolint-exceptions","title":"justified nolint exceptions","description":"When style linters cannot be applied universally across a codebase due to architectural constraints or legitimate use cases, use targeted `//nolint` comments with clear explanations rather than disabling the linter entirely. This approach maintains code style standards while allowing necessary exceptions.","repository":"gofiber/fiber","domain":"app-frameworks","topic":"Code Style","language":"Yaml","updated":"2024-02-25","comments":2,"stars":37560,"raw":"https://awesomereviewers.com/raw/fiber-justified-nolint-exceptions.md"},{"slug":"tensorflow-parameterize-cicd-scripts","title":"Parameterize ci/cd scripts","description":"Avoid duplicating CI/CD scripts by leveraging configuration files and parameterization instead of creating multiple similar scripts for different platforms or build scenarios. Use platform-specific configuration options in shared config files (like .bazelrc) or make scripts accept parameters for variant behaviors.","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"CI/CD","language":"Shell","updated":"2024-02-24","comments":2,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-parameterize-cicd-scripts.md"},{"slug":"alacritty-consistent-error-handling","title":"consistent error handling","description":"Maintain uniform error handling patterns throughout the codebase. Avoid mixing different error handling approaches like panics, process::exit(), and proper Result returns within the same application flow.","repository":"alacritty/alacritty","domain":"devtools","topic":"Error Handling","language":"Rust","updated":"2024-02-23","comments":4,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-consistent-error-handling.md"},{"slug":"grafana-design-token-value-consistency","title":"Design token value consistency","description":"When implementing design tokens in code, ensure values accurately represent the intended visual outcome, even if design tools have limitations. Use proper unit types that correctly translate to UI rendering rather than arbitrary numeric values.","repository":"grafana/grafana","domain":"observability","topic":"Code Style","language":"Json","updated":"2024-02-23","comments":3,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-design-token-value-consistency.md"},{"slug":"jan-api-interface-consistency","title":"API interface consistency","description":"Ensure that API function signatures, return types, and interface implementations are consistent and properly declared. When modifying functions to be asynchronous or changing their return types, update both the implementation and any related type declarations to maintain contract integrity.","repository":"menloresearch/jan","domain":"llm-infra","topic":"API","language":"TypeScript","updated":"2024-02-23","comments":2,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-api-interface-consistency.md"},{"slug":"prometheus-avoid-panics-gracefully","title":"avoid panics gracefully","description":"Never use panic() for error handling in production code paths, especially in core engine components. Instead, handle errors gracefully by returning appropriate values or ignoring problematic data with optional warnings.","repository":"prometheus/prometheus","domain":"observability","topic":"Error Handling","language":"Go","updated":"2024-02-22","comments":5,"stars":59616,"raw":"https://awesomereviewers.com/raw/prometheus-avoid-panics-gracefully.md"},{"slug":"ui-use-concise-methods","title":"Use concise methods","description":"Prefer built-in methods and properties that achieve the same result with less code. This improves readability, reduces potential bugs, and makes your code more maintainable.","repository":"shadcn-ui/ui","domain":"app-frameworks","topic":"Code Style","language":"Other","updated":"2024-02-22","comments":2,"stars":90568,"raw":"https://awesomereviewers.com/raw/ui-use-concise-methods.md"},{"slug":"helix-hide-implementation-details","title":"hide implementation details","description":"When designing APIs, avoid exposing internal structures, implementation details, or platform-specific concepts to external consumers. Instead, create clean, stable interfaces that focus on what users need to accomplish rather than how the system works internally.","repository":"helix-editor/helix","domain":"devtools","topic":"API","language":"Rust","updated":"2024-02-20","comments":4,"stars":39026,"raw":"https://awesomereviewers.com/raw/helix-hide-implementation-details.md"},{"slug":"tensorflow-format-lines-and-comments","title":"Format lines and comments","description":"Ensure all code follows formatting guidelines for readability and consistency. Keep lines under 80 characters, splitting longer lines appropriately across multiple lines when needed. All comments should be written as complete sentences with proper capitalization and ending punctuation.","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Code Style","language":"Python","updated":"2024-02-20","comments":2,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-format-lines-and-comments.md"},{"slug":"tree-sitter-write-explicit-concrete-tests","title":"Write explicit concrete tests","description":"Tests should be written explicitly with concrete examples and clear assertions rather than being generated programmatically or hidden in utility code. This improves test readability, maintainability, and debugging capabilities.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Testing","language":"Rust","updated":"2024-02-17","comments":3,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-write-explicit-concrete-tests.md"},{"slug":"tokio-memory-ordering-needs-justification","title":"Memory ordering needs justification","description":"When using atomic operations, explicitly justify the choice of memory ordering. Each use of a memory ordering should be documented with a clear explanation of why that specific ordering is sufficient and safe.","repository":"tokio-rs/tokio","domain":"runtimes","topic":"Concurrency","language":"Rust","updated":"2024-02-15","comments":4,"stars":28981,"raw":"https://awesomereviewers.com/raw/tokio-memory-ordering-needs-justification.md"},{"slug":"unstructured-document-credential-formats","title":"Document credential formats","description":"When documenting security-sensitive parameters such as private keys, certificates, API tokens, or other authentication credentials, always specify the expected format including any required headers, footers, and structural elements. This prevents configuration errors that could lead to authentication failures or security vulnerabilities.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"Security","language":"Other","updated":"2024-02-14","comments":1,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-document-credential-formats.md"},{"slug":"waveterm-use-strong-keys","title":"use strong keys","description":"Always use secure cryptographic algorithms and minimum key sizes—even for dummy, test, or helper keys. Avoid generating or shipping 1024-bit RSA keys (they are considered weak). Prefer modern algorithms (ed25519) when supported; otherwise use at least 2048-bit RSA. Mark any ephemeral/dummy keys clearly in code, avoid persisting them, and follow library...","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Security","language":"Go","updated":"2024-02-14","comments":1,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-use-strong-keys.md"},{"slug":"semgrep-use-appropriate-log-levels","title":"Use appropriate log levels","description":"Choose log levels based on the intended audience to prevent user-visible noise. Most logging should use `Logs.debug` rather than `Logs.info` or `Logs.err`, since info-level and above messages are visible to end users with `--verbose` or by default.","repository":"semgrep/semgrep","domain":"security","topic":"Logging","language":"Other","updated":"2024-02-13","comments":4,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-use-appropriate-log-levels.md"},{"slug":"waveterm-prefer-streaming-operations","title":"Prefer streaming operations","description":"Motivation: avoid large, unnecessary memory allocations and excessive decoding or retention of full data sets. For parsing, logs, or history, operate on raw bytes or streams and read only the portion you need. For long-lived state, avoid keeping full large objects in memory—cap, page, or store lightweight references.","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Performance Optimization","language":"TypeScript","updated":"2024-02-09","comments":3,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-prefer-streaming-operations.md"},{"slug":"jan-ensure-proper-event-sequencing","title":"Ensure proper event sequencing","description":"When working with event-driven systems, ensure that events are emitted at the appropriate time and in the correct context to prevent race conditions and incorrect behavior. Consider whether the function's purpose aligns with event emission - single-response functions should not broadcast events meant for streaming contexts. Additionally, be mindful of...","repository":"menloresearch/jan","domain":"llm-infra","topic":"Concurrency","language":"TypeScript","updated":"2024-02-09","comments":2,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-ensure-proper-event-sequencing.md"},{"slug":"checkov-strategic-error-handling","title":"Strategic error handling","description":"Choose appropriate error handling strategies based on the nature of the error and recovery potential: 1. **Raise exceptions only for truly exceptional conditions**:","repository":"bridgecrewio/checkov","domain":"security","topic":"Error Handling","language":"Python","updated":"2024-02-07","comments":5,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-strategic-error-handling.md"},{"slug":"checkov-strategic-exception-management","title":"Strategic exception management","description":"Choose the appropriate error handling strategy based on the context and severity of potential failures. Use exceptions for truly exceptional conditions that represent invalid states or unrecoverable errors, while providing graceful fallbacks for non-critical failures.","repository":"bridgecrewio/checkov","domain":"security","topic":"Error Handling","language":"Python","updated":"2024-02-07","comments":5,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-strategic-exception-management.md"},{"slug":"nest-preserve-api-interface-stability","title":"Preserve API interface stability","description":"When modifying or extending public API interfaces, ensure backward compatibility and proper versioning. Follow these guidelines: 1. Make interface additions optional to avoid breaking changes:","repository":"nestjs/nest","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2024-02-07","comments":5,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-preserve-api-interface-stability.md"},{"slug":"nest-preserve-public-api-stability","title":"Preserve public API stability","description":"When modifying or extending public interfaces, ensure changes maintain backward compatibility and follow proper versioning practices. Key guidelines:","repository":"nestjs/nest","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2024-02-07","comments":5,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-preserve-public-api-stability.md"},{"slug":"waveterm-propagate-errors-clearly","title":"Propagate errors clearly","description":"Always return and propagate errors; surface them to callers and the UI, and clean up resources on error paths. Motivation - Avoid hiding failures by logging only or encoding errors as special string values. Returning errors lets callers decide how to handle, retry, or present failures. Ensure resources (files, network streams, conex) are closed with defer...","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Error Handling","language":"Go","updated":"2024-02-07","comments":4,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-propagate-errors-clearly.md"},{"slug":"waveterm-centralize-sentinel-names","title":"centralize sentinel names","description":"Define and use named constants for special sentinel identifiers (e.g., \"local\", \"connected\") and add semantic methods on domain types near their definitions to encapsulate boolean checks (e.g., RemoteType.IsLocal()). Motivation: magic strings and scattered boolean logic reduce clarity and increase risk of inconsistent checks. Placing constants and small...","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Naming Conventions","language":"Go","updated":"2024-02-07","comments":2,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-centralize-sentinel-names.md"},{"slug":"refact-api-authorization-validation","title":"API authorization validation","description":"All API endpoints must implement proper authorization checks before processing requests, especially when authentication mechanisms like tokens are available. When adding new API routes, verify that appropriate authorization validation is in place to prevent unauthorized access to sensitive functionality.","repository":"smallcloudai/refact","domain":"ai-agents","topic":"Security","language":"Python","updated":"2024-02-07","comments":1,"stars":3114,"raw":"https://awesomereviewers.com/raw/refact-api-authorization-validation.md"},{"slug":"spring-framework-descriptive-specific-names","title":"Descriptive specific names","description":"Choose names that are specific, descriptive, and accurately reflect the purpose and domain of variables, methods, classes, and constants. Avoid overly generic terms that could be ambiguous or conflict with future features.","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Naming Conventions","language":"Java","updated":"2024-02-06","comments":8,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-descriptive-specific-names.md"},{"slug":"unstructured-api-examples-completeness","title":"API examples completeness","description":"Ensure all API code examples include all required parameters with correct placeholder values. Incomplete examples lead to user confusion and implementation errors when developers copy-paste documentation snippets.","repository":"Unstructured-IO/unstructured","domain":"llm-infra","topic":"API","language":"Other","updated":"2024-02-06","comments":3,"stars":12117,"raw":"https://awesomereviewers.com/raw/unstructured-api-examples-completeness.md"},{"slug":"tensorflow-framework-migration-instructions","title":"Framework migration instructions","description":"When documenting AI framework migrations (like TensorFlow/Keras version changes), provide complete instructions covering both installation and code modifications. Include:","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"AI","language":"Markdown","updated":"2024-02-06","comments":2,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-framework-migration-instructions.md"},{"slug":"ui-optimize-documentation-for-usability","title":"Optimize documentation for usability","description":"When creating component documentation, prioritize the developer experience by providing clear, usable examples and configurations. For Storybook components, configure props documentation thoughtfully—rather than removing props like `children` from the table entirely, consider using more specific controls:","repository":"shadcn-ui/ui","domain":"app-frameworks","topic":"Documentation","language":"TSX","updated":"2024-02-06","comments":2,"stars":90568,"raw":"https://awesomereviewers.com/raw/ui-optimize-documentation-for-usability.md"},{"slug":"refact-follow-api-design-conventions","title":"Follow API design conventions","description":"Ensure API endpoints adhere to established design conventions including proper HTTP methods, authorization requirements, and clean route organization. Use GET for data retrieval operations and include appropriate authorization headers for protected endpoints. Avoid creating unnecessary routers when prefixes can be incorporated directly into route...","repository":"smallcloudai/refact","domain":"ai-agents","topic":"API","language":"Python","updated":"2024-02-05","comments":2,"stars":3114,"raw":"https://awesomereviewers.com/raw/refact-follow-api-design-conventions.md"},{"slug":"jan-ai-model-configuration-completeness","title":"AI model configuration completeness","description":"Ensure all necessary AI model parameters are properly configured and passed through the system. AI models require comprehensive configuration including hardware settings (CPU/GPU allocation, thread counts), model-specific parameters (context length, n_gpu_layers), and proper path resolution. Missing configuration can lead to runtime failures, suboptimal...","repository":"menloresearch/jan","domain":"llm-infra","topic":"AI","language":"TypeScript","updated":"2024-02-03","comments":4,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-ai-model-configuration-completeness.md"},{"slug":"jan-use-centralized-logging-framework","title":"Use centralized logging framework","description":"Always use the established logging infrastructure instead of creating custom logging solutions or multiple logging systems. This prevents fragmentation and ensures consistent log management across the codebase.","repository":"menloresearch/jan","domain":"llm-infra","topic":"Logging","language":"TypeScript","updated":"2024-02-03","comments":2,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-use-centralized-logging-framework.md"},{"slug":"prettier-targeted-css-modifications","title":"targeted CSS modifications","description":"Make targeted, purposeful CSS modifications that either enhance visual presentation or fix specific functionality issues without disrupting existing styles. When adding new styles, focus on specific improvements like centering text or adjusting colors. When modifying existing styles, preserve the original intent and make minimal changes to address the...","repository":"prettier/prettier","domain":"devtools","topic":"Code Style","language":"Css","updated":"2024-02-03","comments":2,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-targeted-css-modifications.md"},{"slug":"tensorflow-handle-dynamic-shapes","title":"Handle dynamic shapes","description":"When implementing tensor-based algorithms, avoid assumptions about fixed tensor shapes by not relying on direct shape attributes (`.shape`, `.ndim`), which may return `None` in graph mode. Instead, use TensorFlow operations like `tf.shape()` and `tf.rank()` which work in both eager and graph execution modes. For validation, use TensorFlow's conditional...","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Algorithms","language":"Python","updated":"2024-02-02","comments":5,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-handle-dynamic-shapes.md"},{"slug":"spring-framework-minimize-allocation-hotspots","title":"Minimize allocation hotspots","description":"Reduce object creation in performance-critical paths by carefully evaluating allocation patterns. For frequently instantiated objects, consider caching instances or using static helpers, but always validate improvements with proper benchmarks.","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Performance Optimization","language":"Java","updated":"2024-02-01","comments":11,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-minimize-allocation-hotspots.md"},{"slug":"mermaid-config-schema-defaults","title":"Config schema defaults","description":"When updating configuration schemas, ensure each config option is fully specified and not redundantly redefined. Apply these rules: 1) **Always set `type` and `default` for new properties** so downstream consumers get predictable behavior and the schema remains type-correct.","repository":"mermaid-js/mermaid","domain":"devtools","topic":"Configurations","language":"Yaml","updated":"2024-02-01","comments":3,"stars":87952,"raw":"https://awesomereviewers.com/raw/mermaid-config-schema-defaults.md"},{"slug":"kotlin-names-express-clear-intent","title":"Names express clear intent","description":"Choose names that clearly express intent and follow established conventions. Prefer explicit, descriptive names over abbreviations or ambiguous terms. Align with platform-specific naming patterns and maintain consistency with existing codebase conventions.","repository":"JetBrains/kotlin","domain":"runtimes","topic":"Naming Conventions","language":"Kotlin","updated":"2024-01-31","comments":11,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-names-express-clear-intent.md"},{"slug":"kotlin-design-extensible-stable-apis","title":"Design extensible stable APIs","description":"When designing public APIs, prioritize extensibility while maintaining backward compatibility and implementation hiding. This ensures APIs can evolve without breaking existing clients while allowing for future enhancements.","repository":"JetBrains/kotlin","domain":"runtimes","topic":"API","language":"Kotlin","updated":"2024-01-30","comments":7,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-design-extensible-stable-apis.md"},{"slug":"spring-boot-concrete-bean-return-types","title":"Concrete bean return types","description":"When defining `@Bean` methods in Spring configurations, use concrete return types rather than interfaces while using interface types in `@ConditionalOnMissingBean` annotations. This approach maximizes type information available to the Spring bean factory while maintaining flexibility in bean overriding.","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Spring","language":"Java","updated":"2024-01-27","comments":6,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-concrete-bean-return-types.md"},{"slug":"grafana-use-appropriate-permission-checks","title":"Use appropriate permission checks","description":"When implementing role-based access control (RBAC), ensure you use the correct permission verification method based on the security context. Distinguish between:","repository":"grafana/grafana","domain":"observability","topic":"Security","language":"TSX","updated":"2024-01-19","comments":1,"stars":68825,"raw":"https://awesomereviewers.com/raw/grafana-use-appropriate-permission-checks.md"},{"slug":"db-gpt-docs-accuracy-checks","title":"Docs accuracy checks","description":"When writing documentation in code (comments, docstrings, example snippets), ensure every instruction and external link precisely matches the actual package extras and the implemented service/provider.","repository":"eosphoros-ai/DB-GPT","domain":"ai-agents","topic":"Documentation","language":"Python","updated":"2024-01-18","comments":2,"stars":18703,"raw":"https://awesomereviewers.com/raw/db-gpt-docs-accuracy-checks.md"},{"slug":"compose-use-api-options-pattern","title":"Use API options pattern","description":"Design API methods using options objects instead of multiple parameters. This pattern provides better extensibility, version compatibility, and maintains consistent interfaces across the codebase.","repository":"docker/compose","domain":"orchestration","topic":"API","language":"Go","updated":"2024-01-17","comments":4,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-use-api-options-pattern.md"},{"slug":"sentry-php-propagate-errors-with-context","title":"Propagate errors with context","description":"Always propagate errors appropriately by rethrowing caught exceptions and maintaining error context. Catch exceptions only when you can handle them meaningfully, and ensure errors aren't silently swallowed.","repository":"getsentry/sentry-php","domain":"observability","topic":"Error Handling","language":"PHP","updated":"2024-01-16","comments":5,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-propagate-errors-with-context.md"},{"slug":"logseq-maintain-documentation-consistency","title":"Maintain documentation consistency","description":"When modifying documentation structure or content, ensure all cross-references remain valid and avoid creating inconsistencies between related documents. Before renaming files or restructuring documentation, search for and update all internal links that reference the changed content. When platform-specific documentation exists alongside general guides,...","repository":"logseq/logseq","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2024-01-16","comments":3,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-maintain-documentation-consistency.md"},{"slug":"prisma-document-configuration-decisions","title":"Document configuration decisions","description":"Add explanatory comments to configuration files that clarify the reasoning behind non-obvious choices, feature exclusions, conditional logic, and environment-specific settings. This helps future maintainers understand why certain configurations exist and prevents accidental modifications.","repository":"prisma/prisma","domain":"data-systems","topic":"Configurations","language":"Yaml","updated":"2024-01-15","comments":3,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-document-configuration-decisions.md"},{"slug":"brew-secure-api-url-parsing","title":"Secure API URL parsing","description":"When parsing API endpoint URLs, implement rigorous input validation using precise regular expressions. This includes: - Escaping special characters in domain literals (e.g., `github\\.com`)","repository":"Homebrew/brew","domain":"devtools","topic":"API","language":"Shell","updated":"2024-01-14","comments":3,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-secure-api-url-parsing.md"},{"slug":"query-type-parameter-naming","title":"Type Parameter Naming","description":"Enforce a single, strict naming convention for TypeScript generic type parameters using ESLint, and migrate the rule to `error` after a short “warn” rollout.","repository":"tanstack/query","domain":"app-frameworks","topic":"Naming Conventions","language":"Other","updated":"2024-01-14","comments":2,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-type-parameter-naming.md"},{"slug":"jan-externalize-configuration-values","title":"externalize configuration values","description":"Configuration values, especially sensitive data like API keys and environment-specific settings, should be externalized to environment variables rather than hardcoded in source code. This prevents sensitive information from being permanently stored in git history and enables proper configuration management across different environments.","repository":"menloresearch/jan","domain":"llm-infra","topic":"Configurations","language":"JavaScript","updated":"2024-01-11","comments":2,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-externalize-configuration-values.md"},{"slug":"spring-boot-preserve-api-compatibility","title":"Preserve API compatibility","description":"When evolving APIs, maintain backward compatibility to avoid breaking client code. Consider these guidelines: 1. **Add overloaded methods instead of modifying signatures**: When adding parameters, create a new method rather than changing an existing one.","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"API","language":"Java","updated":"2024-01-10","comments":9,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-preserve-api-compatibility.md"},{"slug":"v-configure-socket-blocking-behavior","title":"Configure socket blocking behavior","description":"Always explicitly configure socket blocking behavior when creating TCP connections, and provide compile-time flags for backwards compatibility when changing default behaviors.","repository":"vlang/v","domain":"runtimes","topic":"Networking","language":"Other","updated":"2024-01-10","comments":4,"stars":36582,"raw":"https://awesomereviewers.com/raw/v-configure-socket-blocking-behavior.md"},{"slug":"prettier-use-example-configuration-files","title":"Use example configuration files","description":"When providing team configuration files that developers might want to customize, use `.example` suffixes and implement automatic copying mechanisms to avoid conflicts with personal settings.","repository":"prettier/prettier","domain":"devtools","topic":"Configurations","language":"Json","updated":"2024-01-08","comments":2,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-use-example-configuration-files.md"},{"slug":"poetry-specify-tool-version-requirements","title":"specify tool version requirements","description":"When documenting CI/CD tools and integrations, always specify exact version requirements and compatibility constraints. This prevents integration failures and ensures reproducible builds across different environments.","repository":"python-poetry/poetry","domain":"devtools","topic":"CI/CD","language":"Markdown","updated":"2024-01-05","comments":2,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-specify-tool-version-requirements.md"},{"slug":"jan-concise-documentation-writing","title":"Concise documentation writing","description":"Write documentation that respects user intelligence by being concise and avoiding over-explanation of obvious concepts. Assume users are \"lazy but smart\" - they don't need explanations like \"A thread title is a title of a thread\" but do need clear directions to find what they need.","repository":"menloresearch/jan","domain":"llm-infra","topic":"Documentation","language":"Markdown","updated":"2023-12-29","comments":3,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-concise-documentation-writing.md"},{"slug":"jan-configuration-structure-clarity","title":"Configuration structure clarity","description":"Ensure configuration parameters are properly structured, accurately documented, and clearly indicate their scope and purpose. Configuration hierarchies should be explicit (global, assistant-level, thread-level), parameter categories should be well-defined (init vs runtime), and documented values must match actual system behavior.","repository":"menloresearch/jan","domain":"llm-infra","topic":"Configurations","language":"Markdown","updated":"2023-12-26","comments":3,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-configuration-structure-clarity.md"},{"slug":"turborepo-use-environment-aware-configurations","title":"Use environment-aware configurations","description":"Configure paths and system references dynamically to ensure they work across all environments (development, testing, production). Avoid hardcoded paths or environment-specific values that will break when code is packaged or deployed.","repository":"vercel/turborepo","domain":"devtools","topic":"Configurations","language":"JavaScript","updated":"2023-12-26","comments":2,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-use-environment-aware-configurations.md"},{"slug":"pr-agent-use-clear-style-helpers","title":"Use Clear Style Helpers","description":"Adopt maintainable, idiomatic Python patterns to improve readability and reduce future change risk. ### 1) Prefer `isinstance()` over `type(...) == ...`","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"Code Style","language":"Python","updated":"2023-12-24","comments":8,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-use-clear-style-helpers.md"},{"slug":"cli-api-response-consistency","title":"API response consistency","description":"Ensure consistent patterns for API response handling, error management, and type safety across all API interactions. This includes standardizing error response structures based on status codes, properly defining response types to match actual API behavior, and implementing robust error handling with appropriate fallbacks.","repository":"snyk/cli","domain":"security","topic":"API","language":"TypeScript","updated":"2023-12-21","comments":7,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-api-response-consistency.md"},{"slug":"sentry-php-use-data-providers-effectively","title":"Use data providers effectively","description":"Organize your test suite by using data providers to consolidate similar test cases rather than creating multiple test methods with duplicated logic. This improves maintainability, increases test coverage, and makes adding new test scenarios easier.","repository":"getsentry/sentry-php","domain":"observability","topic":"Testing","language":"PHP","updated":"2023-12-20","comments":7,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-use-data-providers-effectively.md"},{"slug":"maplibre-native-optimize-compilation-flags","title":"Optimize compilation flags","description":"When optimizing application performance, carefully select compiler flags based on your optimization goals. For size-critical applications or accurate size measurements, use `-Oz` to prevent aggressive inlining that can distort metrics. Additionally, implement compiler caching with tools like `ccache` to significantly improve build times in development and...","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Performance Optimization","language":"Yaml","updated":"2023-12-17","comments":2,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-optimize-compilation-flags.md"},{"slug":"checkov-document-configuration-options","title":"Document configuration options","description":"Always provide comprehensive documentation for all configuration options, including environment variables, feature flags, and version overrides. For each configuration option:","repository":"bridgecrewio/checkov","domain":"security","topic":"Configurations","language":"Markdown","updated":"2023-12-16","comments":5,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-document-configuration-options.md"},{"slug":"waveterm-centralize-configuration-values","title":"centralize configuration values","description":"Keep layout constants, feature flags, and user-configurable settings in centralized configuration modules (not hardcoded in components). Motivation: makes it easy to find and change UI \"magic\" values (e.g., tab width, spacing) and ensures behavior can be toggled per-environment or per-user (e.g., suppressing update banners when users turn off update checks).","repository":"wavetermdev/waveterm","domain":"devtools","topic":"Configurations","language":"TSX","updated":"2023-12-15","comments":2,"stars":17328,"raw":"https://awesomereviewers.com/raw/waveterm-centralize-configuration-values.md"},{"slug":"tensorflow-be-explicit-in-references","title":"Be explicit in references","description":"When writing documentation, always be specific and explicit when referring to files, tools, configurations, or other elements. Vague references create confusion and require readers to make assumptions or search for additional context.","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Documentation","language":"Markdown","updated":"2023-12-14","comments":2,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-be-explicit-in-references.md"},{"slug":"yoga-use-semantic-naming","title":"Use semantic naming","description":"Choose semantic, logical names that describe purpose and intent rather than physical characteristics or implementation details. This improves code maintainability, internationalization support, and clarity.","repository":"facebook/yoga","domain":"runtimes","topic":"Naming Conventions","language":"TypeScript","updated":"2023-12-13","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-use-semantic-naming.md"},{"slug":"yoga-avoid-eval-function","title":"avoid eval() function","description":"The eval() function executes arbitrary JavaScript code from strings, creating significant security vulnerabilities including code injection attacks. This is especially dangerous when processing external data like API responses, user input, or browser logs that could contain malicious code.","repository":"facebook/yoga","domain":"runtimes","topic":"Security","language":"TypeScript","updated":"2023-12-13","comments":1,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-avoid-eval-function.md"},{"slug":"prettier-document-ci-workflow-rationale","title":"Document CI workflow rationale","description":"Always include clear comments explaining the reasoning behind CI workflow decisions, including test environment separation, version matrix choices, and build requirements. This prevents confusion about when different workflows should be used and helps maintain consistency across the team.","repository":"prettier/prettier","domain":"devtools","topic":"CI/CD","language":"Yaml","updated":"2023-12-11","comments":2,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-document-ci-workflow-rationale.md"},{"slug":"checkov-secure-api-endpoints","title":"Secure API endpoints","description":"Always configure proper authorization for API endpoints to prevent unauthorized access to back-end resources. Avoid combinations that create open access, such as using `AuthorizationType.NONE` together with `api_key_required=False` in API Gateway configurations.","repository":"bridgecrewio/checkov","domain":"security","topic":"API","language":"Yaml","updated":"2023-12-10","comments":2,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-secure-api-endpoints.md"},{"slug":"logseq-simplify-code-readability","title":"Simplify code readability","description":"Write code that prioritizes clarity and simplicity over cleverness. Use appropriate Clojure idioms to make code more readable and maintainable. Key practices:","repository":"logseq/logseq","domain":"app-frameworks","topic":"Code Style","language":"Other","updated":"2023-12-07","comments":7,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-simplify-code-readability.md"},{"slug":"db-gpt-use-safe-url-encoding","title":"Use safe URL encoding","description":"When constructing connection strings/URIs that embed user credentials, always URL-encode username/password (and other URI components as needed) using an encoder that safely handles reserved characters. Avoid `urllib.parse.quote` for credentials where characters like `@` and `#` may appear; prefer `quote_plus`.","repository":"eosphoros-ai/DB-GPT","domain":"ai-agents","topic":"Security","language":"Python","updated":"2023-12-07","comments":1,"stars":18703,"raw":"https://awesomereviewers.com/raw/db-gpt-use-safe-url-encoding.md"},{"slug":"istio-verify-logging-configuration-functionality","title":"verify logging configuration functionality","description":"Ensure that logging configuration options actually perform the behavior their names suggest and provide real value. Before implementing or maintaining logging features, verify that they work as advertised and aren't just cosmetic labels.","repository":"istio/istio","domain":"orchestration","topic":"Logging","language":"Other","updated":"2023-12-05","comments":2,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-verify-logging-configuration-functionality.md"},{"slug":"nest-explicit-default-configurations","title":"Explicit default configurations","description":"Always provide explicit default values for configuration options to improve code readability and maintainability. Use helper methods consistently for default value management, and document defaults clearly.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2023-12-04","comments":9,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-explicit-default-configurations.md"},{"slug":"tensorflow-informative-error-messages","title":"Informative error messages","description":"Error messages should be informative, actionable, and concise to help users quickly understand and fix issues. Follow these guidelines: 1. Include specific details in error messages:","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Error Handling","language":"Python","updated":"2023-12-04","comments":5,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-informative-error-messages.md"},{"slug":"compose-safe-collection-modification","title":"Safe collection modification","description":"When modifying collections during iteration, use safe patterns to avoid subtle bugs and undefined behavior. Common unsafe patterns include modifying map values during range iteration, capturing loop variables by reference, and deleting from slices while iterating.","repository":"docker/compose","domain":"orchestration","topic":"Algorithms","language":"Go","updated":"2023-12-04","comments":3,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-safe-collection-modification.md"},{"slug":"jan-externalize-hardcoded-configurations","title":"Externalize hardcoded configurations","description":"Avoid hardcoding configuration values like ports, URLs, API endpoints, and environment-specific settings directly in source code. Instead, externalize these values to environment variables, configuration files, or dependency injection to improve maintainability and deployment flexibility.","repository":"menloresearch/jan","domain":"llm-infra","topic":"Configurations","language":"TypeScript","updated":"2023-12-04","comments":3,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-externalize-hardcoded-configurations.md"},{"slug":"spring-framework-use-documentation-features-properly","title":"Use documentation features properly","description":"Utilize Asciidoc features correctly when writing or updating Spring Framework documentation. Instead of hardcoded links, use defined attributes where available. For example, replace:","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Documentation","language":"Other","updated":"2023-12-04","comments":2,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-use-documentation-features-properly.md"},{"slug":"core-lifecycle-effects-management","title":"Lifecycle effects management","description":"Properly manage component lifecycle effects and cleanup in React components to prevent memory leaks and performance issues. Use appropriate dependency arrays in useEffect hooks, and ensure cleanup functions are implemented for subscriptions, event listeners, and other side effects.","repository":"vuejs/core","domain":"app-frameworks","topic":"React","language":"TypeScript","updated":"2023-12-01","comments":3,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-lifecycle-effects-management.md"},{"slug":"boto3-prevent-algorithmic-pitfalls","title":"Prevent algorithmic pitfalls","description":"Avoid common algorithmic errors that lead to incorrect results or inefficient code by following these practices: 1. **Never modify a collection while iterating over it**","repository":"boto/boto3","domain":"cloud-infra","topic":"Algorithms","language":"Python","updated":"2023-11-29","comments":7,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-prevent-algorithmic-pitfalls.md"},{"slug":"maplibre-native-template-instantiation-trade-offs","title":"Template instantiation trade-offs","description":"When designing algorithms that accept callbacks or function parameters, consider the trade-off between template functions and `std::function`: 1. **Templates generate code** - Each unique lambda passed to a template function creates a new instance of that entire function body, which can significantly increase binary size for large functions.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Algorithms","language":"Other","updated":"2023-11-28","comments":3,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-template-instantiation-trade-offs.md"},{"slug":"go-use-benchmarked-thresholds","title":"Use benchmarked thresholds","description":"Base performance-critical constants, limits, and thresholds on empirical benchmarking rather than arbitrary values. When implementing optimizations that involve numeric parameters—such as buffer size limits, inlining costs, or caching thresholds—conduct systematic benchmarking to determine optimal values and document the rationale.","repository":"golang/go","domain":"runtimes","topic":"Performance Optimization","language":"Go","updated":"2023-11-22","comments":3,"stars":129599,"raw":"https://awesomereviewers.com/raw/go-use-benchmarked-thresholds.md"},{"slug":"checkov-avoid-hardcoded-secrets","title":"Avoid hardcoded secrets","description":"Never include hardcoded secrets or credentials in your infrastructure as code files. Secrets in configuration files pose significant security risks as they may be inadvertently exposed through version control systems or shared repositories.","repository":"bridgecrewio/checkov","domain":"security","topic":"Security","language":"Terraform","updated":"2023-11-21","comments":1,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-avoid-hardcoded-secrets.md"},{"slug":"nest-use-factory-providers","title":"Use factory providers","description":"Prefer `useFactory` over `useValue` for better performance in NestJS dependency injection, especially for large objects or complex configurations. Using `useValue` with large objects can significantly slow down application bootstrapping due to expensive module serialization.","repository":"nestjs/nest","domain":"app-frameworks","topic":"NestJS","language":"TypeScript","updated":"2023-11-17","comments":3,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-use-factory-providers.md"},{"slug":"jan-document-ai-infrastructure-requirements","title":"Document AI infrastructure requirements","description":"When documenting AI applications that run local models or perform inference, always provide comprehensive infrastructure requirements including hardware specifications, platform-specific drivers, and setup instructions. This ensures users can successfully run AI models without encountering compatibility issues.","repository":"menloresearch/jan","domain":"llm-infra","topic":"AI","language":"Markdown","updated":"2023-11-16","comments":4,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-document-ai-infrastructure-requirements.md"},{"slug":"chef-extract-and-organize-methods","title":"Extract and organize methods","description":"Break down large, complex methods into smaller, focused methods with clear names that describe their purpose. This improves code readability, maintainability, and testability.","repository":"chef/chef","domain":"cloud-infra","topic":"Code Style","language":"Ruby","updated":"2023-11-15","comments":8,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-extract-and-organize-methods.md"},{"slug":"tokenizers-return-results-not-panics","title":"Return results not panics","description":"Libraries should never panic as this can crash applications using the library. Always return a `Result` type rather than using functions or methods that can panic (`panic!()`, `unwrap()`, `expect()`, `assert!()`) in public APIs and internal logic. This allows consumers of your library to properly handle error conditions.","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"Error Handling","language":"Rust","updated":"2023-11-14","comments":8,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-return-results-not-panics.md"},{"slug":"maplibre-native-consistent-api-practices","title":"Consistent API practices","description":"Maintain consistency in API design, documentation, and implementation across all supported platforms to improve developer experience and reduce friction.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2023-11-14","comments":6,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-consistent-api-practices.md"},{"slug":"tokenizers-minimize-memory-allocations","title":"Minimize memory allocations","description":"Avoid unnecessary memory allocations to improve performance. Each allocation has both CPU and memory overhead that can accumulate significantly, especially in hot code paths.","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"Performance Optimization","language":"Rust","updated":"2023-11-14","comments":5,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-minimize-memory-allocations.md"},{"slug":"tokenizers-choose-semantically-clear-identifiers","title":"Choose semantically clear identifiers","description":"Select parameter and method names that accurately describe their purpose and behavior, avoiding ambiguous terms that can lead to confusion. Consider these guidelines:","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"Naming Conventions","language":"Rust","updated":"2023-11-14","comments":4,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-choose-semantically-clear-identifiers.md"},{"slug":"jan-consolidate-build-scripts","title":"consolidate build scripts","description":"When creating multiple build variants (debug, publish, etc.), avoid duplicating build commands by reusing the base build script. This reduces maintenance overhead, ensures consistency across build targets, and shortens complex build commands.","repository":"menloresearch/jan","domain":"llm-infra","topic":"CI/CD","language":"Json","updated":"2023-11-14","comments":2,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-consolidate-build-scripts.md"},{"slug":"prettier-add-explanatory-comments","title":"Add explanatory comments","description":"Add explanatory comments for complex logic, special cases, or non-obvious code behavior. Comments should explain the \"why\" behind the code and \"what\" specific conditions or syntax patterns are being handled.","repository":"prettier/prettier","domain":"devtools","topic":"Documentation","language":"JavaScript","updated":"2023-11-10","comments":5,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-add-explanatory-comments.md"},{"slug":"frp-organize-code-logically","title":"Organize code logically","description":"Maintain a clean and logical code structure by properly organizing code according to its functionality and purpose: 1. Group related functionality into dedicated packages based on domain logic (e.g., `pkg/ssh` for SSH-related code)","repository":"fatedier/frp","domain":"cloud-infra","topic":"Code Style","language":"Go","updated":"2023-11-09","comments":6,"stars":95938,"raw":"https://awesomereviewers.com/raw/frp-organize-code-logically.md"},{"slug":"sentry-php-balance-ci-test-coverage","title":"Balance CI test coverage","description":"Configure CI workflows to optimize both comprehensive testing and resource usage. For resource-intensive tests that may cause issues (like OOM errors with code coverage), split test suites and run coverage selectively:","repository":"getsentry/sentry-php","domain":"observability","topic":"CI/CD","language":"Yaml","updated":"2023-11-08","comments":4,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-balance-ci-test-coverage.md"},{"slug":"semgrep-justify-error-handling-design","title":"justify error handling design","description":"When implementing error handling mechanisms, ensure that design decisions are well-justified and properly reasoned. This applies to both architectural choices (like global state for error correlation) and technical analysis (like exception flow paths).","repository":"semgrep/semgrep","domain":"security","topic":"Error Handling","language":"Python","updated":"2023-11-08","comments":2,"stars":12598,"raw":"https://awesomereviewers.com/raw/semgrep-justify-error-handling-design.md"},{"slug":"ui-leverage-framework-defaults","title":"Leverage framework defaults","description":"Avoid redundant or unnecessary configuration by understanding and utilizing default behaviors provided by frameworks and tools. Remove explicit configuration when the underlying framework already handles it automatically, which reduces maintenance overhead and prevents configuration drift.","repository":"shadcn-ui/ui","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2023-11-03","comments":3,"stars":90568,"raw":"https://awesomereviewers.com/raw/ui-leverage-framework-defaults.md"},{"slug":"checkov-precise-configuration-validation","title":"Precise configuration validation","description":"Ensure configuration validation logic accurately reflects security intentions and best practices. When writing validation checks: 1. Use precise operators that directly verify the intended state:","repository":"bridgecrewio/checkov","domain":"security","topic":"Configurations","language":"Yaml","updated":"2023-11-02","comments":4,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-precise-configuration-validation.md"},{"slug":"react-native-organize-tests-clearly","title":"organize tests clearly","description":"Structure tests with clear organization, focused scope, and minimal duplication to improve maintainability and debugging. Each test should have a single, well-defined purpose that correlates directly to its name. Group related tests using describe blocks and extract common setup code to reduce duplication.","repository":"facebook/react-native","domain":"app-frameworks","topic":"Testing","language":"JavaScript","updated":"2023-11-02","comments":4,"stars":123178,"raw":"https://awesomereviewers.com/raw/react-native-organize-tests-clearly.md"},{"slug":"checkov-comprehensive-security-scanning","title":"Comprehensive security scanning","description":"Always configure security scanning tools with comprehensive coverage and readable output to maximize vulnerability detection. This includes: 1. **Enable scanning across all files**: Use flags like `--enable-secret-scan-all-files` to ensure no potential vulnerability is missed.","repository":"bridgecrewio/checkov","domain":"security","topic":"Security","language":"Yaml","updated":"2023-11-02","comments":3,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-comprehensive-security-scanning.md"},{"slug":"jan-leverage-existing-solutions","title":"leverage existing solutions","description":"Avoid duplicating functionality by leveraging existing libraries and creating reusable components. Instead of redefining common utilities or creating similar components for each use case, use established libraries and build generic, reusable components that can be configured for different scenarios.","repository":"menloresearch/jan","domain":"llm-infra","topic":"Code Style","language":"TSX","updated":"2023-11-02","comments":2,"stars":37620,"raw":"https://awesomereviewers.com/raw/jan-leverage-existing-solutions.md"},{"slug":"frp-non-root-container-users","title":"Non-root container users","description":"Always run containers with a non-root user to reduce the security attack surface. Modern Docker allows non-root users to bind to privileged ports (80, 443), eliminating a common reason for using root. Create a dedicated user and group in your Dockerfile and ensure your application runs with that user's privileges.","repository":"fatedier/frp","domain":"cloud-infra","topic":"Security","language":"Dockerfile","updated":"2023-10-31","comments":1,"stars":95938,"raw":"https://awesomereviewers.com/raw/frp-non-root-container-users.md"},{"slug":"alacritty-consistent-naming-conventions","title":"Consistent naming conventions","description":"Maintain consistent naming patterns and capitalization throughout the codebase, especially for configuration options, string values, and identifiers. This includes using consistent capitalization for similar values (e.g., \"None\" instead of mixing \"none\" and \"None\"), adopting uniform naming patterns for related options (e.g., using \"duration\" consistently...","repository":"alacritty/alacritty","domain":"devtools","topic":"Naming Conventions","language":"Other","updated":"2023-10-30","comments":3,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-consistent-naming-conventions.md"},{"slug":"chef-memoize-expensive-operations","title":"Memoize expensive operations","description":"Cache results of expensive operations, especially shell commands and external queries, to avoid redundant executions. Use Ruby's idiomatic memoization pattern with blocks for clarity and efficiency. Only fetch data when needed, and structure code to optimize for the most common execution paths.","repository":"chef/chef","domain":"cloud-infra","topic":"Performance Optimization","language":"Ruby","updated":"2023-10-27","comments":6,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-memoize-expensive-operations.md"},{"slug":"kubeflow-go-export-naming-conventions","title":"Go export naming conventions","description":"In Go, the first letter of an identifier (function, variable, struct field, etc.) determines its visibility outside the package: 1. **Uppercase first letter**: The identifier is exported and accessible from other packages","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Naming Conventions","language":"Go","updated":"2023-10-26","comments":7,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-go-export-naming-conventions.md"},{"slug":"kubeflow-externalize-configuration-parameters","title":"Externalize configuration parameters","description":"Create configurations that can be easily managed outside your application code. Design configuration parameters to be externalized through appropriate mechanisms like environment variables, config files, or Kubernetes custom resources (CRs). This improves manageability, enables GitOps workflows, and supports different deployment environments.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Configurations","language":"Markdown","updated":"2023-10-26","comments":4,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-externalize-configuration-parameters.md"},{"slug":"chef-secure-network-operations","title":"Secure network operations","description":"When performing network operations, prioritize security and configurability to ensure robustness across different environments. This includes: 1. **Use explicit command patterns**: When executing shell commands that involve network operations, avoid string interpolation and use argument arrays instead to prevent command injection vulnerabilities.","repository":"chef/chef","domain":"cloud-infra","topic":"Networking","language":"Ruby","updated":"2023-10-25","comments":4,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-secure-network-operations.md"},{"slug":"sentry-php-secure-dependency-constraints","title":"Secure dependency constraints","description":"When specifying dependency version constraints, always include lower version bounds that exclude versions with known security vulnerabilities. For dependencies used directly in your code (not just transient dependencies), you have a responsibility to prevent users from inadvertently installing vulnerable versions, as this makes your own package vulnerable.","repository":"getsentry/sentry-php","domain":"observability","topic":"Security","language":"Json","updated":"2023-10-25","comments":1,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-secure-dependency-constraints.md"},{"slug":"free-programming-books-simplify-ci-scripting","title":"Simplify CI scripting","description":"Keep CI/CD workflow steps readable and maintainable by consolidating repeated commands and using basic shell utilities for log processing. Apply these rules:","repository":"EbookFoundation/free-programming-books","domain":"docs","topic":"CI/CD","language":"Yaml","updated":"2023-10-21","comments":3,"stars":388003,"raw":"https://awesomereviewers.com/raw/free-programming-books-simplify-ci-scripting.md"},{"slug":"free-programming-books-least-privilege-actions-tokens","title":"Least-privilege Actions tokens","description":"Treat CI workflow tokens as sensitive credentials: configure GitHub Actions `permissions` explicitly and keep token usage minimal. Apply this standard when workflows need to create PR comments/reviews:","repository":"EbookFoundation/free-programming-books","domain":"docs","topic":"Security","language":"Yaml","updated":"2023-10-21","comments":2,"stars":388003,"raw":"https://awesomereviewers.com/raw/free-programming-books-least-privilege-actions-tokens.md"},{"slug":"checkov-backward-compatible-parameters","title":"Backward compatible parameters","description":"When evolving API function signatures, maintain backward compatibility by making new parameters optional with sensible defaults. This allows existing code to continue working while supporting new functionality. When modifying parameters, carefully consider the complete data structure being passed, especially for collections and complex objects.","repository":"bridgecrewio/checkov","domain":"security","topic":"API","language":"Python","updated":"2023-10-20","comments":3,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-backward-compatible-parameters.md"},{"slug":"checkov-validate-configurations-correctly","title":"Validate configurations correctly","description":"When writing validation logic for configurations, ensure you're using the appropriate operators that correctly test for the intended state. Incorrect validation operators can lead to false results and security vulnerabilities.","repository":"bridgecrewio/checkov","domain":"security","topic":"Configurations","language":"Yaml","updated":"2023-10-16","comments":3,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-validate-configurations-correctly.md"},{"slug":"kubeflow-centralize-dependency-configurations","title":"Centralize dependency configurations","description":"When adding or updating package dependencies, place them in centralized configuration files rather than duplicating them across multiple services. Keep dependencies up-to-date with the latest stable versions and replace deprecated packages with their recommended successors. Always verify backward compatibility when upgrading dependency versions.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Configurations","language":"Txt","updated":"2023-10-16","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-centralize-dependency-configurations.md"},{"slug":"yoga-prevent-off-by-one-errors","title":"prevent off-by-one errors","description":"When implementing algorithms that involve spacing, gaps, or iterative calculations, carefully verify loop bounds and edge cases to prevent off-by-one errors. These errors commonly occur when calculating spacing between N items (which requires N-1 gaps, not N gaps) or when applying operations to boundary elements.","repository":"facebook/yoga","domain":"runtimes","topic":"Algorithms","language":"C++","updated":"2023-10-14","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-prevent-off-by-one-errors.md"},{"slug":"cli-validate-security-configurations","title":"Validate security configurations","description":"Always validate security-related configurations and implementations to ensure they follow established security best practices. This includes verifying authentication token formats, communication protocols, and error handling mechanisms.","repository":"snyk/cli","domain":"security","topic":"Security","language":"TypeScript","updated":"2023-10-10","comments":3,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-validate-security-configurations.md"},{"slug":"alacritty-assess-security-trade-offs","title":"Assess security trade-offs","description":"When introducing dependencies or features that have security implications, explicitly evaluate whether the benefits justify the potential risks. Prefer safer alternatives when available, and clearly document security considerations.","repository":"alacritty/alacritty","domain":"devtools","topic":"Security","language":"Other","updated":"2023-10-08","comments":2,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-assess-security-trade-offs.md"},{"slug":"azure-sentinel-timeout-aware-chunking","title":"Timeout-Aware Chunking","description":"For any long-running ingestion/connectors, optimize for throughput while preventing timeout failures. Implement (1) near-timeout early exit and (2) realistic, configurable chunk/batch sizing.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Performance Optimization","language":"Python","updated":"2023-10-06","comments":2,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-timeout-aware-chunking.md"},{"slug":"cli-optimize-variable-declarations","title":"Optimize variable declarations","description":"Declare variables close to their usage point and choose appropriate types to improve code readability and reduce cognitive load. Avoid declaring variables at the top of functions when they're only used once later in the code. Remove unused variables and imports to keep the codebase clean.","repository":"snyk/cli","domain":"security","topic":"Code Style","language":"Go","updated":"2023-10-05","comments":4,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-optimize-variable-declarations.md"},{"slug":"cli-use-descriptive-identifier-names","title":"Use descriptive identifier names","description":"Choose specific, descriptive names for variables, functions, types, and parameters that clearly indicate their purpose and avoid generic terms that could be overloaded or ambiguous. Generic names like `Command`, `Config`, or `Data` can become confusing when multiple similar concepts exist in the same codebase.","repository":"snyk/cli","domain":"security","topic":"Naming Conventions","language":"Go","updated":"2023-10-05","comments":2,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-use-descriptive-identifier-names.md"},{"slug":"chef-keep-actions-versions-current","title":"Keep actions versions current","description":"Always use the latest stable versions of GitHub Actions components in CI/CD workflows to avoid deprecated features, security vulnerabilities, and compatibility issues. This includes:","repository":"chef/chef","domain":"cloud-infra","topic":"CI/CD","language":"Yaml","updated":"2023-10-04","comments":6,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-keep-actions-versions-current.md"},{"slug":"alacritty-unsafe-code-practices","title":"unsafe code practices","description":"Ensure proper use and documentation of unsafe code to prevent security vulnerabilities. The `unsafe` keyword should only be used for operations that can violate memory safety contracts, not for general thread safety or global state concerns. All unsafe functions must include comprehensive safety documentation explaining the contracts that callers must...","repository":"alacritty/alacritty","domain":"devtools","topic":"Security","language":"Rust","updated":"2023-10-03","comments":2,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-unsafe-code-practices.md"},{"slug":"tokenizers-manage-version-constraints","title":"Manage version constraints","description":"When configuring dependency version constraints in project files, follow these principles: 1. Be explicit about version ranges to balance flexibility with stability:","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"Configurations","language":"Toml","updated":"2023-10-02","comments":3,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-manage-version-constraints.md"},{"slug":"chef-document-configuration-completely","title":"Document configuration completely","description":"Always provide complete documentation for configuration options, including defaults, override methods, and security implications. When documenting configuration:","repository":"chef/chef","domain":"cloud-infra","topic":"Configurations","language":"Markdown","updated":"2023-09-27","comments":4,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-document-configuration-completely.md"},{"slug":"checkov-avoid-wildcard-permissions","title":"Avoid wildcard permissions","description":"Implement the principle of least privilege by avoiding wildcard permissions (e.g., '*') in access control policies. Always specify only the exact permissions required for a resource or action. When analyzing existing policies with wildcards, use tools that expand wildcards into specific permissions to understand the full security implications.","repository":"bridgecrewio/checkov","domain":"security","topic":"Security","language":"Markdown","updated":"2023-09-25","comments":1,"stars":7667,"raw":"https://awesomereviewers.com/raw/checkov-avoid-wildcard-permissions.md"},{"slug":"checkov-expand-iam-wildcards","title":"Expand IAM wildcards","description":"Always expand IAM wildcard permissions (`*`) to specific actions for thorough security analysis. Wildcard permissions can unintentionally grant excessive access, creating security vulnerabilities.","repository":"bridgecrewio/checkov","domain":"security","topic":"Security","language":"Markdown","updated":"2023-09-25","comments":1,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-expand-iam-wildcards.md"},{"slug":"query-silence-unused-query-updates","title":"Silence Unused Query Updates","description":"To optimize performance, prevent components from re-rendering when they don’t need to react to query updates. **Rule:** If you use `useQuery`/`useFocusEffect` for *prefetching* or *side effects* and intentionally *ignore the result*, disable change notifications so the hook doesn’t subscribe to updates that would trigger re-renders.","repository":"tanstack/query","domain":"app-frameworks","topic":"Performance Optimization","language":"Markdown","updated":"2023-09-20","comments":2,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-silence-unused-query-updates.md"},{"slug":"pr-agent-store-tokens-in-secrets","title":"Store Tokens in Secrets","description":"Do not commit authentication credentials (e.g., GitHub personal access tokens, API keys, passwords) in versioned configuration files. Keep them in a dedicated secrets source such as `.secrets.toml` (or your secret manager), and ensure the committed config only contains placeholders/defaults.","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"Security","language":"Toml","updated":"2023-09-20","comments":1,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-store-tokens-in-secrets.md"},{"slug":"prettier-verify-optional-chaining-necessity","title":"Verify optional chaining necessity","description":"Analyze whether optional chaining (`?.`) is actually needed based on the surrounding context and prior validations. Remove optional chaining when values are already confirmed to be truthy through previous checks, but add it when there's genuine risk of null/undefined access.","repository":"prettier/prettier","domain":"devtools","topic":"Null Handling","language":"JavaScript","updated":"2023-09-18","comments":6,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-verify-optional-chaining-necessity.md"},{"slug":"ncnn-stable-public-api-surface","title":"Stable Public API Surface","description":"When modifying or adding exported interfaces in public headers, ensure the external API surface is stable, easy to use across platforms/languages, and does not leak internal implementation details.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"API","language":"Other","updated":"2023-09-18","comments":5,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-stable-public-api-surface.md"},{"slug":"kong-no-blanket-vulnerability-ignores","title":"No Blanket Vulnerability Ignores","description":"Security scanner ignore files must not use broad “blanket” suppression that can hide future real issues. **Standard** - Avoid rules that ignore by coarse attributes (e.g., `fix-state: unknown`) for wide sets of findings.","repository":"Kong/kong","domain":"cloud-infra","topic":"Security","language":"Yaml","updated":"2023-09-18","comments":1,"stars":43871,"raw":"https://awesomereviewers.com/raw/kong-no-blanket-vulnerability-ignores.md"},{"slug":"ncnn-inference-compatibility-rules","title":"Inference Compatibility Rules","description":"Ensure layer math, parameter semantics, and model conversion/backends remain consistent so inference results don’t silently change. Apply these rules:","repository":"Tencent/ncnn","domain":"ml-systems","topic":"AI","language":"C++","updated":"2023-09-14","comments":5,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-inference-compatibility-rules.md"},{"slug":"deno-enhance-error-message-clarity","title":"Enhance error message clarity","description":"Error messages should be both specific about what went wrong and provide contextual information to help developers locate and fix the issue. Even in performance-critical or low-level APIs, basic validation with clear error messages is essential because \"there's no easy way for the developer to get feedback on failures\" otherwise.","repository":"denoland/deno","domain":"runtimes","topic":"Error Handling","language":"JavaScript","updated":"2023-09-14","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-enhance-error-message-clarity.md"},{"slug":"cli-use-descriptive-parameter-names","title":"Use descriptive parameter names","description":"Parameter names should clearly indicate their purpose and avoid ambiguity or conflicts with existing constructs in the codebase context. Names should be self-explanatory without requiring additional comments or context to understand their function.","repository":"snyk/cli","domain":"security","topic":"Naming Conventions","language":"Yaml","updated":"2023-09-13","comments":2,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-use-descriptive-parameter-names.md"},{"slug":"kotlin-consider-operation-time-complexity","title":"Consider operation time complexity","description":"When implementing operations that manipulate collections or perform repeated actions, carefully consider the time complexity implications. Avoid operations that could result in unexpected quadratic or worse complexity. Pay special attention to:","repository":"JetBrains/kotlin","domain":"runtimes","topic":"Algorithms","language":"Kotlin","updated":"2023-09-12","comments":5,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-consider-operation-time-complexity.md"},{"slug":"maplibre-native-buffer-bounds-validation","title":"Buffer bounds validation","description":"Always validate buffer boundaries before performing memory operations to prevent buffer overflow vulnerabilities. When copying data into a buffer at a specified offset, verify that the combination of size and offset doesn't exceed the buffer's allocated capacity.","repository":"maplibre/maplibre-native","domain":"app-frameworks","topic":"Security","language":"C++","updated":"2023-09-12","comments":1,"stars":1411,"raw":"https://awesomereviewers.com/raw/maplibre-native-buffer-bounds-validation.md"},{"slug":"kubeflow-environment-aware-configuration-design","title":"Environment-aware configuration design","description":"Design configurations that work consistently across different environments without requiring environment-specific modifications. Configurations should be parameterized and adaptable to various deployment contexts (development, production, air-gapped environments).","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Configurations","language":"Yaml","updated":"2023-09-06","comments":3,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-environment-aware-configuration-design.md"},{"slug":"compose-evaluate-dependency-api-compatibility","title":"evaluate dependency API compatibility","description":"Before adding or updating dependencies, thoroughly evaluate API compatibility and understand the implications of using forks versus upstream versions. This prevents recurring dependency issues and ensures long-term maintainability.","repository":"docker/compose","domain":"orchestration","topic":"API","language":"Other","updated":"2023-09-06","comments":2,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-evaluate-dependency-api-compatibility.md"},{"slug":"spring-framework-database-agnostic-sql-syntax","title":"Database-agnostic SQL syntax","description":"Write SQL statements that conform to standard SQL rather than relying on vendor-specific dialects to ensure portability across different database systems.","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Database","language":"Java","updated":"2023-09-04","comments":3,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-database-agnostic-sql-syntax.md"},{"slug":"electron-strip-event-parameters","title":"strip event parameters","description":"When exposing IPC event handlers through contextBridge in Electron applications, always strip the event parameter before calling renderer callbacks to prevent security vulnerabilities. The event object contains `event.sender` which can be exploited by malicious code in the renderer process to send arbitrary IPC messages, leading to privilege escalation.","repository":"electron/electron","domain":"devtools","topic":"Security","language":"JavaScript","updated":"2023-08-28","comments":1,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-strip-event-parameters.md"},{"slug":"comfyui-centralize-configuration-constants","title":"centralize configuration constants","description":"Configuration values, constants, and default settings should be defined in a single location and referenced from there, rather than duplicated across multiple files or functions. This prevents inconsistencies, reduces maintenance burden, and ensures that changes to configuration values only need to be made in one place.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Configurations","language":"JavaScript","updated":"2023-08-27","comments":2,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-centralize-configuration-constants.md"},{"slug":"ink-optimize-iteration-patterns","title":"optimize iteration patterns","description":"When implementing loops and iteration logic, evaluate whether your current approach is the most efficient and readable option available. Look for opportunities to simplify complex iteration patterns and eliminate unnecessary loops.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"Algorithms","language":"TypeScript","updated":"2023-08-25","comments":2,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-optimize-iteration-patterns.md"},{"slug":"tensorflow-use-modern-assertions","title":"Use modern assertions","description":"Always use current assertion methods in test code to ensure clarity and future compatibility. Specifically, replace deprecated methods with their modern equivalents, such as using `assertRaisesRegex` instead of `assertRaisesRegexp` when validating exceptions. This approach allows you to verify both the exception type and the specific error message content...","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Testing","language":"Python","updated":"2023-08-25","comments":2,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-use-modern-assertions.md"},{"slug":"checkov-configure-security-scanners-completely","title":"Configure security scanners completely","description":"Security scanning tools must be fully configured to maximize detection capabilities. When implementing tools like Checkov in CI/CD pipelines: 1. For Docker-based scanners, use the `--tty` flag for better output handling:","repository":"bridgecrewio/checkov","domain":"security","topic":"Security","language":"Yaml","updated":"2023-08-24","comments":2,"stars":7668,"raw":"https://awesomereviewers.com/raw/checkov-configure-security-scanners-completely.md"},{"slug":"pr-agent-safe-optional-api-contracts","title":"Safe, Optional API Contracts","description":"When designing API responses and client-triggered actions, keep contracts accurate and defaults safe: 1) Make optional data optional in response schemas","repository":"the-pr-agent/pr-agent","domain":"ai-agents","topic":"API","language":"Toml","updated":"2023-08-22","comments":2,"stars":12523,"raw":"https://awesomereviewers.com/raw/pr-agent-safe-optional-api-contracts.md"},{"slug":"ncnn-semantic-collision-safe-naming","title":"Semantic Collision-Safe Naming","description":"All identifiers should be (1) semantically clear, (2) consistent with project naming patterns, and (3) collision-safe. Apply this checklist: - Prefer clear, domain-meaningful names for configuration fields (avoid ambiguous terms like `resize_type` when the concept is “mode/sample_type”).","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Naming Conventions","language":"Other","updated":"2023-08-16","comments":5,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-semantic-collision-safe-naming.md"},{"slug":"nest-pin-dependency-versions","title":"Pin dependency versions","description":"Explicitly pin or constrain dependency versions in CI/CD configurations instead of using `latest` tags. This prevents unexpected build failures when new incompatible versions are released. Consider using parameterized versions to centralize version management while maintaining stability.","repository":"nestjs/nest","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2023-08-14","comments":4,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-pin-dependency-versions.md"},{"slug":"nest-parameterize-version-requirements","title":"Parameterize version requirements","description":"Always parameterize tool and runtime versions in CI/CD configurations rather than hardcoding them. This makes your pipelines more maintainable when dependencies need updates and provides a single source of truth for version requirements.","repository":"nestjs/nest","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2023-08-14","comments":3,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-parameterize-version-requirements.md"},{"slug":"cli-verify-downloaded-file-integrity","title":"verify downloaded file integrity","description":"Always verify the integrity of downloaded files before using them, especially in security-sensitive applications. At minimum, validate downloaded files using checksums (SHA256, etc.) provided by the source. For higher security requirements, implement cryptographic signature verification using GPG keys.","repository":"snyk/cli","domain":"security","topic":"Security","language":"Python","updated":"2023-08-11","comments":2,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-verify-downloaded-file-integrity.md"},{"slug":"compose-pin-build-dependency-versions","title":"Pin build dependency versions","description":"Always pin specific versions for build dependencies and tools to prevent unexpected build failures, even when the dependency won't be shipped in the final product. While rolling tags may be convenient, explicit version pinning provides build reproducibility and prevents surprises from automatic updates.","repository":"docker/compose","domain":"orchestration","topic":"Configurations","language":"Dockerfile","updated":"2023-08-10","comments":3,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-pin-build-dependency-versions.md"},{"slug":"cli-separate-build-from-runtime","title":"separate build from runtime","description":"Dependencies and build requirements should be installed during Docker image creation or environment setup, not in runtime execution scripts. This separation improves pipeline reliability, reduces execution time, and maintains clear boundaries between build and deployment phases.","repository":"snyk/cli","domain":"security","topic":"CI/CD","language":"Shell","updated":"2023-08-06","comments":2,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-separate-build-from-runtime.md"},{"slug":"continue-smart-model-selection","title":"Smart model selection","description":"Implement intelligent model selection mechanisms that adapt to different scenarios instead of hardcoding specific AI models. Create abstraction layers that can:","repository":"continuedev/continue","domain":"ai-agents","topic":"AI","language":"Python","updated":"2023-07-31","comments":3,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-smart-model-selection.md"},{"slug":"sentry-php-explicit-null-handling","title":"Explicit null handling","description":"Always be explicit and consistent when handling null values to improve code clarity and prevent subtle bugs. This applies to null checks, nullable type declarations, and function parameters.","repository":"getsentry/sentry-php","domain":"observability","topic":"Null Handling","language":"PHP","updated":"2023-07-29","comments":6,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-explicit-null-handling.md"},{"slug":"continue-user-friendly-configuration-retrieval","title":"User-friendly configuration retrieval","description":"When retrieving configuration values like API keys or environment variables, include helpful error messages that guide users on how to fix missing configurations. Consider centralizing configuration retrieval logic in the appropriate classes based on their usage patterns.","repository":"continuedev/continue","domain":"ai-agents","topic":"Configurations","language":"Python","updated":"2023-07-29","comments":2,"stars":27819,"raw":"https://awesomereviewers.com/raw/continue-user-friendly-configuration-retrieval.md"},{"slug":"neovim-optimize-data-structure-operations","title":"optimize data structure operations","description":"When working with data structures, prioritize efficiency through proper memory management and compact data representation. Use appropriate conversion patterns that handle memory cleanup correctly, and leverage bit manipulation techniques for space-efficient data storage.","repository":"neovim/neovim","domain":"devtools","topic":"Algorithms","language":"C","updated":"2023-07-29","comments":2,"stars":91433,"raw":"https://awesomereviewers.com/raw/neovim-optimize-data-structure-operations.md"},{"slug":"deeplearning4j-remove-debugging-artifacts","title":"Remove debugging artifacts","description":"Production code should be free from debugging artifacts that reduce readability and maintainability. Remove all debugging print statements, commented-out code blocks, and other temporary debugging elements before merging code.","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Code Style","language":"C++","updated":"2023-07-26","comments":9,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-remove-debugging-artifacts.md"},{"slug":"octokit.net-document-public-api-elements","title":"Document public API elements","description":"Every public API element (classes, methods, properties, constructors) must have XML documentation comments that clearly describe its purpose and usage. This improves developer experience through IntelliSense and ensures the API is well-documented.","repository":"octokit/octokit.net","domain":"devtools","topic":"Documentation","language":"C#","updated":"2023-07-24","comments":8,"stars":2793,"raw":"https://awesomereviewers.com/raw/octokit.net-document-public-api-elements.md"},{"slug":"tree-sitter-respect-environment-overrides","title":"Respect environment overrides","description":"Build systems and configuration scripts must respect standard environment variables and provide proper override mechanisms. This ensures flexibility for users with different build environments, cross-compilation needs, and custom toolchain requirements.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Configurations","language":"Other","updated":"2023-07-20","comments":4,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-respect-environment-overrides.md"},{"slug":"tensorflow-document-non-obvious-code","title":"Document non-obvious code","description":"Add clarifying comments to improve code readability and maintainability when code behavior isn''t immediately obvious. Two key practices to follow: 1. **Label non-obvious function arguments** with the `/*arg=*/` prefix to clarify their purpose. This is especially important for boolean flags, magic numbers, or default values where the meaning isn''t...","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Documentation","language":"Other","updated":"2023-07-19","comments":2,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-document-non-obvious-code.md"},{"slug":"tensorflow-validate-tensor-inputs-safely","title":"Validate tensor inputs safely","description":"When handling tensor inputs that may contain invalid values, use transformational approaches rather than conditional checks. Conditional checks like `if value < 0:` may work with scalar values but fail with tensor objects during graph execution.","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Null Handling","language":"Python","updated":"2023-07-17","comments":3,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-validate-tensor-inputs-safely.md"},{"slug":"esbuild-follow-configuration-conventions","title":"Follow configuration conventions","description":"When working with configurations, maintain consistency by following established conventions and proper categorization. This includes using naming patterns that match related tools/frameworks and organizing configuration entries in appropriate sections based on actual capabilities.","repository":"evanw/esbuild","domain":"devtools","topic":"Configurations","language":"TypeScript","updated":"2023-07-13","comments":2,"stars":39161,"raw":"https://awesomereviewers.com/raw/esbuild-follow-configuration-conventions.md"},{"slug":"core-log-complete-error-objects","title":"log complete error objects","description":"Always log complete error objects rather than just error messages to preserve stack traces, error codes, and debugging context. Use the application's logger instead of hardcoded console statements in modules.","repository":"adonisjs/core","domain":"app-frameworks","topic":"Logging","language":"TypeScript","updated":"2023-07-06","comments":4,"stars":18071,"raw":"https://awesomereviewers.com/raw/core-log-complete-error-objects.md"},{"slug":"redis-deterministic-control-plane-protocols","title":"Deterministic Control-Plane Protocols","description":"When multiple agents participate in cluster control-plane updates (e.g., TD, FC, nodes), treat the protocol as an algorithm and make its conflict-resolution and time/progression semantics explicit in the spec/code review contract.","repository":"redis/redis","domain":"data-systems","topic":"Algorithms","language":"Markdown","updated":"2023-07-06","comments":4,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-deterministic-control-plane-protocols.md"},{"slug":"ncnn-canonical-naming-and-typos","title":"Canonical Naming and Typos","description":"Use canonical, consistently formatted identifiers across code and build files, and verify every variable/option name is spelled exactly as the build system expects.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Naming Conventions","language":"Txt","updated":"2023-07-06","comments":3,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-canonical-naming-and-typos.md"},{"slug":"ui-consistent-import-paths","title":"Consistent import paths","description":"Establish and follow consistent import path conventions throughout the codebase. Prefer aliased imports using the project's path aliases (e.g., `@/src/utils/get-initial-values`) over relative imports to ensure consistency and improve maintainability. This practice creates uniform import statements across files regardless of their location in the project...","repository":"shadcn-ui/ui","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2023-07-05","comments":2,"stars":90568,"raw":"https://awesomereviewers.com/raw/ui-consistent-import-paths.md"},{"slug":"sonic-function-documentation-standards","title":"Function documentation standards","description":"Function documentation comments must follow Go conventions by starting with the function name, and all parameters should have clear explanations of their purpose and current functionality.","repository":"bytedance/sonic","domain":"runtimes","topic":"Documentation","language":"Go","updated":"2023-07-02","comments":2,"stars":8532,"raw":"https://awesomereviewers.com/raw/sonic-function-documentation-standards.md"},{"slug":"core-explicit-nullish-checks","title":"Explicit nullish checks","description":"When checking for the absence of values, use explicit nullish checks rather than relying on JavaScript's falsy behavior. This prevents issues with valid falsy values like empty strings, zero, or false being treated as non-existent.","repository":"vuejs/core","domain":"app-frameworks","topic":"Null Handling","language":"TypeScript","updated":"2023-06-28","comments":5,"stars":50769,"raw":"https://awesomereviewers.com/raw/core-explicit-nullish-checks.md"},{"slug":"sonic-validate-memory-bounds","title":"validate memory bounds","description":"Always validate array and string bounds before accessing memory to prevent out-of-bounds access and potential crashes. When working with strings or arrays, especially those with known length information, check indices against the actual length before dereferencing pointers.","repository":"bytedance/sonic","domain":"runtimes","topic":"Null Handling","language":"C","updated":"2023-06-27","comments":7,"stars":8532,"raw":"https://awesomereviewers.com/raw/sonic-validate-memory-bounds.md"},{"slug":"sonic-consistent-semantic-naming","title":"Consistent semantic naming","description":"Maintain consistent naming conventions throughout the codebase and use semantically clear identifiers that clearly indicate their purpose and behavior. All functions, variables, and other identifiers should follow the same naming style (preferably snake_case for C code) and have descriptive names that make their functionality obvious.","repository":"bytedance/sonic","domain":"runtimes","topic":"Naming Conventions","language":"C","updated":"2023-06-27","comments":3,"stars":8532,"raw":"https://awesomereviewers.com/raw/sonic-consistent-semantic-naming.md"},{"slug":"sonic-bounds-checking-first","title":"bounds checking first","description":"Always validate array and buffer bounds before accessing elements to prevent out-of-bounds access and potential security vulnerabilities. This is critical in algorithms that iterate through data structures or perform string operations.","repository":"bytedance/sonic","domain":"runtimes","topic":"Algorithms","language":"C","updated":"2023-06-27","comments":2,"stars":8532,"raw":"https://awesomereviewers.com/raw/sonic-bounds-checking-first.md"},{"slug":"sonic-consistent-code-formatting","title":"consistent code formatting","description":"Maintain consistent indentation and brace alignment throughout the codebase to improve readability and code organization. Use 4-space indentation consistently across all files and align closing braces with their corresponding opening statements.","repository":"bytedance/sonic","domain":"runtimes","topic":"Code Style","language":"C","updated":"2023-06-27","comments":2,"stars":8532,"raw":"https://awesomereviewers.com/raw/sonic-consistent-code-formatting.md"},{"slug":"sonic-meaningful-comment-practices","title":"Meaningful comment practices","description":"Comments should explain the reasoning behind code decisions rather than restating what the code obviously does. Focus on the \"why\" rather than the \"what\" to provide value that isn't immediately apparent from reading the code itself.","repository":"bytedance/sonic","domain":"runtimes","topic":"Documentation","language":"C","updated":"2023-06-27","comments":2,"stars":8532,"raw":"https://awesomereviewers.com/raw/sonic-meaningful-comment-practices.md"},{"slug":"serverless-maintain-iam-role-isolation","title":"maintain IAM role isolation","description":"Each resource should use the IAM role assigned to its associated function rather than sharing roles across different functional boundaries. Sharing roles between different functions or resources can create security vulnerabilities and potential privilege escalation paths.","repository":"serverless/serverless","domain":"cloud-infra","topic":"Security","language":"JavaScript","updated":"2023-06-27","comments":1,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-maintain-iam-role-isolation.md"},{"slug":"svelte-justify-configuration-changes","title":"Justify configuration changes","description":"When making configuration changes, especially dependency upgrades, provide clear justification for why the change is necessary rather than simply updating to the latest version. Explain the specific benefits, required features, or problems being solved.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2023-06-26","comments":2,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-justify-configuration-changes.md"},{"slug":"yoga-keep-configuration-versions-current","title":"Keep configuration versions current","description":"Regularly review and update version specifications in configuration files to align with current standards and internal practices. When updating versions, consider both the benefits of newer features and potential compatibility impacts.","repository":"facebook/yoga","domain":"runtimes","topic":"Configurations","language":"Swift","updated":"2023-06-16","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-keep-configuration-versions-current.md"},{"slug":"express-rest-principles-first","title":"REST principles first","description":"When designing APIs with Express, prioritize proper REST principles and HTTP semantics over convenience. This ensures your API is predictable, standards-compliant, and maintainable:","repository":"expressjs/express","domain":"app-frameworks","topic":"API","language":"JavaScript","updated":"2023-06-14","comments":5,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-rest-principles-first.md"},{"slug":"electron-context-aware-module-loading","title":"Context-aware module loading","description":"Choose appropriate module loading syntax based on your execution context and build configuration settings. Different environments have different module system capabilities that must be respected.","repository":"electron/electron","domain":"devtools","topic":"Configurations","language":"TypeScript","updated":"2023-06-13","comments":3,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-context-aware-module-loading.md"},{"slug":"electron-remove-internal-apis","title":"Remove internal APIs","description":"Delete internal system properties and APIs after use to prevent application code from accessing protected functionality. This security practice ensures that internal methods cannot be called by user code, protecting system integrity and preventing potential security vulnerabilities.","repository":"electron/electron","domain":"devtools","topic":"Security","language":"TypeScript","updated":"2023-06-13","comments":1,"stars":117644,"raw":"https://awesomereviewers.com/raw/electron-remove-internal-apis.md"},{"slug":"compose-validate-before-value-use","title":"Validate before value use","description":"Always validate potentially null or empty values before use, and provide explicit default values when handling optional data. This prevents runtime errors and makes code behavior more predictable.","repository":"docker/compose","domain":"orchestration","topic":"Null Handling","language":"Go","updated":"2023-06-08","comments":3,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-validate-before-value-use.md"},{"slug":"logseq-add-explanatory-documentation","title":"Add explanatory documentation","description":"Add docstrings to functions and comments to explain complex logic, especially when the purpose or reasoning isn't immediately clear from the code itself. This includes documenting function parameters, explaining non-obvious conditions, and clarifying implementation decisions or workarounds.","repository":"logseq/logseq","domain":"app-frameworks","topic":"Documentation","language":"Other","updated":"2023-06-04","comments":6,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-add-explanatory-documentation.md"},{"slug":"kubeflow-consistent-descriptive-naming","title":"Consistent descriptive naming","description":"Maintain consistency in naming patterns across related resources while ensuring names accurately reflect their purpose. When naming components, files, or configurations:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Naming Conventions","language":"Yaml","updated":"2023-06-04","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-consistent-descriptive-naming.md"},{"slug":"kubeflow-structured-owners-files","title":"Structured OWNERS files","description":"OWNERS files must follow project documentation standards to properly reflect component ownership and maintainership. When creating or updating these files:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Documentation","language":"Other","updated":"2023-06-03","comments":3,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-structured-owners-files.md"},{"slug":"zod-prefer-behavior-true-names","title":"Prefer behavior-true names","description":"Use naming that clearly communicates the real behavior/intent of the API and avoids misleading abbreviations or borrowed terms whose common meaning differs.","repository":"colinhacks/zod","domain":"app-frameworks","topic":"Naming Conventions","language":"Markdown","updated":"2023-06-02","comments":3,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-prefer-behavior-true-names.md"},{"slug":"serverless-maintain-configuration-standards","title":"maintain configuration standards","description":"Ensure configuration files maintain both consistency and currency across all services. Configuration values should follow established patterns within the codebase and use up-to-date versions for runtimes and dependencies.","repository":"serverless/serverless","domain":"cloud-infra","topic":"Configurations","language":"Yaml","updated":"2023-06-01","comments":2,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-maintain-configuration-standards.md"},{"slug":"tensorflow-secure-infrastructure-maintenance","title":"Secure infrastructure maintenance","description":"Maintain CI/CD infrastructure with security and currency as top priorities. This includes: 1. **Keep build tools updated**: Always use the latest stable versions of build tools and dependencies in CI/CD environments to benefit from bug fixes, security updates, and improved features.","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"CI/CD","language":"Dockerfile","updated":"2023-05-31","comments":2,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-secure-infrastructure-maintenance.md"},{"slug":"tensorflow-maintain-package-verification","title":"Maintain package verification","description":"Always keep signature verification enabled in package managers, even in development environments, Docker containers, or when facing initialization challenges. Disabling signature verification creates a significant security vulnerability by allowing potentially compromised or malicious packages to be installed.","repository":"tensorflow/tensorflow","domain":"ml-systems","topic":"Security","language":"Other","updated":"2023-05-31","comments":1,"stars":190625,"raw":"https://awesomereviewers.com/raw/tensorflow-maintain-package-verification.md"},{"slug":"express-handle-streams-properly","title":"Handle streams properly","description":"When transferring data over HTTP, properly implement streaming mechanisms to prevent memory exhaustion and potential denial-of-service vulnerabilities. Handle backpressure appropriately to ensure that slow clients cannot overwhelm server resources.","repository":"expressjs/express","domain":"app-frameworks","topic":"Networking","language":"JavaScript","updated":"2023-05-30","comments":5,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-handle-streams-properly.md"},{"slug":"kubeflow-document-migration-paths","title":"Document migration paths","description":"When implementing version changes or migrations, provide comprehensive documentation and tools to support users through the transition process. This includes:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Migrations","language":"Markdown","updated":"2023-05-29","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-document-migration-paths.md"},{"slug":"serverless-use-runserverless-utility","title":"Use runServerless utility","description":"All new tests must be written using the `runServerless` utility instead of legacy testing approaches. This utility provides a more reliable way to test functionality by replicating full command runs, ensuring that cross-dependent machinery works as expected in production.","repository":"serverless/serverless","domain":"cloud-infra","topic":"Testing","language":"JavaScript","updated":"2023-05-25","comments":25,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-use-runserverless-utility.md"},{"slug":"compose-wrap-and-check-errors","title":"Wrap and check errors","description":"Always wrap errors with meaningful context and use typed error checking instead of string matching. This helps with error tracing and maintains consistent error handling patterns.","repository":"docker/compose","domain":"orchestration","topic":"Error Handling","language":"Go","updated":"2023-05-24","comments":4,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-wrap-and-check-errors.md"},{"slug":"cypress-environment-variable-handling","title":"Environment variable handling","description":"Environment variables should be properly validated, parsed, and documented with clear override mechanisms. Always validate that environment variable names are non-empty strings before processing. When parsing environment variable values, trim whitespace and remove surrounding quotes to handle cross-platform differences, especially on Windows where quotes...","repository":"cypress-io/cypress","domain":"devtools","topic":"Configurations","language":"JavaScript","updated":"2023-05-24","comments":4,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-environment-variable-handling.md"},{"slug":"serverless-use-descriptive-semantic-names","title":"Use descriptive semantic names","description":"Variable and function names should clearly communicate their purpose, type, and scope without requiring additional context. Avoid confusing naming patterns and follow established conventions to improve code readability and maintainability.","repository":"serverless/serverless","domain":"cloud-infra","topic":"Naming Conventions","language":"JavaScript","updated":"2023-05-23","comments":16,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-use-descriptive-semantic-names.md"},{"slug":"serverless-consistent-asyncawait-usage","title":"consistent async/await usage","description":"When refactoring code to use async/await, ensure complete and consistent adoption throughout the function or module. Avoid mixing async/await syntax with .then() chains, as this creates confusing and hard-to-maintain code.","repository":"serverless/serverless","domain":"cloud-infra","topic":"Concurrency","language":"JavaScript","updated":"2023-05-22","comments":9,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-consistent-asyncawait-usage.md"},{"slug":"alacritty-choose-familiar-intuitive-names","title":"Choose familiar, intuitive names","description":"When naming variables, methods, or configuration options, prioritize terms that are both intuitive to users and familiar within the relevant domain. Avoid technical jargon when simpler, more natural alternatives exist, while also preferring established terminology that the target audience already knows.","repository":"alacritty/alacritty","domain":"devtools","topic":"Naming Conventions","language":"Yaml","updated":"2023-05-20","comments":3,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-choose-familiar-intuitive-names.md"},{"slug":"aws-sdk-js-explicit-verified-configurations","title":"Explicit verified configurations","description":"Always specify configuration values explicitly and verify their accuracy against official documentation or tests. This applies to region configurations, API settings, and credential management. Avoid mutations of global configuration objects, and instead set values explicitly when defined by service APIs.","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Configurations","language":"Json","updated":"2023-05-19","comments":3,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-explicit-verified-configurations.md"},{"slug":"vitess-structured-configuration-management","title":"Structured configuration management","description":"Avoid using global configuration singletons that rely on string-based lookups, as they lead to brittle code that's hard to maintain. Instead, implement a structured approach where configuration values are explicitly declared with their types, sources (flags, environment variables, config files), and default values. This improves compile-time safety,...","repository":"vitessio/vitess","domain":"data-systems","topic":"Configurations","language":"Markdown","updated":"2023-05-19","comments":3,"stars":19815,"raw":"https://awesomereviewers.com/raw/vitess-structured-configuration-management.md"},{"slug":"tokenizers-prioritize-tokenizer-simplicity","title":"Prioritize tokenizer simplicity","description":"When implementing AI model components like tokenizers, favor simplicity over rarely-used features that significantly increase code complexity. This is especially important for performance-critical paths in machine learning pipelines. Consider removing or deferring implementation of features that:","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"AI","language":"TypeScript","updated":"2023-05-17","comments":2,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-prioritize-tokenizer-simplicity.md"},{"slug":"kubeflow-private-vulnerability-reporting","title":"Private vulnerability reporting","description":"Never expose security vulnerabilities in public issue trackers. Security issues require confidential handling to prevent exploitation before fixes are available. Use private reporting channels such as:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Security","language":"Markdown","updated":"2023-05-16","comments":1,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-private-vulnerability-reporting.md"},{"slug":"poetry-network-request-configuration","title":"Network request configuration","description":"When implementing or documenting network functionality, ensure proper configuration options are provided and compatibility across different environments is considered. Network requests should have configurable timeouts and work reliably across platform variations.","repository":"python-poetry/poetry","domain":"devtools","topic":"Networking","language":"Markdown","updated":"2023-05-14","comments":2,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-network-request-configuration.md"},{"slug":"yoga-improve-code-readability","title":"Improve code readability","description":"Enhance code clarity and maintainability by applying several readability techniques: extract repeated expressions into well-named variables, simplify complex boolean logic, use proper constant declarations, and remove redundant code that sets default values.","repository":"facebook/yoga","domain":"runtimes","topic":"Code Style","language":"C++","updated":"2023-05-12","comments":4,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-improve-code-readability.md"},{"slug":"logseq-classify-configuration-properties-appropriately","title":"Classify configuration properties appropriately","description":"Ensure configuration properties and settings are properly categorized based on their intended use, visibility, and user interaction requirements. Built-in system properties should be classified as hidden, editable, or user-visible depending on whether end users should interact with them directly.","repository":"logseq/logseq","domain":"app-frameworks","topic":"Configurations","language":"Markdown","updated":"2023-05-12","comments":3,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-classify-configuration-properties-appropriately.md"},{"slug":"terraform-least-privilege-for-tokens","title":"Least privilege for tokens","description":"Always apply the principle of least privilege when configuring access tokens for CI/CD workflows and other automated processes. Use fine-grained tokens or permissions that grant only the minimum necessary access required for the specific operations.","repository":"hashicorp/terraform","domain":"cloud-infra","topic":"Security","language":"Yaml","updated":"2023-05-12","comments":1,"stars":45532,"raw":"https://awesomereviewers.com/raw/terraform-least-privilege-for-tokens.md"},{"slug":"spring-boot-explicit-security-documentation","title":"Explicit security documentation","description":"Always provide explicit and accurate documentation for security-related configurations, including: 1. Use proper configuration property syntax with validation where possible (e.g., `configprop:spring.security.oauth2.resourceserver.jwt.audiences[]`)","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Security","language":"Other","updated":"2023-05-11","comments":4,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-explicit-security-documentation.md"},{"slug":"serverless-structure-configs-for-clarity","title":"Structure configs for clarity","description":"Organize configuration objects to maximize clarity and maintainability while ensuring robust validation. Follow these principles: 1. Use single object definitions instead of multiple configurations to enable specific error messages","repository":"serverless/serverless","domain":"cloud-infra","topic":"Configurations","language":"JavaScript","updated":"2023-05-10","comments":5,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-structure-configs-for-clarity.md"},{"slug":"serverless-prefer-simple-readable-patterns","title":"prefer simple readable patterns","description":"Choose simple, readable code patterns over complex alternatives. Avoid unnecessary complexity that doesn't add functional value but makes code harder to understand and maintain.","repository":"serverless/serverless","domain":"cloud-infra","topic":"Code Style","language":"JavaScript","updated":"2023-05-09","comments":8,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-prefer-simple-readable-patterns.md"},{"slug":"serverless-api-clarity-and-consistency","title":"API clarity and consistency","description":"Ensure API configurations, documentation, and terminology are clear, consistent, and properly organized. Group related API properties together logically, use precise terminology that matches the underlying service (e.g., distinguish \"HTTP API\" from \"REST API\"), and maintain consistent naming conventions throughout.","repository":"serverless/serverless","domain":"cloud-infra","topic":"API","language":"Markdown","updated":"2023-05-09","comments":5,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-api-clarity-and-consistency.md"},{"slug":"nextchat-secure-proxy-endpoints","title":"Secure proxy endpoints","description":"Proxy endpoints that forward requests to external services can be exploited by malicious actors if left unsecured. Always implement proper authentication, authorization, and destination validation for proxy endpoints, especially in production deployments.","repository":"ChatGPTNextWeb/NextChat","domain":"ai-agents","topic":"Security","language":"Other","updated":"2023-05-09","comments":1,"stars":85721,"raw":"https://awesomereviewers.com/raw/nextchat-secure-proxy-endpoints.md"},{"slug":"deeplearning4j-keep-configurations-current","title":"Keep configurations current","description":"Ensure all configuration elements (dependencies, build settings, preprocessor flags) are up-to-date, documented, and consistent with project standards. This practice prevents issues arising from outdated references and improves maintainability for team members.","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Configurations","language":"Other","updated":"2023-05-08","comments":4,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-keep-configurations-current.md"},{"slug":"tokenizers-use-explicit-assertions","title":"Use explicit assertions","description":"Tests should assert specific expected values rather than just verifying general functionality. This practice makes tests more robust against subtle regressions and helps catch \"under the radar\" bugs where behavior is modified unintentionally.","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"Testing","language":"Rust","updated":"2023-05-06","comments":2,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-use-explicit-assertions.md"},{"slug":"kubeflow-standardize-makefile-patterns","title":"Standardize makefile patterns","description":"Maintain consistent Makefile patterns across all components to improve build reliability and developer experience in CI/CD pipelines. Key practices to follow:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"CI/CD","language":"Other","updated":"2023-05-05","comments":5,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-standardize-makefile-patterns.md"},{"slug":"logseq-configuration-option-lifecycle","title":"Configuration option lifecycle","description":"When adding new configuration options, follow a systematic approach to ensure consistency and maintainability across the application. This prevents incomplete implementations that can break existing functionality or create inconsistent user experiences.","repository":"logseq/logseq","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2023-05-05","comments":5,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-configuration-option-lifecycle.md"},{"slug":"comfyui-avoid-hardcoded-values","title":"avoid hardcoded values","description":"Replace hardcoded styling values and configuration constants with flexible alternatives to improve maintainability and consistency. Use CSS variables for colors and theming, backend-provided values for limits and ranges, and semantic CSS properties instead of absolute positioning.","repository":"comfyanonymous/ComfyUI","domain":"ml-systems","topic":"Code Style","language":"JavaScript","updated":"2023-05-05","comments":2,"stars":83726,"raw":"https://awesomereviewers.com/raw/comfyui-avoid-hardcoded-values.md"},{"slug":"compose-document-cicd-workflows-clearly","title":"Document CI/CD workflows clearly","description":"When documenting CI/CD processes, build pipelines, or deployment workflows, use clear and precise language that helps developers understand the sequence of operations. Write in present tense to describe what tools do, and provide explicit references when explaining examples.","repository":"docker/compose","domain":"orchestration","topic":"CI/CD","language":"Markdown","updated":"2023-05-05","comments":2,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-document-cicd-workflows-clearly.md"},{"slug":"elasticsearch-document-security-requirements-explicitly","title":"Document security requirements explicitly","description":"Always document security-related configurations, permissions, and behaviors explicitly and comprehensively. When documenting security features: 1. Clearly specify required permissions and roles","repository":"elastic/elasticsearch","domain":"data-systems","topic":"Security","language":"Other","updated":"2023-05-03","comments":2,"stars":73104,"raw":"https://awesomereviewers.com/raw/elasticsearch-document-security-requirements-explicitly.md"},{"slug":"serverless-configuration-examples-accuracy","title":"configuration examples accuracy","description":"Ensure configuration examples and documentation use current, supported syntax and accurately reflect the actual behavior of the system. Avoid promoting deprecated features, outdated versions, or configuration options that have no effect.","repository":"serverless/serverless","domain":"cloud-infra","topic":"Configurations","language":"Markdown","updated":"2023-04-30","comments":6,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-configuration-examples-accuracy.md"},{"slug":"poetry-avoid-redundant-tool-configuration","title":"avoid redundant tool configuration","description":"When configuring code style tools, avoid enabling rules or settings that duplicate functionality already provided by other tools in your toolchain. This reduces configuration complexity, prevents conflicting rules, and improves maintainability.","repository":"python-poetry/poetry","domain":"devtools","topic":"Code Style","language":"Toml","updated":"2023-04-30","comments":3,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-avoid-redundant-tool-configuration.md"},{"slug":"nextchat-validate-parameter-boundaries","title":"Validate parameter boundaries","description":"Always validate that parameters contain expected types and values within safe boundaries, not just null/undefined checks. Optional parameters can receive unexpected types (like event objects), and numeric parameters need boundary validation to prevent invalid operations.","repository":"ChatGPTNextWeb/NextChat","domain":"ai-agents","topic":"Null Handling","language":"TypeScript","updated":"2023-04-29","comments":2,"stars":85721,"raw":"https://awesomereviewers.com/raw/nextchat-validate-parameter-boundaries.md"},{"slug":"compose-prevent-unintended-ci-behaviors","title":"Prevent unintended CI behaviors","description":"Ensure CI/CD pipelines maintain predictable and reliable behavior by avoiding changes that introduce unexpected side effects or alter default behaviors. This includes preventing automatic actions like image pushing when not explicitly requested, using consistent tooling approaches across similar operations, and properly handling unreliable components.","repository":"docker/compose","domain":"orchestration","topic":"CI/CD","language":"Go","updated":"2023-04-28","comments":4,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-prevent-unintended-ci-behaviors.md"},{"slug":"deeplearning4j-centralize-dependency-management","title":"Centralize dependency management","description":"Manage dependencies at the top level using `<dependencyManagement>` to ensure version consistency across modules and prevent conflicts. Define version properties in one place and reference them throughout the project:","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Configurations","language":"Xml","updated":"2023-04-21","comments":10,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-centralize-dependency-management.md"},{"slug":"chef-remove-commented-code","title":"Remove commented code","description":"Avoid leaving commented-out code in the codebase. Version control systems already track the history of changes, making commented-out code unnecessary. Removing unused commented code improves readability, reduces confusion, and keeps the codebase clean.","repository":"chef/chef","domain":"cloud-infra","topic":"Code Style","language":"Yaml","updated":"2023-04-19","comments":3,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-remove-commented-code.md"},{"slug":"spring-framework-verify-operation-semantics","title":"Verify operation semantics","description":"When implementing algorithms that process collections or use conditional logic, always verify the exact semantics of operations across different data structures.","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Algorithms","language":"Other","updated":"2023-04-18","comments":2,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-verify-operation-semantics.md"},{"slug":"express-ensure-test-completion","title":"Ensure test completion","description":"Tests must properly terminate by following appropriate asynchronous patterns. For asynchronous tests, always invoke the `done()` callback after assertions or use returned Promises. For synchronous tests, omit the `done` parameter entirely. Use Mocha's built-in assertion handling rather than manual try-catch blocks.","repository":"expressjs/express","domain":"app-frameworks","topic":"Testing","language":"JavaScript","updated":"2023-04-13","comments":5,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-ensure-test-completion.md"},{"slug":"typescript-preserve-api-compatibility-first","title":"Preserve API compatibility first","description":"When modifying existing APIs, maintain backwards compatibility by adding new overloads rather than directly changing existing signatures. Mark old signatures as deprecated when introducing new patterns, but keep them functional until a major version change.","repository":"microsoft/typescript","domain":"runtimes","topic":"API","language":"TypeScript","updated":"2023-04-13","comments":4,"stars":105378,"raw":"https://awesomereviewers.com/raw/typescript-preserve-api-compatibility-first.md"},{"slug":"kubeflow-use-appropriate-log-levels","title":"Use appropriate log levels","description":"Always match logging levels to the message's purpose and severity. Use log.Info for general information, log.Warn for warnings, and log.Error for error conditions. Avoid using fmt.Println for logging as it bypasses the logging framework's level-based filtering capabilities.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Logging","language":"Go","updated":"2023-04-13","comments":3,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-use-appropriate-log-levels.md"},{"slug":"logseq-multi-arity-backward-compatibility","title":"Multi-arity backward compatibility","description":"When extending existing API functions with new parameters, use multi-arity function definitions to maintain backward compatibility. This allows existing code to continue working unchanged while providing enhanced functionality through additional arities.","repository":"logseq/logseq","domain":"app-frameworks","topic":"API","language":"Other","updated":"2023-04-07","comments":3,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-multi-arity-backward-compatibility.md"},{"slug":"poetry-verify-configuration-options","title":"Verify configuration options","description":"Always verify that configuration file options and command flags are correct and properly documented. Incorrect configuration syntax can cause silent failures or unintended side effects that are difficult to debug.","repository":"python-poetry/poetry","domain":"devtools","topic":"Configurations","language":"Other","updated":"2023-04-07","comments":2,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-verify-configuration-options.md"},{"slug":"logseq-filter-nil-values-defensively","title":"Filter nil values defensively","description":"Proactively filter out nil values from collections and validate non-empty states before processing to prevent runtime errors. This defensive approach prevents common issues like \"Cannot read properties of null\" errors and ensures robust data handling.","repository":"logseq/logseq","domain":"app-frameworks","topic":"Null Handling","language":"Other","updated":"2023-04-06","comments":3,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-filter-nil-values-defensively.md"},{"slug":"mastodon-use-404-over-403","title":"Use 404 over 403","description":"When blocking access to security-sensitive endpoints or directories, return HTTP 404 (Not Found) instead of 403 (Forbidden) to prevent information disclosure. A 403 response reveals that the resource exists but access is denied, which can provide valuable reconnaissance information to attackers. A 404 response makes it harder for attackers to determine what...","repository":"mastodon/mastodon","domain":"app-frameworks","topic":"Security","language":"Other","updated":"2023-04-03","comments":1,"stars":48691,"raw":"https://awesomereviewers.com/raw/mastodon-use-404-over-403.md"},{"slug":"cli-explain-complex-logic","title":"Explain complex logic","description":"Add explanatory comments for non-obvious code sections, complex business logic, and public methods to clarify their purpose and reasoning. Comments should explain the \"why\" behind decisions and the \"what\" for functions that aren't immediately clear from their implementation.","repository":"snyk/cli","domain":"security","topic":"Documentation","language":"Go","updated":"2023-03-30","comments":2,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-explain-complex-logic.md"},{"slug":"kubeflow-component-agnostic-styling-principles","title":"Component-agnostic styling principles","description":"Create reusable components with styles that don't make assumptions about parent contexts or affect their positioning in different applications. Keep positioning styles (like margins) in the parent components that use them rather than in the reusable component itself. Prefer properties that don't assume parent styling context.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Code Style","language":"Css","updated":"2023-03-30","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-component-agnostic-styling-principles.md"},{"slug":"go-wrap-errors-properly","title":"wrap errors properly","description":"When creating error messages that include information from underlying errors, use fmt.Errorf with the %w verb instead of string concatenation with err.Error(). This preserves the error chain, enabling proper error unwrapping and better debugging capabilities.","repository":"golang/go","domain":"runtimes","topic":"Error Handling","language":"Go","updated":"2023-03-28","comments":2,"stars":129599,"raw":"https://awesomereviewers.com/raw/go-wrap-errors-properly.md"},{"slug":"cypress-thoughtful-error-handling","title":"Thoughtful error handling","description":"Implement error handling that considers recoverability, appropriate logging levels, and prevents redundant operations. Use warnings for recoverable errors during retry attempts, and errors only for final failures. Avoid duplicate error logging when errors are already wrapped or handled elsewhere. Implement guards to prevent redundant error handler setup,...","repository":"cypress-io/cypress","domain":"devtools","topic":"Error Handling","language":"JavaScript","updated":"2023-03-24","comments":5,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-thoughtful-error-handling.md"},{"slug":"cypress-document-non-obvious-code","title":"Document non-obvious code","description":"Add explanatory comments when code logic is unclear, implements workarounds, or has special reasoning that isn't immediately apparent to other developers. Comments should explain the \"why\" behind the implementation, not just the \"what\".","repository":"cypress-io/cypress","domain":"devtools","topic":"Documentation","language":"JavaScript","updated":"2023-03-24","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-document-non-obvious-code.md"},{"slug":"kubeflow-private-variable-naming-convention","title":"Private variable naming convention","description":"Use the 'prv' prefix for private class members and ensure they're explicitly declared with the 'private' access modifier. This maintains consistency with established team conventions and improves code readability by clearly indicating variable scope.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Naming Conventions","language":"TypeScript","updated":"2023-03-24","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-private-variable-naming-convention.md"},{"slug":"azure-sentinel-use-standard-entity-identifiers","title":"Use Standard Entity Identifiers","description":"When creating `entityMappings`, use semantically strong, standard identifier fields as the mapped `columnName`. Avoid “legacy/weak” intermediary names like `AccountCustomEntity` (and avoid unnecessary wrapper columns like `IPCustomEntity`) when a direct standard field already exists.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Naming Conventions","language":"Yaml","updated":"2023-03-23","comments":6,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-use-standard-entity-identifiers.md"},{"slug":"kubeflow-match-algorithms-to-purpose","title":"Match algorithms to purpose","description":"Select algorithmic constructs and control structures that are appropriate for the specific task. Common issues include: 1. Using loops when conditional checks are sufficient","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Algorithms","language":"Python","updated":"2023-03-23","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-match-algorithms-to-purpose.md"},{"slug":"kubeflow-type-appropriate-default-values","title":"Type-appropriate default values","description":"Initialize variables with type-appropriate default values to prevent type errors and null reference exceptions during operations. When a variable is expected to hold a collection type (list, dictionary, set), use the corresponding empty collection (`[]`, `{}`, `set()`) rather than other falsy values like `None` or empty strings.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Null Handling","language":"Python","updated":"2023-03-23","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-type-appropriate-default-values.md"},{"slug":"kubeflow-use-snake-case-in-python","title":"Use snake_case in Python","description":"Follow Python's PEP 8 naming convention by using snake_case for variables, functions, and methods rather than camelCase or other styles. This enhances readability and maintains consistency across the codebase.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Naming Conventions","language":"Python","updated":"2023-03-22","comments":3,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-use-snake-case-in-python.md"},{"slug":"istio-document-observability-clearly","title":"Document observability clearly","description":"Ensure observability documentation is clear, accessible, and grammatically correct. This includes defining technical acronyms and ensuring proper sentence structure in configuration explanations.","repository":"istio/istio","domain":"orchestration","topic":"Observability","language":"Markdown","updated":"2023-03-21","comments":2,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-document-observability-clearly.md"},{"slug":"material-ui-secure-api-endpoints","title":"Secure API endpoints","description":"Always implement appropriate security measures for API endpoints that perform sensitive operations. This includes: 1. **Verify request authenticity**: Ensure requests come from legitimate sources using mechanisms like SDK verification, API keys, or signatures.","repository":"mui/material-ui","domain":"app-frameworks","topic":"Security","language":"JavaScript","updated":"2023-03-21","comments":2,"stars":96063,"raw":"https://awesomereviewers.com/raw/material-ui-secure-api-endpoints.md"},{"slug":"deeplearning4j-ensure-test-determinism","title":"Ensure test determinism","description":"Create reliable and reproducible tests by explicitly controlling test inputs and verifying function behavior doesn''t have unintended side effects. Two key practices to follow:","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Testing","language":"Java","updated":"2023-03-16","comments":2,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-ensure-test-determinism.md"},{"slug":"kubeflow-api-structure-balance","title":"API structure balance","description":"Maintain a clear separation between resource-specific API handlers and common utilities. Resource-specific handlers should remain in their dedicated modules to reduce dependencies, while common functionality should be extracted into shared helpers for consistency.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"API","language":"Python","updated":"2023-03-15","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-api-structure-balance.md"},{"slug":"kubeflow-reduce-nesting-depth","title":"Reduce nesting depth","description":"Improve code readability by reducing nesting depth with early returns and functional approaches. Use early returns to handle edge cases first, and prefer functional operators over nested conditionals when working with streams or collections.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Code Style","language":"TypeScript","updated":"2023-03-14","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-reduce-nesting-depth.md"},{"slug":"ink-use-descriptive-parameter-names","title":"Use descriptive parameter names","description":"Choose parameter names that clearly communicate their purpose and avoid confusion with similar concepts. Avoid generic or ambiguous names that could be misinterpreted.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"Naming Conventions","language":"TypeScript","updated":"2023-03-13","comments":2,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-use-descriptive-parameter-names.md"},{"slug":"aws-sdk-js-defensive-null-checking","title":"Defensive null checking","description":"Always perform explicit null/undefined checks before accessing properties or using values that could be null or undefined. Use strict equality checks rather than relying on JavaScript's truthy/falsy evaluation which can lead to subtle bugs.","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Null Handling","language":"JavaScript","updated":"2023-03-10","comments":7,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-defensive-null-checking.md"},{"slug":"serverless-use-loose-equality-checks","title":"use loose equality checks","description":"Use loose equality (`== null`) instead of strict equality (`=== null` or `=== undefined`) when checking for both null and undefined values. In most JavaScript contexts, null and undefined should be treated equivalently, and loose equality provides a more concise and readable way to handle both cases.","repository":"serverless/serverless","domain":"cloud-infra","topic":"Null Handling","language":"JavaScript","updated":"2023-03-10","comments":6,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-use-loose-equality-checks.md"},{"slug":"spring-boot-stable-observability-components","title":"Stable observability components","description":"Always use stable, production-ready versions of observability components (libraries, dependencies, and documentation references) in your applications. Monitoring and observability systems are critical infrastructure that should prioritize stability over cutting-edge features.","repository":"spring-projects/spring-boot","domain":"app-frameworks","topic":"Observability","language":"Other","updated":"2023-03-09","comments":2,"stars":77637,"raw":"https://awesomereviewers.com/raw/spring-boot-stable-observability-components.md"},{"slug":"spring-framework-package-null-safety-annotations","title":"Package null-safety annotations","description":"All package-info.java files must include both @NonNullApi and @NonNullFields annotations to establish null-safety at the package level. These annotations must each be on a single line for proper detection by static analysis tools. This practice makes null-handling behavior explicit, reduces NullPointerExceptions, and enforces consistent null-safety...","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Null Handling","language":"Xml","updated":"2023-03-08","comments":3,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-package-null-safety-annotations.md"},{"slug":"poetry-maintain-security-constraints","title":"maintain security constraints","description":"Always preserve existing security constraints and validation mechanisms rather than weakening them for convenience or functionality. When modifying authentication, validation, or security-related code, ensure that the changes maintain or strengthen the security posture.","repository":"python-poetry/poetry","domain":"devtools","topic":"Security","language":"Python","updated":"2023-03-06","comments":3,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-maintain-security-constraints.md"},{"slug":"logseq-api-input-validation","title":"API input validation","description":"When working with APIs, always validate inputs beyond basic format checking to ensure semantic correctness and handle edge cases properly. Simple constructor calls or basic format validation may accept invalid or unexpected inputs that could cause issues downstream.","repository":"logseq/logseq","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2023-03-03","comments":3,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-api-input-validation.md"},{"slug":"cypress-use-descriptive-names","title":"Use descriptive names","description":"Choose names that clearly reveal the purpose and behavior of variables, functions, and methods. Names should be self-documenting and follow these patterns:","repository":"cypress-io/cypress","domain":"devtools","topic":"Naming Conventions","language":"TypeScript","updated":"2023-03-02","comments":6,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-use-descriptive-names.md"},{"slug":"gin-configuration-file-precision","title":"Configuration file precision","description":"Ensure configuration files are precisely maintained with correct syntax and compatible version declarations. This includes: 1. **Version compatibility**: When using language features, ensure the declared version in configuration files (e.g., go.mod) is compatible. For example, if using Go 1.20 features like `unsafe.StringData()`, ensure go.mod specifies...","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"2023-03-01","comments":3,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-configuration-file-precision.md"},{"slug":"kubeflow-safe-url-operations","title":"Safe URL operations","description":"When handling URLs for API interactions and navigation, use precise methods for both comparison and construction to avoid subtle bugs: 1. For URL path comparison, use `startsWith()` instead of `includes()` to prevent false positives from substring matches:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"API","language":"TypeScript","updated":"2023-02-24","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-safe-url-operations.md"},{"slug":"azure-quickstart-templates-in-code-documentation-consistency","title":"In-code Documentation Consistency","description":"Ensure any developer-facing documentation embedded in the codebase (template metadata, links, and sample deployment instructions) is complete, unambiguous, portable, and consistent with the repository layout.","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Documentation","language":"Json","updated":"2023-02-22","comments":5,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-in-code-documentation-consistency.md"},{"slug":"boto3-follow-naming-conventions","title":"Follow naming conventions","description":"Use consistent and appropriate naming conventions based on the context\\ \\ in Python code:\\n\\n1. **Classes**: Use `CamelCase` for class names\\n   ```python\\n\\ \\   class ResourceMeta(object):","repository":"boto/boto3","domain":"cloud-infra","topic":"Naming Conventions","language":"Python","updated":"2023-02-21","comments":7,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-follow-naming-conventions.md"},{"slug":"cypress-prioritize-backward-compatibility","title":"prioritize backward compatibility","description":"When evolving APIs, prioritize maintaining backward compatibility over enforcing strict design constraints. Teams should choose approaches that allow existing code to continue working rather than forcing breaking changes for theoretical purity.","repository":"cypress-io/cypress","domain":"devtools","topic":"API","language":"TSX","updated":"2023-02-21","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-prioritize-backward-compatibility.md"},{"slug":"temporal-minimize-credential-data-exposure","title":"Minimize credential data exposure","description":"When handling security credentials (particularly TLS certificates) in data structures intended for transmission or serialization, include only the minimum necessary identifying information. Avoid passing complete certificate chains or redundant fields that have already been validated upstream.","repository":"temporalio/temporal","domain":"orchestration","topic":"Security","language":"Go","updated":"2023-02-21","comments":1,"stars":14953,"raw":"https://awesomereviewers.com/raw/temporal-minimize-credential-data-exposure.md"},{"slug":"nest-graph-based-dependency-management","title":"Graph-based dependency management","description":"When managing module dependencies in a system, treat the dependencies as a directed graph and apply appropriate graph algorithms to ensure proper initialization order and prevent errors.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Algorithms","language":"TypeScript","updated":"2023-02-20","comments":3,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-graph-based-dependency-management.md"},{"slug":"nest-use-topological-sorting","title":"Use topological sorting","description":"When managing dependencies between modules or components, implement a topological sorting algorithm to ensure correct initialization order. This prevents cascading errors and ensures that dependencies are properly initialized before they're used.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Algorithms","language":"TypeScript","updated":"2023-02-20","comments":3,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-use-topological-sorting.md"},{"slug":"istio-leverage-kernel-network-structures","title":"leverage kernel network structures","description":"When implementing eBPF networking programs, prefer using kernel-native data structures and BPF helpers over maintaining custom eBPF maps that duplicate network routing information. The kernel already tracks IP-to-MAC mappings, interface information, and routing data through its networking stack.","repository":"istio/istio","domain":"orchestration","topic":"Networking","language":"C","updated":"2023-02-17","comments":3,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-leverage-kernel-network-structures.md"},{"slug":"cypress-prefer-semantic-test-selectors","title":"Prefer semantic test selectors","description":"When writing tests, prioritize semantic and accessibility-based selectors over data attributes or generic selectors. Use accessible names, roles, and text content to select elements, as these selectors validate both functionality and accessibility simultaneously.","repository":"cypress-io/cypress","domain":"devtools","topic":"Testing","language":"TSX","updated":"2023-02-14","comments":3,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-prefer-semantic-test-selectors.md"},{"slug":"azure-quickstart-templates-avoid-empty-placeholders","title":"Avoid empty placeholders","description":"When a parameter/property is optional in an ARM template, don’t represent “missing” with empty objects or empty strings—these can be treated as real values and fail validation or downstream logic.","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Null Handling","language":"Json","updated":"2023-02-09","comments":4,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-avoid-empty-placeholders.md"},{"slug":"ink-packagejson-configuration-standards","title":"Package.json configuration standards","description":"Ensure package.json follows modern standards and maintains consistency across configuration fields. Use structured exports instead of simple main field, align dependency versions with engine requirements, prefer configuration properties over CLI flags, and avoid accidental version locking.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2023-02-09","comments":4,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-packagejson-configuration-standards.md"},{"slug":"ink-fix-linting-root-causes","title":"Fix linting root causes","description":"Address underlying code issues rather than disabling linting rules or working around auto-formatter conflicts. When linting tools flag legitimate problems, fix the root cause instead of suppressing the warning. When auto-formatters conflict with intentional code patterns, adjust project-wide configuration rather than using local disables.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"Code Style","language":"TSX","updated":"2023-02-08","comments":3,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-fix-linting-root-causes.md"},{"slug":"nest-secure-hash-algorithms","title":"Secure hash algorithms","description":"Always use cryptographically secure hash algorithms for sensitive operations instead of weak or broken ones. Weak algorithms can compromise security and make your application vulnerable. Prefer modern algorithms like SHA-256 over older or non-cryptographic hash functions.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Security","language":"TypeScript","updated":"2023-02-07","comments":1,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-secure-hash-algorithms.md"},{"slug":"nest-use-secure-hash-algorithms","title":"Use secure hash algorithms","description":"Always use strong, modern cryptographic hash algorithms for security-sensitive operations. Avoid deprecated or weak algorithms that might be vulnerable to attacks. When selecting hash algorithms, consider both security requirements and performance characteristics.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Security","language":"TypeScript","updated":"2023-02-07","comments":1,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-use-secure-hash-algorithms.md"},{"slug":"nest-use-consistent-curly-braces","title":"Use consistent curly braces","description":"Always use curly braces for conditional statements and loops, even for single-line bodies. This maintains consistency throughout the codebase and improves readability. Avoid inline conditionals.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2023-02-06","comments":5,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-use-consistent-curly-braces.md"},{"slug":"nest-use-consistent-control-structures","title":"Use consistent control structures","description":"Always use curly braces for control structures (if, for, while, etc.), even for single-line statements. This improves code readability and maintainability by making the code structure explicit and consistent.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2023-02-06","comments":4,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-use-consistent-control-structures.md"},{"slug":"octokit.net-verify-documentation-links","title":"Verify documentation links","description":"Always ensure external links in documentation are valid, secure, and point to authoritative sources. This includes: 1. Use HTTPS instead of HTTP links for security","repository":"octokit/octokit.net","domain":"devtools","topic":"Documentation","language":"Markdown","updated":"2023-02-06","comments":2,"stars":2793,"raw":"https://awesomereviewers.com/raw/octokit.net-verify-documentation-links.md"},{"slug":"nest-optimize-critical-path-iterations","title":"Optimize critical path iterations","description":"Use appropriate iteration techniques in performance-critical code paths to minimize overhead and maximize execution speed: 1. **Use raw for loops with early termination** instead of array methods like `map` and `filter` for maximum performance:","repository":"nestjs/nest","domain":"app-frameworks","topic":"Performance Optimization","language":"TypeScript","updated":"2023-02-04","comments":3,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-optimize-critical-path-iterations.md"},{"slug":"frp-validate-with-sensible-defaults","title":"Validate with sensible defaults","description":"Implement a comprehensive configuration validation strategy that combines centralized validation functions with appropriate default values and user-friendly messaging. Instead of failing with errors on non-critical configuration issues, provide warnings and continue with sensible defaults.","repository":"fatedier/frp","domain":"cloud-infra","topic":"Configurations","language":"Go","updated":"2023-02-03","comments":4,"stars":95938,"raw":"https://awesomereviewers.com/raw/frp-validate-with-sensible-defaults.md"},{"slug":"deeplearning4j-use-appropriate-logging-levels","title":"Use appropriate logging levels","description":"Reserve logging statements for their appropriate purposes and levels. Use debugging-level logs (`sd_debug`) for development-time diagnostic information, and only use standard printing functions (`sd_printf`) for critical user-facing messages or error conditions. Excessive or incorrectly leveled logging creates noise in production systems and can impact...","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Logging","language":"C++","updated":"2023-02-03","comments":3,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-use-appropriate-logging-levels.md"},{"slug":"azure-quickstart-templates-validated-api-parameters","title":"Validated API parameters","description":"Treat template parameters and embedded ARM calls as a client-facing API contract. Validate inputs and constrain the “request schema” so invalid values can’t be sent, and keep compatibility/UX aligned with how the template is consumed.","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"API","language":"Other","updated":"2023-02-02","comments":4,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-validated-api-parameters.md"},{"slug":"chef-fail-fast-principle","title":"Fail fast principle","description":"Design CI/CD pipelines to fail quickly and visibly rather than masking errors through excessive retries or complex conditions. When a build step fails, it should fail immediately with clear error reporting to reduce debugging time and enable faster remediation.","repository":"chef/chef","domain":"cloud-infra","topic":"CI/CD","language":"Other","updated":"2023-02-02","comments":3,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-fail-fast-principle.md"},{"slug":"kotlin-standardize-build-configurations","title":"Standardize build configurations","description":"Maintain consistent and standardized build configurations across the project to improve maintainability and reduce errors: 1. **Centralize dependency management** - Use shared dependency declarations rather than hardcoding versions in individual module build files. This ensures consistency across the project and makes version updates simpler.","repository":"JetBrains/kotlin","domain":"runtimes","topic":"Configurations","language":"Other","updated":"2023-02-02","comments":3,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-standardize-build-configurations.md"},{"slug":"nest-proper-asynchronous-error-handling","title":"Proper asynchronous error handling","description":"Ensure errors in asynchronous operations and event-based systems are handled consistently to prevent unexpected behavior. Always maintain Promise integrity by never resolving and rejecting the same Promise, and use appropriate error event handlers.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2023-02-01","comments":7,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-proper-asynchronous-error-handling.md"},{"slug":"cli-use-secure-hash-functions","title":"Use secure hash functions","description":"When hashing sensitive data such as authentication tokens, always use cryptographically secure hash functions like SHA-256 instead of faster but insecure alternatives like MD5 or CRC32. Secure hash functions provide protection against reverse engineering and rainbow table attacks, which is critical for maintaining the confidentiality of sensitive...","repository":"snyk/cli","domain":"security","topic":"Security","language":"Go","updated":"2023-02-01","comments":1,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-use-secure-hash-functions.md"},{"slug":"kubeflow-use-enums-for-state","title":"Use enums for state","description":"When handling nullable or undefined states, use enumerations instead of primitive types like boolean or null/undefined. Enums provide more descriptive and type-safe representations of different states, including the absence of a value or an unknown state.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Null Handling","language":"TypeScript","updated":"2023-01-31","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-use-enums-for-state.md"},{"slug":"logseq-simplify-naming-conventions","title":"Simplify naming conventions","description":"Prioritize simple, enforceable naming conventions over complex guidelines that are difficult to follow consistently. When establishing naming standards, focus on what serves a clear purpose and can be realistically maintained by the team.","repository":"logseq/logseq","domain":"app-frameworks","topic":"Naming Conventions","language":"Markdown","updated":"2023-01-31","comments":2,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-simplify-naming-conventions.md"},{"slug":"kubeflow-normalize-url-paths","title":"Normalize URL paths","description":"When handling URLs in web applications, consistently normalize path formats to prevent routing and service communication issues. This is especially important when working with services like Istio that expect specific URL formats (e.g., trailing slashes).","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Networking","language":"TypeScript","updated":"2023-01-30","comments":3,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-normalize-url-paths.md"},{"slug":"logseq-css-comment-standards","title":"CSS comment standards","description":"Always use proper CSS comment syntax (`/* */`) instead of inline comments (`//`) for better cross-browser compatibility and code consistency. Additionally, rely on autoprefixer configuration for vendor prefixes rather than manually adding them, which reduces code duplication and maintenance overhead.","repository":"logseq/logseq","domain":"app-frameworks","topic":"Code Style","language":"Css","updated":"2023-01-23","comments":2,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-css-comment-standards.md"},{"slug":"chef-structure-cicd-scripts","title":"Structure CI/CD scripts","description":"Improve CI/CD shell scripts' readability and maintainability by using appropriate shell script patterns. Use heredocs for multiline output generation (especially for YAML configurations) and extract repetitive operations into functions. This approach reduces duplication, makes scripts easier to understand, and simplifies future updates.","repository":"chef/chef","domain":"cloud-infra","topic":"CI/CD","language":"Shell","updated":"2023-01-20","comments":2,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-structure-cicd-scripts.md"},{"slug":"logseq-extract-reusable-hooks","title":"Extract reusable hooks","description":"When you identify React logic that handles complex state management or event handling patterns that could be reused across multiple components, extract it into a custom hook. This promotes code reusability, reduces duplication, and makes components more focused on their primary responsibilities.","repository":"logseq/logseq","domain":"app-frameworks","topic":"React","language":"Other","updated":"2023-01-20","comments":2,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-extract-reusable-hooks.md"},{"slug":"azure-cli-scope-apt-signing-keys","title":"Scope APT Signing Keys","description":"When configuring APT repositories in install scripts, scope trust to a dedicated signing key and avoid deprecated/global keys. Don’t hardcode `amd64`; derive the architecture so the repo source is correct for non-amd64 systems.","repository":"Azure/azure-cli","domain":"cloud-infra","topic":"Security","language":"Shell","updated":"2023-01-19","comments":1,"stars":4592,"raw":"https://awesomereviewers.com/raw/azure-cli-scope-apt-signing-keys.md"},{"slug":"istio-audit-license-dependencies","title":"audit license dependencies","description":"Always verify the licensing compatibility of all dependencies, especially in security-critical networking code. GPL and other restrictive licenses can create legal compliance issues and security vulnerabilities through forced disclosure requirements or usage restrictions.","repository":"istio/istio","domain":"orchestration","topic":"Security","language":"C","updated":"2023-01-17","comments":1,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-audit-license-dependencies.md"},{"slug":"prisma-vet-third-party-actions","title":"vet third-party actions","description":"Before using third-party GitHub Actions or similar external dependencies, thoroughly review their security implications. Specifically: 1) Understand what tokens or credentials they require and how they use them, 2) Verify that permission checks and security features work as expected, 3) Avoid providing unnecessary credentials (like PATs when not required),...","repository":"prisma/prisma","domain":"data-systems","topic":"Security","language":"Yaml","updated":"2023-01-16","comments":1,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-vet-third-party-actions.md"},{"slug":"openai-python-robust-aiohttp-networking","title":"Robust aiohttp Networking","description":"When implementing HTTP/multipart requests and streaming (SSE/chunked) parsing with aiohttp, follow these rules: - Prefer aiohttp’s built-in primitives for multipart bodies (e.g., MultipartWriter) instead of manually encoding file payloads or copying brittle logic from other clients.","repository":"openai/openai-python","domain":"ai-agents","topic":"Networking","language":"Python","updated":"2023-01-12","comments":3,"stars":30731,"raw":"https://awesomereviewers.com/raw/openai-python-robust-aiohttp-networking.md"},{"slug":"deeplearning4j-compare-floating-point-safely","title":"Compare floating-point safely","description":"When implementing numerical algorithms, never compare floating-point values directly for equality due to precision errors. Instead: 1. Use an epsilon threshold for comparisons:","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Algorithms","language":"Java","updated":"2023-01-10","comments":4,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-compare-floating-point-safely.md"},{"slug":"chef-verify-automated-documentation","title":"Verify automated documentation","description":"When using automated tools to generate documentation, always verify the output for accuracy and document any additional manual steps required for completion. Automated documentation can inherit incorrect properties or miss crucial steps in the process.","repository":"chef/chef","domain":"cloud-infra","topic":"Documentation","language":"Markdown","updated":"2023-01-09","comments":2,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-verify-automated-documentation.md"},{"slug":"yoga-standardize-build-configurations","title":"standardize build configurations","description":"Ensure build configurations are consistently propagated through all build steps and output directories follow standardized patterns. This prevents configuration mismatches that can cause deployment issues and makes CI/CD pipelines more reliable.","repository":"facebook/yoga","domain":"runtimes","topic":"CI/CD","language":"Other","updated":"2023-01-08","comments":4,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-standardize-build-configurations.md"},{"slug":"yoga-use-appropriate-ci-toolchains","title":"Use appropriate CI toolchains","description":"Ensure CI/CD workflows use technology-specific setup actions and execute commands in the correct working directories. Avoid using generic or unrelated setup actions that install unnecessary toolchains, as this increases build time and complexity. Always specify the appropriate working directory for technology-specific commands to ensure they execute in the...","repository":"facebook/yoga","domain":"runtimes","topic":"CI/CD","language":"Yaml","updated":"2023-01-07","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-use-appropriate-ci-toolchains.md"},{"slug":"octokit.net-secure-permission-modeling","title":"Secure permission modeling","description":"When implementing security-related models such as permissions, carefully design the properties to prevent unauthorized modifications and maintain appropriate constraints:","repository":"octokit/octokit.net","domain":"devtools","topic":"Security","language":"C#","updated":"2023-01-06","comments":2,"stars":2793,"raw":"https://awesomereviewers.com/raw/octokit.net-secure-permission-modeling.md"},{"slug":"logseq-respect-existing-formatting","title":"Respect existing formatting","description":"When modifying existing files, maintain the formatting and style conventions already established in those files rather than imposing new formatting standards. This includes respecting existing whitespace patterns, indentation styles, and structural formatting choices.","repository":"logseq/logseq","domain":"app-frameworks","topic":"Code Style","language":"Markdown","updated":"2023-01-04","comments":2,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-respect-existing-formatting.md"},{"slug":"tokenizers-flexible-tokenizer-implementation","title":"Flexible tokenizer implementation","description":"When implementing tokenizers for AI models, ensure flexibility and robust behavior across different contexts: 1. Initialize tokenizers with all relevant parameters to maintain consistent behavior:","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"AI","language":"Python","updated":"2022-12-26","comments":2,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-flexible-tokenizer-implementation.md"},{"slug":"yoga-measure-optimization-trade-offs","title":"Measure optimization trade-offs","description":"Always measure and document the impact of performance optimizations before implementing them. When making optimization decisions, quantify the benefits (size reduction, speed improvement) against the costs (build time, code complexity, maintainability).","repository":"facebook/yoga","domain":"runtimes","topic":"Performance Optimization","language":"Other","updated":"2022-12-22","comments":3,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-measure-optimization-trade-offs.md"},{"slug":"kubeflow-precise-workflow-triggers","title":"Precise workflow triggers","description":"Configure CI/CD workflows to trigger precisely based on relevant file path changes. This minimizes unnecessary builds and tests while ensuring all required workflows run when dependencies are modified.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"CI/CD","language":"Yaml","updated":"2022-12-20","comments":7,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-precise-workflow-triggers.md"},{"slug":"logseq-prevent-command-injection-vulnerabilities","title":"Prevent command injection vulnerabilities","description":"When implementing shell command execution or CLI features, prioritize security by avoiding direct shell execution and implementing robust input validation. Simple allow/deny lists for dangerous commands may not provide sufficient protection against command injection attacks.","repository":"logseq/logseq","domain":"app-frameworks","topic":"Security","language":"Other","updated":"2022-12-19","comments":2,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-prevent-command-injection-vulnerabilities.md"},{"slug":"istio-telemetry-consistency-standards","title":"telemetry consistency standards","description":"Ensure telemetry attribute population logic is consistent across all components and follows established standards. When implementing telemetry features like resource attributes, baggage headers, or tracing configurations, use the same business logic and attribute naming conventions throughout the codebase.","repository":"istio/istio","domain":"orchestration","topic":"Observability","language":"Go","updated":"2022-12-16","comments":4,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-telemetry-consistency-standards.md"},{"slug":"kubeflow-standardize-style-scripts","title":"Standardize style scripts","description":"Maintain consistent code style enforcement scripts across all projects by standardizing linting and formatting configurations in package.json. Use modern, supported tools instead of deprecated ones (like tslint).","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Code Style","language":"Json","updated":"2022-12-15","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-standardize-style-scripts.md"},{"slug":"istio-optimize-hot-path-performance","title":"optimize hot path performance","description":"Identify and eliminate expensive operations in frequently executed code paths, particularly in packet processing and network handling contexts. Hot paths are code sections that execute repeatedly at high frequency, where even small performance penalties can significantly impact overall system performance.","repository":"istio/istio","domain":"orchestration","topic":"Performance Optimization","language":"C","updated":"2022-12-09","comments":2,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-optimize-hot-path-performance.md"},{"slug":"logseq-check-undefined-before-use","title":"Check undefined before use","description":"Always verify that values are not undefined before accessing or using them, whether they are object properties or function parameters. This prevents TypeScript compilation errors and potential runtime issues.","repository":"logseq/logseq","domain":"app-frameworks","topic":"Null Handling","language":"TSX","updated":"2022-12-07","comments":2,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-check-undefined-before-use.md"},{"slug":"kubeflow-automate-style-enforcement","title":"Automate style enforcement","description":"Configure your development environment to automatically enforce code style standards rather than relying on manual checks during code review. This includes:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Code Style","language":"Yaml","updated":"2022-12-05","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-automate-style-enforcement.md"},{"slug":"azure-sentinel-externalize-sensitive-identifiers","title":"Externalize sensitive identifiers","description":"Do not hardcode subscription/workspace/tenant/customer identifiers in scripts or source code—even if they’re not “secrets.” These are identifying information that can leak via logs, UI, demos, screenshots, or reviews. Pass them in via parameters or configuration (env vars, secure pipeline variables, secret stores) and avoid echoing them.","repository":"Azure/Azure-Sentinel","domain":"cloud-infra","topic":"Security","language":"Other","updated":"2022-12-05","comments":1,"stars":6042,"raw":"https://awesomereviewers.com/raw/azure-sentinel-externalize-sensitive-identifiers.md"},{"slug":"nest-structure-behavior-driven-tests-properly","title":"Structure behavior-driven tests properly","description":"Organize tests using behavior-driven development (BDD) patterns to improve clarity and maintainability. Group related tests using descriptive `describe` blocks for methods/scenarios, and write clear test cases that focus on testing behavior rather than implementation details.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Testing","language":"TypeScript","updated":"2022-12-01","comments":6,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-structure-behavior-driven-tests-properly.md"},{"slug":"nest-avoid-testing-anti-patterns","title":"Avoid testing anti-patterns","description":"Ensure your tests actually validate functionality by avoiding common testing anti-patterns: 1. **Don''t mock what you''re testing** - When testing a method, don''t mock its implementation as this tests nothing meaningful:","repository":"nestjs/nest","domain":"app-frameworks","topic":"Testing","language":"TypeScript","updated":"2022-12-01","comments":5,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-avoid-testing-anti-patterns.md"},{"slug":"cypress-explain-non-obvious-code","title":"Explain non-obvious code","description":"Add explanatory comments for complex logic, workarounds, and non-obvious code patterns to help future maintainers understand the reasoning behind implementation decisions. Include links to external resources like GitHub issues, documentation, or source materials when relevant.","repository":"cypress-io/cypress","domain":"devtools","topic":"Documentation","language":"TypeScript","updated":"2022-11-30","comments":5,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-explain-non-obvious-code.md"},{"slug":"cypress-informative-error-messages","title":"Informative error messages","description":"Error messages should be informative and include the actual values that caused the problem, not just generic descriptions. Use centralized error message utilities and ensure both the message and stack trace are properly updated.","repository":"cypress-io/cypress","domain":"devtools","topic":"Error Handling","language":"TypeScript","updated":"2022-11-30","comments":3,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-informative-error-messages.md"},{"slug":"cypress-test-version-compatibility","title":"Test version compatibility","description":"When testing across different versions of dependencies, proactively address version compatibility issues to prevent compilation failures and ensure proper behavior validation. Use mocking or stubbing techniques to resolve dependency conflicts, and explicitly test version-specific behaviors including error messages.","repository":"cypress-io/cypress","domain":"devtools","topic":"Testing","language":"JSX","updated":"2022-11-30","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-test-version-compatibility.md"},{"slug":"kubeflow-descriptive-consistent-naming","title":"Descriptive consistent naming","description":"Use descriptive and consistent names throughout the codebase. Prefer full, meaningful names over acronyms or abbreviations to improve readability and understanding, especially for newcomers. Maintain naming consistency across different files, configurations, and references to the same entity.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Naming Conventions","language":"Other","updated":"2022-11-30","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-descriptive-consistent-naming.md"},{"slug":"sentry-php-minimize-file-memory-footprint","title":"Minimize file memory footprint","description":"When handling files in your application, minimize memory usage to optimize performance. Follow these guidelines: 1. **Avoid multiple reads**: Read file content only once and reuse it throughout your code. Each read operation loads the entire file into memory.","repository":"getsentry/sentry-php","domain":"observability","topic":"Performance Optimization","language":"PHP","updated":"2022-11-29","comments":3,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-minimize-file-memory-footprint.md"},{"slug":"kubeflow-specific-network-access-documentation","title":"Specific network access documentation","description":"When documenting network access methods or service connections, always provide specific commands with explicit ports and namespaces rather than general approaches. Include clear examples of how to connect to each required service and explain the underlying proxying mechanisms.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Networking","language":"Markdown","updated":"2022-11-23","comments":3,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-specific-network-access-documentation.md"},{"slug":"deno-prevent-prototype-pollution","title":"prevent prototype pollution","description":"When implementing security measures around JavaScript's `__proto__` property, disable the setter to prevent prototype pollution attacks while carefully considering whether getter access is needed for compatibility. Prototype pollution occurs when attackers can modify Object.prototype, potentially affecting all objects in the application.","repository":"denoland/deno","domain":"runtimes","topic":"Security","language":"JavaScript","updated":"2022-11-23","comments":2,"stars":103714,"raw":"https://awesomereviewers.com/raw/deno-prevent-prototype-pollution.md"},{"slug":"kubeflow-optimize-container-build-configurations","title":"Optimize container build configurations","description":"Configure containerized application builds to be efficient and flexible by avoiding hardcoded architecture decisions and using appropriate compiler flags. Let the build system determine architecture targeting instead of maintaining architecture-specific code blocks in your Dockerfiles. For Go applications, use appropriate build flags like `CGO_ENABLED=0` to...","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"CI/CD","language":"Dockerfile","updated":"2022-11-23","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-optimize-container-build-configurations.md"},{"slug":"istio-api-version-compatibility-first","title":"API version compatibility first","description":"When selecting API versions, prioritize compatibility over using the latest available version. Choose older, stable API versions when they provide the same schema but broader compatibility across Kubernetes versions. This approach minimizes breaking changes for users and reduces deployment friction.","repository":"istio/istio","domain":"orchestration","topic":"API","language":"Yaml","updated":"2022-11-22","comments":4,"stars":37192,"raw":"https://awesomereviewers.com/raw/istio-api-version-compatibility-first.md"},{"slug":"compose-maintain-documentation-consistency","title":"Maintain documentation consistency","description":"Ensure consistent terminology, precise language, and uniform formatting throughout all documentation to improve clarity and user experience. Use standardized terms consistently (e.g., \"V1\" and \"V2\" not \"v1\" and \"v2\"), choose precise wording that clearly conveys intent, and maintain consistent formatting patterns.","repository":"docker/compose","domain":"orchestration","topic":"Documentation","language":"Markdown","updated":"2022-11-21","comments":3,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-maintain-documentation-consistency.md"},{"slug":"kubeflow-validate-model-optimization","title":"Validate model optimization","description":"When implementing AI model optimization techniques such as early stopping algorithms or hyperparameter tuning, include proper validation mechanisms to help users effectively reduce model overfitting and improve accuracy.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"AI","language":"Markdown","updated":"2022-11-17","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-validate-model-optimization.md"},{"slug":"nest-prevent-race-conditions","title":"Prevent race conditions","description":"When handling concurrent operations in asynchronous environments, avoid mutating shared state that could lead to race conditions. Instead, create operation-specific state or use immutable patterns to ensure each request path has isolated context.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Concurrency","language":"TypeScript","updated":"2022-11-09","comments":3,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-prevent-race-conditions.md"},{"slug":"aws-sdk-js-semantic-naming-conventions","title":"Semantic naming conventions","description":"Use descriptive, semantic names for all code elements that clearly indicate their purpose and behavior. Follow consistent casing patterns throughout the codebase:","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Naming Conventions","language":"JavaScript","updated":"2022-11-03","comments":6,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-semantic-naming-conventions.md"},{"slug":"zod-define-equality-semantics","title":"Define Equality Semantics","description":"Ensure algorithmic helpers that use data structures (e.g., deep equality, key intersections) have an explicit correctness contract and are implemented with runtime-compatible structures.","repository":"colinhacks/zod","domain":"app-frameworks","topic":"Algorithms","language":"TypeScript","updated":"2022-11-02","comments":3,"stars":42628,"raw":"https://awesomereviewers.com/raw/zod-define-equality-semantics.md"},{"slug":"cypress-function-decomposition-clarity","title":"function decomposition clarity","description":"Functions should be focused, concise, and easy to understand. Break down large functions (>100 lines) into smaller, well-named functions that each handle a single responsibility. Remove unused parameters to reduce cognitive load and prevent confusion. Prefer functional programming patterns like `.some()`, `.map()`, and `.filter()` over imperative loops when...","repository":"cypress-io/cypress","domain":"devtools","topic":"Code Style","language":"TypeScript","updated":"2022-10-28","comments":6,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-function-decomposition-clarity.md"},{"slug":"nest-follow-protocol-standards","title":"Follow protocol standards","description":"When implementing networking features, strictly adhere to protocol specifications and standards to ensure proper interoperability. This applies to HTTP headers, status codes, and protocol-specific connection handling.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Networking","language":"TypeScript","updated":"2022-10-24","comments":6,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-follow-protocol-standards.md"},{"slug":"tree-sitter-automate-frequent-releases","title":"automate frequent releases","description":"Implement automated release workflows to publish updates frequently and consistently across all distribution channels. Manual release processes create bottlenecks that force consumers to pin dependencies to specific commit SHAs instead of using stable releases.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"CI/CD","language":"Markdown","updated":"2022-10-19","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-automate-frequent-releases.md"},{"slug":"go-use-proper-network-constants","title":"Use proper network constants","description":"When writing network-related code, always use named constants from system packages instead of magic numbers, and ensure complete protocol implementation. This includes using proper constants for network operations (like `windows.IfOperStatusUp` instead of `0x01`), calculating buffer sizes correctly with system functions (like `syscall.CmsgSpace(4)` for file...","repository":"golang/go","domain":"runtimes","topic":"Networking","language":"Go","updated":"2022-10-17","comments":6,"stars":129599,"raw":"https://awesomereviewers.com/raw/go-use-proper-network-constants.md"},{"slug":"kubeflow-prefer-external-configuration","title":"Prefer external configuration","description":"Design applications to use external configuration sources rather than hardcoding values directly in source code. This allows for configuration changes without requiring code modifications or redeployment.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Configurations","language":"JavaScript","updated":"2022-10-17","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-prefer-external-configuration.md"},{"slug":"yoga-enforce-style-in-ci","title":"Enforce style in CI","description":"Configure automated formatting tools in CI/CD pipelines to enforce code style standards rather than silently fix violations. Use validation flags that cause the build to fail when formatting issues are detected, and ensure all commands run non-interactively.","repository":"facebook/yoga","domain":"runtimes","topic":"Code Style","language":"Yaml","updated":"2022-10-14","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-enforce-style-in-ci.md"},{"slug":"cli-api-interface-design","title":"API interface design","description":"Design interfaces that balance simplicity with extensibility. Consolidate related parameters into cohesive data structures to reduce interface complexity, while using interfaces to enable future implementations and maintain flexibility.","repository":"snyk/cli","domain":"security","topic":"API","language":"Go","updated":"2022-10-13","comments":2,"stars":5178,"raw":"https://awesomereviewers.com/raw/cli-api-interface-design.md"},{"slug":"logseq-strategic-dependency-versioning","title":"Strategic dependency versioning","description":"Use strategic versioning approaches for dependencies based on their impact and maintenance status. Pin exact versions for dependencies that inject global styles, configurations, or behaviors to prevent unintended breaking changes during automatic updates. For unmaintained dependencies, evaluate alternatives or consider forking if there are useful pending...","repository":"logseq/logseq","domain":"app-frameworks","topic":"Configurations","language":"Json","updated":"2022-10-12","comments":2,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-strategic-dependency-versioning.md"},{"slug":"tokenizers-robust-workflow-configurations","title":"Robust workflow configurations","description":"Ensure CI/CD workflow configuration files follow best practices for maintainability and correctness: 1. Use centralized dependency management approaches like setup tools extras instead of hardcoding dependencies in workflow files:","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"Configurations","language":"Yaml","updated":"2022-10-05","comments":2,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-robust-workflow-configurations.md"},{"slug":"yoga-evaluate-synchronization-necessity","title":"Evaluate synchronization necessity","description":"Before implementing thread safety mechanisms like atomic operations or mutexes for global variables, critically assess whether perfect synchronization is actually required for program correctness. Consider the performance cost of synchronization against the importance of data accuracy.","repository":"facebook/yoga","domain":"runtimes","topic":"Concurrency","language":"C++","updated":"2022-10-03","comments":4,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-evaluate-synchronization-necessity.md"},{"slug":"yoga-design-familiar-apis","title":"Design familiar APIs","description":"Design APIs that align with platform conventions and user expectations rather than creating novel patterns. APIs should feel natural to developers already familiar with the target platform's idioms and established libraries.","repository":"facebook/yoga","domain":"runtimes","topic":"API","language":"Other","updated":"2022-10-03","comments":3,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-design-familiar-apis.md"},{"slug":"poetry-add-missing-code-documentation","title":"Add missing code documentation","description":"Ensure all methods have docstrings and complex logic includes explanatory comments to help contributors understand code intent and functionality. Missing documentation creates barriers for new contributors and makes code maintenance more difficult.","repository":"python-poetry/poetry","domain":"devtools","topic":"Documentation","language":"Python","updated":"2022-10-02","comments":2,"stars":33496,"raw":"https://awesomereviewers.com/raw/poetry-add-missing-code-documentation.md"},{"slug":"compose-avoid-hardcoded-configuration-values","title":"Avoid hardcoded configuration values","description":"Configuration values should be parameterized rather than hardcoded in scripts and tools. Hardcoded values make code less reusable and require manual updates when used in different contexts or projects.","repository":"docker/compose","domain":"orchestration","topic":"Configurations","language":"Shell","updated":"2022-09-27","comments":2,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-avoid-hardcoded-configuration-values.md"},{"slug":"sonic-maintain-consistent-formatting","title":"Maintain consistent formatting","description":"Ensure all code follows the established project formatting standards consistently across the codebase. This includes adhering to specific indentation rules, import statement formatting, and other style conventions defined for the project. When contributing code, always match the existing formatting patterns rather than introducing inconsistencies.","repository":"bytedance/sonic","domain":"runtimes","topic":"Code Style","language":"Go","updated":"2022-09-27","comments":2,"stars":8532,"raw":"https://awesomereviewers.com/raw/sonic-maintain-consistent-formatting.md"},{"slug":"sentry-php-split-for-better-readability","title":"Split for better readability","description":"Break long lines and complex structures across multiple lines to improve code readability. Follow these guidelines: 1. Keep line length around 80 characters (soft limit)","repository":"getsentry/sentry-php","domain":"observability","topic":"Code Style","language":"PHP","updated":"2022-09-26","comments":11,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-split-for-better-readability.md"},{"slug":"logseq-tailwind-configuration-patterns","title":"Tailwind configuration patterns","description":"Follow Tailwind CSS's recommended configuration patterns to ensure proper functionality and JIT mode compatibility. Use the `theme.extend` object for custom values like font sizes, implement plugin functions for advanced customizations like CSS variable exposure, and explicitly safelist dynamic classes when regex patterns are incompatible with JIT mode.","repository":"logseq/logseq","domain":"app-frameworks","topic":"Configurations","language":"JavaScript","updated":"2022-09-26","comments":3,"stars":37695,"raw":"https://awesomereviewers.com/raw/logseq-tailwind-configuration-patterns.md"},{"slug":"sentry-php-descriptive-identifier-naming","title":"Descriptive identifier naming","description":"Choose meaningful, self-explanatory names for variables, parameters, properties, and methods that clearly convey their purpose. Avoid abbreviations and acronyms unless they're widely understood industry standards.","repository":"getsentry/sentry-php","domain":"observability","topic":"Naming Conventions","language":"PHP","updated":"2022-09-23","comments":9,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-descriptive-identifier-naming.md"},{"slug":"compose-isolate-test-dependencies","title":"Isolate test dependencies","description":"Keep test dependencies separate from production code dependencies to avoid polluting the main module. Use separate modules for test code when test-specific dependencies would otherwise be included in the main module's dependency tree.","repository":"docker/compose","domain":"orchestration","topic":"Testing","language":"Other","updated":"2022-09-23","comments":2,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-isolate-test-dependencies.md"},{"slug":"azure-quickstart-templates-maintainable-documentation-standards","title":"Maintainable Documentation Standards","description":"Keep template READMEs technically correct, GitHub-renderable, and maintainable. - Use markdown syntax that GitHub will render (avoid docs.microsoft.com-only constructs like `[!TIP]`; if needed, replace with standard headings/blockquote/correct GitHub-compatible callouts).","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Documentation","language":"Markdown","updated":"2022-09-22","comments":5,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-maintainable-documentation-standards.md"},{"slug":"esbuild-maintain-api-compatibility","title":"maintain API compatibility","description":"When implementing or extending APIs, preserve compatibility with existing standards and expected behaviors. APIs should maintain the same contracts, interfaces, and behavioral patterns as the systems they emulate or replace.","repository":"evanw/esbuild","domain":"devtools","topic":"API","language":"Go","updated":"2022-09-19","comments":5,"stars":39161,"raw":"https://awesomereviewers.com/raw/esbuild-maintain-api-compatibility.md"},{"slug":"mxnet-consistent-logging-format","title":"Consistent logging format","description":"Use consistent string formatting in logging statements throughout the codebase. Prefer `%` style placeholders over f-strings or `.format()` in logging calls as this is more efficient when logs are filtered by level (placeholders are only evaluated if the log is actually emitted).","repository":"apache/mxnet","domain":"ml-systems","topic":"Logging","language":"Python","updated":"2022-09-12","comments":3,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-consistent-logging-format.md"},{"slug":"turborepo-consider-config-generation-methods","title":"Consider config generation methods","description":"When implementing code to handle configuration files like lockfiles or environment settings, carefully consider the trade-offs between direct serialization and template-based approaches. While direct serialization from data structures is often simpler and less error-prone, template-based generation may provide better control over formatting, whitespace...","repository":"vercel/turborepo","domain":"devtools","topic":"Configurations","language":"Go","updated":"2022-09-09","comments":2,"stars":28115,"raw":"https://awesomereviewers.com/raw/turborepo-consider-config-generation-methods.md"},{"slug":"celery-prefer-safe-serialization","title":"Prefer safe serialization","description":"Avoid `pickle` unless you have a documented, justified need and you can guarantee the serialized data never comes from untrusted sources. Prefer safe, data-only formats (e.g., JSON) for serialization/deserialization in tests and production code.","repository":"celery/celery","domain":"orchestration","topic":"Security","language":"Python","updated":"2022-09-05","comments":1,"stars":28464,"raw":"https://awesomereviewers.com/raw/celery-prefer-safe-serialization.md"},{"slug":"kubeflow-use-table-driven-tests","title":"Use table-driven tests","description":"In Go, prefer table-driven tests over multiple separate test functions. Table tests allow for concise testing of multiple scenarios, improve code readability, and make it easier to add new test cases.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Testing","language":"Go","updated":"2022-08-30","comments":3,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-use-table-driven-tests.md"},{"slug":"kubeflow-simplify-code-structure","title":"Simplify code structure","description":"Strive to simplify code structure by eliminating unnecessary complexity. This includes: 1. **Move conditions higher in the code** when appropriate to avoid unnecessary operations. Check conditions as early as possible to fail fast or skip work.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Code Style","language":"Go","updated":"2022-08-29","comments":7,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-simplify-code-structure.md"},{"slug":"kubeflow-check-before-use","title":"Check before use","description":"Always validate that objects, maps, and other reference types are non-nil before attempting to use them. Use early nil checks with clear returns to improve code readability and prevent null pointer exceptions.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Null Handling","language":"Go","updated":"2022-08-29","comments":3,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-check-before-use.md"},{"slug":"redis-control-plane-connectivity-rules","title":"Control-plane connectivity rules","description":"Define a single, deterministic networking contract between data-plane nodes and the control plane (TD/FC), and make it resilient to CP reachability and multi-FC state consistency.","repository":"redis/redis","domain":"data-systems","topic":"Networking","language":"Markdown","updated":"2022-08-29","comments":3,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-control-plane-connectivity-rules.md"},{"slug":"mxnet-technical-precision-matters","title":"Technical precision matters","description":"When documenting AI models, frameworks, and optimization techniques, precision in language is as important as precision in your algorithms. Technical inaccuracies or unclear explanations can lead to implementation errors and confusion.","repository":"apache/mxnet","domain":"ml-systems","topic":"AI","language":"Markdown","updated":"2022-08-25","comments":8,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-technical-precision-matters.md"},{"slug":"mxnet-simplify-for-readability","title":"Simplify for readability","description":"Complex expressions, especially nested ternary operations, reduce code readability and maintainability. Prefer simpler alternatives: 1. Break down nested ternary operations into clear if-else statements:","repository":"apache/mxnet","domain":"ml-systems","topic":"Code Style","language":"Other","updated":"2022-08-25","comments":7,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-simplify-for-readability.md"},{"slug":"mxnet-explain-optimization-mechanisms","title":"Explain optimization mechanisms","description":"When implementing or documenting performance optimizations, clearly explain the mechanism and expected performance benefit. For memory-bound optimizations, specify exactly how memory operations are reduced:","repository":"apache/mxnet","domain":"ml-systems","topic":"Performance Optimization","language":"Markdown","updated":"2022-08-25","comments":5,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-explain-optimization-mechanisms.md"},{"slug":"mxnet-pre-compute-reused-data","title":"Pre-compute reused data","description":"When data will be accessed multiple times during processing, avoid redundant calculations by pre-computing values upfront rather than using lazy evaluation. This pattern significantly improves performance in iterative operations like machine learning training, inference, or repeated data transformations.","repository":"apache/mxnet","domain":"ml-systems","topic":"Performance Optimization","language":"Python","updated":"2022-08-25","comments":2,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-pre-compute-reused-data.md"},{"slug":"compose-avoid-variable-name-conflicts","title":"Avoid variable name conflicts","description":"Choose variable names that prevent conflicts with system variables, external tools, and variables in overlapping scopes. Use prefixes or distinct naming to differentiate purpose and avoid unintended overrides.","repository":"docker/compose","domain":"orchestration","topic":"Naming Conventions","language":"Other","updated":"2022-08-23","comments":2,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-avoid-variable-name-conflicts.md"},{"slug":"octokit.net-use-appropriate-framework-targets","title":"Use appropriate framework targets","description":"When configuring .NET projects, always use the correct target framework elements and versions: 1. Use the singular `<TargetFramework>` element when targeting a single framework:","repository":"octokit/octokit.net","domain":"devtools","topic":"Configurations","language":"Other","updated":"2022-08-10","comments":2,"stars":2793,"raw":"https://awesomereviewers.com/raw/octokit.net-use-appropriate-framework-targets.md"},{"slug":"fastapi-proper-http-status-codes","title":"Proper HTTP status codes","description":"When implementing authentication and authorization systems, use semantically correct HTTP status codes to accurately convey the nature of security-related failures. This improves API security by providing accurate information to clients without exposing unnecessary details.","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Security","language":"Python","updated":"2022-08-03","comments":4,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-proper-http-status-codes.md"},{"slug":"ncnn-reliable-technical-documentation","title":"Reliable Technical Documentation","description":"When updating technical docs, ensure they are reliable in both what they claim and how developers can apply them: - Keep headings/sections aligned with the exact runtime/build parameters shown in outputs (e.g., if the benchmark runs with gpu_device=0, reflect “GPU0” in the subsection title).","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Documentation","language":"Markdown","updated":"2022-08-03","comments":4,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-reliable-technical-documentation.md"},{"slug":"chef-clear-abstraction-boundaries","title":"Clear abstraction boundaries","description":"Design APIs with clear and consistent abstraction boundaries to maintain\\ \\ code quality and prevent interface leakage between different system layers. \\n","repository":"chef/chef","domain":"cloud-infra","topic":"API","language":"Ruby","updated":"2022-08-02","comments":3,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-clear-abstraction-boundaries.md"},{"slug":"ncnn-config-contract-enforcement","title":"Config Contract Enforcement","description":"When introducing or updating environment/configuration behavior, ensure the documented meaning, runtime inputs (CLI/feature flags), and build-time discovery (CMake/pkg paths) all point to the same intended target. Avoid “it compiles” success that doesn’t enable the feature, and avoid “it builds” that accidentally links against a mismatched dependency set.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Configurations","language":"Markdown","updated":"2022-08-02","comments":2,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-config-contract-enforcement.md"},{"slug":"kotlin-minimize-not-null-assertions","title":"Minimize not-null assertions","description":"Avoid using not-null assertions (`!!`) when safer alternatives exist. Instead: 1. Use safe calls (`?.`) when accessing properties or methods on nullable references","repository":"JetBrains/kotlin","domain":"runtimes","topic":"Null Handling","language":"Java","updated":"2022-07-21","comments":2,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-minimize-not-null-assertions.md"},{"slug":"redis-required-api-partitioning","title":"Required API Partitioning","description":"When designing cluster APIs/specs, explicitly partition endpoints into categories by *actor* and *compatibility obligation*, and document which categories alternative implementations must implement.","repository":"redis/redis","domain":"data-systems","topic":"API","language":"Markdown","updated":"2022-07-20","comments":4,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-required-api-partitioning.md"},{"slug":"redis-define-non-ack-behavior","title":"Define Non-Ack Behavior","description":"For any control-plane action that depends on acknowledgement (epochs/status updates, joins/removes, metadata propagation), the codebase must explicitly define end-to-end error handling: timeout, retry/escalation, cascade effects, and the operator override path.","repository":"redis/redis","domain":"data-systems","topic":"Error Handling","language":"Markdown","updated":"2022-07-18","comments":3,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-define-non-ack-behavior.md"},{"slug":"redis-evidence-based-failover-targets","title":"Evidence-Based Failover Targets","description":"When proposing performance/SLA goals (e.g., failover completion time), require an evidence-based rationale and a repeatable way to validate them—especially for worst-case behavior.","repository":"redis/redis","domain":"data-systems","topic":"Performance Optimization","language":"Markdown","updated":"2022-07-16","comments":2,"stars":74261,"raw":"https://awesomereviewers.com/raw/redis-evidence-based-failover-targets.md"},{"slug":"mxnet-use-intent-revealing-names","title":"Use intent-revealing names","description":"Choose names that clearly reveal the purpose, behavior, or type of the code elements they represent. A good name should answer \"what\" rather than \"how\" and should be precise enough to avoid ambiguity.","repository":"apache/mxnet","domain":"ml-systems","topic":"Naming Conventions","language":"Other","updated":"2022-07-15","comments":5,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-use-intent-revealing-names.md"},{"slug":"kubeflow-pin-version-dependencies","title":"Pin version dependencies","description":"Explicitly pin version dependencies in configuration files to ensure reproducible builds and prevent breaking changes. When dealing with external tools, scripts, or APIs, always specify exact versions or commit hashes rather than using \"latest\" or master branches.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Configurations","language":"Other","updated":"2022-07-14","comments":4,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-pin-version-dependencies.md"},{"slug":"mxnet-documentation-clarity-and-formatting","title":"Documentation clarity and formatting","description":"When writing documentation (README files, tutorials, API docs), ensure clarity and proper formatting: 1. **Define technical terms and concepts** - Don''t assume readers are familiar with specialized terminology. Include brief explanations and relevant links for reference.","repository":"apache/mxnet","domain":"ml-systems","topic":"Documentation","language":"Markdown","updated":"2022-07-08","comments":3,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-documentation-clarity-and-formatting.md"},{"slug":"octokit.net-catch-specific-exceptions","title":"Catch specific exceptions","description":"Always catch specific exception types rather than using general catch blocks. This improves error handling precision, enables targeted recovery strategies, and maintains consistency across your codebase.","repository":"octokit/octokit.net","domain":"devtools","topic":"Error Handling","language":"C#","updated":"2022-07-06","comments":4,"stars":2793,"raw":"https://awesomereviewers.com/raw/octokit.net-catch-specific-exceptions.md"},{"slug":"esbuild-verify-platform-network-compatibility","title":"verify platform network compatibility","description":"When adding support for new platforms or architectures, thoroughly verify that networking functionality works correctly across different runtime environments and build configurations. This includes validating Go version requirements, cross-compilation toolchain compatibility, and runtime behavior differences.","repository":"evanw/esbuild","domain":"devtools","topic":"Networking","language":"Other","updated":"2022-07-06","comments":3,"stars":39161,"raw":"https://awesomereviewers.com/raw/esbuild-verify-platform-network-compatibility.md"},{"slug":"express-clear-intention-in-names","title":"Clear intention in names","description":"Choose names that clearly communicate intention and follow established conventions. This applies to variables, functions, methods, and architectural components.","repository":"expressjs/express","domain":"app-frameworks","topic":"Naming Conventions","language":"JavaScript","updated":"2022-07-04","comments":7,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-clear-intention-in-names.md"},{"slug":"alacritty-user-friendly-network-descriptions","title":"User-friendly network descriptions","description":"When documenting network-related features like URL handling, hyperlinks, or web protocols, prioritize user-understandable descriptions over technical implementation details. Users care about what functionality they gain, not the internal mechanics of how it works.","repository":"alacritty/alacritty","domain":"devtools","topic":"Networking","language":"Markdown","updated":"2022-07-04","comments":2,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-user-friendly-network-descriptions.md"},{"slug":"openai-python-azure-ad-token-responsibility","title":"Azure AD token responsibility","description":"When adding Azure Active Directory authentication (Security), make token acquisition and dependency responsibility explicit and align it with your SDK’s lifecycle.","repository":"openai/openai-python","domain":"ai-agents","topic":"Security","language":"Markdown","updated":"2022-06-23","comments":2,"stars":30731,"raw":"https://awesomereviewers.com/raw/openai-python-azure-ad-token-responsibility.md"},{"slug":"compose-use-organizational-secrets","title":"Use organizational secrets","description":"When working with GitHub Actions workflows that require shared credentials or tokens, leverage organizational-level secrets instead of duplicating them across individual repositories. This approach centralizes secret management, reduces the attack surface, and simplifies maintenance.","repository":"docker/compose","domain":"orchestration","topic":"Security","language":"Yaml","updated":"2022-06-21","comments":1,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-use-organizational-secrets.md"},{"slug":"serverless-maintain-proper-formatting","title":"maintain proper formatting","description":"Ensure code and configuration files follow proper formatting standards that maintain both syntactic validity and visual readability. This includes correct indentation for nested structures and appropriate line length management to prevent horizontal scrolling.","repository":"serverless/serverless","domain":"cloud-infra","topic":"Code Style","language":"Markdown","updated":"2022-06-13","comments":2,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-maintain-proper-formatting.md"},{"slug":"sentry-php-precise-dependency-versioning","title":"Precise dependency versioning","description":"When specifying dependency version constraints in configuration files, be deliberate about minimum versions based on required features and compatibility requirements. Use the lowest compatible version constraint to maximize project compatibility, but ensure specific feature requirements are met.","repository":"getsentry/sentry-php","domain":"observability","topic":"Configurations","language":"Json","updated":"2022-05-25","comments":4,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-precise-dependency-versioning.md"},{"slug":"prisma-accurate-method-descriptions","title":"Accurate method descriptions","description":"API documentation must precisely describe method behavior, especially return values and cardinality. Inaccurate descriptions mislead developers about what methods actually return, potentially causing runtime errors or incorrect assumptions.","repository":"prisma/prisma","domain":"data-systems","topic":"Documentation","language":"TypeScript","updated":"2022-05-23","comments":2,"stars":42967,"raw":"https://awesomereviewers.com/raw/prisma-accurate-method-descriptions.md"},{"slug":"compose-avoid-ci-resource-conflicts","title":"avoid CI resource conflicts","description":"Design CI workflows to prevent resource conflicts when multiple builds run concurrently on shared infrastructure. This includes using unique identifiers for temporary resources, minimizing container privileges, and separating CI-specific operations from local development workflows.","repository":"docker/compose","domain":"orchestration","topic":"CI/CD","language":"Other","updated":"2022-05-19","comments":3,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-avoid-ci-resource-conflicts.md"},{"slug":"sentry-php-optimize-regex-patterns","title":"Optimize regex patterns","description":"When using regular expressions, optimize for both performance and precision to ensure efficient and accurate pattern matching: 1. **Use non-capturing groups** when you don''t need to reference the matched content, reducing memory allocations:","repository":"getsentry/sentry-php","domain":"observability","topic":"Algorithms","language":"PHP","updated":"2022-05-15","comments":14,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-optimize-regex-patterns.md"},{"slug":"sentry-php-document-configuration-comprehensively","title":"Document configuration comprehensively","description":"When adding or modifying configuration options, ensure they are documented with complete context. Group related changes together (like deprecation and default value changes), include reference numbers, and explain the purpose and effect of configuration options. This helps users understand how to properly configure the system without confusion.","repository":"getsentry/sentry-php","domain":"observability","topic":"Configurations","language":"Markdown","updated":"2022-05-11","comments":2,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-document-configuration-comprehensively.md"},{"slug":"deeplearning4j-descriptive-error-context","title":"Descriptive error context","description":"Error messages should be specific, descriptive, and include context to help with debugging. Avoid generic messages like \"Failed execution\" or numeric error codes without explanation.","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Error Handling","language":"C++","updated":"2022-05-03","comments":5,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-descriptive-error-context.md"},{"slug":"core-comprehensive-error-handling","title":"comprehensive error handling","description":"Ensure error handling mechanisms are comprehensive and graceful rather than limited or forceful. Use persistent event listeners (`process.on()`) instead of one-time listeners (`process.once()`) for critical error scenarios to handle all occurrences, not just the first one. Similarly, prefer graceful shutdown methods that allow proper cleanup over forceful...","repository":"adonisjs/core","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"2022-05-02","comments":2,"stars":18071,"raw":"https://awesomereviewers.com/raw/core-comprehensive-error-handling.md"},{"slug":"octokit.net-maintain-consistent-style","title":"Maintain consistent style","description":"Follow established patterns consistently throughout the codebase to improve readability and maintainability: 1. **Use auto properties with appropriate access modifiers**:","repository":"octokit/octokit.net","domain":"devtools","topic":"Code Style","language":"C#","updated":"2022-04-20","comments":7,"stars":2793,"raw":"https://awesomereviewers.com/raw/octokit.net-maintain-consistent-style.md"},{"slug":"esbuild-algorithm-selection-correctness","title":"Algorithm selection correctness","description":"Choose algorithms that correctly match the problem requirements and understand their computational properties and side effects. Avoid using overly general solutions (like regex) when simpler, more precise algorithms exist.","repository":"evanw/esbuild","domain":"devtools","topic":"Algorithms","language":"Go","updated":"2022-04-19","comments":4,"stars":39161,"raw":"https://awesomereviewers.com/raw/esbuild-algorithm-selection-correctness.md"},{"slug":"mxnet-explicit-null-checks","title":"Explicit null checks","description":"Always use explicit null checks (`value is None` or `value is not None`) rather than implicit truthiness evaluations when testing for null/None values. Implicit boolean checks can invoke `__bool__` methods leading to unexpected behavior.","repository":"apache/mxnet","domain":"ml-systems","topic":"Null Handling","language":"Python","updated":"2022-04-19","comments":4,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-explicit-null-checks.md"},{"slug":"serverless-maintain-naming-consistency","title":"maintain naming consistency","description":"Ensure consistent naming patterns across related components and configurations. When naming properties, methods, or identifiers that relate to the same concept, use the same form (singular/plural, casing, terminology) throughout the codebase.","repository":"serverless/serverless","domain":"cloud-infra","topic":"Naming Conventions","language":"Markdown","updated":"2022-04-19","comments":2,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-maintain-naming-consistency.md"},{"slug":"prettier-vue-syntax-parsing-robustness","title":"Vue syntax parsing robustness","description":"When processing Vue components, ensure parsing logic handles edge cases correctly and selects appropriate parsers safely. This includes proper validation of directive syntax and careful parser selection based on explicit language declarations.","repository":"prettier/prettier","domain":"devtools","topic":"Vue","language":"JavaScript","updated":"2022-04-16","comments":2,"stars":50772,"raw":"https://awesomereviewers.com/raw/prettier-vue-syntax-parsing-robustness.md"},{"slug":"cypress-use-descriptive-testing-names","title":"Use descriptive testing names","description":"Ensure all testing-related identifiers, scripts, and messages use clear, descriptive names rather than abbreviations or overly specific terminology. This improves maintainability and reduces confusion for both developers and users.","repository":"cypress-io/cypress","domain":"devtools","topic":"Testing","language":"Json","updated":"2022-04-14","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-use-descriptive-testing-names.md"},{"slug":"deeplearning4j-validate-and-document-nulls","title":"Validate and document nulls","description":"Always handle null values explicitly and consistently throughout your codebase to prevent null pointer exceptions. Follow these guidelines: 1. **Validate nulls early** using Preconditions to provide clear error messages:","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Null Handling","language":"Java","updated":"2022-04-10","comments":6,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-validate-and-document-nulls.md"},{"slug":"mxnet-document-all-parameters","title":"Document all parameters","description":"Always provide complete and accurate documentation for all function parameters, especially when adding new ones. Each parameter should have a clear description that explains its purpose, expected values, and behavior.","repository":"apache/mxnet","domain":"ml-systems","topic":"Documentation","language":"Other","updated":"2022-04-08","comments":5,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-document-all-parameters.md"},{"slug":"vite-use-optional-patterns","title":"Use optional patterns","description":"Choose the most appropriate pattern for handling potentially undefined or null values. When designing types, prefer optional properties (`?:`) over nullable types (`| null`) when a value is conceptually \"not yet computed\" rather than explicitly null.","repository":"vitejs/vite","domain":"devtools","topic":"Null Handling","language":"TypeScript","updated":"2022-04-01","comments":4,"stars":74031,"raw":"https://awesomereviewers.com/raw/vite-use-optional-patterns.md"},{"slug":"azure-quickstart-templates-test-template-defaults","title":"Test template defaults","description":"When testing a template’s behavior, avoid overriding it with explicit parameter values. Remove parameter values from the parameters file so the template’s `defaultValue(s)` are used, ensuring the default-path is actually exercised.","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Testing","language":"Json","updated":"2022-03-28","comments":2,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-test-template-defaults.md"},{"slug":"tokenizers-thread-safe-resource-sharing","title":"Thread-safe resource sharing","description":"When sharing mutable data between threads, use the `Arc<RwLock<T>>` pattern to ensure thread safety. `Arc` provides thread-safe reference counting for sharing ownership across thread boundaries, while `RwLock` enables controlled mutation of the shared data.","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"Concurrency","language":"Rust","updated":"2022-03-10","comments":3,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-thread-safe-resource-sharing.md"},{"slug":"mxnet-use-named-constants","title":"Use named constants","description":"In AI model implementations, avoid using magic numbers directly in code as they reduce readability and make maintenance difficult. Always define constants with meaningful names, especially for values related to tensor dimensions, indices, and type identifiers.","repository":"apache/mxnet","domain":"ml-systems","topic":"AI","language":"Other","updated":"2022-03-10","comments":2,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-use-named-constants.md"},{"slug":"nest-modern-null-safety-patterns","title":"Modern null safety patterns","description":"Leverage modern JavaScript features and utility functions for safer null/undefined handling. This reduces code verbosity while improving reliability.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Null Handling","language":"TypeScript","updated":"2022-03-07","comments":5,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-modern-null-safety-patterns.md"},{"slug":"nest-standardize-null-safety-patterns","title":"Standardize null safety patterns","description":"Use modern JavaScript features and utility functions consistently for null/undefined checks. Prefer optional chaining (?.), nullish coalescing (??), and dedicated utility functions like isNil() over direct null checks or OR (||) operators.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Null Handling","language":"TypeScript","updated":"2022-03-07","comments":5,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-standardize-null-safety-patterns.md"},{"slug":"mxnet-graph-traversal-optimization","title":"Graph traversal optimization","description":"When working with graph structures, avoid performing redundant depth-first search (DFS) traversals as each traversal incurs an O(V+E) complexity cost. Instead, consider:","repository":"apache/mxnet","domain":"ml-systems","topic":"Algorithms","language":"Other","updated":"2022-03-07","comments":4,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-graph-traversal-optimization.md"},{"slug":"cypress-simplify-complex-expressions","title":"Simplify complex expressions","description":"Break down complex conditional logic, nested structures, and verbose syntax into smaller, well-named functions or more concise expressions. This improves code readability and maintainability.","repository":"cypress-io/cypress","domain":"devtools","topic":"Code Style","language":"Other","updated":"2022-02-28","comments":5,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-simplify-complex-expressions.md"},{"slug":"serverless-standardize-log-output-methods","title":"standardize log output methods","description":"Use `process.stdout.write` instead of `console.log` for controlled logging output to avoid linter issues and ensure consistent behavior. When using `process.stdout.write`, manually add newlines since they are not automatically appended like with `console.log`. Maintain consistent log message formatting with proper prefixes and structured layout.","repository":"serverless/serverless","domain":"cloud-infra","topic":"Logging","language":"JavaScript","updated":"2022-02-28","comments":4,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-standardize-log-output-methods.md"},{"slug":"tokenizers-simplify-for-readability","title":"Simplify for readability","description":"Prioritize code readability by using simpler and more direct expressions. When possible, return values directly instead of using temporary variables and explicit return statements. Break complex logic into intermediate variables with descriptive names. Structure control flow for maximum clarity, preferring Rust idioms like match expressions over nested...","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"Code Style","language":"Rust","updated":"2022-02-14","comments":6,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-simplify-for-readability.md"},{"slug":"sentry-php-document-api-changes","title":"Document API changes","description":"When documenting API changes, particularly breaking changes, follow these practices to ensure clarity and ease of migration: 1. **Group related changes** for better scannability. When multiple methods or functions change in a similar way, format them as a structured list:","repository":"getsentry/sentry-php","domain":"observability","topic":"API","language":"Markdown","updated":"2022-02-08","comments":5,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-document-api-changes.md"},{"slug":"express-clear-array-operations","title":"Clear array operations","description":"When working with arrays, prioritize clarity and explicitness over terse or clever constructs. For array membership checks, use `array.indexOf(item) === -1` rather than less obvious expressions like `!~array.indexOf(item)` or `array.indexOf(item) < 0`. This improves readability and makes code intent immediately clear to other developers.","repository":"expressjs/express","domain":"app-frameworks","topic":"Algorithms","language":"JavaScript","updated":"2022-02-06","comments":2,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-clear-array-operations.md"},{"slug":"svelte-optimize-computational-complexity","title":"optimize computational complexity","description":"When implementing algorithms, especially in runtime or performance-critical code, prioritize computational efficiency by minimizing redundant operations and simplifying mathematical expressions. Look for opportunities to reduce the number of multiplications, divisions, and variable assignments.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Algorithms","language":"TypeScript","updated":"2022-02-04","comments":2,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-optimize-computational-complexity.md"},{"slug":"mxnet-consistent-naming-patterns","title":"Consistent naming patterns","description":"Maintain consistent naming conventions throughout the codebase to enhance readability and reduce confusion. This applies to: 1. **Import aliases**: Use standardized aliases for imported libraries. When working with both MXNet''s NumPy and the official NumPy, use ''onp'' for the official NumPy to clearly distinguish between them:","repository":"apache/mxnet","domain":"ml-systems","topic":"Naming Conventions","language":"Python","updated":"2022-02-02","comments":7,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-consistent-naming-patterns.md"},{"slug":"mxnet-use-explicit-optional-types","title":"Use explicit optional types","description":"When dealing with values that may be absent or null, always use explicit optional type wrappers instead of implicit null checks or nullable types without clear type constraints. This makes the code's intent clearer, prevents null reference errors, and improves type safety.","repository":"apache/mxnet","domain":"ml-systems","topic":"Null Handling","language":"Other","updated":"2022-01-28","comments":3,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-use-explicit-optional-types.md"},{"slug":"cypress-document-security-policy-trade-offs","title":"Document security policy trade-offs","description":"When implementing security policies like Content Security Policy (CSP), always include clear documentation explaining the reasoning behind each directive choice and any security trade-offs being made. This prevents confusion during code reviews and ensures team members understand the security implications.","repository":"cypress-io/cypress","domain":"devtools","topic":"Security","language":"Html","updated":"2022-01-19","comments":1,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-document-security-policy-trade-offs.md"},{"slug":"frp-connection-lifecycle-management","title":"Connection lifecycle management","description":"Implement comprehensive lifecycle management for network connections. Ensure proper initialization, authentication, monitoring, and termination of connections to maintain system reliability and performance.","repository":"fatedier/frp","domain":"cloud-infra","topic":"Networking","language":"Go","updated":"2022-01-12","comments":5,"stars":95938,"raw":"https://awesomereviewers.com/raw/frp-connection-lifecycle-management.md"},{"slug":"tree-sitter-use-meaningful-identifiers","title":"Use meaningful identifiers","description":"Choose identifiers that accurately represent their purpose, semantics, and relationship to the codebase. Names should be self-documenting and consistent with established patterns in the module or API.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Naming Conventions","language":"C","updated":"2022-01-12","comments":5,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-use-meaningful-identifiers.md"},{"slug":"boto3-manage-test-environments","title":"Manage test environments","description":"When writing tests that interact with environment variables or configuration settings, always (1) preserve the original state and (2) explicitly specify required configurations.","repository":"boto/boto3","domain":"cloud-infra","topic":"Configurations","language":"Python","updated":"2021-12-28","comments":3,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-manage-test-environments.md"},{"slug":"tree-sitter-use-meaningful-prefixed-names","title":"Use meaningful prefixed names","description":"Names should be semantically meaningful and properly prefixed to prevent namespace conflicts. In C, enum variants and global identifiers are added to the top-level namespace, so prefix them with their type name even if repetitive. Choose names that reflect domain concepts and purpose rather than technical implementation details. Prioritize clarity over...","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Naming Conventions","language":"Other","updated":"2021-12-24","comments":4,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-use-meaningful-prefixed-names.md"},{"slug":"yoga-cache-expensive-computations","title":"Cache expensive computations","description":"Identify and cache the results of expensive computations to avoid redundant calculations, especially in performance-critical code paths. This includes recursive functions, user-defined callbacks, and complex arithmetic operations that may be called multiple times with the same inputs.","repository":"facebook/yoga","domain":"runtimes","topic":"Performance Optimization","language":"C++","updated":"2021-12-23","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-cache-expensive-computations.md"},{"slug":"kubeflow-manage-configuration-changes","title":"Manage configuration changes","description":"Carefully manage configuration file changes to ensure consistency and minimize unintended impacts across your project. When modifying configuration files:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Configurations","language":"Json","updated":"2021-12-22","comments":3,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-manage-configuration-changes.md"},{"slug":"tokenizers-consistent-api-design","title":"Consistent API design","description":"When designing and modifying APIs, ensure consistency in parameter naming, default values, and which functionality is exposed. Each API design decision should:","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"API","language":"Other","updated":"2021-12-15","comments":2,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-consistent-api-design.md"},{"slug":"ncnn-null-safe-checks","title":"Null-safe checks","description":"Make null/empty handling explicit and safe—so empty values don’t break logic or even generate invalid syntax, and raw null-pointer checks are replaced with semantic, invariant-based checks.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Null Handling","language":"Other","updated":"2021-12-09","comments":5,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-null-safe-checks.md"},{"slug":"mxnet-avoid-redundant-calculations","title":"Avoid redundant calculations","description":"Eliminate redundant calculations by identifying and caching frequently used values to improve performance. Consider these optimization patterns: 1. Cache function results when used multiple times:","repository":"apache/mxnet","domain":"ml-systems","topic":"Performance Optimization","language":"Other","updated":"2021-12-07","comments":4,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-avoid-redundant-calculations.md"},{"slug":"cypress-avoid-redundant-io-operations","title":"avoid redundant I/O operations","description":"Identify and eliminate repeated expensive operations, particularly file system access, by implementing caching, batching, or data sharing strategies. When the same file or resource is accessed multiple times within a short timeframe, consider caching the result or restructuring the code to perform the operation once and reuse the data.","repository":"cypress-io/cypress","domain":"devtools","topic":"Performance Optimization","language":"TypeScript","updated":"2021-12-07","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-avoid-redundant-io-operations.md"},{"slug":"tokenizers-avoid-unsafe-code","title":"Avoid unsafe code","description":"Prioritize memory safety and security over performance optimizations by avoiding unsafe code blocks, especially in libraries. Even when bounds are checked, unsafe code can introduce subtle security vulnerabilities and maintenance challenges. Prefer using safe Rust patterns and abstractions, even if it means a slight performance overhead (like an additional...","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"Security","language":"Rust","updated":"2021-12-06","comments":1,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-avoid-unsafe-code.md"},{"slug":"deeplearning4j-document-api-completely","title":"Document API completely","description":"All public APIs must have comprehensive and clear documentation that helps developers understand functionality without examining implementation details. Follow these guidelines:","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Documentation","language":"Java","updated":"2021-11-15","comments":8,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-document-api-completely.md"},{"slug":"mxnet-document-environment-variables","title":"Document environment variables","description":"All environment variables must be documented in the central env_var.md file with clear descriptions of their purpose, acceptable values, and effects. Use consistent naming patterns that reflect the subsystem they configure (e.g., MXNET_CUDNN_*, MXNET_MKLDNN_*) and avoid introducing new variables when existing ones can serve the same purpose.","repository":"apache/mxnet","domain":"ml-systems","topic":"Configurations","language":"Other","updated":"2021-11-09","comments":3,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-document-environment-variables.md"},{"slug":"fastapi-preserve-unset-field-values","title":"Preserve unset field values","description":"When implementing partial updates in FastAPI, use the `exclude_unset` parameter in Pydantic's `.dict()` or `.model_dump()` method to avoid overriding existing values with defaults. This ensures that only fields explicitly set by the client are updated, while preserving any existing values for fields not included in the request. This pattern is particularly...","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Null Handling","language":"Markdown","updated":"2021-11-05","comments":3,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-preserve-unset-field-values.md"},{"slug":"cypress-prefer-modern-composition-patterns","title":"prefer modern composition patterns","description":"Use Vue 3 Composition API patterns that provide better performance, type safety, and maintainability. Prefer `computed` over `watch` + reactive assignment when deriving values from other reactive data. Use `defineEmits` instead of `$emit` in templates for type safety. Adopt modern `defineProps<{}>()` syntax over PropType casting for better TypeScript...","repository":"cypress-io/cypress","domain":"devtools","topic":"Vue","language":"Other","updated":"2021-11-03","comments":5,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-prefer-modern-composition-patterns.md"},{"slug":"cypress-consistent-naming-patterns","title":"Consistent naming patterns","description":"Establish and enforce consistent naming conventions across different contexts in your codebase. Teams should decide on specific patterns and use linting to maintain consistency rather than mixing approaches.","repository":"cypress-io/cypress","domain":"devtools","topic":"Naming Conventions","language":"Other","updated":"2021-11-03","comments":3,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-consistent-naming-patterns.md"},{"slug":"cypress-prioritize-naming-clarity","title":"Prioritize naming clarity","description":"Choose names and aliases that clearly communicate their purpose and meaning rather than optimizing for brevity or perceived elegance. Avoid abbreviated aliases that obscure the actual location or purpose of code elements, and resist adding premature complexity like numerical suffixes unless multiple variants actually exist.","repository":"cypress-io/cypress","domain":"devtools","topic":"Naming Conventions","language":"Json","updated":"2021-11-03","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-prioritize-naming-clarity.md"},{"slug":"cypress-avoid-brittle-css-patterns","title":"Avoid brittle CSS patterns","description":"Write CSS that prioritizes maintainability and reduces the likelihood of conflicts or brittleness. This includes using semantic class names instead of raw HTML element selectors, and avoiding explicit z-index values when possible.","repository":"cypress-io/cypress","domain":"devtools","topic":"Code Style","language":"Css","updated":"2021-10-29","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-avoid-brittle-css-patterns.md"},{"slug":"mxnet-use-pytest-parameterization","title":"Use pytest parameterization","description":"Structure unit tests using pytest's parameterize decorator instead of manual loops or wrapper functions. This approach improves test readability, makes failure cases easier to identify, and allows individual test cases to be run separately.","repository":"apache/mxnet","domain":"ml-systems","topic":"Testing","language":"Python","updated":"2021-10-29","comments":2,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-use-pytest-parameterization.md"},{"slug":"sentry-php-dynamic-error-configuration","title":"Dynamic error configuration","description":"Design error handling systems that respect runtime changes to error settings rather than fixing configurations at initialization time. When handling errors, dynamically evaluate error reporting flags to allow for temporary error silencing and context-specific error handling behavior. Preserve user-specified error levels when processing exceptions to ensure...","repository":"getsentry/sentry-php","domain":"observability","topic":"Error Handling","language":"Markdown","updated":"2021-10-19","comments":2,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-dynamic-error-configuration.md"},{"slug":"cypress-graphql-mutation-design","title":"GraphQL mutation design","description":"Design GraphQL mutations to return meaningful objects rather than simple booleans, and use simple ID parameters instead of complex nested objects. This follows GraphQL best practices and enables proper client-side cache management.","repository":"cypress-io/cypress","domain":"devtools","topic":"API","language":"TypeScript","updated":"2021-10-18","comments":4,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-graphql-mutation-design.md"},{"slug":"ink-documentation-code-quality","title":"Documentation code quality","description":"Ensure documentation code blocks use appropriate syntax highlighting and provide comprehensive, functional examples. For shell commands in markdown, use `sh` syntax highlighting rather than `console` for better highlighting accuracy and copy functionality. When documenting APIs or components, provide multiple complete examples that demonstrate different...","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"Code Style","language":"Markdown","updated":"2021-10-17","comments":2,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-documentation-code-quality.md"},{"slug":"boto3-follow-flake8-style-guidelines","title":"Follow flake8 style guidelines","description":"Adhere to the project''s established flake8 style guidelines as defined in setup.cfg. This includes: 1. Maintain line length limits of 80 characters for consistency and readability across all files.","repository":"boto/boto3","domain":"cloud-infra","topic":"Code Style","language":"Other","updated":"2021-10-15","comments":2,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-follow-flake8-style-guidelines.md"},{"slug":"cypress-consistent-descriptive-naming","title":"consistent descriptive naming","description":"Maintain consistent naming patterns across similar functionality while ensuring names accurately describe their current purpose and scope. When multiple options exist for the same feature, standardize on one clear option to avoid confusion in documentation and usage. Update variable names when their type or purpose changes, and use descriptive names that...","repository":"cypress-io/cypress","domain":"devtools","topic":"Naming Conventions","language":"JavaScript","updated":"2021-10-12","comments":5,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-consistent-descriptive-naming.md"},{"slug":"cypress-choose-appropriate-log-levels","title":"Choose appropriate log levels","description":"Select log levels based on the intended audience and actionability of the message. Use `debug` for internal development information that helps with troubleshooting, `warn` or `error` for user-actionable issues, and avoid logging messages that add noise without providing value to the user.","repository":"cypress-io/cypress","domain":"devtools","topic":"Logging","language":"JavaScript","updated":"2021-10-12","comments":4,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-choose-appropriate-log-levels.md"},{"slug":"ink-consistent-code-formatting","title":"Consistent code formatting","description":"Maintain consistent formatting and alignment throughout the codebase to improve readability and maintainability. This includes proper indentation for multi-line constructs, consistent spacing in documentation, and clear structural organization.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"2021-10-10","comments":3,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-consistent-code-formatting.md"},{"slug":"mxnet-centralize-configuration-parameters","title":"Centralize configuration parameters","description":"Avoid hardcoded paths and duplicated configuration values throughout the code. Instead: 1. Use dedicated configuration files for settings that appear in multiple places","repository":"apache/mxnet","domain":"ml-systems","topic":"Configurations","language":"Shell","updated":"2021-10-10","comments":3,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-centralize-configuration-parameters.md"},{"slug":"mxnet-comprehensive-api-documentation","title":"Comprehensive API documentation","description":"Ensure all API elements are thoroughly documented following a consistent format. This includes: 1. **All function parameters** must have descriptive documentation that explains their purpose, expected values, and default behaviors.","repository":"apache/mxnet","domain":"ml-systems","topic":"Documentation","language":"Python","updated":"2021-10-03","comments":4,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-comprehensive-api-documentation.md"},{"slug":"mxnet-document-api-completely","title":"Document API completely","description":"Always provide comprehensive API documentation that clearly specifies: 1. **Parameter types** - Document all acceptable parameter types, not just specific implementations. When a parameter accepts any object that satisfies certain behavior (like iterables), explicitly state this rather than referencing a specific class.","repository":"apache/mxnet","domain":"ml-systems","topic":"API","language":"Python","updated":"2021-10-03","comments":3,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-document-api-completely.md"},{"slug":"azure-quickstart-templates-env-aligned-configuration","title":"Env-Aligned Configuration","description":"When a solution has environment-specific configuration (e.g., public vs US Gov) or requires cloud-context values, ensure: 1) **Environment-specific UI/artifacts are derived from the declared support matrix** (e.g., `metadata.json` → `environments`). If an environment is not supported, do not render its corresponding badge/button/link.","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Configurations","language":"Markdown","updated":"2021-09-29","comments":2,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-env-aligned-configuration.md"},{"slug":"mxnet-eliminate-redundant-constructs","title":"Eliminate redundant constructs","description":"Remove unnecessary coding patterns that add complexity without providing value. Focus on clarity and simplicity by: 1. Not using enumerate() when the index is unused:","repository":"apache/mxnet","domain":"ml-systems","topic":"Code Style","language":"Python","updated":"2021-09-17","comments":12,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-eliminate-redundant-constructs.md"},{"slug":"deeplearning4j-optimize-validation-checks","title":"Optimize validation checks","description":"When implementing validation and requirement checks, balance thoroughness with performance considerations. Critical validations should remain unconditional, but optimize their implementation to minimize performance impact:","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Performance Optimization","language":"CUDA","updated":"2021-09-05","comments":2,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-optimize-validation-checks.md"},{"slug":"mxnet-hybridization-compatible-operations","title":"Hybridization compatible operations","description":"When implementing neural network models that will be hybridized for performance optimization, use operations that are compatible with symbolic execution to avoid runtime errors. Hybridization converts imperative code to symbolic for better inference performance, but requires special handling of certain operations.","repository":"apache/mxnet","domain":"ml-systems","topic":"AI","language":"Python","updated":"2021-09-03","comments":5,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-hybridization-compatible-operations.md"},{"slug":"mxnet-centralize-synchronization-logic","title":"Centralize synchronization logic","description":"When implementing concurrent operations, especially in heterogeneous computing environments (CPU/GPU), centralize synchronization management in dedicated components rather than using flags scattered throughout the codebase. This approach improves maintainability, reduces the potential for race conditions, and makes concurrency behavior more predictable.","repository":"apache/mxnet","domain":"ml-systems","topic":"Concurrency","language":"Other","updated":"2021-09-02","comments":3,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-centralize-synchronization-logic.md"},{"slug":"serverless-api-schema-validation-accuracy","title":"API schema validation accuracy","description":"Ensure that JSON schema validation for API configurations precisely matches the actual service requirements and constraints. Schema validation should use correct JSON schema properties and accurately reflect documented API limits.","repository":"serverless/serverless","domain":"cloud-infra","topic":"API","language":"JavaScript","updated":"2021-09-01","comments":7,"stars":46810,"raw":"https://awesomereviewers.com/raw/serverless-api-schema-validation-accuracy.md"},{"slug":"express-use-unique-password-salts","title":"Use unique password salts","description":"When implementing password hashing, always use unique, randomly generated salts for each user. Using constant or shared salts significantly reduces security by allowing identical passwords to produce identical hashes, making them vulnerable to rainbow table attacks.","repository":"expressjs/express","domain":"app-frameworks","topic":"Security","language":"JavaScript","updated":"2021-08-31","comments":1,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-use-unique-password-salts.md"},{"slug":"cypress-ensure-async-synchronization","title":"ensure async synchronization","description":"When dealing with async operations that depend on external systems (servers, backends, etc.), ensure proper synchronization to avoid race conditions. Don't rely on client-side polling or workarounds when the root cause is improper async handling.","repository":"cypress-io/cypress","domain":"devtools","topic":"Concurrency","language":"Other","updated":"2021-08-30","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-ensure-async-synchronization.md"},{"slug":"chef-log-message-quality","title":"Log message quality","description":"Ensure all log messages are consistent in formatting and clear in purpose. Complete sentences in logs should end with proper punctuation (especially periods), and messages should precisely describe what is happening in the system. When logging phase transitions or significant events, explicitly state where one phase ends and another begins rather than using...","repository":"chef/chef","domain":"cloud-infra","topic":"Logging","language":"Markdown","updated":"2021-08-27","comments":2,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-log-message-quality.md"},{"slug":"chef-update-security-critical-dependencies","title":"Update security-critical dependencies","description":"Regularly audit and update third-party libraries and dependencies to address known security vulnerabilities. Pay special attention to components that handle sensitive operations such as file system access, encryption, or network communication. Implement a systematic process to monitor CVEs and security bulletins relevant to your dependencies, and document...","repository":"chef/chef","domain":"cloud-infra","topic":"Security","language":"Markdown","updated":"2021-08-27","comments":1,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-update-security-critical-dependencies.md"},{"slug":"chef-use-strict-test-doubles","title":"Use strict test doubles","description":"Always use strict test doubles (instance_double, class_double) instead of basic doubles or OpenStruct in tests. Strict doubles provide compile-time checks that prevent tests from passing when the mocked interface changes, improving test maintainability and catching integration issues early.","repository":"chef/chef","domain":"cloud-infra","topic":"Testing","language":"Ruby","updated":"2021-08-26","comments":4,"stars":7860,"raw":"https://awesomereviewers.com/raw/chef-use-strict-test-doubles.md"},{"slug":"mxnet-optimize-iteration-patterns","title":"Optimize iteration patterns","description":"When iterating through collections, choose the most efficient iteration pattern based on what information you actually need. If you only need the elements without using their indices, use direct iteration instead of enumerate:","repository":"apache/mxnet","domain":"ml-systems","topic":"Algorithms","language":"Python","updated":"2021-08-25","comments":6,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-optimize-iteration-patterns.md"},{"slug":"mxnet-consistent-api-documentation","title":"Consistent API documentation","description":"Maintain high-quality, consistent documentation as a critical component of API design. Documentation should feature: 1. Correct grammar and spelling, including proper punctuation and sentence structure","repository":"apache/mxnet","domain":"ml-systems","topic":"API","language":"Markdown","updated":"2021-08-23","comments":2,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-consistent-api-documentation.md"},{"slug":"gin-pin-dependency-versions","title":"Pin dependency versions","description":"Always specify exact versions of tools and dependencies in CI/CD workflows rather than using 'latest' or floating versions. This ensures build reproducibility, prevents unexpected failures when upstream dependencies change, and makes debugging easier.","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2021-08-17","comments":2,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-pin-dependency-versions.md"},{"slug":"deeplearning4j-configurable-resource-locations","title":"Configurable resource locations","description":"Always make file paths, temporary directories, and resource locations configurable with reasonable defaults instead of hard-coding them. Users may have specific environment requirements such as using SSDs instead of system drives or working with constrained environments like Spring Boot.","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Configurations","language":"Java","updated":"2021-08-16","comments":4,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-configurable-resource-locations.md"},{"slug":"kubeflow-validate-inputs-explicitly","title":"Validate inputs explicitly","description":"Always validate input parameters and respond with appropriate HTTP status codes when invalid values are detected, even when inputs appear controlled by your frontend. Backend validation should explicitly check for invalid or unexpected values (like \"NaN\" or values outside an allowed set) and raise appropriate exceptions with clear error messages.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Error Handling","language":"Python","updated":"2021-08-13","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-validate-inputs-explicitly.md"},{"slug":"kubeflow-mark-ui-text-i18n","title":"Mark UI text i18n","description":"All user-facing text in HTML templates should be marked for internationalization using the i18n directive. This includes labels, placeholders, error messages, and any other text displayed to users. Using the i18n directive ensures the text can be properly extracted for translation and maintains consistent internationalization throughout the application.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Documentation","language":"Html","updated":"2021-08-12","comments":3,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-mark-ui-text-i18n.md"},{"slug":"deeplearning4j-preserve-api-compatibility","title":"Preserve API compatibility","description":"When evolving APIs, prioritize backward compatibility to protect existing client code. Make new parameters optional whenever possible to allow existing code to continue functioning. If breaking changes are necessary, evaluate how users typically interact with your API before proceeding.","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"API","language":"Kotlin","updated":"2021-08-05","comments":2,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-preserve-api-compatibility.md"},{"slug":"cypress-strengthen-test-assertions","title":"Strengthen test assertions","description":"Write specific, regression-proof test assertions that validate exact expected values rather than allowing ambiguous matches. Avoid assertions that could pass with incorrect but similar values.","repository":"cypress-io/cypress","domain":"devtools","topic":"Testing","language":"JavaScript","updated":"2021-08-02","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-strengthen-test-assertions.md"},{"slug":"tokenizers-document-for-comprehension","title":"Document for comprehension","description":"Add comprehensive documentation that helps others understand both the interface and implementation of your code. This includes: 1. **Detailed parameter documentation** in docstrings with type information and purpose descriptions, especially for new or non-obvious parameters","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"Documentation","language":"Python","updated":"2021-07-21","comments":2,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-document-for-comprehension.md"},{"slug":"azure-quickstart-templates-secure-parameter-placeholders","title":"Secure Parameter Placeholders","description":"...","repository":"Azure/azure-quickstart-templates","domain":"cloud-infra","topic":"Security","language":"Json","updated":"2021-07-21","comments":1,"stars":14846,"raw":"https://awesomereviewers.com/raw/azure-quickstart-templates-secure-parameter-placeholders.md"},{"slug":"deeplearning4j-use-logging-best-practices","title":"Use logging best practices","description":"Adopt these logging best practices to ensure consistent, efficient, and meaningful logs: 1. **Use Lombok''s `@Slf4j` annotation** instead of manually declaring loggers:","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Logging","language":"Java","updated":"2021-07-20","comments":5,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-use-logging-best-practices.md"},{"slug":"deeplearning4j-clear-descriptive-identifiers","title":"Clear descriptive identifiers","description":"Choose clear, self-descriptive names for all code identifiers that accurately reflect their purpose and behavior. Method names should be verbs or verb phrases that indicate their function without ambiguity. For boolean methods, use prefixes like \"is\", \"has\", or \"should\" followed by the condition they check.","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Naming Conventions","language":"Java","updated":"2021-07-20","comments":3,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-clear-descriptive-identifiers.md"},{"slug":"nest-http-header-management","title":"HTTP header management","description":"When working with HTTP responses, follow these principles for proper header management: 1. **Only set default headers when undefined, not when falsy:**","repository":"nestjs/nest","domain":"app-frameworks","topic":"Networking","language":"TypeScript","updated":"2021-07-19","comments":4,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-http-header-management.md"},{"slug":"cypress-await-promise-returning-functions","title":"await promise-returning functions","description":"Always await functions that return promises to ensure proper asynchronous execution and avoid potential race conditions or unexpected behavior. When converting from promise chains to async/await, verify that all promise-returning function calls include the await keyword.","repository":"cypress-io/cypress","domain":"devtools","topic":"Concurrency","language":"TypeScript","updated":"2021-07-19","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-await-promise-returning-functions.md"},{"slug":"cypress-safe-null-access-patterns","title":"Safe null access patterns","description":"Always provide fallbacks when accessing properties or methods on values that could be undefined or null to prevent runtime errors. Use defensive programming patterns like logical OR operators, conditional checks, or nullish coalescing when available.","repository":"cypress-io/cypress","domain":"devtools","topic":"Null Handling","language":"Other","updated":"2021-07-14","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-safe-null-access-patterns.md"},{"slug":"netty-prevent-test-resource-leaks","title":"Prevent test resource leaks","description":"Always ensure proper cleanup of resources in tests to prevent memory leaks. When using EmbeddedChannel, call readOutbound() to process all expected buffers and finish() at the end of your test to verify no resources remain and release any remaining buffers. This is particularly important for tests involving data buffers, channels, and I/O operations.","repository":"netty/netty","domain":"runtimes","topic":"Testing","language":"Java","updated":"2021-07-12","comments":3,"stars":34227,"raw":"https://awesomereviewers.com/raw/netty-prevent-test-resource-leaks.md"},{"slug":"cypress-use-exact-dependency-versions","title":"Use exact dependency versions","description":"Always specify exact dependency versions in package.json files instead of using version ranges (^, ~) to ensure reproducible builds and prevent accidental upgrades that could introduce breaking changes.","repository":"cypress-io/cypress","domain":"devtools","topic":"Configurations","language":"Json","updated":"2021-06-25","comments":3,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-use-exact-dependency-versions.md"},{"slug":"deeplearning4j-cross-platform-algorithm-optimization","title":"Cross-platform algorithm optimization","description":"When implementing algorithms that need to execute efficiently across different platforms, consider both compile-time and runtime optimizations: 1. For template-heavy code, use explicit instantiations to improve compilation speed and avoid compiler limitations on specific platforms:","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Algorithms","language":"Other","updated":"2021-06-22","comments":4,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-cross-platform-algorithm-optimization.md"},{"slug":"deeplearning4j-document-in-code-decisions","title":"Document in-code decisions","description":"Always include explanations for implementation decisions, non-obvious constructs, and specialized functions directly within the code as comments, rather than relying on external systems like commit messages or GitHub discussions. This practice ensures that future developers can understand the code's purpose and behavior without having to search through...","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Documentation","language":"CUDA","updated":"2021-06-22","comments":2,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-document-in-code-decisions.md"},{"slug":"runtime-centralize-platform-configurations","title":"Centralize platform configurations","description":"Platform-specific code and API usage should be centralized in designated configuration files rather than scattered throughout the codebase. When adding code that might not be available on all supported platforms:","repository":"dotnet/runtime","domain":"runtimes","topic":"Configurations","language":"C","updated":"2021-06-16","comments":2,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-centralize-platform-configurations.md"},{"slug":"kotlin-dependency-verification-configuration","title":"Dependency verification configuration","description":"When adding new dependencies to build.gradle.kts files, always update the corresponding verification metadata to prevent build failures. Use the Gradle command `./gradlew --write-verification-metadata md5,sha256 help` to generate the necessary metadata, but review the output carefully as it may add more dependencies than required. Consider manually adding...","repository":"JetBrains/kotlin","domain":"runtimes","topic":"Configurations","language":"Xml","updated":"2021-06-15","comments":2,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-dependency-verification-configuration.md"},{"slug":"esbuild-minimize-test-maintenance","title":"minimize test maintenance","description":"Avoid unnecessary test maintenance overhead by eliminating duplicate test coverage and implementing automated test update mechanisms. When the same functionality is already covered by equivalent tests (e.g., end-to-end tests that exercise the same code paths), remove redundant test implementations rather than maintaining multiple versions. Additionally,...","repository":"evanw/esbuild","domain":"devtools","topic":"Testing","language":"Go","updated":"2021-06-08","comments":2,"stars":39161,"raw":"https://awesomereviewers.com/raw/esbuild-minimize-test-maintenance.md"},{"slug":"cypress-standardize-api-patterns","title":"standardize API patterns","description":"Establish consistent patterns for API design, particularly for request/response formats and parameter structures. This improves predictability, type safety, and developer experience across the codebase.","repository":"cypress-io/cypress","domain":"devtools","topic":"API","language":"JavaScript","updated":"2021-06-04","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-standardize-api-patterns.md"},{"slug":"kubeflow-use-modern-javascript-idioms","title":"Use modern JavaScript idioms","description":"Favor modern JavaScript syntax and clean code practices to improve readability and maintainability. This includes: 1. **Use template literals** instead of string concatenation for clearer string interpolation:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Code Style","language":"JavaScript","updated":"2021-05-31","comments":5,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-use-modern-javascript-idioms.md"},{"slug":"brew-document-ci-pipeline-comprehensively","title":"Document CI pipeline comprehensively","description":"Ensure CI/CD pipeline documentation accurately reflects the complete workflow, including job dependencies, execution order, and all operations performed by each step. When documenting CI processes:","repository":"Homebrew/brew","domain":"devtools","topic":"CI/CD","language":"Markdown","updated":"2021-05-19","comments":3,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-document-ci-pipeline-comprehensively.md"},{"slug":"boto3-isolate-concurrent-resources","title":"Isolate concurrent resources","description":"Create separate instances of non-thread-safe resources for each thread or process in concurrent applications rather than sharing a single instance. Many objects that maintain state or shared metadata (like sessions, connections, or context-dependent resources) are not thread-safe and can cause race conditions or unpredictable behavior when accessed...","repository":"boto/boto3","domain":"cloud-infra","topic":"Concurrency","language":"Other","updated":"2021-05-18","comments":4,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-isolate-concurrent-resources.md"},{"slug":"brew-evaluate-security-control-effectiveness","title":"Evaluate security control effectiveness","description":"Security measures should be evaluated against realistic threat models to avoid creating a false sense of security. When implementing security controls like checksums, consider whether they actually protect against likely attack vectors.","repository":"Homebrew/brew","domain":"devtools","topic":"Security","language":"Markdown","updated":"2021-05-17","comments":1,"stars":44168,"raw":"https://awesomereviewers.com/raw/brew-evaluate-security-control-effectiveness.md"},{"slug":"kotlin-document-security-implementations","title":"Document security implementations","description":"Always document non-obvious security implementations, especially authentication mechanisms, with explanatory comments and references to underlying implementation details or documentation. Security-related code should be explicit and clear to prevent misunderstandings that could lead to vulnerabilities.","repository":"JetBrains/kotlin","domain":"runtimes","topic":"Security","language":"Kotlin","updated":"2021-05-17","comments":1,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-document-security-implementations.md"},{"slug":"cypress-consistent-formatting-preferences","title":"Consistent formatting preferences","description":"Follow consistent formatting and syntax patterns to improve code readability and maintainability. This includes using compact formatting for test blocks, proper quote usage, positive-first conditionals, and preferred syntax patterns.","repository":"cypress-io/cypress","domain":"devtools","topic":"Code Style","language":"JavaScript","updated":"2021-05-10","comments":6,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-consistent-formatting-preferences.md"},{"slug":"deeplearning4j-modular-adaptive-configurations","title":"Modular adaptive configurations","description":"Structure configuration scripts with modularity and adaptability in mind. Extract repeated parameters into variables, separate parameter construction from command execution, and use dynamic detection for environment-specific values instead of hardcoding them. This approach improves readability, maintainability, and resilience to changes in the environment.","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Configurations","language":"Yaml","updated":"2021-05-10","comments":2,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-modular-adaptive-configurations.md"},{"slug":"cypress-optimize-dynamic-loading","title":"optimize dynamic loading","description":"When using dynamic imports, implement timing controls and strategic naming to ensure reliable and efficient resource loading. Use minimal delays (like setTimeout with 0ms) to control initialization timing and prevent race conditions that could cause failures. Additionally, use descriptive chunk names with webpackChunkName comments to create readable,...","repository":"cypress-io/cypress","domain":"devtools","topic":"Performance Optimization","language":"JavaScript","updated":"2021-04-26","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-optimize-dynamic-loading.md"},{"slug":"kubeflow-document-networking-annotations","title":"Document networking annotations","description":"When using Istio or other networking-related annotations in configuration files, always include detailed comments explaining their purpose, behavior, and effects. This makes networking constraints and logic transparent to developers and users who need to understand the system's behavior.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Networking","language":"Yaml","updated":"2021-04-13","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-document-networking-annotations.md"},{"slug":"go-gobuild-directive-syntax","title":"go:build directive syntax","description":"Ensure go:build directives follow correct syntax with no space between \"//\" and \"go\", and use proper logical operators for multiple conditions. Incorrect spacing causes the directive to be ignored by the compiler, potentially including wrong code for target environments.","repository":"golang/go","domain":"runtimes","topic":"Configurations","language":"Go","updated":"2021-04-11","comments":2,"stars":129599,"raw":"https://awesomereviewers.com/raw/go-gobuild-directive-syntax.md"},{"slug":"ink-use-descriptive-variable-names","title":"Use descriptive variable names","description":"Avoid single-character variables and abbreviations in favor of descriptive, full-word names that clearly communicate the variable's purpose or content. This improves code readability and makes the codebase more maintainable for other developers.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"Naming Conventions","language":"TSX","updated":"2021-04-05","comments":3,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-use-descriptive-variable-names.md"},{"slug":"ink-react-interface-clarity","title":"React interface clarity","description":"Ensure React interfaces have descriptive names and accurate documentation that clearly communicate their purpose and usage. Interface names should be specific to their context (e.g., `StdoutContextProps` instead of `StdoutProps` for Context-related interfaces), and API documentation should accurately reflect how methods are called (e.g., distinguishing...","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"React","language":"TypeScript","updated":"2021-04-05","comments":2,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-react-interface-clarity.md"},{"slug":"ncnn-stable-benchmarking-practices","title":"Stable Benchmarking Practices","description":"When collecting performance numbers, ensure both (1) benchmark parameters match the target hardware and (2) the execution environment is stable/isolated—otherwise results can be misleading.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Performance Optimization","language":"Markdown","updated":"2021-04-02","comments":2,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-stable-benchmarking-practices.md"},{"slug":"compose-specific-defensive-error-handling","title":"specific defensive error handling","description":"Implement specific exception handling and defensive programming practices to prevent generic errors from masking real issues and provide graceful degradation when operations fail.","repository":"docker/compose","domain":"orchestration","topic":"Error Handling","language":"Python","updated":"2021-04-01","comments":3,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-specific-defensive-error-handling.md"},{"slug":"kubeflow-load-configurations-efficiently","title":"Load configurations efficiently","description":"When designing components that require configuration, follow these practices to enhance performance, maintainability, and usability: 1. **Load configuration once at startup** rather than repeatedly during reconciliation loops:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Configurations","language":"Go","updated":"2021-03-30","comments":4,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-load-configurations-efficiently.md"},{"slug":"cypress-prioritize-jsx-readability","title":"Prioritize JSX readability","description":"Favor inline conditional rendering in JSX over extracting logic to variables before the return statement, as it maintains better flow control visibility and reduces cognitive overhead when reading components. Additionally, use descriptive variable names that clearly convey their purpose and state.","repository":"cypress-io/cypress","domain":"devtools","topic":"React","language":"TSX","updated":"2021-03-30","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-prioritize-jsx-readability.md"},{"slug":"cypress-extract-inline-code","title":"Extract inline code","description":"Extract complex inline code elements into separate functions, components, or constants to improve readability and maintainability. This includes hardcoded strings, complex event handlers, and lengthy JSX expressions.","repository":"cypress-io/cypress","domain":"devtools","topic":"Code Style","language":"TSX","updated":"2021-03-29","comments":3,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-extract-inline-code.md"},{"slug":"compose-schema-changes-upstream-first","title":"Schema changes upstream first","description":"When modifying configuration schemas, always propose changes to the upstream/source repository first before implementing them locally. This practice prevents schema divergence, maintains version integrity, and ensures a single source of truth for configuration definitions.","repository":"docker/compose","domain":"orchestration","topic":"Configurations","language":"Json","updated":"2021-03-26","comments":3,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-schema-changes-upstream-first.md"},{"slug":"kubeflow-standardize-build-configurations","title":"Standardize build configurations","description":"All components should use consistent build configurations and patterns in their CI/CD setup. This includes standardizing Makefile variables, build commands, and docker build processes across repositories. Inconsistent build configurations make CI/CD pipelines difficult to maintain and can lead to confusion during development.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"CI/CD","language":"Markdown","updated":"2021-03-17","comments":3,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-standardize-build-configurations.md"},{"slug":"kubeflow-use-css-classes-properly","title":"Use CSS classes properly","description":"Avoid inline styles and `!important` declarations in your HTML templates. Instead, define and use CSS classes that encapsulate styling needs. This improves code maintainability, readability, and reduces CSS specificity issues.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Code Style","language":"Html","updated":"2021-03-16","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-use-css-classes-properly.md"},{"slug":"kubeflow-follow-api-conventions","title":"Follow API conventions","description":"When designing APIs, adhere to established API conventions, particularly Kubernetes API conventions when working within the Kubernetes ecosystem. This improves API clarity, maintainability, and future compatibility.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"API","language":"Go","updated":"2021-03-12","comments":4,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-follow-api-conventions.md"},{"slug":"kubeflow-unique-workflow-step-names","title":"Unique workflow step names","description":"When defining CI/CD workflows, always ensure task/step names are unique to prevent execution failures. Workflow engines like Argo will reject pipelines with duplicate step names, which becomes particularly important when:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"CI/CD","language":"Python","updated":"2021-03-12","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-unique-workflow-step-names.md"},{"slug":"kubeflow-control-header-modification","title":"Control header modification","description":"When allowing user-configurable HTTP headers in your application, implement strict validation to prevent security bypasses. Users should never be allowed to override security-critical headers that could compromise authentication or authorization mechanisms.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Security","language":"Go","updated":"2021-03-11","comments":1,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-control-header-modification.md"},{"slug":"boto3-configure-proxies-with-schemes","title":"Configure proxies with schemes","description":"When configuring proxies in AWS SDK clients, always include the complete URL scheme in proxy definitions. Match the scheme to the protocol: use ''http://'' for HTTP connections and ''https://'' for HTTPS connections. Missing or incorrect schemes can lead to connection failures or security issues.","repository":"boto/boto3","domain":"cloud-infra","topic":"Networking","language":"Other","updated":"2021-03-08","comments":5,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-configure-proxies-with-schemes.md"},{"slug":"boto3-consistent-naming-standards","title":"Consistent naming standards","description":"Follow standard Python naming conventions consistently throughout code and documentation. Use underscores instead of hyphens in variable and parameter names (e.g., `proxies_config` not `proxies-config`). Maintain consistent capitalization of technical terms across all documentation. When working with file paths in code examples, use platform-agnostic...","repository":"boto/boto3","domain":"cloud-infra","topic":"Naming Conventions","language":"Other","updated":"2021-02-23","comments":3,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-consistent-naming-standards.md"},{"slug":"deeplearning4j-numerical-stability-practices","title":"Numerical stability practices","description":"When implementing machine learning algorithms, ensure numerical correctness and stability by following these practices: 1. Use appropriate default parameters based on research paper recommendations. For example, in AdaBelief, use smaller epsilon values as recommended by the authors:","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"AI","language":"Java","updated":"2021-02-22","comments":5,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-numerical-stability-practices.md"},{"slug":"go-documentation-quality-standards","title":"Documentation quality standards","description":"Ensure all documentation comments follow proper formatting conventions and are placed where developers will most likely read them. Documentation should use correct grammar, complete sentences, and end with periods. Additionally, place documentation at the most relevant location - typically at interface definitions rather than implementation details, since...","repository":"golang/go","domain":"runtimes","topic":"Documentation","language":"Go","updated":"2021-02-21","comments":2,"stars":129599,"raw":"https://awesomereviewers.com/raw/go-documentation-quality-standards.md"},{"slug":"aws-sdk-js-document-apis-completely","title":"Document APIs completely","description":"Always provide complete, clear, and contextually rich documentation for all public APIs. Documentation should: 1. Use proper grammar and clear wording","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Documentation","language":"TypeScript","updated":"2021-02-10","comments":3,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-document-apis-completely.md"},{"slug":"tree-sitter-consolidate-related-logging","title":"consolidate related logging","description":"When logging information about the same operation or context, combine multiple related log statements into a single, comprehensive message rather than using separate log calls. This reduces log noise, improves readability, and can enhance performance by reducing the number of logging function calls.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Logging","language":"C","updated":"2021-02-08","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-consolidate-related-logging.md"},{"slug":"sentry-php-flexible-configuration-formats","title":"Flexible configuration formats","description":"Support multiple configuration formats where appropriate (string, callable, object) to accommodate different frameworks and usage patterns. This improves developer experience across different ecosystems (like Laravel, Symfony) while maintaining type safety through proper validation.","repository":"getsentry/sentry-php","domain":"observability","topic":"Configurations","language":"PHP","updated":"2021-01-28","comments":4,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-flexible-configuration-formats.md"},{"slug":"fastapi-use-appropriate-documentation-formats","title":"Use appropriate documentation formats","description":"Choose the most suitable documentation format based on context to maximize\\ \\ readability and information value. \\n\\nFor Pydantic models:\\n- Use class-level\\ \\ docstrings for comprehensive documentation that supports rich formatting including\\ \\ newlines and emphasis","repository":"fastapi/fastapi","domain":"app-frameworks","topic":"Documentation","language":"Python","updated":"2021-01-21","comments":2,"stars":86871,"raw":"https://awesomereviewers.com/raw/fastapi-use-appropriate-documentation-formats.md"},{"slug":"kubeflow-consistent-separator-conventions","title":"Consistent separator conventions","description":"Use appropriate separators in compound identifiers to improve readability and ensure naming consistency across the codebase. Specifically: 1. Use hyphens to separate words in multi-word paths, repository names, and other resources:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Naming Conventions","language":"Markdown","updated":"2021-01-04","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-consistent-separator-conventions.md"},{"slug":"frp-document-code-decisions","title":"Document code decisions","description":"Always include clear documentation for important code decisions and metadata. This includes preserving copyright notices and explaining the reasoning behind specific values and constants.","repository":"fatedier/frp","domain":"cloud-infra","topic":"Documentation","language":"Go","updated":"2020-12-28","comments":2,"stars":95938,"raw":"https://awesomereviewers.com/raw/frp-document-code-decisions.md"},{"slug":"ink-ensure-documentation-usability","title":"Ensure documentation usability","description":"Documentation should be practical and serve its intended audience effectively. Examples must be runnable out-of-the-box or include clear setup instructions, while API documentation should focus on public interfaces that users actually need.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"Documentation","language":"JavaScript","updated":"2020-12-27","comments":2,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-ensure-documentation-usability.md"},{"slug":"kubeflow-configurable-security-with-defaults","title":"Configurable security with defaults","description":"Make security features configurable through environment variables or configuration files, but always implement secure defaults. This allows teams to adapt security controls to their specific deployment environments while maintaining a secure baseline.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Security","language":"Python","updated":"2020-12-23","comments":1,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-configurable-security-with-defaults.md"},{"slug":"cypress-prefer-standard-terminology","title":"Prefer standard terminology","description":"Use widely accepted industry-standard names and conventions rather than descriptive but non-standard alternatives. This improves code readability and maintainability by leveraging established terminology that developers are already familiar with.","repository":"cypress-io/cypress","domain":"devtools","topic":"Naming Conventions","language":"JSX","updated":"2020-12-20","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-prefer-standard-terminology.md"},{"slug":"ink-prefer-idiomatic-patterns","title":"prefer idiomatic patterns","description":"Choose language-native methods and control structures that make code more readable and maintainable. Use built-in functions instead of manual implementations, select appropriate control flow structures, and write explicit code that clearly communicates intent.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"Code Style","language":"JavaScript","updated":"2020-12-19","comments":4,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-prefer-idiomatic-patterns.md"},{"slug":"ink-use-descriptive-names","title":"Use descriptive names","description":"Choose variable, function, and export names that clearly communicate their purpose and content. Avoid abbreviations and ambiguous terms that could mislead other developers about what the identifier represents.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"Naming Conventions","language":"JavaScript","updated":"2020-12-19","comments":3,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-use-descriptive-names.md"},{"slug":"nuxt-semantic-names-with-counters","title":"semantic names with counters","description":"When generating unique identifiers that may have multiple instances, combine semantic base names with counters or indices to ensure both readability and uniqueness. Use meaningful component names, scope IDs, or descriptive strings as the base, then append a counter to distinguish multiple instances.","repository":"nuxt/nuxt","domain":"app-frameworks","topic":"Naming Conventions","language":"JavaScript","updated":"2020-12-16","comments":2,"stars":57769,"raw":"https://awesomereviewers.com/raw/nuxt-semantic-names-with-counters.md"},{"slug":"go-use-conventional-descriptive-names","title":"Use conventional descriptive names","description":"Variable names should follow established language conventions and clearly communicate their purpose and context. Avoid abbreviated or cryptic names in favor of descriptive identifiers that make code self-documenting.","repository":"golang/go","domain":"runtimes","topic":"Naming Conventions","language":"Go","updated":"2020-12-15","comments":2,"stars":129599,"raw":"https://awesomereviewers.com/raw/go-use-conventional-descriptive-names.md"},{"slug":"compose-prefer-explicit-readability","title":"prefer explicit readability","description":"Choose explicit, readable code constructs over \"clever\" or overly complex ones. Complex functional programming constructs, intricate ternary operators, and large list comprehensions can make code harder to understand and maintain.","repository":"docker/compose","domain":"orchestration","topic":"Code Style","language":"Python","updated":"2020-12-02","comments":3,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-prefer-explicit-readability.md"},{"slug":"compose-avoid-mutable-defaults","title":"avoid mutable defaults","description":"Never use mutable objects (lists, dictionaries, sets) as default parameter values in function definitions. This creates a shared object across all function calls, leading to unexpected behavior where modifications persist between calls.","repository":"docker/compose","domain":"orchestration","topic":"Null Handling","language":"Python","updated":"2020-12-01","comments":3,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-avoid-mutable-defaults.md"},{"slug":"frp-follow-go-naming-conventions","title":"Follow Go naming conventions","description":"Adhere to Go's standard naming conventions for identifiers:\\n\\n1. **Control\\ \\ visibility with capitalization**:\\n   - Use uppercase first letter for exported\\ \\ (public) identifiers","repository":"fatedier/frp","domain":"cloud-infra","topic":"Naming Conventions","language":"Go","updated":"2020-11-25","comments":4,"stars":95938,"raw":"https://awesomereviewers.com/raw/frp-follow-go-naming-conventions.md"},{"slug":"nest-manage-testing-dependencies","title":"Manage testing dependencies","description":"Properly manage testing-related dependencies by placing them in devDependencies and regularly auditing them to remove redundant tools. Test-only packages should never appear in regular dependencies, and outdated testing libraries should be removed when newer alternatives are already present in the project.","repository":"nestjs/nest","domain":"app-frameworks","topic":"Testing","language":"Json","updated":"2020-11-22","comments":2,"stars":71766,"raw":"https://awesomereviewers.com/raw/nest-manage-testing-dependencies.md"},{"slug":"nest-test-dependency-management","title":"Test dependency management","description":"Testing tools and libraries should be placed in `devDependencies` rather than regular dependencies in package.json. Regularly review testing dependencies to identify and remove outdated or redundant packages. For example, if a newer testing tool now includes functionality previously provided by a separate package (like 'nyc' now depending on...","repository":"nestjs/nest","domain":"app-frameworks","topic":"Testing","language":"Json","updated":"2020-11-22","comments":2,"stars":71767,"raw":"https://awesomereviewers.com/raw/nest-test-dependency-management.md"},{"slug":"sentry-php-purposeful-documentation-standards","title":"Purposeful documentation standards","description":"Documentation should convey purpose and behavior, not just replicate code structure. Each docblock should explain what a component does and why it exists, rather than merely restating its name or signature.","repository":"getsentry/sentry-php","domain":"observability","topic":"Documentation","language":"PHP","updated":"2020-11-16","comments":10,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-purposeful-documentation-standards.md"},{"slug":"ncnn-validate-by-file-header","title":"Validate by File Header","description":"When parsing untrusted files (e.g., images), do not choose decode/encode logic based on filename suffix/substring (e.g., “.pgm/.ppm/.jpg”). Instead, detect the actual format using file content (magic bytes/header) and only proceed if it matches supported signatures; otherwise fail safely.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Security","language":"C++","updated":"2020-11-13","comments":1,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-validate-by-file-header.md"},{"slug":"tokenizers-pythonic-api-design","title":"Pythonic API design","description":"Design APIs that follow Python language conventions and idioms rather than blindly mirroring the underlying implementation language. Consider what would feel most natural to Python developers in terms of parameter ordering, default values, and call patterns.","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"API","language":"Python","updated":"2020-11-11","comments":3,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-pythonic-api-design.md"},{"slug":"swift-document-api-stability","title":"Document API stability","description":"When working with AI frameworks and machine learning libraries, clearly document the stability state of APIs being used. For experimental or evolving features:","repository":"tensorflow/swift","domain":"ml-systems","topic":"AI","language":"Other","updated":"2020-10-27","comments":3,"stars":6136,"raw":"https://awesomereviewers.com/raw/swift-document-api-stability.md"},{"slug":"aws-sdk-js-accurate-type-signatures","title":"Accurate type signatures","description":"When defining API interfaces in TypeScript, ensure that method signatures accurately reflect the actual behavior and requirements of the implementation. Pay special attention to:","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"API","language":"TypeScript","updated":"2020-10-24","comments":2,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-accurate-type-signatures.md"},{"slug":"tokenizers-choose-optimal-data-structures","title":"Choose optimal data structures","description":"Select data structures based on their algorithmic complexity and usage patterns. Consider the tradeoffs between different structures (e.g., Vec vs HashMap) and their impact on performance. Key considerations:","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"Algorithms","language":"Rust","updated":"2020-10-23","comments":4,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-choose-optimal-data-structures.md"},{"slug":"gin-use-standard-api-constants","title":"Use standard API constants","description":"Always use standard library constants for HTTP methods and status codes rather than string literals or numeric values. This improves code readability, prevents typos, and makes it easier to maintain API consistency.","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"API","language":"Go","updated":"2020-10-23","comments":3,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-use-standard-api-constants.md"},{"slug":"cloudsplaining-configure-loggers-consistently","title":"Configure loggers consistently","description":"Always configure module-level loggers with a consistent pattern across the codebase. Use `logging.getLogger(__name__)` to create loggers that match the module hierarchy, set appropriate default levels (typically WARNING for library code), use standardized formatting that includes timestamp, logger name, level, and message, and provide mechanisms to adjust...","repository":"salesforce/cloudsplaining","domain":"security","topic":"Logging","language":"Python","updated":"2020-10-23","comments":2,"stars":2100,"raw":"https://awesomereviewers.com/raw/cloudsplaining-configure-loggers-consistently.md"},{"slug":"aws-sdk-js-content-integrity-verification","title":"Content integrity verification","description":"When handling HTTP responses, especially with streaming data, properly verify content integrity and length to prevent data corruption or unexpected termination. Key considerations:","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Networking","language":"JavaScript","updated":"2020-10-20","comments":5,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-content-integrity-verification.md"},{"slug":"ink-provide-clear-documentation-context","title":"Provide clear documentation context","description":"Documentation should include practical context, clear explanations, and appropriate examples to help users understand both what functionality does and when to use it. Avoid confusing technical jargon and provide concrete use cases.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"2020-10-19","comments":3,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-provide-clear-documentation-context.md"},{"slug":"tokenizers-purpose-indicating-descriptive-names","title":"Purpose-indicating descriptive names","description":"Choose names for variables, methods, parameters, and fixtures that clearly communicate their purpose, content, and behavior. Names should be self-documenting and consider future code evolution.","repository":"huggingface/tokenizers","domain":"ml-systems","topic":"Naming Conventions","language":"Python","updated":"2020-10-13","comments":3,"stars":9868,"raw":"https://awesomereviewers.com/raw/tokenizers-purpose-indicating-descriptive-names.md"},{"slug":"kubeflow-prioritize-readability-over-brevity","title":"Prioritize readability over brevity","description":"When writing code, favor readability and maintainability over clever or compact solutions. Break down complex logic into smaller, well-named functions with clear purposes rather than embedding all logic in a single function.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Code Style","language":"Python","updated":"2020-09-24","comments":4,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-prioritize-readability-over-brevity.md"},{"slug":"sentry-php-keep-testing-dependencies-current","title":"Keep testing dependencies current","description":"Regularly update testing framework dependencies (PHPUnit, PHPStan, etc.) to maintain compatibility with your project''s PHP version requirements and ensure access to new testing features. When updating dependencies, consider future compatibility needs by using appropriate version constraints.","repository":"getsentry/sentry-php","domain":"observability","topic":"Testing","language":"Json","updated":"2020-09-23","comments":2,"stars":1873,"raw":"https://awesomereviewers.com/raw/sentry-php-keep-testing-dependencies-current.md"},{"slug":"kubeflow-document-code-thoroughly","title":"Document code thoroughly","description":"Always include appropriate documentation in your code to improve readability, maintainability, and usability: 1. **Document all public APIs** with Go doc comments:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Documentation","language":"Go","updated":"2020-09-21","comments":4,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-document-code-thoroughly.md"},{"slug":"spring-framework-use-appropriate-collections","title":"Use appropriate collections","description":"Choose the right collection implementation for each algorithmic task to optimize both performance and readability. Use Sets for operations requiring uniqueness, TreeMap for maintaining sorted keys, and leverage built-in collection methods rather than implementing operations manually.","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"Algorithms","language":"Java","updated":"2020-08-03","comments":6,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-use-appropriate-collections.md"},{"slug":"swift-teach-by-example","title":"Teach by example","description":"Present concepts through clear, focused examples that demonstrate features positively rather than through comparisons or criticisms of alternative approaches. Allow readers to discover benefits through well-constructed examples rather than explicit statements about superiority.","repository":"tensorflow/swift","domain":"ml-systems","topic":"Documentation","language":"Other","updated":"2020-07-20","comments":5,"stars":6136,"raw":"https://awesomereviewers.com/raw/swift-teach-by-example.md"},{"slug":"kotlin-use-configuration-property-providers","title":"Use configuration property providers","description":"Always use Gradle's Provider API when accessing project, system, or Gradle properties in your build configuration. This ensures proper handling of configuration cache and allows for dynamic property updates.","repository":"JetBrains/kotlin","domain":"runtimes","topic":"Configurations","language":"Kotlin","updated":"2020-07-17","comments":7,"stars":50857,"raw":"https://awesomereviewers.com/raw/kotlin-use-configuration-property-providers.md"},{"slug":"compose-avoid-confusing-names","title":"Avoid confusing names","description":"Choose clear, unambiguous names that don't shadow existing identifiers or create confusion about their purpose. Avoid variable names that shadow method names, class names, or built-in functions, as this makes code harder to understand and can suggest incorrect behavior like recursive calls.","repository":"docker/compose","domain":"orchestration","topic":"Naming Conventions","language":"Python","updated":"2020-07-06","comments":2,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-avoid-confusing-names.md"},{"slug":"query-short-circuit-for-performance","title":"Short-Circuit for Performance","description":"In performance-sensitive code paths, minimize unnecessary work by ordering conditions to short-circuit early, and avoid redundant async wrappers. **Apply these rules:**","repository":"tanstack/query","domain":"app-frameworks","topic":"Performance Optimization","language":"JavaScript","updated":"2020-06-26","comments":3,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-short-circuit-for-performance.md"},{"slug":"ink-useeffect-for-measurements","title":"useEffect for measurements","description":"When using functions that depend on rendered layout or DOM measurements, call them within useEffect hooks to ensure they execute after the component has rendered and layout calculations are complete.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"React","language":"Markdown","updated":"2020-06-20","comments":2,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-useeffect-for-measurements.md"},{"slug":"ncnn-append-only-compatibility","title":"Append Only Compatibility","description":"When a generated API surface (e.g., an enum/type-id) is derived from the order of a registration list, treat that order as part of the public/binary API. Never reorder, insert in the middle, or remove/disable entries in that list—add new items only by appending at the end.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"API","language":"Txt","updated":"2020-06-07","comments":3,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-append-only-compatibility.md"},{"slug":"compose-pin-git-dependencies","title":"Pin git dependencies","description":"When using git references for dependencies in configuration files like requirements.txt, always pin to specific commit SHAs instead of branch names to ensure reproducible builds and prevent unexpected changes from being automatically pulled in.","repository":"docker/compose","domain":"orchestration","topic":"Configurations","language":"Txt","updated":"2020-05-29","comments":2,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-pin-git-dependencies.md"},{"slug":"cypress-structured-debug-logging","title":"structured debug logging","description":"Use structured logging with object notation instead of string interpolation for debug messages to improve readability and provide better structured data. This approach makes logs more consistent and easier to parse, while also helping to consolidate related information into single log statements.","repository":"cypress-io/cypress","domain":"devtools","topic":"Logging","language":"Other","updated":"2020-05-26","comments":3,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-structured-debug-logging.md"},{"slug":"query-prefer-explicit-rtl-assertions","title":"Prefer explicit RTL assertions","description":"In React Testing Library tests, keep assertions outside components, and rely on proper global teardown. - Teardown/cleanup: Since RTL v9, `cleanup()` is automatic when RTL is configured normally. Only call `cleanup()` manually if your test setup does not provide an `afterEach`.","repository":"tanstack/query","domain":"app-frameworks","topic":"Testing","language":"JavaScript","updated":"2020-05-15","comments":4,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-prefer-explicit-rtl-assertions.md"},{"slug":"query-active-cache-config-safety","title":"Active Cache & Config Safety","description":"When implementing caching layers/providers and cache-driven handlers: - **Assume multiple cache instances may exist.** Avoid single “default cache” globals for runtime behaviors (e.g., focus handlers). Track **all active caches** and update/notify each.","repository":"tanstack/query","domain":"app-frameworks","topic":"Caching","language":"JavaScript","updated":"2020-05-14","comments":4,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-active-cache-config-safety.md"},{"slug":"compose-add-logging-without-duplication","title":"Add logging without duplication","description":"When adding logging functionality to existing code, encapsulate the logging logic within methods or use parameters to avoid code duplication and maintain clean interfaces. Add informational logging (debug/info level) to provide visibility into system operations, especially for default behaviors and skipped actions, but avoid duplicating conditional checks...","repository":"docker/compose","domain":"orchestration","topic":"Logging","language":"Python","updated":"2020-05-06","comments":6,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-add-logging-without-duplication.md"},{"slug":"octokit.net-design-intuitive-api-methods","title":"Design intuitive API methods","description":"When designing API methods, prioritize intuitive usage patterns and backwards compatibility. Follow these guidelines: 1. Order parameters from required to optional, maintaining consistency across overloads:","repository":"octokit/octokit.net","domain":"devtools","topic":"API","language":"C#","updated":"2020-04-14","comments":5,"stars":2793,"raw":"https://awesomereviewers.com/raw/octokit.net-design-intuitive-api-methods.md"},{"slug":"yoga-safe-configuration-definitions","title":"Safe configuration definitions","description":"When defining configuration flags and options, use practices that ensure compatibility across different preprocessors and build environments. For macro-based configuration flags, use integer values (0/1) instead of boolean literals (true/false) to avoid preprocessor compatibility issues. Additionally, consider using runtime configuration mechanisms (like...","repository":"facebook/yoga","domain":"runtimes","topic":"Configurations","language":"C++","updated":"2020-04-08","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-safe-configuration-definitions.md"},{"slug":"ink-use-reactfc-consistently","title":"Use React.FC consistently","description":"Use React.FC (or React.FunctionComponent) for typing functional components instead of verbose function type definitions. React.FC provides built-in typing for common props like children, key, and ref, reducing boilerplate and ensuring consistency across the codebase.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"React","language":"TSX","updated":"2020-04-05","comments":2,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-use-reactfc-consistently.md"},{"slug":"ncnn-build-script-ordering","title":"Build Script Ordering","description":"In build/configuration files (e.g., CMakeLists), keep statements organized so that they are (1) scoped to the conditions that actually enable the associated sources/targets, and (2) ordered deterministically (e.g., alphabetical for registration lists).","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Code Style","language":"Txt","updated":"2020-03-30","comments":2,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-build-script-ordering.md"},{"slug":"query-propagate-and-test-errors","title":"Propagate and Test Errors","description":"Handle errors at the right boundary, keep failure state consistent, and ensure tests validate the real semantics. Apply these rules: 1) Don’t swallow errors inside reusable helpers.","repository":"tanstack/query","domain":"app-frameworks","topic":"Error Handling","language":"JavaScript","updated":"2020-03-27","comments":3,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-propagate-and-test-errors.md"},{"slug":"query-null-safe-optional-handling","title":"Null-Safe Optional Handling","description":"When dealing with possibly missing or nullable values (especially globals and config), make null/undefined handling explicit and never call a value unless you’ve verified its type.","repository":"tanstack/query","domain":"app-frameworks","topic":"Null Handling","language":"JavaScript","updated":"2020-03-27","comments":2,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-null-safe-optional-handling.md"},{"slug":"ink-avoid-any-type-usage","title":"avoid `any` type usage","description":"Replace `any` type annotations with more specific types to improve type safety and null handling. The `any` type disables TypeScript's type checking, including null safety checks, making code prone to runtime errors.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"Null Handling","language":"TSX","updated":"2020-03-26","comments":4,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-avoid-any-type-usage.md"},{"slug":"aws-sdk-js-document-sdk-version-requirements","title":"Document sdk version requirements","description":"Always explicitly document AWS SDK version requirements in your project, and include configuration instructions for different deployment environments. This is especially critical for Lambda functions where the runtime may include its own SDK version.","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Configurations","language":"Markdown","updated":"2020-03-23","comments":2,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-document-sdk-version-requirements.md"},{"slug":"ink-clear-api-interfaces","title":"Clear API interfaces","description":"Ensure API interfaces are clearly defined with proper formatting and comprehensive documentation. Type definitions should use consistent formatting with appropriate line breaks for complex objects, and documentation should precisely explain callback behavior, timing, and parameters.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"2020-03-22","comments":2,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-clear-api-interfaces.md"},{"slug":"opentelemetry-python-track-observability-api-changes","title":"Track observability API changes","description":"Stay informed about API changes in observability libraries like OpenTelemetry, especially during their active development phases. Ensure that both implementation code and documentation are updated to reflect the current API patterns.","repository":"open-telemetry/opentelemetry-python","domain":"observability","topic":"Observability","language":"Other","updated":"2020-03-03","comments":2,"stars":2061,"raw":"https://awesomereviewers.com/raw/opentelemetry-python-track-observability-api-changes.md"},{"slug":"kubeflow-enforce-https-protocol","title":"Enforce HTTPS protocol","description":"Always validate that URLs use the HTTPS protocol in both implementation code and validation error messages. Even if your application might handle HTTP-to-HTTPS redirects, enforce HTTPS from the outset as a security best practice to prevent man-in-the-middle attacks and data exposure.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Security","language":"TypeScript","updated":"2020-02-20","comments":1,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-enforce-https-protocol.md"},{"slug":"cypress-use-precise-networking-terminology","title":"Use precise networking terminology","description":"When writing error messages or documentation related to network requests and cross-origin policies, use precise terminology that accurately describes the scope of the issue. Prefer \"URL\" over \"domain\" when the problem could involve any URL component (protocol, port, path, etc.), not just the domain name. Use proper technical terms like \"origin\" when...","repository":"cypress-io/cypress","domain":"devtools","topic":"Networking","language":"Other","updated":"2020-02-18","comments":4,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-use-precise-networking-terminology.md"},{"slug":"deeplearning4j-minimize-object-allocations","title":"Minimize object allocations","description":"Avoid creating unnecessary temporary objects or arrays which can impact performance through increased garbage collection and memory pressure. Apply these techniques to optimize memory usage:","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Performance Optimization","language":"Java","updated":"2020-02-17","comments":4,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-minimize-object-allocations.md"},{"slug":"cypress-clear-security-error-messages","title":"Clear security error messages","description":"When implementing security restrictions or policies, ensure error messages clearly explain what the security boundary is, why it exists, and what specifically triggered the violation. Vague or technical jargon can leave developers confused about security requirements.","repository":"cypress-io/cypress","domain":"devtools","topic":"Security","language":"Other","updated":"2020-02-04","comments":1,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-clear-security-error-messages.md"},{"slug":"kubeflow-contextualize-and-classify-errors","title":"Contextualize and classify errors","description":"Always provide meaningful context when handling errors, and classify them appropriately based on their source. This improves debugging, helps users understand issues, and creates a consistent approach to error handling across the codebase.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Error Handling","language":"Go","updated":"2020-01-21","comments":4,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-contextualize-and-classify-errors.md"},{"slug":"compose-environment-variable-safety","title":"Environment variable safety","description":"Always use `os.environ.get()` instead of direct dictionary access when reading environment variables to avoid KeyError exceptions. Establish clear precedence rules where command line options override environment variables, and log conflicts appropriately when incompatible configuration sources are detected.","repository":"docker/compose","domain":"orchestration","topic":"Configurations","language":"Python","updated":"2020-01-11","comments":3,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-environment-variable-safety.md"},{"slug":"boto3-keep-ci-configurations-updated","title":"Keep CI configurations updated","description":"Regularly review and update CI configuration files to remove obsolete settings and use appropriate version specifications based on current platform capabilities. This minimizes configuration overhead, reduces maintenance burden, and ensures your CI pipeline remains efficient.","repository":"boto/boto3","domain":"cloud-infra","topic":"CI/CD","language":"Yaml","updated":"2020-01-10","comments":2,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-keep-ci-configurations-updated.md"},{"slug":"compose-use-standard-api-fields","title":"Use standard API fields","description":"When designing APIs or interfaces, prioritize using existing standard fields and patterns from established APIs rather than creating custom implementations. This ensures consistency across tools and reduces cognitive load for users.","repository":"docker/compose","domain":"orchestration","topic":"API","language":"Python","updated":"2020-01-09","comments":4,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-use-standard-api-fields.md"},{"slug":"query-deterministic-async-lifecycle","title":"Deterministic Async Lifecycle","description":"Ensure async features that depend on a query/promise’s lifecycle (e.g., cancellation hooks, query function availability) are wired using a deterministic initialization order. Don’t write code paths that assume `query`/`query.promise` already exists; either (a) centralize initialization (e.g., reuse a prefetch-like path) or (b) explicitly create/transition...","repository":"tanstack/query","domain":"app-frameworks","topic":"Concurrency","language":"JavaScript","updated":"2020-01-09","comments":2,"stars":49380,"raw":"https://awesomereviewers.com/raw/query-deterministic-async-lifecycle.md"},{"slug":"deeplearning4j-always-secure-your-locks","title":"Always secure your locks","description":"When using locks or other synchronization mechanisms in concurrent code, always release locks in a finally block to ensure they are released even when exceptions occur. Failure to do so can lead to deadlocks if other threads need the same lock.","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Concurrency","language":"Java","updated":"2019-12-06","comments":3,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-always-secure-your-locks.md"},{"slug":"swift-format-for-readability","title":"Format for readability","description":"Code should be formatted to optimize readability. Apply these key practices: 1. **Maintain reasonable line length** (typically 100 columns) by breaking long lines of code. For function declarations with multiple parameters or long statements, wrap them across lines with proper indentation:","repository":"tensorflow/swift","domain":"ml-systems","topic":"Code Style","language":"Other","updated":"2019-12-04","comments":3,"stars":6136,"raw":"https://awesomereviewers.com/raw/swift-format-for-readability.md"},{"slug":"swift-mathematical-precision-matters","title":"Mathematical precision matters","description":"When implementing mathematical algorithms, ensure precise terminology and correct implementation of mathematical concepts. This is especially important for complex domains like differentiation, optimization, or numerical methods.","repository":"tensorflow/swift","domain":"ml-systems","topic":"Algorithms","language":"Markdown","updated":"2019-11-26","comments":4,"stars":6136,"raw":"https://awesomereviewers.com/raw/swift-mathematical-precision-matters.md"},{"slug":"kubeflow-stable-configuration-management","title":"Stable configuration management","description":"Always ensure configuration values are managed consistently and sourced\\ \\ from stable locations. \\n\\n1. Use defined constants instead of string literals\\ \\ for configuration values to improve maintainability and reduce errors when values\\ \\ change","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Configurations","language":"TSX","updated":"2019-11-25","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-stable-configuration-management.md"},{"slug":"compose-precise-security-pattern-matching","title":"precise security pattern matching","description":"When checking for security features or configurations in shell scripts, use precise pattern matching to avoid false positives and limit information exposure. Instead of broad substring matches that could match unintended content, use specific patterns and restrict output to only necessary information.","repository":"docker/compose","domain":"orchestration","topic":"Security","language":"Shell","updated":"2019-11-22","comments":1,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-precise-security-pattern-matching.md"},{"slug":"ink-verify-packagejson-accuracy","title":"Verify package.json accuracy","description":"Ensure that package.json configuration entries accurately reflect the actual project structure and include complete, working settings. Incorrect or incomplete package.json configuration can cause runtime failures and deployment issues.","repository":"vadimdemedes/ink","domain":"app-frameworks","topic":"Configurations","language":"Markdown","updated":"2019-11-13","comments":2,"stars":31825,"raw":"https://awesomereviewers.com/raw/ink-verify-packagejson-accuracy.md"},{"slug":"gin-close-resource-handles-properly","title":"Close resource handles properly","description":"Always close file resources and other system handles after use to prevent resource leaks. Resource leaks can cause system instability, memory issues, and limit scalability, especially in long-running services handling many requests.","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"Error Handling","language":"Markdown","updated":"2019-11-01","comments":2,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-close-resource-handles-properly.md"},{"slug":"gin-document-api-behavior","title":"Document API behavior","description":"Thoroughly document how your API endpoints handle data binding and processing, especially non-obvious behaviors that affect how client data is mapped to server-side structures. This includes:","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2019-11-01","comments":2,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-document-api-behavior.md"},{"slug":"deeplearning4j-document-ai-apis-completely","title":"Document AI APIs completely","description":"When developing AI libraries and tools, provide comprehensive and accurate API documentation that helps users navigate complex functionality. Documentation should:","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"AI","language":"Markdown","updated":"2019-10-24","comments":4,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-document-ai-apis-completely.md"},{"slug":"deeplearning4j-maintain-proper-capitalization","title":"Maintain proper capitalization","description":"Always use correct and consistent capitalization for product names, class names, and method names throughout code and documentation. Pay special attention to:","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Naming Conventions","language":"Markdown","updated":"2019-10-21","comments":2,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-maintain-proper-capitalization.md"},{"slug":"kubeflow-isolate-test-cases","title":"Isolate test cases","description":"Create separate test functions for distinct functionality to improve test clarity and make failure points more obvious. When writing tests, avoid combining multiple scenarios into a single test function.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Testing","language":"Python","updated":"2019-10-18","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-isolate-test-cases.md"},{"slug":"cypress-improve-code-expressiveness","title":"Improve code expressiveness","description":"Write code that clearly communicates its intent through expressive method names and simplified control flow. Replace complex inline conditions with descriptive method calls that encapsulate the logic, and use early returns to reduce cyclomatic complexity and focus functions on their primary responsibility.","repository":"cypress-io/cypress","domain":"devtools","topic":"Code Style","language":"JSX","updated":"2019-10-16","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-improve-code-expressiveness.md"},{"slug":"swift-follow-swift-naming-conventions","title":"Follow Swift naming conventions","description":"Ensure code follows established Swift naming conventions and remains consistent with domain terminology: 1. Use standard Swift parameter labels (e.g., use `named:` instead of `called:`):","repository":"tensorflow/swift","domain":"ml-systems","topic":"Naming Conventions","language":"Swift","updated":"2019-10-11","comments":3,"stars":6136,"raw":"https://awesomereviewers.com/raw/swift-follow-swift-naming-conventions.md"},{"slug":"compose-minimize-credential-access-scope","title":"minimize credential access scope","description":"Apply the principle of least privilege when managing credentials in CI/CD pipelines and application code. Use credentials that are limited to only the specific permissions required for the task, and remove credentials entirely when they're not needed. This reduces security risk by limiting potential access if credentials are compromised and makes credential...","repository":"docker/compose","domain":"orchestration","topic":"Security","language":"Other","updated":"2019-09-13","comments":1,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-minimize-credential-access-scope.md"},{"slug":"deeplearning4j-optimize-hardware-acceleration","title":"Optimize hardware acceleration","description":"AI systems should use the most performant hardware acceleration libraries and carefully manage hardware-specific dependencies. Prefer Intel MKL over OpenBLAS for CPU operations as it provides superior performance for matrix calculations critical to neural networks and machine learning algorithms. Keep CPU and GPU dependencies cleanly separated to support...","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"AI","language":"Xml","updated":"2019-09-11","comments":2,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-optimize-hardware-acceleration.md"},{"slug":"aws-sdk-js-validate-configurations-with-clarity","title":"Validate configurations with clarity","description":"Configuration validation should use explicit checks and clear conditional logic to improve code readability and prevent errors. When validating configuration values:","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Configurations","language":"JavaScript","updated":"2019-09-06","comments":3,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-validate-configurations-with-clarity.md"},{"slug":"gin-minimize-configuration-complexity","title":"Minimize configuration complexity","description":"Keep configuration files clean and maintainable by regularly reviewing and removing unnecessary settings and outdated version support. This includes:","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"Configurations","language":"Yaml","updated":"2019-09-04","comments":2,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-minimize-configuration-complexity.md"},{"slug":"linux-prefer-early-returns","title":"Prefer early returns","description":"When a function can determine an early result based on input validation or special cases, return immediately rather than assigning to a temporary variable and having a single exit point. Early returns reduce nesting, improve readability, and often result in more efficient code by making guard conditions more visible.","repository":"torvalds/linux","domain":"runtimes","topic":"Code Style","language":"C","updated":"2019-09-02","comments":2,"stars":197350,"raw":"https://awesomereviewers.com/raw/linux-prefer-early-returns.md"},{"slug":"frp-focus-documentation-content","title":"Focus documentation content","description":"Maintain streamlined primary documentation (like README files) that focuses only on currently supported functionality and recommended approaches. Move specialized details, legacy systems, or deprecated methods to secondary documentation sources like wikis or specialized guides.","repository":"fatedier/frp","domain":"cloud-infra","topic":"Documentation","language":"Markdown","updated":"2019-08-31","comments":2,"stars":95938,"raw":"https://awesomereviewers.com/raw/frp-focus-documentation-content.md"},{"slug":"aws-sdk-js-standardize-api-promise-patterns","title":"Standardize API promise patterns","description":"When adding promise support to API methods, implement a consistent pattern that handles both callback-style and multi-parameter methods. Use a standardized promisification approach that appends the promise-determining callback as the last argument.","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"API","language":"JavaScript","updated":"2019-08-27","comments":2,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-standardize-api-promise-patterns.md"},{"slug":"swift-swift-idiomatic-naming","title":"Swift idiomatic naming","description":"Follow Swift''s naming conventions to write more readable, maintainable code. The Swift language emphasizes clarity and expressiveness in naming: 1. **Avoid `get` prefixes** in function and method names. In Swift, properties and zero-argument methods serve this purpose without the prefix.","repository":"tensorflow/swift","domain":"ml-systems","topic":"Naming Conventions","language":"Other","updated":"2019-08-05","comments":3,"stars":6136,"raw":"https://awesomereviewers.com/raw/swift-swift-idiomatic-naming.md"},{"slug":"swift-generic-algorithm-design","title":"Generic algorithm design","description":"When implementing generic algorithms in Swift, follow these best practices to improve code clarity and performance: 1. Place type constraints directly on associated types rather than at the protocol level:","repository":"tensorflow/swift","domain":"ml-systems","topic":"Algorithms","language":"Other","updated":"2019-08-03","comments":3,"stars":6136,"raw":"https://awesomereviewers.com/raw/swift-generic-algorithm-design.md"},{"slug":"deeplearning4j-user-friendly-documentation-examples","title":"User-friendly documentation examples","description":"Documentation should guide users toward best practices through clear examples. Begin with positive patterns before covering pitfalls, clarify all function parameters, and recommend appropriate methods for common tasks.","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Documentation","language":"Markdown","updated":"2019-07-25","comments":5,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-user-friendly-documentation-examples.md"},{"slug":"deeplearning4j-use-modern-api-methods","title":"Use modern API methods","description":"When implementing algorithms with numerical libraries like ND4J, always prefer the most direct and type-safe API methods over older patterns. This improves code clarity, prevents subtle bugs, and often leads to better performance.","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Algorithms","language":"Markdown","updated":"2019-07-01","comments":4,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-use-modern-api-methods.md"},{"slug":"svelte-validate-configuration-interdependencies","title":"Validate configuration interdependencies","description":"When configuration options have logical dependencies or constraints, implement both smart defaults and validation checks to ensure consistent behavior. Set dependent options to appropriate default values based on other configuration values, and validate that the final combination of options represents a valid state.","repository":"sveltejs/svelte","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"2019-04-24","comments":2,"stars":83580,"raw":"https://awesomereviewers.com/raw/svelte-validate-configuration-interdependencies.md"},{"slug":"swift-follow-swift-conventions","title":"Follow Swift conventions","description":"When designing and documenting APIs in Swift, adhere to Swift''s established naming conventions and documentation practices: 1. **Use correct initializer syntax**: Swift initializers should not form phrases with argument labels. Avoid prepositions in argument labels.","repository":"tensorflow/swift","domain":"ml-systems","topic":"API","language":"Markdown","updated":"2019-04-23","comments":2,"stars":6136,"raw":"https://awesomereviewers.com/raw/swift-follow-swift-conventions.md"},{"slug":"compose-consistent-formatting-choices","title":"consistent formatting choices","description":"Maintain consistent formatting and style choices throughout your codebase to improve readability and maintainability. This includes consistent variable syntax, proper quoting practices, and organized list formatting.","repository":"docker/compose","domain":"orchestration","topic":"Code Style","language":"Other","updated":"2019-04-15","comments":4,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-consistent-formatting-choices.md"},{"slug":"compose-optimize-docker-layer-caching","title":"optimize Docker layer caching","description":"Order Dockerfile instructions from least frequently changing to most frequently changing to maximize Docker layer caching efficiency and reduce build times in CI/CD pipelines.","repository":"docker/compose","domain":"orchestration","topic":"CI/CD","language":"Dockerfile","updated":"2019-04-15","comments":2,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-optimize-docker-layer-caching.md"},{"slug":"aws-sdk-js-isolate-sensitive-buffer-data","title":"Isolate sensitive buffer data","description":"When handling sensitive data in Node.js, protect against data leakage by isolating sensitive content in dedicated buffers. Node.js can create Buffers that aren't fully isolated, where `buf.byteLength !== buf.buffer.byteLength`, meaning sensitive data might be accessible to other code through the shared buffer memory.","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Security","language":"JavaScript","updated":"2019-04-15","comments":1,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-isolate-sensitive-buffer-data.md"},{"slug":"deeplearning4j-document-ai-implementation-references","title":"Document AI implementation references","description":"When implementing AI algorithms or neural network operations, document the sources of specific implementation choices, especially for parameters or techniques that might appear arbitrary or unusual at first glance. Include references to established AI frameworks, research papers, or model implementations that informed your approach.","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"AI","language":"C++","updated":"2019-04-11","comments":2,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-document-ai-implementation-references.md"},{"slug":"swift-document-environment-variables","title":"Document environment variables","description":"When using configurable components, clearly document all relevant environment variables and their effects. Include examples showing how to set variables for common use cases, and specify any platform-specific differences. For environment variables that affect runtime behavior, clearly document when they need to be set and any order dependencies.","repository":"tensorflow/swift","domain":"ml-systems","topic":"Configurations","language":"Other","updated":"2019-03-30","comments":4,"stars":6136,"raw":"https://awesomereviewers.com/raw/swift-document-environment-variables.md"},{"slug":"aws-sdk-js-early-return-after-errors","title":"Early return after errors","description":"When handling errors in asynchronous functions, always return immediately after invoking a callback with an error to prevent subsequent code execution. This avoids the risk of calling callbacks multiple times or continuing execution paths that assume success.","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Error Handling","language":"JavaScript","updated":"2019-03-22","comments":6,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-early-return-after-errors.md"},{"slug":"swift-provide-comprehensive-examples","title":"Provide comprehensive examples","description":"API documentation should include complete examples that demonstrate all key usage patterns. When documenting related functions (like differentiation APIs), provide examples for each variant to show their relationships and differences. Include examples that showcase both basic usage and advanced patterns.","repository":"tensorflow/swift","domain":"ml-systems","topic":"Documentation","language":"Markdown","updated":"2019-03-16","comments":3,"stars":6136,"raw":"https://awesomereviewers.com/raw/swift-provide-comprehensive-examples.md"},{"slug":"aws-sdk-js-structured-test-resource-management","title":"Structured test resource management","description":"Organize tests with proper resource lifecycle management to ensure reliability and maintainability. Create test resources once in `before` hooks rather than in individual tests, and clean them up in corresponding `after` hooks. For shared resources, use unique identifiers (e.g., timestamps) to prevent conflicts between test runs.","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Testing","language":"JavaScript","updated":"2019-03-13","comments":5,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-structured-test-resource-management.md"},{"slug":"swift-swift-style-consistency","title":"Swift style consistency","description":"Maintain consistent Swift style conventions throughout all code, including examples in documentation and comments. Follow these specific guidelines: 1. Use 4-space indentation for all Swift code","repository":"tensorflow/swift","domain":"ml-systems","topic":"Code Style","language":"Markdown","updated":"2019-03-08","comments":2,"stars":6136,"raw":"https://awesomereviewers.com/raw/swift-swift-style-consistency.md"},{"slug":"yoga-understand-undefined-value-semantics","title":"understand undefined value semantics","description":"Before modifying initialization patterns or removing static variables, investigate the semantic meaning of undefined values and object lifetimes in the existing codebase. What appears to be a memory leak or improper initialization may be intentional design.","repository":"facebook/yoga","domain":"runtimes","topic":"Null Handling","language":"C++","updated":"2019-03-05","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-understand-undefined-value-semantics.md"},{"slug":"octokit.net-use-asyncawait-pattern","title":"Use async/await pattern","description":"When designing or documenting API clients, always use the async/await pattern rather than blocking calls. Replace code that uses `.GetAwaiter().GetResult()` with proper async/await syntax to prevent potential deadlocks and improve application responsiveness.","repository":"octokit/octokit.net","domain":"devtools","topic":"API","language":"Markdown","updated":"2019-02-20","comments":4,"stars":2793,"raw":"https://awesomereviewers.com/raw/octokit.net-use-asyncawait-pattern.md"},{"slug":"swift-training-aware-ml-apis","title":"Training-aware ML APIs","description":"Design machine learning APIs with explicit parameters for distinguishing between training and inference phases rather than relying on global state or implicit context. This pattern enables concurrent training and testing, improves model reusability, and prevents subtle bugs in distributed training scenarios.","repository":"tensorflow/swift","domain":"ml-systems","topic":"AI","language":"Markdown","updated":"2019-02-19","comments":3,"stars":6136,"raw":"https://awesomereviewers.com/raw/swift-training-aware-ml-apis.md"},{"slug":"ncnn-preserve-backward-compatibility","title":"Preserve Backward Compatibility","description":"When making schema/proto changes, never remove (or repurpose) legacy layer parameters that existing models/configs rely on. For backward compatibility migrations, keep the old message/field definitions, mark them deprecated if appropriate, and implement translation/mapping to the new schema rather than dropping support.","repository":"Tencent/ncnn","domain":"ml-systems","topic":"Migrations","language":"Other","updated":"2019-02-12","comments":2,"stars":23205,"raw":"https://awesomereviewers.com/raw/ncnn-preserve-backward-compatibility.md"},{"slug":"kubeflow-prevent-xss-vulnerabilities","title":"Prevent XSS vulnerabilities","description":"Never directly concatenate untrusted data (like user inputs or API responses) into HTML strings, as this creates cross-site scripting (XSS) vulnerabilities. Instead, create the HTML structure first, then populate content using safe DOM manipulation methods like jQuery's .text() or native JavaScript's .textContent that automatically escape special characters.","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Security","language":"JavaScript","updated":"2019-02-11","comments":1,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-prevent-xss-vulnerabilities.md"},{"slug":"mxnet-avoid-eval-function","title":"Avoid eval function","description":"Never use the `eval()` function in Python code as it creates serious security vulnerabilities by executing arbitrary code at runtime. This can lead to code injection attacks when processing user inputs or data from untrusted sources.","repository":"apache/mxnet","domain":"ml-systems","topic":"Security","language":"Python","updated":"2019-01-30","comments":1,"stars":20801,"raw":"https://awesomereviewers.com/raw/mxnet-avoid-eval-function.md"},{"slug":"cypress-choose-appropriate-type-comparisons","title":"Choose appropriate type comparisons","description":"When implementing algorithms that compare or process different data types, carefully consider the level of type strictness required for your use case. Overly strict type checking (like `Object.prototype.toString`) may prevent useful operations, while overly loose checking may produce meaningless results.","repository":"cypress-io/cypress","domain":"devtools","topic":"Algorithms","language":"Other","updated":"2019-01-22","comments":2,"stars":48850,"raw":"https://awesomereviewers.com/raw/cypress-choose-appropriate-type-comparisons.md"},{"slug":"yoga-explicit-code-declarations","title":"explicit code declarations","description":"Always make code declarations explicit and consistent to improve readability and maintainability. This includes specifying all property attributes, using const for immutable parameters, and avoiding misleading naming conventions.","repository":"facebook/yoga","domain":"runtimes","topic":"Code Style","language":"Other","updated":"2019-01-04","comments":4,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-explicit-code-declarations.md"},{"slug":"deeplearning4j-parameterize-configuration-scripts","title":"Parameterize configuration scripts","description":"Configuration scripts should use variables for values that might change or are used in multiple places, such as paths, versions, and environment-specific settings. This improves maintainability, makes updates easier, and facilitates cross-platform support.","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Configurations","language":"Markdown","updated":"2019-01-01","comments":3,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-parameterize-configuration-scripts.md"},{"slug":"express-follow-standardjs-when-modifying","title":"Follow StandardJS when modifying","description":"When modifying existing code, update the touched lines to follow StandardJS conventions while preserving the style of untouched code. This ensures gradual, consistent adoption of StandardJS formatting.","repository":"expressjs/express","domain":"app-frameworks","topic":"Code Style","language":"JavaScript","updated":"2018-11-29","comments":7,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-follow-standardjs-when-modifying.md"},{"slug":"octokit.net-use-nullable-for-optionals","title":"Use nullable for optionals","description":"When a property or parameter represents an optional value that might be absent in requests or responses, use nullable types rather than non-nullable types with default values. This clearly distinguishes between \"not set\" and an explicit value, prevents sending unintended defaults in API requests, and properly handles missing values in API responses.","repository":"octokit/octokit.net","domain":"devtools","topic":"Null Handling","language":"C#","updated":"2018-11-07","comments":6,"stars":2793,"raw":"https://awesomereviewers.com/raw/octokit.net-use-nullable-for-optionals.md"},{"slug":"aws-sdk-js-document-apis-thoroughly","title":"Document APIs thoroughly","description":"All public API elements must be thoroughly documented with JSDoc annotations that clearly explain their purpose, parameters, return values, and default behaviors. Documentation should be precise, matching the actual code behavior rather than making assumptions or using misleading descriptions.","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Documentation","language":"JavaScript","updated":"2018-10-30","comments":6,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-document-apis-thoroughly.md"},{"slug":"aws-sdk-js-limit-cache-size","title":"Limit cache size","description":"Always implement size constraints on caches to prevent memory leaks and performance degradation. Unbounded caches can grow continuously and consume excessive memory, especially in long-running applications.","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Caching","language":"JavaScript","updated":"2018-10-30","comments":3,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-limit-cache-size.md"},{"slug":"go-go-module-configuration","title":"Go module configuration","description":"Ensure Go projects use modern module configuration instead of legacy GOPATH setup. Projects should be created outside of GOPATH directory structure, with proper environment variable configuration and module files.","repository":"golang/go","domain":"runtimes","topic":"Configurations","language":"Html","updated":"2018-10-17","comments":3,"stars":129599,"raw":"https://awesomereviewers.com/raw/go-go-module-configuration.md"},{"slug":"dive-domain-appropriate-data-structures","title":"Domain-appropriate data structures","description":"Design data structures that accurately reflect the constraints and behavior of your problem domain. Choose data types that match the natural constraints of your values, and design structural patterns that align with expected usage.","repository":"wagoodman/dive","domain":"orchestration","topic":"Algorithms","language":"Go","updated":"2018-10-07","comments":2,"stars":51517,"raw":"https://awesomereviewers.com/raw/dive-domain-appropriate-data-structures.md"},{"slug":"deeplearning4j-fail-fast-clearly","title":"Fail fast clearly","description":"Detect and report errors as early as possible with detailed context to prevent silent failures and aid debugging. Validate inputs, states, and implementation completeness with appropriate exceptions that include relevant information.","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Error Handling","language":"Java","updated":"2018-09-03","comments":4,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-fail-fast-clearly.md"},{"slug":"alacritty-synchronize-platform-configurations","title":"synchronize platform configurations","description":"When making configuration changes that affect multiple platform-specific files, ensure all related configuration files are updated consistently and test the changes on each target platform.","repository":"alacritty/alacritty","domain":"devtools","topic":"Configurations","language":"Yaml","updated":"2018-08-22","comments":2,"stars":59675,"raw":"https://awesomereviewers.com/raw/alacritty-synchronize-platform-configurations.md"},{"slug":"swift-minimize-cross-device-transfers","title":"Minimize cross-device transfers","description":"Data transfers between different compute devices (CPU/host to GPU/accelerator and back) can significantly impact performance in heterogeneous computing environments. Each transfer introduces latency and can block computation pipelines. Pay special attention to round-trip patterns where data moves from device A to B and back to A, as these create...","repository":"tensorflow/swift","domain":"ml-systems","topic":"Performance Optimization","language":"Markdown","updated":"2018-08-14","comments":2,"stars":6136,"raw":"https://awesomereviewers.com/raw/swift-minimize-cross-device-transfers.md"},{"slug":"octokit.net-consistent-naming-patterns","title":"Consistent naming patterns","description":"Follow consistent naming conventions throughout the codebase to improve readability and maintainability: 1. **Client property names should be singular**, not plural:","repository":"octokit/octokit.net","domain":"devtools","topic":"Naming Conventions","language":"C#","updated":"2018-08-10","comments":14,"stars":2793,"raw":"https://awesomereviewers.com/raw/octokit.net-consistent-naming-patterns.md"},{"slug":"gin-use-standard-http-constants","title":"Use standard HTTP constants","description":"Always use the standard HTTP status constants from the `http` package instead of raw numeric values in your networking code. This practice improves code readability, maintainability, and helps prevent errors when working with HTTP responses.","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"Networking","language":"Go","updated":"2018-08-07","comments":2,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-use-standard-http-constants.md"},{"slug":"yoga-add-safety-checks","title":"Add safety checks","description":"Always add appropriate safety checks before operations that could result in undefined behavior, null references, or memory issues. This includes using weak references to prevent retain cycles, verifying exact object types before type-specific operations, and adding conditional checks before calling methods that may return undefined values.","repository":"facebook/yoga","domain":"runtimes","topic":"Null Handling","language":"Objective-C","updated":"2018-07-26","comments":3,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-add-safety-checks.md"},{"slug":"deeplearning4j-type-safe-numerical-algorithms","title":"Type-safe numerical algorithms","description":"When implementing numerical algorithms, always use appropriate data types to prevent overflow and preserve precision: 1. Use `Nd4jLong` or `auto` instead of `int` for array indices, dimensions, and strides, especially when working with potentially large data structures:","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Algorithms","language":"C++","updated":"2018-06-27","comments":2,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-type-safe-numerical-algorithms.md"},{"slug":"octokit.net-use-specific-assertions","title":"Use specific assertions","description":"Always write assertions that verify specific, expected values rather than simple existence or boolean checks. This ensures tests validate exactly what you intend and provides clearer error messages when tests fail.","repository":"octokit/octokit.net","domain":"devtools","topic":"Testing","language":"C#","updated":"2018-06-20","comments":8,"stars":2793,"raw":"https://awesomereviewers.com/raw/octokit.net-use-specific-assertions.md"},{"slug":"deeplearning4j-avoid-environment-specific-paths","title":"Avoid environment-specific paths","description":"Always use environment variables or configuration mechanisms instead of hardcoding paths to compilers, tools, or directories. Hardcoded paths create dependencies on specific environments and break compatibility across different platforms and CI systems.","repository":"deeplearning4j/deeplearning4j","domain":"ml-systems","topic":"Configurations","language":"Shell","updated":"2018-06-19","comments":3,"stars":14036,"raw":"https://awesomereviewers.com/raw/deeplearning4j-avoid-environment-specific-paths.md"},{"slug":"aws-sdk-js-maintain-consistent-formatting","title":"Maintain consistent formatting","description":"Enhance code readability and maintainability by applying consistent formatting practices throughout your codebase: 1. Properly indent continuation lines (lines that are part of the same statement as the preceding line)","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Code Style","language":"JavaScript","updated":"2018-06-07","comments":4,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-maintain-consistent-formatting.md"},{"slug":"express-accurate-jsdoc-documentation","title":"Accurate JSDoc documentation","description":"Always ensure JSDoc comments accurately reflect the actual code implementation. Parameter types, optionality, and function behavior must be precisely documented to prevent confusion and bugs.","repository":"expressjs/express","domain":"app-frameworks","topic":"Documentation","language":"JavaScript","updated":"2018-04-16","comments":2,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-accurate-jsdoc-documentation.md"},{"slug":"tree-sitter-optimize-parser-development-strategy","title":"optimize parser development strategy","description":"When developing parsers or grammars, apply strategic optimization by prioritizing commonly used language features and choosing appropriate conflict resolution algorithms based on performance trade-offs.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Algorithms","language":"Markdown","updated":"2018-02-15","comments":3,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-optimize-parser-development-strategy.md"},{"slug":"yoga-document-complex-logic","title":"Document complex logic","description":"Add clear explanatory comments to complex calculations, platform-specific behavior, or non-obvious code sections. Use NOTE comments to explain the reasoning behind tricky implementations, especially when dealing with framework-specific quirks or mathematical calculations.","repository":"facebook/yoga","domain":"runtimes","topic":"Code Style","language":"Objective-C","updated":"2018-01-20","comments":3,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-document-complex-logic.md"},{"slug":"compose-avoid-external-test-dependencies","title":"avoid external test dependencies","description":"Tests should not depend on external resources like real URLs, remote servers, or external APIs as these dependencies make tests flaky and unreliable. Instead, use local mock servers, stub responses, or dependency injection to simulate external behavior.","repository":"docker/compose","domain":"orchestration","topic":"Testing","language":"Python","updated":"2018-01-05","comments":2,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-avoid-external-test-dependencies.md"},{"slug":"aws-sdk-js-follow-established-testing-patterns","title":"Follow established testing patterns","description":"When writing tests, use existing patterns and infrastructure already established in the codebase rather than creating custom implementations. This improves consistency, reduces maintenance burden, and helps ensure comprehensive test coverage.","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Testing","language":"Other","updated":"2017-10-19","comments":3,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-follow-established-testing-patterns.md"},{"slug":"aws-sdk-js-semantic-type-organization","title":"Semantic type organization","description":"Organize types and interfaces in intuitive namespace hierarchies and use specific types instead of generic ones. Types should be accessible through logically related namespaces, and method signatures should accurately reflect their parameters and return values. This improves code clarity, discoverability, and type safety.","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Naming Conventions","language":"TypeScript","updated":"2017-08-01","comments":2,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-semantic-type-organization.md"},{"slug":"yoga-analyze-performance-trade-offs","title":"Analyze performance trade-offs","description":"Before implementing convenience features or making architectural decisions, carefully evaluate their performance implications and hidden costs. Consider factors like method call overhead, automatic behavior frequency, and resource utilization patterns.","repository":"facebook/yoga","domain":"runtimes","topic":"Performance Optimization","language":"Objective-C","updated":"2017-07-29","comments":3,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-analyze-performance-trade-offs.md"},{"slug":"boto3-avoid-identifier-name-stuttering","title":"Avoid identifier name stuttering","description":"Do not repeat the resource name in identifier names. This form of stuttering makes code less readable and inconsistent. Instead, use simple, descriptive identifiers without redundancy.","repository":"boto/boto3","domain":"cloud-infra","topic":"Naming Conventions","language":"Json","updated":"2017-07-09","comments":2,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-avoid-identifier-name-stuttering.md"},{"slug":"gin-declare-phony-targets","title":"Declare .PHONY targets","description":"Always explicitly declare all Makefile targets that don't create files as `.PHONY`. This prevents conflicts with potential files of the same name, makes build intentions clear, and increases reliability in CI/CD pipelines.","repository":"gin-gonic/gin","domain":"app-frameworks","topic":"CI/CD","language":"Other","updated":"2017-06-15","comments":2,"stars":83022,"raw":"https://awesomereviewers.com/raw/gin-declare-phony-targets.md"},{"slug":"tree-sitter-assert-null-before-access","title":"Assert null before access","description":"When asserting conditions on potentially null pointers, always check for null first before accessing the pointer's properties or members. This prevents segmentation faults and makes null expectations explicit in the code.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Null Handling","language":"C","updated":"2017-06-14","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-assert-null-before-access.md"},{"slug":"tree-sitter-validate-algorithmic-inputs","title":"validate algorithmic inputs","description":"Always validate inputs and handle edge cases before performing algorithmic operations, especially when dealing with indices, state transitions, or data structure traversals. Check for boundary conditions, invalid states, and null/undefined values that could cause out-of-bounds access or undefined behavior.","repository":"tree-sitter/tree-sitter","domain":"runtimes","topic":"Algorithms","language":"Other","updated":"2017-06-09","comments":2,"stars":21799,"raw":"https://awesomereviewers.com/raw/tree-sitter-validate-algorithmic-inputs.md"},{"slug":"yoga-avoid-configuration-side-effects","title":"Avoid configuration side effects","description":"Configuration properties should behave predictably without hidden side effects that override explicitly set values. When a developer sets a configuration value, the system should respect that value rather than applying additional logic that might change the effective behavior.","repository":"facebook/yoga","domain":"runtimes","topic":"Configurations","language":"Objective-C","updated":"2017-05-24","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-avoid-configuration-side-effects.md"},{"slug":"yoga-separate-formatting-from-logging","title":"separate formatting from logging","description":"Design logging utility functions to return formatted strings rather than directly performing logging operations. This separation of concerns improves modularity, testability, and allows callers to control when and how logging occurs.","repository":"facebook/yoga","domain":"runtimes","topic":"Logging","language":"Other","updated":"2017-04-26","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-separate-formatting-from-logging.md"},{"slug":"aws-sdk-js-test-configuration-precedence","title":"Test configuration precedence","description":"When implementing systems that load configuration from multiple sources, always test the precedence rules explicitly to ensure the correct values are being used. Configuration loading bugs can be subtle and difficult to diagnose in production.","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Configurations","language":"Other","updated":"2017-04-13","comments":3,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-test-configuration-precedence.md"},{"slug":"core-eslint-configuration-alignment","title":"ESLint configuration alignment","description":"Ensure your ESLint configuration matches the JavaScript language features used in your codebase to prevent false warnings and maintain consistent code quality checks. When using ES6+ features like `let`, `const`, object shorthand notation, or other modern JavaScript syntax, update your ESLint configuration to recognize these features.","repository":"adonisjs/core","domain":"app-frameworks","topic":"Code Style","language":"JavaScript","updated":"2017-04-12","comments":6,"stars":18071,"raw":"https://awesomereviewers.com/raw/core-eslint-configuration-alignment.md"},{"slug":"awesome-go-verify-markdown-sanitization","title":"Verify markdown sanitization","description":"When processing markdown content, always verify what sanitization your chosen markdown library provides to prevent XSS vulnerabilities while avoiding redundant security measures. Some libraries like `github_flavored_markdown` include built-in sanitization, while others like `blackfriday` require explicit sanitization of their output.","repository":"avelino/awesome-go","domain":"docs","topic":"Security","language":"Go","updated":"2017-03-29","comments":2,"stars":151435,"raw":"https://awesomereviewers.com/raw/awesome-go-verify-markdown-sanitization.md"},{"slug":"yoga-choose-meaningful-identifiers","title":"Choose meaningful identifiers","description":"All identifiers including parameters, files, functions, and categories should clearly communicate their purpose and role. Avoid generic or ambiguous names that require additional context to understand.","repository":"facebook/yoga","domain":"runtimes","topic":"Naming Conventions","language":"Other","updated":"2017-03-14","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-choose-meaningful-identifiers.md"},{"slug":"yoga-use-descriptive-function-names","title":"Use descriptive function names","description":"Function names should clearly convey their purpose and behavior, not just their signature or implementation details. Avoid names that could be confused with existing functions that have similar but different behavior.","repository":"facebook/yoga","domain":"runtimes","topic":"Naming Conventions","language":"C","updated":"2017-03-01","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-use-descriptive-function-names.md"},{"slug":"yoga-control-structure-formatting","title":"Control structure formatting","description":"Always use braces for control structures (if, for, while, etc.) even for single statements, and maintain consistent spacing around parentheses and braces. This improves code readability and prevents potential bugs when code is modified later.","repository":"facebook/yoga","domain":"runtimes","topic":"Code Style","language":"Java","updated":"2017-02-27","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-control-structure-formatting.md"},{"slug":"express-enforce-null-safety-patterns","title":"Enforce null safety patterns","description":"Implement comprehensive null safety patterns to prevent runtime errors and ensure predictable behavior. Follow these guidelines: 1. Use explicit null/undefined checks instead of loose comparisons:","repository":"expressjs/express","domain":"app-frameworks","topic":"Null Handling","language":"JavaScript","updated":"2017-02-24","comments":8,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-enforce-null-safety-patterns.md"},{"slug":"yoga-explicit-undefined-state-handling","title":"Explicit undefined state handling","description":"Always use explicit, well-defined representations for undefined, uninitialized, or invalid states instead of magic values or allowing undefined behavior to propagate silently. Create named constants or enum values for undefined states, and make conscious decisions about whether to crash, return defaults, or handle undefined values gracefully.","repository":"facebook/yoga","domain":"runtimes","topic":"Null Handling","language":"C","updated":"2017-02-23","comments":5,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-explicit-undefined-state-handling.md"},{"slug":"yoga-extract-complex-conditions","title":"Extract complex conditions","description":"When encountering complex conditional expressions or generic variable references, extract them into clearly named variables or use explicit identifiers to improve code readability and maintainability.","repository":"facebook/yoga","domain":"runtimes","topic":"Code Style","language":"C","updated":"2017-02-23","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-extract-complex-conditions.md"},{"slug":"yoga-manage-resource-lifecycles","title":"Manage resource lifecycles","description":"Ensure proper resource allocation and cleanup pairing, and maintain clear ownership semantics to prevent memory leaks and null reference issues. When allocating resources like GCHandle, always pair allocation with corresponding cleanup calls. Avoid overwriting allocated resources without first cleaning up the previous allocation.","repository":"facebook/yoga","domain":"runtimes","topic":"Null Handling","language":"C#","updated":"2017-02-13","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-manage-resource-lifecycles.md"},{"slug":"boto3-consistent-method-interfaces","title":"Consistent method interfaces","description":"Design APIs with consistent method interfaces across related resources to improve usability and reduce learning curve. When similar operations are available on different resources, they should follow the same naming conventions, parameter structures, and behavior patterns.","repository":"boto/boto3","domain":"cloud-infra","topic":"API","language":"Python","updated":"2017-02-06","comments":5,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-consistent-method-interfaces.md"},{"slug":"yoga-write-focused-single-purpose-tests","title":"Write focused single-purpose tests","description":"Tests should focus on validating one specific behavior or scenario rather than combining multiple test cases into complex, multi-purpose tests. Each test should have a clear, meaningful purpose that actually exercises the code under test.","repository":"facebook/yoga","domain":"runtimes","topic":"Testing","language":"Html","updated":"2017-02-02","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-write-focused-single-purpose-tests.md"},{"slug":"yoga-algorithm-specification-compliance","title":"Algorithm specification compliance","description":"When implementing layout algorithms, ensure strict adherence to web standards and specifications, particularly regarding control flow and edge case handling. Complex algorithms like baseline calculation require precise implementation of specification details to avoid subtle bugs.","repository":"facebook/yoga","domain":"runtimes","topic":"Algorithms","language":"C","updated":"2017-01-05","comments":3,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-algorithm-specification-compliance.md"},{"slug":"aws-sdk-js-complete-configuration-type-definitions","title":"Complete configuration type definitions","description":"Ensure configuration type definitions are complete and consistent between global and service-specific settings. When designing configuration classes, include service identifiers as optional instance variables and ensure update methods accept all relevant option types that might be used at both global and service-specific levels.","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Configurations","language":"TypeScript","updated":"2017-01-05","comments":2,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-complete-configuration-type-definitions.md"},{"slug":"octokit.net-abstract-configuration-access","title":"Abstract configuration access","description":"Use abstraction layers to access configuration settings rather than accessing environment variables, feature flags, or other configuration sources directly. This improves maintainability by centralizing configuration logic, enabling validation, and simplifying testing.","repository":"octokit/octokit.net","domain":"devtools","topic":"Configurations","language":"C#","updated":"2016-12-23","comments":3,"stars":2793,"raw":"https://awesomereviewers.com/raw/octokit.net-abstract-configuration-access.md"},{"slug":"aws-sdk-js-organize-type-declarations","title":"Organize type declarations","description":"Structure TypeScript declarations to improve maintainability and developer experience. Organize related types into appropriate namespaces and use inheritance to avoid duplication.","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Code Style","language":"TypeScript","updated":"2016-10-29","comments":2,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-organize-type-declarations.md"},{"slug":"computer-science-consistent-markdown-tables","title":"Consistent Markdown Tables","description":"When adding or editing tables in documentation, ensure the Markdown table is both syntactically continuous (so rows actually belong to the table) and stylististically consistent with existing docs.","repository":"ossu/computer-science","domain":"docs","topic":"Documentation","language":"Markdown","updated":"2016-10-13","comments":2,"stars":203692,"raw":"https://awesomereviewers.com/raw/computer-science-consistent-markdown-tables.md"},{"slug":"yoga-follow-language-naming-conventions","title":"Follow language naming conventions","description":"Ensure all identifiers (properties, methods, classes, variables) follow the established naming conventions of the programming language being used. This improves code readability, maintainability, and consistency across the codebase.","repository":"facebook/yoga","domain":"runtimes","topic":"Naming Conventions","language":"C#","updated":"2016-10-04","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-follow-language-naming-conventions.md"},{"slug":"spring-framework-optimize-ci-environment-configuration","title":"Optimize CI environment configuration","description":"When configuring CI environments, carefully evaluate whether default dependency versions are sufficient for your project needs before adding custom installation steps. Default configurations (like Travis CI's JDK version) often provide adequate support while maintaining optimal build times. Only include additional installation commands when specific project...","repository":"spring-projects/spring-framework","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"2016-07-02","comments":3,"stars":58382,"raw":"https://awesomereviewers.com/raw/spring-framework-optimize-ci-environment-configuration.md"},{"slug":"express-access-settings-properly","title":"Access settings properly","description":"Always use the provided settings accessor methods (`app.get()`, `app.set()`, `app.enabled()`, `app.disabled()`) to access application configuration instead of directly accessing the settings object. Direct access to the settings object was deprecated and may lead to inconsistent behavior or errors.","repository":"expressjs/express","domain":"app-frameworks","topic":"Configurations","language":"JavaScript","updated":"2016-03-15","comments":4,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-access-settings-properly.md"},{"slug":"express-method-chaining-for-clarity","title":"Method chaining for clarity","description":"Design API methods that favor chaining over multiple parameters to improve readability and maintainability. When implementing methods that require both a resource and configuration options (like status codes), prefer method chaining patterns that clearly separate concerns and make the purpose of each parameter explicit.","repository":"expressjs/express","domain":"app-frameworks","topic":"API","language":"Markdown","updated":"2016-03-14","comments":2,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-method-chaining-for-clarity.md"},{"slug":"express-structured-release-workflows","title":"Structured release workflows","description":"Implement a clearly defined release strategy that distinguishes between different types of changes. Create separate workflows for patch releases (typo fixes, safe dependency updates, low-risk fixes) and non-patch releases (features, breaking changes):","repository":"expressjs/express","domain":"app-frameworks","topic":"CI/CD","language":"Markdown","updated":"2016-02-23","comments":3,"stars":67300,"raw":"https://awesomereviewers.com/raw/express-structured-release-workflows.md"},{"slug":"boto3-use-standard-example-credentials","title":"Use standard example credentials","description":"When including API keys, access tokens, or other credentials in documentation, examples, or test code, always use clearly marked standard formats that won''t trigger security scanners or be mistaken for real credentials.","repository":"boto/boto3","domain":"cloud-infra","topic":"Security","language":"Other","updated":"2016-01-25","comments":1,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-use-standard-example-credentials.md"},{"slug":"awesome-go-verify-url-security-and-validity","title":"Verify URL security and validity","description":"Always ensure external URLs use HTTPS when available and verify that links resolve correctly before including them in documentation or code. HTTP links expose users to potential security risks through unencrypted connections, while broken or incorrect URLs create poor user experience and may indicate outdated dependencies.","repository":"avelino/awesome-go","domain":"docs","topic":"Networking","language":"Markdown","updated":"2015-10-23","comments":2,"stars":151435,"raw":"https://awesomereviewers.com/raw/awesome-go-verify-url-security-and-validity.md"},{"slug":"octokit.net-precise-and-consistent-naming","title":"Precise and consistent naming","description":"Names should clearly indicate their specific purpose and context, while\\ \\ maintaining correct capitalization of brand names and products. \\n\\nWhen naming\\ \\ variables, parameters, or targets:","repository":"octokit/octokit.net","domain":"devtools","topic":"Naming Conventions","language":"Other","updated":"2015-10-16","comments":2,"stars":2793,"raw":"https://awesomereviewers.com/raw/octokit.net-precise-and-consistent-naming.md"},{"slug":"yoga-strict-null-checks","title":"Strict null checks","description":"Use explicit strict equality checks when testing for null or undefined values. Prefer `x === undefined` over `typeof x === 'undefined'` when the variable is known to exist. When checking for both null and undefined, use `x == null` (loose equality) as it covers both cases, or check each explicitly with `x === null || x === undefined`. Avoid using the `||`...","repository":"facebook/yoga","domain":"runtimes","topic":"Null Handling","language":"JavaScript","updated":"2015-10-07","comments":5,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-strict-null-checks.md"},{"slug":"yoga-consistent-formatting-choices","title":"consistent formatting choices","description":"Maintain consistent formatting and structural choices throughout the codebase to improve readability and maintainability. This includes always using braces for control structures (even single-line statements), choosing appropriate control flow constructs for clarity, and organizing code to prevent execution order issues.","repository":"facebook/yoga","domain":"runtimes","topic":"Code Style","language":"JavaScript","updated":"2015-10-04","comments":3,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-consistent-formatting-choices.md"},{"slug":"yoga-reset-algorithm-state-internally","title":"Reset algorithm state internally","description":"Algorithms should handle their own state initialization and cleanup internally rather than relying on callers to manage it. This prevents bugs caused by stale data from previous executions and reduces the burden on calling code.","repository":"facebook/yoga","domain":"runtimes","topic":"Algorithms","language":"JavaScript","updated":"2015-10-04","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-reset-algorithm-state-internally.md"},{"slug":"compose-document-complex-code","title":"Document complex code","description":"When code elements become complex—whether functions performing multiple operations or data structures with multiple attributes—they require proper documentation to aid understanding and maintenance. Complex functions should include docstrings explaining their purpose, parameters, and behavior. Data structures should document their attributes and types for...","repository":"docker/compose","domain":"orchestration","topic":"Documentation","language":"Python","updated":"2015-09-18","comments":2,"stars":35858,"raw":"https://awesomereviewers.com/raw/compose-document-complex-code.md"},{"slug":"yoga-benchmark-performance-optimizations","title":"benchmark performance optimizations","description":"Always measure and validate performance optimizations through benchmarking before assuming they provide benefits. Performance changes can have unexpected consequences, and what appears to be an optimization may actually degrade performance in real-world scenarios.","repository":"facebook/yoga","domain":"runtimes","topic":"Performance Optimization","language":"JavaScript","updated":"2015-09-07","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-benchmark-performance-optimizations.md"},{"slug":"yoga-avoid-build-side-effects","title":"avoid build side effects","description":"Build scripts should avoid performing operations as side effects and instead use explicit, dedicated tasks for each operation. Side effects make build processes unpredictable, harder to maintain, and difficult to debug when issues arise.","repository":"facebook/yoga","domain":"runtimes","topic":"CI/CD","language":"JavaScript","updated":"2015-08-13","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-avoid-build-side-effects.md"},{"slug":"yoga-centralize-configuration-values","title":"Centralize configuration values","description":"Consolidate all configuration variables, constants, and settings into a centralized configuration object rather than declaring them as scattered variables throughout the codebase. This improves maintainability, reduces duplication, and enables consistent templating patterns.","repository":"facebook/yoga","domain":"runtimes","topic":"Configurations","language":"JavaScript","updated":"2015-08-13","comments":2,"stars":18255,"raw":"https://awesomereviewers.com/raw/yoga-centralize-configuration-values.md"},{"slug":"aws-sdk-js-example-documentation-standards","title":"Example documentation standards","description":"Organize API documentation examples for maximum clarity and usefulness. Place hand-written examples before generated examples since they're typically more valuable to users. When using @example tags, include only the descriptive title without redundant 'Example:' prefixes.","repository":"aws/aws-sdk-js","domain":"cloud-infra","topic":"Documentation","language":"Ruby","updated":"2015-07-22","comments":2,"stars":7628,"raw":"https://awesomereviewers.com/raw/aws-sdk-js-example-documentation-standards.md"},{"slug":"awesome-go-follow-go-style-guidelines","title":"Follow Go style guidelines","description":"Code should adhere to the recommended Go style guidelines as outlined in the official Go Code Review Comments. While perfect adherence isn't always required, aim for minimal golint issues and follow established Go conventions for naming, formatting, and code organization.","repository":"avelino/awesome-go","domain":"docs","topic":"Code Style","language":"Markdown","updated":"2015-07-05","comments":2,"stars":151435,"raw":"https://awesomereviewers.com/raw/awesome-go-follow-go-style-guidelines.md"},{"slug":"boto3-write-self-documenting-tests","title":"Write self-documenting tests","description":"Tests should clearly communicate their purpose and expectations without requiring readers to analyze implementation details or scroll through files. Each test should:","repository":"boto/boto3","domain":"cloud-infra","topic":"Testing","language":"Python","updated":"2015-05-20","comments":8,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-write-self-documenting-tests.md"},{"slug":"boto3-avoid-hidden-performance-costs","title":"Avoid hidden performance costs","description":"When designing APIs that interact with remote services, be cautious about implementing convenience features that may introduce significant hidden performance costs. Collection operations like slicing, negative indexing, or operations that process all items can be unexpectedly expensive when they require fetching large amounts of data.","repository":"boto/boto3","domain":"cloud-infra","topic":"Performance Optimization","language":"Python","updated":"2014-10-16","comments":3,"stars":9417,"raw":"https://awesomereviewers.com/raw/boto3-avoid-hidden-performance-costs.md"},{"slug":"axum-comprehensive-documentation-standards","title":"Comprehensive documentation standards","description":"Create clear, well-structured API documentation following proper formatting, correct references, informative examples, and completeness standards. Documentation should be treated as a first-class feature - it's often the first interaction users have with your API.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"Documentation","language":"Rust","updated":"","comments":16,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-comprehensive-documentation-standards.md"},{"slug":"fastify-use-specific-assertion-methods","title":"Use specific assertion methods","description":"Choose the appropriate assertion method based on the data type being tested. This improves test readability and provides clearer error messages when tests fail.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Testing","language":"JavaScript","updated":"","comments":15,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-use-specific-assertion-methods.md"},{"slug":"axum-type-safe-flexible-apis","title":"Type-safe flexible APIs","description":"Design APIs that favor both type safety and flexibility. Use strongly typed wrappers instead of primitive types, but accept generic parameters where flexibility is beneficial.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"API","language":"Rust","updated":"","comments":10,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-type-safe-flexible-apis.md"},{"slug":"axum-code-review-interaction-patterns","title":"Axum Code Review: Interaction Patterns","description":"When implementing Axum-based applications, it is crucial to ensure that the interaction patterns between components are well-designed and clearly documented. This includes understanding edge cases, limitations, and best practices around state sharing, router nesting, and extractor ordering.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"Axum","language":"TypeScript","updated":"","comments":9,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-code-review-interaction-patterns.md"},{"slug":"azure-sdk-for-net-documentation-quality-standards","title":"Documentation quality standards","description":"Ensure documentation is specific, complete, and actionable for developers: 1. **Provide meaningful content** - Avoid vague descriptions like \"Test changes\" in changelogs. Instead, be specific about what was modified or tested:","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Documentation","language":"Markdown","updated":"","comments":9,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-documentation-quality-standards.md"},{"slug":"fastify-write-clear-documentation","title":"Write clear documentation","description":"Documentation should be clear, precise, and self-contained while following established style conventions. When writing technical documentation, use precise language, make documentation self-contained, follow style conventions, and create accessible links.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"","comments":8,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-write-clear-documentation.md"},{"slug":"nextjs-effective-cache-management-in-nextjs-applications","title":"Effective Cache Management in Next.js Applications","description":"When implementing caching in Next.js applications, it is crucial to be intentional about the caching behavior for each component and function. Apply caching directives consistently and consider their implications.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Next.js","language":"JavaScript","updated":"","comments":8,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-effective-cache-management-in-nextjs-applications.md"},{"slug":"nextjs-secure-data-handling-in-nextjs-applications","title":"Secure Data Handling in Next.js Applications","description":"When building Next.js applications that handle sensitive data, it's crucial to implement robust security measures to prevent data leakage and injection attacks.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Next.js","language":"JavaScript","updated":"","comments":8,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-secure-data-handling-in-nextjs-applications.md"},{"slug":"nextjs-technical-documentation-precision","title":"Technical documentation precision","description":"Ensure technical documentation is precise, accurate, and correctly formatted to prevent confusion and improve developer experience.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Documentation","language":"Mdx","updated":"","comments":8,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-technical-documentation-precision.md"},{"slug":"axum-prefer-simpler-code-constructs","title":"Prefer simpler code constructs","description":"Always opt for simpler, more idiomatic code constructs over complex or verbose alternatives. This includes using built-in Rust patterns instead of manual implementations, leveraging pattern matching for cleaner control flow, using method chaining when it improves readability, and maintaining consistent formatting.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"Code Style","language":"Rust","updated":"","comments":6,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-prefer-simpler-code-constructs.md"},{"slug":"fastify-concurrent-operations-completion-management","title":"Concurrent operations completion management","description":"When running concurrent operations in tests, ensure all operations complete before concluding the test. Race conditions occur when your test calls done() or resolves before all async operations finish, leading to flaky tests or missed assertions.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Concurrency","language":"JavaScript","updated":"","comments":6,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-concurrent-operations-completion-management.md"},{"slug":"fastify-consistent-test-code-style","title":"Consistent test code style","description":"Maintain consistent and clear testing patterns by following these guidelines: use strict equality assertions, prefer variable reassignment over block scoping for multiple sequential requests, and maintain consistent formatting to improve code readability and reduce unnecessary indentation.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Code Style","language":"JavaScript","updated":"","comments":6,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-consistent-test-code-style.md"},{"slug":"nextjs-handling-dynamic-content-in-nextjs-components","title":"Handling Dynamic Content in Next.js Components","description":"When implementing Next.js components that rely on dynamic content (e.g. random values, current time), it is crucial to use proper boundary handling to avoid hydration errors and performance issues.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Next.js","language":"JavaScript","updated":"","comments":6,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-handling-dynamic-content-in-nextjs-components.md"},{"slug":"axios-complete-error-handling-chain","title":"Complete error handling chain","description":"Implement comprehensive error handling throughout the codebase by ensuring all error scenarios are properly caught, typed, and propagated. This includes always including catch blocks for async operations, properly typing and propagating error information, using standardized error codes, and ensuring error callbacks receive and handle error parameters.","repository":"axios/axios","domain":"app-frameworks","topic":"Error Handling","language":"JavaScript","updated":"","comments":5,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-complete-error-handling-chain.md"},{"slug":"axios-consistent-method-behaviors","title":"Consistent method behaviors","description":"Design API methods with predictable behavior patterns that follow common conventions. Methods that modify objects directly should not return values unless supporting method chaining. Methods that retrieve or transform data should return new objects without modifying inputs.","repository":"axios/axios","domain":"app-frameworks","topic":"API","language":"JavaScript","updated":"","comments":5,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-consistent-method-behaviors.md"},{"slug":"axios-documentation-reflects-reality","title":"Documentation reflects reality","description":"Always ensure documentation accurately represents the actual code behavior and implementation details. Include important contextual information such as platform-specific limitations, explanations for deprecated features with recommended alternatives, precise descriptions of function parameters and behaviors, and concise, merged code examples to demonstrate functionality.","repository":"axios/axios","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"","comments":5,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-documentation-reflects-reality.md"},{"slug":"axios-proxy-protocol-handling","title":"Proxy protocol handling","description":"When implementing HTTP clients with proxy support, ensure the connection to the proxy uses the protocol specified in the proxy configuration (not the request protocol). This is crucial for scenarios like accessing HTTPS resources through an HTTP proxy.","repository":"axios/axios","domain":"app-frameworks","topic":"Networking","language":"JavaScript","updated":"","comments":5,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-proxy-protocol-handling.md"},{"slug":"axios-specific-test-assertions","title":"Specific test assertions","description":"When writing tests, explicitly assert specific conditions and expected values rather than relying on general success/failure checks. This prevents tests from silently passing when they should fail and ensures tests verify exactly what they're intended to verify.","repository":"axios/axios","domain":"app-frameworks","topic":"Testing","language":"JavaScript","updated":"","comments":5,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-specific-test-assertions.md"},{"slug":"axios-standardize-null-value-checks","title":"Standardize null value checks","description":"Always use consistent patterns and utility functions for handling null and undefined values. This improves code reliability and maintainability while preventing common errors.","repository":"axios/axios","domain":"app-frameworks","topic":"Null Handling","language":"JavaScript","updated":"","comments":5,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-standardize-null-value-checks.md"},{"slug":"axios-type-safe-api-interfaces-design","title":"Type-safe API interfaces design","description":"Design API interfaces with strong type safety while maintaining excellent developer experience. Prefer explicit types over loose ones to enable better IDE support and catch errors at compile time.","repository":"axios/axios","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"","comments":5,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-type-safe-api-interfaces-design.md"},{"slug":"axum-consistent-axum-usage-in-typescript","title":"Consistent axum Usage in TypeScript","description":"When implementing TypeScript code that uses the axum package, maintain consistent and idiomatic usage: always use lowercase 'axum', leverage axum's built-in types correctly, follow best practices for state and dependencies, ensure proper error handling, and use routing and middleware features effectively.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"Axum","language":"TypeScript","updated":"","comments":5,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-consistent-axum-usage-in-typescript.md"},{"slug":"axum-documentation-consistency-standards","title":"Documentation consistency standards","description":"Maintain consistent documentation formatting standards across all project files, especially in changelogs, code examples, and technical documentation. This ensures readability and prevents confusion when documentation is viewed in different contexts.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"","comments":5,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-documentation-consistency-standards.md"},{"slug":"axum-prefer-descriptive-over-brief","title":"Prefer descriptive over brief","description":"Choose clear, descriptive names over abbreviated or shortened versions. Names should be self-documenting and follow Rust conventions. While brevity can be tempting, the clarity and maintainability benefits of descriptive names outweigh the extra characters.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"Naming Conventions","language":"Rust","updated":"","comments":5,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-prefer-descriptive-over-brief.md"},{"slug":"azure-sdk-for-net-centralize-configuration-values","title":"Centralize configuration values","description":"Configuration values should be defined once and referenced throughout your project to ensure consistency and simplify maintenance. Hardcoded values scattered across multiple files lead to update errors and inconsistent configurations.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Configurations","language":"Other","updated":"","comments":5,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-centralize-configuration-values.md"},{"slug":"azure-sdk-for-net-preserve-api-compatibility","title":"Preserve API compatibility","description":"When evolving APIs, maintain backward compatibility to prevent breaking\\ \\ changes for existing consumers. \\n\\nKey approaches:\\n\\n1. **Retain removed members\\ \\ with obsolete attributes**: When removing or replacing public methods, mark the\\ \\ original as obsolete but maintain its functionality.","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"API","language":"C#","updated":"","comments":5,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-preserve-api-compatibility.md"},{"slug":"fastify-adhere-to-fastify-coding-conventions","title":"Adhere to Fastify Coding Conventions","description":"When implementing code that uses the Fastify package in TypeScript, ensure the following conventions are followed: avoid contractions, use Oxford commas, and maintain consistent formatting.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Fastify","language":"TypeScript","updated":"","comments":5,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-adhere-to-fastify-coding-conventions.md"},{"slug":"fastify-consistent-jsdoc-standards","title":"Consistent JSDoc standards","description":"Document all public APIs and significant internal functions with comprehensive JSDoc comments that include accurate descriptions, parameter and return types, and any notable side effects. Follow standard JSDoc format conventions consistently across the codebase.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Documentation","language":"JavaScript","updated":"","comments":5,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-consistent-jsdoc-standards.md"},{"slug":"fastify-explicit-configuration-usage-in-fastify","title":"Explicit Configuration Usage in Fastify","description":"When using the Fastify framework in TypeScript, ensure that all configuration options are explicitly declared and properly documented. This includes clearly defining all required configuration parameters, explicitly specifying any configuration constraints or mutually exclusive options, and providing comprehensive examples.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Fastify","language":"TypeScript","updated":"","comments":5,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-explicit-configuration-usage-in-fastify.md"},{"slug":"fastify-null-safe-patterns","title":"Null safe patterns","description":"Use concise null checking patterns to prevent runtime errors and improve code readability when handling potentially undefined values.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Null Handling","language":"JavaScript","updated":"","comments":5,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-null-safe-patterns.md"},{"slug":"fastify-preserve-error-context","title":"Preserve error context","description":"When handling errors, always ensure the original error context is preserved and properly surfaced. Error information should never be silently swallowed in try/catch blocks, as this makes debugging extremely difficult and can lead to unexpected system behavior.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Error Handling","language":"JavaScript","updated":"","comments":5,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-preserve-error-context.md"},{"slug":"fastify-properly-handle-errors-in-fastify-applications","title":"Properly Handle Errors in Fastify Applications","description":"When implementing error handling in Fastify applications, it is important to always throw instances of the Error class rather than primitive values or non-Error objects. This ensures that errors are properly propagated through the Fastify error handling chain.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Fastify","language":"TypeScript","updated":"","comments":5,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-properly-handle-errors-in-fastify-applications.md"},{"slug":"fastify-type-safe-api-designs","title":"Type-safe API designs","description":"Design APIs with strong type safety to improve developer experience and catch errors at compile time. Avoid using any types when possible, carefully order generic parameters to support type inference, and ensure return types accurately reflect API behavior.","repository":"fastify/fastify","domain":"app-frameworks","topic":"API","language":"TypeScript","updated":"","comments":5,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-type-safe-api-designs.md"},{"slug":"langchainjs-optimize-model-token-usage","title":"Optimize model token usage","description":"Implement token-efficient patterns when working with AI models to optimize costs and performance. Key practices include: 1. Batch identical prompts into single API calls where supported","repository":"langchain-ai/langchainjs","domain":"ai-agents","topic":"AI","language":"TypeScript","updated":"","comments":5,"stars":15004,"raw":"https://awesomereviewers.com/raw/langchainjs-optimize-model-token-usage.md"},{"slug":"nextjs-optimize-nextjs-resource-utilization","title":"Optimize Next.js Resource Utilization","description":"As a code reviewer, I recommend the following practices to optimize resource utilization when implementing Next.js applications.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Next.js","language":"JavaScript","updated":"","comments":5,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-optimize-nextjs-resource-utilization.md"},{"slug":"nextjs-write-robust-assertions","title":"Write robust assertions","description":"When writing tests, ensure assertions can handle non-deterministic content while providing clear failure context: use targeted assertions for non-deterministic content, use specialized tools like cheerio for DOM testing, and include contextual information in diagnostic tests.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Testing","language":"TypeScript","updated":"","comments":5,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-write-robust-assertions.md"},{"slug":"axios-extract-for-better-readability","title":"Extract for better readability","description":"Complex expressions and repeated code should be extracted into well-named variables to improve readability and maintainability. This applies to repeated string/value combinations, complex conditional logic, array transformations, and URL or path constructions.","repository":"axios/axios","domain":"app-frameworks","topic":"Code Style","language":"JavaScript","updated":"","comments":4,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-extract-for-better-readability.md"},{"slug":"axios-proper-error-handling-in-axios-typescript-code","title":"Proper Error Handling in Axios TypeScript Code","description":"As a code reviewer, it is important to ensure that Axios-based TypeScript code properly handles and propagates errors. Key recommendations include using console.error() instead of console.log() when logging errors, preserving the full error object rather than just the error message, and following established Axios error handling patterns.","repository":"axios/axios","domain":"app-frameworks","topic":"Axios","language":"TypeScript","updated":"","comments":4,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-proper-error-handling-in-axios-typescript-code.md"},{"slug":"axios-robust-axios-usage-in-typescript","title":"Robust Axios Usage in TypeScript","description":"This review focuses on ensuring robust and type-safe usage of the Axios library in TypeScript codebases. Key recommendations include leveraging Axios' built-in type-checking utilities, properly handling Content-Type headers when sending data, and standardizing serialization patterns for complex data types.","repository":"axios/axios","domain":"app-frameworks","topic":"Axios","language":"TypeScript","updated":"","comments":4,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-robust-axios-usage-in-typescript.md"},{"slug":"axios-validate-security-critical-inputs","title":"Validate security-critical inputs","description":"Always validate and sanitize user-supplied inputs before using them in security-sensitive operations. This helps prevent multiple types of vulnerabilities including Server-Side Request Forgery (SSRF), prototype pollution, and command injection.","repository":"axios/axios","domain":"app-frameworks","topic":"Security","language":"JavaScript","updated":"","comments":4,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-validate-security-critical-inputs.md"},{"slug":"axum-handle-protocol-headers-properly","title":"Handle protocol headers properly","description":"When implementing network services, especially proxies and protocol handlers, proper HTTP header management is critical for correct functionality, compatibility, and diagnostics.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"Networking","language":"Rust","updated":"","comments":4,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-handle-protocol-headers-properly.md"},{"slug":"axum-lock-carefully-in-async","title":"Lock carefully in async","description":"When using locks in async code, follow critical guidelines to avoid deadlocks. Never hold std::sync::Mutex locks across .await points as this can cause deadlocks even in single-threaded runtimes. Use tokio::sync::Mutex when the lock needs to be held across await points.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"Concurrency","language":"Rust","updated":"","comments":4,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-lock-carefully-in-async.md"},{"slug":"axum-minimize-memory-allocation-overhead","title":"Minimize memory allocation overhead","description":"Optimize performance by minimizing unnecessary memory allocations and using allocation-efficient APIs. Key practices include using static data when possible instead of dynamic allocations, leveraging specialized types and methods that minimize copies, and considering allocation patterns in data transformations.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"Performance Optimization","language":"Rust","updated":"","comments":4,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-minimize-memory-allocation-overhead.md"},{"slug":"axum-structure-errors-for-safety","title":"Structure errors for safety","description":"Create specific error types with appropriate status codes while ensuring sensitive details are logged but not exposed to clients. Follow guidelines for defining specific error types, implementing proper status codes, logging detailed errors internally, and returning sanitized error messages to clients.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"Error Handling","language":"Rust","updated":"","comments":4,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-structure-errors-for-safety.md"},{"slug":"axum-use-option-combinators","title":"Use Option combinators","description":"Instead of verbose conditional logic, prefer Rust's Option combinators like map, and_then, and filter for handling potentially null values. This creates more concise, readable code that expresses intent clearly and reduces the chance of null-related bugs.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"Null Handling","language":"Rust","updated":"","comments":4,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-use-option-combinators.md"},{"slug":"fastify-benchmark-before-choosing-methods","title":"Benchmark before choosing methods","description":"Always benchmark different implementation approaches for performance-critical operations before selecting a method. Different approaches (like array operations, string parsing, or data iteration) can have significant performance implications that may not be intuitive.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Performance Optimization","language":"JavaScript","updated":"","comments":4,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-benchmark-before-choosing-methods.md"},{"slug":"fastify-consistent-descriptive-naming","title":"Consistent descriptive naming","description":"Use precise, consistent, and descriptive naming conventions throughout your code to enhance readability and maintainability. This includes using past participle forms for variables storing processed data, choosing function names that clearly describe their purpose, using consistent naming patterns for related parameters, and naming properties to clearly indicate their relationships.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Naming Conventions","language":"JavaScript","updated":"","comments":4,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-consistent-descriptive-naming.md"},{"slug":"fastify-content-negotiation-design","title":"Content negotiation design","description":"When building APIs, implement proper content negotiation to handle various media types in both requests and responses. This ensures your API can work with different client requirements and maintain compatibility with diverse ecosystems.","repository":"fastify/fastify","domain":"app-frameworks","topic":"API","language":"JavaScript","updated":"","comments":4,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-content-negotiation-design.md"},{"slug":"fastify-proper-handling-of-promises-in-fastify-implementations","title":"Proper Handling of Promises in Fastify Implementations","description":"When implementing Fastify applications in TypeScript, it is important to follow consistent patterns for handling promises and respecting the framework's specific constraints. Avoid mixing async/await with callback styles, especially when registering routes, plugins, or parsers.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Fastify","language":"TypeScript","updated":"","comments":4,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-proper-handling-of-promises-in-fastify-implementations.md"},{"slug":"nextjs-maintain-consistent-naming-conventions-in-nextjs-code","title":"Maintain Consistent Naming Conventions in Next.js Code","description":"As a code reviewer for Next.js projects, ensure that all code artifacts, including component names, file names, and configuration keys, adhere to consistent naming conventions.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Next.js","language":"JavaScript","updated":"","comments":4,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-maintain-consistent-naming-conventions-in-nextjs-code.md"},{"slug":"nextjs-proper-error-handling-in-nextjs-api-routes","title":"Proper Error Handling in Next.js API Routes","description":"This review focuses on ensuring proper error handling in Next.js API routes. Key principles include validating incoming request data, using consistent error response structures, and sanitizing error messages.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Next.js","language":"JavaScript","updated":"","comments":4,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-proper-error-handling-in-nextjs-api-routes.md"},{"slug":"nextjs-proper-use-of-suspense-in-nextjs-components","title":"Proper Use of Suspense in Next.js Components","description":"When building Next.js applications that leverage server-side rendering (SSR) or Partial Prerendering (PPR), it is essential to wrap components that access dynamic or non-deterministic values in Suspense boundaries with appropriate fallbacks.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Next.js","language":"JavaScript","updated":"","comments":4,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-proper-use-of-suspense-in-nextjs-components.md"},{"slug":"nextjs-verify-documentation-references","title":"Verify documentation references","description":"When writing or updating documentation, ensure all code examples, installation commands, and project references accurately reflect the current codebase.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Documentation","language":"Markdown","updated":"","comments":4,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-verify-documentation-references.md"},{"slug":"react-balance-constraints-with-flexibility","title":"Balance constraints with flexibility","description":"When designing APIs, carefully evaluate constraints imposed on consumers. Each limitation should serve a clear purpose; otherwise, favor flexibility. Instead of rigid enforcement, consider more adaptable interfaces with documentation about recommended usage patterns.","repository":"facebook/react","domain":"app-frameworks","topic":"API","language":"JavaScript","updated":"","comments":4,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-balance-constraints-with-flexibility.md"},{"slug":"react-optimize-hot-paths","title":"Optimize hot paths","description":"In performance-critical code paths that execute frequently, optimize to reduce unnecessary operations that can impact runtime performance.","repository":"facebook/react","domain":"app-frameworks","topic":"Performance Optimization","language":"JavaScript","updated":"","comments":4,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-optimize-hot-paths.md"},{"slug":"axios-configuration-property-standards","title":"Configuration property standards","description":"Always define configuration properties with sensible defaults and consistent naming conventions. When adding new configurable features, establish clear defaults that follow platform conventions and document their purpose.","repository":"axios/axios","domain":"app-frameworks","topic":"Configurations","language":"JavaScript","updated":"","comments":3,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-configuration-property-standards.md"},{"slug":"axios-consistent-naming-conventions-for-axios-requests-and-responses","title":"Consistent Naming Conventions for Axios Requests and Responses","description":"When using the Axios library in TypeScript, it is important to follow consistent naming conventions to improve code readability and maintainability. Use the 'on' prefix for Axios event handlers and callbacks, use domain-specific prefixes like 'response' to clarify scope, maintain consistent naming patterns for similar functionality, and align with established conventions.","repository":"axios/axios","domain":"app-frameworks","topic":"Axios","language":"TypeScript","updated":"","comments":3,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-consistent-naming-conventions-for-axios-requests-and-responses.md"},{"slug":"axios-proper-axios-configuration-and-usage","title":"Proper Axios Configuration and Usage","description":"When implementing code that uses the Axios library in TypeScript, it is important to follow best practices for configuring and accessing Axios instances and settings. Ensure that Axios instances are properly configured with appropriate defaults, configuration properties are accessed correctly, and request-specific configuration overrides instance-level defaults in a predictable manner.","repository":"axios/axios","domain":"app-frameworks","topic":"Axios","language":"TypeScript","updated":"","comments":3,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-proper-axios-configuration-and-usage.md"},{"slug":"axum-document-feature-flags","title":"Document feature flags","description":"When configuring feature flags in Cargo.toml, ensure they are properly structured and documented. Chain feature dependencies correctly, document non-obvious configuration choices with comments, and use appropriate syntax for conditional feature activation.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"Configurations","language":"TOML","updated":"","comments":3,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-document-feature-flags.md"},{"slug":"azure-sdk-for-net-follow-formatting-standards","title":"Follow formatting standards","description":"Maintain consistent code formatting by adhering to the defined standards in the .editorconfig file and Azure SDK implementation guidelines at https://azure.github.io/azure-sdk/dotnet_implementation.html. Pay attention to these specific formatting rules:","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Code Style","language":"Markdown","updated":"","comments":3,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-follow-formatting-standards.md"},{"slug":"fastify-consistent-fastify-integration-patterns","title":"Consistent Fastify Integration Patterns","description":"When implementing integrations and plugins using the Fastify framework, maintain consistent coding patterns and conventions: follow Fastify's recommended package naming conventions, ensure integrations provide clear and comprehensive documentation, use Fastify's built-in type definitions and decorators consistently, and include full RFC references when referencing external protocol standards.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Fastify","language":"TypeScript","updated":"","comments":3,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-consistent-fastify-integration-patterns.md"},{"slug":"nextjs-consistent-variable-style-patterns","title":"Consistent variable style patterns","description":"Maintain consistent patterns for variable declarations and naming conventions: use const by default for variable declarations, use clear complete words in variable names instead of abbreviations, and for truthiness checks prefer simple boolean conditions unless explicit null/undefined checks are required.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"","comments":3,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-consistent-variable-style-patterns.md"},{"slug":"nextjs-optimize-data-structure-selection","title":"Optimize data structure selection","description":"Choose data structures that match your specific access patterns and performance requirements. The right data structure can significantly improve performance without requiring algorithm changes.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Performance Optimization","language":"Rust","updated":"","comments":3,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-optimize-data-structure-selection.md"},{"slug":"nextjs-prefer-existence-checks-in-nextjs-components","title":"Prefer Existence Checks in Next.js Components","description":"When working with props, state, or other values in Next.js components that may be null, undefined, or contain error states, use existence checks rather than direct property access or value comparisons.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Next.js","language":"JavaScript","updated":"","comments":3,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-prefer-existence-checks-in-nextjs-components.md"},{"slug":"nextjs-verify-workflow-configuration-integrity","title":"Verify workflow configuration integrity","description":"Carefully review GitHub Actions workflow configurations to prevent subtle errors that can cause CI/CD pipeline failures or unexpected behavior.","repository":"vercel/next.js","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"","comments":3,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-verify-workflow-configuration-integrity.md"},{"slug":"nextjs-write-concise-idiomatic-code","title":"Write concise idiomatic code","description":"Favor concise and idiomatic expressions in your Rust code to improve readability and maintainability.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Code Style","language":"Rust","updated":"","comments":3,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-write-concise-idiomatic-code.md"},{"slug":"react-check-property-existence-first","title":"Check property existence first","description":"Always verify that an object and its properties exist before accessing them to prevent 'cannot read property of undefined/null' errors. This is especially important when dealing with objects that might come from different build environments or third-party libraries.","repository":"facebook/react","domain":"app-frameworks","topic":"Null Handling","language":"JavaScript","updated":"","comments":3,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-check-property-existence-first.md"},{"slug":"react-complete-hook-dependencies","title":"Complete hook dependencies","description":"Always specify complete dependency arrays in React hooks to prevent bugs from stale closures and avoid unnecessary rerenders. When using hooks like useEffect, useMemo, or useCallback, include all values from the component scope that are referenced inside the hook's callback function.","repository":"facebook/react","domain":"app-frameworks","topic":"React","language":"JavaScript","updated":"","comments":3,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-complete-hook-dependencies.md"},{"slug":"react-match-errors-to-context","title":"Match errors to context","description":"Choose error handling mechanisms based on the error's severity and context. For critical issues that should prevent further execution, throw explicit exceptions. For non-critical issues, use logging with sufficient detail to aid debugging without interrupting execution.","repository":"facebook/react","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"","comments":3,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-match-errors-to-context.md"},{"slug":"react-optimize-react-component-dependencies","title":"Optimize React Component Dependencies","description":"When implementing React components, ensure that dependencies between component state, props, and side effects are accurately tracked to prevent missed updates and unnecessary re-renders.","repository":"facebook/react","domain":"app-frameworks","topic":"React","language":"TypeScript","updated":"","comments":3,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-optimize-react-component-dependencies.md"},{"slug":"react-separate-conditional-paths","title":"Separate conditional paths","description":"When working with concurrent operations, separate conditional logic from potentially expensive or suspenseful execution paths. This improves performance, prevents race conditions, and makes concurrent code more predictable and maintainable.","repository":"facebook/react","domain":"app-frameworks","topic":"Concurrency","language":"JavaScript","updated":"","comments":3,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-separate-conditional-paths.md"},{"slug":"react-use-appropriate-testing-methods","title":"Use appropriate testing methods","description":"When writing tests, use the appropriate testing utilities and ensure proper test isolation. For testing warning behaviors, use assertConsoleErrorDev instead of environment flags. For testing sequential actions, use logging utilities with corresponding assertions. Always clean up after tests that use mocks.","repository":"facebook/react","domain":"app-frameworks","topic":"Testing","language":"JavaScript","updated":"","comments":3,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-use-appropriate-testing-methods.md"},{"slug":"react-verify-performance-empirically","title":"Verify performance empirically","description":"Always validate performance optimizations through measurement rather than assumptions. Run multiple iterations of performance tests to ensure statistical significance and reduce noise in your metrics.","repository":"facebook/react","domain":"app-frameworks","topic":"Performance Optimization","language":"TypeScript","updated":"","comments":3,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-verify-performance-empirically.md"},{"slug":"axios-consistent-axios-usage-patterns","title":"Consistent Axios Usage Patterns","description":"Maintain consistent usage of the Axios library throughout your TypeScript codebase. Pay special attention to consistent error handling, Axios configuration options, Axios request patterns, and Axios response handling.","repository":"axios/axios","domain":"app-frameworks","topic":"Axios","language":"TypeScript","updated":"","comments":2,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-consistent-axios-usage-patterns.md"},{"slug":"axios-consistent-semicolon-usage","title":"Consistent semicolon usage","description":"Always terminate statements with explicit semicolons to maintain consistency with the existing codebase style. Avoid relying on JavaScript's automatic semicolon insertion (ASI) feature, as this can lead to inconsistent code appearance and potential subtle bugs.","repository":"axios/axios","domain":"app-frameworks","topic":"Code Style","language":"TypeScript","updated":"","comments":2,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-consistent-semicolon-usage.md"},{"slug":"axios-flexible-configuration-design","title":"Flexible configuration design","description":"Design configuration interfaces to be flexible and extensible rather than overly specific. When creating configuration objects, make configuration parameters optional when possible with sensible defaults and allow for arbitrary additional properties rather than creating specific fields for custom configurations.","repository":"axios/axios","domain":"app-frameworks","topic":"Configurations","language":"TypeScript","updated":"","comments":2,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-flexible-configuration-design.md"},{"slug":"axios-user-friendly-error-messages","title":"User-friendly error messages","description":"Error messages should be concise and clearly communicate what went wrong without unnecessary verbosity. When implementing error handling, maintain consistent code style and organize related operations logically within appropriate blocks.","repository":"axios/axios","domain":"app-frameworks","topic":"Error Handling","language":"Html","updated":"","comments":2,"stars":107000,"raw":"https://awesomereviewers.com/raw/axios-user-friendly-error-messages.md"},{"slug":"axum-implement-distributed-tracing-in-axum-applications","title":"Implement Distributed Tracing in Axum Applications","description":"As an Axum code reviewer, I recommend implementing proper distributed tracing in your Axum-based web applications to ensure observability across service boundaries. Use Axum's built-in middleware layers to consistently instrument your code.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"Axum","language":"TypeScript","updated":"","comments":2,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-implement-distributed-tracing-in-axum-applications.md"},{"slug":"axum-use-appropriate-concurrency-patterns-with-axum","title":"Use Appropriate Concurrency Patterns with Axum","description":"When building asynchronous Axum applications that share mutable state, it's important to select the right concurrency mechanisms. Use Axum's built-in Mutex or RwLock for general shared state, prefer connection pools for shared I/O resources, and consider the actor pattern for complex shared operations.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"Axum","language":"TypeScript","updated":"","comments":2,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-use-appropriate-concurrency-patterns-with-axum.md"},{"slug":"azure-sdk-for-net-document-maintenance-decisions","title":"Document maintenance decisions","description":"Add clear documentation for any decisions that affect future code maintenance. This includes: 1. Providing explanatory comments for non-obvious default values in parameters","repository":"Azure/azure-sdk-for-net","domain":"cloud-infra","topic":"Documentation","language":"Other","updated":"","comments":2,"stars":5809,"raw":"https://awesomereviewers.com/raw/azure-sdk-for-net-document-maintenance-decisions.md"},{"slug":"fastify-consistent-fastify-package-naming-and-references","title":"Consistent Fastify Package Naming and References","description":"When implementing code using the Fastify package in TypeScript, it is important to use consistent and accurate naming conventions for Fastify-related references: always use the actual Fastify package name, use correct Fastify terminology and casing, and organize Fastify-related imports and references alphabetically.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Fastify","language":"TypeScript","updated":"","comments":2,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-consistent-fastify-package-naming-and-references.md"},{"slug":"fastify-ensure-proper-null-handling-when-using-fastify-decorators","title":"Ensure Proper Null Handling When Using Fastify Decorators","description":"When working with Fastify decorators, always perform explicit null checks before accessing potentially undefined properties. Relying on implicit null handling can lead to subtle bugs and unexpected behavior.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Fastify","language":"TypeScript","updated":"","comments":2,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-ensure-proper-null-handling-when-using-fastify-decorators.md"},{"slug":"fastify-proper-ipv6-address-formatting","title":"Proper IPv6 address formatting","description":"When constructing URLs with IP addresses, ensure IPv6 addresses are properly formatted according to RFC standards by wrapping them in square brackets. This applies to all IPv6 addresses, not just specific cases like localhost. Additionally, use appropriate event handlers for network events that should only be handled once per connection.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Networking","language":"JavaScript","updated":"","comments":2,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-proper-ipv6-address-formatting.md"},{"slug":"fastify-secure-fastify-code-implementation","title":"Secure Fastify Code Implementation","description":"This review focuses on secure implementation patterns when using the Fastify web framework in TypeScript: prevent Prototype Pollution Attacks by avoiding direct property access on untrusted objects, and protect Against Denial-of-Service Attacks by configuring appropriate request timeouts.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Fastify","language":"TypeScript","updated":"","comments":2,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-secure-fastify-code-implementation.md"},{"slug":"fastify-support-flexible-logging","title":"Support flexible logging","description":"When designing logging interfaces, create flexible APIs that accommodate both standard and custom logging needs. This includes supporting custom log levels, allowing message format customization, and enabling level selection based on context.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Logging","language":"JavaScript","updated":"","comments":2,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-support-flexible-logging.md"},{"slug":"fastify-use-bot-identity","title":"Use bot identity","description":"When configuring Git operations in GitHub Actions workflows, especially for automated commits, use the GitHub Actions bot identity instead of personal user accounts. This clearly distinguishes automated actions from manual ones, provides better audit trails, and avoids personal attribution for system-generated changes.","repository":"fastify/fastify","domain":"app-frameworks","topic":"CI/CD","language":"Yaml","updated":"","comments":2,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-use-bot-identity.md"},{"slug":"fastify-verify-types-in-tests","title":"Verify types in tests","description":"Use explicit type assertions in TypeScript tests to verify that types behave as expected across various scenarios. Include assertions for inheritance relationships, property types, and different response status codes.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Testing","language":"TypeScript","updated":"","comments":2,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-verify-types-in-tests.md"},{"slug":"kubeflow-standardize-metrics-collection","title":"Standardize metrics collection","description":"Use the appropriate metric types for the data being collected and consider\\ \\ centralizing monitoring code to ensure consistency across components. \\n\\nFor\\ \\ accumulating values like request counts, use counters rather than gauges:","repository":"kubeflow/kubeflow","domain":"ml-systems","topic":"Observability","language":"Go","updated":"","comments":2,"stars":15064,"raw":"https://awesomereviewers.com/raw/kubeflow-standardize-metrics-collection.md"},{"slug":"nextjs-choose-optimal-data-structures","title":"Choose optimal data structures","description":"Select data structures based on their performance characteristics and actual usage patterns. When implementing algorithms, consider usage patterns, understand API differences, and match data structures to access patterns.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Algorithms","language":"Rust","updated":"","comments":2,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-choose-optimal-data-structures.md"},{"slug":"nextjs-complete-data-structures","title":"Complete data structures","description":"When implementing data structures such as tries, trees, or graphs, ensure all critical operations (insertion, deletion, traversal) are fully implemented with proper cleanup logic. Incomplete implementations can lead to memory leaks, stale data, and incorrect application behavior.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Algorithms","language":"TypeScript","updated":"","comments":2,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-complete-data-structures.md"},{"slug":"nextjs-complete-error-handling-flows","title":"Complete error handling flows","description":"Implement robust error handling patterns that ensure both proper resource cleanup and error context preservation.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Error Handling","language":"TypeScript","updated":"","comments":2,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-complete-error-handling-flows.md"},{"slug":"nextjs-dependency-conscious-apis","title":"Dependency conscious APIs","description":"Design APIs with dependency implications in mind. Carefully consider how your API design choices might force dependencies on consumers, which can lead to dependency bloat or tight coupling between components.","repository":"vercel/next.js","domain":"app-frameworks","topic":"API","language":"Rust","updated":"","comments":2,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-dependency-conscious-apis.md"},{"slug":"nextjs-document-configuration-sources","title":"Document configuration sources","description":"When providing configuration instructions, document the exact location and method to obtain required values. Include specific paths, URLs, or UI navigation steps needed to find configuration settings.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Configurations","language":"JSON","updated":"","comments":2,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-document-configuration-sources.md"},{"slug":"nextjs-non-blocking-observability-mechanisms","title":"Non-blocking observability mechanisms","description":"When implementing observability mechanisms like telemetry or status monitoring, ensure they don't block or interfere with critical application operations. Use background processes for telemetry submissions and dedicated endpoints for status checks.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Observability","language":"TypeScript","updated":"","comments":2,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-non-blocking-observability-mechanisms.md"},{"slug":"nextjs-proper-panic-chains","title":"Proper panic chains","description":"When implementing panic handlers, follow these critical practices to ensure robust error handling: register panic handlers early, chain new handlers with existing ones, and use appropriate error type downcasting methods.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Error Handling","language":"Rust","updated":"","comments":2,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-proper-panic-chains.md"},{"slug":"nextjs-robust-error-handling-in-nextjs-components","title":"Robust Error Handling in Next.js Components","description":"When building Next.js components, it is crucial to implement robust error handling to ensure the stability and predictability of your application. Always explicitly check for error conditions before proceeding with normal execution flow.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Next.js","language":"JavaScript","updated":"","comments":2,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-robust-error-handling-in-nextjs-components.md"},{"slug":"nextjs-validate-nextjs-configuration-usage","title":"Validate Next.js Configuration Usage","description":"When implementing Next.js in your application, ensure that you are correctly using the framework's documented configuration options and patterns. Configuration in Next.js is handled in specific ways, and improper usage can lead to runtime errors or unexpected behavior.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Next.js","language":"JavaScript","updated":"","comments":2,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-validate-nextjs-configuration-usage.md"},{"slug":"react-defensive-handling-of-nullable-react-components","title":"Defensive Handling of Nullable React Components","description":"When working with React components that may return null or undefined values, implement defensive coding patterns to prevent runtime errors and improve code reliability.","repository":"facebook/react","domain":"app-frameworks","topic":"React","language":"TypeScript","updated":"","comments":2,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-defensive-handling-of-nullable-react-components.md"},{"slug":"react-document-code-intent","title":"Document code intent","description":"Add clear comments that explain the intent and behavior of code that might not be immediately obvious to other developers. Meaningful comments should provide context about why the code exists and how it works.","repository":"facebook/react","domain":"app-frameworks","topic":"Documentation","language":"JavaScript","updated":"","comments":2,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-document-code-intent.md"},{"slug":"react-dry-configuration-patterns","title":"Dry configuration patterns","description":"Apply DRY (Don't Repeat Yourself) principles to all configuration files to improve maintainability. Extract shared configuration options into reusable constants, especially for values used across multiple environments or settings.","repository":"facebook/react","domain":"app-frameworks","topic":"Configurations","language":"JavaScript","updated":"","comments":2,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-dry-configuration-patterns.md"},{"slug":"react-explicit-csp-nonce-management","title":"Explicit CSP nonce management","description":"When implementing Content Security Policy (CSP) protections, always explicitly pass nonce values to components rather than auto-applying them. This gives developers more control over security aspects and prevents potential security bypasses when integrating components from different sources.","repository":"facebook/react","domain":"app-frameworks","topic":"Security","language":"JavaScript","updated":"","comments":2,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-explicit-csp-nonce-management.md"},{"slug":"react-multi-stack-config-settings","title":"Multi-stack config settings","description":"When creating configuration files for development environments that use multiple technology stacks, ensure settings are properly scoped to accommodate different file types and tools within the same project.","repository":"facebook/react","domain":"app-frameworks","topic":"Configurations","language":"Other","updated":"","comments":2,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-multi-stack-config-settings.md"},{"slug":"react-proper-scoping-and-usage-of-react-variables","title":"Proper Scoping and Usage of React Variables","description":"When implementing React components, it is important to ensure that variables are properly scoped and used throughout the component lifecycle. This reviewer provides guidance on best practices for managing variable declarations and usage in React code.","repository":"facebook/react","domain":"app-frameworks","topic":"React","language":"TypeScript","updated":"","comments":2,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-proper-scoping-and-usage-of-react-variables.md"},{"slug":"react-proper-usage-of-react-hooks","title":"Proper Usage of React Hooks","description":"When using the React library in TypeScript, ensure that you are correctly implementing the recommended React hooks based on the version of ESLint being used in your project.","repository":"facebook/react","domain":"app-frameworks","topic":"React","language":"TypeScript","updated":"","comments":2,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-proper-usage-of-react-hooks.md"},{"slug":"react-standardize-url-handling","title":"Standardize URL handling","description":"When working with URLs in networking code, always use the standard `URL` constructor to properly resolve relative URLs against a base URL instead of manual string concatenation or ad-hoc replacements.","repository":"facebook/react","domain":"app-frameworks","topic":"Networking","language":"JavaScript","updated":"","comments":2,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-standardize-url-handling.md"},{"slug":"react-write-readable-conditionals","title":"Write readable conditionals","description":"Structure conditionals for maximum clarity and comprehension. Avoid unnecessary negation in boolean expressions, use else clauses appropriately, and organize compound conditions to reduce cognitive load.","repository":"facebook/react","domain":"app-frameworks","topic":"Code Style","language":"JavaScript","updated":"","comments":2,"stars":237000,"raw":"https://awesomereviewers.com/raw/react-write-readable-conditionals.md"},{"slug":"runtime-feature-flag-implementation","title":"Feature flag implementation","description":"When implementing feature flags, ensure consistency between runtime and compiled scenarios. Feature switches marked with `FeatureSwitchDefinition` must properly return the AppContext switch value when defined:","repository":"dotnet/runtime","domain":"runtimes","topic":"Configurations","language":"C#","updated":"","comments":2,"stars":16578,"raw":"https://awesomereviewers.com/raw/runtime-feature-flag-implementation.md"},{"slug":"axum-secure-cookie-configuration","title":"Secure cookie configuration","description":"Always set appropriate security flags on cookies, especially those used for authentication or session management. At minimum, include HttpOnly, Secure, and SameSite flags to prevent cookie theft, session hijacking, and cross-site request forgery attacks.","repository":"tokio-rs/axum","domain":"app-frameworks","topic":"Security","language":"Rust","updated":"","comments":1,"stars":22100,"raw":"https://awesomereviewers.com/raw/axum-secure-cookie-configuration.md"},{"slug":"fastify-secure-content-type-validation","title":"Secure Content-Type validation","description":"When implementing Content-Type validation, ensure regular expressions start with '^' or include ';?' to properly detect the essence MIME type. Improper validation patterns may create vulnerabilities to CORS attacks.","repository":"fastify/fastify","domain":"app-frameworks","topic":"Security","language":"JavaScript","updated":"","comments":1,"stars":34000,"raw":"https://awesomereviewers.com/raw/fastify-secure-content-type-validation.md"},{"slug":"nextjs-decode-before-validation","title":"Decode before validation","description":"Always decode URL paths before performing security validations to prevent bypass attacks using URL encoding. Security mechanisms that rely on string pattern matching can be circumvented when attackers use URL-encoded characters.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Security","language":"TypeScript","updated":"","comments":1,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-decode-before-validation.md"},{"slug":"nextjs-document-security-attributes","title":"Document security attributes","description":"When handling security-related attributes (like nonces, integrity hashes, or CSP directives), always document the logic and prioritize explicitly passed values over automatically provided ones.","repository":"vercel/next.js","domain":"app-frameworks","topic":"Security","language":"TSX","updated":"","comments":1,"stars":133000,"raw":"https://awesomereviewers.com/raw/nextjs-document-security-attributes.md"}]}
