Use environment variables

hashicorp/terraform
21
45532

When working with configurations that require sensitive data (credentials, tokens, passwords), always use environment...

Configurations Other

Prevent sensitive data exposure

bridgecrewio/checkov
20
7667

Never log or store sensitive information (passwords, tokens, secrets) in clear text. This common security vulnerabili...

Security Python

Optimize allocation hotspots

netty/netty
17
34227

Identify and optimize object allocation in performance-critical paths by applying appropriate allocation strategies b...

Performance Optimization Java

Extract for clarity

elastic/elasticsearch
16
73104

Extract complex or reused logic into focused, well-named methods with single responsibilities. This improves code rea...

Code Style Java

Protect sensitive data

bridgecrewio/checkov
16
7668

Never log, display, or store sensitive information like passwords, tokens, or secrets in clear text. This creates sig...

Security Python

Comprehensive documentation standards

tokio-rs/axum
16
22100

Create clear, well-structured API documentation following proper formatting, correct references, informative examples...

Documentation Rust

Use specific assertion methods

fastify/fastify
15
34000

Choose the appropriate assertion method based on the data type being tested. This improves test readability and provi...

Testing Javascript

Consistent naming patterns

octokit/octokit.net
14
2793

Follow consistent naming conventions throughout the codebase to improve readability and maintainability: 1. **Client...

Naming Conventions C#

Handle async operation errors

elie222/inbox-zero
14
8267

Always wrap asynchronous operations in try-catch-finally blocks to prevent unhandled promise rejections and ensure pr...

Error Handling TSX

Keep CI configurations minimal

laravel/framework
14
33763

When configuring CI workflows, include only the extensions, tools, and settings that are necessary for the specific t...

CI/CD Yaml
13
58382

Follow Spring Framework's code style guidelines to ensure consistency across the codebase. Key rules include: 1. **I...

Code Style Java

Code for readability

opencv/opencv
13
82865

Prioritize human readability when writing code. Split complex expressions into steps with meaningful variable names. ...

Code Style C++

Descriptive consistent naming

ghostty-org/ghostty
13
32864

Use descriptive, consistent naming that follows language and platform conventions. Choose names that clearly communic...

Naming Conventions Other
13
14036

Maintain clean, professional code by removing development artifacts and improving readability: 1. **Remove debug cod...

Code Style Java

Design interfaces, not implementations

zed-industries/zed
12
62119

Create intuitive API interfaces that abstract away implementation details while providing a consistent experience for...

API Rust

Use testify assertion libraries

vitessio/vitess
12
19815

Replace manual if-error checks with `testify`'s `assert` and `require` packages to make tests more readable, maintain...

Testing Go

Eliminate redundant constructs

apache/mxnet
12
20801

Remove unnecessary coding patterns that add complexity without providing value. Focus on clarity and simplicity by: ...

Code Style Python

Limit token permissions

chef/chef
12
7860

Always specify the minimum required permissions for the GITHUB_TOKEN in GitHub Actions workflows to enhance security....

Security Yaml

Eliminate code redundancy

vllm-project/vllm
11
51730

Keep your codebase maintainable by eliminating both unnecessary and duplicated code: 1. **Remove debugging artifacts...

Code Style Python

Minimize allocation hotspots

spring-projects/spring-framework
11
58382

Reduce object creation in performance-critical paths by carefully evaluating allocation patterns. For frequently inst...

Performance Optimization Java

Optimize for readability

dotnet/runtime
11
16578

Write code that clearly communicates intent by using appropriate naming and formatting techniques. Improve readabilit...

Code Style C#

Device-agnostic acceleration code

pytorch/pytorch
11
91345

Avoid hardcoding specific device types like 'cuda' in AI code. Instead, use device-agnostic approaches such as device...

AI Python

Craft actionable errors

opentofu/opentofu
11
25901

Create error messages that provide precise context, avoid unnecessary details, and give users clear actions to take. ...

Error Handling Go

Names express clear intent

JetBrains/kotlin
11
50857

Choose names that clearly express intent and follow established conventions. Prefer explicit, descriptive names over ...

Naming Conventions Kotlin

Sanitize all inputs

elie222/inbox-zero
11
8267

Properly sanitize or escape all user-provided inputs before using them in sensitive contexts to prevent injection att...

Security Typescript

Standardize platform-agnostic configuration

zed-industries/zed
10
62119

Ensure configuration handling is consistent and platform-agnostic by following these guidelines: 1. Use environment ...

Configurations Rust

Document code thoroughly

vllm-project/vllm
10
51730

Always include comprehensive documentation for your code through both docstrings and explanatory comments. For clas...

Documentation Python

Use proper types

tensorflow/tensorflow
10
190625

Maintain code clarity by using appropriate type declarations and parameter passing conventions: 1. **Prefer explicit...

Code Style Other

Complete API documentation

spring-projects/spring-framework
10
58382

Documentation should be complete, accurate, and follow Spring Framework conventions. Ensure your Javadocs include: 1...

Documentation Java

Standardize configuration paths

quarkusio/quarkus
10
14667

Follow consistent patterns for storing and referencing configuration files across projects. Place custom configuratio...

Configurations Other

Next.js directory structure

prowler-cloud/prowler
10
11834

Keep the Next.js `/app` directory strictly for routing purposes as per framework conventions. Non-routing related cod...

Code Style Typescript

Safe null handling

pola-rs/polars
10
34296

Always implement robust null handling patterns to prevent unexpected behavior and crashes. Consider all edge cases wh...

Null Handling Rust

Extract duplicated code

pola-rs/polars
10
34296

Identify and extract duplicated code into reusable functions or move common fields to parent structures. This makes t...

Code Style Rust

Consistent descriptive naming

opencv/opencv
10
82865

Use clear, descriptive names that follow consistent patterns established in the codebase and broader programming stan...

Naming Conventions Other

TypeScript naming standards

langchain-ai/langchainjs
10
15004

Follow consistent naming conventions in TypeScript to improve code clarity, type safety, and developer experience: 1...

Naming Conventions Typescript

Handle errors with care

elie222/inbox-zero
10
8267

Always implement comprehensive error handling for asynchronous operations, external API calls, and database operation...

Error Handling Typescript

Optimize for code readability

laravel/framework
10
33763

Prioritize code readability over clever solutions by: 1. Using early returns to reduce nesting 2. Leveraging modern P...

Code Style PHP

Centralize dependency management

deeplearning4j/deeplearning4j
10
14036

Manage dependencies at the top level using `` to ensure version consistency across modules and ...

Configurations Xml

Restrict public access

bridgecrewio/checkov
10
7667

Cloud resources should be configured to restrict public network access by default to minimize potential attack surfac...

Networking Python

Extract focused functions

bridgecrewio/checkov
10
7667

Break down complex logic into small, well-named functions that each do one thing well. This improves code readability...

Code Style Python

Consistent naming conventions

bridgecrewio/checkov
10
7668

Maintain consistent naming patterns throughout the codebase to improve readability and reduce confusion: 1. **Use de...

Naming Conventions Python

Type-safe flexible APIs

tokio-rs/axum
10
22100

Design APIs that favor both type safety and flexibility. Use strongly typed wrappers instead of primitive types, but ...

API Rust

Consistent semantic naming

vercel/ai
10
15590

Use clear, consistent, and semantic naming patterns across your codebase to improve readability and maintainability: ...

Naming Conventions Typescript

Prefer idiomatic Option handling

zed-industries/zed
9
62119

When handling null values in Rust, use idiomatic Option patterns instead of verbose nested conditionals. This improve...

Null Handling Rust

Avoid magic numbers

vllm-project/vllm
9
51730

Replace hardcoded values and magic numbers in AI model code with named constants or configuration parameters. This im...

AI Python

Propagate errors with context

vercel/turborepo
9
28115

Properly propagate errors to callers with sufficient context rather than handling them prematurely or hiding them. Le...

Error Handling Rust

Release locks before waking

tokio-rs/tokio
9
28989

In concurrent systems, it's critical to release locks before performing operations that might trigger reentrancy or b...

Concurrency Rust

Use consistent error handling

tensorflow/tensorflow
9
190625

Apply standardized error handling patterns across your codebase for improved reliability and debugging. For new code,...

Error Handling Other

Preserve API compatibility

spring-projects/spring-boot
9
77637

When evolving APIs, maintain backward compatibility to avoid breaking client code. Consider these guidelines: 1. **A...

API Java

Specific exceptions with context

dotnet/runtime
9
16578

Always throw the most specific exception type appropriate for the error condition and include contextual information ...

Error Handling C#

Optimize memory access

dotnet/runtime
9
16578

When implementing performance-critical algorithms, carefully consider memory access patterns. Document alignment assu...

Algorithms C#

Follow naming patterns

dotnet/runtime
9
16578

Maintain consistent naming patterns throughout your code to improve readability and maintainability. Follow these gui...

Naming Conventions C#

Self-documenting identifier names

rails/rails
9
57027

Use clear, self-documenting names for variables, methods, and classes that express intent without exposing unnecessar...

Naming Conventions Ruby

Layer security defenses

rails/rails
9
57027

Implement multiple layers of security throughout your application rather than relying on a single protection mechanis...

Security Markdown

Verify token security level

quarkusio/quarkus
9
14667

When refreshing or updating authentication tokens, always verify the new token maintains or exceeds the original toke...

Security Other

Appropriate error handling

pola-rs/polars
9
34296

Distinguish between implementation errors (invariant violations) and expected failure cases. For implementation error...

Error Handling Rust

Semantic over generic names

netty/netty
9
34227

Choose specific, descriptive names that clearly convey purpose over generic or abbreviated identifiers. Names should ...

Naming Conventions Java

Document public APIs

netty/netty
9
34227

All public-facing APIs must be thoroughly documented with clear javadocs. This includes: 1. **Classes and interfaces...

Documentation Java

Use transactions for consistency

elie222/inbox-zero
9
8267

Always wrap multiple related database operations in a transaction to ensure data consistency and prevent partial upda...

Database Typescript

Remove commented code

elie222/inbox-zero
9
8267

Commented-out code should be removed from the codebase rather than left as comments. Keeping commented code: 1. Clut...

Code Style TSX

Extract repeated code

grafana/grafana
9
68825

Identify and extract repeated code patterns into well-named functions to improve readability, maintainability, and te...

Code Style Go

Code structure clarity

ghostty-org/ghostty
9
32864

Write code with clear structural organization that enhances readability and maintainability. Extract duplicated or co...

Code Style Other

Explicit null handling

laravel/framework
9
33763

Use explicit identity comparisons for null checks and leverage modern PHP null-handling features to create more relia...

Null Handling PHP

Documentation translation guidelines

fastapi/fastapi
9
86871

Maintain consistency and accuracy when translating documentation. Ensure technical terms and special formatting eleme...

Documentation Markdown

Name reflects meaning

elastic/elasticsearch
9
73104

Choose names that clearly communicate the intent, behavior, and semantics of code elements. Names should be accurate,...

Naming Conventions Java

Remove debugging artifacts

deeplearning4j/deeplearning4j
9
14036

Production code should be free from debugging artifacts that reduce readability and maintainability. Remove all debug...

Code Style C++

Fail gracefully always

chef/chef
9
7860

Ensure code handles errors robustly by using protective patterns that prevent resource leaks, provide clear diagnosti...

Error Handling Ruby

Safe dictionary navigation

bridgecrewio/checkov
9
7668

Always use the `.get()` method with appropriate default values when accessing dictionaries instead of direct key acce...

Null Handling Python

Centralize environment variables

bridgecrewio/checkov
9
7668

All environment variables should be defined in a centralized location (`checkov/common/util/env_vars_config.py`) rath...

Configurations Python

Documentation quality standards

Azure/azure-sdk-for-net
9
5809

Ensure documentation is specific, complete, and actionable for developers: 1. **Provide meaningful content** - Avoid...

Documentation Markdown

Axum Code Review: Interaction Patterns

tokio-rs/axum
9
22100

When implementing Axum-based applications, it is crucial to ensure that the interaction patterns between components a...

Axum Typescript

Vectorize over Python loops

vllm-project/vllm
8
51730

Replace Python loops and list comprehensions with vectorized operations when processing tensors or performing repeate...

Performance Optimization Python

Catch specific exception types

vllm-project/vllm
8
51730

Avoid using broad exception handlers like `except Exception:` or bare `except:`. Instead, catch specific exception ty...

Error Handling Python

Prevent concurrent access races

vitessio/vitess
8
19815

When sharing data across goroutines, always use proper synchronization mechanisms to prevent race conditions. Race co...

Concurrency Go

Meaningful consistent naming

vitessio/vitess
8
19815

Use descriptive, semantically clear names that follow consistent patterns throughout the codebase. Names should conve...

Naming Conventions Go

Names should be descriptive

astral-sh/uv
8
60322

Use clear, descriptive names while avoiding redundant qualifiers. Choose full words over abbreviations unless the abb...

Naming Conventions Rust

Clear precise documentation

astral-sh/uv
8
60322

Documentation should use direct, precise language that accurately describes components and their behavior. Maintain c...

Documentation Rust

Validate configurations comprehensively

vercel/turborepo
8
28115

When implementing configuration systems, ensure comprehensive validation, testing, and documentation. Key requirement...

Configurations Rust

Descriptive, unambiguous identifiers

vercel/turborepo
8
28115

Choose names that clearly express intent and behavior while avoiding ambiguity. Identifiers should communicate their ...

Naming Conventions Rust

Write focused single-purpose tests

tokio-rs/tokio
8
28981

Break down large test cases into smaller, focused tests that each verify a single feature or behavior. Each test shou...

Testing Rust

Optimize algorithmic complexity

tokio-rs/tokio
8
28989

Always consider the time and space complexity implications of your code. Choose data structures and algorithms that m...

Algorithms Rust

Return results not panics

huggingface/tokenizers
8
9868

Libraries should never panic as this can crash applications using the library. Always return a `Result` type rather t...

Error Handling Rust

Descriptive specific names

spring-projects/spring-framework
8
58382

Choose names that are specific, descriptive, and accurately reflect the purpose and domain of variables, methods, cla...

Naming Conventions Java

Optimize test case design

spring-projects/spring-boot
8
77637

Write focused, efficient tests that validate core functionality without unnecessary complexity. Key principles: 1. T...

Testing Java

Follow consistent style conventions

spring-projects/spring-boot
8
77637

Spring Boot projects maintain specific coding style conventions for consistency and readability. When contributing co...

Code Style Java

Explicit security configurations

spring-projects/spring-boot
8
77637

When configuring security-related features, always use the most specific configurer classes to make security decision...

Security Java

Precise type narrowing

astral-sh/ruff
8
40619

Implement sound type narrowing algorithms that balance precision with correctness. When narrowing types: 1. For dire...

Algorithms Markdown

Organize tests for clarity

rails/rails
8
57027

Structure tests to maximize clarity and maintainability by: 1. Placing related tests together in appropriate test fil...

Testing Ruby

Optimize numerical precision

pytorch/pytorch
8
91345

When implementing AI operations that involve matrix multiplication or neural network components, explicitly support m...

AI C++

Use configurable default values

prowler-cloud/prowler
8
11834

Make configuration values flexible and robust by avoiding hardcoded values and providing sensible defaults. This ensu...

Configurations Python

Specific exception handling

prowler-cloud/prowler
8
11834

Handle exceptions with specificity rather than using broad catch-all blocks. Catch specific exception types, provide ...

Error Handling Python

Separate configuration lifecycles

opentofu/opentofu
8
25901

Maintain clear separation between different stages of configuration processing by creating dedicated structures for e...

Configurations Go

Log effectively for debugging

opentofu/opentofu
8
25901

Always include meaningful log messages at appropriate levels to aid in debugging and system monitoring. Follow these ...

Logging Go

Document intent and limitations

opentofu/opentofu
8
25901

Clearly document the intended purpose, scope limitations, and design decisions in your code. For all exported types, ...

Documentation Go

Follow GoDoc conventions

ollama/ollama
8
145704

Document code following Go's official documentation style guide (https://tip.golang.org/doc/comment). All exported fu...

Documentation Go

Descriptive balanced naming

ollama/ollama
8
145704

Choose identifier names that clearly communicate their purpose while maintaining an appropriate balance between brevi...

Naming Conventions Go

Use specific assertions

octokit/octokit.net
8
2793

Always write assertions that verify specific, expected values rather than simple existence or boolean checks. This en...

Testing C#

Document public API elements

octokit/octokit.net
8
2793

Every public API element (classes, methods, properties, constructors) must have XML documentation comments that clear...

Documentation C#

Technical documentation precision

vercel/next.js
8
133000

Ensure technical documentation is precise, accurate, and correctly formatted to prevent confusion and improve develop...

Documentation Mdx

Secure Data Handling in Next.js Applications

vercel/next.js
8
133000

When building Next.js applications that handle sensitive data, it's crucial to implement robust security measures to ...

Next.js Javascript

Effective Cache Management in Next.js Applications

vercel/next.js
8
133000

When implementing caching in Next.js applications, it is crucial to be intentional about the caching behavior for eac...

Next.js Javascript

Design domain-specific error types

neondatabase/neon
8
19015

Create and use domain-specific error types instead of generic errors or anyhow. This improves error handling clarity ...

Error Handling Rust

Technical precision matters

apache/mxnet
8
20801

When documenting AI models, frameworks, and optimization techniques, precision in language is as important as precisi...

AI Markdown

Effective API samples

JetBrains/kotlin
8
50857

Create clear, comprehensive, and properly structured code samples to document API usage. Follow these principles: 1....

Documentation Kotlin

Use descriptive names

influxdata/influxdb
8
30268

Names in code should be self-documenting, accurately reflect purpose, and follow consistent conventions. Apply these ...

Naming Conventions Go

Promote code clarity

influxdata/influxdb
8
30268

Write code that prioritizes clarity and maintainability over brevity. This involves several key practices: 1. **Extr...

Code Style Rust

Minimize critical path allocations

influxdata/influxdb
8
30268

Avoid unnecessary memory allocations in performance-critical code paths. These allocations not only consume memory bu...

Performance Optimization Rust

Lock with defer unlock

influxdata/influxdb
8
30268

Always follow the lock-defer-unlock pattern when protecting shared resources with mutexes. Acquire the lock, immediat...

Concurrency Go

Choose appropriate lock primitives

influxdata/influxdb
8
30268

Select lock types based on access patterns - prefer RWLock over Mutex for read-heavy operations to enable concurrent ...

Concurrency Rust

Documentation clarity and formatting

ghostty-org/ghostty
8
32864

Ensure documentation is clear, precise, and consistently formatted. Key practices include: 1. **Be explicit and unam...

Documentation Yaml

Use semantic exceptions

laravel/framework
8
33763

Choose exception types that accurately reflect the nature of the error. Use `LogicException` for developer errors lik...

Error Handling PHP

Precise type annotations

laravel/framework
8
33763

Always use the most specific and accurate type information possible in PHPDoc comments to improve static analysis, ID...

Documentation PHP

Write clear documentation

fastify/fastify
8
34000

Documentation should be clear, precise, and self-contained while following established style conventions. When writin...

Documentation Markdown

Isolate configuration concerns

fastapi/fastapi
8
86871

Keep configuration settings separate from application code by using environment variables or dedicated configuration ...

Configurations Markdown

Document all responses

fastapi/fastapi
8
86871

When designing APIs, thoroughly document all possible responses your endpoints can return, not just the "happy path" ...

API Markdown

Single source documentation

expressjs/express
8
67300

Maintain documentation with a single source of truth to prevent inconsistencies and reduce maintenance burden. When i...

Documentation Markdown

Enforce null safety patterns

expressjs/express
8
67300

Implement comprehensive null safety patterns to prevent runtime errors and ensure predictable behavior. Follow these ...

Null Handling Javascript

Optimize before implementing

elastic/elasticsearch
8
73104

Before implementing algorithms, evaluate their efficiency implications, especially for operations that may be execute...

Algorithms Java

Document API completely

deeplearning4j/deeplearning4j
8
14036

All public APIs must have comprehensive and clear documentation that helps developers understand functionality withou...

Documentation Java

Semantic naming patterns

crewaiinc/crewai
8
33945

Names should clearly communicate purpose, relationships, and domain context. Choose identifiers that reveal intent an...

Naming Conventions Python

Prefer pythonic simplicity

crewaiinc/crewai
8
33945

Use Python's expressive features to write cleaner, more maintainable code by reducing nesting and improving readabili...

Code Style Python

Extract and organize methods

chef/chef
8
7860

Break down large, complex methods into smaller, focused methods with clear names that describe their purpose. This im...

Code Style Ruby

Write pythonic code

bridgecrewio/checkov
8
7668

Embrace Python's idiomatic programming style to make your code more readable, concise, and maintainable. Follow these...

Code Style Python

Safe dictionary access

bridgecrewio/checkov
8
7667

Always use safe dictionary access patterns when handling potentially null or missing values. This prevents KeyError a...

Null Handling Python

Restrict public network

bridgecrewio/checkov
8
7668

Always configure cloud resources to restrict or disable public network access unless explicitly required for the appl...

Networking Python

Choose optimal algorithms

bridgecrewio/checkov
8
7667

Always select appropriate data structures and algorithms based on their performance characteristics and the specific ...

Algorithms Python

Write self-documenting tests

boto/boto3
8
9417

Tests should clearly communicate their purpose and expectations without requiring readers to analyze implementation d...

Testing Python

Use descriptive action names

apache/airflow
8
40858

Names should clearly indicate purpose and behavior using appropriate action verbs and descriptive terms. This applies...

Naming Conventions Python

Test through public APIs

zed-industries/zed
7
62119

Write comprehensive tests that validate functionality through public interfaces rather than testing implementation de...

Testing Rust

Follow logging best practices

vllm-project/vllm
7
51730

Maintain high-quality logging throughout the codebase by following these best practices: 1. **Use appropriate log le...

Logging Python

Check before access

vllm-project/vllm
7
51730

Always verify that objects, attributes, and variables are not None before accessing their properties, calling their m...

Null Handling Python

Dynamic configuration needs validation

vitessio/vitess
7
19815

When implementing dynamic configuration options, validate that the system actually supports runtime changes for that ...

Configurations Go

Descriptive consistent naming

vitejs/vite
7
74031

Choose variable, function, and class names that accurately reflect their purpose while maintaining consistency with e...

Naming Conventions Typescript

Structure for readability

astral-sh/uv
7
60322

Organize code to maximize readability and maintainability. When code becomes complex, break it down into smaller, mor...

Code Style Rust

Redact URL credentials

astral-sh/uv
7
60322

Always redact sensitive credentials in URLs before logging, displaying in error messages, or serializing to prevent a...

Security Rust

Organize tailwind classes

shadcn-ui/ui
7
90568

Structure your Tailwind CSS classes for readability and maintainability. Instead of long chains of conditional classe...

Code Style TSX

Structure conditional compilation

tokio-rs/tokio
7
28981

Use organized structural patterns for conditional compilation to improve code maintainability and readability. Avoid ...

Configurations Rust

Follow naming conventions

tokio-rs/tokio
7
28981

Choose names that follow established API conventions and guidelines to create a consistent, intuitive codebase: 1. F...

Naming Conventions Rust

Meaningful consistent names

tensorflow/tensorflow
7
190625

Choose names that are both semantically precise and follow consistent conventions. Names should accurately reflect be...

Naming Conventions Other
7
58382

Spring Framework tests must use AssertJ for assertions rather than JUnit's `Assertions`, Spring's `Assert` class, or ...

Testing Java

Maintain consistent naming patterns

spring-projects/spring-boot
7
77637

Follow established naming patterns and conventions throughout the codebase to ensure consistency and clarity. This in...

Naming Conventions Java

Consistent observability data

spring-projects/spring-boot
7
77637

When implementing observability features, always ensure consistency in your data model, especially with tags and attr...

Observability Java

Simplify code expressions

dotnet/runtime
7
16578

Strive for clarity by simplifying code expressions and reducing unnecessary complexity. Complex or verbose expression...

Code Style C++

Choose error strategies deliberately

astral-sh/ruff
7
40619

Make deliberate choices about error handling strategies based on the context. Decide between early returns with appro...

Error Handling Rust

Database-specific query optimization

rails/rails
7
57027

Leverage database-specific features to optimize queries and improve performance. Different database engines have uniq...

Database Ruby

Configure at proper scope

rails/rails
7
57027

Place configuration options at their proper scope within the framework hierarchy. Avoid tight coupling between compon...

Configurations Ruby

Meaningful error communication

quarkusio/quarkus
7
14667

Error handling should be designed to provide clear, actionable information to developers while avoiding redundancy. F...

Error Handling Java

Document configuration comprehensively

quarkusio/quarkus
7
14667

Configuration properties should be thoroughly documented with explicit details about constraints, units, default valu...

Configurations Java

API evolution strategy

quarkusio/quarkus
7
14667

Design APIs with future extensibility in mind by using parameter objects instead of direct method parameters. When an...

API Java

Document code rationale

pydantic/pydantic
7
24377

Add clear comments that explain the "why" behind non-obvious code decisions, complex logic, or special-case handling....

Documentation Python

Consistent term capitalization

pydantic/pydantic
7
24377

Follow consistent capitalization rules for technical terms, acronyms, and library names throughout your codebase and ...

Naming Conventions Markdown

Meaningful consistent naming

prowler-cloud/prowler
7
11834

Use names that clearly describe the purpose and behavior of variables, methods, classes, and files, while maintaining...

Naming Conventions Python

Specify configuration behaviors

opentofu/opentofu
7
25901

When implementing configuration features (variables, flags, resources), thoroughly document their behavior in all sce...

Configurations Markdown

Optimize code location scope

open-telemetry/opentelemetry-python
7
2061

Place code in the most specific and appropriate location to improve findability and maintainability. Follow these pri...

Code Style Python
7
2061

Design APIs that can evolve without breaking existing code. Use keyword-only arguments (with `*,`) for optional param...

API Python

Use proper assertions

opencv/opencv
7
82865

Write tests with proper assertions to ensure reliability and maintainability. Follow these guidelines: 1. **Check fo...

Testing C++

Use optimized functions

opencv/opencv
7
82865

When implementing algorithms, prefer using OpenCV's built-in optimized functions over writing custom implementations....

Algorithms C++

Maintain consistent style

octokit/octokit.net
7
2793

Follow established patterns consistently throughout the codebase to improve readability and maintainability: 1. **Us...

Code Style C#

Simplify control flow

netty/netty
7
34227

Streamline code by simplifying control flow structures to improve readability. Eliminate unnecessary nesting and verb...

Code Style Java

Structure endpoints for REST

neondatabase/neon
7
19015

Organize API endpoints hierarchically by resource type and use appropriate HTTP methods based on operation semantics....

API Rust

Clear consistent identifier names

neondatabase/neon
7
19015

Choose clear, consistent, and non-redundant names for identifiers across the codebase. Follow these guidelines: 1. U...

Naming Conventions Rust

Simplify for readability

apache/mxnet
7
20801

Complex expressions, especially nested ternary operations, reduce code readability and maintainability. Prefer simple...

Code Style Other

Consistent naming patterns

apache/mxnet
7
20801

Maintain consistent naming conventions throughout the codebase to enhance readability and reduce confusion. This appl...

Naming Conventions Python

Use comprehensive JSDoc

langchain-ai/langchainjs
7
15004

Always use JSDoc format (`/** */`) instead of regular comments (`//`) for documenting classes, functions, and interfa...

Documentation Typescript

Preserve API backward compatibility

langchain-ai/langchainjs
7
15004

When modifying existing APIs, maintain backward compatibility by implementing changes in a non-breaking way. Use meth...

API Typescript

Simplify code structure

kubeflow/kubeflow
7
15064

Strive to simplify code structure by eliminating unnecessary complexity. This includes: 1. **Move conditions higher ...

Code Style Go

Precise workflow triggers

kubeflow/kubeflow
7
15064

Configure CI/CD workflows to trigger precisely based on relevant file path changes. This minimizes unnecessary builds...

CI/CD Yaml

Go export naming conventions

kubeflow/kubeflow
7
15064

In Go, the first letter of an identifier (function, variable, struct field, etc.) determines its visibility outside t...

Naming Conventions Go

Use configuration property providers

JetBrains/kotlin
7
50857

Always use Gradle's Provider API when accessing project, system, or Gradle properties in your build configuration. Th...

Configurations Kotlin

Test edge cases

JetBrains/kotlin
7
50857

Ensure tests verify both basic functionality and edge cases. Tests that only cover the happy path can miss critical b...

Testing Kotlin

Minimize unnecessary work

JetBrains/kotlin
7
50857

Optimize performance by reducing the amount of computation performed, especially on data that won't appear in the fin...

Performance Optimization Kotlin

Keep code clearly organized

JetBrains/kotlin
7
50857

Maintain code readability and organization by extracting focused, well-named functions and using appropriate scoping....

Code Style Kotlin

Design extensible stable APIs

JetBrains/kotlin
7
50857

When designing public APIs, prioritize extensibility while maintaining backward compatibility and implementation hidi...

API Kotlin

Use testify assertions

influxdata/influxdb
7
30268

Always use the testify package (require/assert) in tests instead of standard Go testing assertions. The testify libra...

Testing Go

Validate environment variables strictly

elie222/inbox-zero
7
8267

Enforce strict validation of environment variables using Zod schemas with explicit environment-specific rules. Requir...

Configurations Typescript

Safe concurrent programming

grafana/grafana
7
68825

When working with concurrent code, carefully manage shared resources and synchronization to prevent race conditions, ...

Concurrency Go

Follow documentation conventions

grafana/grafana
7
68825

Ensure documentation adheres to established style guidelines and technical standards: 1. **Use proper terminology an...

Documentation Markdown

Use modern PHPUnit attributes

laravel/framework
7
33763

Prefer modern PHPUnit attributes over PHPDoc annotations for improved type safety, IDE support, and code readability ...

Testing PHP

Technical term consistency

fastapi/fastapi
7
86871

When working with multilingual codebases or documentation, maintain consistent naming conventions for technical terms...

Naming Conventions Markdown

Sync versus async tests

fastapi/fastapi
7
86871

Choose the appropriate testing approach based on your test requirements. For standard API endpoint testing, use `Test...

Testing Markdown

Standardize dependency version notation

expressjs/express
7
67300

When specifying dependencies in package.json, follow consistent version notation patterns that align with your projec...

Configurations Json

Follow StandardJS when modifying

expressjs/express
7
67300

When modifying existing code, update the touched lines to follow StandardJS conventions while preserving the style of...

Code Style Javascript

Clear intention in names

expressjs/express
7
67300

Choose names that clearly communicate intention and follow established conventions. This applies to variables, functi...

Naming Conventions Javascript

Document with examples

chef/chef
7
7860

Always include comprehensive documentation with clear examples for properties, methods, and code patterns. Documentat...

Documentation Ruby

Consistent descriptive naming patterns

chef/chef
7
7860

Use clear, descriptive names that follow consistent patterns across the codebase. For methods and properties: 1. Use...

Naming Conventions Ruby

Meaningful identifier names

bridgecrewio/checkov
7
7667

Choose descriptive and semantic identifiers that clearly convey purpose, role, and behavior. Avoid vague, generic nam...

Naming Conventions Python

Prevent algorithmic pitfalls

boto/boto3
7
9417

Avoid common algorithmic errors that lead to incorrect results or inefficient code by following these practices: 1. ...

Algorithms Python

Follow naming conventions

boto/boto3
7
9417

Use consistent and appropriate naming conventions based on the context in Python code: 1. **Classes**: Use `CamelCas...

Naming Conventions Python

Defensive null value handling

boto/boto3
7
9417

Always handle potential null/None values defensively by: 1. Using `.get()` for dictionary access instead of direct ke...

Null Handling Python

Design stable APIs

Azure/azure-sdk-for-net
7
5809

When creating or modifying APIs, carefully consider what becomes part of your public API surface to ensure backward c...

API Markdown

Check before dereferencing

Azure/azure-sdk-for-net
7
5809

Always verify objects are not null before dereferencing them, particularly when using methods that might return null ...

Null Handling C#

Defensive null checking

aws/aws-sdk-js
7
7628

Always perform explicit null/undefined checks before accessing properties or using values that could be null or undef...

Null Handling Javascript

Prefer Rust structural patterns

zed-industries/zed
6
62119

Use Rust's structural patterns to write more idiomatic and maintainable code. This includes: 1. Use early returns to...

Code Style Rust

Consider algorithmic complexity

zed-industries/zed
6
62119

When implementing algorithms, be mindful of their computational complexity and choose appropriate data structures for...

Algorithms Rust

Use self-documenting names

vllm-project/vllm
6
51730

Variable, function, and parameter names should accurately reflect their purpose, behavior, and content. Choosing desc...

Naming Conventions Python

Process configurations consistently

vllm-project/vllm
6
51730

Ensure that configuration data is processed consistently and correctly throughout the codebase. This includes: 1. **...

Configurations Python

Optimize data structures

vitessio/vitess
6
19815

Choose and implement data structures with careful consideration of algorithmic complexity, memory usage, and Go's spe...

Algorithms Go

Extract shared code patterns

vitessio/vitess
6
19815

Identify and extract repeated code patterns into reusable functions to improve maintainability and reduce duplication...

Code Style Go

Ensure documentation accuracy

vitejs/vite
6
74031

Documentation must precisely reflect the current codebase implementation. When documenting features, options, or APIs...

Documentation Markdown

Make errors user actionable

astral-sh/uv
6
60322

Error messages should provide clear, actionable information that helps users understand and resolve the problem. Each...

Error Handling Rust

Know your implicit configurations

vercel/turborepo
6
28115

When working with Turborepo, be aware of implicit configurations and special files that affect behavior even when not...

Configurations Other

Eliminate code duplication

vercel/turborepo
6
28115

Avoid duplicating logic, patterns, or data across the codebase. When similar code appears in multiple places, extract...

Code Style Rust

Use Option methods idiomatically

tokio-rs/tokio
6
28989

When dealing with Optional values, prefer Rust's built-in Option methods over manual null checks. This makes code mor...

Null Handling Rust

Structural configuration approaches

tokio-rs/tokio
6
28989

When working with feature flags and conditional compilation, prefer structural approaches over scattered configuratio...

Configurations Rust

Prefer explicit over concise

tokio-rs/tokio
6
28989

Choose explicit and unambiguous names over concise but unclear ones. When a method, type, or variable has a specific ...

Naming Conventions Rust

Organize code logically

tokio-rs/tokio
6
28989

Group related code elements together with a consistent and logical structure. Place stable fields and functionality f...

Code Style Rust

Optimize memory allocation

tokio-rs/tokio
6
28981

Be deliberate about memory allocation patterns to improve performance. Implement these practices: 1. **Pre-allocate ...

Performance Optimization Rust

Network API design consistency

tokio-rs/tokio
6
28989

When designing networking APIs, maintain consistency with existing interfaces while ensuring proper cross-platform co...

Networking Rust

Follow import style

tokio-rs/tokio
6
28981

Tokio projects follow specific import conventions for consistency and readability. Adhere to these guidelines: 1. Us...

Code Style Rust

Flexible consistent API patterns

tokio-rs/tokio
6
28989

Design APIs with flexibility and consistency by leveraging established patterns and avoiding unnecessary constraints....

API Rust

Design error handling carefully

tokio-rs/tokio
6
28989

When implementing error handling, balance between propagation and recovery. Design error types to preserve context wh...

Error Handling Rust

Simplify for readability

huggingface/tokenizers
6
9868

Prioritize code readability by using simpler and more direct expressions. When possible, return values directly inste...

Code Style Rust

Descriptive purpose-driven naming

hashicorp/terraform
6
45532

Choose identifiers that accurately describe their purpose and behavior, not just their type or how they're used. Name...

Naming Conventions Go

Contextual null checks

hashicorp/terraform
6
45532

Use type-appropriate null checking strategies based on the context of your data. For primitive values, ensure they ex...

Null Handling Go

Choose efficient implementations

tensorflow/tensorflow
6
190625

When implementing algorithms, prioritize both correctness and performance by selecting appropriate data structures, o...

Algorithms Other

Use appropriate collections

spring-projects/spring-framework
6
58382

Choose the right collection implementation for each algorithmic task to optimize both performance and readability. Us...

Algorithms Java

Meaningful exception design

spring-projects/spring-boot
6
77637

Design exceptions to provide clear context, preserve stack traces, and propagate correctly through your system. Key p...

Error Handling Java

Documentation clarity principles

spring-projects/spring-boot
6
77637

When writing technical documentation, adhere to these core principles to ensure clarity and effectiveness: 1. **Use ...

Documentation Other

Document configuration properties completely

spring-projects/spring-boot
6
77637

Configuration properties should be fully documented with clear descriptions, explicit default values, and proper meta...

Configurations Java

Concrete bean return types

spring-projects/spring-boot
6
77637

When defining `@Bean` methods in Spring configurations, use concrete return types rather than interfaces while using ...

Spring Java

Alphabetical ordering requirement

spring-projects/spring-boot
6
77637

Always maintain alphabetical ordering for lists of elements including dependencies, modules, configuration entries, a...

Code Style Other

Optimize common paths

dotnet/runtime
6
16578

Design algorithms that optimize for the most common execution paths by prioritizing frequent scenarios in conditional...

Algorithms Other

Model actual hardware costs

dotnet/runtime
6
16578

Base optimization decisions on accurate hardware cost models rather than outdated assumptions. Modern architectures h...

Performance Optimization C++

Document configuration intent

dotnet/runtime
6
16578

Configuration settings should be self-documenting with clear intent. When adding temporary workarounds, conditional f...

Configurations Other

Handle nulls with Option

astral-sh/ruff
6
40619

Use Rust's Option type and its methods effectively to handle nullable values. This improves code clarity and safety b...

Null Handling Rust

Prefer simpler expressions

rails/rails
6
57027

Always choose the simplest, most readable way to express your code logic. Unnecessary complexity makes code harder to...

Code Style Ruby

Minimize unnecessary object allocations

rails/rails
6
57027

Avoid creating unnecessary objects, especially in frequently executed code paths. This includes being mindful of impl...

Performance Optimization Ruby

Minimize public API surface

rails/rails
6
57027

Design APIs with a minimal public surface area by carefully controlling which methods and properties are exposed. Sta...

API Ruby

Follow documentation conventions

rails/rails
6
57027

Maintain consistent formatting and style in all documentation to improve readability and professionalism: 1. **Use p...

Documentation Markdown

Document APIs clearly

rails/rails
6
57027

When designing and documenting APIs, prioritize clarity and completeness through concrete examples and accurate param...

API Markdown

Thread-safe state management

quarkusio/quarkus
6
14667

When managing state accessed by multiple threads, ensure thread safety through appropriate synchronization mechanisms...

Concurrency Java

Graceful API evolution

pytorch/pytorch
6
91345

When modifying, deprecating, or replacing APIs, ensure a smooth transition experience for developers by following the...

API Python

Standardize dependency management

pydantic/pydantic
6
24377

Maintain consistent dependency management practices across CI workflows to ensure reliable builds and tests. Use the ...

CI/CD Yaml

Maintain code consistency

pydantic/pydantic
6
24377

Ensure code follows consistent patterns throughout the codebase, even when duplicating code is necessary. When simila...

Code Style Python

Least privilege principle

prowler-cloud/prowler
6
11834

Always follow the principle of least privilege by granting the minimum permissions necessary for functionality. This ...

Security Python

Optimize memory allocation patterns

pola-rs/polars
6
34296

Minimize memory allocations and optimize allocation patterns to improve performance. Key practices: 1. Pre-allocate ...

Performance Optimization Rust

Names reveal clear intent

pola-rs/polars
6
34296

Choose names that clearly communicate intent and context, avoiding ambiguity or confusion. Variable and function name...

Naming Conventions Rust

Explicit null handling

pola-rs/polars
6
34296

Always be explicit and consistent about how null values are handled in operations and documentation. This clarity pre...

Null Handling Python

Structure tests thoroughly

opentofu/opentofu
6
25901

Create well-structured tests with thorough coverage of both expected success and error conditions. Name test cases de...

Testing Go

Safe lock patterns

opentofu/opentofu
6
25901

When implementing concurrent operations, ensure locks are acquired and released properly in all execution paths. Alwa...

Concurrency Go

Reduce code nesting

opentofu/opentofu
6
25901

Minimize nesting levels and complexity in your code to improve readability and maintainability. Use early returns ins...

Code Style Go

Write purposeful comments

open-telemetry/opentelemetry-python
6
2061

Comments should explain "why" and "how" rather than restating what is already obvious from the code. Focus on providi...

Documentation Python

Sanitize observability data exports

open-telemetry/opentelemetry-python
6
2061

When exporting observability data (metrics, traces, logs) to external systems, properly sanitize all data fields to e...

Observability Python

Use OpenCV error mechanisms

opencv/opencv
6
82865

Always use OpenCV's built-in error handling mechanisms instead of C++ exceptions or custom error handling. This ensur...

Error Handling C++

Prevent null vulnerabilities

opencv/opencv
6
82865

Use container classes and smart pointers instead of manual memory allocation to prevent null pointer dereferences and...

Null Handling C++

Cross-platform API design rules

opencv/opencv
6
82865

Design public APIs to work seamlessly across different programming languages and platforms. Follow these key principl...

API Other

Clear API contracts

opencv/opencv
6
82865

Design APIs with clear contracts that behave exactly as their names and signatures suggest. Functions should do preci...

API C++

Optimize with standard library

ollama/ollama
6
145704

When implementing algorithms, prefer using Go's standard library over custom implementations or external dependencies...

Algorithms Go

Use nullable for optionals

octokit/octokit.net
6
2793

When a property or parameter represents an optional value that might be absent in requests or responses, use nullable...

Null Handling C#

Handling Dynamic Content in Next.js Components

vercel/next.js
6
133000

When implementing Next.js components that rely on dynamic content (e.g. random values, current time), it is crucial t...

Next.js Javascript

Use null validation utilities

netty/netty
6
34227

Consistently use utility methods like `ObjectUtil.checkNotNull()` or `Objects.requireNonNull()` to validate that para...

Null Handling Java

Memory ordering needs barriers

netty/netty
6
34227

Ensure proper memory ordering in concurrent code by using appropriate memory barriers and atomic operations based on ...

Concurrency Java

Optimize cargo dependencies

neondatabase/neon
6
19015

Maintain clean and efficient dependency configurations in Cargo.toml files by following these practices: 1. **Use wo...

Configurations Toml

Minimize unnecessary allocations

neondatabase/neon
6
19015

Avoid allocations and cloning when they don't provide sufficient benefit relative to their performance cost. Balance ...

Performance Optimization Rust

Log level appropriately

neondatabase/neon
6
19015

Select the appropriate log level based on operational significance and ensure messages are clear, accurate, and forma...

Logging Rust

Keep files focused small

neondatabase/neon
6
19015

Maintain code organization by keeping files focused on a single responsibility and splitting large files into smaller...

Code Style Rust

Optimize iteration patterns

apache/mxnet
6
20801

When iterating through collections, choose the most efficient iteration pattern based on what information you actuall...

Algorithms Python

Prefer nullish coalescing

langchain-ai/langchainjs
6
15004

When handling null or undefined values, use modern JavaScript patterns to write more robust and maintainable code: 1...

Null Handling Typescript

Prefer descriptive errors

JetBrains/kotlin
6
50857

When handling errors in your code, always provide detailed context in error messages to aid debugging. Use Kotlin's s...

Error Handling Kotlin

Wrap errors with context

influxdata/influxdb
6
30268

Always wrap errors with meaningful context using fmt.Errorf and %w verb. Include relevant identifiers (filenames, IDs...

Error Handling Go

Follow API conventions

influxdata/influxdb
6
30268

Design APIs following modern conventions and best practices to improve usability, maintainability, and consistency ac...

API Rust

Choose optimal data structures

influxdata/influxdb
6
30268

Select data structures based on specific access patterns and performance requirements. When both fast lookup and pred...

Algorithms Rust

Minimize redundant operations

elie222/inbox-zero
6
8267

Optimize application performance by preventing unnecessary renders, calculations, and network operations. Implement p...

Performance Optimization TSX

Handle nulls with types

elie222/inbox-zero
6
8267

Enforce type safety by properly handling null and undefined values through TypeScript types and explicit checks. Avoi...

Null Handling TSX

Enforce atomic database operations

elie222/inbox-zero
6
8267

Replace check-then-act patterns with atomic database operations to prevent race conditions in concurrent environments...

Concurrency Typescript

Explicit null validation

grafana/grafana
6
68825

Always validate objects for null/nil before accessing their properties, and establish consistent patterns for handlin...

Null Handling Go

Descriptive semantic names

grafana/grafana
6
68825

Always use descriptive variable, parameter, function, and constant names that clearly convey their purpose and behavi...

Naming Conventions TSX

Document code behavior

gin-gonic/gin
6
83022

Document the "why" and "how" of your code, not just what it does. Add clear comments to explain: 1. Non-obvious beha...

Documentation Go

Robust SSH integration

ghostty-org/ghostty
6
32864

When implementing SSH integration in your application, follow these practices to ensure reliability across different ...

Networking Other

Document configs comprehensively

ghostty-org/ghostty
6
32864

Configuration options must be documented comprehensively with: 1. Clear, descriptive name using appropriate platform...

Configurations Other

Organize code logically

fatedier/frp
6
95938

Maintain a clean and logical code structure by properly organizing code according to its functionality and purpose: ...

Code Style Go

Name indicates clear purpose

laravel/framework
6
33763

Names should clearly indicate their purpose, type, and behavior. This applies to methods, variables, and parameters. ...

Naming Conventions PHP

Cache expensive operations

laravel/framework
6
33763

Identify and cache results of expensive operations that may be called repeatedly during a request lifecycle, especial...

Performance Optimization PHP

Consistent test code style

fastify/fastify
6
34000

Maintain consistent and clear testing patterns by following these guidelines: use strict equality assertions, prefer ...

Code Style Javascript

Concurrent operations completion management

fastify/fastify
6
34000

When running concurrent operations in tests, ensure all operations complete before concluding the test. Race conditio...

Concurrency Javascript

Use configuration access methods

elastic/elasticsearch
6
73104

When accessing configuration settings, always use the appropriate type-safe accessor methods provided by the configur...

Configurations Java

Robust test assertions

elastic/elasticsearch
6
73104

Use precise, informative assertions in tests to provide clear feedback when tests fail and verify the correct behavio...

Testing Java

Prefer callbacks over blocking

elastic/elasticsearch
6
73104

Always structure concurrent code to use asynchronous callbacks instead of blocking operations. Blocking calls like Co...

Concurrency Java

Measure before optimizing performance

elastic/elasticsearch
6
73104

Before implementing performance optimizations, measure and validate the impact through benchmarks. This applies espec...

Performance Optimization Java

Validate and document nulls

deeplearning4j/deeplearning4j
6
14036

Always handle null values explicitly and consistently throughout your codebase to prevent null pointer exceptions. Fo...

Null Handling Java

Structure errors with intent

crewaiinc/crewai
6
33945

Implement error handling with clear intent and proper propagation. Follow these principles: 1. Use structured try/ca...

Error Handling Python

Write comprehensive test cases

vuejs/core
6
50769

Tests should thoroughly cover all code paths and edge cases. Each test case should: 1. Test distinct scenarios in sep...

Testing Typescript

Strict props event handling

vuejs/core
6
50769

Enforce strict typing and consistent handling of component props and events to ensure type safety, runtime validation...

Vue Typescript

Evolve APIs gracefully

vuejs/core
6
50769

When modifying or extending APIs, prioritize backward compatibility while providing clear migration paths for future ...

API Typescript

Choose semantic descriptive names

vuejs/core
6
50769

Names should be clear, descriptive and follow consistent patterns. Choose names that accurately reflect the purpose a...

Naming Conventions Typescript

Avoid redundant computations

vuejs/core
6
50769

Identify and eliminate redundant operations that cause performance bottlenecks by caching expensive function results,...

Performance Optimization Typescript

Never commit secrets

chef/chef
6
7860

Private cryptographic keys, certificates with private keys, and other secrets must never be committed to source code ...

Security Other

Memoize expensive operations

chef/chef
6
7860

Cache results of expensive operations, especially shell commands and external queries, to avoid redundant executions....

Performance Optimization Ruby

Keep actions versions current

chef/chef
6
7860

Always use the latest stable versions of GitHub Actions components in CI/CD workflows to avoid deprecated features, s...

CI/CD Yaml

Externalize configuration values

chef/chef
6
7860

Avoid hardcoding configuration values directly in scripts, especially for values that might change between environmen...

Configurations Shell

Choose semantic algorithms

chef/chef
6
7860

Select algorithms and data operations that match the semantic intent of your code rather than using convenient but po...

Algorithms Ruby

Document configuration consistently

bridgecrewio/checkov
6
7667

Ensure all configuration options are clearly documented and follow consistent naming and syntax conventions. This inc...

Configurations Markdown

Comprehensive API documentation

boto/boto3
6
9417

Always provide comprehensive API documentation that includes accurate examples, complete parameter descriptions, and ...

Documentation Python

Use domain-specific type names

Azure/azure-sdk-for-net
6
5809

Types should be named with clear domain context rather than generic terms. Avoid single-word or overly generic names ...

Naming Conventions C#

Minimize memory allocations

Azure/azure-sdk-for-net
6
5809

Reduce garbage collection pressure and improve application performance by avoiding unnecessary memory allocations. Th...

Performance Optimization C#

Document code reasoning

Azure/azure-sdk-for-net
6
5809

Add clear, concise comments that explain the "why" behind complex logic, non-obvious decisions, and implicit behavior...

Documentation C#

Prefer simpler code constructs

tokio-rs/axum
6
22100

Always opt for simpler, more idiomatic code constructs over complex or verbose alternatives. This includes using buil...

Code Style Rust

Semantic naming conventions

aws/aws-sdk-js
6
7628

Use descriptive, semantic names for all code elements that clearly indicate their purpose and behavior. Follow consis...

Naming Conventions Javascript

Early return after errors

aws/aws-sdk-js
6
7628

When handling errors in asynchronous functions, always return immediately after invoking a callback with an error to ...

Error Handling Javascript

Document APIs thoroughly

aws/aws-sdk-js
6
7628

All public API elements must be thoroughly documented with JSDoc annotations that clearly explain their purpose, para...

Documentation Javascript

Validate user-controlled paths

apache/airflow
6
40858

Always validate and sanitize user-provided inputs used in file path operations to prevent path traversal attacks. Pat...

Security Python

Standardize API parameter handling

apache/airflow
6
40858

Use consistent parameter handling patterns across API endpoints to ensure maintainability and predictable behavior. F...

API Python

Avoid code duplication

apache/airflow
6
40858

Extract repeated code patterns into reusable functions, variables, or constants to improve maintainability and reduce...

Code Style Python

Verify AI model capabilities

vercel/ai
6
15590

Always verify and accurately document AI model capabilities, supported formats, and limitations before implementation...

AI Other

Type-safe null handling

vercel/ai
6
15590

Use TypeScript's type system and modern JavaScript features to prevent null reference errors. **TypeScript type saf...

Null Handling Typescript

Keep tests simple

vercel/ai
6
15590

Tests should be straightforward, explicit, and free from complex logic or indirection. Avoid "magic" in tests that ma...

Testing Typescript

Use structured model metadata

zed-industries/zed
5
62119

Represent AI model information using structured data rather than hardcoded enumerations or conditionals. Store capabi...

AI Rust

Scope dependencies appropriately

zed-industries/zed
5
62119

Configure dependencies with their minimum necessary scope to maintain clean architecture and improve build times. Key...

Configurations Toml

Document configuration constraints clearly

zed-industries/zed
5
62119

When defining configuration options, always clearly document parameter constraints, valid ranges, and behaviors. For ...

Configurations Markdown

Choose domain-specific semantic names

zed-industries/zed
5
62119

Names should clearly reflect their domain-specific meaning and purpose, avoiding generic or ambiguous terms. This app...

Naming Conventions Rust

Validate algorithmic operations carefully

vllm-project/vllm
5
51730

Mathematical and logical operations require careful validation to ensure correctness. Common issues include: 1. Oper...

Algorithms Python

Remove unnecessary code elements

vllm-project/vllm
5
51730

Keep code clean and maintainable by removing unnecessary elements that add complexity without value: 1. Remove unuse...

Code Style CUDA

Preserve API compatibility

vllm-project/vllm
5
51730

When modifying API interfaces, parameters, or argument behavior, ensure backward compatibility is maintained to preve...

API Python

Optimize memory allocation

vitessio/vitess
5
19815

Always allocate data structures with appropriate initial capacity and use memory-efficient data types to reduce memor...

Performance Optimization Go

Runtime-agnostic API design

vitejs/vite
5
74031

When designing APIs for systems that support multiple JavaScript runtimes, prioritize decoupling server state from us...

API Markdown

Propagate errors with context

vitejs/vite
5
74031

Always propagate errors with proper context and recovery strategy. Use try-catch blocks for both synchronous and asyn...

Error Handling Typescript

Environment variable management

vitejs/vite
5
74031

When working with environment variables in Vite applications, be explicit about variable loading behavior and precede...

Configurations Markdown

Secure configuration defaults

astral-sh/uv
5
60322

Establish secure default configurations in project metadata files to prevent accidental publishing and ensure proper ...

Configurations Markdown

Optimize CI/CD commands

astral-sh/uv
5
60322

Design CI/CD workflows to be efficient, consistent, and purposeful across all environments. When writing or modifying...

CI/CD Yaml

Environment variable best practices

astral-sh/uv
5
60322

When implementing environment variable configuration: 1. Follow standard environment variable conventions: - Use upp...

Configurations Rust

Meaningful consistent identifiers

shadcn-ui/ui
5
90568

Choose descriptive, semantically accurate names for variables, types, and components that clearly communicate their p...

Naming Conventions TSX

Validate performance impact first

vercel/turborepo
5
28115

Always validate performance changes through profiling or benchmarking before implementation, and favor memory-efficie...

Performance Optimization Rust

Design ergonomic APIs

vercel/turborepo
5
28115

Create APIs that are both easy to use correctly and hard to use incorrectly. Focus on: 1. **Use pattern matching for...

API Rust

Structure feature flags strategically

tokio-rs/tokio
5
28989

Design feature flags to minimize dependency bloat while maximizing flexibility for users. Each optional dependency sh...

Configurations Toml

Structure API doc blocks

tokio-rs/tokio
5
28989

Each public API documentation block should follow a consistent structure: 1. Start with a single-line summary that c...

Documentation Rust

Socket configuration guidance

tokio-rs/tokio
5
28981

When implementing networking APIs, always clearly document socket modes, configuration options, and platform-specific...

Networking Rust

Optimize hot paths

tokio-rs/tokio
5
28989

Identify and optimize frequently executed code paths to improve performance. Hot paths have a significant impact on o...

Performance Optimization Rust

Graceful error handling

tokio-rs/tokio
5
28981

Prioritize graceful error handling over panicking by providing fallbacks and propagating rich context. When operation...

Error Handling Rust

Fast deterministic tests

tokio-rs/tokio
5
28989

Avoid using real sleeps or delays in tests as they significantly slow down the test suite and can introduce flakiness...

Testing Rust

Design flexible APIs

tokio-rs/tokio
5
28981

When designing APIs, prioritize flexibility, ergonomics, and intuitiveness to create better user experiences. APIs sh...

API Rust

Minimize memory allocations

huggingface/tokenizers
5
9868

Avoid unnecessary memory allocations to improve performance. Each allocation has both CPU and memory overhead that ca...

Performance Optimization Rust

Handle nullable types idiomatically

huggingface/tokenizers
5
9868

Use Rust's idiomatic patterns when working with Option and Result types to prevent panics and improve code clarity. ...

Null Handling Rust

Use precise semantic names

hashicorp/terraform
5
45532

Choose names that accurately reflect the purpose and semantics of the entity being named. Avoid overloaded or ambiguo...

Naming Conventions Other

Prefer modern authentication

hashicorp/terraform
5
45532

Always use modern identity-based authentication methods instead of static credentials when accessing external systems...

Security Other

Include descriptive documentation

hashicorp/terraform
5
45532

Provide complete, clear descriptions for all configuration elements in documentation. Every output, variable, argumen...

Documentation Other

Document function behavior completely

hashicorp/terraform
5
45532

Function and method documentation should accurately describe behavior, parameters, and any non-obvious aspects of the...

Documentation Go

Validate quantization parameters carefully

tensorflow/tensorflow
5
190625

When implementing quantized operations in ML models, thoroughly validate quantization parameters to ensure correctnes...

AI Other

Validate before dereference

tensorflow/tensorflow
5
190625

Always check that pointers, optional values, and results of type casts are valid before dereferencing or using them. ...

Null Handling Other

Optimize loop operations

tensorflow/tensorflow
5
190625

Minimize expensive operations within inner loops to improve performance. Key practices include: 1. Extract loop-inva...

Performance Optimization Other

Informative error messages

tensorflow/tensorflow
5
190625

Error messages should be informative, actionable, and concise to help users quickly understand and fix issues. Follow...

Error Handling Python

Handle dynamic shapes

tensorflow/tensorflow
5
190625

When implementing tensor-based algorithms, avoid assumptions about fixed tensor shapes by not relying on direct shape...

Algorithms Python

Teach by example

tensorflow/swift
5
6136

Present concepts through clear, focused examples that demonstrate features positively rather than through comparisons...

Documentation Other

Respect annotation processing order

spring-projects/spring-framework
5
58382

When designing Spring components, pay careful attention to the order in which annotations are processed, especially f...

Spring Java

Design for API extension

spring-projects/spring-framework
5
58382

When designing APIs, prioritize extensibility by providing clear extension points and avoiding direct exposure of imp...

API Java

Cleanup error handling

spring-projects/spring-framework
5
58382

When handling resources that require cleanup (like streams, connections, or transactions), ensure that errors during ...

Error Handling Java

API boundary null handling

spring-projects/spring-framework
5
58382

Establish consistent null handling patterns at API boundaries to prevent null pointer exceptions and improve code cla...

Null Handling Java

Property description conventions

spring-projects/spring-boot
5
77637

When documenting configuration properties in Spring Boot applications, follow these conventions for clarity and consi...

Documentation Java

Prevent null references

dotnet/runtime
5
16578

Use defensive coding practices to prevent null reference exceptions by properly handling potentially null values thro...

Null Handling C#

Maintainable test structure

dotnet/runtime
5
16578

Write tests that are maintainable, self-documenting, and that promote good testing practices: 1. **Use proper assert...

Testing C#

Document code meaningfully

dotnet/runtime
5
16578

Provide meaningful documentation that enhances code maintainability and understanding. Follow these practices: 1. **...

Documentation C#

Cache expensive computations

dotnet/runtime
5
16578

Avoid recomputing expensive operations by caching results when they will be used multiple times. This applies to meth...

Performance Optimization C#

Avoid busy waiting

dotnet/runtime
5
16578

When implementing concurrent code that waits for conditions to be met, avoid busy-wait loops that continuously consum...

Concurrency C#

Abstract traversal patterns

dotnet/runtime
5
16578

When implementing algorithms that operate on complex data structures (trees, graphs, dominator structures), abstract ...

Algorithms C++

Use descriptive identifiers

astral-sh/ruff
5
40619

Avoid abbreviations in variable, parameter, and method names to improve code readability and maintainability. Use des...

Naming Conventions Rust

Profile allocations before optimization

astral-sh/ruff
5
40619

Before implementing data structures or algorithms, analyze allocation patterns and optimize for common cases. Key str...

Performance Optimization Rust

Document component behavior comprehensively

astral-sh/ruff
5
40619

Documentation should clearly explain the purpose, behavior, and relationships between code components using accessibl...

Documentation Rust

Consider algorithmic complexity tradeoffs

astral-sh/ruff
5
40619

When implementing algorithms or data structures, carefully evaluate the tradeoffs between computational complexity, m...

Algorithms Rust

Write complete API examples

rails/rails
5
57027

Always provide complete, context-rich code examples in API documentation. Examples should show the full usage context...

Documentation Ruby

Place configurations appropriately

rails/rails
5
57027

Choose the right location and scope for your Rails configuration options to improve maintainability and clarity: 1. ...

Configurations Markdown

Initialize nil-prone variables

rails/rails
5
57027

Always initialize variables that might be nil to appropriate default values to prevent unexpected behavior. For boole...

Null Handling Ruby

Prefer Optional over nulls

quarkusio/quarkus
5
14667

Use Java's Optional API instead of null checks to improve code readability, safety, and maintainability. When dealing...

Null Handling Java

Optimize algorithmic operations

quarkusio/quarkus
5
14667

Before implementing or modifying algorithms, carefully evaluate data structure properties and operation costs. Always...

Algorithms Java

Name for meaning first

quarkusio/quarkus
5
14667

Choose names that prioritize domain meaning and clarity over implementation details. This applies to methods, variabl...

Naming Conventions Java

Document public APIs

quarkusio/quarkus
5
14667

All public APIs, interfaces, and methods should include comprehensive JavaDoc that clearly explains their purpose, pa...

Documentation Java

Clear database configuration examples

quarkusio/quarkus
5
14667

Database configuration examples in documentation should be correct, minimal, and include proper context. Provide only...

Database Other

Use higher-level iterations

pytorch/pytorch
5
91345

When working with multiple sequences that need to be combined, prefer higher-level iteration abstractions over nested...

Algorithms Python

Prevent null pollution

pytorch/pytorch
5
91345

Design your code to minimize the unexpected introduction of None values into data structures and APIs. Use immutable ...

Null Handling Python

Handle errors specifically

pytorch/pytorch
5
91345

Always be explicit and specific when handling errors rather than using catch-all approaches or implicit conventions. ...

Error Handling Python

Robust error messaging

pydantic/pydantic
5
24377

Create clear, specific, and actionable error messages that help users understand and resolve issues, while implementi...

Error Handling Python

Eliminate redundant computation

pydantic/pydantic
5
24377

Identify and eliminate redundant or duplicate computation paths in your code, especially for expensive operations lik...

Algorithms Python

Cache expensive computations

pydantic/pydantic
5
24377

Implement strategic caching and memoization for expensive or frequently repeated computations to avoid redundant work...

Performance Optimization Python

Secure authentication flows

prowler-cloud/prowler
5
11834

Implement authentication flows that protect sensitive information and follow secure credential management practices: ...

Security Markdown

Safe attribute access patterns

prowler-cloud/prowler
5
11834

Implement consistent patterns for safely accessing potentially null or undefined attributes and dictionary values. Th...

Null Handling Python

Prioritize code readability

prowler-cloud/prowler
5
11834

Write code that optimizes for human readability and understanding. Complex expressions, while technically correct, ca...

Code Style Python

Consistent naming patterns

prowler-cloud/prowler
5
11834

Follow systematic naming conventions for types, interfaces, and functions to enhance code readability and navigabilit...

Naming Conventions Typescript

Hide implementation details

pola-rs/polars
5
34296

Design public APIs to hide implementation details and focus on the user's mental model of the system. Avoid exposing ...

API Python

Explicit configuration precedence

pola-rs/polars
5
34296

Implement a clear configuration resolution chain that follows a consistent precedence pattern: explicit parameters fi...

Configurations Python

Evaluate algorithmic complexity tradeoffs

pola-rs/polars
5
34296

When implementing algorithms, carefully evaluate tradeoffs between performance optimizations and code maintainability...

Algorithms Rust

Document with examples

opentofu/opentofu
5
25901

Always include clear, contextual examples when documenting APIs, interfaces, or command-line functionality. Examples ...

API Markdown

Defensive null handling

opentofu/opentofu
5
25901

Always initialize data structures before use, particularly before accessing them in loops or conditional blocks. Chec...

Null Handling Go

Clear concise documentation

opentofu/opentofu
5
25901

Write documentation that is direct, consistent, and appropriately detailed. Follow these principles: 1. **Use direct...

Documentation Other

Optimize configuration structure

open-telemetry/opentelemetry-python
5
2061

Structure configuration files like tox.ini to maximize maintainability and efficiency. Use factor prefixes (e.g., "te...

Configurations Other

Handle exceptions appropriately

open-telemetry/opentelemetry-python
5
2061

When implementing error handling logic, be deliberate about which exception types you catch and where you handle them...

Error Handling Python

Follow Python naming conventions

open-telemetry/opentelemetry-python
5
2061

Use consistent Python naming conventions to improve code readability and maintainability: 1. Use snake_case for func...

Naming Conventions Python

Configuration source precedence

open-telemetry/opentelemetry-python
5
2061

Define and document a clear precedence order when configurations come from multiple sources (code parameters, environ...

Configurations Python

Optimize memory allocation patterns

opencv/opencv
5
82865

Prefer efficient memory allocation patterns to improve performance. Key practices: 1. Use RAII containers (like Mat)...

Performance Optimization C++

Optimize container access

opencv/opencv
5
82865

Choose efficient container types and optimize access patterns in performance-critical code. Avoid operations that cau...

Performance Optimization Other

Maintain code consistency

opencv/opencv
5
82865

Keep code clean and consistent with established project conventions. This includes: 1. Follow existing formatting st...

Code Style Other

Guard optional dependencies

opencv/opencv
5
82865

Configuration management requires careful handling of optional dependencies in both build scripts and source code. Al...

Configurations Other

Use idiomatic Go flow

ollama/ollama
5
145704

Follow Go's idiomatic control flow patterns to improve code readability and maintainability. Key practices include: ...

Code Style Go

Use environment variables

ollama/ollama
5
145704

Use environment variables instead of hardcoding configuration values such as file paths, port numbers, or system-spec...

Configurations Go

Guard against nil

ollama/ollama
5
145704

Always check for nil values and successful type assertions before accessing or dereferencing objects, especially when...

Null Handling Go

Document synchronization intent

ollama/ollama
5
145704

Always clearly document the purpose and scope of synchronization primitives (mutexes, read-write locks) by: 1. Placi...

Concurrency Go

Comprehensive test coverage

ollama/ollama
5
145704

Test functions should provide comprehensive coverage of both expected and edge cases. Include tests for: 1. **Bounda...

Testing Go

Clear recoverable error messages

ollama/ollama
5
145704

Error messages should be clear, actionable, and indicate whether recovery is possible. When designing error handling:...

Error Handling Go

Abstract model operations cleanly

ollama/ollama
5
145704

When implementing AI model operations, create clean abstractions through interfaces that separate core mathematical o...

AI Go

Design intuitive API methods

octokit/octokit.net
5
2793

When designing API methods, prioritize intuitive usage patterns and backwards compatibility. Follow these guidelines:...

API C#

Write robust assertions

vercel/next.js
5
133000

When writing tests, ensure assertions can handle non-deterministic content while providing clear failure context: use...

Testing Typescript

Optimize Next.js Resource Utilization

vercel/next.js
5
133000

As a code reviewer, I recommend the following practices to optimize resource utilization when implementing Next.js ap...

Next.js Javascript

Release resources consistently

netty/netty
5
34227

Always ensure resources are properly released, especially in exception paths. Use try-finally blocks to guarantee cle...

Error Handling Java

Use descriptive identifiers

neondatabase/neon
5
19015

Choose clear, meaningful names for variables, parameters, and constants that convey their purpose without requiring a...

Naming Conventions Python

Stage configuration changes gradually

neondatabase/neon
5
19015

When introducing configuration changes that affect multiple system components, implement them in stages to ensure smo...

Configurations Rust

Hierarchical semantic naming

neondatabase/neon
5
19015

Use hierarchical prefixes and clear descriptive names to indicate the domain, source, and purpose of code elements. T...

Naming Conventions Other

Flexible documented configurations

neondatabase/neon
5
19015

Create configuration interfaces that are flexible, well-documented, and future-proof. When designing configuration pa...

Configurations Other

Document concurrency design decisions

neondatabase/neon
5
19015

Always document key concurrency design decisions in code, including: 1. Locking protocols and ordering between multip...

Concurrency Rust

Design metrics for insights

neondatabase/neon
5
19015

Design metrics that provide actionable insights while maintaining system efficiency. Follow these key principles: 1....

Observability Rust

Comprehensive code documentation

neondatabase/neon
5
19015

Properly document code with clear, accurate, and useful comments using the correct syntax based on context: 1. Use `...

Documentation Rust

Use intent-revealing names

apache/mxnet
5
20801

Choose names that clearly reveal the purpose, behavior, or type of the code elements they represent. A good name shou...

Naming Conventions Other

Hybridization compatible operations

apache/mxnet
5
20801

When implementing neural network models that will be hybridized for performance optimization, use operations that are...

AI Python

Explain optimization mechanisms

apache/mxnet
5
20801

When implementing or documenting performance optimizations, clearly explain the mechanism and expected performance be...

Performance Optimization Markdown

Document all parameters

apache/mxnet
5
20801

Always provide complete and accurate documentation for all function parameters, especially when adding new ones. Each...

Documentation Other

Validate untrusted input

langchain-ai/langchainjs
5
15004

Always validate and sanitize user-provided inputs before using them in sensitive contexts like SQL queries, file path...

Security Typescript

Throw meaningful errors

langchain-ai/langchainjs
5
15004

Always throw specific, actionable errors instead of returning unexpected values or simply logging issues. Error messa...

Error Handling Typescript

Optimize model token usage

langchain-ai/langchainjs
5
15004

Implement token-efficient patterns when working with AI models to optimize costs and performance. Key practices inclu...

AI Typescript

Follow documentation standards

langchain-ai/langchainjs
5
15004

Ensure all documentation follows established templates and includes required sections. When referencing components, a...

Documentation Other

Use modern JavaScript idioms

kubeflow/kubeflow
5
15064

Favor modern JavaScript syntax and clean code practices to improve readability and maintainability. This includes: 1...

Code Style Javascript

Structured documentation with examples

kubeflow/kubeflow
5
15064

Create comprehensive documentation with clear structure and practical examples. Documentation should include: 1. **S...

Documentation Markdown

Standardize makefile patterns

kubeflow/kubeflow
5
15064

Maintain consistent Makefile patterns across all components to improve build reliability and developer experience in ...

CI/CD Other

Environment variable management

kubeflow/kubeflow
5
15064

Manage environment variables in Docker configurations with appropriate scope, placement, and documentation: 1. **Set...

Configurations Dockerfile

Centralize configuration values

kubeflow/kubeflow
5
15064

Store all configuration values in dedicated configuration files rather than hardcoding them throughout the applicatio...

Configurations Typescript

Consider operation time complexity

JetBrains/kotlin
5
50857

When implementing operations that manipulate collections or perform repeated actions, carefully consider the time com...

Algorithms Kotlin

Structured logging best practices

influxdata/influxdb
5
30268

Use structured logging with appropriate field types and context to make logs more useful for troubleshooting. Choose ...

Logging Go

Stable schema identifiers

influxdata/influxdb
5
30268

Use persistent identifiers for schema elements rather than relying on positional information or enumeration, which ca...

Database Rust

Prefer explicit nullability

influxdata/influxdb
5
30268

Always make nullable states explicit in your code by leveraging Rust's type system. Use `Option` rather than senti...

Null Handling Rust

Manage complete cache lifecycle

influxdata/influxdb
5
30268

Implement comprehensive cache lifecycle management focusing on three key aspects: 1. Idempotent Creation: Make cache...

Caching Rust

Maintain code readability

influxdata/influxdb
5
30268

Ensure code remains readable and maintainable by following these practices: 1. **Combine case statements with identi...

Code Style Go

Handle errors by criticality

influxdata/influxdb
5
30268

Choose error handling strategies based on operation criticality: 1. For critical operations that could corrupt data ...

Error Handling Rust

Descriptive semantic naming

influxdata/influxdb
5
30268

Create identifiers that clearly convey meaning through descriptive names and appropriate types. Two key practices imp...

Naming Conventions Rust

Clear configuration parameters

influxdata/influxdb
5
30268

Configuration parameters should be descriptively named, well documented, and have sensible defaults that are visible ...

Configurations Rust

Transactional verified migrations

elie222/inbox-zero
5
8267

Enhance database migration reliability by wrapping changes in transactions with pre-check and post-verification steps...

Migrations Sql

Time precision matters

elie222/inbox-zero
5
8267

When implementing algorithms involving date and time calculations, maintain precise control over time components to a...

Algorithms Typescript

Prevent async race conditions

elie222/inbox-zero
5
8267

Always guard against race conditions when working with asynchronous code. Implement these patterns to avoid unpredict...

Concurrency TSX

Names reflect semantic purpose

elie222/inbox-zero
5
8267

Choose names that reflect the semantic purpose rather than implementation details or temporal characteristics. Names ...

Naming Conventions Typescript

Standardize observability semantic conventions

grafana/grafana
5
68825

When implementing observability features (logs, metrics, traces), use consistent semantic conventions to ensure data ...

Observability Go

Proper shell quoting

grafana/grafana
5
68825

Always use proper quoting in shell scripts (especially GitHub Actions workflows) to prevent word splitting, globbing,...

Code Style Yaml

Function design principles

grafana/grafana
5
68825

Design functions for maximum reusability, clarity, and maintainability. Follow these principles: 1. **Pass complete ...

Code Style Typescript

Close resources with errors

grafana/grafana
5
68825

Always close resources (files, streams, connections) and properly handle their Close() errors. For read operations, C...

Error Handling Go

Use if-unwrap with optionals

ghostty-org/ghostty
5
32864

Always use Zig's if-unwrap pattern (`if (optional) |value| {...}`) when working with optional values instead of force...

Null Handling Other

Handle errors completely

fatedier/frp
5
95938

Always handle errors comprehensively by checking return values, implementing proper error propagation, and ensuring r...

Error Handling Go

Connection lifecycle management

fatedier/frp
5
95938

Implement comprehensive lifecycle management for network connections. Ensure proper initialization, authentication, m...

Networking Go

Manage dependencies wisely

laravel/framework
5
33763

When configuring dependencies in composer.json files, follow these guidelines to ensure maintainable and reliable con...

Configurations Json

Escape column names properly

laravel/framework
5
33763

Always use the appropriate wrapping/escaping mechanism when generating SQL to prevent syntax errors and SQL injection...

Database PHP

Design flexible APIs

laravel/framework
5
33763

When designing APIs, prioritize flexibility and developer experience by: 1. **Accept broader parameter types** - Use...

API PHP

Type-safe API designs

fastify/fastify
5
34000

Design APIs with strong type safety to improve developer experience and catch errors at compile time. Avoid using any...

API Typescript

Properly Handle Errors in Fastify Applications

fastify/fastify
5
34000

When implementing error handling in Fastify applications, it is important to always throw instances of the Error clas...

Fastify Typescript

Preserve error context

fastify/fastify
5
34000

When handling errors, always ensure the original error context is preserved and properly surfaced. Error information ...

Error Handling Javascript

Null safe patterns

fastify/fastify
5
34000

Use concise null checking patterns to prevent runtime errors and improve code readability when handling potentially u...

Null Handling Javascript

Explicit Configuration Usage in Fastify

fastify/fastify
5
34000

When using the Fastify framework in Typescript, ensure that all configuration options are explicitly declared and pro...

Fastify Typescript

Consistent JSDoc standards

fastify/fastify
5
34000

Document all public APIs and significant internal functions with comprehensive JSDoc comments that include accurate d...

Documentation Javascript

Adhere to Fastify Coding Conventions

fastify/fastify
5
34000

When implementing code that uses the Fastify package in Typescript, ensure the following conventions are followed: av...

Fastify Typescript

Protocol-specific error handling

fastapi/fastapi
5
86871

Handle errors and responses appropriately based on the network protocol being used. Different protocols have differen...

Networking Markdown

Consistent code examples

fastapi/fastapi
5
86871

Maintain consistent formatting and styling in code examples throughout your NestJS application documentation. This en...

NestJS Markdown

REST principles first

expressjs/express
5
67300

When designing APIs with Express, prioritize proper REST principles and HTTP semantics over convenience. This ensures...

API Javascript

Propagate errors properly

expressjs/express
5
67300

Always forward errors to the framework's error handling pipeline instead of swallowing them or handling them inconsis...

Error Handling Javascript

Handle streams properly

expressjs/express
5
67300

When transferring data over HTTP, properly implement streaming mechanisms to prevent memory exhaustion and potential ...

Networking Javascript

Ensure test completion

expressjs/express
5
67300

Tests must properly terminate by following appropriate asynchronous patterns. For asynchronous tests, always invoke t...

Testing Javascript

Prevent redundant operations

elastic/elasticsearch
5
73104

In distributed database systems, prevent redundant operations that can overload cluster resources. When implementing ...

Database Java

User-friendly documentation examples

deeplearning4j/deeplearning4j
5
14036

Documentation should guide users toward best practices through clear examples. Begin with positive patterns before co...

Documentation Markdown

Use logging best practices

deeplearning4j/deeplearning4j
5
14036

Adopt these logging best practices to ensure consistent, efficient, and meaningful logs: 1. **Use Lombok's `@Slf4j` ...

Logging Java

Numerical stability practices

deeplearning4j/deeplearning4j
5
14036

When implementing machine learning algorithms, ensure numerical correctness and stability by following these practice...

AI Java

Descriptive error context

deeplearning4j/deeplearning4j
5
14036

Error messages should be specific, descriptive, and include context to help with debugging. Avoid generic messages li...

Error Handling C++

Model-agnostic AI code

crewaiinc/crewai
5
33945

When building applications that interact with AI models, avoid hardcoding model-specific behavior and instead design ...

AI Python

Maintain consistent code style

vuejs/core
5
50769

Follow project-wide code style conventions to ensure consistency and readability. Key practices include: 1. Use cons...

Code Style Typescript

Explicit nullish checks

vuejs/core
5
50769

When checking for the absence of values, use explicit nullish checks rather than relying on JavaScript's falsy behavi...

Null Handling Typescript

Secure credential management

chef/chef
5
7860

When handling passwords, certificates, or keys in your code, implement secure encryption and storage mechanisms to pr...

Security Ruby

Prefer guard clauses

chef/chef
5
7860

Use guard clauses with early returns for null checking instead of wrapping code in conditional blocks. This improves ...

Null Handling Ruby

Explicit configuration over implicit

chef/chef
5
7860

Always define explicit configuration defaults rather than relying on implicit behavior or autovivification. Configura...

Configurations Ruby

Use appropriate logging levels

bridgecrewio/checkov
5
7668

Select the correct logging level based on the importance and visibility requirements of the information. Choose WARNI...

Logging Python

Thorough test assertions

bridgecrewio/checkov
5
7667

Ensure tests thoroughly validate functionality through comprehensive assertions. When writing tests: 1. Assert all r...

Testing Python

Strategic exception management

bridgecrewio/checkov
5
7668

Choose the appropriate error handling strategy based on the context and severity of potential failures. Use exception...

Error Handling Python

Strategic error handling

bridgecrewio/checkov
5
7667

Choose appropriate error handling strategies based on the nature of the error and recovery potential: 1. **Raise exc...

Error Handling Python

Document configuration options

bridgecrewio/checkov
5
7668

Always provide comprehensive documentation for all configuration options, including environment variables, feature fl...

Configurations Markdown

Choose optimal data structures

bridgecrewio/checkov
5
7668

Select the most appropriate data structure based on the specific operations your algorithm needs to perform. This cho...

Algorithms Python

Write clear examples

boto/boto3
5
9417

Create comprehensive code examples in documentation that demonstrate common operations and use proper formatting. Use...

Documentation Other

Consistent method interfaces

boto/boto3
5
9417

Design APIs with consistent method interfaces across related resources to improve usability and reduce learning curve...

API Python

Configure proxies with schemes

boto/boto3
5
9417

When configuring proxies in AWS SDK clients, always include the complete URL scheme in proxy definitions. Match the s...

Networking Other

Specific exceptions for clarity

Azure/azure-sdk-for-net
5
5809

Use specific exception types with meaningful error messages rather than generic exceptions to improve error handling,...

Error Handling C#

Preserve API compatibility

Azure/azure-sdk-for-net
5
5809

When evolving APIs, maintain backward compatibility to prevent breaking changes for existing consumers. Key approac...

API C#

Maintain clean code structure

Azure/azure-sdk-for-net
5
5809

Keep code clean and well-organized by: 1. Removing unnecessary elements: - Delete commented-out code that is no lo...

Code Style C#

Centralize configuration values

Azure/azure-sdk-for-net
5
5809

Configuration values should be defined once and referenced throughout your project to ensure consistency and simplify...

Configurations Other

Prefer descriptive over brief

tokio-rs/axum
5
22100

Choose clear, descriptive names over abbreviated or shortened versions. Names should be self-documenting and follow R...

Naming Conventions Rust

Documentation consistency standards

tokio-rs/axum
5
22100

Maintain consistent documentation formatting standards across all project files, especially in changelogs, code examp...

Documentation Markdown

Consistent axum Usage in Typescript

tokio-rs/axum
5
22100

When implementing Typescript code that uses the axum package, maintain consistent and idiomatic usage: always use low...

Axum Typescript

Type-safe API interfaces design

axios/axios
5
107000

Design API interfaces with strong type safety while maintaining excellent developer experience. Prefer explicit types...

API Typescript

Standardize null value checks

axios/axios
5
107000

Always use consistent patterns and utility functions for handling null and undefined values. This improves code relia...

Null Handling Javascript

Specific test assertions

axios/axios
5
107000

When writing tests, explicitly assert specific conditions and expected values rather than relying on general success/...

Testing Javascript

Proxy protocol handling

axios/axios
5
107000

When implementing HTTP clients with proxy support, ensure the connection to the proxy uses the protocol specified in ...

Networking Javascript

Documentation reflects reality

axios/axios
5
107000

Always ensure documentation accurately represents the actual code behavior and implementation details. Include import...

Documentation Markdown

Consistent method behaviors

axios/axios
5
107000

Design API methods with predictable behavior patterns that follow common conventions. Methods that modify objects dir...

API Javascript

Complete error handling chain

axios/axios
5
107000

Implement comprehensive error handling throughout the codebase by ensuring all error scenarios are properly caught, t...

Error Handling Javascript

Structured test resource management

aws/aws-sdk-js
5
7628

Organize tests with proper resource lifecycle management to ensure reliability and maintainability. Create test resou...

Testing Javascript

Content integrity verification

aws/aws-sdk-js
5
7628

When handling HTTP responses, especially with streaming data, properly verify content integrity and length to prevent...

Networking Javascript

Validate nulls explicitly

apache/airflow
5
40858

Always check for null values before using them, and use Python's idiomatic patterns to make these checks concise and ...

Null Handling Python

Use system configuration defaults

apache/airflow
5
40858

Always use the configuration system's default values instead of hardcoding defaults in the code. This ensures consist...

Configurations Python

Maintain code consistency

apache/airflow
5
40858

Ensure consistency throughout the codebase by following established patterns for both UI components and code structur...

Code Style TSX

Internationalize ui text

apache/airflow
5
40858

All user interface text must be internationalized using the appropriate i18n module instead of hardcoded strings. Thi...

Documentation TSX

Handle exceptions with specificity

apache/airflow
5
40858

Use specific exception types and avoid masking errors through overly broad exception handling or default values. This...

Error Handling Python

Documentation best practices

apache/airflow
5
40858

Documentation should follow established best practices to ensure clarity, consistency, and usefulness: 1. **Use prop...

Documentation Other

Verify properties before logging

vercel/ai
5
15590

When logging object properties, always verify that the property names exactly match the actual structure of the objec...

Logging Typescript

Maintain API naming consistency

vercel/ai
5
15590

When working with AI model interfaces and result objects, ensure consistent property naming across related components...

AI Typescript

Document API schemas

vercel/ai
5
15590

Add comprehensive JSDoc comments to all API interfaces, types, and schema definitions. This documentation should: 1....

Documentation Typescript

Consistent provider options

vercel/ai
5
15590

When designing APIs that support multiple providers or service integrations, implement consistent patterns for handli...

API Typescript

Protect render loop performance

zed-industries/zed
4
62119

Ensure render loop operations stay within frame time budget (typically 16.67ms for 60fps). Avoid expensive computatio...

Performance Optimization Rust

Contextualize don't panic

zed-industries/zed
4
62119

Always provide meaningful context for errors and avoid code that can panic in production. Use `.context()` or `.with_...

Error Handling Rust

Background process blocking operations

zed-industries/zed
4
62119

Always move potentially blocking operations to background threads to maintain UI responsiveness. Use appropriate spaw...

Concurrency Rust

Document AI model capabilities

vllm-project/vllm
4
51730

Provide clear, comprehensive documentation for AI model capabilities, especially for multimodal features and deployme...

AI Markdown

Use parameterized queries

vitessio/vitess
4
19815

Always use parameterized queries with bind variables instead of string concatenation or formatting when constructing ...

Database Go

Standardize error wrapping patterns

vitessio/vitess
4
19815

Use consistent error wrapping patterns to preserve error context and ensure proper error code propagation. Always: 1....

Error Handling Go

Metric design best practices

vitessio/vitess
4
19815

Design metrics to be reliable and maintainable by following these key principles: 1. Initialize metrics with zero va...

Observability Go

Log levels and clarity

vitessio/vitess
4
19815

Choose appropriate log levels and write clear, meaningful log messages that provide necessary context without creatin...

Logging Go

Explicit nil handling

vitessio/vitess
4
19815

Always handle nil values explicitly in your code to improve clarity and prevent subtle bugs. When a function needs to...

Null Handling Go

Environment-portable configuration management

vitessio/vitess
4
19815

Ensure all configurations are environment-portable and follow current best practices for the target platforms. This i...

Configurations Other

Use optional patterns

vitejs/vite
4
74031

Choose the most appropriate pattern for handling potentially undefined or null values. When designing types, prefer o...

Null Handling Typescript

Optimize glob operations

vitejs/vite
4
74031

When using glob patterns for file system operations, ensure optimal performance and consistent behavior by configurin...

Algorithms Typescript

Minimize memory allocations

vitejs/vite
4
74031

Choose methods and patterns that reduce unnecessary memory allocations and object creation to improve performance. Wh...

Performance Optimization Typescript

Manage configuration inheritance carefully

vitejs/vite
4
74031

When designing configuration systems, establish clear default values and inheritance patterns. Follow these principle...

Configurations Typescript

Leverage native tooling

vitejs/vite
4
74031

Prioritize native or Rust-based implementations of build tools over their JavaScript counterparts to significantly im...

Performance Optimization Markdown

Evolve APIs with compatibility

vitejs/vite
4
74031

When evolving APIs, maintain backwards compatibility while introducing new features by following a staged deprecation...

API Typescript

Document code purposefully

vitejs/vite
4
74031

High-quality code documentation improves maintainability and helps other developers understand your intentions. Follo...

Documentation Typescript

Clean configuration organization

vitejs/vite
4
74031

Organize configuration settings logically and avoid redundancy in project configuration files. Group related options ...

Configurations Json

Break down complex functions

vitejs/vite
4
74031

Improve code readability and maintainability by decomposing large, complex functions into smaller, focused ones. When...

Code Style Typescript

Use direct documentation style

astral-sh/uv
4
60322

Write documentation using direct, clear language that addresses the reader directly. Follow these style guidelines: ...

Documentation Markdown

Respect connectivity state

astral-sh/uv
4
60322

Applications should gracefully handle different network connectivity states and provide appropriate feedback to users...

Networking Rust

Consistent authentication patterns

astral-sh/uv
4
60322

Design API authentication mechanisms with consistent patterns, clear documentation, and helpful error messages. When ...

API Markdown

Balance test performance considerations

astral-sh/uv
4
60322

When writing tests, consider both thoroughness and execution time. For operations with significant overhead (like Pyt...

Testing Rust

React rendering safeguards

shadcn-ui/ui
4
90568

This standard ensures your React components render correctly and efficiently, preventing common pitfalls that cause e...

React TSX

Keep build tooling updated

vercel/turborepo
4
28115

Maintain up-to-date build and CI/CD tooling to leverage the latest features, performance improvements, and security p...

CI/CD Json

Define API boundaries

vercel/turborepo
4
28115

Clearly specify what constitutes your public API contract to manage versioning expectations and documentation require...

API Other

Configuration precision matters

vercel/turborepo
4
28115

Ensure configuration files are precise and stable to prevent unexpected build failures and runtime issues. This inclu...

Configurations Json

Choose logging levels wisely

vercel/turborepo
4
28115

Select appropriate logging levels based on the frequency and importance of the logged operation. Use `trace` for high...

Logging Rust

Boundary case handling

vercel/turborepo
4
28115

Always handle boundary conditions explicitly in algorithms to prevent unexpected behavior. When implementing algorith...

Algorithms Rust

Secure unsafe code

tokio-rs/tokio
4
28989

When working with unsafe code, follow these practices to minimize security vulnerabilities: 1. **Minimize scope**: L...

Security Rust

Optimize algorithmic efficiency

tokio-rs/tokio
4
28981

Pay careful attention to operations inside loops and recursive functions to avoid unexpected algorithmic complexity. ...

Algorithms Rust

Memory ordering needs justification

tokio-rs/tokio
4
28981

When using atomic operations, explicitly justify the choice of memory ordering. Each use of a memory ordering should ...

Concurrency Rust

Granular feature flags

tokio-rs/tokio
4
28981

Feature flags should be designed with granularity to ensure dependencies are only required when absolutely necessary....

Configurations Toml

Document null safety assumptions

tokio-rs/tokio
4
28981

When writing code that handles potentially null, undefined, or uninitialized values, always document safety assumptio...

Null Handling Rust

Code block formatting standards

tokio-rs/tokio
4
28981

When documenting code examples and shell commands in project documentation, follow these formatting standards to ensu...

Documentation Markdown

Prefer explicit API design

huggingface/tokenizers
4
9868

When designing APIs, favor simple and explicit interfaces over flexible but complex ones. This reduces cognitive load...

API Rust

Choose semantically clear identifiers

huggingface/tokenizers
4
9868

Select parameter and method names that accurately describe their purpose and behavior, avoiding ambiguous terms that ...

Naming Conventions Rust

Choose optimal data structures

huggingface/tokenizers
4
9868

Select data structures based on their algorithmic complexity and usage patterns. Consider the tradeoffs between diffe...

Algorithms Rust

Resource cleanup on errors

hashicorp/terraform
4
45532

Always ensure proper resource cleanup in error paths to prevent leaks. Use defer functions with explicit error checki...

Error Handling Go

Guard shared state

hashicorp/terraform
4
45532

Consistently protect shared state with appropriate synchronization mechanisms and ensure proper cleanup to prevent ra...

Concurrency Go

Explicit protocol interfaces

hashicorp/terraform
4
45532

Design protocol interfaces with explicit behavior definitions rather than relying on implicit conventions. Clearly sp...

API Other

Ensure test isolation

hashicorp/terraform
4
45532

Tests should be completely isolated from each other and clean up after themselves to prevent interference. 1. **Use...

Testing Go

Consistent documentation formatting

hashicorp/terraform
4
45532

Maintain consistent style in documentation files to improve readability and professionalism. Specifically: 1. **Comm...

Code Style Other

Configuration override precedence

hashicorp/terraform
4
45532

When designing systems with configurations that can be specified at multiple levels (global vs local, environment vs ...

Configurations Go

Clarify test documentation

hashicorp/terraform
4
45532

Ensure all testing-related documentation is clear, accurate, and user-focused. Use precise terminology when describin...

Testing Other

Choose appropriate API types

hashicorp/terraform
4
45532

Select the simplest data types that satisfy requirements when designing API signatures. Avoid using complex types (li...

API Go

Tensor-aware control flow

tensorflow/tensorflow
4
190625

When working with TensorFlow tensors, avoid using Python comparison operators (`<`, `>=`, `==`) or conditional checks...

AI Python

Complete docstring structure

tensorflow/tensorflow
4
190625

Function documentation should follow a consistent structure that includes all necessary components to be complete and...

Documentation Python

Centralize configuration settings

tensorflow/tensorflow
4
190625

Place configuration settings in centralized, appropriate locations rather than duplicating them across multiple files...

Configurations Other

Mathematical precision matters

tensorflow/swift
4
6136

When implementing mathematical algorithms, ensure precise terminology and correct implementation of mathematical conc...

Algorithms Markdown

Document environment variables

tensorflow/swift
4
6136

When using configurable components, clearly document all relevant environment variables and their effects. Include ex...

Configurations Other

Use environment-independent defaults

spring-projects/spring-framework
4
58382

When designing configuration options, avoid relying on environment-specific defaults such as system character encodin...

Configurations Java

Spring annotation best practices

spring-projects/spring-framework
4
58382

When working with Spring annotations, follow these guidelines to avoid common issues: 1. **Use interface types for d...

Spring Other

Minimize lock contention

spring-projects/spring-framework
4
58382

When implementing thread-safe code, minimize the scope and duration of locks to reduce contention and improve perform...

Concurrency Java

Consistent style conventions

spring-projects/spring-framework
4
58382

Apply consistent formatting and organization conventions throughout the codebase to enhance readability and maintaina...

Code Style Other

Explicit security documentation

spring-projects/spring-boot
4
77637

Always provide explicit and accurate documentation for security-related configurations, including: 1. Use proper con...

Security Other

Structure configuration options

dotnet/runtime
4
16578

Design and document configuration options (feature flags, environment variables, conditional compilation) to be clear...

Configurations C++

Maintain consistent formatting

dotnet/runtime
4
16578

Ensure consistent formatting and organization throughout the codebase to improve readability and maintainability. Thi...

Code Style Other

Decompose complex algorithms

dotnet/runtime
4
16578

When implementing algorithms, break down complex methods that handle multiple concerns into smaller, more focused met...

Algorithms C

Choose appropriate error mechanisms

dotnet/runtime
4
16578

Use the right error handling mechanism for each scenario: exceptions for recoverable situations, assertions only for ...

Error Handling C++

Support configuration extension patterns

astral-sh/ruff
4
40619

When designing configuration systems, provide both replacement and extension options for list-based settings to give ...

Configurations Rust

Maintain focused module structure

astral-sh/ruff
4
40619

Keep modules focused and well-organized by grouping related functionality together and splitting large files into log...

Code Style Rust

Leverage existing API utilities

astral-sh/ruff
4
40619

When implementing or consuming APIs, always prefer using existing utility methods and abstractions over manual implem...

API Rust

Optimize hot paths

facebook/react
4
237000

In performance-critical code paths that execute frequently, optimize to reduce unnecessary operations that can impact...

Performance Optimization Javascript

Balance constraints with flexibility

facebook/react
4
237000

When designing APIs, carefully evaluate constraints imposed on consumers. Each limitation should serve a clear purpos...

API Javascript

Understand query method behavior

rails/rails
4
57027

When working with database queries in Active Record, it's essential to understand the precise behavior of query metho...

Database Markdown

Optimize cache headers

rails/rails
4
57027

Use appropriate HTTP cache headers based on content mutability. For immutable assets (like digest-stamped files), app...

Caching Other

Human-readable configuration values

rails/rails
4
57027

When writing configuration files, prioritize human readability and maintainability by using descriptive expressions i...

Configurations Other

Efficient data processing

rails/rails
4
57027

When implementing algorithms that process large data streams or collections, use a chunking approach rather than proc...

Algorithms Ruby

Contextual error messages

rails/rails
4
57027

Error messages should provide sufficient context to understand and debug the problem efficiently. Include both the ex...

Error Handling Ruby

Content security policy configuration

rails/rails
4
57027

Implement Content Security Policy (CSP) configurations appropriately for your application's context. Use report-only ...

Security Ruby

Validate database connections explicitly

quarkusio/quarkus
4
14667

Always implement explicit database connection validation strategies to ensure robust application behavior during star...

Database Java

Secure authentication defaults

quarkusio/quarkus
4
14667

Configure authentication mechanisms with secure default settings to prevent security vulnerabilities. When implementi...

Security Java

Documentation style consistency

quarkusio/quarkus
4
14667

Maintain consistent documentation style to improve readability and user experience: 1. **Use precise terminology**: ...

Documentation Other

Avoid wildcard imports

quarkusio/quarkus
4
14667

Wildcard (star) imports like `import java.util.*;` are prohibited in the codebase as they reduce code readability and...

Code Style Java

Avoid unnecessary allocations

quarkusio/quarkus
4
14667

Minimize object creation and memory allocations, especially in frequently called methods and hot code paths, to reduc...

Performance Optimization Java

Automate style enforcement

quarkusio/quarkus
4
14667

Implement automated code style enforcement using complementary tools rather than relying on manual reviews. Configure...

Code Style Xml

Optimize memory usage

pytorch/pytorch
4
91345

Limit memory consumption in performance-critical paths by conditionally creating large data structures or deferring a...

Performance Optimization C++

Normalize configuration parameters

pytorch/pytorch
4
91345

Always normalize configuration inputs (especially environment variables) by removing whitespace and applying consiste...

Configurations Python

Eliminate redundant operations

pytorch/pytorch
4
91345

Avoid unnecessary operations that can impact performance. This includes: 1. Redundant data transformations: - Loa...

Performance Optimization Python

Design for compatibility

pytorch/pytorch
4
91345

When evolving APIs, prioritize backward compatibility to minimize disruption for existing users. Add new functionalit...

API C++

Choose appropriate exceptions

pytorch/pytorch
4
91345

Select the proper exception type based on the error scenario to provide clearer error handling and better debugging e...

Error Handling C++

Write targeted, specific tests

pydantic/pydantic
4
24377

Tests should validate specific, well-defined behaviors with clear assertions that directly relate to what's being tes...

Testing Python

Simple defaults, flexible overrides

pydantic/pydantic
4
24377

Design APIs with intuitive defaults for common use cases while providing specialized options for edge cases. This app...

API Python

Semantic over syntactic

pydantic/pydantic
4
24377

Choose names that clearly communicate the purpose and behavior of your code elements, focusing on semantic meaning ra...

Naming Conventions Python

Safe attribute access pattern

pydantic/pydantic
4
24377

Always use safe attribute access patterns to handle potentially null or undefined attributes. Instead of direct attri...

Null Handling Python

Document configuration relationships

pydantic/pydantic
4
24377

When designing configuration options that interact with each other, clearly document these relationships and consider...

Configurations Python

Consistent configuration patterns

pydantic/pydantic
4
24377

When working with configurations in Pydantic models, maintain consistency by using `ConfigDict()` instead of plain di...

Configurations Markdown

Balance documentation thoroughness

pydantic/pydantic
4
24377

Documentation should balance completeness with avoiding redundancy. When documenting complex features: 1. Centralize...

Documentation Markdown

Service layer abstraction

prowler-cloud/prowler
4
11834

Separate business logic and external service interactions from API views by using dedicated service layers. This impr...

API Python

Parameterize security commands

prowler-cloud/prowler
4
11834

When writing security-related CLI commands or remediation steps, always use standardized parameter placeholders (e.g....

Security Json

Memory usage optimization

prowler-cloud/prowler
4
11834

Optimize memory usage in high-performance applications by implementing explicit memory management techniques. This in...

Performance Optimization Python

Maintain component consistency

prowler-cloud/prowler
4
11834

Use a consistent approach when working with components to improve code maintainability and ensure visual coherence th...

Code Style TSX

Ensure migration compatibility

prowler-cloud/prowler
4
11834

When modifying database schemas through migrations, ensure compatibility with existing data. For new required fields,...

Migrations Python

Document configuration variables

prowler-cloud/prowler
4
11834

Always provide complete documentation for configuration variables, including their exact format, purpose, and behavio...

Configurations Markdown

Document authentication requirements

prowler-cloud/prowler
4
11834

When creating or modifying APIs, always provide comprehensive documentation for authentication methods and prerequisi...

API Markdown

Prevent deadlock conditions

pola-rs/polars
4
34296

Carefully manage resource acquisition and release to prevent deadlocks in concurrent code. Deadlocks typically occur ...

Concurrency Rust

Prevent cryptic errors

pola-rs/polars
4
34296

Always implement proper validation and type checking to prevent cryptic error messages. When errors do occur, provide...

Error Handling Python

Organize tests efficiently

pola-rs/polars
4
34296

Write maintainable, well-structured tests that are easy to understand and extend. Tests should remain simple and focu...

Testing Python

Optimize data transformations

pola-rs/polars
4
34296

When implementing data processing operations, avoid unnecessary data transformations, copies, and conversions that ca...

Database Rust

Design for operation flexibility

pola-rs/polars
4
34296

When implementing algorithms that operate on data structures (particularly arrays, lists, or collections), design the...

Algorithms Python

Defer expensive operations

pola-rs/polars
4
34296

Avoid triggering expensive computations prematurely in your code. Operations like `collect()`, intensive IO operation...

Performance Optimization Python

Choose appropriate abstractions

pola-rs/polars
4
34296

When designing APIs, select data types and patterns that match how they will be consumed while facilitating long-term...

API Rust

Proper span lifecycle

opentofu/opentofu
4
25901

Always ensure trace spans are properly closed in all code execution paths to prevent trace leaks that can distort obs...

Observability Go

Prevent backing array surprises

opentofu/opentofu
4
25901

When modifying slices in Go, be aware that appending to a slice with available capacity will modify the backing array...

Algorithms Go

Minimize API surface

opentofu/opentofu
4
25901

Design APIs with minimal exposed surface by encapsulating implementation details within packages. When designing APIs...

API Go

Write reliable test cases

open-telemetry/opentelemetry-python
4
2061

Create deterministic and reliable test cases by following these guidelines: 1. Use hardcoded values instead of rando...

Testing Python

Return collections not None

open-telemetry/opentelemetry-python
4
2061

Return empty collections (lists, dicts, sets) instead of None when representing empty states. This reduces null check...

Null Handling Python

Prevent recursive logging calls

open-telemetry/opentelemetry-python
4
2061

Avoid implementing logging calls that could trigger recursive logging patterns, which can lead to infinite loops and ...

Logging Python

Precise configuration specifications

open-telemetry/opentelemetry-python
4
2061

Ensure configuration files use tool-specific syntax and conventions while leveraging appropriate defaults. Be intenti...

Configurations Toml

Place attributes correctly

open-telemetry/opentelemetry-python
4
2061

When implementing observability with OpenTelemetry, place attributes at the appropriate level in the telemetry hierar...

Observability Markdown
4
2061

Always use exact version pinning (==) for dependencies in requirements files rather than version ranges. This ensures...

Configurations Txt

Choose data structures wisely

open-telemetry/opentelemetry-python
4
2061

Select data structures based on your specific access patterns and performance requirements. Using the right data stru...

Algorithms Python

Optimize for common cases

opencv/opencv
4
82865

When implementing algorithms, create specialized versions for common cases to improve performance, while maintaining ...

Algorithms Other

Framework synchronization practices

opencv/opencv
4
82865

When implementing concurrent code, always use the framework's provided synchronization primitives rather than direct ...

Concurrency C++

Document properly with references

opencv/opencv
4
82865

Always separate code from documentation and use proper referencing techniques. Documentation should be in markdown fi...

Documentation Other

Reuse buffers strategically

ollama/ollama
4
145704

For frequently called methods or hot code paths, reuse allocations instead of creating new buffers on each call. This...

Performance Optimization Go

Platform-aware configuration documentation

ollama/ollama
4
145705

Always document platform-specific configuration differences and requirements thoroughly. When writing documentation o...

Configurations Markdown

Loose API coupling

ollama/ollama
4
145704

Maintain a clear separation between API definitions and their implementations by avoiding direct passing of API struc...

API Go

Use async/await pattern

octokit/octokit.net
4
2793

When designing or documenting API clients, always use the async/await pattern rather than blocking calls. Replace cod...

API Markdown

Catch specific exceptions

octokit/octokit.net
4
2793

Always catch specific exception types rather than using general catch blocks. This improves error handling precision,...

Error Handling C#

Verify documentation references

vercel/next.js
4
133000

When writing or updating documentation, ensure all code examples, installation commands, and project references accur...

Documentation Markdown

Proper Use of Suspense in Next.js Components

vercel/next.js
4
133000

When building Next.js applications that leverage server-side rendering (SSR) or Partial Prerendering (PPR), it is ess...

Next.js Javascript

Proper Error Handling in Next.js API Routes

vercel/next.js
4
133000

This review focuses on ensuring proper error handling in Next.js API routes. Key principles include validating incomi...

Next.js Javascript

Maintain Consistent Naming Conventions in Next.js Code

vercel/next.js
4
133000

As a code reviewer for Next.js projects, ensure that all code artifacts, including component names, file names, and c...

Next.js Javascript

Protect network buffer lifecycle

netty/netty
4
34227

When handling network buffers in protocol implementations, ensure proper lifecycle management to prevent memory leaks...

Networking Java

Preserve backward compatibility

netty/netty
4
34227

When evolving APIs in minor versions, always maintain backward compatibility to avoid breaking client code. Follow th...

API Java

Optimize search operations

netty/netty
4
34227

Enhance search algorithm performance by prioritizing common cases, using appropriate data structures, and avoiding un...

Algorithms Java

Configurable over hardcoded

netty/netty
4
34227

Make configuration parameters configurable rather than hardcoding values, especially for limits, sizes, and threshold...

Configurations Java

Scope JWT authentication tokens

neondatabase/neon
4
19015

Always include tenant, timeline, and endpoint identifiers in JWT tokens used for service authentication. This ensures...

Security Markdown

Proper Option type usage

neondatabase/neon
4
19015

Use Option only for truly optional values that can meaningfully be None. Avoid using Option when a value is always...

Null Handling Rust

Proactive cache warming

neondatabase/neon
4
19015

Implement proactive cache warming strategies to minimize performance degradation after system restarts or during cold...

Performance Optimization Markdown

Pin GitHub action versions

neondatabase/neon
4
19015

Always pin GitHub Actions to specific commit hashes instead of using major/minor version tags (like @v4). This ensure...

CI/CD Yaml

Ensure algorithm robustness

neondatabase/neon
4
19015

When implementing algorithms, ensure they handle all edge cases correctly and robustly. Code should gracefully manage...

Algorithms Rust

Connection pooling with pipelining

neondatabase/neon
4
19015

Implement connection pooling with request pipelining for network services to optimize resource usage and improve thro...

Networking Rust

Graph traversal optimization

apache/mxnet
4
20801

When working with graph structures, avoid performing redundant depth-first search (DFS) traversals as each traversal ...

Algorithms Other

Explicit null checks

apache/mxnet
4
20801

Always use explicit null checks (`value is None` or `value is not None`) rather than implicit truthiness evaluations ...

Null Handling Python

Comprehensive API documentation

apache/mxnet
4
20801

Ensure all API elements are thoroughly documented following a consistent format. This includes: 1. **All function pa...

Documentation Python

Avoid redundant calculations

apache/mxnet
4
20801

Eliminate redundant calculations by identifying and caching frequently used values to improve performance. Consider t...

Performance Optimization Other

Use database-native types

langchain-ai/langchainjs
4
15004

Always leverage database-native data types and appropriate schema design to maximize performance and query capabiliti...

Database Typescript

Eliminate redundant code

langchain-ai/langchainjs
4
15004

Simplify code by eliminating redundancy and unnecessary complexity. This improves readability, reduces potential bugs...

Code Style Typescript

Dependency classification standards

langchain-ai/langchainjs
4
15004

Properly classify dependencies in package.json according to their usage pattern and project guidelines. This ensures ...

Configurations Json

Comprehensive AI documentation

langchain-ai/langchainjs
4
15004

When documenting AI integrations, provide comprehensive examples that showcase all common initialization and usage pa...

AI Other

Avoid hardcoded configurations

langchain-ai/langchainjs
4
15004

Always parameterize values that might vary across different environments or users instead of hardcoding them in your ...

Configurations Typescript

Standardize network tools

kubeflow/kubeflow
4
15064

When performing network operations in build scripts or containers, prefer `curl` over `wget` for HTTP requests to sta...

Networking Dockerfile

Prioritize readability over brevity

kubeflow/kubeflow
4
15064

When writing code, favor readability and maintainability over clever or compact solutions. Break down complex logic i...

Code Style Python

Pin version dependencies

kubeflow/kubeflow
4
15064

Explicitly pin version dependencies in configuration files to ensure reproducible builds and prevent breaking changes...

Configurations Other

Load configurations efficiently

kubeflow/kubeflow
4
15064

When designing components that require configuration, follow these practices to enhance performance, maintainability,...

Configurations Go

Follow API conventions

kubeflow/kubeflow
4
15064

When designing APIs, adhere to established API conventions, particularly Kubernetes API conventions when working with...

API Go

Externalize configuration parameters

kubeflow/kubeflow
4
15064

Create configurations that can be easily managed outside your application code. Design configuration parameters to be...

Configurations Markdown

Document code thoroughly

kubeflow/kubeflow
4
15064

Always include appropriate documentation in your code to improve readability, maintainability, and usability: 1. **D...

Documentation Go

Contextualize and classify errors

kubeflow/kubeflow
4
15064

Always provide meaningful context when handling errors, and classify them appropriately based on their source. This i...

Error Handling Go

Centralize configuration constants

kubeflow/kubeflow
4
15064

Store configuration constants, defaults, and environment variable mappings in dedicated configuration files rather th...

Configurations Python

Use defensive null checks

JetBrains/kotlin
4
50857

When working with properties or methods that could potentially be null, use Kotlin's null safety features defensively...

Null Handling Kotlin

Use structured logging fields

influxdata/influxdb
4
30268

Always use structured logging with descriptive field names rather than string interpolation. Include relevant context...

Logging Rust

Prevent nil dereferences

influxdata/influxdb
4
30268

Always verify that pointers, slices, or arrays are non-nil and have sufficient elements before attempting to access t...

Null Handling Go

Prefer configurable values

influxdata/influxdb
4
30268

Always use configurable values instead of hardcoded defaults when available. This ensures that user preferences are r...

Configurations Go

Performance-conscious metrics implementation

influxdata/influxdb
4
30268

Implement metrics collection that is both comprehensive and minimally impactful on system performance. Design your me...

Observability Rust

Include explanatory examples

influxdata/influxdb
4
30268

Always enhance documentation with concrete, illustrative examples that demonstrate expected inputs, formats, or outpu...

Documentation Rust

Avoid unnecessary work

influxdata/influxdb
4
30268

When optimizing performance-critical code paths, eliminate redundant operations and unnecessary processing: 1. **Exi...

Performance Optimization Go

Avoid flaky test patterns

influxdata/influxdb
4
30268

Write reliable tests by avoiding common patterns that can lead to flaky behavior. Specifically: 1. Avoid arbitrary t...

Testing Rust

Test all code paths

elie222/inbox-zero
4
8267

Write comprehensive tests that cover all code paths including edge cases, error conditions, and different parameter c...

Testing Typescript

Prevent workflow recursion

elie222/inbox-zero
4
8267

Control GitHub Actions workflow execution to avoid infinite loops and unnecessary builds. Implement these practices: ...

CI/CD Yaml

Normalize API responses

elie222/inbox-zero
4
8267

Design APIs to return consistent response structures across different data sources or providers. Normalize responses ...

API TSX

Handle AI operation failures

elie222/inbox-zero
4
8267

Always implement proper error handling for AI service operations. AI services can fail due to rate limiting, network ...

AI Typescript

Ensure API contract integrity

elie222/inbox-zero
4
8267

Maintain strict consistency between API implementation and contract by ensuring: 1. Request/response schemas match ex...

API Typescript

Define schema relations correctly

elie222/inbox-zero
4
8267

When designing database schemas, ensure relations and constraints are explicitly and correctly defined: 1. Every mod...

Database Prisma

Complete hook dependency arrays

elie222/inbox-zero
4
8267

Ensure all hooks (useEffect, useCallback, useMemo) explicitly list every dependency used within their callback functi...

React TSX

Cache invariant computations

elie222/inbox-zero
4
8267

Avoid repeatedly computing values that don't change frequently. For data structures, maps, or validation schemas used...

Performance Optimization Typescript

Safe property access patterns

grafana/grafana
4
68825

Use appropriate null/undefined handling techniques based on the context to prevent runtime errors. Be mindful of the ...

Null Handling TSX

Prefer null-safe access

grafana/grafana
4
68825

Always use null-safe access patterns when dealing with potentially undefined values to prevent runtime errors and imp...

Null Handling Typescript

Optimize performance patterns

grafana/grafana
4
68825

Choose efficient implementation patterns that improve performance. Apply these optimizations throughout your code: 1...

Performance Optimization Go

Name for purpose first

grafana/grafana
4
68825

Choose names that lead with their primary purpose or category, followed by specific details. This makes code more dis...

Naming Conventions Go

Minimize database joins

grafana/grafana
4
68825

Prefer direct filtering or specialized service methods over complex JOIN operations, especially when maintaining or r...

Database Go

Maintain configuration documentation accuracy

grafana/grafana
4
68825

Always ensure configuration documentation accurately reflects the current system capabilities, limitations, and featu...

Configurations Markdown

Judicious configuration management

grafana/grafana
4
68825

Carefully manage configuration options, including feature flags, to balance flexibility with maintainability: 1. **U...

Configurations Go

Fail-safe security defaults

grafana/grafana
4
68825

Always implement security features with fail-safe defaults that deny access or disable insecure functionality unless ...

Security Go

Consistent semantic naming

grafana/grafana
4
68825

Use consistent, specific, and semantically appropriate naming conventions throughout the codebase. When creating new ...

Naming Conventions Typescript

Consistent API versioning approach

grafana/grafana
4
68825

Adopt and document a consistent approach to API versioning across your services. The chosen format should be clearly ...

API Go

Component architecture principles

grafana/grafana
4
68825

Extract logic that doesn't render JSX into custom hooks instead of components. Components that don't return markup cr...

React TSX

Descriptive idiomatic identifiers

gin-gonic/gin
4
83022

Use descriptive names for variables, types, and interfaces that follow Go language idioms. Avoid single-letter variab...

Naming Conventions Go

Consistent error patterns

gin-gonic/gin
4
83022

Implement consistent error handling patterns throughout your codebase to improve readability and maintainability. **...

Error Handling Go

Structure user documentation

ghostty-org/ghostty
4
32864

When documenting complex features or configuration options, structure your documentation with these four key elements...

Documentation Other

Semantic name clarity

ghostty-org/ghostty
4
32864

Names should clearly and accurately reflect the purpose of variables, methods, and other identifiers. Follow these pr...

Naming Conventions Swift

Prevent unnecessary memory operations

ghostty-org/ghostty
4
32864

Avoid redundant memory allocations and copies when simpler alternatives exist. This includes: 1. Use in-place compar...

Performance Optimization Other

Optimize comparison patterns efficiently

ghostty-org/ghostty
4
32864

Choose efficient comparison patterns and algorithms based on the data type and use case. Key guidelines: 1. For stri...

Algorithms Other

In-tree build configurations

ghostty-org/ghostty
4
32864

Keep all build configuration files (Snapcraft, Flatpak manifests, etc.) in the repository alongside your code to ensu...

CI/CD Yaml

Validate with sensible defaults

fatedier/frp
4
95938

Implement a comprehensive configuration validation strategy that combines centralized validation functions with appro...

Configurations Go

Follow Go naming conventions

fatedier/frp
4
95938

Adhere to Go's standard naming conventions for identifiers: 1. **Control visibility with capitalization**: - Use ...

Naming Conventions Go

Optimize migration code

laravel/framework
4
33763

When writing database migration code, prioritize clarity and efficiency to ensure migrations are reliable and maintai...

Migrations PHP

Optimize loop operations

laravel/framework
4
33763

When writing loops, optimize for both readability and performance by following these key principles: 1. **Exit early...

Algorithms PHP

Disable coverage in workflows

laravel/framework
4
33763

Keep code coverage tools disabled in CI/CD workflows unless they're specifically needed for generating coverage repor...

Testing Yaml

Descriptive configuration keys

laravel/framework
4
33763

Configuration keys should clearly indicate their value type, units, or expected format to prevent misunderstandings a...

Configurations PHP

Proper Handling of Promises in Fastify Implementations

fastify/fastify
4
34000

When implementing Fastify applications in TypeScript, it is important to follow consistent patterns for handling prom...

Fastify Typescript

Content negotiation design

fastify/fastify
4
34000

When building APIs, implement proper content negotiation to handle various media types in both requests and responses...

API Javascript

Consistent descriptive naming

fastify/fastify
4
34000

Use precise, consistent, and descriptive naming conventions throughout your code to enhance readability and maintaina...

Naming Conventions Javascript

Benchmark before choosing methods

fastify/fastify
4
34000

Always benchmark different implementation approaches for performance-critical operations before selecting a method. D...

Performance Optimization Javascript

Use pytest fixtures effectively

fastapi/fastapi
4
86871

Tests should use pytest fixtures to improve organization, promote test isolation, and avoid code duplication. Fixture...

Testing Python

Use early returns

fastapi/fastapi
4
86871

Decrease indentation levels in your code by using early returns for edge cases and guard conditions. This approach im...

Code Style Python

Respect async execution order

fastapi/fastapi
4
86871

When working with asynchronous code, always be mindful of the execution order of operations, particularly with regard...

Concurrency Markdown

Proper HTTP status codes

fastapi/fastapi
4
86871

When implementing authentication and authorization systems, use semantically correct HTTP status codes to accurately ...

Security Python

Optimize hot paths

expressjs/express
4
67300

When writing code that will be executed frequently (hot paths), prioritize performance optimizations that reduce over...

Performance Optimization Javascript

Optimize dependency automation

expressjs/express
4
67300

Configure automated dependency update tools (like Dependabot) to balance security needs against developer cognitive l...

Configurations Yaml

Access settings properly

expressjs/express
4
67300

Always use the provided settings accessor methods (`app.get()`, `app.set()`, `app.enabled()`, `app.disabled()`) to ac...

Configurations Javascript

Parallel branch traceability

elastic/elasticsearch
4
73104

When implementing algorithms with parallel processing branches, ensure proper traceability and data consistency acros...

Algorithms Markdown

Exceptions for critical errors

elastic/elasticsearch
4
73104

Use exceptions rather than assertions for handling critical error conditions that need to be caught in production. As...

Error Handling Java

Defensive null handling

elastic/elasticsearch
4
73104

Always handle null references and values defensively to prevent NullPointerExceptions and unexpected behavior. Follow...

Null Handling Java

Configure type serialization

elastic/elasticsearch
4
73104

When working with databases that exchange data with other systems, ensure proper serialization and deserialization of...

Database Markdown

Clarity over uncertainty

elastic/elasticsearch
4
73104

Technical documentation should use precise language that clearly differentiates between product behavior and user con...

Documentation Markdown

Use modern API methods

deeplearning4j/deeplearning4j
4
14036

When implementing algorithms with numerical libraries like ND4J, always prefer the most direct and type-safe API meth...

Algorithms Markdown

Minimize object allocations

deeplearning4j/deeplearning4j
4
14036

Avoid creating unnecessary temporary objects or arrays which can impact performance through increased garbage collect...

Performance Optimization Java

Keep configurations current

deeplearning4j/deeplearning4j
4
14036

Ensure all configuration elements (dependencies, build settings, preprocessor flags) are up-to-date, documented, and ...

Configurations Other
4
14036

Detect and report errors as early as possible with detailed context to prevent silent failures and aid debugging. Val...

Error Handling Java

Document AI APIs completely

deeplearning4j/deeplearning4j
4
14036

When developing AI libraries and tools, provide comprehensive and accurate API documentation that helps users navigat...

AI Markdown

Cross-platform algorithm optimization

deeplearning4j/deeplearning4j
4
14036

When implementing algorithms that need to execute efficiently across different platforms, consider both compile-time ...

Algorithms Other

Configurable resource locations

deeplearning4j/deeplearning4j
4
14036

Always make file paths, temporary directories, and resource locations configurable with reasonable defaults instead o...

Configurations Java

Compare floating-point safely

deeplearning4j/deeplearning4j
4
14036

When implementing numerical algorithms, never compare floating-point values directly for equality due to precision er...

Algorithms Java

Default None not empty

crewaiinc/crewai
4
33945

Always use `None` as the default value for optional parameters and class attributes instead of empty collections (`[]...

Null Handling Python

Pause tracking during side-effects

vuejs/core
4
50769

When executing side-effects in reactive systems (like event handlers, cleanup functions, or async operations), always...

Concurrency Typescript

Optimize common search paths

vuejs/core
4
50769

Implement dedicated fast paths for common search patterns while maintaining a complete fallback path for edge cases. ...

Algorithms Typescript

Guarantee cleanup execution

vuejs/core
4
50769

When implementing features that require cleanup or state restoration, always use try-finally blocks to ensure cleanup...

Error Handling Typescript

Use strict test doubles

chef/chef
4
7860

Always use strict test doubles (instance_double, class_double) instead of basic doubles or OpenStruct in tests. Stric...

Testing Ruby

Standardize installation directory paths

chef/chef
4
7860

Maintain consistent and separate installation paths for different build types to prevent conflicts and improve system...

Configurations Other

Secure network operations

chef/chef
4
7860

When performing network operations, prioritize security and configurability to ensure robustness across different env...

Networking Ruby

Document configuration decisions

chef/chef
4
7860

Add clear comments explaining the rationale behind configuration decisions, especially for workarounds, compatibility...

Configurations Yaml

Document configuration completely

chef/chef
4
7860

Always provide complete documentation for configuration options, including defaults, override methods, and security i...

Configurations Markdown

Use pytest best practices

bridgecrewio/checkov
4
7668

Adopt modern pytest features to create maintainable, isolated, and comprehensive tests. This includes: 1. **Prefer p...

Testing Python

Preserve API compatibility

bridgecrewio/checkov
4
7668

When modifying existing APIs, function signatures, or return structures, always maintain backward compatibility to pr...

API Python

Precise configuration validation

bridgecrewio/checkov
4
7667

Ensure configuration validation logic accurately reflects security intentions and best practices. When writing valida...

Configurations Yaml

Structure for readability

boto/boto3
4
9417

Prioritize code readability by structuring code in a way that makes it easy to understand at a glance. This includes:...

Code Style Python

Isolate concurrent resources

boto/boto3
4
9417

Create separate instances of non-thread-safe resources for each thread or process in concurrent applications rather t...

Concurrency Other

Consistent region configuration

boto/boto3
4
9417

Always maintain consistency in region configurations throughout your application. Instead of hardcoding endpoints, us...

Configurations Other

Write deterministic tests

Azure/azure-sdk-for-net
4
5809

Tests should be deterministic, reliable, and isolated from external dependencies to ensure consistent results across ...

Testing C#

User-friendly configuration values

Azure/azure-sdk-for-net
4
5809

Prefer intuitive, user-friendly values for configuration options over technical "magic strings" or codes that require...

Configurations Markdown

Standardize environment variables

Azure/azure-sdk-for-net
4
5809

Ensure environment variable names are consistently spelled, properly referenced, and follow established naming conven...

Configurations C#

Externalize configuration values

Azure/azure-sdk-for-net
4
5809

Store configuration values (URLs, demands, pool names) in centralized variables rather than hardcoding them inline. T...

Configurations Yaml

Use Option combinators

tokio-rs/axum
4
22100

Instead of verbose conditional logic, prefer Rust's Option combinators like map, and_then, and filter for handling po...

Null Handling Rust

Structure errors for safety

tokio-rs/axum
4
22100

Create specific error types with appropriate status codes while ensuring sensitive details are logged but not exposed...

Error Handling Rust

Minimize memory allocation overhead

tokio-rs/axum
4
22100

Optimize performance by minimizing unnecessary memory allocations and using allocation-efficient APIs. Key practices ...

Performance Optimization Rust

Lock carefully in async

tokio-rs/axum
4
22100

When using locks in async code, follow critical guidelines to avoid deadlocks. Never hold std::sync::Mutex locks acro...

Concurrency Rust

Handle protocol headers properly

tokio-rs/axum
4
22100

When implementing network services, especially proxies and protocol handlers, proper HTTP header management is critic...

Networking Rust

Validate security-critical inputs

axios/axios
4
107000

Always validate and sanitize user-supplied inputs before using them in security-sensitive operations. This helps prev...

Security Javascript

Robust Axios Usage in Typescript

axios/axios
4
107000

This review focuses on ensuring robust and type-safe usage of the Axios library in Typescript codebases. Key recommen...

Axios Typescript

Proper Error Handling in Axios Typescript Code

axios/axios
4
107000

As a code reviewer, it is important to ensure that Axios-based Typescript code properly handles and propagates errors...

Axios Typescript

Extract for better readability

axios/axios
4
107000

Complex expressions and repeated code should be extracted into well-named variables to improve readability and mainta...

Code Style Javascript

Maintain consistent formatting

aws/aws-sdk-js
4
7628

Enhance code readability and maintainability by applying consistent formatting practices throughout your codebase: 1...

Code Style Javascript

Safe constraint modification sequence

apache/airflow
4
40858

When modifying constraints in database migrations, follow a safe sequence of operations to prevent integrity errors: ...

Migrations Python

Parameterize similar tests

apache/airflow
4
40858

Write parameterized tests instead of using for loops or duplicating test code for similar test cases. Using pytest's ...

Testing Python

Optimize collection processing patterns

apache/airflow
4
40858

Use Python's built-in efficient collection processing methods instead of manual implementations. This reduces code co...

Algorithms Python

Leverage backend API capabilities

apache/airflow
4
40858

When consuming APIs in frontend applications, utilize the backend capabilities rather than reimplementing equivalent ...

API TSX

Explicit version constraints

apache/airflow
4
40858

Always specify explicit version constraints for dependencies in configuration files (like pyproject.toml), particular...

Configurations Toml

Explicit over implicit configuration

apache/airflow
4
40858

Always prefer explicit configuration parameters over inferring behavior from indirect sources like image tags, naming...

Configurations Yaml

Ensure deterministic queries

apache/airflow
4
40858

Build SQLAlchemy queries that are both efficient and deterministic to prevent unpredictable results and improve perfo...

Database Python

Document public API boundaries

apache/airflow
4
40858

Clearly define and document the boundaries between public and internal APIs to guide developers on proper interface u...

API Other

Context-rich log messages

apache/airflow
4
40858

Ensure log messages provide clear context about what happened, potential consequences, and actionable information for...

Logging Python

Consistent technical term translation

apache/airflow
4
40858

When localizing an application, maintain consistent conventions for technical terms while respecting language-specifi...

Naming Conventions Json

Component reuse first

apache/airflow
4
40858

Always prioritize reusing existing components before creating new ones. This practice improves codebase consistency, ...

React TSX

Place configurations appropriately

vercel/ai
4
15590

Configuration options should be organized based on their nature and scope of use. Place model-specific configurations...

Configurations Typescript

Explicit code organization patterns

vercel/ai
4
15590

Maintain clear and explicit code organization patterns by following these guidelines: 1. Use explicit property visib...

Code Style Typescript

Self-explanatory identifier names

zed-industries/zed
3
62119

Choose identifier names that clearly convey their purpose without requiring users to understand implementation detail...

Naming Conventions Json

Respect language-specific conventions

zed-industries/zed
3
62119

Always adhere to the established formatting and syntax conventions of each programming language while maintaining con...

Code Style Toml

Maintain style consistency

zed-industries/zed
3
62119

Ensure consistent styling is maintained across related elements in the codebase. This applies to: 1. **Visual assets...

Code Style Other

Maintain consistent naming

zed-industries/zed
3
62119

Ensure naming follows consistent patterns throughout the codebase in both style and structure: 1. Use agreed-upon ca...

Naming Conventions Other

Hierarchical configuration organization

zed-industries/zed
3
62119

Organize configuration settings hierarchically by grouping related settings under meaningful namespaces rather than c...

Configurations Json

Secure before deployment

vllm-project/vllm
3
51730

Remove or secure development-specific code before deploying to production environments. Development artifacts like de...

Security Python

Protect shared state

vllm-project/vllm
3
51730

When mutable state (like dictionaries, lists, or counters) is accessed from multiple threads or concurrent tasks, use...

Concurrency Python

Structured configuration management

vitessio/vitess
3
19815

Avoid using global configuration singletons that rely on string-based lookups, as they lead to brittle code that's ha...

Configurations Markdown

Robust network handling

vitessio/vitess
3
19815

Always implement proper network timeout handling and address formatting to ensure robust connectivity across differen...

Networking Go

Secure workflow permissions

vitejs/vite
3
74031

Define explicit and minimal permissions in GitHub Actions workflows to ensure proper operation while maintaining secu...

CI/CD Yaml

Restrict server access

vitejs/vite
3
74031

Always configure server security settings with explicit allowed lists rather than permissive values. Using `true` for...

Security Markdown

Short-circuit evaluation strategies

astral-sh/uv
3
60322

When implementing search or traversal algorithms, use short-circuit evaluation strategically to avoid unnecessary com...

Algorithms Rust

Optimize cache sharing strategies

astral-sh/uv
3
60322

Select the appropriate cache sharing approach based on your execution environment to maximize performance and efficie...

Caching Markdown

Follow established naming conventions

astral-sh/uv
3
60322

Adhere to established naming conventions for files, variables, functions, and configuration options to maintain consi...

Naming Conventions Markdown

Enforce strong optional types

astral-sh/uv
3
60322

Use strong typing and early validation to handle optional values and prevent null-related issues. Prefer enums and sp...

Null Handling Rust

Declarative constraints over runtime

astral-sh/uv
3
60322

Design APIs that enforce constraints through type systems and declarative mechanisms rather than runtime checks. This...

API Rust

Prevent object recreations

shadcn-ui/ui
3
90568

Avoid creating new objects and functions repeatedly during renders to reduce memory pressure and improve performance....

Performance Optimization TSX

Leverage framework defaults

shadcn-ui/ui
3
90568

Avoid redundant or unnecessary configuration by understanding and utilizing default behaviors provided by frameworks ...

Configurations Typescript

Complete optional chaining

shadcn-ui/ui
3
90568

When using optional chaining (`?.`), ensure that **all subsequent operations** in the chain are also protected from n...

Null Handling TSX

Complete configuration paths

shadcn-ui/ui
3
90568

Always verify that configuration files include all necessary file paths and extensions, particularly for framework-sp...

Configurations Other

Validate configuration structures

vercel/turborepo
3
28115

Ensure configuration files and schemas adhere to their expected structure, location, and uniqueness constraints. When...

Configurations Typescript

Use functional null handling

vercel/turborepo
3
28115

Leverage Rust's functional operators for handling nullable and optional values. Instead of using unwrap() or explicit...

Null Handling Rust

Use affected mode

vercel/turborepo
3
28115

Optimize CI pipelines by running tasks only on packages affected by code changes. Use the `--affected` flag in Turbor...

CI/CD Other

Standardize package manager commands

vercel/turborepo
3
28115

Ensure all package manager commands in documentation and CI/CD scripts follow the correct syntax for the specific pac...

CI/CD Markdown

Semantic naming conventions

vercel/turborepo
3
28115

Use names that clearly convey the purpose and content of variables, parameters, and properties. When working with obj...

Naming Conventions Typescript

Minimize lock duration

vercel/turborepo
3
28115

When using locks in asynchronous code, minimize the scope and duration for which locks are held, especially across `....

Concurrency Rust

Document configuration alternatives

vercel/turborepo
3
28115

When documenting commands or tools that can be executed in different ways based on configuration settings (like globa...

Configurations Markdown

Document cache strategies

vercel/turborepo
3
28115

Always provide clear documentation and implementation for caching strategies, including key generation, invalidation ...

Caching Other

Optimize job structure

tokio-rs/tokio
3
28989

Structure CI jobs for clarity, parallelism, and efficiency. Each job should have a single, well-defined purpose to pr...

CI/CD Yaml

Optimize CI job structure

tokio-rs/tokio
3
28981

Structure your CI workflows to maximize performance and clarity. Each job should have a single, clear responsibility ...

CI/CD Yaml

Minimize unsafe code

tokio-rs/tokio
3
28981

When writing code that requires unsafe operations, follow these critical security practices: 1. Minimize the scope o...

Security Rust

Clear command documentation

tokio-rs/tokio
3
28989

When documenting shell commands in technical documentation, use the `shell` language identifier instead of `bash` as ...

Documentation Markdown

Thread-safe resource sharing

huggingface/tokenizers
3
9868

When sharing mutable data between threads, use the `Arc>` pattern to ensure thread safety. `Arc` provides t...

Concurrency Rust

Pythonic API design

huggingface/tokenizers
3
9868

Design APIs that follow Python language conventions and idioms rather than blindly mirroring the underlying implement...

API Python

Purpose-indicating descriptive names

huggingface/tokenizers
3
9868

Choose names for variables, methods, parameters, and fixtures that clearly communicate their purpose, content, and be...

Naming Conventions Python

Optimize workflow triggers

huggingface/tokenizers
3
9868

Configure CI workflows with targeted triggers and path filters to balance thoroughness with efficiency. Run critical ...

CI/CD Yaml

Modular model components

huggingface/tokenizers
3
9868

Design machine learning model code with clear component boundaries and proper separation of concerns. Each component ...

AI Rust

Manage version constraints

huggingface/tokenizers
3
9868

When configuring dependency version constraints in project files, follow these principles: 1. Be explicit about vers...

Configurations Toml

Technical precision matters

hashicorp/terraform
3
45532

When documenting algorithms, data structures, and computational processes, use precise and objective language rather ...

Algorithms Other

Validate tensor inputs safely

tensorflow/tensorflow
3
190625

When handling tensor inputs that may contain invalid values, use transformational approaches rather than conditional ...

Null Handling Python

Separate test data

tensorflow/tensorflow
3
190625

Large test data should be separated from test logic to improve readability and maintainability. Move test data into s...

Testing Other

Training-aware ML APIs

tensorflow/swift
3
6136

Design machine learning APIs with explicit parameters for distinguishing between training and inference phases rather...

AI Markdown

Swift idiomatic naming

tensorflow/swift
3
6136

Follow Swift's naming conventions to write more readable, maintainable code. The Swift language emphasizes clarity an...

Naming Conventions Other

Provide comprehensive examples

tensorflow/swift
3
6136

API documentation should include complete examples that demonstrate all key usage patterns. When documenting related ...

Documentation Markdown

Generic algorithm design

tensorflow/swift
3
6136

When implementing generic algorithms in Swift, follow these best practices to improve code clarity and performance: ...

Algorithms Other

Format for readability

tensorflow/swift
3
6136

Code should be formatted to optimize readability. Apply these key practices: 1. **Maintain reasonable line length** ...

Code Style Other

Follow Swift naming conventions

tensorflow/swift
3
6136

Ensure code follows established Swift naming conventions and remains consistent with domain terminology: 1. Use stan...

Naming Conventions Swift

Document API stability

tensorflow/swift
3
6136

When working with AI frameworks and machine learning libraries, clearly document the stability state of APIs being us...

AI Other

Standardize configuration formats

spring-projects/spring-framework
3
58382

Use consistent, explicit, and well-documented formats in all configuration files to improve readability and prevent m...

Configurations Other

Package null-safety annotations

spring-projects/spring-framework
3
58382

All package-info.java files must include both @NonNullApi and @NonNullFields annotations to establish null-safety at ...

Null Handling Xml

Optimize CI environment configuration

spring-projects/spring-framework
3
58382

When configuring CI environments, carefully evaluate whether default dependency versions are sufficient for your proj...

CI/CD Yaml

Leverage Kotlin null-safety

spring-projects/spring-framework
3
58382

Utilize Kotlin's null-safety features effectively to create cleaner, more robust code: 1. For class properties that ...

Null Handling Kotlin

Database-agnostic SQL syntax

spring-projects/spring-framework
3
58382

Write SQL statements that conform to standard SQL rather than relying on vendor-specific dialects to ensure portabili...

Database Java

Clone network headers carefully

spring-projects/spring-framework
3
58382

When working with HTTP or WebSocket headers in networking code, be cautious about header manipulation, cloning, and l...

Networking Java

Validate nulls properly

spring-projects/spring-boot
3
77637

Always use appropriate null validation mechanisms to prevent NullPointerExceptions and ensure code robustness. For s...

Null Handling Java

Reference existing configurations

spring-projects/spring-boot
3
77637

When setting up configuration files, reference existing configuration sources rather than duplicating values or logic...

Configurations Yaml

Validate before access

dotnet/runtime
3
16578

Always validate parameters and initialize variables before access to prevent null dereference and undefined behavior....

Null Handling C

Preserve pointer authentication

dotnet/runtime
3
16578

When implementing Pointer Authentication (PAC) for security, maintain signed pointers throughout their entire lifecyc...

Security C++

Platform-agnostic network APIs

dotnet/runtime
3
16578

When implementing networking functionality, ensure code uses platform-agnostic APIs and appropriate abstraction layer...

Networking C++

Parameterize configuration values

dotnet/runtime
3
16578

Extract hard-coded configuration values into variables, parameters, or templates to improve reusability and simplify ...

Configurations Yaml

Optimize build dependency chains

dotnet/runtime
3
16578

When configuring build and test processes in CI/CD pipelines, ensure proper dependency chains with clear inputs and o...

CI/CD Other

Memory ordering matters

dotnet/runtime
3
16578

When working with shared data in multithreaded environments, memory ordering is critical to prevent race conditions a...

Concurrency C++

Choose descriptive names

dotnet/runtime
3
16578

Names should clearly convey purpose and meaning. Parameter, variable, and method names should be self-explanatory and...

Naming Conventions C++

Verify union attribute access

astral-sh/ruff
3
40619

When working with union types in Python, always verify that all components of the union have the attributes you're tr...

Null Handling Markdown

Structure documentation effectively

astral-sh/ruff
3
40619

Documentation should follow a consistent structure where explanations precede code examples, preferably ending with a...

Documentation Markdown

Ensure algorithmic determinism

astral-sh/ruff
3
40619

When implementing algorithms for code analysis, type checking, or pattern matching, ensure they produce consistent an...

Algorithms Other

Assert exact expectations

astral-sh/ruff
3
40619

Always assert exact expected values in tests rather than using loose assertions. When testing the presence of element...

Testing Rust

Verify performance empirically

facebook/react
3
237000

Always validate performance optimizations through measurement rather than assumptions. Run multiple iterations of per...

Performance Optimization Typescript

Use appropriate testing methods

facebook/react
3
237000

When writing tests, use the appropriate testing utilities and ensure proper test isolation. For testing warning behav...

Testing Javascript

Separate conditional paths

facebook/react
3
237000

When working with concurrent operations, separate conditional logic from potentially expensive or suspenseful executi...

Concurrency Javascript

Optimize React Component Dependencies

facebook/react
3
237000

When implementing React components, ensure that dependencies between component state, props, and side effects are acc...

React Typescript

Match errors to context

facebook/react
3
237000

Choose error handling mechanisms based on the error's severity and context. For critical issues that should prevent f...

Error Handling Typescript

Complete hook dependencies

facebook/react
3
237000

Always specify complete dependency arrays in React hooks to prevent bugs from stale closures and avoid unnecessary re...

React Javascript

Check property existence first

facebook/react
3
237000

Always verify that an object and its properties exist before accessing them to prevent 'cannot read property of undef...

Null Handling Javascript

Wrap threaded code properly

rails/rails
3
57027

When working with threads in Rails applications, always wrap application code with `Rails.application.executor.wrap` ...

Concurrency Markdown

Semantic HTML usage

rails/rails
3
57027

Use HTML elements according to their semantic purpose to ensure proper accessibility and code organization. Choose el...

Code Style Other

Environment-specific logger configuration

rails/rails
3
57027

Configure loggers in environment-specific files rather than in application.rb or initializers. Different environments...

Logging Markdown

Document performance implications

rails/rails
3
57027

Clearly document the performance implications of features and configurations to help users make informed decisions. A...

Performance Optimization Markdown

Consistent terminology usage

rails/rails
3
57027

Always use consistent terminology for the same concept throughout your codebase, documentation, and user interfaces. ...

Naming Conventions Other

Reuse test patterns

quarkusio/quarkus
3
14667

Minimize duplication and improve test maintainability by reusing existing test patterns and leveraging parameterizati...

Testing Java

Document deployment strategy constraints

quarkusio/quarkus
3
14667

Always document and enforce appropriate deployment strategies for different application types in your CI/CD pipeline ...

CI/CD Other

Document dependency versions

quarkusio/quarkus
3
14667

When managing dependency versions in configuration files, provide clear documentation to help maintainers understand ...

Configurations Xml

Descriptive consistent naming

quarkusio/quarkus
3
14667

Use clear, descriptive names instead of cryptic abbreviations, and follow consistent naming patterns across your code...

Naming Conventions Other

Avoid request-path blocking

quarkusio/quarkus
3
14667

Minimize blocking operations in request-handling paths to ensure responsive application performance. Implement cachin...

Performance Optimization Other

Thread context management

pytorch/pytorch
3
91345

Always explicitly set required thread context and state rather than assuming inheritance from parent threads or other...

Concurrency Python

Structure for readability

pytorch/pytorch
3
91345

Structure code to maximize readability by reducing unnecessary complexity. Use early returns to minimize nesting leve...

Code Style Python

Reusable workflow design

pytorch/pytorch
3
91345

Design CI/CD workflows with reusability and clear naming conventions from the start. Use meaningful prefixes that ref...

CI/CD Yaml

Reduce code duplication

pytorch/pytorch
3
91345

Eliminate repeated code patterns by using appropriate abstraction techniques. This improves readability, reduces main...

Code Style C++

Purpose-revealing identifier names

pytorch/pytorch
3
91345

Choose identifier names that clearly reveal their purpose and behavior. Names should be specific, descriptive, and se...

Naming Conventions Python

Prefer HINTS in CMake

pytorch/pytorch
3
91345

When configuring library searches in CMake, use `HINTS` instead of `PATHS` when you want to prioritize specific locat...

Configurations Txt

Parameterize similar test cases

pytorch/pytorch
3
91345

Instead of duplicating test code or using nested loops, use test parameterization to handle multiple test cases effic...

Testing Python

Modular configuration design

pytorch/pytorch
3
91345

Configuration systems should be designed with modularity and clarity in mind. When creating configuration classes or ...

Configurations Other

Document configuration decisions

pytorch/pytorch
3
91345

Always document configuration decisions in package metadata files like `pyproject.toml` with clear comments, especial...

Configurations Toml

Consistent code organization

pytorch/pytorch
3
91345

Follow consistent code organization patterns: 1. Place static definitions in .cpp files rather than headers to preve...

Code Style Other

Check CUDA availability first

pytorch/pytorch
3
91345

Always verify CUDA availability before performing CUDA-specific operations to prevent runtime errors when code runs o...

Pytorch Python

Structured configuration management

pydantic/pydantic
3
24377

Configuration files should follow official standards, have up-to-date tool settings, and appropriate dependency const...

Configurations Toml

Preserve language conventions

pydantic/pydantic
3
24377

When designing APIs that bridge between programming languages and external data formats (like JSON, XML, etc.), maint...

API Markdown

Explicit over implicit

pydantic/pydantic
3
24377

Always prefer explicit configuration settings over relying on implicit defaults or environmental behaviors in CI work...

Configurations Yaml

Documentation formatting standards

pydantic/pydantic
3
24377

Maintain consistent documentation formatting to ensure proper rendering and readability. Follow these key practices: ...

Code Style Markdown

Categorize error types

pydantic/pydantic
3
24377

Distinguish between different categories of errors and handle each appropriately. Specifically: 1. **Validation erro...

Error Handling Markdown

Use configuration placeholders

prowler-cloud/prowler
3
11834

Avoid hardcoding specific values like regions, timeframes, or identifiers in configuration commands, examples, or set...

Configurations Json

Tenant-aware query optimization

prowler-cloud/prowler
3
11834

Always include tenant_id filters in database queries for multi-tenant systems to maintain data isolation and improve ...

Database Python

Pin GitHub Actions dependencies

prowler-cloud/prowler
3
11834

Always pin GitHub Actions to specific commit SHAs rather than using major version references to prevent supply chain ...

CI/CD Yaml

Parameterize similar tests

prowler-cloud/prowler
3
11834

Write maintainable tests by using pytest parametrization for similar test cases instead of duplicating test logic. Th...

Testing Python

Document dependency versioning

prowler-cloud/prowler
3
11834

Use consistent patterns for specifying dependency versions in configuration files and document reasoning behind versi...

Configurations Toml

Feature flag compatibility

pola-rs/polars
3
34296

Design code to work correctly with any combination of feature flags. When implementing conditional compilation with f...

Configurations Rust

Favor clarity over brevity

pola-rs/polars
3
34296

Always prioritize code readability and maintainability over concise but cryptic implementations. Extract repeated log...

Code Style Python

Database API abstraction

pola-rs/polars
3
34296

When designing database interaction layers, carefully consider when to create wrapper methods versus allowing direct ...

Database Python

Create demonstrative examples

pola-rs/polars
3
34296

Include clear, concise examples in documentation that effectively demonstrate functionality. Follow these principles ...

Documentation Python

Consistent naming standards

pola-rs/polars
3
34296

Maintain consistent and standardized naming throughout the codebase: 1. **Use snake_case for multi-word identifiers*...

Naming Conventions Python

CI workflow configuration best

pola-rs/polars
3
34296

Configure GitHub Actions workflows to maximize reliability and maintainability. Follow these key practices: 1. **Alw...

CI/CD Yaml

Optimize CI/CD workflows

opentofu/opentofu
3
25901

Configure CI/CD workflows to maximize efficiency and improve developer experience. Consider these key optimization pr...

CI/CD Yaml

Names preserve cognitive context

opentofu/opentofu
3
25901

Choose variable, function, and type names that preserve cognitive context by clearly indicating their purpose and rel...

Naming Conventions Go

Explicit versus dynamic configurations

opentofu/opentofu
3
25901

Prefer explicit hardcoded configurations over dynamic ones when the configuration changes infrequently and control is...

Configurations Yaml

Document reference standards

opentofu/opentofu
3
25901

Maintain consistent and accurate reference practices throughout project documentation to enhance usability and mainta...

Documentation Markdown

Structured changelog documentation

open-telemetry/opentelemetry-python
3
2061

Maintain consistent and informative changelog documentation by following these practices: 1. Structure changelogs wi...

Documentation Markdown

Maintain consistent naming

open-telemetry/opentelemetry-python
3
2061

Ensure naming conventions are consistent across your codebase and related repositories. When naming commands, functio...

Naming Conventions Markdown

Explicit CI configurations

open-telemetry/opentelemetry-python
3
2061

Always use explicit, specific configurations in CI/CD pipelines to prevent ambiguity and conflicts. This includes: 1...

CI/CD Other

Validate tensor dimensions

opencv/opencv
3
82865

When implementing AI model inference code, always validate tensor dimensions and shapes before manipulating them. Neu...

AI C++

Meaningful semantic naming

opencv/opencv
3
82865

Choose names that clearly communicate purpose and follow consistent patterns across the codebase: 1. Use generic fun...

Naming Conventions Python

Feature flag convention

opencv/opencv
3
82865

Establish a consistent pattern for feature flags and dependency management in configuration files: 1. Use `WITH_*` o...

Configurations Txt

Cleanup before errors

opencv/opencv
3
82865

Always ensure all resources are properly released before raising errors to prevent resource leaks. This practice is e...

Error Handling Other

Use portable path configurations

ollama/ollama
3
145705

Build and configuration scripts should use portable path handling techniques to ensure they work correctly across dif...

Configurations Shell

Optimize AI implementation patterns

ollama/ollama
3
145705

When implementing AI systems, prioritize established patterns and optimizations rather than creating new implementati...

AI Other

Complete null checks

ollama/ollama
3
145705

Always perform thorough null checks before dereferencing pointers, and ensure all operations on potentially null obje...

Null Handling C++

AI memory management

ollama/ollama
3
145705

Document and implement proper memory management strategies for AI model inference to prevent out-of-memory errors and...

AI Markdown

Abstract configuration access

octokit/octokit.net
3
2793

Use abstraction layers to access configuration settings rather than accessing environment variables, feature flags, o...

Configurations C#

Write concise idiomatic code

vercel/next.js
3
133000

Favor concise and idiomatic expressions in your Rust code to improve readability and maintainability.

Code Style Rust

Verify workflow configuration integrity

vercel/next.js
3
133000

Carefully review GitHub Actions workflow configurations to prevent subtle errors that can cause CI/CD pipeline failur...

CI/CD Yaml

Prefer Existence Checks in Next.js Components

vercel/next.js
3
133000

When working with props, state, or other values in Next.js components that may be null, undefined, or contain error s...

Next.js Javascript

Optimize data structure selection

vercel/next.js
3
133000

Choose data structures that match your specific access patterns and performance requirements. The right data structur...

Performance Optimization Rust

Consistent variable style patterns

vercel/next.js
3
133000

Maintain consistent patterns for variable declarations and naming conventions: use const by default for variable decl...

Code Style Typescript

Prevent test resource leaks

netty/netty
3
34227

Always ensure proper cleanup of resources in tests to prevent memory leaks. When using EmbeddedChannel, call readOutb...

Testing Java

Consistent dependency declarations

netty/netty
3
34227

Ensure dependency declarations in build configuration files use concrete values rather than variables that may not re...

Configurations Xml

Secure authentication handling

neondatabase/neon
3
19015

Always implement proper authentication checks and protect sensitive credentials throughout your codebase. This includ...

Security Rust

Precise algorithm terminology

neondatabase/neon
3
19015

When implementing and documenting algorithms, use precise terminology and be explicit about metrics, operations, and ...

Algorithms Markdown

Performance test pragmatism

neondatabase/neon
3
19015

When designing performance tests, focus on efficiency and meaningful insights rather than exhaustive combinations. Co...

Performance Optimization Python

Optimize data structures

neondatabase/neon
3
19015

When implementing algorithms, prioritize data structure choices that minimize resource usage while maintaining functi...

Algorithms C

Handle all error paths

neondatabase/neon
3
19015

Ensure comprehensive error handling throughout the codebase by implementing proper error handling blocks, defensive v...

Error Handling C

Guard against race conditions

neondatabase/neon
3
19015

When working with concurrent operations, always implement proper guards to prevent race conditions between processes....

Concurrency C

Extract and reuse

neondatabase/neon
3
19015

Create focused utility functions for repeated or complex operations instead of duplicating logic across the codebase....

Code Style C

Environment-specific config defaults

neondatabase/neon
3
19015

Define appropriate configuration defaults for different environments (development, testing, production) using dedicat...

Configurations Python

Document API specs completely

neondatabase/neon
3
19015

When designing and implementing APIs, always provide comprehensive specifications that clearly document all endpoints...

API Markdown

Database before memory

neondatabase/neon
3
19015

When working with database systems that also maintain in-memory state, always update the persistent database state be...

Database Rust

Configuration context alignment

neondatabase/neon
3
19015

Choose the appropriate configuration context based on how changes will be handled by the system. When defining custom...

Configurations C

Configurable cache parameters

neondatabase/neon
3
19015

Cache configurations should be runtime-configurable rather than hardcoded, with support for dynamic resizing when con...

Caching Rust

Cache performance preservation

neondatabase/neon
3
19015

When implementing database failover or restart mechanisms, ensure performance consistency by preserving and prewarmin...

Database Markdown

Avoid flaky tests

neondatabase/neon
3
19015

Tests should be designed to be deterministic and reliable to prevent wasted developer time and false confidence. Tw...

Testing Python

Adaptive cache expiration strategy

neondatabase/neon
3
19015

Design cache expiration policies that align with actual workload patterns rather than arbitrary timeframes. For syste...

Caching Markdown

Use explicit optional types

apache/mxnet
3
20801

When dealing with values that may be absent or null, always use explicit optional type wrappers instead of implicit n...

Null Handling Other

Documentation clarity and formatting

apache/mxnet
3
20801

When writing documentation (README files, tutorials, API docs), ensure clarity and proper formatting: 1. **Define te...

Documentation Markdown

Document environment variables

apache/mxnet
3
20801

All environment variables must be documented in the central env_var.md file with clear descriptions of their purpose,...

Configurations Other

Document API completely

apache/mxnet
3
20801

Always provide comprehensive API documentation that clearly specifies: 1. **Parameter types** - Document all accepta...

API Python

Consistent logging format

apache/mxnet
3
20801

Use consistent string formatting in logging statements throughout the codebase. Prefer `%` style placeholders over f-...

Logging Python

Centralize synchronization logic

apache/mxnet
3
20801

When implementing concurrent operations, especially in heterogeneous computing environments (CPU/GPU), centralize syn...

Concurrency Other

Centralize configuration parameters

apache/mxnet
3
20801

Avoid hardcoded paths and duplicated configuration values throughout the code. Instead: 1. Use dedicated configurati...

Configurations Shell

Documentation completeness check

langchain-ai/langchainjs
3
15004

Ensure all documentation is complete, well-formatted, and maximally useful for developers. This includes: 1. **Use p...

Documentation Markdown

Constructor over setter

langchain-ai/langchainjs
3
15004

Prefer passing configuration through constructor parameters rather than setting properties after instantiation. This ...

API Other

Consistent naming conventions

langchain-ai/langchainjs
3
15004

Maintain consistent and explicit naming conventions across your codebase that reflect: 1. **Component dependencies**...

Naming Conventions Other

Consistent AI naming

langchain-ai/langchainjs
3
15004

Use specific and consistent naming conventions when referencing AI services, models, and their parameters throughout ...

AI Javascript

Chunked data processing

langchain-ai/langchainjs
3
15004

When processing large arrays or data structures, implement chunked processing to avoid stack size limitations and opt...

Algorithms Typescript

AI dependency management

langchain-ai/langchainjs
3
15004

When integrating AI models and language processing libraries, follow these dependency management best practices: 1. ...

AI Json

Use table-driven tests

kubeflow/kubeflow
3
15064

In Go, prefer table-driven tests over multiple separate test functions. Table tests allow for concise testing of mult...

Testing Go

Use snake_case in Python

kubeflow/kubeflow
3
15064

Follow Python's PEP 8 naming convention by using snake_case for variables, functions, and methods rather than camelCa...

Naming Conventions Python

Use appropriate log levels

kubeflow/kubeflow
3
15064

Always match logging levels to the message's purpose and severity. Use log.Info for general information, log.Warn for...

Logging Go

Structured OWNERS files

kubeflow/kubeflow
3
15064

OWNERS files must follow project documentation standards to properly reflect component ownership and maintainership. ...

Documentation Other

Standardize build configurations

kubeflow/kubeflow
3
15064

All components should use consistent build configurations and patterns in their CI/CD setup. This includes standardiz...

CI/CD Markdown

Specific network access documentation

kubeflow/kubeflow
3
15064

When documenting network access methods or service connections, always provide specific commands with explicit ports ...

Networking Markdown

Normalize URL paths

kubeflow/kubeflow
3
15064

When handling URLs in web applications, consistently normalize path formats to prevent routing and service communicat...

Networking Typescript

Mark UI text i18n

kubeflow/kubeflow
3
15064

All user-facing text in HTML templates should be marked for internationalization using the i18n directive. This inclu...

Documentation Html

Manage configuration changes

kubeflow/kubeflow
3
15064

Carefully manage configuration file changes to ensure consistency and minimize unintended impacts across your project...

Configurations Json

Environment-aware configuration design

kubeflow/kubeflow
3
15064

Design configurations that work consistently across different environments without requiring environment-specific mod...

Configurations Yaml

Document with precision

kubeflow/kubeflow
3
15064

Write informative, consistent, and precise code comments throughout your codebase. When documenting code: 1. **Be sp...

Documentation Dockerfile

Check before use

kubeflow/kubeflow
3
15064

Always validate that objects, maps, and other reference types are non-nil before attempting to use them. Use early ni...

Null Handling Go

Standardize build configurations

JetBrains/kotlin
3
50857

Maintain consistent and standardized build configurations across the project to improve maintainability and reduce er...

Configurations Other

Type over primitives

influxdata/influxdb
3
30268

Use domain-specific types instead of primitives (like strings, []byte, or generic maps) to represent domain concepts ...

Algorithms Go

Secure token lifecycle

influxdata/influxdb
3
30268

Implement comprehensive lifecycle controls for authentication tokens to maintain security throughout token creation, ...

Security Rust

Explicit security parameters

influxdata/influxdb
3
30268

Security-critical features should be implemented as required parameters rather than optional parameters or option fun...

Security Go

Document complete data flows

influxdata/influxdb
3
30268

When documenting database systems, ensure all documentation includes complete end-to-end data flows. Both diagrams an...

Database Markdown

Complete schema management

influxdata/influxdb
3
30268

When working with database systems that have flexible schemas (like InfluxDB), ensure complete schema discovery and p...

Database Go

Sanitize external content

elie222/inbox-zero
3
8267

Always sanitize and validate external content before processing or rendering it to prevent security vulnerabilities l...

Security TSX

Remove commented out code

elie222/inbox-zero
3
8267

Delete commented-out code instead of retaining it in the codebase. Commented code creates confusion, adds maintenance...

Code Style Typescript

Next.js async behavior

elie222/inbox-zero
3
8267

Understand and correctly implement the asynchronous behavior of Next.js APIs and components. Follow these guidelines:...

Next TSX

Guard against null chains

elie222/inbox-zero
3
8267

Prevent null pointer exceptions by validating object chains before accessing nested properties. Use early returns wit...

Null Handling Typescript

Externalize configuration values

elie222/inbox-zero
3
8267

Configuration files should not contain hardcoded values for usernames, credentials, hostnames, or environment-specifi...

Configurations Yaml

Database type best practices

elie222/inbox-zero
3
8267

Select appropriate data types and defaults for database columns to ensure data integrity and simplify application cod...

Database Sql

Proper mocking techniques

grafana/grafana
3
68825

Use appropriate mocking approaches for different dependencies in tests to ensure accurate test results and prevent fa...

Testing TSX

Optimize hot paths

grafana/grafana
3
68825

Identify and optimize frequently executed code paths by moving invariant calculations and conditional logic outside o...

Algorithms Typescript

Measure before optimizing

grafana/grafana
3
68825

Performance optimizations should be validated with measurements rather than assumptions. When implementing performanc...

Performance Optimization TSX

Maintain API version compatibility

grafana/grafana
3
68825

When implementing or modifying APIs, ensure backward compatibility across versions and client interfaces. Carefully e...

API Typescript

Graceful feature availability

grafana/grafana
3
68825

When implementing configurable features, ensure they degrade gracefully based on environment conditions like feature ...

Configurations TSX

Feature toggle lifecycle

grafana/grafana
3
68825

When working with feature toggles and configuration flags, manage their entire lifecycle carefully to prevent breakin...

Configurations Typescript

Design token value consistency

grafana/grafana
3
68825

When implementing design tokens in code, ensure values accurately represent the intended visual outcome, even if desi...

Code Style Json

Complete configuration fields

grafana/grafana
3
68825

Ensure all plugin configuration files include the complete set of required fields specific to their plugin type. Miss...

Configurations Json

Write resilient tests

gin-gonic/gin
3
83022

Tests should be designed to validate behavior without being brittle or sensitive to implementation details. Avoid dir...

Testing Go

Use standard API constants

gin-gonic/gin
3
83022

Always use standard library constants for HTTP methods and status codes rather than string literals or numeric values...

API Go

Precompute over recalculate

gin-gonic/gin
3
83022

Perform expensive calculations during initialization rather than on each request, and avoid unnecessary operations in...

Performance Optimization Go

Early return pattern

gin-gonic/gin
3
83022

Prefer returning early from functions rather than nesting conditions. When a condition can lead to an early exit, han...

Code Style Go

Configuration file precision

gin-gonic/gin
3
83022

Ensure configuration files are precisely maintained with correct syntax and compatible version declarations. This inc...

Configurations Other

Prefer safe optional handling

ghostty-org/ghostty
3
32864

Always use Swift's built-in mechanisms for safely handling optional values instead of force unwrapping or manual nil ...

Null Handling Swift

Encapsulate implementation details

ghostty-org/ghostty
3
32864

When designing APIs, create appropriate abstractions that hide platform-specific or low-level implementation details ...

API Other

Define explicit error sets

ghostty-org/ghostty
3
32864

Always define explicit error sets for functions that can fail, rather than using inferred error sets. This makes erro...

Error Handling Other

Centralize configuration values

ghostty-org/ghostty
3
32864

Hardcoded configuration values scattered throughout codebases create maintenance burdens and increase the risk of inc...

Configurations Yaml

Centralize configuration management

ghostty-org/ghostty
3
32864

Avoid hardcoded or duplicated configuration values by centralizing them in a dedicated location. When configurations ...

Configurations Swift

Consistent Fastify Integration Patterns

fastify/fastify
3
34000

When implementing integrations and plugins using the Fastify framework, maintain consistent coding patterns and conve...

Fastify Typescript

Standardize version transitions

fastapi/fastapi
3
86871

When supporting multiple library versions or preparing for version deprecation in configuration-dependent code, use s...

Configurations Python

Secure JWT authentication

fastapi/fastapi
3
86871

Implement secure authentication using JWT tokens by following these best practices: 1. **Use secure libraries**: Pre...

Security Markdown

Proper response handling

fastapi/fastapi
3
86871

When designing APIs, ensure responses adhere to HTTP semantics by: 1. Using semantic status code constants instead o...

API Python

Preserve unset field values

fastapi/fastapi
3
86871

When implementing partial updates in FastAPI, use the `exclude_unset` parameter in Pydantic's `.dict()` or `.model_du...

Null Handling Markdown

Explicit exception propagation

fastapi/fastapi
3
86871

Always be explicit about how exceptions are handled, propagated, and recovered from in your code. When catching excep...

Error Handling Markdown

Structured release workflows

expressjs/express
3
67300

Implement a clearly defined release strategy that distinguishes between different types of changes. Create separate w...

CI/CD Markdown

Purposeful style changes

expressjs/express
3
67300

Code style modifications should accompany functional improvements rather than being submitted as standalone changes. ...

Code Style Markdown

Implement least privilege

expressjs/express
3
67300

Apply the principle of least privilege for all repository and system access to enhance security. Each role should be ...

Security Markdown

Stage intensive operations carefully

elastic/elasticsearch
3
73104

When implementing operations that consume significant system resources (CPU, memory, I/O), introduce changes graduall...

Performance Optimization Markdown

Scope and document configurations

elastic/elasticsearch
3
73104

When designing and implementing configuration options, carefully consider two key aspects: 1. **Choose appropriate c...

Configurations Markdown

Design for evolution

elastic/elasticsearch
3
73104

When designing APIs, prioritize flexibility and independent evolution of components. Avoid tightly coupling related s...

API Java

Use appropriate logging levels

deeplearning4j/deeplearning4j
3
14036

Reserve logging statements for their appropriate purposes and levels. Use debugging-level logs (`sd_debug`) for devel...

Logging C++

Parameterize configuration scripts

deeplearning4j/deeplearning4j
3
14036

Configuration scripts should use variables for values that might change or are used in multiple places, such as paths...

Configurations Markdown

Eliminate redundant code

deeplearning4j/deeplearning4j
3
14036

Keep code clean by removing all forms of redundancy that affect readability and maintainability. This includes: 1. A...

Code Style Other

Clear descriptive identifiers

deeplearning4j/deeplearning4j
3
14036

Choose clear, self-descriptive names for all code identifiers that accurately reflect their purpose and behavior. Met...

Naming Conventions Java

Avoid environment-specific paths

deeplearning4j/deeplearning4j
3
14036

Always use environment variables or configuration mechanisms instead of hardcoding paths to compilers, tools, or dire...

Configurations Shell

Always secure your locks

deeplearning4j/deeplearning4j
3
14036

When using locks or other synchronization mechanisms in concurrent code, always release locks in a finally block to e...

Concurrency Java

Validate configurations up front

crewaiinc/crewai
3
33945

Always validate configuration parameters and environment variables at initialization time, providing clear error mess...

Configurations Python

Typed API client abstractions

crewaiinc/crewai
3
33945

When designing API clients, encapsulate responses in typed objects rather than passing raw JSON throughout your codeb...

API Python

Thread safety first

crewaiinc/crewai
3
33945

When implementing features that may run concurrently, always ensure thread safety using appropriate synchronization m...

Concurrency Python

Test behavior not calls

crewaiinc/crewai
3
33945

Tests should validate actual system behavior rather than just verifying method calls. When writing tests, focus on as...

Testing Python

Explicit over implicit

crewaiinc/crewai
3
33945

Always explicitly configure important system components rather than relying on implicit defaults or environment varia...

Configurations Other

Clear AI component interfaces

crewaiinc/crewai
3
33945

When designing AI components and tools, use domain-specific terminology and provide clear interface documentation to ...

AI Other

Vue component type safety

vuejs/core
3
50769

When defining Vue components with TypeScript, use appropriate component definition patterns to ensure proper type inf...

Vue TSX

Use environment flags consistently

vuejs/core
3
50769

Feature flags like `__DEV__` and `__COMPAT__` are critical configuration mechanisms that control environment-specific...

Configurations Typescript

Lifecycle effects management

vuejs/core
3
50769

Properly manage component lifecycle effects and cleanup in React components to prevent memory leaks and performance i...

React Typescript

Standardize shell flags

chef/chef
3
7860

Always use `set -eou pipefail` at the beginning of shell scripts to ensure consistent error handling and behavior acr...

Code Style Shell

Remove commented code

chef/chef
3
7860

Avoid leaving commented-out code in the codebase. Version control systems already track the history of changes, makin...

Code Style Yaml

Fail fast principle

chef/chef
3
7860

Design CI/CD pipelines to fail quickly and visibly rather than masking errors through excessive retries or complex co...

CI/CD Other

Clear abstraction boundaries

chef/chef
3
7860

Design APIs with clear and consistent abstraction boundaries to maintain code quality and prevent interface leakage b...

API Ruby

Validate configurations correctly

bridgecrewio/checkov
3
7668

When writing validation logic for configurations, ensure you're using the appropriate operators that correctly test f...

Configurations Yaml

Support all target environments

bridgecrewio/checkov
3
7667

When managing dependency configurations (Pipfiles, requirements.txt, lock files), ensure compatibility with all suppo...

Configurations Other

Comprehensive security scanning

bridgecrewio/checkov
3
7667

Always configure security scanning tools with comprehensive coverage and readable output to maximize vulnerability de...

Security Yaml

Backward compatible parameters

bridgecrewio/checkov
3
7667

When evolving API function signatures, maintain backward compatibility by making new parameters optional with sensibl...

API Python

Manage test environments

boto/boto3
3
9417

When writing tests that interact with environment variables or configuration settings, always (1) preserve the origin...

Configurations Python

Demonstrate canonical API patterns

boto/boto3
3
9417

Always provide examples that demonstrate the recommended and most current API usage patterns. This includes: 1. Usin...

API Other

Consistent naming standards

boto/boto3
3
9417

Follow standard Python naming conventions consistently throughout code and documentation. Use underscores instead of ...

Naming Conventions Other

Avoid hidden performance costs

boto/boto3
3
9417

When designing APIs that interact with remote services, be cautious about implementing convenience features that may ...

Performance Optimization Python

Surface errors appropriately

Azure/azure-sdk-for-net
3
5809

Ensure errors are visible and properly handled rather than silently processed or hidden. Provide mechanisms for devel...

Error Handling Markdown

Prefer identity-based authentication

Azure/azure-sdk-for-net
3
5809

Always prioritize modern identity-based authentication methods over traditional username/password credentials. This i...

Security Markdown

Follow formatting standards

Azure/azure-sdk-for-net
3
5809

Maintain consistent code formatting by adhering to the defined standards in the .editorconfig file and Azure SDK impl...

Code Style Markdown

Descriptive consistent identifiers

Azure/azure-sdk-for-net
3
5809

Use clear, descriptive identifiers that accurately reflect their purpose, and maintain consistent naming patterns thr...

Naming Conventions Other

Centralize pipeline configurations

Azure/azure-sdk-for-net
3
5809

Use centralized templates and variables for pipeline configurations instead of duplicating or hardcoding values. This...

CI/CD Yaml

Document feature flags

tokio-rs/axum
3
22100

When configuring feature flags in Cargo.toml, ensure they are properly structured and documented. Chain feature depen...

Configurations TOML

Proper Axios Configuration and Usage

axios/axios
3
107000

When implementing code that uses the Axios library in TypeScript, it is important to follow best practices for config...

Axios Typescript

Consistent Naming Conventions for Axios Requests and Responses

axios/axios
3
107000

When using the Axios library in Typescript, it is important to follow consistent naming conventions to improve code r...

Axios Typescript

Configuration property standards

axios/axios
3
107000

Always define configuration properties with sensible defaults and consistent naming conventions. When adding new conf...

Configurations Javascript

Validate configurations with clarity

aws/aws-sdk-js
3
7628

Configuration validation should use explicit checks and clear conditional logic to improve code readability and preve...

Configurations Javascript

Test configuration precedence

aws/aws-sdk-js
3
7628

When implementing systems that load configuration from multiple sources, always test the precedence rules explicitly ...

Configurations Other

Limit cache size

aws/aws-sdk-js
3
7628

Always implement size constraints on caches to prevent memory leaks and performance degradation. Unbounded caches can...

Caching Javascript

Follow established testing patterns

aws/aws-sdk-js
3
7628

When writing tests, use existing patterns and infrastructure already established in the codebase rather than creating...

Testing Other

Explicit verified configurations

aws/aws-sdk-js
3
7628

Always specify configuration values explicitly and verify their accuracy against official documentation or tests. Thi...

Configurations Json

Document APIs completely

aws/aws-sdk-js
3
7628

Always provide complete, clear, and contextually rich documentation for all public APIs. Documentation should: 1. Us...

Documentation Typescript

Follow naming conventions

apache/airflow
3
40858

Use proper naming conventions to make code more readable and maintainable: 1. **Functions should start with verbs** ...

Naming Conventions TSX

Enforce authentication boundaries

apache/airflow
3
40858

Implement strict authentication boundaries and access controls to prevent security vulnerabilities: 1. When multiple...

Security Other

Document intentional choices

apache/airflow
3
40858

Add explanatory comments for non-obvious code decisions that might appear incorrect, unusual, or suboptimal to future...

Documentation Python

Validate pattern matching

vercel/ai
3
15590

When implementing algorithms that involve pattern matching or data parsing, ensure robustness across all edge cases a...

Algorithms Typescript

Test before documenting

vercel/ai
3
15590

Always thoroughly test API features and endpoints before documenting them, especially when integrating with third-par...

API Other

Provide actionable examples

vercel/ai
3
15590

Documentation should include concrete, executable code examples rather than vague instructions. Make your examples co...

Documentation Other

Document configuration decisions

vercel/ai
3
15590

When modifying configuration files (package.json, tsconfig.json, etc.), document the reasoning behind significant cha...

Configurations Json

Async error callbacks

vercel/ai
3
15590

When handling asynchronous operations, especially those that might continue running in the background after the main ...

Error Handling Typescript

Proper documentation linking

zed-industries/zed
2
62119

Documentation should use appropriate linking strategies to ensure content remains accessible and navigable across all...

Documentation Markdown

Precise test pattern matching

zed-industries/zed
2
62119

When identifying test patterns in code, use specific equality predicates (`#eq?`) instead of list inclusion predicate...

Testing Other

Minimize credential exposure lifetime

zed-industries/zed
2
62119

Credentials and secrets should never be stored persistently in memory or written to files. Instead, use ephemeral pat...

Security Rust

Explicit over implicit

zed-industries/zed
2
62119

When designing APIs, prioritize explicit parameter identification over implicit context. APIs with clear, unambiguous...

API Other

Document configuration clearly

zed-industries/zed
2
62119

When adding or modifying configuration parameters, especially in JSON settings files, ensure they are clearly documen...

Code Style Json

Optimize tensor memory operations

vllm-project/vllm
2
51730

When working with PyTorch tensors, use memory-efficient operations that avoid unnecessary copies. Specify memory form...

Pytorch Python

Optimize GPU execution

vllm-project/vllm
2
51730

Ensure GPU code is optimized for both proper thread utilization and correct architecture dispatching: 1. **Maximize ...

Performance Optimization CUDA

Match reference names

vllm-project/vllm
2
51730

Ensure that filenames and paths referenced in scripts, commands, or configuration files exactly match the actual name...

Naming Conventions Other

Environment-aware configuration values

vllm-project/vllm
2
51730

When creating configuration files or defining configuration constants, ensure they properly adapt to different enviro...

Configurations Other

Combine identical CSS

vllm-project/vllm
2
51730

When multiple CSS selectors share identical styling properties, combine them using comma separation rather than dupli...

Code Style Css

AI model persistence

vllm-project/vllm
2
51730

When containerizing AI applications, ensure proper model persistence by mounting volumes to the default cache locatio...

AI Other

Validate environment configurations

vitessio/vitess
2
19815

Ensure that all environment-specific configurations work properly across all target environments, particularly when m...

Configurations Yaml

Size fields appropriately

vitessio/vitess
2
19815

When designing database schemas, choose field types and sizes that accommodate both current and anticipated future da...

Database Sql

Pin environment versions

vitessio/vitess
2
19815

Always use explicit version tags for CI/CD environments (runners, containers, images, tool versions) instead of float...

CI/CD Yaml

Manage workflow state transitions

vitessio/vitess
2
19815

When working with temporal workflows, always implement explicit state transitions rather than abrupt deletions. Workf...

Temporal Go

Justify CI resource additions

vitessio/vitess
2
19815

Before adding new resources (Dockerfiles, jobs, images) to CI/CD pipelines, provide clear justification for their nec...

CI/CD Other

Document configuration precedence

vitessio/vitess
2
19815

When implementing multiple configuration methods (e.g., config files, command-line flags, environment variables), cle...

Configurations Txt

Database configuration best practices

vitessio/vitess
2
19815

When implementing or modifying database-related configurations, follow these principles: 1. Use semantically appropr...

Database Markdown

Consistent database APIs

vitessio/vitess
2
19815

Design database APIs with consistent patterns for response structures and error handling. Follow established conventi...

Database Other

Clear metric documentation

vitessio/vitess
2
19815

When adding, modifying, or deprecating metrics, ensure comprehensive and clear documentation. Include: 1. Descriptiv...

Observability Markdown

Avoid skipping e2e tests

vitessio/vitess
2
19815

Do not use the `skip_e2e` flag to bypass end-to-end tests that fail. Instead, fix the test implementation by providin...

Testing Json

Vue component import handling

vitejs/vite
2
74031

When working with Vue single-file components, pay special attention to how imports are processed, particularly with q...

Vue Typescript

Targeted yet comprehensive

vitejs/vite
2
74031

Write focused tests that verify specific functionality without unnecessary setup, while still ensuring complete cover...

Testing Javascript

Separate configuration responsibilities

vitejs/vite
2
74031

Design configuration files with clear separation of responsibilities and maintain flexibility for future changes. Avo...

Configurations Other

Self-referential worker URLs

vitejs/vite
2
74031

When creating Web Workers for network communication, use self-referential URL patterns that are resilient to file ren...

Networking Javascript

React transformation tool clarity

vitejs/vite
2
74031

When working with React in Vite projects, be precise about which transformation tools (Babel, SWC, Oxc, esbuild) hand...

React Markdown

Precise documentation language

vitejs/vite
2
74031

Use specific and clear language in all documentation to improve user understanding and avoid ambiguity. Favor precise...

Documentation Other

Explicit version requirements

vitejs/vite
2
74031

Always specify explicit Node.js version requirements in configuration files to ensure compatibility with language fea...

Configurations Javascript

Document protocol configurations clearly

vitejs/vite
2
74031

When documenting network protocol configurations (TLS, HTTP/2, CORS), provide specific details about required options...

Networking Markdown

Configure SSR environments

vitejs/vite
2
74031

When implementing server-side rendering in Next.js projects that use Vite as a bundler, ensure proper environment sep...

Next Markdown

Complete deployment commands

vitejs/vite
2
74031

Always ensure build commands in CI/CD configurations include all necessary steps for successful deployment, particula...

CI/CD Markdown

Code example consistency

vitejs/vite
2
74031

Ensure code examples in documentation and comments are syntactically correct and properly marked with the appropriate...

Code Style Markdown

Clean network resources

vitejs/vite
2
74031

Always properly close and clean up network connections to prevent memory leaks and resource exhaustion. When establis...

Networking Typescript

Test deployment edge cases

astral-sh/uv
2
60322

Ensure that code paths handling different deployment environments (installation prefixes, target directories, etc.) h...

Testing Python

Optimize docker build caching

astral-sh/uv
2
60322

Leverage Docker BuildKit's cache and bind mount capabilities to dramatically improve CI build times and reduce image ...

CI/CD Dockerfile

Document build configurations

astral-sh/uv
2
60322

When setting Rust build configurations, especially in CI/Docker environments, explicitly document optimization choice...

Configurations Dockerfile

Cache sharing strategy

astral-sh/uv
2
60322

When implementing caching in build systems, carefully configure cache sharing behavior based on your concurrency requ...

Caching Dockerfile

Avoid unnecessary constraints

astral-sh/uv
2
60322

When specifying dependencies and version requirements in project configuration files, avoid adding unnecessary constr...

Configurations Toml

Use concise methods

shadcn-ui/ui
2
90568

Prefer built-in methods and properties that achieve the same result with less code. This improves readability, reduce...

Code Style Other

Preprocess data early

shadcn-ui/ui
2
90568

Transform and prepare data structures at their source rather than during consumption. This includes flattening nested...

Algorithms TSX

Optimize documentation for usability

shadcn-ui/ui
2
90568

When creating component documentation, prioritize the developer experience by providing clear, usable examples and co...

Documentation TSX

Consistent import paths

shadcn-ui/ui
2
90568

Establish and follow consistent import path conventions throughout the codebase. Prefer aliased imports using the pro...

Code Style Typescript

Verify test commands

vercel/turborepo
2
28115

Always verify that test commands documented in project guides work exactly as written. Test commands should be copy-p...

Testing Markdown

Use workspace dependencies consistently

vercel/turborepo
2
28115

Always use workspace-level dependency declarations (`workspace = true`) rather than specifying exact versions in indi...

Configurations Toml

Use JSDoc deprecation standards

vercel/turborepo
2
28115

When marking code as deprecated, use JSDoc standards to provide clear guidance for developers. Always use the `@depre...

Documentation Typescript

Use environment-aware configurations

vercel/turborepo
2
28115

Configure paths and system references dynamically to ensure they work across all environments (development, testing, ...

Configurations Javascript

Hybrid monorepo testing

vercel/turborepo
2
28115

When working with tests in a monorepo, implement a hybrid testing approach that balances local development experience...

Testing Other

Handle errors appropriately

vercel/turborepo
2
28115

Implement appropriate error handling strategies based on the criticality of operations. For non-critical operations t...

Error Handling Typescript

Graceful error recovery

vercel/turborepo
2
28115

Implement error handling that accumulates diagnostics rather than failing immediately, especially for operations that...

Error Handling Other

Framework-specific entrypoints organization

vercel/turborepo
2
28115

When creating libraries that integrate with Next.js or other frameworks, organize your code with separate entrypoints...

Next Other

Design for testability

vercel/turborepo
2
28115

Extract complex logic into separate, pure functions to improve testability. Functions with clear inputs and outputs a...

Testing Typescript

Consider config generation methods

vercel/turborepo
2
28115

When implementing code to handle configuration files like lockfiles or environment settings, carefully consider the t...

Configurations Go

Test production configurations too

tokio-rs/tokio
2
28981

Include testing configurations that mirror production environments to catch issues that might only manifest in releas...

Testing Yaml

Test diverse configurations

tokio-rs/tokio
2
28989

Configure test suites to run under multiple specialized environments to catch issues that might not appear in standar...

Testing Yaml

Simplify configuration flags

tokio-rs/tokio
2
28989

Keep configuration flags, feature toggles, and build settings concise and well-organized. Use simpler names where app...

Configurations Yaml

Version AI dependencies appropriately

huggingface/tokenizers
2
9868

When adding or updating dependencies for AI/ML libraries in your project, follow these two key practices: 1. **Set a...

AI Toml

Use explicit assertions

huggingface/tokenizers
2
9868

Tests should assert specific expected values rather than just verifying general functionality. This practice makes te...

Testing Rust

Test algorithmic behavior

huggingface/tokenizers
2
9868

When testing algorithms, verify their actual functionality rather than just checking for proper instantiation or prop...

Algorithms Python

Smart configuration defaults

huggingface/tokenizers
2
9868

Prefer smart configuration defaults that auto-detect the environment instead of requiring explicit configuration flag...

Configurations Python

Robust workflow configurations

huggingface/tokenizers
2
9868

Ensure CI/CD workflow configuration files follow best practices for maintainability and correctness: 1. Use centrali...

Configurations Yaml

Prioritize tokenizer simplicity

huggingface/tokenizers
2
9868

When implementing AI model components like tokenizers, favor simplicity over rarely-used features that significantly ...

AI Typescript

Flexible tokenizer implementation

huggingface/tokenizers
2
9868

When implementing tokenizers for AI models, ensure flexibility and robust behavior across different contexts: 1. Ini...

AI Python

Document for comprehension

huggingface/tokenizers
2
9868

Add comprehensive documentation that helps others understand both the interface and implementation of your code. This...

Documentation Python

Consistent API design

huggingface/tokenizers
2
9868

When designing and modifying APIs, ensure consistency in parameter naming, default values, and which functionality is...

API Other

Secure checkout configurations

hashicorp/terraform
2
45532

When configuring GitHub Actions workflows, pay special attention to the checkout action's configuration to ensure bot...

CI/CD Yaml

Explicit dependency graph

hashicorp/terraform
2
45532

When implementing algorithms involving dependencies between components or operations, model the dependency graph expl...

Algorithms Go

Descriptive migration functions

hashicorp/terraform
2
45532

Name migration-related functions descriptively to convey their exact purpose and context of use. Include detailed doc...

Migrations Shell

Verify platform compatibility first

tensorflow/tensorflow
2
190625

When writing networking code that interacts with platform-specific features, always check for the existence of platfo...

Networking Shell

Use modern assertions

tensorflow/tensorflow
2
190625

Always use current assertion methods in test code to ensure clarity and future compatibility. Specifically, replace d...

Testing Python

Secure infrastructure maintenance

tensorflow/tensorflow
2
190625

Maintain CI/CD infrastructure with security and currency as top priorities. This includes: 1. **Keep build tools upd...

CI/CD Dockerfile

Parameterize ci/cd scripts

tensorflow/tensorflow
2
190625

Avoid duplicating CI/CD scripts by leveraging configuration files and parameterization instead of creating multiple s...

CI/CD Shell

Framework migration instructions

tensorflow/tensorflow
2
190625

When documenting AI framework migrations (like TensorFlow/Keras version changes), provide complete instructions cover...

AI Markdown

Format lines and comments

tensorflow/tensorflow
2
190625

Ensure all code follows formatting guidelines for readability and consistency. Keep lines under 80 characters, splitt...

Code Style Python

Document non-obvious code

tensorflow/tensorflow
2
190625

Add clarifying comments to improve code readability and maintainability when code behavior isn't immediately obvious....

Documentation Other

Consistent variable naming

tensorflow/tensorflow
2
190625

Use ALL_CAPS for constants and environment variables in shell scripts, and reference these variables consistently thr...

Naming Conventions Shell

Build dependency synchronization

tensorflow/tensorflow
2
190625

When adding new imports to code files, always synchronize by updating the corresponding dependencies in BUILD files. ...

Configurations Python

Be explicit in references

tensorflow/tensorflow
2
190625

When writing documentation, always be specific and explicit when referring to files, tools, configurations, or other ...

Documentation Markdown

Swift style consistency

tensorflow/swift
2
6136

Maintain consistent Swift style conventions throughout all code, including examples in documentation and comments. Fo...

Code Style Markdown

Minimize cross-device transfers

tensorflow/swift
2
6136

Data transfers between different compute devices (CPU/host to GPU/accelerator and back) can significantly impact perf...

Performance Optimization Markdown

Follow Swift conventions

tensorflow/swift
2
6136

When designing and documenting APIs in Swift, adhere to Swift's established naming conventions and documentation prac...

API Markdown

Verify operation semantics

spring-projects/spring-framework
2
58382

When implementing algorithms that process collections or use conditional logic, always verify the exact semantics of ...

Algorithms Other

Use documentation features properly

spring-projects/spring-framework
2
58382

Utilize Asciidoc features correctly when writing or updating Spring Framework documentation. Instead of hardcoded lin...

Documentation Other

Structured log message quality

spring-projects/spring-boot
2
77637

Design log messages to be clear, concise, and properly structured to maximize their utility for debugging and monitor...

Logging Java

Stable observability components

spring-projects/spring-boot
2
77637

Always use stable, production-ready versions of observability components (libraries, dependencies, and documentation ...

Observability Other

Include database-specific migration dependencies

spring-projects/spring-boot
2
77637

When implementing database migrations with tools like Flyway, ensure you include the appropriate database-specific de...

Migrations Other

Environment variables best practices

spring-projects/spring-boot
2
77637

When working with environment variables in configuration files, follow these practices to ensure reliability and test...

Configurations Other

Consistent terminology usage

spring-projects/spring-boot
2
77637

When referring to technical concepts in documentation and code comments, use proper full names and consistent termino...

Naming Conventions Other

Clear structured logging documentation

spring-projects/spring-boot
2
77637

Document structured logging implementations with clarity, explicitly noting precedence rules and interactions with ot...

Logging Other

Bean lifecycle management

spring-projects/spring-boot
2
77637

When using containers and external services in Spring applications (especially with Testcontainers), declare them as ...

Spring Other

Use utility macros

dotnet/runtime
2
16578

Use predefined utility macros for common operations instead of repeating manual calculations throughout your code. Th...

Code Style C

Platform-aware algorithm optimization

dotnet/runtime
2
16578

When implementing performance-critical algorithms, design your code to detect and utilize platform-specific hardware ...

Algorithms Txt

Optimize aligned SIMD operations

dotnet/runtime
2
16578

Always use proper memory alignment for SIMD (Single Instruction, Multiple Data) operations to maximize performance. W...

Performance Optimization C

Names reflect actual purpose

dotnet/runtime
2
16578

Name variables, properties, and functions to accurately reflect their purpose and actual usage in code, not just thei...

Naming Conventions Other

Memory barrier pairing

dotnet/runtime
2
16578

When implementing low-level synchronization mechanisms in multi-threaded code, ensure that memory barriers are correc...

Concurrency Other

Maintain configuration compatibility

dotnet/runtime
2
16578

When modifying configuration systems, prioritize backward compatibility unless there's an explicit breaking change pl...

Configurations Txt

Honor API contracts

dotnet/runtime
2
16578

When implementing or modifying APIs, carefully preserve the historical behavior and semantic contracts of existing in...

API C#

Feature flag implementation

dotnet/runtime
2
16578

When implementing feature flags, ensure consistency between runtime and compiled scenarios. Feature switches marked w...

Configurations C#

Explicit API versioning

dotnet/runtime
2
16578

When extending interfaces with new methods or functionality, always implement proper versioning to ensure compatibili...

API Other

Enable configurable instrumentation

dotnet/runtime
2
16578

Always provide configurable options for performance instrumentation and hardware acceleration in your codebase. These...

Performance Optimization Other

Document non-obvious logic

dotnet/runtime
2
16578

Add clear comments explaining the purpose and reasoning behind complex or non-obvious code logic. Comments should exp...

Documentation C

Document function contracts

dotnet/runtime
2
16578

Always document function contracts completely, even when surrounding code lacks documentation. Include header comment...

Documentation C++

Centralize platform configurations

dotnet/runtime
2
16578

Platform-specific code and API usage should be centralized in designated configuration files rather than scattered th...

Configurations C

Test edge cases

astral-sh/ruff
2
40619

When writing tests, prioritize coverage of edge cases and non-standard code patterns to ensure robust functionality. ...

Testing Python

Single yield algorithm

astral-sh/ruff
2
40619

Context managers must follow a crucial algorithmic constraint: each execution path must yield exactly once. Multiple ...

Algorithms Python

Logical content organization

astral-sh/ruff
2
40619

Organize code and documentation logically based on functionality and dependencies. Place files in directories that re...

Code Style Markdown

Clear and relevant comments

astral-sh/ruff
2
40619

Ensure all comments in the codebase provide value and clarity rather than creating confusion. Remove comments that ar...

Code Style Python

Write readable conditionals

facebook/react
2
237000

Structure conditionals for maximum clarity and comprehension. Avoid unnecessary negation in boolean expressions, use ...

Code Style Javascript

Standardize URL handling

facebook/react
2
237000

When working with URLs in networking code, always use the standard `URL` constructor to properly resolve relative URL...

Networking Javascript

Proper Usage of React Hooks

facebook/react
2
237000

When using the React library in Typescript, ensure that you are correctly implementing the recommended React hooks ba...

React Typescript

Proper Scoping and Usage of React Variables

facebook/react
2
237000

When implementing React components, it is important to ensure that variables are properly scoped and used throughout ...

React Typescript

Multi-stack config settings

facebook/react
2
237000

When creating configuration files for development environments that use multiple technology stacks, ensure settings a...

Configurations Other

Explicit CSP nonce management

facebook/react
2
237000

When implementing Content Security Policy (CSP) protections, always explicitly pass nonce values to components rather...

Security Javascript

Dry configuration patterns

facebook/react
2
237000

Apply DRY (Don't Repeat Yourself) principles to all configuration files to improve maintainability. Extract shared co...

Configurations Javascript

Document code intent

facebook/react
2
237000

Add clear comments that explain the intent and behavior of code that might not be immediately obvious to other develo...

Documentation Javascript

Defensive Handling of Nullable React Components

facebook/react
2
237000

When working with React components that may return null or undefined values, implement defensive coding patterns to p...

React Typescript

Test helpers for maintainability

rails/rails
2
57027

Create reusable helper methods for common testing operations to improve test maintainability and consistency. Design ...

Testing Other

Spring DI precedence rules

quarkusio/quarkus
2
14667

When developing Quarkus extensions that interact with classes containing Spring annotations (like `@Service`, `@Compo...

Spring Java

Prevent metrics cardinality explosion

quarkusio/quarkus
2
14667

When implementing metrics and telemetry in your application, avoid using dynamic values like path parameters or user ...

Observability Java

Optimize elimination paths

quarkusio/quarkus
2
14667

When implementing algorithms that process large data structures or complex computational paths, prioritize opportunit...

Algorithms Other

Keep configurations current

quarkusio/quarkus
2
14667

Always use the latest stable and supported versions in configuration files. This applies to runtime environments, bui...

Configurations Yaml

Document observability context flows

quarkusio/quarkus
2
14667

When implementing observability features like OpenTelemetry exporters, metrics collection, or distributed tracing, cl...

Observability Other

Design fluent HTTP APIs

quarkusio/quarkus
2
14667

When designing HTTP-related APIs, prioritize readability and intuitiveness through well-crafted fluent interfaces. AP...

API Other

Consolidate duplicate configurations

quarkusio/quarkus
2
14667

Maintain a single source of truth for configuration files instead of duplicating them across the codebase. Duplicated...

Configurations Txt

Type-appropriate null representation

pytorch/pytorch
2
91345

Always use type-appropriate mechanisms to represent the absence of a value. For objects, use default constructors rat...

Null Handling C++

Reuse existing algorithms

pytorch/pytorch
2
91345

Before implementing common algorithms or utilities, check if the codebase already contains an appropriate implementat...

Algorithms C++

Preserve API compatibility

pytorch/pytorch
2
91345

When modifying existing APIs, always prioritize backward compatibility to avoid breaking client code. Before changing...

API Other

Optimize container operations

pytorch/pytorch
2
91345

Minimize CPU overhead in container operations by using efficient data structure patterns: 1. **Use static containers...

Performance Optimization Other

Hardware acceleration considerations

pytorch/pytorch
2
91345

When implementing hardware-accelerated operations for AI models, ensure support for the latest architectures while co...

AI Other

Descriptive unambiguous names

pytorch/pytorch
2
91345

Always use descriptive variable names that clearly indicate their purpose without requiring readers to check call sit...

Naming Conventions C++

Choose data structures wisely

pytorch/pytorch
2
91345

When designing algorithms, select data structures that accommodate all possible scenarios, not just the common case. ...

Algorithms Other

Choose appropriate pointer types

pytorch/pytorch
2
91345

Select the right pointer type based on ownership semantics to prevent null reference issues and memory leaks. Follow ...

Null Handling Other

Centralize configuration detection

pytorch/pytorch
2
91345

Always use centralized configuration detection mechanisms (like CMake finder modules) instead of hardcoding paths or ...

Configurations Shell

Actionable error messages

pytorch/pytorch
2
91345

When writing error messages in PyTorch code, include not only what went wrong but also clear guidance on how to fix t...

Pytorch C++

Specific types for performance

pydantic/pydantic
2
24377

Using concrete types instead of abstract container classes in data models improves validation performance. More speci...

Performance Optimization Markdown

Enforce style with linters

pydantic/pydantic
2
24377

Use automated linting tools to enforce consistent code style across the project, but be deliberate about which rules ...

Code Style Toml

Data structure correctness

pydantic/pydantic
2
24377

Ensure data structures are accurately represented with their proper constraints and valid implementations, particular...

Algorithms Markdown

Avoid unnecessary operations

pydantic/pydantic
2
24364

Check conditions early to skip unnecessary processing and reuse computed values where possible to optimize performanc...

Performance Optimization Python

Avoid shared structure mutation

pydantic/pydantic
2
24364

When implementing algorithms that manipulate complex nested data structures, avoid directly mutating shared objects t...

Algorithms Python

Write objectively

prowler-cloud/prowler
2
11834

Use an impersonal, objective tone in technical documentation. Avoid using second-person pronouns ("you") and subjecti...

Documentation Markdown

Task signature methods

prowler-cloud/prowler
2
11834

When chaining Celery tasks, choose the correct signature method: - Use `.s()` when a task needs the output from the p...

Celery Python

Prefer server components

prowler-cloud/prowler
2
11834

Default to server components in Next.js applications to maximize the benefits of server-side rendering. Avoid adding ...

Next TSX

Parameterize configuration values

prowler-cloud/prowler
2
11834

Always extract configuration values (like versions, paths, or other changeable settings) into parameters rather than ...

Configurations Dockerfile

Log exceptions with context

prowler-cloud/prowler
2
11834

When handling exceptions in your code, ensure they are properly logged with sufficient context to aid debugging. For ...

Logging Python

Format AI code identifiers

prowler-cloud/prowler
2
11834

When documenting AI systems, always format code identifiers, function names, agent names, model names, and other tech...

AI Markdown

Flexible AI model versions

prowler-cloud/prowler
2
11834

When integrating LLM or AI models into your application, implement model selection in a way that accommodates the rap...

AI Python

Environment variables for configurations

prowler-cloud/prowler
2
11834

Store all configurable values such as URLs, API endpoints, and external service locations in environment variables ra...

Configurations TSX

Endpoints for evolving data

prowler-cloud/prowler
2
11834

Design dedicated API endpoints for data that changes frequently or grows over time, rather than hardcoding such infor...

API Typescript

Enable database resilience

prowler-cloud/prowler
2
11834

Always configure appropriate resilience features for database services to ensure data durability and high availabilit...

Database Json

Consistent environment variable naming

prowler-cloud/prowler
2
11834

When naming environment variables, ensure that names are both technically accurate and follow established project con...

Naming Conventions Other

Configure observability variables

prowler-cloud/prowler
2
11834

Always define all necessary environment variables for observability tools in configuration files, even if using defau...

Observability Other

Use consistent temporal types

pola-rs/polars
2
34296

When implementing or modifying temporal operations, maintain consistent data types that align with existing temporal ...

Temporal Rust

Edge case algorithm handling

pola-rs/polars
2
34296

When implementing algorithms, pay special attention to edge cases, particularly empty collections. Define and documen...

Algorithms Markdown

Cross-platform feature flags

pola-rs/polars
2
34296

When documenting package installation commands with feature flags, ensure compatibility across different operating sy...

Configurations Markdown

Review consistency assumptions

opentofu/opentofu
2
25901

Periodically reassess your database operations based on updated consistency guarantees offered by storage technologie...

Database Markdown

Provider instance management

opentofu/opentofu
2
25901

Ensure proper configuration of provider instances when using environment-specific settings. When using `for_each` wit...

Configurations Other

Protect infrastructure secrets

opentofu/opentofu
2
25901

Infrastructure-as-code tools like OpenTofu may store sensitive information in plaintext state files, creating securit...

Security Markdown

Document phased migration paths

opentofu/opentofu
2
25901

When replacing an existing system feature with a new implementation, provide a clear and well-documented phased migra...

Migrations Markdown

Contextualize security findings

opentofu/opentofu
2
25901

When reporting security vulnerabilities, include sufficient context beyond just vulnerability IDs or codes. Always pr...

Security Yaml

Clear relationship descriptions

opentofu/opentofu
2
25901

When documenting algorithms or data structures with graph-like relationships, use precise terminology to describe con...

Algorithms Markdown

Use proper testing frameworks

open-telemetry/opentelemetry-python
2
2061

Always leverage established testing frameworks and APIs over custom bash scripts or direct Python execution for test ...

Testing Shell

Track observability API changes

open-telemetry/opentelemetry-python
2
2061

Stay informed about API changes in observability libraries like OpenTelemetry, especially during their active develop...

Observability Other

Telemetry version pinning

open-telemetry/opentelemetry-python
2
2061

When specifying observability frameworks like OpenTelemetry in requirements files, use the compatible release operato...

Observability Txt

Adapt for linter compatibility

open-telemetry/opentelemetry-python
2
2061

When writing or modifying code, design patterns and templates to be compatible with linting tools. This is especially...

Code Style Other

Thread-safe resource cleanup

opencv/opencv
2
82865

When implementing resource cleanup in concurrent applications, avoid using deprecated finalizers and instead use Phan...

Concurrency Java

Maintain build compatibility

opencv/opencv
2
82865

When modifying build scripts or configurations, ensure compatibility across all supported environments and properly t...

CI/CD Txt

Document configuration version requirements

opencv/opencv
2
82865

Make build configuration options explicit and document their version dependencies. When introducing configuration par...

Configurations Python

Check nulls directly

opencv/opencv
2
82865

Check objects directly for null/empty state instead of using separate tracking variables. Always perform null checks ...

Null Handling Other

Purpose-reflecting file names

ollama/ollama
2
145705

File names should clearly communicate their purpose and functionality. Avoid generic, ambiguous, or numbered names (l...

Naming Conventions Other

Path traversal prevention

ollama/ollama
2
145705

Implement multiple validation layers to prevent path traversal attacks. File paths provided by users or external syst...

Security Go

Optimize memory allocations

ollama/ollama
2
145705

Be strategic about memory allocations to improve performance in your C++ code. Consider two key optimization patterns...

Performance Optimization C++

Model precision matters

ollama/ollama
2
145705

When deploying AI models on specialized hardware accelerators (GPUs, NPUs), ensure you're using compatible model prec...

AI Shell

Keep container images current

ollama/ollama
2
145705

Always use up-to-date and supported container images in Dockerfiles and configuration files. Before specifying a base...

Configurations Dockerfile

Extract duplicated code

ollama/ollama
2
145705

Identify repeated code segments and extract them into reusable functions or variables. This improves maintainability,...

Code Style Other

Complete HTTP protocol handling

ollama/ollama
2
145705

When implementing HTTP client functionality, ensure comprehensive support for all standard HTTP status codes and secu...

Networking Go

Complete documentation coverage

ollama/ollama
2
145705

Documentation should comprehensively cover all supported options, variations, and potential future use cases. When cr...

Documentation Markdown

AI dependency decoupling strategy

ollama/ollama
2
145705

Implement clear boundaries between your core AI system and external machine learning libraries through abstraction la...

AI C++

Use appropriate framework targets

octokit/octokit.net
2
2793

When configuring .NET projects, always use the correct target framework elements and versions: 1. Use the singular `...

Configurations Other

Secure permission modeling

octokit/octokit.net
2
2793

When implementing security-related models such as permissions, carefully design the properties to prevent unauthorize...

Security C#

Precise and consistent naming

octokit/octokit.net
2
2793

Names should clearly indicate their specific purpose and context, while maintaining correct capitalization of brand n...

Naming Conventions Other

File-specific indentation standards

octokit/octokit.net
2
2793

Maintain consistent indentation based on file type to ensure code readability and prevent unwanted whitespace changes...

Code Style Json

Validate Next.js Configuration Usage

vercel/next.js
2
133000

When implementing Next.js in your application, ensure that you are correctly using the framework's documented configu...

Next.js Javascript

Robust Error Handling in Next.js Components

vercel/next.js
2
133000

When building Next.js components, it is crucial to implement robust error handling to ensure the stability and predic...

Next.js Javascript

Proper panic chains

vercel/next.js
2
133000

When implementing panic handlers, follow these critical practices to ensure robust error handling: register panic han...

Error Handling Rust

Non-blocking observability mechanisms

vercel/next.js
2
133000

When implementing observability mechanisms like telemetry or status monitoring, ensure they don't block or interfere ...

Observability Typescript

Document configuration sources

vercel/next.js
2
133000

When providing configuration instructions, document the exact location and method to obtain required values. Include ...

Configurations JSON

Dependency conscious APIs

vercel/next.js
2
133000

Design APIs with dependency implications in mind. Carefully consider how your API design choices might force dependen...

API Rust

Complete error handling flows

vercel/next.js
2
133000

Implement robust error handling patterns that ensure both proper resource cleanup and error context preservation.

Error Handling Typescript

Complete data structures

vercel/next.js
2
133000

When implementing data structures such as tries, trees, or graphs, ensure all critical operations (insertion, deletio...

Algorithms Typescript

Choose optimal data structures

vercel/next.js
2
133000

Select data structures based on their performance characteristics and actual usage patterns. When implementing algori...

Algorithms Rust

Enable header validation

netty/netty
2
34227

Always enable HTTP header validation to prevent request/response splitting vulnerabilities. These attacks can occur w...

Security Java

Check feature compatibility

netty/netty
2
34227

When using kernel-specific networking features like io_uring, always implement runtime detection of feature support b...

Networking C

Reliable concurrency synchronization

neondatabase/neon
2
19015

When handling concurrent operations, prefer completion signals and proper thread management over arbitrary timeouts. ...

Concurrency Python

Proper metrics design

neondatabase/neon
2
19015

When designing metrics for observability systems like Prometheus, follow established best practices to ensure your me...

Observability Other

Optimize what matters

neondatabase/neon
2
19015

Focus optimization efforts on performance-critical paths rather than applying micro-optimizations everywhere. Balance...

Performance Optimization C

Modern shell syntax

neondatabase/neon
2
19015

Prefer double brackets (`[[ ]]`) over single brackets (`[ ]`) in shell scripts for improved functionality and consist...

Code Style Yaml

Mind transaction boundaries

neondatabase/neon
2
19015

Be conscious of implicit transaction boundaries when working with databases. Programming constructs can create unexpe...

Database Python

Limit concurrent access slots

neondatabase/neon
2
19015

Design concurrency mechanisms based on actual usage patterns rather than theoretical maximum connections. When implem...

Concurrency Other

Handle network interrupts safely

neondatabase/neon
2
19015

Network code must properly handle interrupts and maintain consistent connection state at all potential interruption p...

Networking C

Feature flag implementation clarity

neondatabase/neon
2
19015

When implementing feature flags in the system, clearly document both the evaluation strategy and its performance impl...

Configurations Markdown

Document parameter choices

neondatabase/neon
2
19015

Always add explanatory comments for parameters or configuration options that aren't self-explanatory from their names...

Documentation Python

Document connection transitions

neondatabase/neon
2
19015

When implementing systems that involve network connection state changes (such as during failovers, restarts, or compo...

Networking Markdown

Database replica promotion safeguards

neondatabase/neon
2
19015

When implementing database replica promotion logic, avoid temporary workarounds that bypass validation checks. Instea...

Database Other

Balance flexibility with performance

neondatabase/neon
2
19015

When designing APIs, carefully balance flexibility against performance constraints. More flexible APIs often come wit...

API Other

Use pytest parameterization

apache/mxnet
2
20801

Structure unit tests using pytest's parameterize decorator instead of manual loops or wrapper functions. This approac...

Testing Python

Use named constants

apache/mxnet
2
20801

In AI model implementations, avoid using magic numbers directly in code as they reduce readability and make maintenan...

AI Other

Pre-compute reused data

apache/mxnet
2
20801

When data will be accessed multiple times during processing, avoid redundant calculations by pre-computing values upf...

Performance Optimization Python

Consistent API documentation

apache/mxnet
2
20801

Maintain high-quality, consistent documentation as a critical component of API design. Documentation should feature: ...

API Markdown

Update documentation configuration

langchain-ai/langchainjs
2
15004

When adding new files or components to the project, ensure that documentation configuration is updated accordingly. T...

Documentation Json

Simplify code organization

langchain-ai/langchainjs
2
15004

Maintain clean code organization by eliminating unnecessary abstractions and preventing codebase fragmentation. This ...

Code Style Javascript

Platform-appropriate environment variables

langchain-ai/langchainjs
2
15004

Always use the correct syntax for accessing environment variables based on the target platform. In JavaScript/Node.js...

Configurations Javascript

Match configuration documentation

langchain-ai/langchainjs
2
15004

Configuration documentation must accurately reflect implementation details and behavior. Ensure that: 1. Code exampl...

Configurations Markdown

Follow standard naming

langchain-ai/langchainjs
2
15004

Use established naming patterns and correct capitalization throughout the codebase and documentation. For test fixt...

Naming Conventions Markdown

Validate model optimization

kubeflow/kubeflow
2
15064

When implementing AI model optimization techniques such as early stopping algorithms or hyperparameter tuning, includ...

AI Markdown

Validate inputs explicitly

kubeflow/kubeflow
2
15064

Always validate input parameters and respond with appropriate HTTP status codes when invalid values are detected, eve...

Error Handling Python

Use enums for state

kubeflow/kubeflow
2
15064

When handling nullable or undefined states, use enumerations instead of primitive types like boolean or null/undefine...

Null Handling Typescript

Use CSS classes properly

kubeflow/kubeflow
2
15064

Avoid inline styles and `!important` declarations in your HTML templates. Instead, define and use CSS classes that en...

Code Style Html

Unique workflow step names

kubeflow/kubeflow
2
15064

When defining CI/CD workflows, always ensure task/step names are unique to prevent execution failures. Workflow engin...

CI/CD Python

Type-appropriate default values

kubeflow/kubeflow
2
15064

Initialize variables with type-appropriate default values to prevent type errors and null reference exceptions during...

Null Handling Python

Structure for navigation

kubeflow/kubeflow
2
15064

Documentation should be structured to optimize user navigation and information discovery. When organizing documentati...

Documentation Yaml

Standardize style scripts

kubeflow/kubeflow
2
15064

Maintain consistent code style enforcement scripts across all projects by standardizing linting and formatting config...

Code Style Json

Standardize metrics collection

kubeflow/kubeflow
2
15064

Use the appropriate metric types for the data being collected and consider centralizing monitoring code to ensure con...

Observability Go

Stable configuration management

kubeflow/kubeflow
2
15064

Always ensure configuration values are managed consistently and sourced from stable locations. 1. Use defined const...

Configurations TSX

Safe URL operations

kubeflow/kubeflow
2
15064

When handling URLs for API interactions and navigation, use precise methods for both comparison and construction to a...

API Typescript

Reduce nesting depth

kubeflow/kubeflow
2
15064

Improve code readability by reducing nesting depth with early returns and functional approaches. Use early returns to...

Code Style Typescript

Private variable naming convention

kubeflow/kubeflow
2
15064

Use the 'prv' prefix for private class members and ensure they're explicitly declared with the 'private' access modif...

Naming Conventions Typescript

Prefer external configuration

kubeflow/kubeflow
2
15064

Design applications to use external configuration sources rather than hardcoding values directly in source code. This...

Configurations Javascript

Optimize container build configurations

kubeflow/kubeflow
2
15064

Configure containerized application builds to be efficient and flexible by avoiding hardcoded architecture decisions ...

CI/CD Dockerfile

Match algorithms to purpose

kubeflow/kubeflow
2
15064

Select algorithmic constructs and control structures that are appropriate for the specific task. Common issues includ...

Algorithms Python

Isolate test cases

kubeflow/kubeflow
2
15064

Create separate test functions for distinct functionality to improve test clarity and make failure points more obviou...

Testing Python

Enforce least privilege

kubeflow/kubeflow
2
15064

Configure all systems with the minimum permissions required to function. For Kubernetes deployments, use security con...

Security Yaml

Document networking annotations

kubeflow/kubeflow
2
15064

When using Istio or other networking-related annotations in configuration files, always include detailed comments exp...

Networking Yaml

Document migration paths

kubeflow/kubeflow
2
15064

When implementing version changes or migrations, provide comprehensive documentation and tools to support users throu...

Migrations Markdown

Descriptive consistent naming

kubeflow/kubeflow
2
15064

Use descriptive and consistent names throughout the codebase. Prefer full, meaningful names over acronyms or abbrevia...

Naming Conventions Other

Consistent separator conventions

kubeflow/kubeflow
2
15064

Use appropriate separators in compound identifiers to improve readability and ensure naming consistency across the co...

Naming Conventions Markdown

Consistent descriptive naming

kubeflow/kubeflow
2
15064

Maintain consistency in naming patterns across related resources while ensuring names accurately reflect their purpos...

Naming Conventions Yaml

Component-agnostic styling principles

kubeflow/kubeflow
2
15064

Create reusable components with styles that don't make assumptions about parent contexts or affect their positioning ...

Code Style Css

Centralize dependency configurations

kubeflow/kubeflow
2
15064

When adding or updating package dependencies, place them in centralized configuration files rather than duplicating t...

Configurations Txt

Automate style enforcement

kubeflow/kubeflow
2
15064

Configure your development environment to automatically enforce code style standards rather than relying on manual ch...

Code Style Yaml

API structure balance

kubeflow/kubeflow
2
15064

Maintain a clear separation between resource-specific API handlers and common utilities. Resource-specific handlers s...

API Python

Use modern test infrastructure

JetBrains/kotlin
2
50857

Always add new tests to the current recommended test infrastructure rather than legacy systems that are being phased ...

Testing Other

Minimize not-null assertions

JetBrains/kotlin
2
50857

Avoid using not-null assertions (`!!`) when safer alternatives exist. Instead: 1. Use safe calls (`?.`) when accessin...

Null Handling Java

Dependency verification configuration

JetBrains/kotlin
2
50857

When adding new dependencies to build.gradle.kts files, always update the corresponding verification metadata to prev...

Configurations Xml

Copy external string inputs

JetBrains/kotlin
2
50857

When storing string pointers from external sources (like command-line arguments), always validate the input and creat...

Null Handling C++

Document versioning strategies

influxdata/influxdb
2
30268

Establish and clearly document versioning strategies in configuration files, both for your application and its depend...

Configurations Yaml

Document function signatures

influxdata/influxdb
2
30268

Always document function parameters and return values in the function header comment or interface definition. This is...

Documentation Go

Centralize workspace configurations

influxdata/influxdb
2
30268

Centralize configuration settings like dependency versions and feature flags at the workspace level rather than dupli...

Configurations Toml

Semantic naming consistency

elie222/inbox-zero
2
8267

Ensure all model and field names semantically reflect their actual purpose and maintain consistency with their usage ...

Naming Conventions Prisma

Ensure schema-migration consistency

elie222/inbox-zero
2
8267

When modifying database schemas, ensure complete alignment between schema definitions and SQL migration scripts. Ever...

Migrations Prisma

Eliminate documentation redundancy

elie222/inbox-zero
2
8267

Documentation should be concise and avoid repeating the same information in multiple places. Redundant content confus...

Documentation Markdown

Consistent code organization

elie222/inbox-zero
2
8267

Maintain consistent patterns when organizing code elements within schema files. Place standard fields (like IDs and t...

Code Style Prisma

Collections use plural names

elie222/inbox-zero
2
8267

Always use plural names for properties representing collections (arrays/lists) in interfaces, types, and destructurin...

Naming Conventions TSX

Workflow permission boundaries

grafana/grafana
2
68825

Always define explicit and minimal permission boundaries in GitHub Actions workflows to adhere to the principle of le...

Security Yaml

Use dynamic port allocation

grafana/grafana
2
68825

When writing tests that require network services (HTTP, gRPC, or custom protocols), use port 0 to let the operating s...

Networking Go

Stable test assertions

grafana/grafana
2
68825

Write tests that focus on behavior rather than implementation details to create more stable and maintainable test sui...

Testing Typescript

Sort with clarity

grafana/grafana
2
68825

Ensure sorting functions are named to accurately reflect their behavior and implement consistent sorting approaches t...

Algorithms Go

Opt-in configurable caching

grafana/grafana
2
68825

Implement caching mechanisms as opt-in features with explicit configuration options rather than as defaults. This app...

Caching Typescript

Object parameters for readability

grafana/grafana
2
68825

When a function has 3 or more parameters, use object destructuring instead of positional arguments. This improves cod...

Code Style TSX

Document translatable UI text

grafana/grafana
2
68825

All user-facing text in UI components should be properly documented for translation using the application's internati...

Documentation TSX

Defense in depth

grafana/grafana
2
68825

Always implement multiple layers of security controls, even when they might seem redundant. This strategy ensures pro...

Security Typescript

Contextual structured logging

grafana/grafana
2
68825

Log messages should provide sufficient context to be meaningful and actionable while following structured logging pat...

Logging Go

Check before calculating

grafana/grafana
2
68825

Implement preliminary validation checks before executing expensive operations to avoid unnecessary processing. When h...

Performance Optimization Typescript

Balance flexibility with simplicity

grafana/grafana
2
68825

When designing component APIs, strive to find the optimal balance between providing flexible configuration options an...

API TSX

Assert with precision

grafana/grafana
2
68825

Tests should verify actual behavior rather than just successful execution. When writing assertions, favor precise equ...

Testing Go

Use standard HTTP constants

gin-gonic/gin
2
83022

Always use the standard HTTP status constants from the `http` package instead of raw numeric values in your networkin...

Networking Go

Select algorithms by complexity

gin-gonic/gin
2
83022

Choose appropriate algorithms based on computational complexity requirements and context. When implementing lookups, ...

Algorithms Go

Preserve security configurations

gin-gonic/gin
2
83022

Always respect explicitly set security attributes and properly sanitize user inputs to prevent security vulnerabiliti...

Security Go

Pin dependency versions

gin-gonic/gin
2
83022

Always specify exact versions of tools and dependencies in CI/CD workflows rather than using 'latest' or floating ver...

CI/CD Yaml

Minimize configuration complexity

gin-gonic/gin
2
83022

Keep configuration files clean and maintainable by regularly reviewing and removing unnecessary settings and outdated...

Configurations Yaml

Initialize before null-checking

gin-gonic/gin
2
83022

When handling potentially nil values, ensure proper initialization order to prevent race conditions and null referenc...

Null Handling Go

Document API behavior

gin-gonic/gin
2
83022

Thoroughly document how your API endpoints handle data binding and processing, especially non-obvious behaviors that ...

API Markdown

Declare .PHONY targets

gin-gonic/gin
2
83022

Always explicitly declare all Makefile targets that don't create files as `.PHONY`. This prevents conflicts with pote...

CI/CD Other

Close resource handles properly

gin-gonic/gin
2
83022

Always close file resources and other system handles after use to prevent resource leaks. Resource leaks can cause sy...

Error Handling Markdown

Prefer flat control flow

ghostty-org/ghostty
2
32864

Minimize code nesting by using Swift features like `guard` statements and early returns instead of deeply nested if-e...

Code Style Swift

Pipeline-friendly script design

ghostty-org/ghostty
2
32864

Design scripts to be easily integrated into build pipelines and CI/CD workflows by using standard I/O streams instead...

CI/CD Python

Generate dynamic configurations

ghostty-org/ghostty
2
32864

Always generate configuration files programmatically when they contain dynamic content that changes frequently or nee...

Configurations Xml

Format for readability

ghostty-org/ghostty
2
32864

Documentation should be formatted to optimize readability and information retention. Apply these principles to make d...

Documentation Markdown

Validate security-critical inputs

fatedier/frp
2
95938

Always implement thorough validation for user-controllable inputs that could pose security risks. Particularly: 1. *...

Security Go

Focus documentation content

fatedier/frp
2
95938

Maintain streamlined primary documentation (like README files) that focuses only on currently supported functionality...

Documentation Markdown

Document code decisions

fatedier/frp
2
95938

Always include clear documentation for important code decisions and metadata. This includes preserving copyright noti...

Documentation Go

Check context cancellation

fatedier/frp
2
95938

Always implement proper cancellation mechanisms in concurrent code to prevent goroutine leaks and enable timely shutd...

Concurrency Go

Precise testing dependency versioning

laravel/framework
2
33763

When specifying testing library dependencies, always use explicit minimum patch versions rather than development bran...

Testing Json

Mark sensitive parameters

laravel/framework
2
33763

Always use the `#[\SensitiveParameter]` attribute for parameters containing sensitive information such as passwords, ...

Security PHP

Verify types in tests

fastify/fastify
2
34000

Use explicit type assertions in TypeScript tests to verify that types behave as expected across various scenarios. In...

Testing Typescript

Use bot identity

fastify/fastify
2
34000

When configuring Git operations in GitHub Actions workflows, especially for automated commits, use the GitHub Actions...

CI/CD Yaml

Support flexible logging

fastify/fastify
2
34000

When designing logging interfaces, create flexible APIs that accommodate both standard and custom logging needs. This...

Logging Javascript

Secure Fastify Code Implementation

fastify/fastify
2
34000

This review focuses on secure implementation patterns when using the Fastify web framework in Typescript: prevent Pro...

Fastify Typescript

Proper IPv6 address formatting

fastify/fastify
2
34000

When constructing URLs with IP addresses, ensure IPv6 addresses are properly formatted according to RFC standards by ...

Networking Javascript

Ensure Proper Null Handling When Using Fastify Decorators

fastify/fastify
2
34000

When working with Fastify decorators, always perform explicit null checks before accessing potentially undefined prop...

Fastify Typescript

Consistent Fastify Package Naming and References

fastify/fastify
2
34000

When implementing code using the Fastify package in Typescript, it is important to use consistent and accurate naming...

Fastify Typescript

Use universally understandable identifiers

fastapi/fastapi
2
86871

When naming variables, functions, routes, and other code elements, use clear, neutral terminology that will be unders...

Naming Conventions Python

Use streaming generators

fastapi/fastapi
2
86871

When processing large files or datasets, implement generator functions that yield data incrementally rather than load...

Algorithms Markdown

Use appropriate documentation formats

fastapi/fastapi
2
86871

Choose the most suitable documentation format based on context to maximize readability and information value. For P...

Documentation Python

Optimize IO with async

fastapi/fastapi
2
86871

FastAPI's performance advantage comes from its asynchronous foundation built on Starlette and Uvicorn, using `uvloop`...

Performance Optimization Markdown

Environment-specific database configuration

fastapi/fastapi
2
86871

Configure database connections differently based on the environment. Use lightweight file-based databases like SQLite...

Database Markdown

Consistent dependency versioning

fastapi/fastapi
2
86871

When updating dependency version constraints in requirements files, ensure consistency with versions pinned by other ...

Configurations Txt

Clear informative errors

fastapi/fastapi
2
86871

Error messages should be clear, specific, and provide enough context to understand the issue without exposing unneces...

Error Handling Python

Avoid blocking in async

fastapi/fastapi
2
86871

When working with asynchronous code, ensure that I/O operations (like file reads/writes) don't block the event loop. ...

Concurrency Python

Modern TypeScript style

expressjs/express
2
67300

Use modern TypeScript syntax and conventions throughout the codebase. This includes: - Using `const` instead of `var`...

Code Style Typescript

Method chaining for clarity

expressjs/express
2
67300

Design API methods that favor chaining over multiple parameters to improve readability and maintainability. When impl...

API Markdown

Maintain API types

expressjs/express
2
67300

Ensure API type definitions accurately reflect current implementations. When maintaining TypeScript definitions for A...

API Typescript

Exclude sensitive configurations

expressjs/express
2
67300

Do not commit sensitive, time-limited, or environment-specific configuration files to version control. Instead: 1. F...

Configurations Other

Clear array operations

expressjs/express
2
67300

When working with arrays, prioritize clarity and explicitness over terse or clever constructs. For array membership c...

Algorithms Javascript

Accurate JSDoc documentation

expressjs/express
2
67300

Always ensure JSDoc comments accurately reflect the actual code implementation. Parameter types, optionality, and fun...

Documentation Javascript

Use current configuration patterns

elastic/elasticsearch
2
73104

Always use the current recommended configuration patterns for your project, avoiding deprecated approaches. When conf...

Configurations Yaml

Specify explicit REST formats

elastic/elasticsearch
2
73104

Always specify explicit request formats in REST API tests rather than relying on default behaviors. This includes: 1...

API Yaml

Document security requirements explicitly

elastic/elasticsearch
2
73104

Always document security-related configurations, permissions, and behaviors explicitly and comprehensively. When docu...

Security Other

Document performance tradeoffs

elastic/elasticsearch
2
73104

Always explicitly document the performance implications of API parameters, limit changes, and features that could sig...

Performance Optimization Other

Complete API parameter documentation

elastic/elasticsearch
2
73104

API endpoints must include comprehensive documentation for all parameters. For each parameter, clearly specify: 1. W...

API Other

Avoid flaky tests

elastic/elasticsearch
2
73104

Design tests to be deterministic and reliable across different environments. Tests that occasionally fail due to timi...

Testing Yaml

Type-safe numerical algorithms

deeplearning4j/deeplearning4j
2
14036

When implementing numerical algorithms, always use appropriate data types to prevent overflow and preserve precision:...

Algorithms C++

Prevent memory leaks

deeplearning4j/deeplearning4j
2
14036

Always ensure proper memory management when using dynamic allocation. Memory leaks are a critical performance issue t...

Performance Optimization C++

Preserve API compatibility

deeplearning4j/deeplearning4j
2
14036

When evolving APIs, prioritize backward compatibility to protect existing client code. Make new parameters optional w...

API Kotlin

Optimize validation checks

deeplearning4j/deeplearning4j
2
14036

When implementing validation and requirement checks, balance thoroughness with performance considerations. Critical v...

Performance Optimization CUDA

Optimize hardware acceleration

deeplearning4j/deeplearning4j
2
14036

AI systems should use the most performant hardware acceleration libraries and carefully manage hardware-specific depe...

AI Xml

Modular adaptive configurations

deeplearning4j/deeplearning4j
2
14036

Structure configuration scripts with modularity and adaptability in mind. Extract repeated parameters into variables,...

Configurations Yaml

Maintain proper capitalization

deeplearning4j/deeplearning4j
2
14036

Always use correct and consistent capitalization for product names, class names, and method names throughout code and...

Naming Conventions Markdown

Ensure test determinism

deeplearning4j/deeplearning4j
2
14036

Create reliable and reproducible tests by explicitly controlling test inputs and verifying function behavior doesn't ...

Testing Java

Document in-code decisions

deeplearning4j/deeplearning4j
2
14036

Always include explanations for implementation decisions, non-obvious constructs, and specialized functions directly ...

Documentation CUDA

Document AI implementation references

deeplearning4j/deeplearning4j
2
14036

When implementing AI algorithms or neural network operations, document the sources of specific implementation choices...

AI C++

Functional code examples

crewaiinc/crewai
2
33945

Ensure all code examples in documentation are complete, accurate, and ready to run without modification. Since develo...

Documentation Other

Fail securely by default

crewaiinc/crewai
2
33945

When designing systems that handle sensitive operations, always default to the most secure behavior rather than prior...

Security Python

Consistent configuration declarations

crewaiinc/crewai
2
33945

Ensure configuration specifications (such as version requirements, environment settings, and tool declarations) are c...

Configurations Markdown

Prefer safe DOM manipulations

vuejs/core
2
50769

When manipulating DOM content, prefer safer alternatives to innerHTML when possible to prevent Cross-Site Scripting (...

Security Typescript

Optimize build scripts

vuejs/core
2
50769

Improve CI/CD pipeline efficiency by optimizing package.json scripts. Run compatible tasks in parallel using pattern ...

CI/CD Json

Align configurations with usage

vuejs/core
2
50769

Configuration files should accurately reflect the actual requirements and characteristics of your codebase. When sett...

Configurations Json

Configure loggers consistently

salesforce/cloudsplaining
2
2100

Always configure module-level loggers with a consistent pattern across the codebase. Use `logging.getLogger(__name__)...

Logging Python

Verify automated documentation

chef/chef
2
7860

When using automated tools to generate documentation, always verify the output for accuracy and document any addition...

Documentation Markdown

Structure CI/CD scripts

chef/chef
2
7860

Improve CI/CD shell scripts' readability and maintainability by using appropriate shell script patterns. Use heredocs...

CI/CD Shell

Standardize bash error-handling

chef/chef
2
7860

Always use `set -eou pipefail` at the beginning of bash scripts to ensure consistent and robust error handling. This ...

Error Handling Shell

Log message quality

chef/chef
2
7860

Ensure all log messages are consistent in formatting and clear in purpose. Complete sentences in logs should end with...

Logging Markdown

Use correct encryption properties

bridgecrewio/checkov
2
7668

When configuring security features in Azure ARM templates, always use the correct property names as specified in the ...

Security Json

Target core resources

bridgecrewio/checkov
2
7668

When implementing network security checks for serverless functions like AWS Lambda, ensure you target the core functi...

Networking Yaml

Secure API endpoints

bridgecrewio/checkov
2
7667

Always configure proper authorization for API endpoints to prevent unauthorized access to back-end resources. Avoid c...

API Yaml

Minimize workflow complexity

bridgecrewio/checkov
2
7668

Keep GitHub Actions workflows efficient and maintainable by eliminating redundant configurations and ensuring compreh...

CI/CD Yaml

Lambda CORS protection

bridgecrewio/checkov
2
7667

When implementing network security checks for AWS Lambda functions, ensure that CORS (Cross-Origin Resource Sharing) ...

Networking Yaml

Implement pre-commit hooks

bridgecrewio/checkov
2
7668

Automate quality and security checks by implementing pre-commit hooks in your Git repositories to catch issues early ...

CI/CD Markdown

Ensure dependency compatibility

bridgecrewio/checkov
2
7668

When adding or updating dependencies in configuration files (Pipfile, requirements.txt), ensure compatibility with al...

Configurations Other

Configure security scanners completely

bridgecrewio/checkov
2
7668

Security scanning tools must be fully configured to maximize detection capabilities. When implementing tools like Che...

Security Yaml

Azure encryption property names

bridgecrewio/checkov
2
7667

When configuring encryption settings for Azure resources in ARM templates, always use the correct property names as d...

Security Json

Use appropriate comment syntax

boto/boto3
2
9417

Choose the correct comment syntax based on the file type and processing system to ensure documentation serves its int...

Documentation Html

Keep CI configurations updated

boto/boto3
2
9417

Regularly review and update CI configuration files to remove obsolete settings and use appropriate version specificat...

CI/CD Yaml

Function-focused code organization

boto/boto3
2
9417

Files should contain only code related to their named purpose, with proper organization and formatting. When adding f...

Code Style Javascript

Follow flake8 style guidelines

boto/boto3
2
9417

Adhere to the project's established flake8 style guidelines as defined in setup.cfg. This includes: 1. Maintain line...

Code Style Other

Avoid identifier name stuttering

boto/boto3
2
9417

Do not repeat the resource name in identifier names. This form of stuttering makes code less readable and inconsisten...

Naming Conventions Json

Use higher-level telemetry

Azure/azure-sdk-for-net
2
5809

When implementing observability for Azure services, prefer higher-level telemetry packages and configuration methods ...

Observability Markdown

Preserve protocol data integrity

Azure/azure-sdk-for-net
2
5809

When working with network protocols (like AMQP, NFS, or SMB), maintain the integrity of the original protocol data st...

Networking Markdown

Match CI commands locally

Azure/azure-sdk-for-net
2
5809

Always use the same build and test commands locally that are used in your CI pipeline to ensure consistency between e...

CI/CD Markdown

Handle external process errors

Azure/azure-sdk-for-net
2
5809

When calling external processes (like dotnet, msbuild, etc.), always implement proper error handling and output manag...

Error Handling Other

Eliminate repeated code

Azure/azure-sdk-for-net
2
5809

Reduce code duplication by extracting repeated patterns into variables, loops, or helper functions. When you find you...

Code Style Other

Document non-obvious code

Azure/azure-sdk-for-net
2
5809

Add clarifying comments to code elements whose purpose or behavior may not be immediately apparent to other developer...

Documentation Yaml

Document maintenance decisions

Azure/azure-sdk-for-net
2
5809

Add clear documentation for any decisions that affect future code maintenance. This includes: 1. Providing explanato...

Documentation Other

Document AI changes thoroughly

Azure/azure-sdk-for-net
2
5809

When updating AI libraries and SDKs, ensure all changes are thoroughly documented in changelogs with clear categoriza...

AI Markdown

Complete pipeline configurations

Azure/azure-sdk-for-net
2
5809

Ensure all CI/CD configuration files have their required fields properly populated with specific values rather than e...

CI/CD Json

Approve AI dependencies conditionally

Azure/azure-sdk-for-net
2
5809

All AI-related dependencies (Microsoft.Extensions.AI.*, etc.) require explicit approval before inclusion and must be ...

AI Other

Address not mask

Azure/azure-sdk-for-net
2
5809

Always address the root cause of CI/CD pipeline issues rather than masking them with quick fixes. This applies to enc...

CI/CD Other

Use Appropriate Concurrency Patterns with Axum

tokio-rs/axum
2
22100

When building asynchronous Axum applications that share mutable state, it's important to select the right concurrency...

Axum Typescript

Implement Distributed Tracing in Axum Applications

tokio-rs/axum
2
22100

As an Axum code reviewer, I recommend implementing proper distributed tracing in your Axum-based web applications to ...

Axum Typescript

User-friendly error messages

axios/axios
2
107000

Error messages should be concise and clearly communicate what went wrong without unnecessary verbosity. When implemen...

Error Handling Html

Flexible configuration design

axios/axios
2
107000

Design configuration interfaces to be flexible and extensible rather than overly specific. When creating configuratio...

Configurations Typescript

Consistent semicolon usage

axios/axios
2
107000

Always terminate statements with explicit semicolons to maintain consistency with the existing codebase style. Avoid ...

Code Style Typescript

Consistent Axios Usage Patterns

axios/axios
2
107000

Maintain consistent usage of the Axios library throughout your Typescript codebase. Pay special attention to consiste...

Axios Typescript

Standardize API promise patterns

aws/aws-sdk-js
2
7628

When adding promise support to API methods, implement a consistent pattern that handles both callback-style and multi...

API Javascript

Semantic type organization

aws/aws-sdk-js
2
7628

Organize types and interfaces in intuitive namespace hierarchies and use specific types instead of generic ones. Type...

Naming Conventions Typescript

Organize type declarations

aws/aws-sdk-js
2
7628

Structure TypeScript declarations to improve maintainability and developer experience. Organize related types into ap...

Code Style Typescript

Example documentation standards

aws/aws-sdk-js
2
7628

Organize API documentation examples for maximum clarity and usefulness. Place hand-written examples before generated ...

Documentation Ruby

Document sdk version requirements

aws/aws-sdk-js
2
7628

Always explicitly document AWS SDK version requirements in your project, and include configuration instructions for d...

Configurations Markdown

Complete configuration type definitions

aws/aws-sdk-js
2
7628

Ensure configuration type definitions are complete and consistent between global and service-specific settings. When ...

Configurations Typescript

Accurate type signatures

aws/aws-sdk-js
2
7628

When defining API interfaces in TypeScript, ensure that method signatures accurately reflect the actual behavior and ...

API Typescript

Validate configuration source changes

apache/airflow
2
40858

When switching between different configuration sources (like APIs or configuration values), ensure data structure com...

Configurations TSX

Use proper access patterns

apache/airflow
2
40858

Access configurations through documented abstraction layers rather than bypassing them with direct database or low-le...

Configurations Other

Use guards over assertions

apache/airflow
2
40858

Prefer explicit type guards and null checks over TypeScript's type assertions (`as`) when handling potentially null o...

Null Handling TSX

Share documentation configs

apache/airflow
2
40858

Documentation tooling and configuration files should leverage shared/centralized resources rather than maintaining du...

Documentation Txt

Quote shell variables

apache/airflow
2
40858

Always quote shell script variable expansions using double quotes to prevent word splitting issues and ensure consist...

Code Style Shell

Optimize CI configurations

apache/airflow
2
40858

When designing CI/CD workflows, prioritize both resource efficiency and clear documentation. Incorporate dynamic conf...

CI/CD Yaml

Natural language translations

apache/airflow
2
40858

When providing translations for user interface elements and documentation, prioritize natural and idiomatic expressio...

Documentation Json

Versioning for migrations

vercel/ai
2
15590

Use appropriate version bumps to signal migration requirements and maintain clear upgrade paths. Flag breaking change...

Migrations Markdown

Optimize CI type checking

vercel/ai
2
15590

Configure separate TypeScript type-checking strategies for CI environments and local development. CI pipelines should...

CI/CD Json

Format for rendering compatibility

vercel/ai
2
15590

Documentation should be formatted appropriately for its intended rendering context and ensure discoverability. Consid...

Documentation Markdown

Flexible API inputs

vercel/ai
2
15590

Design APIs to accept flexible input formats and schema structures, ensuring a better developer experience while main...

API Markdown

Consistent camelCase naming

vercel/ai
2
15590

Use camelCase consistently for all property names, method names, and configuration options, even when interacting wit...

Naming Conventions Other

Consistent AI interfaces

vercel/ai
2
15590

Maintain consistent naming patterns and parameter structures across AI provider implementations. This makes the SDK m...

AI Markdown

Warn against sudo

zed-industries/zed
1
62119

Applications that may need elevated privileges should explicitly warn against running the entire application with sud...

Security Shell

Verify dependency integrity

vitessio/vitess
1
19815

Always verify the integrity of external dependencies, especially those downloaded from non-official or personal repos...

Security Yaml

Permission hierarchy awareness

vitejs/vite
1
74031

When implementing permission checks, understand the hierarchical nature of permissions and avoid redundant checks. Hi...

Security Yaml

Escape HTML content properly

vitejs/vite
1
74031

Always use specialized HTML escaping functions when outputting dynamic content to prevent Cross-Site Scripting (XSS) ...

Security Typescript

Mask sensitive tokens

astral-sh/uv
1
60322

Always mask sensitive tokens, credentials, and secrets in CI/CD workflows to prevent accidental exposure in logs or b...

Security Yaml

Add interactive element roles

shadcn-ui/ui
1
90568

When adding event handlers like `onClick` to non-interactive elements such as `div`, always include appropriate ARIA ...

Security TSX

Accessible security indicators

shadcn-ui/ui
1
90568

Ensure all security-related UI elements such as warnings, error messages, and destructive action buttons meet WCAG co...

Security Css

Avoid unsafe code

huggingface/tokenizers
1
9868

Prioritize memory safety and security over performance optimizations by avoiding unsafe code blocks, especially in li...

Security Rust

Sanitize command inputs

hashicorp/terraform
1
45532

When constructing commands that will be executed, always sanitize input values to prevent command injection vulnerabi...

Security Go

Least privilege for tokens

hashicorp/terraform
1
45532

Always apply the principle of least privilege when configuring access tokens for CI/CD workflows and other automated ...

Security Yaml

Maintain package verification

tensorflow/tensorflow
1
190625

Always keep signature verification enabled in package managers, even in development environments, Docker containers, ...

Security Other

Validate security-sensitive inputs

spring-projects/spring-framework
1
58382

Always use appropriate validation mechanisms for security-sensitive inputs to prevent vulnerabilities. When implement...

Security Java

Inherit organization security policies

spring-projects/spring-boot
1
77637

Before implementing custom security documentation or procedures, check if your organization already provides standard...

Security Markdown

Constant-time cryptographic validation

dotnet/runtime
1
16578

Always use constant-time comparison methods when validating cryptographic values to prevent timing side-channel attac...

Security C#

Use explicit permission notations

astral-sh/ruff
1
40619

When setting file permissions through system calls like `chmod`, always use explicit octal notation (with the `0o` pr...

Security Rust

Prefer modern security

quarkusio/quarkus
1
14667

When implementing security features (such as artifact signing), use current best practices and prefer pure-Java secur...

Security Xml

Test authentication dependencies

prowler-cloud/prowler
1
11834

When updating authentication-related dependencies or adding new authentication capabilities (like SAML, OAuth, etc.),...

Security Toml

Precise CSP configuration

prowler-cloud/prowler
1
11834

When integrating third-party services into your web application, carefully configure Content Security Policy (CSP) he...

Security Javascript

Fix dependency vulnerabilities

prowler-cloud/prowler
1
11834

Security vulnerabilities in dependencies must be addressed immediately rather than bypassed with flags like `--no-ver...

Security Yaml

Avoid localStorage for credentials

prowler-cloud/prowler
1
11834

Do not store user profiles, authentication tokens, or other sensitive user information in client-side storage mechani...

Security Typescript

Redact sensitive credentials

pola-rs/polars
1
34296

When implementing authentication or handling credentials, always redact sensitive information (keys, tokens, password...

Security Rust

Secure encryption key backups

opentofu/opentofu
1
25901

Always implement proper encryption key management procedures, including secure backups of encryption keys before enab...

Security Other

Preserve sensitive data marks

opentofu/opentofu
1
25901

Carefully handle data marked as sensitive throughout the codebase to maintain security properties. Ensure that sensit...

Security Go

Document security attributes

vercel/next.js
1
133000

When handling security-related attributes (like nonces, integrity hashes, or CSP directives), always document the log...

Security TSX

Decode before validation

vercel/next.js
1
133000

Always decode URL paths before performing security validations to prevent bypass attacks using URL encoding. Security...

Security Typescript

Prefer opt-in security

neondatabase/neon
1
19015

When implementing security features that modify data presentation or alter normal data access patterns (like anonymiz...

Security Dockerfile

Harden CI/CD runners

neondatabase/neon
1
19015

All CI/CD workflow jobs must implement security controls for network traffic, particularly using the step-security/ha...

Security Yaml

Escape SQL parameters

neondatabase/neon
1
19015

Always escape parameters in database connection strings to prevent SQL injection attacks. Direct string concatenation...

Security Sql

Avoid eval function

apache/mxnet
1
20801

Never use the `eval()` function in Python code as it creates serious security vulnerabilities by executing arbitrary ...

Security Python

Private vulnerability reporting

kubeflow/kubeflow
1
15064

Never expose security vulnerabilities in public issue trackers. Security issues require confidential handling to prev...

Security Markdown

Prevent XSS vulnerabilities

kubeflow/kubeflow
1
15064

Never directly concatenate untrusted data (like user inputs or API responses) into HTML strings, as this creates cros...

Security Javascript

Harden container security

kubeflow/kubeflow
1
15064

When building container images, ensure they're compatible with restricted Kubernetes security contexts. Use numeric U...

Security Dockerfile

Enforce HTTPS protocol

kubeflow/kubeflow
1
15064

Always validate that URLs use the HTTPS protocol in both implementation code and validation error messages. Even if y...

Security Typescript

Control header modification

kubeflow/kubeflow
1
15064

When allowing user-configurable HTTP headers in your application, implement strict validation to prevent security byp...

Security Go

Configurable security with defaults

kubeflow/kubeflow
1
15064

Make security features configurable through environment variables or configuration files, but always implement secure...

Security Python

Document security implementations

JetBrains/kotlin
1
50857

Always document non-obvious security implementations, especially authentication mechanisms, with explanatory comments...

Security Kotlin

Vet security-critical dependencies

influxdata/influxdb
1
30268

When introducing new dependencies, especially those handling sensitive operations like language interpreters, perform...

Security Toml

Secure dependency management

elie222/inbox-zero
1
8267

Always maintain secure dependencies by following these two critical security practices: 1. **Keep dependencies updat...

Security Json

Quote shell substitutions

elie222/inbox-zero
1
8267

Always enclose command substitutions in double quotes when assigning to variables or using in shell scripts to preven...

Security Yaml

Enforce user scoping

elie222/inbox-zero
1
8267

All database queries must include appropriate user scoping to prevent unauthorized data access and Insecure Direct Ob...

Security Other

Use appropriate permission checks

grafana/grafana
1
68825

When implementing role-based access control (RBAC), ensure you use the correct permission verification method based o...

Security TSX

Update vulnerable dependencies

grafana/grafana
1
68825

Always update dependencies with known security vulnerabilities to their patched versions. Dependencies with security ...

Security Other

Avoid plaintext credentials

grafana/grafana
1
68825

Never include plaintext passwords or credentials in connection strings, configuration files, or documentation example...

Security Markdown

Secure temporary files

ghostty-org/ghostty
1
32864

Always use `mktemp` instead of manually constructing temporary file paths with random values. Manually constructed pa...

Security Other

Sanitize debug output

ghostty-org/ghostty
1
32864

Never print or log sensitive information such as tokens, passwords, or secrets that might be present in environment v...

Security Python

Non-root container users

fatedier/frp
1
95938

Always run containers with a non-root user to reduce the security attack surface. Modern Docker allows non-root users...

Security Dockerfile

Secure Content-Type validation

fastify/fastify
1
34000

When implementing Content-Type validation, ensure regular expressions start with '^' or include ';?' to properly dete...

Security Javascript

Use unique password salts

expressjs/express
1
67300

When implementing password hashing, always use unique, randomly generated salts for each user. Using constant or shar...

Security Javascript

Pin action commit hashes

expressjs/express
1
67300

Always pin third-party GitHub Actions to specific commit hashes rather than semantic version tags (like `@v1`). This ...

Security Yaml

Enforce least privilege

elastic/elasticsearch
1
73104

Always assign the minimum permissions necessary for functionality when implementing role-based access controls. This ...

Security Java

Update security-critical dependencies

chef/chef
1
7860

Regularly audit and update third-party libraries and dependencies to address known security vulnerabilities. Pay spec...

Security Markdown

Expand IAM wildcards

bridgecrewio/checkov
1
7668

Always expand IAM wildcard permissions (`*`) to specific actions for thorough security analysis. Wildcard permissions...

Security Markdown

Avoid wildcard permissions

bridgecrewio/checkov
1
7667

Implement the principle of least privilege by avoiding wildcard permissions (e.g., '*') in access control policies. A...

Security Markdown

Avoid hardcoded secrets

bridgecrewio/checkov
1
7668

Never include hardcoded secrets or credentials in your infrastructure as code files. Secrets in configuration files p...

Security Terraform

Use standard example credentials

boto/boto3
1
9417

When including API keys, access tokens, or other credentials in documentation, examples, or test code, always use cle...

Security Other

Redact sensitive information

Azure/azure-sdk-for-net
1
5809

Always sanitize configuration data or any potentially sensitive information before logging or displaying it. When log...

Security Other

Externalize sensitive credentials

Azure/azure-sdk-for-net
1
5809

Never hardcode sensitive values such as client identifiers, API keys, connection strings, or passwords directly in co...

Security Yaml

Complete authentication testing

Azure/azure-sdk-for-net
1
5809

Always verify both positive and negative authentication scenarios in your security tests. For each authentication mec...

Security C#

Isolate sensitive buffer data

aws/aws-sdk-js
1
7628

When handling sensitive data in Node.js, protect against data leakage by isolating sensitive content in dedicated buf...

Security Javascript

Prioritize secure token storage

apache/airflow
1
40858

When implementing authentication token handling, prioritize more secure storage mechanisms over less secure ones. Spe...

Security Typescript

Document security exceptions

apache/airflow
1
40858

When disabling security-related linter rules or bypassing security best practices, always include comments that expla...

Security TSX